SKAdNetwork 및 전환값 설정

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

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

Disable SKAdNetwork communication

public disableSkanAttribution(): void

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

1
const adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5

6
adjustConfig.disableSkanAttribution();
7

8
Adjust.initSdk(adjustConfig);

Update conversion values

updateSkanConversionValue: (conversionValue: number, coarseValue: string, lockWindow: boolean, callback: (error: string) => void) => void

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

Adjust에서 전환값을 관리하는 경우 서버는 SDK에서 이 값을 업데이트합니다. updateSkanConversionValue 메서드를 사용하여 이 값을 업데이트할 수도 있습니다. 다음 인수를 허용합니다.

인수 (Arguments)	데이터 유형	설명
`conversionValue`	Number	전환값. `0` 및 `63` 사이의 값이어야 함.
`coarseValue`	부울(bool) 문자열 (`SKAdNetwork.CoarseConversionValue`)	coarse-grained 전환값. 앱의 설치 수가 Privacy Threshold를 충족하지 못하는 경우에 사용됩니다. `'low'` (`SKAdNetworkCoarseConversionValueLow`에 대한 것) `'medium'` (`SKAdNetworkCoarseConversionValueMedium`에 대한 것) `'high'` (`SKAdNetworkCoarseConversionValueHigh`에 대한 것)
`lockWindow`	부울 자료	전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부.전환값 윈도우가 종료될 때까지 기다리지 않고 시스템이 포스트백을 전송하도록 하려면 `true` 값을 사용하시기 바랍니다. 기본: `false`.

1
Adjust.updateSkanConversionValue(6, 'coarse-value', ‘true’, function(error) {
2
    // error is present in case it happened
3
});

Listen for changes to conversion values

public setSkanUpdatedCallback(
      callback: (skanData: AdjustSkanData) => void
    ): void

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

1
const adjustConfig = new AdjustConfig(appToken, environment);
2

3
adjustConfig.setSkanUpdatedCallback(function (skanData) {
4
   console.log("Conversion value: " + skanData.conversionValue);
5
   console.log("Coarse value: " + skanData.coarseValue);
6
   console.log("Lock window: " + skanData.lockWindow);
7
   console.log("Error: " + skanData.error);
8
});
9

10
Adjust.initSdk(adjustConfig);

Example

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

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

1
import { Adjust, AdjustEvent, AdjustConfig } from "react-native-adjust";
2

3
const App: () => React$Node = () => {
4
   Adjust.getSdkVersion(function (sdkVersion) {
5
      console.log("Adjust SDK version: " + sdkVersion);
6
   });
7

8
   const adjustConfig = new AdjustConfig(
9
      "{YourAppToken}",
10
      AdjustConfig.EnvironmentSandbox
11
   );
12

13
  adjustConfig.setSkanUpdatedCallback(function (skanData) {
14
   console.log("Conversion value: " + skanData.conversionValue);
15
   console.log("Coarse value: " + skanData.coarseValue);
16
   console.log("Lock window: " + skanData.lockWindow);
17
   console.log("Error: " + skanData.error);
18
});
19

20
   Adjust.initSdk(adjustConfig);
21
};
22

23
export default App;

Set up direct install postbacks

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

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

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