adjust-icon

SKAdNetwork 및 전환값 설정

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

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

SKAdNetwork 커뮤니케이션 비활성화

메서드 서명
disableSkanAttribution(): void

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

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);


adjustConfig.disableSkanAttribution();


Adjust.initSdk(adjustConfig);

전환값 업데이트

메서드 서명
updateSkanConversionValue(conversionValue: number, coarseValue: string, lockWindow: boolean): Promise<string>

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

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

인수 (Arguments)데이터 유형설명
conversionValueNumber전환값. 0 및 63 사이의 값이어야 함.
coarseValue부울(bool) 문자열 (SKAdNetwork.CoarseConversionValue)Coarse 전환값입니다. 앱의 설치 수가 개인 정보 보호 기준을 충족하지 못하는 경우에 사용됩니다.
  • 'low' (SKAdNetworkCoarseConversionValueLow에 대한 것)
  • 'medium' (SKAdNetworkCoarseConversionValueMedium에 대한 것)
  • 'high' (SKAdNetworkCoarseConversionValueHigh에 대한 것)
lockWindow부울 자료전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부.전환값 윈도우가 종료될 때까지 기다리지 않고 시스템이 포스트백을 전송하도록 하려면 true 값을 사용하시기 바랍니다. 기본: false.
Adjust.updateSkanConversionValue(6, "low", true, function (error) {
   // error is present in case it happened
});

전환값 변경 사항 수신

메서드 서명
setSkanUpdatedCallback(skanUpdatedCallback: (skanData: AdjustSkanData) => void): void

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

const adjustConfig = new AdjustConfig(appToken, environment);


adjustConfig.setSkanUpdatedCallback(function (skanData) {
   console.log("Conversion value: " + skanData.conversionValue);
   console.log("Coarse value: " + skanData.coarseValue);
   console.log("Lock window: " + skanData.lockWindow);
   console.log("Error: " + skanData.error);
});


Adjust.initSdk(adjustConfig);

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

Adjust에 성공한 SKAdNetwork 및 AdAttributionKit 콜백의 사본을 전송하도록 앱을 구성하면, 애널리틱스에서 어트리뷰션 정보의 두 소스를 모두 사용할 수 있습니다.

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

  1. Xcode의 프로젝트 네비게이터(Project navigator)에서 Info.plist 를 선택합니다.
  2. 속성 리스트 에디터의 키 옆에 있는 추가(Add) 버튼을 선택한 후 Return을 누릅니다.
  3. 다음 키를 추가합니다.

SKAdNetwork의 경우

  • 키: Advertising attribution report endpoint URL (또는 NSAdvertisingAttributionReportEndpoint 원시 키 표현)
  • 유형: 문자열
  • 값: https://adjust-skadnetwork.com

AdAttributionKit의 경우

  • 키: AdAttributionKit - Postback Copy URL (또는 AttributionCopyEndpoint 원시 키 표현)
  • 유형: 문자열
  • 값: https://adjust-skadnetwork.com