ATT 설정

IDFA(ID for Advertisers)를 기록하려면 사용자의 허가를 받기 위한 메시지를 표시해야 합니다. 이렇게 하려면 앱에 Apple의 ATT(App Tracking Transparency) 프레임워크를 포함해야 합니다. Adjust SDK는 사용자의 허가 여부를 저장하고 각 요청과 함께 Adjust 서버로 전송합니다.

Authorization statuses

상태	코드	설명
`ATTrackingManagerAuthorizationStatusNotDetermined`	`0`	사용자가 아직 액세스 프롬프트에 응답하지 않음
`ATTrackingManagerAuthorizationStatusRestricted`	`1`	앱 관련 데이터에 대한 액세스가 디바이스 수준에서 차단됨.
`ATTrackingManagerAuthorizationStatusDenied`	`2`	사용자가 앱 관련 데이터에 대한 디바이스 측정 액세스를 거부함
`ATTrackingManagerAuthorizationStatusAuthorized`	`3`	사용자가 앱 관련 데이터에 대한 디바이스 측정 액세스를 승인함

ATT authorization wrapper

requestAppTrackingAuthorization: (handler: (status: number) => void) => void

Adjust SDK에는 Apple requestAppTrackingAuthorization 메서드의 래퍼가 포함되어 있습니다. ATT 프롬프트를 커스텀하지 않으려면 이 래퍼를 사용할 수 있습니다.

콜백 메서드는 사용자가 동의 팝업창에 응답할 때 트리거되고 사용자의 동의 상태 코드를 Adjust 서버로 전송합니다. 콜백 함수 내에서 각 상태 코드에 대한 응답을 정의할 수 있습니다.

ATT에 대한 텍스트 콘텐츠를 지정해야 합니다. 이를 위해 텍스트를 Info.plist 파일의 NSUserTrackingUsageDescription 키에 추가합니다.

1
Adjust.requestAppTrackingAuthorization(function (status) {
2
   print("[Adjust]: Authorization status update!");
3
   switch (status) {
4
      case 0:
5
         // ATTrackingManagerAuthorizationStatusNotDetermined case
6
         break;
7
      case 1:
8
         // ATTrackingManagerAuthorizationStatusRestricted case
9
         break;
10
      case 2:
11
         // ATTrackingManagerAuthorizationStatusDenied case
12
         break;
13
      case 3:
14
         // ATTrackingManagerAuthorizationStatusAuthorized case
15
         break;
16
   }
17
});

Example

예시에서는 사용자가 프롬프트와 상호작용할 때 사용자의 인증 상태에 대해 읽을 수 있는(human-readable) 설명을 로그하는 방법을 보여줍니다.

1
Adjust.requestAppTrackingAuthorization(function (status) {
2
   print("[Adjust]: Authorization status update!");
3
   switch (status) {
4
      case 0:
5
         console.log("The user has not responded to the access prompt yet.");
6
         break;
7
      case 1:
8
         console.log(
9
            "Access to app-related data is blocked at the device level.",
10
         );
11
         break;
12
      case 2:
13
         console.log(
14
            "The user has denied access to app-related data for device measurement.",
15
         );
16
         break;
17
      case 3:
18
         console.log(
19
            "The user has approved access to app-related data for device measurement.",
20
         );
21
         break;
22
   }
23
});

Get current authorization status

getAppTrackingAuthorizationStatus: (callback: (authorizationStatus: number) => void) => void

사용자의 현재 인증 상태는 언제든지 조회가 가능합니다. getAppTrackingAuthorizationStatus 메서드를 호출하여 number로 인증 상태 코드를 반환합니다.

1
Adjust.getAppTrackingAuthorizationStatus(function (status) {
2
   // check status value
3
});

Example

예시에서는 사용자의 인증 상태를 수집하여 string으로 변환하는 방법을 보여줍니다. 해당 정보는 authorizationStatus라는 변수로 할당되어 키 "status"와 함께 세션 파트너 파라미터로 전달됩니다.

1
Adjust.getAppTrackingAuthorizationStatus(function (status) {
2
   Adjust.addGlobalCallbackParameter("status", status.toString());
3
});

Custom prompt timing

public setAttConsentWaitingInterval(attConsentWaitingInterval: number): void

앱이 온보딩 과정이나 튜토리얼을 포함하는 경우, 사용자가 온보딩 과정이나 튜토리얼을 완료할 때까지 사용자의 ATT 동의 상태 전송을 지연시킬 수 있습니다. 이를 위해 attConsentWaitingInterval 속성을 설정하여 최대 120초 동안 데이터 전송을 지연하여 사용자가 초기 온보딩을 완료할 수 있는 시간을 제공할 수 있습니다. 타임아웃이 끝나거나 사용자가 동의 상태를 설정한 경우, SDK는 지연 기간 동안 기록된 모든 정보를 사용자의 동의 상태와 함께 Adjust 서버로 전송합니다.

1
const adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
//...
6
adjustConfig.setAttConsentWaitingInterval(30);
7
//...
8
Adjust.initSdk(adjustConfig);