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.

개발자

Adjust 클래스

Adjust 클래스를 사용하면 앱과 사용자에 대한 정보를 Adjust로 전송할 수 있습니다. 이는 어트리뷰션과 애널리틱스를 위한 이벤트 트래킹에도 사용될 수 있습니다.

메서드

각 세션에 콜백 파라미터 전송

Adjust SDK에 의해 기록된 각 세션과 함께 콜백 파라미터를 전송할 수 있습니다. 이 메서드를 여러 번 호출하여 추가 파라미터를 더할 수 있습니다.

+ (void) addSessionCallbackParameter: (nonnull NSString *) key
                               value: (nonnull NSString *) value

Objective-C

Swift

Javascript

[Adjust addSessionCallbackParameter:@"foo" value:@"bar"];

세션 콜백 파라미터 삭제

세션 파라미터를 추가한 경우, 이후 이를 모두 삭제할 수 있습니다. 파라미터 키를 removeSessionCallbackParameter로 전송하시기 바랍니다.

+ (void) removeSessionCallbackParameter: (nonnull NSString *) key

Objective-C

Swift

Javascript

[Adjust removeSessionCallbackParameter:@"foo"];

모든 세션 콜백 파라미터 재설정

세션 콜백 파라미터를 추가한 경우, 이후 이를 모두 삭제할 수 있습니다. 모두 삭제 하려면 resetSessionCallbackParameters 메서드를 호출합니다.

+ (void) resetSessionCallbackParameters

Objective-C

Swift

Javascript

[Adjust resetSessionCallbackParameters];

각 세션에 대해 네트워크 파트너에게 콜백 파라미터 전송

Adjust SDK에 의해 기록된 각 세션과 함께 콜백 파라미터를 파트너에게 전송할 수 있습니다. 이 메서드를 여러 번 호출하여 추가 파라미터를 더할 수 있습니다.

+ (void) addSessionPartnerParameter: (nonnull NSString *) key
                              value: (nonnull NSString *) value

Objective-C

Swift

Javascript

[Adjust addSessionPartnerParameter:@"foo" value:@"bar"];

파트너에 대한 콜백 파라미터 삭제

파트너 파라미터를 추가한 경우, 이후 이를 모두 삭제할 수 있습니다. 파라미터 키를 removeSessionPartnerParameter로 전송하시기 바랍니다.

+ (void) removeSessionPartnerParameter: (nonnull NSString *) key

Objective-C

Swift

Javascript

[Adjust removeSessionPartnerParameter:@"foo"];

파트너에 대한 모든 콜백 파라미터 재설정

파트너 파라미터를 추가한 경우, 이후 이를 모두 삭제할 수 있습니다. 모두 삭제 하려면 resetSessionPartnerParameters 메서드를 호출합니다.

+ (void) resetSessionPartnerParameters

Objective-C

Swift

Javascript

[Adjust resetSessionPartnerParameters];

기기에 대한 Adjust ID 얻기

adid 메서드를 호출하여 유저의 기기 Adjust ID를 반환할 수 있습니다.

참고:

adid는 설치가 성공적으로 트래킹 된 이후에만 이용 가능합니다.

+ (NSString *) adid

Objective-C

Swift

Javascript

NSString *adid = [Adjust adid];

반환 값

값	데이터 유형	설명
`adid`	문자열	기기의 고유한 Adjust ID.

앱 실행이 올바르게 되었는지 검증

SDK를 초기화하려면 앱이 올바르게 실행되었는지 검증해야 합니다. ADJConfig 객체를 appDidLaunch 메서드로 전달하시기 바랍니다:

참고:

`didFinishLaunching` 또는 `didFinishLaunchingWithOptions` 메서드의 마지막에 이를 호출하시기 바랍니다.

+ (void) appDidLaunch: (nullable ADJConfig *) adjustConfig

Objective-C

Swift

Javascript

[Adjust appDidLaunch:adjustConfig];

파라미터

값	데이터 유형	설명
`adjustConfig`	ADJConfig 객체	모든 선택적 기능이 설정된 ADJConfig 객체가 완료되었습니다.

App Tracking Transparency 관리

Adjust SDK는 requestTrackingAuthorizationWithCompletionHandler 메서드에 빌드된 래퍼를 포함합니다. 이를 사용하여 사용자의 승인 상태에 대한 정보를 수집할 수 있습니다.

Objective-C

