SKAdNetworkとconversion valueの設定

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

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

SKAdNetworkの通信を無効化する

public disableSkanAttribution(): void

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

1
const adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5

6
adjustConfig.disableSkanAttribution();
7

8
Adjust.initSdk(adjustConfig);

Conversion valueを更新する

updateSkanConversionValue: (conversionValue: number, coarseValue: string, lockWindow: boolean, callback: (error: string) => void) => void

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

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`となっています。

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

Conversion valueの変更を受信する

public setSkanUpdatedCallback(
      callback: (skanData: AdjustSkanData) => void
    ): void

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

1
const adjustConfig = new AdjustConfig(appToken, environment);
2

3
adjustConfig.setSkanUpdatedCallback(function (skanData) {
4
   console.log("Conversion value: " + skanData.conversionValue);
5
   console.log("Coarse value: " + skanData.coarseValue);
6
   console.log("Lock window: " + skanData.lockWindow);
7
   console.log("Error: " + skanData.error);
8
});
9

10
Adjust.initSdk(adjustConfig);

例

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

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

1
import { Adjust, AdjustEvent, AdjustConfig } from "react-native-adjust";
2

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

8
   const adjustConfig = new AdjustConfig(
9
      "{YourAppToken}",
10
      AdjustConfig.EnvironmentSandbox
11
   );
12

13
  adjustConfig.setSkanUpdatedCallback(function (skanData) {
14
   console.log("Conversion value: " + skanData.conversionValue);
15
   console.log("Coarse value: " + skanData.coarseValue);
16
   console.log("Lock window: " + skanData.lockWindow);
17
   console.log("Error: " + skanData.error);
18
});
19

20
   Adjust.initSdk(adjustConfig);
21
};
22

23
export default App;

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

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

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

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