SKAdNetworkとconversion valueの設定

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

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

Disable SKAdNetwork communication

- (void)disableSkanAttribution;

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

SKAdNetworkとの通信を非有効化するには、引数なしでdisableSkanAttributionメソッドを呼び出してください。

Swift
Objective-C

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

1
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}"
2
                                            environment:ADJEnvironmentSandbox];
3
[adjustConfig disableSkanAttribution];
4
/// ...
5
[Adjust initSdk:adjustConfig];

Update conversion values

+ (void)updateSkanConversionValue:(NSInteger)conversionValue
                      coarseValue:(nullable NSString *)coarseValue
                       lockWindow:(nullable NSNumber *)lockWindow
            withCompletionHandler:(void (^_Nullable)(NSError *_Nullable error))completion;

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

Adjustでconversion valueを管理している場合、AdjustのサーバーはSDKでこの値を更新します。また、updateSkanConversionValueメソッドを使用して、この値を更新することが可能です。以下の引数を受け入れます。

引数	データタイプ	説明
`fineValue`	整数	Conversion value。`0`～`63`の値にする必要があります。
`coarseValue`	`SKAdNetwork.CoarseConversionValue`	粒度が粗いconversion value。この値は、プライバシーのしきい値に到達するだけのアプリインストール数でない場合に使用されます。 `SKAdNetworkCoarseConversionValueLow` `SKAdNetworkCoarseConversionValueMedium` `SKAdNetworkCoarseConversionValueHigh`
`lockWindow`	Boolean	Conversion期間の終了前にポストバックを送信するかどうか。 `true`を指定した場合、conversion期間の終了を待たずにポストバックを送信するようにシステムに指示します。デフォルトの設定は`false`となっています。
`completion`	機能	オプションの完了ハンドラー。conversion valueのアップデート時にこのメソッドで発生するエラーをキャッチして処理するために指定します。ハンドラーを指定しない場合は、この値を`nil`に設定します。

Swift
Objective-C

1
Adjust.updateSkanConversionValue(
2
    1,
3
    coarseValue: SKAdNetwork.CoarseConversionValue.low,
4
    lockWindow: false) { error in
5
    if let error {
6
        print(String(format: "An error occurred during completion: %@", error))
7
    }
8
}

1
[Adjust updateSkanConversionValue:1
2
                        coarseValue:SKAdNetworkCoarseConversionValueLow
3
                        lockWindow:NO
4
               withCompletionHandler:^(NSError *_Nullable error) {
5
      NSLog(@"An error occurred during completion: %@", error);
6
}];

SKAdNetwork callbacks

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

conversion_value: The updated conversion value.
coarse_value: The updated coarse conversion value
lock_window: Whether to send the postback before the conversion window ends
error: Any error message returned by the update.

Example

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

Swift
Objective-C

1
func adjustSkanUpdated(withConversionData data: [String: String]) {
2
    print("Conversion value updated callback called!")
3
    print(String(format: "Conversion value dictionary: \n%@", data.description))
4
}

1
- (void)adjustSkanUpdatedWithConversionData:(NSDictionary<NSString *, NSString *> *)data {
2
    NSLog(@"Conversion value updated callback called!");
3
    NSLog(@"Conversion value dictionary: \n%@", data.description);
4
}

Set up direct install postbacks

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

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

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