SDK Ekleme
Related Digital iOS SDK’ini Cocoapods aracılığıyla projenize ekleyebilirsiniz. SDK’i yüklemek için aşağıdaki satırı podfile dosyanıza ekleyin.
pod 'RelatedDigitalIOS'
Not: Eğer Push Modülünü kullanmayacaksanız verilen kodlar içerisinde pushla ilgili olanları eklemenize gerek yoktur.
Kurulum
AppDelegate.swift dosyanızda RelatedDigitalIOS’u import edin. Ardından didFinishLaunchingWithOptions içerisine aşağıdaki kodları ekleyin. Bu kodlar Related Digital Analytics ve Push modüllerini aktif eder.
import RelatedDigitalIOS
import UserNotifications
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
RelatedDigital.initialize(organizationId: "YOUR_ORGANIZATION_ID, profileId: "YOUR_PROFILE_ID, dataSource: "YOUR_DATA_SOURCE", launchOptions: launchOptions)
RelatedDigital.enablePushNotifications(appAlias: "YOUR_APP_ALIAS", launchOptions: launchOptions, appGroupsKey: "YOUR_APP_GROUP_KEY", deliveredBadge: true)
UNUserNotificationCenter.current().delegate = self
RelatedDigital.loggingEnabled = true
RelatedDigital.inAppNotificationsEnabled = true
if #available(iOS 13, *) {
// handle push for iOS 13 and later in sceneDelegate
} else if let userInfo = launchOptions?[UIApplication.LaunchOptionsKey.remoteNotification] as? [String: Any] {
RelatedDigital.handlePush(pushDictionary: userInfo)
}
return true
}
İsteğe bağlı parametreler
loggingEnabled: SDK tarafından konsola log basılmasını istiyorsanız bu değeri true geçmelisiniz. Bu sayede SDK’den çıkan istekleri, responseları ve varsa hataları görebilirsiniz.
inAppNotificationsEnabled: Uygulamanızda InApp Message (Popup, Rakamlarla Anket vb.), Çarkıfelek, Kazı Kazan, Story gibi Target Aksiyonları gösterecekseniz bu değeri true geçmelisiniz.
geofenceEnabled: Eğer kullanıcılarınızın konumuna göre push göndermeyi planlıyorsanız bu değeri true geçmelisiniz.
OrganizationId, ProfileId ve Data Source Bilgilerini Alma
RMC Panel’de hesabınıza giriş yaptıktan sonra aşağıdaki adımları izleyerek bilgilere ulaşabilirsiniz.
Öncelikle üst menüden Management > Profiles sayfasına giriyoruz.
Ardından bu sayfada Actions altındaki butona tıklıyorum.
Son olarak görselde gösterilen alanlardan ilgili bilgileri alabilirsiniz.
App Alias Bilgisini Alma
App Alias bilgisini almak için öncelikle panelde uygulama tanımlamanız gerekmektedir. App Alias eşsiz bir değerdir. Her uygulamanın kendine ait bir App Alias değeri olabilir. Bu değeri siz belirliyorsunuz.
Panele giriş yaptıktan sonra sağ üstte bulunan Ayarlar ikonunun üstüne gelip Campaign Management sayfasına giriyoruz ve bu sayfadan da uygulama eklemek için Push Uygulamaları sayfasına giriyoruz.
Push Uygulamaları sayfasından Yeni iOS Uygulaması butonuna tıklıyoruz.
Açılan sayfada öncelikli olarak P12 sertifikası mı P8 sertifikası mı kullanacağınızı seçmeniz gerekmektedir. P12 ve P8 sertifikalarının en bariz farklılıkları şunlardır.
P12 sertifikası sürelidir 1 sene sonunda yenilemeniz gerekmektedir. P8 sertifikası ise sınırsızdır.
Test uygulamalarına push atmak için P12 sertifikasının Development versiyonunu, Canlı uygulamaya push atmak için P12 sertifikasının Production versiyonunu üretip yüklemeniz gerekmektedir. P8 sertifikasında böyle bir ayrım yoktur.
P12 Sertifikası Oluşturma
P8 Sertifikası Oluşturma
P12 sertifikalı uygulama tanımlama
Uygulama ismi alanına istediğiniz ismi verebilirsiniz. Genel kullanım örneği ise şu şekildedir: Related Digital iOS
P12 dosyanızı seçip P12 Şifresi alanına KeyChain’den çıkarırken oluşturduğunuz şifreyi girin.
Platform olarak ise eğer test uygulamasında çalışacaksanız (sadece XCode üzerinden açılan Debug Mod uygulama) Test’i seçin. Canlı uygulama (Testflight’ta bulunan veya AppStore’da yayınlanmış) üzerinde çalışacaksanız Prod’u seçin.
App Alias değeri olarak istediğiniz bir değeri Türkçe karakter ve boşluk kullanmadan girebilirsiniz. Genel kullanım örneği ise şu şekildedir: related_digital_ios
P8 sertifikalı uygulama tanımlama
Uygulama ismi alanına istediğiniz ismi verebilirsiniz. Genel kullanım örneği ise şu şekildedir: Related Digital iOS
P8 dosyanızı seçin. Bundle ID alanına projenizin Bundle ID değerini girin. Team ID alanına Geliştirici Hesabınızın Team ID değerini giriyorsunuz. Bu bilgiye http://developer.apple.com adresine giriş yaptığınızda Membership sayfası altından ulaşabilirsiniz. Key ID değerinize ise P8 sertifikanızı oluşturduğunuzda gelen sayfadan ulaşabilirsiniz. P8 sertifikanızı kaybetmemelisiniz. Sadece bir kere indirmenize izin veriliyor. Aksi takdirde yenisini oluşturmalısınız.
Platform olarak ise eğer test uygulamasında çalışacaksanız (sadece XCode üzerinden açılan Debug Mod uygulama) Test’i seçin. Canlı uygulama (Testflight’ta bulunan veya AppStore’da yayınlanmış) üzerinde çalışacaksanız Prod’u seçin.
App Alias değeri olarak istediğiniz bir değeri Türkçe karakter ve boşluk kullanmadan girebilirsiniz. Genel kullanım örneği ise şu şekildedir: related_digital_ios
