adjust-icon

SKAdNetworkとconversion valueの設定

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

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

SKAdNetworkの通信を無効化する

プロパティ宣言
public bool? IsSkanAttributionEnabled { get; set; }

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

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.IsSkanAttributionEnabled = false;
//...
Adjust.InitSdk(adjustConfig);

Conversion valueの変更を受信する

プロパティ宣言
public Action<Dictionary<string, string>> SkanUpdatedDelegate { get; set; }

Adjustを使用してconversion valueを管理している場合、Adjustのサーバーはconversion valueのアップデートをSDKに送信します。AdjustConfigインスタンスのSkanUpdatedDelegateプロパティに関数を割り当て、こうした変更を受信するデリゲート関数を設定することができます。

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
//...
Adjust.InitSdk(adjustConfig);

デリゲート関数は、以下のプロパティを持つSKAdNetworkからポストバックを受信します。

引数説明
fine_valueAdjustサーバーから送信されるconversion value。
coarse_value粒度が粗いconversion value。この値は、プライバシーのしきい値に到達するだけのアプリインストール数でない場合に使用されます。
  • none
  • low
  • medium
  • high

Appleは、low, medium, highに設定された条件がいずれも満たされなかった場合、noneを送信します。
lock_windowConversion期間の終了前にポストバックを送信するかどうか。1の場合、conversion期間の終了前にポストバックが送信されることを示します。
デフォルト値は、SKAdNetwork 4.0のポストバックでは0、それ以前のSKAdNetworkのポストバックではnilになります。
errorエラーが発生した場合は、エラーメッセージを含む。

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

using com.adjust.sdk;
public class ExampleGUI : MonoBehaviour {
void OnGUI() {
if (GUI.Button(new Rect(0, 0, Screen.width, Screen.height), "callback")) {
AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.LogLevel = AdjustLogLevel.Verbose;
adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
Adjust.InitSdk(adjustConfig);
}
private void SkanUpdatedDelegate(Dictionary<string,string> response) {
Debug.Log("Conversion value updated. Callback received");
Debug.Log("Conversion value: " + response["fine_value"]);
Debug.Log("Coarse conversion value: " + response["coarse_value"]);
Debug.Log ("Will send before conversion value window ends: " response["lock_window"]);
Debug.Log("Error message: " response["error"]);
}
}
};

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

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

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

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