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 paketlerine dahil edilemez):
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>3.2 SKAdNetworkItems
AKS'nin kullandığı reklam arabuluculuğu (mediation) ve ilişkilendirme (attribution) ağları (AppLovin, IronSource ve bunlara bağlı teklif verme iş ortakları), ATT kapsamında uygulama yüklemelerini doğru şekilde ilişkilendirebilmek 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 panellerinden alın (AppLovin, IronSource ve AdMob ayrı ayrı 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'te sizin adınıza ATT izni istemez. IDFA'nın AdMob/AppLovin/IronSource arabuluculuğu ve AppsFlyer/Adjust ilişkilendirmesi için kullanılabilir olmasını 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 bu iki adımın zaten tamamlandığını varsaymayın.
3.4 GoogleService-Info.plist
Firebase'in GoogleService-Info.plist dosyasını uygulama hedefinize her zamanki yöntemle ekleyin (kaynak klasörünüze sürükleyin ve hedefe dahil edildiğinden emin olun). Burada AKS'ye özgü bir işlem 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ını kullanır. Uygulama hedefinizin IPHONEOS_DEPLOYMENT_TARGET değerini 15.0 veya üzeri olarak ayarlayın. Podfile içindeki post_install (§1.2) işleminin de 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 seçmek zaten pod'larla sorunsuz bağlanmayı engeller.