App Tracking Transparencyの設定

広告識別子（IDFA）を記録したい場合は、ユーザーの承認を得るためのプロンプトを表示する必要があります。これを行うには、アプリにAppleのAppTrackingTransparency（ATT）フレームワークを組み込む必要があります。Adjust SDKはユーザーの承認状況を保存し、リクエストごとにそれをAdjustサーバーに送信します。

承認ステータス

ステータス	コード	説明
`ATTrackingManagerAuthorizationStatusNotDetermined`	`0`	ユーザーがアクセスプロンプトに応答していない
`ATTrackingManagerAuthorizationStatusRestricted`	`1`	アプリ関連データへのアクセスがデバイスレベルでブロックされている
`ATTrackingManagerAuthorizationStatusDenied`	`2`	ユーザーがデバイス計測によるアプリ関連データへのアクセスを拒否
`ATTrackingManagerAuthorizationStatusAuthorized`	`3`	ユーザーがデバイス計測によるアプリ関連データへのアクセスを承認

ATT承認ラッパー

requestAppTrackingAuthorization(): Promise<number>

Adjust SDKには、AppleのrequestTrackingAuthorizationWithCompletionHandler:メソッドのラッパーが含まれています。ATTプロンプトをカスタマイズしない場合は、このラッパーを使用することができます。

コールバックメソッドは、ユーザーが同意ダイアログに応答した時にトリガーされ、ユーザーの同意ステータスコードをAdjustサーバーに送信します。コールバック関数内で各ステータスコードに対するレスポンスを定義することができます。

ATTのテキスト内容を指定する必要があります。これを行うには、Info.plistファイルでNSUserTrackingUsageDescriptionキーにテキストを追加してください。

1
Adjust.requestAppTrackingAuthorization(function (status) {
2
   print("Authorization status update!");
3
   switch (status) {
4
      case 0:
5
         // ATTrackingManagerAuthorizationStatusNotDetermined case
6
         break;
7
      case 1:
8
         // ATTrackingManagerAuthorizationStatusRestricted case
9
         break;
10
      case 2:
11
         // ATTrackingManagerAuthorizationStatusDenied case
12
         break;
13
      case 3:
14
         // ATTrackingManagerAuthorizationStatusAuthorized case
15
         break;
16
   }
17
});

例

この例では、ユーザーがプロンプトと対話したときに、ユーザーの認証状態について人間が読み取れる説明をログに記録する方法を示しています。

1
Adjust.requestAppTrackingAuthorization(function (status) {
2
   print("Authorization status update!");
3
   switch (status) {
4
      case 0:
5
         console.log("The user has not responded to the access prompt yet.");
6
         break;
7
      case 1:
8
         console.log(
9
            "Access to app-related data is blocked at the device level.",
10
         );
11
         break;
12
      case 2:
13
         console.log(
14
            "The user has denied access to app-related data for device measurement.",
15
         );
16
         break;
17
      case 3:
18
         console.log(
19
            "The user has approved access to app-related data for device measurement.",
20
         );
21
         break;
22
   }
23
});

現在の承認ステータスを取得する

getAppTrackingAuthorizationStatus(): Promise<number>

ユーザーの現在の認証ステータスはいつでも取得することができます。getAppTrackingAuthorizationStatusメソッドを呼び出し、numberで認証ステータスコードを返してください。

1
Adjust.getAppTrackingAuthorizationStatus(function (status) {
2
   // check status value
3
});

プロンプトのタイミングをカスタム設定する

setAttConsentWaitingInterval(attConsentWaitingInterval: number): void

アプリにオンボーディングプロセスまたはチュートリアルが含まれる場合、ユーザーがこのプロセスを完了するまで、ユーザーのATT同意ステータスの送信を遅らせたい場合があります。これを行うには、attConsentWaitingIntervalプロパティを設定して、データの送信を 最大360秒 遅延させ、ユーザーに最初のオンボーディングを完了する時間を与えることができます。タイムアウトが終了した後、またはユーザーが同意ステータスを設定した後に、SDKはユーザーの同意ステータスと共に遅延中に記録した全ての情報をAdjustのサーバーに送信します。

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

7
Adjust.initSdk(adjustConfig);

AppTrackingTransparencyの使用を無効にする

disableAppTrackingTransparencyUsage(): void

Adjust SDKによるAppTrackingTransparency.frameworkとの自動連携を無効化したい場合は、SDKの初期化前にAdjustConfigインスタンスでdisableAppTrackingTransparencyUsageメソッドを呼び出してください。

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

7
Adjust.initSdk(adjustConfig);