Ekleme ve Kurulum

SDK Ekleme

Related Digital iOS SDK’ini Cocoapods veya Swift Package Manager (SPM) aracılığıyla projenize ekleyebilirsiniz.

Cocoapods

SDK’i yüklemek için aşağıdaki satırı podfile dosyanıza ekleyin.

pod 'RelatedDigitalIOS'

SPM

İlk olarak Xcode menüsünden File > Add Packages… yolunu izleyin.

Açılan sayfada sağ üstteki alana https://github.com/relateddigital/relateddigital-ios linkini yapıştırın ve Add Package butonuna tıklayın.

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