SKAdNetworkとconversion valueの設定

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

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

Disable SKAdNetwork communication

bool? isSkanAttributionEnabled;

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

この動作は、AdjustConfigインスタンスのisSkanAttributionEnabledプロパティをbool値に設定することで制御できます。

1
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox, true);
2
//...
3
adjustConfig.isSkanAttributionEnabled = false;
4
//...
5
Adjust.initSdk(adjustConfig);

Update conversion values

static Future<String?> updateSkanConversionValue(int conversionValue, String coarseValue, bool lockWindow)

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

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

1
Adjust.updateSkanConversionValue(6, 'coarse-value', true).then((error) {
2
    // error is present in case it happens
3
});

Listen for changes to conversion values

typedef void SkanUpdatedCallback(Map<String, String> skanUpdateData);
SkanUpdatedCallback? skanUpdatedCallback;

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

1
AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
2
adjustConfig.skanUpdatedCallback = (Map<String, String> data) {
3
    print(Skan Callback: $data');
4
};
5
   print('[Adjust]: Received conversion value update: ' + conversionValue!.toString());
6
};
7
Adjust.initSdk(adjustConfig);

Example

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

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

import 'package:adjust_sdk/adjust.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

initPlatformState() async {
   AdjustConfig config =
      new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
   config.logLevel = AdjustLogLevel.verbose;

config.conversionValueUpdatedCallback = (num? conversionValue) {
      print('[Adjust]: Received conversion value update: ' +
         conversionValue!.toString());
   };

Adjust.initSdk(config);

}

SKAdNetwork 4.0 callbacks

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

Example

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

1
import 'package:adjust_sdk/adjust.dart';
2
import 'package:flutter/cupertino.dart';
3
import 'package:flutter/material.dart';
4
import 'package:flutter/services.dart';
5

6
initPlatformState() async {
7
   AdjustConfig config =
8
      new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
9
   config.logLevel = AdjustLogLevel.verbose;
10

11
   config.skanUpdatedCallback = (Map<String, String> skanUpdateData) {
12
      // process skanUpdateData map
13
      // example: {conversion_value: 0, lock_window: false, coarse_value: low}
14
         print('[Adjust]: Conversion value updated. Callback received');
15
         print('[Adjust]: Conversion value: ' + conversionValue!.toString());
16
         print('[Adjust]: Coarse conversion value: ' + coarseValue!);
17
         print('[Adjust]: Will send before conversion value window ends: ' lockWindow!.toString());
18
   };
19

20
   Adjust.initSdk(config);
21
}

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 を入力します。