3. Proje yapılandırması

3.1 AdMob Uygulama Kimliği (App ID)

Etkinleştirdiğiniz reklam ağları arasında AdMob/GAM varsa, kendi AdMob Uygulama Kimliğinizi Info.plist dosyasına ekleyin (bu kimlik uygulamaya özeldir; xcframework paketlerine dahil edilemez):

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

3.2 SKAdNetworkItems

AKS'nin arkasındaki reklam arabuluculuğu (mediation) ve ilişkilendirme (attribution) ağları (AppLovin, IronSource ve bunların teklif verme iş ortakları), ATT kapsamında uygulama yüklemelerini doğru şekilde ilişkilendirmek için SKAdNetworkIdentifier girdilerine ihtiyaç duyar. Referans uygulama, AppLovin/IronSource/Meta vb. arabuluculuk iş ortaklarını kapsayan yaklaşık 48 girdi içerir. Eski bir listeyi kopyalamak yerine güncel listeyi reklam ağlarınızın yönetim panellerinden alın (AppLovin, IronSource ve AdMob'un her biri bir liste yayımlar); bu ağlar zaman içinde yeni kimlikler ekler.

3.3 App Tracking Transparency (ATT) — sizin tamamlamanız gereken bir eksik

Dikkat: Referans entegrasyonda ne NSUserTrackingUsageDescription ne de herhangi bir ATTrackingManager.requestTrackingAuthorization() çağrısı bulunur. AKS, iOS'te sizin adınıza ATT izni istemez. IDFA'nın AdMob/AppLovin/IronSource arabuluculuğunda ve AppsFlyer/Adjust ilişkilendirmesinde kullanılabilmesini istiyorsanız, her ikisini de kendiniz eklemelisiniz:

<key>NSUserTrackingUsageDescription</key>
<string>Your data will be used to deliver personalized ads.</string>

import AppTrackingTransparency

ATTrackingManager.requestTrackingAuthorization { status in
    // call this before initializing ads — see §4.4
}

Kullanım açıklaması metni olmadan requestTrackingAuthorization çağrısı yapmak, uygulamanın çalışma zamanında çökmesine neden olur. Bu nedenle Info.plist anahtarını eklemeden bu çağrıyı eklemeyin ve SDK entegre edildi diye bunlardan herhangi birinin zaten halledildiğini varsaymayın.

3.4 GoogleService-Info.plist

Firebase'in GoogleService-Info.plist dosyasını uygulama hedefinize (target) her zamanki şekilde ekleyin (kaynak klasörünüze sürükleyin ve hedef üyeliğinin seçili olduğundan emin olun). Bu işlemde AKS'ye özgü bir adım yoktur; Firebase'in standart kurulumu aynen geçerlidir.

3.5 Minimum iOS sürümü (Deployment target)

AppsKit.xcframework/AKSKit.xcframework, minimum iOS 15.0 için Swift 5.9 (Xcode 15.2+) ile derlenmiştir ve modül kararlılığı için BUILD_LIBRARY_FOR_DISTRIBUTION: YES ayarı kullanılır. Uygulama hedefinizin IPHONEOS_DEPLOYMENT_TARGET değerini 15.0 veya üzeri olarak ayarlayın. Ayrıca Podfile içindeki post_install (§1.2) adımının da tüm pod hedeflerini 15.0'a zorladığını unutmayın; dolayısıyla uygulama düzeyinde daha düşük bir hedef sürüm ayarlamak, pod'larla sorunsuz bağlanmayı zaten engeller.