We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

개발자

ADJConfig 클래스

ADJConfig 클래스를 사용하여 Adjust SDK 사용을 위한 설정을 저장할 수 있습니다.

중요:

ADJConfig 클래스는 Adjust SDK 초기화 전에 설정해야 합니다. SDK가 실행 시간에 클래스로부터 속성을 복사하기 때문입니다.

클래스 메서드

ADJConfig 클래스로 SDK 설정하기

중요:

SDK를 설정하려면 이 메서드를 호출해야 합니다.

SDK를 설정하려면 앱에 관한 정보를 config 객체에 전달해야 합니다. 앱 토큰, 환경, 로그 레벨을 명시해야 합니다.

+ (nullable ADJConfig *) configWithAppToken: (nonnull NSString *) appToken
                                environment: (nonnull NSString *) environment
                      allowSuppressLogLevel: (BOOL) allowSuppressLogLevel

Objective-C

Swift

Javascript

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
ADJConfig *adjustConfig = [ADJConfig configWithAppToken:yourAppToken environment:environment allowSuppressLogLevel:YES];

파라미터

파라미터	데이터 유형	설명	필수
`configWithAppToken`	문자열	앱의 앱 토큰. 대시보드에서 찾을 수 있는 고유한 식별자로, 항상 12자입니다.	네
`environment`	문자열	앱의 현재 환경. 이 환경은 실제 트래픽과 테스트 트래픽을 구별하기 위해 사용됩니다. 이 값이 항상 유의미하도록 유지하시기 바랍니다. 이는 매출 트래킹에서 특히 중요합니다.	네
`allowSuppressLogLevel`	Boolean	true로 설정된 경우, `ADJLogLevelSuppress` 사용을 허용하고 프로덕션 환경에서 디폴트값을 대체합니다.	아니요

값

파라미터	값	설명
`environment`	`AdjEnvironmentProduction`	앱이 프로덕션 환경에서 사용되고 있음을 알립니다. 데이터는 라이브로 처리됩니다.
`environment`	`AdjEnvironmentSandbox`	앱이 테스트 중이며 대시보드에서 라이브 데이터로 표시되지 않음을 나타냅니다.

반환 값

인스턴스 메서드

SKAdNetwork와의 커뮤니케이션 비활성화

기본 설정에 따라 Adjust SDK는 Apple의 SKAdNetwork와 정보를 공유합니다. Apple과 정보 공유 계획이 없는 경우 이를 비활성화할 수 있습니다.

- (void) deactivateSKAdNetworkHandling

Objective-C

Swift

[adjustConfig.deactivateSKAdNetworkHandling];

속성

AdServices 프레임워크 데이터의 읽기 활성화/비활성화

앱에 AdServices.framework를 추가한 경우, Adjust SDK는 AdServices 정보에 액세스할 수 있습니다. 이를 차단하려면 allowAdServicesInfoReading 속성을 토글합니다.

참고:

이 속성의 디폴트값은 true 입니다.

- (BOOL) allowAdServicesInfoReading

Objective-C

Swift

[adjustConfig setAllowAdServicesInfoReading:NO];

iAd 프레임워크 데이터의 읽기 활성화/비활성화

기본 설정에 따라 Adjust SDK는 ASKA 트래킹을 위해 iAd 프레임워크의 정보를 읽습니다. 이를 비활성화하려면 allowiAdInfoReading 속성을 토글합니다.

중요:

iAd 프레임워크는 2023년 2월 7일에 Apple에 의해 지원 중단되었습니다. 이 속성은 현재 작동하지 않습니다.

- (BOOL) allowiAdInfoReading

Objective-C

Swift

[adjustConfig setAllowiAdInfoReading:NO];

IDFA 읽기 활성화/비활성화

Adjust SDK는 어트리뷰션 정확성을 높이기 위해 기기로부터 IDFA를 읽습니다. 이를 차단하려면 allowIdfaReading 속성을 토글합니다.

참고:

이 속성의 디폴트값은 true 입니다.

- (BOOL) allowIdfaReading

Objective-C

Swift

[adjustConfig allowIdfaReading:NO];

오가닉 설치에 대한 디폴트 트래커 설정

앱에 대해 디폴트 트래커를 설정할 수 있습니다. Adjust SDK는 읽어야 하는 기타 트래커 정보가 없는 경우 해당 트래커를 사용할 것입니다.

- (NSString *) defaultTracker

Objective-C

Swift

Javascript

[adjustConfig setDefaultTracker:@"{TrackerToken}"];

파라미터

파라미터	데이터 유형	설명
`defaultTracker`	문자열	디폴트로 설정하고자 하는 트래커의 트래커 토큰.

SDK 실행 지연

일부 정보는 앱이 실행되기 전까지 액세스가 불가능할 수 있습니다. 데이터 액세스를 위해 기다려야 하는 경우 SDK의 첫 실행을 지연시킬 수 있습니다. 초 단위로 실행 지연 시간을 설정할 수 있습니다.

중요:

이러한 지연은 유저가 최초로 앱을 실행한 세션에만 적요됩니다. 이 세션 이후 SDK는 지연 없이 앱 실행을 초기화합니다.

- (double) delayStart

Objective-C

Swift

Javascript

[adjustConfig setDelayStart:5.5];

파라미터

파라미터	데이터 유형	설명
`시작 지연`	숫자 (두 자리 수)	초 단위의 원하는 지연 시간. 최대 허용 값은 10초입니다.

