SKAdNetworkとconversion valueの設定

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

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

Disable SKAdNetwork communication

- (void)deactivateSKAdNetworkHandling;

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

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

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
//...
7
adjustConfig.deactivateSKAdNetworkHandling()
8
//...
9
Adjust.appDidLaunch(adjustConfig)

1
*adjustConfig = [ADJConfig configWithAppToken:@"{YourAppToken}"
2
                                 environment:ADJEnvironmentSandbox];
3
[adjustConfig.deactivateSKAdNetworkHandling];
4
/// ...
5
[Adjust appDidLaunch:adjustConfig];

Update conversion values

+ (void)updateConversionValue:(NSInteger)conversionValue;

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

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

1
Adjust.updateConversionValue(value)

1
[Adjust updateConversionValue:value];

Example

この例では、ユーザーがイベントをトリガーしたことに応じて、conversion valueを10に更新する方法を示しています。

1
func onButtonClick() {
2
   Adjust.updateConversionValue(10)
3
}

1
- (void)onButtonClick {
2
   [Adjust updateConversionValue:10];
3
}

Set up completion handlers

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

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

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

Example

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

1
if (@available(iOS 16.1, *)) {
2
  [Adjust updatePostbackConversionValue:1
3
                            coarseValue:SKAdNetworkCoarseConversionValueLow
4
                             lockWindow:NO
5
                      completionHandler:^(NSError *_Nullable error) {
6
                        NSLog(@"An error occurred during completion: %a", error);
7
                      }];
8
}

Listen for changes to conversion values

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

Example

この例では、conversion valueが更新されたときに以下を記録する方法を示しています：

• conversion valueのアップデートを確認するメッセージ
• 新しいconversion value

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

1
- (void)adjustConversionValueUpdated:(NSNumber *)conversionValue {
2
    NSLog(@"Conversion value: %@", conversionValue);
3
}

SKAdNetwork 4.0 callbacks

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

Example

この例では、粒度が細かいconversion value、粒度が粗いconversion value、SKAdNetworkポストバックがconversion期間の終了前に送信されるよう設定されているかどうかをログに記録する方法を示しています。

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

1
- (void)adjustConversionValueUpdated:(NSNumber *)fineValue coarseValue:(NSString *)coarseValue lockWindow:(NSNumber *)lockWindow {
2
    NSLog(@"Fine conversion value: %@", fineValue);
3
    NSLog(@"Coarse conversion value: %@", coarseValue);
4
    NSLog(@"Will send before conversion value window ends: %u", [lockWindow boolValue]);
5
}

Set up direct install postbacks

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

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

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