[Adjust requestTrackingAuthorizationWithCompletionHandler:^(NSUInteger status) {
    switch (status) {
        case 0:
            // ATTrackingManagerAuthorizationStatusNotDetermined case
            break;
        case 1:
            // ATTrackingManagerAuthorizationStatusRestricted case
            break;
        case 2:
            // ATTrackingManagerAuthorizationStatusDenied case
            break;
        case 3:
            // ATTrackingManagerAuthorizationStatusAuthorized case
            break;
    }
}];

반환 값

값	데이터 유형	설명
`0`	integer	`ATTrackingManagerAuthorizationStatusNotDetermined`: 유저가 아직 승인 프롬프트를 보지 않음.
`1`	integer	`ATTrackingManagerAuthorizationStatusRestricted`: 승인 프롬프트가 디바이스 수준에서 제한됨.
`2`	integer	`ATTrackingManagerAuthorizationStatusDenied`: 유저가 액세스를 거부함.
`3`	integer	`ATTrackingManagerAuthorizationStatusAuthorized`: 유저가 액세스를 승인함.

현재 트래킹 승인 상태 조회

iOS 14.5부터 기기의 IDFA를 수집하려면 사용자의 명시적인 동의를 얻어야 합니다. appTrackingAuthorizationStatus 메서드를 통해 Adjust SDK로부터 동의 상태를 쿼리할 수 있습니다.

- (int) appTrackingAuthorizationStatus

Objective-C

Swift

Javascript

int authorizationStatus = [Adjust appTrackingAuthorizationStatus];

반환 값

값	데이터 유형	설명
`상태`	integer	유저가 디바이스에서 트래킹을 승인했는지 여부를 알려주는 상태 코드.

값

값	설명
`0`	유저가 아직 트래킹 승인 요청을 받지 못함.
`1`	유저의 디바이스가 제한됨.
`2`	유저가 IDFA 액세스를 거부함.
`3`	유저가 IDFA 액세스를 승인함.
`-1`	상태 확인이 불가능함.

URL로부터 딥링크 어트리뷰션 정보 얻기

딥링크를 사용하는 경우, Adjust SDK가 어트리뷰션 정보를 위해 URL을 검색하도록 할 수 있습니다. 유효한 정보를 찾으면 SDK는 이를 Adjust 백엔드로 전송합니다.

+ (void) appWillOpenUrl: (nonnull NSURL *) url

Objective-C

Swift

[Adjust appWillOpenUrl:url];

파라미터

값	데이터 유형	설명
`URL`	URL	딥링크 정보를 갖고 있는 URL 객체.

현재 어트리뷰션 데이터 얻기

유저가 앱을 설치한 이후 Adjust SDK에 기기 어트리뷰션 정보를 쿼리할 수 있습니다.

참고:

어트리뷰션 정보는 Adjust 백엔드가 설치를 트래킹한 이후에만 액세스할 수 있습니다. 백엔드는 설치 이벤트로부터 수신한 정보를 반환할 것입니다.

+ (ADJAttribution *) attribution

Objective-C

Swift

Javascript

ADJAttribution *attribution = [Adjust attribution];

반환 값

값	데이터 유형	설명
`어트리뷰션`	ADJAttribution 객체	기기에 현재 관련된 모든 어트리뷰션 데이터를 반환.

유니버설 URL을 스킴 URL로 전환.

Adjust SDK는 유니버설 링크를 딥링크 URL로 전환할 수 있는 도우미 메서드를 제공합니다. 이를 사용하려면 맞춤 딥링크 스킴을 convertUniversalLink 메서드로 전달합니다.

+ (nullable NSURL *) convertUniversalLink: (nonnull NSURL *) url
                                   scheme: (nonnull NSString *) scheme

Objective-C

Swift

[Adjust convertUniversalLink:url scheme:@"adjustExample"];

파라미터

값	데이터 유형	설명
`URL`	URL 객체	딥링크 정보를 포함한 유니버설 URL.
`scheme`	문자열	결과 링크에 접두사로 사용하고자 하는 스킴.

반환 값

값	데이터 유형	설명
`URL`	URL 객체	제공된 접두사를 포함한 정의된 스킴 스타일의 URL 객체.

서드파티 공유 옵션 변경

서드파티 공유에 대한 사용자의 결정을 전달할 수 있습니다. 다음의 메서드를 서드파티 공유 객체와 함께 호출하시기 바랍니다. 객체를 사용자의 결정과 함께 초기화합니다.

또한 사용자의 결정과 함께 상세 옵션을 전달하여, 애널리틱스를 위해 자세한 정보를 얻을 수 있습니다.

(void) + trackThirdPartySharing

Objective-C

Swift

Javascript

// Disable third-party sharing for the user

ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabledNumberBool:@NO];
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

