App Tracking Transparencyの設定

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

承認ステータス

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

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

static void requestTrackingAuthorizationWithCompletionHandler(void (*trackingStatusCallback)(int status));

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

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

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

1
static void authorizationStatusCallback(int 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
}
17

18
// ...
19

20
Adjust2dx::requestTrackingAuthorizationWithCompletionHandler(authorizationStatusCallback);

例

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

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

18
Adjust2dx::requestTrackingAuthorizationWithCompletionHandler(authorizationStatusCallback);

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

static int getAppTrackingAuthorizationStatus();

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

1
Adjust2dx::getAppTrackingAuthorizationStatus();

例

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

1
std::string authorizationStatus = Adjust2dx::getAppTrackingAuthorizationStatus().c_str();
2
Adjust2dx::addSessionPartnerParameter("status", authorizationStatus);

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

static void checkForNewAttStatus();

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

1
Adjust2dx::checkForNewAttStatus();