SKAdNetwork 및 전환값 설정

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

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

Disable SKAdNetwork communication

bool? isSkanAttributionEnabled;

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

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

1
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox, true);
2
//...
3
adjustConfig.isSkanAttributionEnabled = false;
4
//...
5
Adjust.initSdk(adjustConfig);

Update conversion values

static Future<String?> updateSkanConversionValue(int conversionValue, String coarseValue, bool lockWindow)

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

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

인수 (Arguments)	데이터 유형	설명
`conversionValue`	int	전환값. `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).then((error) {
2
    // error is present in case it happens
3
});

Listen for changes to conversion values

typedef void SkanUpdatedCallback(Map<String, String> skanUpdateData);
SkanUpdatedCallback? skanUpdatedCallback;

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

1
AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
2
adjustConfig.skanUpdatedCallback = (Map<String, String> data) {
3
    print(Skan Callback: $data');
4
};
5
   print('[Adjust]: Received conversion value update: ' + conversionValue!.toString());
6
};
7
Adjust.initSdk(adjustConfig);

Example

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

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

import 'package:adjust_sdk/adjust.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

initPlatformState() async {
   AdjustConfig config =
      new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
   config.logLevel = AdjustLogLevel.verbose;

config.conversionValueUpdatedCallback = (num? conversionValue) {
      print('[Adjust]: Received conversion value update: ' +
         conversionValue!.toString());
   };

Adjust.initSdk(config);

}

SKAdNetwork 4.0 callbacks

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

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

Example

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

1
import 'package:adjust_sdk/adjust.dart';
2
import 'package:flutter/cupertino.dart';
3
import 'package:flutter/material.dart';
4
import 'package:flutter/services.dart';
5

6
initPlatformState() async {
7
   AdjustConfig config =
8
      new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
9
   config.logLevel = AdjustLogLevel.verbose;
10

11
   config.skanUpdatedCallback = (Map<String, String> skanUpdateData) {
12
      // process skanUpdateData map
13
      // example: {conversion_value: 0, lock_window: false, coarse_value: low}
14
         print('[Adjust]: Conversion value updated. Callback received');
15
         print('[Adjust]: Conversion value: ' + conversionValue!.toString());
16
         print('[Adjust]: Coarse conversion value: ' + coarseValue!);
17
         print('[Adjust]: Will send before conversion value window ends: ' lockWindow!.toString());
18
   };
19

20
   Adjust.initSdk(config);
21
}

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 주소를 입력하세요.