App Tracking Transparencyの設定

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

承認ステータス

アプリトラッキング承認ラッパー

requestTrackingAuthorizationWithCompletionHandler(): Promise<number >

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

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

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

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

例

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

var adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
Adjust.requestTrackingAuthorizationWithCompletionHandler(function (status) {
   switch (status) {
      case 0:
         console.log("The user has not responded to the access prompt yet.");
         break;
      case 1:
         console.log(
            "Access to app-related data is blocked at the device level.",
         );
         break;
      case 2:
         console.log(
            "The user has denied access to app-related data for device tracking.",
         );
         break;
      case 3:
         console.log(
            "The user has approved access to app-related data for device tracking.",
         );
         break;
   }
});
Adjust.create(adjustConfig);

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

getAppTrackingAuthorizationStatus(): Promise<number >

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

1
Adjust.getAppTrackingAuthorizationStatus();

例

この例では、ユーザーの認証ステータスを収集し、Stringに変換する方法を示しています。この情報はauthorizationStatusという変数に割り当てられ、"status"というキーでセッション パートナー パラメーターとしてパスされます。

1
var authorizationStatus = async () => {
2
   let statusNumber = await Adjust.getAppTrackingAuthorizationStatus();
3
   return statusNumber;
4
};
5
Adjust.addSessionPartnerParameter("status", authorizationStatus);

承認ステータスの変更を確認する

checkForNewAttStatus(): void

カスタムATTプロンプトを使用する場合、ユーザーの認証ステータスに変更があった場合、Adjust SDKに通知する必要があります。checkForNewAttStatusメソッドを呼び出し、Adjustサーバーに認証ステータスを送信してください。

1
Adjust.checkForNewAttStatus();