はじめにSKAdNetworkとSKAN
SingularのiOS SDKはSKAdNetworkとの統合を簡素化し、マルチポストバック、階層的ソースID、粗視化変換値などのSKAN 4.0の機能をサポートします。SingularのオープンソースSKAN標準に基づき、簡単なセットアップと広告ネットワークとの互換性を保証します。セットアップの詳細については、SingularのSKAdNetworkガイドをご覧ください。
SKAdNetworkトラッキングのサポート
ヒント：Singular SDKを使用する場合、SKAdNetworkトラッキングはデフォルトで有効になっています。
SKAdNetworkのサポートを無効またはオフにするには：
- SingularConfigオブジェクトをビルドする際に、skAdNetworkEnabled設定メソッドをFALSE 。
AppTrackingTransparency（ATT）の処理
iOS 14.5+（iOS 18を含む）では、ATTrackingManager 、トラッキングのためにIDFAにアクセスする前にユーザーの同意を求めます。SingularのiOS SDK (v12.x)はATTをサポートし、同意前の初期化を許可し、同意が得られるかタイムアウトが発生するまでイベントを遅らせます。これにより、Appleのプライバシールールに準拠し、SKAdNetwork (SKAN) 4.0との互換性が保証されます。
実装
-
ATTフレームワークを追加する：
- あなたのXcodeプロジェクトにAppTrackingTransparency 。
- Info.plist をNSUserTrackingUsageDescription で更新してください（例："This app uses tracking to personalize ads."）。
-
ATTの同意を求める：
- UX戦略に基づいて、アプリの起動時またはオンボーディング後に同意を求めます。
- SingularのSDKを使用して、同意前の初期化を処理します。
-
Singular SDKを設定します：
- SingularのSDKを設定する。 waitForTrackingAuthorizationWithTimeoutIntervalSingularConfigオブジェクトを構築する際に設定メソッドを設定し、ATT同意が解決されるか、タイムアウト（30秒など）が切れるまでイベントを遅延させます。
ベストプラクティス
- プロンプトタイミング：IDFAの可用性を最大化するためにアプリの起動時にATT同意を要求するか、ユーザーのコンテキストを改善するためにオンボーディングの後まで遅らせます。同意率とUXのバランスをとるために両方をテストしてください。
- タイムアウト：waitForTrackingAuthorizationWithTimeoutInterval を30～300秒に設定します。タイムアウト後、SingularはSKAN 4.0のアトリビューションで処理を進めます（IDFAは使用しません）。
- SKAN 4.0の統合：SKANのポストバックを最適化するために、コンバージョン値の更新がATTの同意と一致するようにします（例えば、イベントを値0～63にマッピングするためにSingularのダッシュボードを使用します）。
- エラー処理：restricted (ペアレンタルコントロールなど) またはnotDetermined の状態についてATTrackingManager.trackingAuthorizationStatus をチェックし、分析のためにログを記録する。
手動変換値の処理
マネージドモード
デフォルトでは、SKAdNetworkの実装はSingularサーバーサイドから直接変換値を管理します。
これにより、クライアントサイドのコードを変更することなく、Singularプラットフォームを通してコンバージョン値を設定・変更することができ、最大限の柔軟性が得られます。
このサーバー側の管理モードは、SKAdNetworkのタイマーの処理にも役立ちます。SKAdNetworkでは、SKAdNetworkへの登録から24時間以内にコンバージョン値を更新することができます。コンバージョン値の更新を呼び出すと、タイマーはさらに24時間延長されます。そのため、コンバージョンイベントを選択する際は、その更新ウィンドウ内でイベントが発生するようにする必要があります。マネージドモードでは、アプリの新しいバージョンをリリースすることなく、いつでもコンバージョンイベントの設定を変更することができます。
手動モード
自分でコンバージョン値を更新したい場合：
- を設定します。 withManualSkanConversionManagementコンフィギュレーションメソッドを設定します。
- そして変換値を更新するために、アプリの必要な場所で skanUpdateConversionValueメソッドを使用してください。
- または、SKAdNetwork 4.0の変換値を手動で更新するには、アプリのライフサイクルの必要な場所で skanUpdateConversionValuesメソッドを使用してください。
注意： 初期化時にSDKを手動更新に設定していない場合、skanUpdateConversionValueメソッドは機能しません。
変換値の取得
現在の変換値を取得するには skanGetConversionValueメソッドを使用します。このメソッドはマネージドモードでもマニュアルモードでも動作します。