SKAdNetwork 및 전환값 설정

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

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

SKAdNetwork 커뮤니케이션 비활성화

public void deactivateSKAdNetworkHandling();

v4.23.0에서 추가됨

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

config 객체에는 해당 동작을 제어하는 boolean isSKAdNetworkHandlingActive 속성이 포함되어 있습니다. 인수 없이 deactivateSKAdNetworkHandling 메서드를 호출하여 SKAdNetwork 커뮤니케이션을 비활성화할 수 있습니다.

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.deactivateSKAdNetworkHandling();
4
//...
5
Adjust.start(adjustConfig);

전환값 업데이트

public static void updateConversionValue(int conversionValue);

전환값은 SKAdNetwork에서 사용자 행동 측정에 사용되는 메커니즘입니다. 64개의 조건을 0에서 63 사이의 값에 매핑하여 설치에 대해 이 정수 값을 SKAdNetwork로 전송할 수 있습니다. 이를 통해 처음 며칠간 사용자의 앱 이용에 관한 통찰력을 얻을 수 있습니다.

Adjust에서 전환값을 관리하는 경우 서버는 SDK에서 이 값을 업데이트합니다. updateConversionValue 메서드를 사용하여 이 값을 업데이트할 수도 있습니다. 이 메서드는 Apple의 updateConversionValue 메서드를 래핑하고 업데이트된 전환값을 나타내는 int 인수를 받아들입니다.

1
Adjust.updateConversionValue(6);

예시

이 예시에서는 사용자가 이벤트를 트리거함에 따라 전환값을 10으로 업데이트하는 방법을 보여줍니다.

1
public void OnButtonClick() {
2
   Adjust.updateConversionValue(10);
3
}

전환값 변경 사항 수신

public void setConversionValueUpdatedDelegate(Action<int> conversionValueUpdatedDelegate, string sceneName = "Adjust");

전환값 관리에 Adjust 솔루션을 사용하는 경우, Adjust 서버는 전환값 업데이트를 SDK에 전송합니다. setConversionValueUpdatedDelegate 메서드를 사용하면 델리게이트 함수를 설정하여 이러한 업데이트를 수신할 수 있습니다. 함수를 인수로 전달합니다.

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.setConversionValueUpdatedDelegate(ConversionValueUpdatedCallback);
4
//...
5
Adjust.start(adjustConfig);

예시

이 예시에서는 전환값이 업데이트될 때 다음 항목을 로깅하는 방법을 보여줍니다.

전환값 업데이트 확인 메세지
새로운 전환값

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.setLogLevel(AdjustLogLevel.Verbose);
         adjustConfig.setConversionValueUpdatedDelegate(ConversionValueUpdatedCallback);

         Adjust.start(adjustConfig);
      }


      private void ConversionValueUpdatedCallback(int conversionValue) {
         Debug.Log("Conversion value updated. Callback received");
         Debug.Log("Conversion value: " + conversionValue);
      }
   }
}

SKAdNetwork 4.0 콜백

v4.33.0에서 추가됨

SKAdNetwork 4.0 포스트백은 광고주들에게 사용자 관련 인사이트를 더 많이 제공하기 위해 추가적인 정보를 포함하고 있습니다. Adjust 서버가 전환값을 업데이트할 때 이 추가 정보가 페이로드에 전송됩니다. setSkad4ConversionValueUpdatedDelegate 콜백 메서드로 이 정보에 액세스하실 수 있습니다.

인수 (Arguments)	데이터 유형	설명
`fineValue`	`NSNumber`	Adjust의 서버가 전송하는 전환값
`coarseValue`	`NSString`	coarse-grained 전환값. 앱의 설치 수가 Privacy Threshold를 충족하지 못하는 경우에 사용됩니다. `none` `low` `medium` `high` Apple은 low, medium, high로 설정된 조건 중 어느 것도 충족되지 않는 경우 아무 것도 전송하지 않습니다.
`lockWindow`	`NSNumber`	전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부. `1`은 전환값 윈도우 종료 전에 포스트백이 전송됨을 의미합니다. SKAdNetwork 4.0 포스트백에서는 `0`, 그 이전 SKAdNetwork 버전에서는 `nil`로 기본 설정되어 있습니다.

예시

본 예시에서 Adjust는 fine-grained 전환값, coarse-grained 전환값, SKAdNetwork 포스트백이 전환값 종료 전에 전송되도록 설정되었는지 여부를 로그합니다.

1
using com.adjust.sdk;
2

3
public class ExampleGUI : MonoBehaviour {
4
    void OnGUI() {
5
        if (GUI.Button(new Rect(0, 0, Screen.width, Screen.height), "callback")) {
6
            AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
7
            adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
8
            adjustConfig.setSkad4ConversionValueUpdatedDelegate(ConversionValueUpdatedCallback);
9

10
            Adjust.start(adjustConfig);
11
        }
12

13

14
      private void ConversionValueUpdatedCallback(int conversionValue, string coarseValue, bool lockWindow) {
15
         Debug.Log("Conversion value updated. Callback received");
16
         Debug.Log("Conversion value: " + fineValue);
17
         Debug.Log("Coarse conversion value: " + coarseValue);
18
         Debug.Log ("Will send before conversion value window ends: " lockWindow);
19
      }
20
   }
21
};

다이렉트 설치 포스트백(direct install postback) 설정하기

Adjust에 SKAdNetwork 콜백의 사본을 전송하도록 앱을 구성하면, 고객님의 애널리틱스에서 SKAdNetwork 정보를 사용하실 수 있습니다.

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

Xcode의 프로젝트 네비게이터(Project navigator)에서 Info.plist 를 선택하세요.
속성 리스트 에디터의 키 옆에 있는 추가 버튼(+)을 선택한 후, Return을 누르세요.
NSAdvertisingAttributionReportEndpoint 를 키 이름으로 입력하세요.
팝업 메뉴의 Type 을 String 으로 설정하세요.
https://adjust-skadnetwork.com 주소를 입력하세요.