iOS SDK Ekleme ve Kurulum

SDK Ekleme

VisilabsIOS, CocoaPods aracılığıyla edinilebilir. Yüklemek için aşağıdaki satırı Podfile'ınıza ekleyin:

pod 'VisilabsIOS'

Kurulum

AppDelegate.swift dosyanızda VisilabsIOS’u import edin ve application:didFinishLaunchingWithOptions: metodunda createAPI metodunu çağırın.

Aşağıdaki kod, Visilabs kütüphanesinin örnek bir başlatmasıdır.

import VisilabsIOS

func application(_ application: UIApplication, didFinishLaunchingWithOptions 
        launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        Visilabs.createAPI(organizationId: "YOUR_ORGANIZATION_ID", profileId: "YOUR_PROFILE_ID"
        , dataSource: "YOUR_DATASOURCE", inAppNotificationsEnabled: true, channel: "IOS"
        , requestTimeoutInSeconds: 30, geofenceEnabled: false, maxGeofenceCount: 20, isIDFAEnabled: true)
        return true
    }

İlk Parametreler

Zorunlu Parametreler
- organizationId : Kuruluşunuzun kimliği. Bu parametrenin değeri, https://intelligence.relateddigital.com/#Management/UserManagement/Profiles adresinden ve ilgili profil seçilerek elde edilebilir.
- profileId : Entegre etmek istediğiniz profilin kimliği. Bu parametrenin değeri, https://intelligence.relateddigital.com/#Management/UserManagement/Profiles adresinden ve ilgili profil seçilerek elde edilebilir.
- dataSource : Entegre etmek istediğiniz profilin veri kaynağı (profil adınız). Bu parametrenin değeri, https://intelligence.relateddigital.com/#Management/UserManagement/Profiles adresinden ve ilgili profil seçilerek elde edilebilir.
İsteği Bağlı Parametreler
- inAppNotificationsEnabled : Varsayılan değer false olarak ayarlıdır. Visilabs'ın in-app notification özelliğini kullanmak istiyorsanız, değeri true olarak ayarlamanız gerekir. Visilabs'ın in-app notification özelliğini kullanmıyorsanız performans açısından bu değeri false olarak bırakmanızı öneririz çünkü her istekte ilgili aksiyon için bir bildirim olup olmadığını kontrol etmek için başka bir istek gönderilir.
- channel : Varsayılan değer "IOS" dur. IOS uygulamanızın olaylarını yönetici panelinin Analitik bölümünde başka bir farklı kanal adı altında kategorize etmek isterseniz bu değeri değiştirebilirsiniz.
- requestTimeoutInSeconds : Varsayılan değer 30'dur. Visilabs sunucularına veri göndermek ve veri almak için saniye cinsinden istek zaman aşımı değeri.
- geofenceEnabled : Varsayılan değer false olarak ayarlıdır. Visilabs'ın geofence özelliğini kullanmak istiyorsanız, değeri true olarak ayarlamanız gerekir. Visilabs'ın geofence özelliğini kullanmıyorsanız, performans ve kullanıcı deneyimi açısından bu değeri false olarak bırakmanızı öneririz, çünkü lokasyon izleme uygulamanızın pil tüketimini artıracak ve kullanıcılara konum izlemeye izin vermek için bir açılır iletişim kutusu soracaktır.
- askLocationPermmissionAtStart : Varsayılan değeri true olarak ayarlıdır. Bu değer true olarak geçildiğinde geoenfeEnabled true ise ve createAPI metodu çalıştırıldığı zaman kullanıcıya konum izni sorulmaktadır. Eğer false geçilirse konum izni sdk tarafından sorulmaz ve sizin kullanıcıdan izin istemeniz gerekir. Kullanıcıdan izin istemek için istediğiniz yerde aşağıdaki metodu çağırabilirsiniz.
  
  Visilabs.callAPI().requestLocationPermissions()
- maxGeofenceCount : Varsayılan değer 20'dir. Apple, herhangi bir uygulamanın aynı anda 20'den fazla lokasyonu izlemesini engeller. Visilabs tüm bu yuvaları kullanabilir. Bununla birlikte, bu yuvaların bazılarına başka bir kullanım için ihtiyacınız varsa, bu parametreyi 20'den daha düşük bir değere ayarlayabilirsiniz. 20'den daha yüksek bir değer ayarlamak, izlenecek maksimum lokasyon sayısını etkilemez.
- isIDFAEnabled: Varsayılan değer true’dur. iOS 14 ile beraber gelen Kullanıcı Takip İzni’ni kullanacaksanız bu değeri true olarak ayarlamalı ve info.plist dosyanıza Privacy - Tracking Usage Description ayarını ekleyip kullanıcı için detaylı açıklama yazmanız gerekmektedir. createAPI metodu çalıştıktan sonra kullanıcıdan takip izni isteyecektir. Detaylı bilgi için tıklayın.

Debug Etme

LoggingEnabled özelliğini true olarak ayarlayarak log kaydını açabilirsiniz. Etkinleştirmek için aşağıdaki adımı izleyin:

Visilabs sunucularına yapılan istekler için varsayılan protokol https'dir. İsteklerinizde daha kolay hata ayıklamak istiyorsanız, insecureProtocol özelliğini true olarak ayarlayarak protokolünüzü değiştirebilirsiniz.