We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

開発者向け

App Tracking Transparencyの設定

注意:

App Tracking Transparency frameworkはv4.23.0以降のAdjust SDKが搭載されたiOSデバイス上のみで利用可能です。

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

承認ステータス

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

注意:

SDKがATTステータスを取得できない場合、 -1 のステータスコードを受け取る可能性があります。

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

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

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

ヒント:

Adjust SDKは、カスタムプロンプトを使用した場合、同意ステータスも記録します。初期化前にプロンプトを表示した場合、SDKはインストールイベントと共にステータスを送信します。プロンプトを初期化後に表示した場合は、SDKはユーザーが更新した後に、即時にバックエンドにステータスを送信します。

DartiOS

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;
    }
  });
}

例

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

Dart

// main.dart

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 tracking.');
break;
        case 3:
          print(
              'The user has approved access to app-related data for device tracking.');
break;
      }
    });

     Adjust.start(config);
}

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

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

Dart

Adjust.getAppTrackingAuthorizationStatus();

例

この例では、ユーザーの認証ステータスを収集し、Stringに変換しています。これをauthorizationStatusと呼ばれる変数として保管し、"status"キーと共にセッションパートナーパラメーターとしてパスします。

Dart

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

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

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

Dart

Adjust.checkForNewAttStatus();