구성

Adjust SDK의 동작을 설정하는 방법에 관한 본 문서의 메서드를 참조하시기 바랍니다.

config 객체 인스턴스화

- (nullable ADJConfig *)initWithAppToken:(nonnull NSString *)appToken
                             environment:(nonnull NSString *)environment
                             suppressLogLevel:(BOOL)allowSuppressLogLevel;

Adjust SDK를 설정하려면 ADJConfig 객체를 인스턴스화해야 합니다. 이 객체에는 Adjust SDK로 전달하기 위해 필요한 읽기 전용 구성 옵션이 포함되어 있습니다.

config 객체를 인스턴스화하려면 새로운 ADJConfig 인스턴스를 생성하고 다음 파라미터를 전달합니다.

appToken NSString: Adjust 앱 토큰입니다.
environment (NSString): SDK를 실행할 환경입니다. 테스트를 위해 샌드박스 모드에서 SDK를 실행하려면 ADJEnvironmentSandbox를 전달합니다. 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 ADJEnvironmentProduction을 전달합니다.
allowSuppressLogLevel (BOOL): 모든 로깅의 비활성화 여부입니다. true로 설정하여 로깅을 비활성화하거나 false로 설정하여 로깅을 활성화합니다.

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
    appToken: yourAppToken,
    environment: environment)

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:yourAppToken
                                                    environment:environment];

setupWebViewJavascriptBridge(function (bridge) {
   var yourAppToken = yourAppToken;
   var environment = AdjustConfig.EnvironmentSandbox;
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
});

읽기 전용 구성

읽기 전용 구성 옵션은 SDK를 초기화하기 전 에 ADJConfig 인스턴스에 설정되어 있습니다. SDK 실행 중에는 이 옵션을 변경할 수 없습니다. 사용할 옵션은 Adjust.initSdk()를 실행하기 전에 설정해야 합니다.

로그 수준 설정

@property (nonatomic, assign) ADJLogLevel logLevel;

Adjust SDK는 다양한 양의 정보를 반환하기 위해 구성 가능한 로그 레벨을 제공합니다. 이용 가능한 로그 레벨은 다음과 같습니다.

ADJLogLevel	설명
`ADJLogLevelVerbose`	모든 로깅 활성화
`ADJLogLevelDebug`	디버그 로깅 활성화
`ADJLogLevelInfo`	정보 수준 로그만 표시(기본 설정)
`ADJLogLevelWarn`	정보 로깅 비활성화
`ADJLogLevelError`	경고 수준 로깅 이하 비활성화
`ADJLogLevelAssert`	오류 수준 로깅 이하 비활성화
`ADJLogLevelSuppress`	모든 로깅 비활성화

config 인스턴스의 logLevel 속성에 ADJLogLevel 값을 할당하여 로그 수준을 설정할 수 있습니다.

logLevel (ADJLogLevel): 사용할 로그 수준

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
    appToken: yourAppToken,
    environment: environment)
// ...
adjustConfig?.logLevel = ADJLogLevel.verbose

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
 ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:yourAppToken
                                                    environment:environment];
// ...
[adjustConfig setLogLevel:ADJLogLevelVerbose];

setupWebViewJavascriptBridge(function (bridge) {
   // ...
   var yourAppToken = yourAppToken;
   var environment = AdjustConfig.EnvironmentSandbox;
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
   adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
});

외부 디바이스 ID 설정

@property (nonatomic, copy, nullable) NSString *externalDeviceId;

외부 디바이스 ID는 기기 또는 사용자에 할당할 수 있는 커스텀 값입니다. 이를 통해 세션과 플랫폼에 걸쳐 사용자를 식별할 수 있습니다. 또한 사용자별 설치 중복 제거에 도움이 되어, 동일한 사용자가 여러 번의 신규 설치로 집계되지 않습니다. 시작하려면 Adjust 담당자에게 문의하시기 바랍니다.

외부 디바이스 ID를 기기에 대한 커스텀 ID로서 사용할 수도 있습니다. 이는 기타 시스템과 통일성을 유지하고 싶은 경우 유용합니다. 외부 디바이스 ID를 config 인스턴스의 externalDeviceId 속성에 할당합니다.

externalDeviceId (NSString): 외부 기기 ID. 이 값은 대소문자를 구분 합니다. 외부 기기 ID를 불러오기한 경우, 전달한 값이 불러온 값과 일치하는지 확인하시기 바랍니다.

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
   appToken: yourAppToken,
   environment: environment)
// ...
adjustConfig?.externalDeviceId = "yourExternalDeviceId"

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
 ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:yourAppToken
                                                    environment:environment];
// ...
[adjustConfig setExternalDeviceId:@"yourExternalDeviceId"];

setupWebViewJavascriptBridge(function (bridge) {
   var yourAppToken = yourAppToken;
   var environment = AdjustConfig.EnvironmentSandbox;
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
   adjustConfig.setExternalDeviceId("yourExternalDeviceId");
});

비즈니스 애널리틱스에서 외부 디바이스 ID를 사용하려면 이를 세션 콜백 파라미터로 전송해야 합니다.

Adjust로 이미 존재하는 외부 기기 ID를 불러오기 하는것도 가능합니다. 이를 통해 Adjust 서버는 미래 데이터를 기존의 기기 기록과 매칭할 수 있습니다. 세부 정보는 Adjust 담당자에게 문의하시기 바랍니다.

디폴트 링크 토큰 설정

@property (nonatomic, copy, nullable) NSString *defaultTracker;

앱이 기기에 사전 설치된 경우 디폴트 링크 토큰을 설정할 수 있습니다. 사용자가 사전 설치된 앱을 처음으로 실행할 때 해당 설치가 디폴트 링크 토큰으로 어트리뷰션됩니다. 디폴트 링크 토큰을 config 인스턴스의 defaultTracker 속성에 할당합니다.

