adjust-icon

SKAdNetworkとconversion valueの設定

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

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

Disable SKAdNetwork communication

メソッドシグネチャー
public deactivateSKAdNetworkHandling(): void
v4.23.0に追加

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

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

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


adjustConfig.deactivateSKAdNetworkHandling();


Adjust.create(adjustConfig);

Update conversion values

メソッドシグネチャー
updateConversionValue: (conversionValue: number) => void

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

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

Adjust.updateConversionValue(6);

Example

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

function _onPress_trackSimpleEvent() {
   Adjust.updateConversionValue(10);
}

Listen for changes to conversion values

メソッドシグネチャー
public setConversionValueUpdatedCallbackListener(
   callback: (conversionValue: AdjustConversionValue) => void
): void

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

const adjustConfig = new AdjustConfig(appToken, environment);


adjustConfig.setConversionValueUpdatedCallbackListener(
   function (conversionValue) {
      console.log("Conversion value updated callback recveived");
      console.log("Conversion value: " + conversionValue.conversionValue);
   },
);


Adjust.create(adjustConfig);

Example

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

  • conversion valueのアップデートを確認するメッセージ
  • 新しいconversion value
import { Adjust, AdjustEvent, AdjustConfig } from "react-native-adjust";
import { AdjustOaid } from "react-native-adjust-oaid";


const App: () => React$Node = () => {
   Adjust.getSdkVersion(function (sdkVersion) {
      console.log("Adjust SDK version: " + sdkVersion);
   });


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


   adjustConfig.setConversionValueUpdatedCallbackListener(function (
      conversionValue
   ) {
      console.log("Conversion value updated. Callback received");
      console.log("Conversion value: " + conversionValue.conversionValue);
   });


   Adjust.create(adjustConfig);
};


export default App;

SKAdNetwork 4.0 callbacks

v4.33.0に追加

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

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

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

Example

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

import { Adjust, AdjustEvent, AdjustConfig } from "react-native-adjust";
import { AdjustOaid } from "react-native-adjust-oaid";


const App: () => React$Node = () => {
   Adjust.getSdkVersion(function (sdkVersion) {
      console.log("Adjust SDK version: " + sdkVersion);
   });


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


   adjustConfig.setSkad4ConversionValueUpdatedCallbackListener(function (
      conversionValue, coarseValue, lockWindow
   ) {
      console.log("Conversion value updated. Callback received");
      console.log("Fine conversion value: " + conversionValue);
      console.log("Coarse conversion value: " + coarseValue);
      console.log("Will send before conversion value window ends: " + lockWindow.toString());
   });


   Adjust.create(adjustConfig);
};


export default App;

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