Bu kılavuz AdPlus iOS SDK kullanımına ait geliştiricilerin ihtiyaç duyacağı bilgileri içermektedir.
Bu bölümde iOS uygulamanıza AdPlus reklamlarını ekleyebilmeniz için gereken adımlar yer almaktadır.
SDK'yı uygulamanıza eklemek için CocoaPods entegrasyonunu tamamlamanız gerekmektedir. Detaylı bilgi için CocoaPods sayfasını inceleyebilirsiniz.
POD dosyanızı oluşturduktan sonra, aşşağıdaki satırı bu dosyaya eklemeniz gerekmektedir.
pod 'ssp-ios-sdk-public'
Ardından;
$ pod install
komutunu çalıştırdığınızda SDK yüklenecektir.
import sspadkitSDK yi yukarıda belirtilen satırları projenize ekledikten sonra kullanmaya başlayabilirsiniz.
SDK nın modüllerine erişmek için ilk önce InventoryID'niz ve AdUnitID'niz ile konfigürasyon dosyanızı oluşturmalısınız. Ardından SSPAdkit nesnemizi oluşturmak için aşşağıda ki örnek kodu kullanabilirsiniz.
let config = SSPAdKitConfig(_inventoryID: "XXXXXXXXX", _adUnitID: "XXXXXXXXX")
let adManager = SSPAdKit.init(_config: config)Bu bölümde iOS uygulamanızda AdPlus reklamlarını özelleştirmeniz için gereken adımlar yer almaktadır.
Reklam isteklerini özelleştirmek için yarattığımız SSPAdkit nesnesi üzerindeki .config değişkenini kullanabilirsiniz.
Özelleştirmek için kullanılan parametreler aşşağıdaki gibidir.
public var yearOfBirth : Int? //Cihaz sahibinin doğum yılı.
public var gender : GenderTypes = .unknown //Cihaz sahibinin cinsiyeti.
public var categories:[String:String] = [:] //Sayfa iceriğinin IAB kategorileri.
public var latitude : String? //Eğer cihaz konum alıyorsa enlem verisi.
public var longtitude : String? //Eğer cihaz konum alıyorsa boylam verisi.
public var customdata:[String:String] = [:] //Geliştiricinin göndermek istediği diğer datalar. Key-Value Dizisi
public var applicationVersion : String? //Uygulamanın versiyonu.
public var language : String? //Alpha-2/ISO 639-1Bu parametrelir reklam isteği oluşturmadan önce belirlemelisiniz.
Konfigürasyon nesnesi üzerinden SDK davranışlarını özelleştirmek için aşşağıdaki parametreleri kullanabilirsiniz.
public var shouldAskForIDFA = false //SDK idfa bilgisi toplamak için kullanıcıdan izin sormasını yönetmek için kullanılır
public var addTimeOutInterval : Int? //Reklam istekleri için time-out süresi. - Varsayılan ve Alt değer = 30Bu parametreleri SDK nesnenizi oluşturmadan önce belirlemelisiniz.
Bu bölümde iOS uygulamanızda AdPlus reklamlarını oluşturmanız için gereken adımlar yer almaktadır.
Banner reklamlar sayfanızın içeriğine dahil olacak şekilde görünecek ebatları ve pozisyonu belirlenebilen statik görünümlü reklamlardır. Bir sayfada birden çok banner reklam yer alabilir.
Banner reklam isteği oluşturmadan önce yarattığımız SSPAdkit nesnesi üzerindeki .bannerDelegate parametresine BannerAdDelegate protokolünü uyguladığınız sınıfınızı belirtmelisiniz.
Bu protokol aşşağıdaki gibi tanımlanmıştır.
protocol BannerAdDelegate: NSObjectProtocol {
func addReceived(forBanner adItem: SSPBannerAd)
func failedToLoadAdd(forBanner adItem: SSPBannerAd, reason: SSPResult)
@objc optional func addWillAppear(forBanner adItem: SSPBannerAd)
}Bu parametreyi belirledikten sonra reklam isteğinizi aşşağıdaki methodu çağırarak oluşturabilirsiniz.
public func requestBanner(for _size:SSPBannerSizes, _identifier : Int? = nil) -> SSPRequestResponse {}Reklam isteğiniz başarılı bir şekilde oluşturulduktan sonra, bu isteğin sonucu BannerAdDelegate protokolünü uyguladığınız sınıfınıza iletilecektir.
Reklam isteğiniz sonucunda, gösterilecek reklam olması halinde
func addReceived(forBanner adItem: SSPBannerAd)methodu çağırılacaktır.
Bu aşamada reklamı göstermek istedğiniz UIView objenizi SDK ya göndermeniz gerekmektedir. Bu işlem için bu kod örneği aşşağıdaki gibidir.
func addReceived(forBanner adItem: SSPBannerAd) {
adItem.show(in: bannerContainerView )
}Reklam isteğiniz sonucunda ya da reklam gösterilmesi sırasında bir hata oluşması halinde
func failedToLoadAdd(forBanner adItem: SSPBannerAd, reason: SSPResult)methodu çağırılacaktır.
Reklam isteği ile ilgili tüm işlemler tamamlandıktan sonra, reklam nesnesi arayüze eklenmeden hemen önce eğer uygulandı ise
@objc optional func addWillAppear(forBanner adItem: SSPBannerAd)methodu çağırılacaktır.
Interstitial reklamlar çalıştığı uygulamanın tümünü kaplayacak şekilde görünecek dinamik görünümlü reklamlardır. Bir sayfada sadece bir interstitial reklam yer alabilir.
Interstitial reklam isteği oluşturmadan önce yarattığımız SSPAdkit nesnesi üzerindeki .popUpDelegate parametresine PopUpAdDelegate protokolünü uyguladığınız sınıfınızı belirtmelisiniz.
Bu protokol aşşağıdaki gibi tanımlanmıştır.
protocol PopUpAdDelegate: NSObjectProtocol {
func addReceived(forPopUp adItem: SSPPopUpAd)
func failedToLoadAdd(forPopUp adItem: SSPPopUpAd, reason: SSPResult)
func closePopUp(forPopUp adItem: SSPPopUpAd)
@objc optional func addWillAppear(forPopUp adItem: SSPPopUpAd)
}Bu parametreyi belirledikten sonra reklam isteğinizi aşşağıdaki methodu çağırarak oluşturabilirsiniz.
public func requestPopup(for _size:SSPPopUpSizes, _identifier : Int? = nil) -> SSPRequestResponse {}Reklam isteğiniz başarılı bir şekilde oluşturulduktan sonra, bu isteğin sonucu PopUpAdDelegate protokolünü uyguladığınız sınıfınıza iletilecektir.
Reklam isteğiniz sonucunda, gösterilecek reklam olması halinde
func addReceived(forPopUp adItem: SSPPopUpAd)methodu çağırılacaktır.
Bu aşamada reklamı göstermek istedğiniz UIView objenizi SDK ya göndermeniz gerekmektedir. Bu işlem için bu kod örneği aşşağıdaki gibidir.
func addReceived(forPopUp adItem: SSPPopUpAd) {
adItem.show(in: popUpContainerView)
}Reklam isteğiniz sonucunda ya da reklam gösterilmesi sırasında bir hata oluşması halinde
func closePopUp(forPopUp adItem: SSPPopUpAd)methodu çağırılacaktır.
Reklam gösterildikten sonra, kullanıcı kapatma düğmesine bastığında
func failedToLoadAdd(forPopUp adItem: SSPPopUpAd, reason: SSPResult)Reklam isteği ile ilgili tüm işlemler tamamlandıktan sonra, reklam nesnesi arayüze eklenmeden hemen önce eğer uygulandı ise
@objc optional func addWillAppear(forBanner adItem: SSPBannerAd)methodu çağırılacaktır.
- iOS 10.0 ve üzeri
- Xcode 12.5 ve üzeri
- Swift 5