Adjust 클래스

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

기능

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

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

static void com.adjust.sdk.Adjust.addSessionCallbackParameter ( String key,
                                                                String value 
                                                              )

Java

Javascript

Adjust.addSessionCallbackParameter("foo", "bar");

세션 콜백 파라미터 삭제

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

static void com.adjust.sdk.Adjust.removeSessionCallbackParameter ( String key )

Java

Javascript

Adjust.removeSessionCallbackParameter("foo");

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

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

static void com.adjust.sdk.Adjust.resetSessionCallbackParameters()

Java

Javascript

Adjust.resetSessionCallbackParameters();

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

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

static void com.adjust.sdk.Adjust.addSessionPartnerParameter ( String key,
                                                               String value
                                                             )

Java

Javascript

Adjust.addSessionPartnerParameter("foo", "bar");

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

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

static void com.adjust.sdk.Adjust.removeSessionPartnerParameter ( String key )

Java

Javascript

Adjust.removeSessionPartnerParameter("foo");

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

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

static void com.adjust.sdk.Adjust.resetSessionPartnerParameters ()

Java

Javascript

Adjust.resetSessionPartnerParameters();

기기에 대한 Adjust ID 얻기

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

참고:

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

static String com.adjust.sdk.Adjust.getAdid ()

Java

Javascript

String adid = Adjust.getAdid();

반환 값

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

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

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

static void com.adjust.sdk.Adjust.appWillOpenUrl ( Uri     url,
                                                   Context context 
                                                 )

Java

Javascript

Adjust.appWillOpenUrl(url, getApplicationContext());

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

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

참고:

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

static AdjustAttribution com.adjust.sdk.Adjust.getAttribution ()

Java

Javascript

AdjustAttribution attribution = Adjust.getAttribution();

서드파티 공유 옵션 변경

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

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

Java

Javascript

// Disable third-party sharing for the user AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing);

// Enable third-party sharing for the user AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing);

// Gather granular details AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(null); adjustThirdPartySharing.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(adjustThirdPartySharing);

// Partner-specific third-party sharing AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(null); adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "install", true); adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "events", true); adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "sessions", true); Adjust.trackThirdPartySharing(adjustThirdPartySharing);

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

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

static void com.adjust.sdk.Adjust.disableThirdPartySharing (final Context context)

Java

Javascript

Adjust.disableThirdPartySharing(getApplicationContext());

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

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

static void com.adjust.sdk.Adjust.trackMeasurementConsent (final boolean consentMeasurement)

Java

Javascript

Adjust.trackMeasurementConsent(true);

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

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

static void com.adjust.sdk.Adjust.gdprForgetMe (final Context context)

Java

Javascript

Adjust.gdprForgetMe(context);

기기의 Google Play 광고 ID 얻기

Google Play Store를 타겟팅하는 경우, Adjust SDK를 사용하여 기기의 광고 ID를 조회하도록 할 수 있습니다. 이는 애널리틱스에 유용할 수 있습니다.

static void com.adjust.sdk.Adjust.getGoogleAdId (Context         context,
                                                 OnDeviceIdsRead onDeviceIdRead
                                                )

Java

Javascript

Adjust.getGoogleAdId(this, new OnDeviceIdsRead() {
    @Override
    public void onGoogleAdIdRead(String googleAdId) {}
});

기기의 Amazon 광고 ID 얻기

Amazon App Store를 타겟팅하는 경우, Adjust SDK를 사용하여 기기의 광고 ID를 조회하도록 할 수 있습니다. 이는 애널리틱스에 유용할 수 있습니다.

static String com.adjust.sdk.Adjust.getAmazonAdId (final Context context)

Java

Javascript

String amazonAdId = Adjust.getAmazonAdId(context);

Adjust SDK 활성화 및 비활성화

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

참고:

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

static void com.adjust.sdk.Adjust.setEnabled (boolean enabled)

Java

Javascript

Adjust.setEnabled(false);

Adjust가 활성화 상태인지 확인

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

static boolean com.adjust.sdk.Adjust.isEnabled ()

