App Tracking Transparencyの設定

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

承認ステータス

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

ATT承認ラッパー

public static void RequestAppTrackingAuthorization(Action<int> callback)

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

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

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

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

例

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

1
Adjust.RequestAppTrackingAuthorization((status) =>
2
{
3

4
    switch (status)
5
    {
6
        case 0:
7
            Debug.Log("The user hasn't responded to the access prompt yet.");
8
            break;
9
        case 1:
10
            Debug.Log("Access to app-related data is blocked at the device level.");
11
            break;
12
        case 2:
13
            Debug.Log("The user has denied access to app-related data for device measurement.");
14
            break;
15
        case 3:
16
            Debug.Log("The user has approved access to app-related data for device measurement.");
17
            break;
18
    }
19
});

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

public static int GetAppTrackingAuthorizationStatus()

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

1
Adjust.GetAppTrackingAuthorizationStatus();

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

public int? AttConsentWaitingInterval { get; set; }

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

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
2
//...
3
adjustConfig.AttConsentWaitingInterval = 30;
4
//...
5
Adjust.InitSdk(adjustConfig);

AppTrackingTransparencyの使用を無効にする

public bool? IsAppTrackingTransparencyUsageEnabled { get; set; }

Adjust SDKによるAppTrackingTransparency.frameworkとの自動連携を無効化したい場合は、SDKの初期化前にAdjustConfigインスタンスのIsAppTrackingTransparencyUsageEnabledプロパティをfalseに設定してください。

1
AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
2
config.IsAppTrackingTransparencyUsageEnabled = false;
3
// ...
4
Adjust.InitSdk(config)