ATT 설정

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

승인 상태

상태	코드	설명
`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);

예시

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

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