App Tracking Transparencyの設定

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

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

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

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

トラッキング リクエスト ダイアログのテキスト内容を特性する必要があります。これをプロジェクトに追加する方法は2つあります。

1. Adjustプレハブの User Tracking Description​ フィールドにテキストを追加します。
2. Info.plistファイルのNSUserTrackingUsageDescriptionキーにテキストを追加します。

Adjust.requestTrackingAuthorizationWithCompletionHandler((status) =>
{
    switch (status)
    {
        case 0:
            // ATTrackingManagerAuthorizationStatusNotDetermined case
            break;
        case 1:
            // ATTrackingManagerAuthorizationStatusRestricted case
            break;
        case 2:
            // ATTrackingManagerAuthorizationStatusDenied case
            break;
        case 3:
            // ATTrackingManagerAuthorizationStatusAuthorized case
            break;
    }
});

Adjust.requestTrackingAuthorizationWithCompletionHandler((status) =>
{
    switch (status)
    {
        case 0:
            Debug.Log("The user has not responded to the access prompt yet.");
break;
        case 1:
            Debug.Log("Access to app-related data is blocked at the device level.");
break;
        case 2:
            Debug.Log("The user has denied access to app-related data for device tracking.");
break;
        case 3:
            Debug.Log("The user has approved access to app-related data for device tracking.");
break;
    }
});

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

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

Adjust.getAppTrackingAuthorizationStatus();

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

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

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

Adjust.checkForNewAttStatus();