App Tracking Transparencyの設定

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

承認ステータス

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

ATT承認ラッパー

static Future<num> requestTrackingAuthorizationWithCompletionHandler() async

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

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

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

if (Platform.isIOS) {
   Adjust.requestTrackingAuthorizationWithCompletionHandler().then((status) {
      switch (status) {
         case 0:
            // ATTrackingManagerAuthorizationStatusNotDetermined case
            break;
         case 1:
            // ATTrackingManagerAuthorizationStatusRestricted case
            break;
         case 2:
            // ATTrackingManagerAuthorizationStatusDenied case
            break;
         case 3:
            // ATTrackingManagerAuthorizationStatusAuthorized case
            break;
      }
   });
}

例

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

import 'package:adjust_sdk/adjust.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

initPlatformState() async {
   AdjustConfig config =
      new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
      config.logLevel = AdjustLogLevel.verbose;

Adjust.requestTrackingAuthorizationWithCompletionHandler().then((status) {
      print('[Adjust]: Authorization status update!');
      switch (status) {
         case 0:
         print(
            'The user has not responded to the access prompt yet.');
         break;
         case 1:
         print(
            'Access to app-related data is blocked at the device level.');
         break;
         case 2:
         print(
            'The user has denied access to app-related data for device measurement.');
         break;
         case 3:
         print(
            'The user has approved access to app-related data for device measurement.');
         break;
      }
   });

   Adjust.start(config);
}

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

static Future<int> getAppTrackingAuthorizationStatus() async

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

Adjust.getAppTrackingAuthorizationStatus();

例

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

String authorizationStatus = Convert.ToString(Adjust.getAppTrackingAuthorizationStatus());
Adjust.addSessionPartnerParameter("status", authorizationStatus);

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

static void checkForNewAttStatus()

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

Adjust.checkForNewAttStatus();

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

num? attConsentWaitingInterval;

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

AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.attConsentWaitingInterval = 30;
//...
Adjust.start(adjustConfig);