adjust-icon

SKAdNetwork 및 전환값 설정

SKAdNetwork(StoreKit Ad Network)는 앱 설치와 재설치를 어트리뷰션하는 Apple의 자체 어트리뷰션 프레임워크입니다. SKAdNetwork 워크플로우는 다음과 같습니다.

  1. Apple은 어트리뷰션 정보를 수집하고, 관련 광고 네트워크에 이를 알립니다.
  2. 네트워크는 Adjust에 해당 정보와 함께 포스트백을 전송합니다.
  3. Adjust는 SKAdNetwork 데이터를 Datascape에 표시합니다.

SKAdNetwork 커뮤니케이션 비활성화

속성 선언
public bool? IsSkanAttributionEnabled { get; set; }

Adjust SDK는 기본값에 따라 SKAdNetwork와 정보를 주고 받습니다. SDK는 초기화 시 SKAdNetwork의 어트리뷰션을 기록합니다.

AdjustConfig 인스턴스의 IsSkanAttributionEnabled 속성을 bool 값으로 설정하여 이 동작을 제어할 수 있습니다.

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.IsSkanAttributionEnabled = false;
//...
Adjust.InitSdk(adjustConfig);

전환값 변경 사항 수신

속성 선언
public Action<Dictionary<string, string>> SkanUpdatedDelegate { get; set; }

전환값 관리에 Adjust 솔루션을 사용하는 경우, Adjust 서버는 전환값 업데이트를 SDK에 전송합니다. 델리게이트 함수를 설정하여 이러한 변경 사항을 수신 대기하고 AdjustConfig 인스턴스의 SkanUpdatedDelegate 속성에 함수를 할당할 수 있습니다.

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
//...
Adjust.InitSdk(adjustConfig);

델리게이트 함수는 SKAdNetwork로부터 다음 속성과 함께 포스트백을 수신합니다.

인수(Arguments)설명
conversion_valueAdjust의 서버가 전송하는 전환값입니다.
coarse_valueCoarse 전환값입니다. 앱의 설치 수가 개인 정보 보호 기준을 충족하지 못하는 경우에 사용됩니다.
  • none
  • low
  • medium
  • high

Apple은 low, medium, high로 설정된 조건 중 어느 것도 충족되지 않는 경우 아무것도 전송하지 않습니다.
lock_window전환 윈도우가 종료되기 전에 포스트백 전송 여부입니다. 1은 전환값 윈도우 종료 전에 포스트백이 전송됨을 의미합니다.
SKAdNetwork 4.0 포스트백에서는 0, 그 이전 SKAdNetwork 버전에서는 nil로 기본 설정되어 있습니다.
error오류가 발생한 경우 오류 메시지를 포함합니다.

예시

본 예시에서는 Fine 전환값과 Coarse 전환값, 그리고 SKAdNetwork 포스트백이 전환 윈도우가 끝나기 전에 전송되도록 설정되었는지를 기록하는 방법을 보여줍니다.

using com.adjust.sdk;
public class ExampleGUI : MonoBehaviour {
void OnGUI() {
if (GUI.Button(new Rect(0, 0, Screen.width, Screen.height), "callback")) {
AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.LogLevel = AdjustLogLevel.Verbose;
adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
Adjust.InitSdk(adjustConfig);
}
private void SkanUpdatedDelegate(Dictionary<string,string> response) {
Debug.Log("Conversion value updated. Callback received");
Debug.Log("Conversion value: " + response["conversion_value"]);
Debug.Log("Coarse conversion value: " + response["coarse_value"]);
Debug.Log ("Will send before conversion value window ends: " response["lock_window"]);
Debug.Log("Error message: " response["error"]);
}
}
};

다이렉트 설치 포스트백 설정

Adjust에 성공한 SKAdNetwork 콜백의 사본을 전송하도록 앱을 구성할 수 있습니다. 이를 통해 애널리틱스에서 SKAdNetwork 정보를 사용할 수 있습니다.

다이렉트 설치 포스트백 설정을 위해, Info.plist 파일에 Adjust 콜백 URL을 추가해야 합니다.

  1. Xcode의 프로젝트 네비게이터(Project navigator)에서 Info.plist 를 선택합니다.
  2. 속성 리스트 에디터의 키 옆에 있는 추가(Add) 버튼을 선택한 후 Return을 누릅니다.
  3. NSAdvertisingAttributionReportEndpoint 를 키 이름으로 입력합니다.
  4. 팝업 메뉴의 종류(Type)문자열(String) 로 설정합니다.
  5. https://adjust-skadnetwork.com 주소를 입력합니다.