adjust-icon

SKAdNetworkとConversion valueの設定

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

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

SKAdNetworkの通信を無効化

メソッドシグネチャー
disableSkanAttribution(): void

Configオブジェクトにはboolean isSkanAttributionEnabledプロパティが含まれており、それが動作を制御します。SKAdNetworkとの通信を無効にするには、disableSkanAttributionメソッドを呼び出してください。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);


adjustConfig.disableSkanAttribution();


Adjust.initSdk(adjustConfig);

Conversion valueを更新する

メソッドシグネチャー
updateSkanConversionValue(conversionValue: number, coarseValue: string, lockWindow: boolean): Promise<string>

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

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

引数データタイプ説明
conversionValue数値指定するConversion value。0～63の値にする必要があります。
coarseValue文字列（SKAdNetwork.CoarseConversionValue）粗いConversion value。この値は、プライバシーのしきい値に到達するだけのアプリインストール数でない場合に使用されます。
  • 'low' SKAdNetworkCoarseConversionValueLow対象
  • 'medium' SKAdNetworkCoarseConversionValueMedium対象
  • 'high' SKAdNetworkCoarseConversionValueHigh対象
lockWindowブーリアンConversion期間の終了前にポストバックを送信するかどうか。
trueを指定した場合、conversion期間の終了を待たずにポストバックを送信するようにシステムに指示します。デフォルトの設定はfalseとなっています。
Adjust.updateSkanConversionValue(6, "low", true, function (error) {
   // error is present in case it happened
});

Conversion valueの変更を受信

メソッドシグネチャー
setSkanUpdatedCallback(skanUpdatedCallback: (skanData: AdjustSkanData) => void): void

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

const adjustConfig = new AdjustConfig(appToken, environment);


adjustConfig.setSkanUpdatedCallback(function (skanData) {
   console.log("Conversion value: " + skanData.conversionValue);
   console.log("Coarse value: " + skanData.coarseValue);
   console.log("Lock window: " + skanData.lockWindow);
   console.log("Error: " + skanData.error);
});


Adjust.initSdk(adjustConfig);

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

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

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

  1. Xcodeのプロジェクトナビゲーターで Info.plist を選択します。
  2. プロパティリストエディタでキーの横にある追加ボタンを選択し、Returnキーを押します。
  3. 以下のキーを追加します。

SKAdNetworkの場合

  • キー： Advertising attribution report endpoint URL (または NSAdvertisingAttributionReportEndpoint のRawキー表現)
  • タイプ： 文字列
  • 値： https://adjust-skadnetwork.com

AdAttributionKitの場合

  • キー： AdAttributionKit - Postback Copy URL (または AttributionCopyEndpoint のRawキー表現)
  • タイプ： 文字列
  • 値： https://adjust-skadnetwork.com