defaultTracker (NSString): 사전 설치된 설치 내용을 기록할 Adjust 링크 토큰

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
   appToken: yourAppToken,
   environment: environment)
adjustConfig?.defaultTracker = "{Token}"
Adjust.initSdk(adjustConfig)

ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:appToken
                                              environment:environment];
[adjustConfig setDefaultTracker:@"{Token}"];
[Adjust initSdk:adjustConfig];

setupWebViewJavascriptBridge(function (bridge) {
   var yourAppToken = yourAppToken;
   var environment = AdjustConfig.EnvironmentSandbox;
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
   adjustConfig.setDefaultTracker("{Token}");
});

비용 데이터 전송 활성화

- (void)enableCostDataInAttribution;

기본 설정에 따라 Adjust SDK는 사용자의 어트리뷰션에서 비용 데이터를 전송하지 않습니다. 비용 데이터 전송을 활성화하여 이 데이터를 전송하도록 SDK를 구성할 수 있습니다. 비용 데이터 전송을 활성화하려면 [ADJConfig enableCostDataInAttribution] 메서드를 호출합니다.

비용 데이터는 사용자의 어트리뷰션 정보에서 액세스할 수 있습니다.

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
   appToken: yourAppToken,
   environment: environment)
// ...
adjustConfig?.enableCostDataInAttribution()

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
 ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:appToken
                                                environment:environment];
// ...
[adjustConfig enableCostDataInAttribution];

setupWebViewJavascriptBridge(function (bridge) {
   var yourAppToken = yourAppToken;
   var environment = AdjustConfig.EnvironmentSandbox;
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
   adjustConfig.enableCostDataInAttribution();
});

백그라운드 전송 활성화

- (void)enableSendingInBackground;

기본값에 따라 Adjust SDK는 앱이 백그라운드에서 실행 중일 때 요청 전송을 일시 중지합니다. 백그라운드 리코딩을 활성화하여 백그라운드에서 요청을 보내도록 SDK를 구성할 수 있습니다. 백그라운드 기록을 활성화하려면 [Adjust enableSendingInBackground] 메서드를 호출합니다.

1
adjustConfig?.enableSendingInBackground()

1
[adjustConfig enableSendingInBackground];

1
adjustConfig.setSendInBackground(true);

동적 구성

동적 구성 옵션은 이벤트 또는 사용자 행동에 대한 응답으로 SDK의 라이프사이클 중에 변경될 수 있습니다.

오프라인 모드 활성화

Adjust SDK는 실시간으로 이벤트와 세션 데이터를 Adjust 서버로 전송합니다. SDK를 오프라인 모드로 설정하면 정보 전송이 일시 중단됩니다. 오프라인 모드에서 SDK는 모든 데이터를 기기의 로컬 파일에 저장합니다. 이후 SDK의 오프라인 모드가 해제되면 Adjust 서버로 해당 정보가 전송됩니다.

[Adjust switchToOfflineMode] 메서드를 호출하여 언제든지 오프라인 모드를 토글할 수 있습니다.

Swift
Objective-C

1
Adjust.switchToOfflineMode()

1
[Adjust switchToOfflineMode]

오프라인 모드 비활성화

[Adjust switchBackToOnlineMode] 메서드를 호출하여 SDK를 재활성화할 수 있습니다. 이렇게 하면 SDK가 정보 전송을 재개합니다.

Swift
Objective-C

1
Adjust.switchBackToOnlineMode()

1
[Adjust switchBackToOnlineMode]

푸시 토큰 설정

+ (void)setPushToken:(nonnull NSData *)pushToken;

푸시 토큰은 Audiences와 클라이언트 콜백에 사용되고 삭제 및 재설치 측정에도 필요합니다.

[Adjust setPushToken] 메서드를 호출하고 다음 인수를 전달하여 언제든지 푸시 토큰을 업데이트할 수 있습니다.

pushToken (NSData): 푸시 토큰

Swift
Objective-C

1
func application(_ app: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken pushToken: Data) {
2
    Adjust.setPushToken(pushToken)
3
}

1
- (void)application:(UIApplication *)app didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)pushToken {
2
    [Adjust setPushToken:pushToken];
3
}

SDK 비활성화

+ (void)disable;

Adjust SDK는 기본 설정에 따라 앱이 열려 있을 때 실행됩니다. [Adjust disable] 메서드를 호출하여 Adjust SDK를 비활성화하고 Adjust로 정보를 전송하는 것을 일시 중지할 수 있습니다. Adjust SDK를 비활성화하면 Adjust 서버로 데이터가 전송되지 않습니다.

Swift
Objective-C

1
Adjust.disable()

1
[Adjust disable];

SDK 활성화

+ (void)enable;

SDK를 비활성화한 후에 다시 활성화하려면 [Adjust enable] 메서드를 호출합니다. SDK가 활성화되면 Adjust 서버로 정보를 전송합니다.

Swift
Objective-C

1
Adjust.enable()

1
[Adjust enable];

활성화 상태 조회

+ (void)isEnabledWithCompletionHandler:(nonnull ADJIsEnabledGetterBlock)completion;

언제든지 completion handler와 함께 [Adjust isEnabledWithCompletionHandler] 메서드를 호출하여 Adjust SDK가 활성화되어 있는지 확인할 수 있습니다. 해당 상태는 비동기적으로 반환되며 completion handler에 BOOL 값으로 전달됩니다.

Swift
Objective-C

1
Adjust.isEnabled { isEnabled in
2
   // Your completion handler
3
};

1
[Adjust isEnabledWithCompletionHandler:^(BOOL isEnabled) {
2
   // Your completion handler
3
}]