SKAdNetworkとconversion valueの設定

SKAdNetworkは、アプリのインストールおよび再インストールのアトリビューションのための、Appleのアトリビューションフレームワークです。SKAdNetworkのワークフローは以下のようになります：

1. Appleがアトリビューション情報を収集し、関連するアドネットワークに通知します。
2. ネットワークがこの情報をAdjustにポストバックで送信します。
3. AdjustはSKAdNetworkデータをDatascapeおよびデータキャンバスに表示します。

Conversion valueのアップデートを受信する

Adjustを使用してconversion valueを管理している場合、Adjustバックエンドはconversion valueのアップデートをSDKに送信します。adjustConversionValueUpdatedメソッドを使用して、こうした変更を受信するデリゲート関数を設定できます。

func adjustConversionValueUpdated(_ conversionValue: NSNumber?){
    print("Conversion value: (conversionValue ?? 0)")
}

SKAdNetwork 4.0コールバック

SKAdNetwork 4.0のポストバックにはいくつかの追加情報が含まれており、広告主はユーザーに関する詳細なインサイトを得ることができます。この追加情報は、Adjustバックエンドによってconversion valueがアップデートされるときにペイロードで送信されます。この情報には、adjustConversionValueUpdatedコールバックメソッドを使用してアクセスできます。

func adjustConversionValueUpdated(_ fineValue: NSNumber?, coarseValue: String?, lockWindow: NSNumber?){
    print("Fine conversion value: (fineValue ?? 0)")
    print("Coarse conversion value: (coarseValue ?? "")")
    print("Will send before conversion value window ends: (lockWindow?.boolValue ?? nil)")
}

Conversion valueを更新する

Conversion valueは、SKAdNetworkでアプリ内のユーザー行動を計測するためのメカニズムです。64の条件を0～63の値に対応させ、ユーザーのインストール時にこの整数値をSKAdNetworkに送信することができます。これによって、はじめの3日間のユーザー行動に関するインサイトを取得することが可能です。

Adjustでconversion valueを管理している場合、バックエンドはSDKでこの値を更新します。また、updateConversionValueメソッドを使用して、この値を更新することができます。このメソッドはAppleのupdateConversionValueメソッドをラップしており、更新されたconversion valueを表す整数の引数を受け入れます。

[Adjust updateConversionValue:value];

func onButtonClick() {
   Adjust.updateConversionValue(10)
}

完了ハンドラーの設定

Adjust SDKには、AppleのupdatePostbackConversionValueメソッドのラッパーが含まれています。これらのメソッドを使用すると、エラーを処理するオプションを含め、より多くの方法でSKAdNetworkポストバックを処理できます。

以下のメソッドがサポートされます。

• updatePostbackConversionValue(_:completionHandler:) – conversion valueをアップデートし、エラーを処理します。
• updatePostbackConversionValue(_:completionHandler:coarseValue:) – 粗い粒度と細かい粒度の両方のconversion valueをアップデートし、エラーを処理します。
• updatePostbackConversionValue(_:coarseValue:lockWindow:completionHandler:) – 粗い粒度と細かい粒度の両方のconversion valueをアップデートし、conversion value期間の終了前にポストバックを送信するかどうかを決定し、エラーを処理します。

例

if #available(iOS 16.1, *) {
    Adjust.updatePostbackConversionValue(
        1,
        coarseValue: SKAdNetwork.CoarseConversionValue.low.rawValue,
lockWindow: false) { error in
        if let error {
            print(String(format: "An error occurred during completion: %a", error))
        }
    }
}

ダイレクトインストールポストバックの設定

獲得したSKAdNetworkコールバックのコピーをAdjustに送信するようにアプリを設定できます。これにより、SKAdNetworkの情報をアナリティクスで使用できるようになります。

ダイレクトインストールポストバックを設定するには、Info.plistファイルにAdjustのコールバックURLを追加してください。

1. XcodeのプロジェクトナビゲーターでInfo.plistを選択します。
2. プロパティリストエディタでキーの横にある追加ボタン（ ＋​ ）を選択し、 リターン​ キーを押します。
3. キーネームに ​NSAdvertisingAttributionReportEndpoint​ を追加します。
4. ポップアップ画面で Type​ から String​ までを設定します。
5. URL ​https://adjust-skadnetwork.com​ を入力します。

詳しくはAppleのガイドConfiguring an Advertised Appをご覧ください。

SKAdNetworkの通信を無効化する

Adjust SDKはv4.23.0以降ではデフォルトでSKAdNetworkと通信を行います。SDKは初期化時にSKAdNetworkのアトリビューションを記録します。

Configオブジェクトにはブーリアン値のisSKAdNetworkHandlingActiveプロパティが含まれており、それが動作を制御します。SKAdNetworkとの通信を非有効化するには、引数なしでdeactivateSKAdNetworkHandlingメソッドを呼び出してください。

[adjustConfig.deactivateSKAdNetworkHandling];