Java

Javascript

Adjust.isEnabled();

Adjust SDK 버전 확인

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

static String com.adjust.sdk.Adjust.getSdkVersion ()

Java

Javascript

Adjust.getSdkVersion();

푸시 토큰 설정

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

static void com.adjust.sdk.Adjust.setPushToken (final String  token,
                                                final Context context
                                               )

Java

Javascript

// Send the token with context (recommended)
Adjust.setPushToken(pushNotificationsToken, context);

// Send the token without context (not recommended)
Adjust.setPushToken(pushNotificationsToken);

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

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

중요:

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

static void com.adjust.sdk.Adjust.setOfflineMode (boolean enabled)

Java

Javascript

Adjust.setOfflineMode(true); // 오프라인 모드 활성화
Adjust.setOfflineMode(false); // 오프라인 모드 비활성화

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

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

참고:

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

static void com.adjust.sdk.Adjust.trackAdRevenue (final AdjustAdRevenue adjustAdRevenue)

Java

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); adjustAdRevenue.setRevenue(1.00, "EUR"); adjustAdRevenue.setAdImpressionsCount(10);
adjustAdRevenue.setAdRevenueNetwork("network1");
adjustAdRevenue.setAdRevenueUnit("unit1");
adjustAdRevenue.setAdRevenuePlacement("banner");
adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue);

값

값	설명
`AdjustConfig.AD_REVENUE_APPLOVIN_MAX`	Applovin Max와의 광고 매출 트래킹 활성화
`AdjustConfig.AD_REVENUE_ADMOB`	AdMob과의 광고 매출 트래킹 활성화
`AdjustConfig.AD_REVENUE_IRONSOURCE`	ironSource와의 광고 매출 트래킹 활성화
`AdjustConfig.AD_REVENUE_ADMOST`	Admost와의 광고 매출 트래킹을 활성화합니다.
`AdjustConfig.AD_REVENUE_UNIITY`	Unity와의 광고 매출 트래킹을 활성화합니다.
`AdjustConfig.AD_REVENUE_HELIUM_CHARTBOOST`	Helium Chartboost와의 광고 매출 트래킹을 활성화합니다.
`AdjustConfig.AD_REVENUE_SOURCE_PUBISHER`	일반 소스와의 광고 매출 트래킹을 활성화합니다.

이벤트 트래킹

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

static void com.adjust.sdk.Adjust.trackEvent (AdjustEvent event)

Java

Javascript

AdjustEvent adjustEvent = new AdjustEvent("abc123");
Adjust.trackEvent(adjustEvent);

파라미터

파라미터	데이터 유형	설명
`이벤트`	`AdjustEvent` 객체	트래킹하려는 이벤트. 이는 이벤트 토큰과 함께 초기화되어야 합니다.

구독 트래킹

경고:

Adjust는 더 이상 신규 고객에 대해 해당 버전의 구독 기록을 제공하지 않습니다. 이미 구독 기록을 설정한 경우 담당 테크니컬 어카운트 매니저나 support@adjust.com 에 연락하여 지원을 받으시기 바랍니다.

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

static void com.adjust.sdk.Adjust.trackPlayStoreSubscription (final AdjustPlayStoreSubscription subscription)

Java

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
    price,
    currency,
    sku,
    orderId,
    signature,
    purchaseToken);
subscription.setPurchaseTime(purchaseTime);

Adjust.trackPlayStoreSubscription(subscription);

파라미터

파라미터	데이터 유형	설명
가격	Long	통화 기호를 포함한 구독 가격.
통화(currency)	문자열	트랜잭션에 사용된 통화 코드.
sku	문자열	제품 ID.
주문 ID	문자열	주문 ID.
서명	문자열	구매 데이터의 데이터 서명.
purchaseToken(구매 토큰)	문자열	구매에 대한 고유 토큰 반환.
purchaseTime(구매 시간)	Long	구매가 발생한 시간.

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

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

static void com.adjust.sdk.Adjust.sendFirstPackages ()

Java

Javascript

Adjust.sendFirstPackages();