// Enable third-party sharing for the user

ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabledNumberBool:@YES];
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

// Gather granular details

ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabledNumberBool:nil];
[adjustThirdPartySharing addGranularOption:@"PartnerA" key:@"foo" value:@"bar"];
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

서드파티와의 데이터 공유 비활성화

disableThirdPartySharing 메서드를 호출하여 서드파티와의 공유를 차단할 수 있습니다. 이는 false로 기본 설정되어 있습니다.

+ (void) disableThirdPartySharing

Objective-C

Swift

Javascript

[Adjust disableThirdPartySharing];

SDK에서 데이터 프라이버시 설정 활성화

Adjust의 데이터 프라이버시 설정을 사용한다면, 이를 Adjust SDK에서도 설정해야 합니다. trackMeasurementConsent 메서드를 호출하여 설정을 완료하시기 바랍니다.

+ (void) trackMeasurementConsent: (BOOL) enabled

Objective-C

Swift

Javascript

[Adjust trackMeasurementConsent:YES];

사용자의 GDPR 잊혀질 권리 요청 활성화

유저가 잊혀질 권리 요청을 할 수 있도록 활성화할 수 있습니다. 이 메서드를 호출하면, Adjust SDK는 해당 요청을 Adjust 백엔드로 전송합니다. Adjust 백엔드는 이에 따라 해당 유저의 정보를 삭제합니다.

- (void) gdprForgetMe

Objective-C

Swift

Javascript

[Adjust gdprForgetMe];

기기 IDFA 수집

idfa 메서드를 호출하여 기기의 IDFA를 조회할 수 있습니다.

+ (nullable NSString *) idfa

Objective-C

Swift

Javascript

NSString *idfa = [Adjust idfa];

반환 값

값	데이터 유형	설명
`IDFA`	문자열	기기의 IDFA.

Adjust SDK 활성화 및 비활성화

setEnabled 메서드를 사용하여 Adjust SDK와의 트래킹을 활성화 또는 비활성화할 수 있습니다.

참고:

Adjust SDK는 활성화로 기본 설정되어 있습니다. checkEnabled 메서드를 사용하여 상태를 확인할 수 있습니다.

+ (void) setEnabled: (BOOL) enabled

Objective-C

Swift

Javascript

[Adjust setEnabled:NO];

Adjust가 활성화 상태인지 확인

isEnabled를 호출하여 Adjust SDK가 활성화 되었는지 확인할 수 있습니다.

+ (BOOL) isEnabled

Objective-C

Swift

Javascript

[Adjust isEnabled];

Adjust SDK 버전 확인

기기에서 Adjust SDK의 어느 버전이 사용되는지 확인하고 싶다면, sdkVersion 메서드를 호출할 수 있습니다.

+ (NSString *) sdkVersion

Objective-C

Swift

[Adjust sdkVersion];

반환 값

값	데이터 유형	설명
`SDK 버전`	문자열	SDK의 버전( `iosX.Y.Z`형식).

푸시 토큰 설정

리어트리뷰션을 위해 푸시 알림을 사용하는 경우, 토큰을 Adjust SDK에 추가해야 합니다.

+ (void) setDeviceToken: (nonnull NSData *) deviceToken

Objective-C

Swift

Javascript

[Adjust setDeviceToken:deviceToken];

파라미터

값	데이터 유형	설명
`deviceToken`	데이터	Apple 푸시 토큰

오프라인 모드 활성화 및 비활성화

유저의 기기가 오프라인 상태일 때 SDK를 오프라인 모드로 설정하여 이벤트를 대기시킬 수 있습니다. 오프라인 모드에서 Adjust SDK는 다시 온라인 모드가 될 때까지 모든 이벤트를 보관합니다. Adjust SDK가 온라인 모드가 되면 이벤트를 전송을 시도할 것입니다.

중요:

오프라인 모드 설정은 앱 실행 간에 유지되지 않습니다. 앱이 마지막으로 실행됐을 때 오프라인 모드로 설정되었더라도, Adjust SDK는 항상 온라인 모드로 시작합니다.

+ (void) setOfflineMode: (BOOL) enabled

Objective-C

Swift

Javascript

[Adjust setOfflineMode:YES]; // 오프라인 모드 활성화
[Adjust setOfflineMode:NO]; // 오프라인 모드 비활성화

특정 소스로부터 광고 매출 트래킹

Adjust SDK는 특정 네트워크 파트너로부터 광고 매출 정보를 수신하는 것을 지원합니다. 네트워크 파트너의 SDK에 의해 기록된 정보를 Adjust SDK에 JSON 객체로 전달할 수 있습니다.

