3. Proje yapılandırması
3.1 AdMob Uygulama Kimliği
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 paketlerinin içine 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ının (AppLovin, IronSource ve bunların alt teklif ortakları), ATT kapsamında yüklemeleri doğru şekilde ilişkilendirebilmesi için SKAdNetworkIdentifier girdilerine ihtiyacı vardır. Referans uygulama, AppLovin/IronSource/Meta vb. arabuluculuk 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) — kendiniz tamamlamanız gereken bir eksik
Dikkat: Referans entegrasyonda ne NSUserTrackingUsageDescription ne de herhangi bir ATTrackingManager.requestTrackingAuthorization() çağrısı bulunur. AKS, iOS'ta sizin adınıza ATT izin istemini göstermez. IDFA'nın AdMob/AppLovin/IronSource arabuluculuğu ve AppsFlyer/Adjust ilişkilendirmesi için 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 çağrıyı eklemeyin ve SDK entegre edildi diye bu iki adımın zaten tamamlandığını varsaymayın.
3.4 GoogleService-Info.plist
Firebase'in GoogleService-Info.plist dosyasını uygulama hedefinize standart ş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 kurulum adımları aynen geçerlidir.
3.5 Minimum iOS sürümü (Deployment target)
AppsKit.xcframework/AKSKit.xcframework, en az iOS 15.0 gerektirecek şekilde Swift 5.9 (Xcode 15.2+) ile derlenmiştir; modül kararlılığı için BUILD_LIBRARY_FOR_DISTRIBUTION: YES kullanılır. Uygulama hedefinizin IPHONEOS_DEPLOYMENT_TARGET değerini 15.0 veya daha yüksek bir sürüme ayarlayın. Ayrıca Podfile içindeki post_install (§1.2) bloğunun da tüm pod hedeflerini 15.0 sürümüne zorladığını unutmayın; dolayısıyla uygulama düzeyinde daha düşük bir hedef sürüm seçmek, pod'larla sorunsuz bağlantı kurulmasını zaten engeller.