Apps Kit SDK logoApps Kit SDK
ドキュメント · iOS 連携

3. プロジェクト設定

3.1 AdMob アプリ ID

有効にしている広告ネットワークに AdMob/GAM が含まれる場合は、ご自身の AdMob アプリ ID を Info.plist に追加してください(アプリ固有の値のため、xcframework 内には同梱できません)。

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

3.2 SKAdNetworkItems

AKS が利用するメディエーション/アトリビューションネットワーク(AppLovin、IronSource、およびそれらの入札パートナー)が ATT のもとでインストールのアトリビューションを正しく行うには、SKAdNetworkIdentifier のエントリが必要です。リファレンスアプリには、AppLovin、IronSource、Meta などのメディエーションパートナーをカバーする約 48 件のエントリが含まれています。各ネットワークは随時新しい ID を追加するため、古いリストをコピーするのではなく、利用する広告ネットワークの管理画面から最新のリストを取得してください(AppLovin、IronSource、AdMob がそれぞれ公開しています)。

3.3 App Tracking Transparency(ATT)— ご自身での追加対応が必要

注意: リファレンス実装には、NSUserTrackingUsageDescription も ATTrackingManager.requestTrackingAuthorization() の呼び出しも含まれていません。AKS は、iOS でアプリに代わって ATT の許可ダイアログを表示しません。AdMob/AppLovin/IronSource のメディエーションや AppsFlyer/Adjust のアトリビューションで IDFA を利用できるようにするには、両方をご自身で追加する必要があります。

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

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

使用目的の説明文を設定せずに requestTrackingAuthorization を呼び出すと、実行時にクラッシュします。必ず Info.plist のキーとあわせて呼び出しを追加してください。SDK を組み込んだからといって、どちらかがすでに対応済みだとは考えないでください。

3.4 GoogleService-Info.plist

通常の手順で、Firebase の GoogleService-Info.plist をアプリターゲットに追加してください(ソースフォルダにドラッグし、ターゲットメンバーシップを確認します)。AKS 固有の設定はなく、Firebase の標準的なセットアップ手順をそのまま適用できます。

3.5 デプロイメントターゲット

AppsKit.xcframework/AKSKit.xcframework は、最低対応バージョンを iOS 15.0 として、Swift 5.9(Xcode 15.2 以降)でビルドされています。また、モジュールの安定性を確保するために BUILD_LIBRARY_FOR_DISTRIBUTION: YES が設定されています。アプリターゲットの IPHONEOS_DEPLOYMENT_TARGET は 15.0 以上に設定してください。なお、Podfile の post_install(§1.2)でも、すべての pod ターゲットが強制的に 15.0 に設定されます。そのため、アプリ側のターゲットをそれより低く設定しても、pod と正常にリンクできません。