참고:

이 기능은 특정 광고 매출 소스에 대해서만 이용할 수 있습니다. 값 표에서 지원되는 소스의 목록을 확인하시기 바랍니다.

+ (void) trackAdRevenue: (nonnull NSString *) source
                payload: (nonnull NSData *)   payload

Objective-C

Swift

// initilise ADJAdRevenue instance with appropriate ad revenue source
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
// pass revenue and currency values
[adRevenue setRevenue:1.6 currency:@"USD"];
// pass optional parameters
[adRevenue setAdImpressionsCount:adImpressionsCount];
[adRevenue setAdRevenueUnit:adRevenueUnit];
[adRevenue setAdRevenuePlacement:adRevenuePlacement];
[adRevenue setAdRevenueNetwork:adRevenueNetwork];
// attach callback and/or partner parameter if needed
[adRevenue addCallbackParameter:key value:value];
[adRevenue addPartnerParameter:key value:value];

// track ad revenue
[Adjust trackAdRevenue:source payload:payload];

파라미터

값	데이터 유형	설명
`소스`	문자열	광고 매출 정보의 소스
`페이로드`	데이터 객체	광고 매출 정보 JSON 페이로드

값

값	설명
`ADJAdRevenueSourceAppLovinMAX`	Applovin Max와의 광고 매출 트래킹 활성화
`ADJAdRevenueSourceAdMob`	AdMob과의 광고 매출 트래킹 활성화
`ADJAdRevenueSourceIronSource`	ironSource와의 광고 매출 트래킹 활성화
`ADJAdRevenueSourceAdMost`	Admost와의 광고 매출 트래킹을 활성화합니다.
`ADJAdRevenueSourceUnity`	Unity와의 광고 매출 트래킹을 활성화합니다.
`ADJAdRevenueSourceHeliumChartboost`	Helium Chartboost와의 광고 매출 트래킹을 활성화합니다.
`ADJAdRevenueSourcePublisher`	일반 소스와의 광고 매출 트래킹을 활성화합니다.

이벤트 트래킹

Adjust SDK는 Adjust 백엔드로 이벤트 정보를 전달하도록 해줍니다. 이는 로데이터 내보내기에서 확인할 수 있습니다.

+ (void) trackEvent: (nullable ADJEvent *) event

Objective-C

Swift

ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
[Adjust trackEvent:event];

파라미터

값	데이터 유형	설명
`이벤트`	ADJEvent 객체	트래킹하고자 하는 이벤트에 대한 ADJEvent 객체. Adjust 대시보드의 이벤트 토큰과 함께 설정되어야 합니다.

구독 트래킹

Adjust SDK는 인앱 구독 이벤트에 대한 정보를 트래킹할 수 있도록 해줍니다. 구독 객체를 만든 뒤 SDK에 전달하시기 바랍니다.

+ (void) trackSubscription: (nonnull ADJSubscription *) subscription

Objective-C

Swift

ADJSubscription *subscription = [[ADJSubscription alloc] initWithPrice:price
                                                              currency:currency
                                                         transactionId:transactionId
                                                            andReceipt:receipt];

[Adjust trackSubscription:subscription];

파라미터

값	데이터 유형	설명
`구독`	ADJSubscription 객체	트래킹하고자 하는 이벤트에 대한 ADJSubscription 객체.

앱 중지에 대해 SDK에 알리기

trackSubsessionEnd 메서드를 호출하여 Adjust SDK에 앱이 중지되었음을 알릴 수 있습니다.

참고:

이 메서드는 시스템 수준의 알림을 사용할 수 없을 때만 필요합니다.

+ (void) trackSubsessionEnd

Objective-C

Swift

[Adjust trackSubsessionEnd];

앱 재개에 대해 SDK에 알리기

trackSubsessionStart 메서드를 호출하여 Adjust SDK에 앱이 재개되었음을 알릴 수 있습니다.

참고:

이 메서드는 시스템 수준의 알림을 사용할 수 없을 때만 필요합니다.

Objective-C

Swift

[Adjust trackSubsessionStart];

SDK가 최초의 페이로드를 전송하도록 하기

Adjust SDK의 시작을 지연시키면 지연 타이머가 끝난 이후 백엔드로 정보가 전송됩니다. 지연 타이머가 끝나기 전에 SDK가 패키지를 보내도록 하려면 이 메서드를 사용할 수 있습니다.

+ (void) sendFirstPackages

Objective-C

Swift

[Adjust sendFirstPackages];