어트리뷰션 변경 내용 기록을 위해 델리게이트 설정

Adjust SDK는 유저 어트리뷰션 변경 내용을 알릴 수 있습니다. 이를 활성화하려면 델리게이트를 등록해야 합니다. 이 정보는 JSCON 객체로 액세스할 수 있습니다.

참고:

Adjust는 어트리뷰션에 다양한 소스를 고려하기 때문에, 이 정보는 실시간으로 제공되지 않습니다.

- (NSObject< AdjustDelegate > *) delegate

Objective-C

Swift

Javascript

[adjustConfig setDelegate:self];

파라미터

파라미터	데이터 유형	설명
`delegate`	객체	해당 구성을 델리게이트로 등록하려면 `self` 로 설정되어야 합니다.

이벤트 버퍼링 활성화

앱에서 많은 이벤트를 트리거하고 있다면, 이벤트 버퍼링을 활성화할 수 있습니다. 이벤트 버퍼링은 이벤트 전송을 늦춥니다. 이 기능을 활성화하면 Adjust SDK가 실시간이 아니라 1분에 한 번씩 이벤트를 전송하게 됩니다. 이러한 버퍼는 Adjust SDK가 Adjust 백엔드로 이벤트를 전송할 때까지 이를 보류시킵니다.

- (BOOL) eventBufferingEnabled

Objective-C

Swift

Javascript

[adjustConfig setEventBufferingEnabled:YES];

로깅 수준 변경

logLevel 속성을 변경하여 Adjust SDK로부터 수신하는 로깅의 수준을 변경할 수 있습니다. 일부 로그 수준은 샌드박스 환경에서 앱을 실행할 때만 이용 가능합니다.

- (ADJLogLevel) logLevel

Objective-C

Swift

Javascript

[adjustConfig setLogLevel:ADJLogLevelVerbose];

파라미터

파라미터	데이터 유형	설명
`logLevel`	`ADJLogLevel` enum	반환하고자 하는 로깅 수준

값

값	설명	가능여부
`ADJLogLevelVerbose`	풀 로깅 활성화	Sandbox
`ADJLogLevelDebug`	디버그 문제를 위해 더욱 상세한 로깅 활성화	Sandbox
`ADJLogLevelInfo`	정보, 경고, 오류, assert 로그 반환	Sandbox
`ADJLogLevelWarn`	경고, 오류, assert 로그 반환	Sandbox
`ADJLogLevelError`	오류와 assert 로그만 반환	Sandbox
`ADJLogLevelAssert`	assert 로그만 반환	Sandbox
`ADJLogLevelSuppress`	모든 로깅 비활성화	Sandbox 프로덕션

비용 데이터와 어트리뷰션 전송 요청

Adjust SDK는 비용 데이터를 어트리뷰션의 일부로 전송해야 하는지 지정할 수 있도록 해줍니다.

- (BOOL) needsCost

Objective-C

Swift

[adjustConfig setNeedsCost:YES];

백그라운드에서 데이터 전송 활성화

기본 설정에 따라 Adjust SDK는 앱이 포그라운드 상태에서 실행된 경우에만 이벤트 정보를 전송합니다. 설정을 통해 앱이 백그라운드 상태에서 실행될 때 SDK가 이벤트를 전송하도록 할 수 있습니다.

- (BOOL) sendInBackground

Objective-C

Swift

Javascript

[adjustConfig setSendInBackground:YES];

외부 기기 ID 전송

BI 시스템에서 기기와 유저를 트래킹하기 위해 맞춤 기기 ID를 추가할 수 있습니다. 이러한 외부 기기 ID는 원하는 값으로 설정할 수 있습니다.

ID를 얻을 때까지 SDK 초기화를 지연해야 할 수 있습니다.

참고:

externalDeviceId 는 광고 ID와 같은 기타 ID보다 우선순위가 낮기 때문에 신규 기기에만 작동합니다. 기존 기기는 우선순위가 더 높은 ID에 의해 계속 어트리뷰션될 것입니다.

- (NSString *) externalDeviceId

Objective-C

Swift

Javascript

[adjustConfig setExternalDeviceId:@"yourExternalDeviceId"];

URL 전략 설정

Adjust SDK는 URL 전략 설정을 사용하여 지역 엔드포인트를 최우선으로 할 수 있습니다. 이 기능은 데이터 레지던시 기능을 사용하는 경우 이용 가능합니다.

- (NSString *) urlStrategy

Objective-C

Swift

Javascript

[adjustConfig setUrlStrategy:ADJDataResidencyEU];

값

값	설명
`ADJDataResidencyEU`	데이터 레지던시 지역을 EU로 설정
`ADJDataResidencyTR`	데이터 레지던시 지역을 터키로 설정
`ADJDataResidencyUS`	데이터 레지던시 지역을 미국으로 설정
`ADJUrlStrategyChina`	URL 전략을 `app.adjust.world` 도메인으로 설정합니다.
`ADJUrlStrategyCn`	URL 전략을 `app.adjust.cn` 도메인으로 설정합니다.
`ADJUrlStrategyCnOnly`	URL strategy를 `app.adjust.cn` 도메인으로 설정하지만 요청이 실패하면 다른 도메인으로 되돌릴 수 없습니다.
`ADJUrlStrategyIndia`	URL 전략을 `app.adjust.net.in` 도메인으로 설정합니다.