AdjustConfig class

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

중요:

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

기능

AdjustConfig 클래스로 SDK 설정

중요:

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

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

AdjustConfig (Context context, String appToken, String environment, boolean allowSuppressLogLevel)

Java

Javascript

String appToken = "{YourAppToken}";
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
AdjustConfig config = new AdjustConfig(this, appToken, environment, true);

파라미터

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

값

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

이벤트 버퍼링 활성화

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

void setEventBufferingEnabled (Boolean eventBufferingEnabled)

Java

Javascript

adjustConfig.setEventBufferingEnabled(true);

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

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

void setSendInBackground (boolean sendInBackground)

Java

Javascript

adjustConfig.setSendInBackground(true);

로깅 수준 변경

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

void setLogLevel (LogLevel logLevel)

Java

Javascript

adjustConfig.setLogLevel(LogLevel.WARN);

파라미터

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

값

표준 값	웹뷰 값	설명
`LogLevel.VERBOSE`	`AdjustConfig.LogLevelVerbose`	풀 로깅 활성화
`LogLevel.DEBUG`	`AdjustConfig.LogLevelDebug`	디버그 문제를 위해 더욱 상세한 로깅 활성화
`LogLevel.INFO`	`AdjustConfig.LogLevelInfo`	정보, 경고, 오류, assert 로그 반환
`LogLevel.WARN`	`AdjustConfig.LogLevelWarn`	경고, 오류, assert 로그 반환
`LogLevel.ERROR`	`AdjustConfig.LogLevelError`	오류와 assert 로그만 반환
`LogLevel.ASSERT`	`AdjustConfig.LogLevelAssert`	assert 로그만 반환
`LogLevel.SUPPRESS`	`AdjustConfig.LogLevelSuppress`	모든 로깅 비활성화

맞춤 프로세스 이름 설정

멀티 프로세스 앱을 빌드하는 경우, config 객체에서 메인 프로세스 이름을 설정해야 합니다.

void setProcessName (String processName)

Java

AdjustConfig.setProcessName("com.example.myapp:YourMainProcessName");

디폴트 트래커 설정

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

void setDefaultTracker (String defaultTracker)

Java

Javascript

adjustConfig.setDefaultTracker("{LinkToken}");

파라미터

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

어트리뷰션 수신기 설정

델리게이트 콜백을 등록하여 트래커 어트리뷰션의 변경 사항에 대한 알림을 받을 수 있습니다. 어트리뷰션에 고려되는 소스가 다르기 때문에 Adjust SDK는 이 정보를 동시적으로 제공할 수 없습니다.

void setOnAttributionChangedListener (OnAttributionChangedListener onAttributionChangedListener)

Java

Javascript

config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
    @Override
    public void onAttributionChanged(AdjustAttribution attribution) {}
});

알려진 기기 여부 설정

기기가 이미 config 인스턴스에 알려진 기기인지 명시할 수 있습니다.

void setDeviceKnown (boolean deviceKnown)

Java

Javascript

AdjustConfig.setDeviceKnown(true);

이벤트 트래킹 성공 델리게이트 설정

이벤트가 성공적으로 트래킹되었음을 알리기 위해 델리게이트 콜백을 등록할 수 있습니다.

void setOnEventTrackingSucceededListener (OnEventTrackingSucceededListener onEventTrackingSucceededListener)

Java

Javascript

config.setOnEventTrackingSucceededListener(new OnEventTrackingSucceededListener() {
    @Override
    public void onFinishedEventTrackingSucceeded(AdjustEventSuccess eventSuccessResponseData) {
        // ...
    }
});

이벤트 트래킹 실패 델리게이트 설정

이벤트가 트래킹 되지 않았음을 알리기 위해 델리게이트 콜백을 등록할 수 있습니다.

void setOnEventTrackingFailedListener (OnEventTrackingFailedListener onEventTrackingFailedListener)

Java

Javascript

config.setOnEventTrackingFailedListener(new OnEventTrackingFailedListener() {
    @Override
    public void onFinishedEventTrackingFailed(AdjustEventFailure eventFailureResponseData) {
        // ...
    }
});

세션 트래킹 성공 델리게이트 설정

세션이 성공적으로 트래킹되었음을 알리기 위해 델리게이트 콜백을 등록할 수 있습니다.

void setOnSessionTrackingSucceededListener (OnSessionTrackingSucceededListener onSessionTrackingSucceededListener)

Java

Javascript

config.setOnSessionTrackingSucceededListener(new OnSessionTrackingSucceededListener() {
    @Override
    public void onFinishedSessionTrackingSucceeded(AdjustSessionSuccess sessionSuccessResponseData) {
        // ...
    }
});

세션 트래킹 실패 델리게이트 설정

세션이 트래킹 되지 않았음을 알리기 위해 델리게이트 콜백을 등록할 수 있습니다.

void setOnSessionTrackingFailedListener (OnSessionTrackingFailedListener onSessionTrackingFailedListener)

Java

Javascript

config.setOnSessionTrackingFailedListener(new OnSessionTrackingFailedListener() {
    @Override
    public void onFinishedSessionTrackingFailed(AdjustSessionFailure sessionFailureResponseData) {
        // ...
    }
});

딥링크 응답 수신기 설정

수신기를 설정하여 딥링크 정보에 응답하도록 할 수 있습니다. 수신기는 불 논리 값을 반환해야 합니다. 이 값은 유저가 딥링크를 열었을 때 액티비티의 실행 여부를 나타냅니다. 자세한 내용은 딥링크 가이드를 참조하시기 바랍니다.

void setOnDeeplinkResponseListener (OnDeeplinkResponseListener onDeeplinkResponseListener)

Java

Javascript

config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() {
    @Override
    public boolean launchReceivedDeeplink(Uri deeplink) {
        // ...
        if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) {
            return true;
        } else {
            return false;
        }
    }
});

SDK 실행 지연

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

중요:

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

void setDelayStart (double delayStart)

Java

Javascript

adjustConfig.setDelayStart(5.5);

파라미터

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

외부 기기 ID 전송

외부 기기 식별자는 기기 또는 유저에 할당할 수 있는 맞춤 값입니다. 기기 식별자가 변경된 이후에도 여러 세션과 설치에서 유저를 식별할 수 있는 유용한 방법입니다.

void setExternalDeviceId (String externalDeviceId)

Java

Javascript

adjustConfig.setExternalDeviceId("{YourExternalDeviceId}")

사전설치 트래킹 활성화 여부 설정

Adjust SDK를 사용하여 앱이 유저 기기에 사전 설치되었는지 확인할 수 있습니다. 가장 좋은 방법은 시스템 페이로드를 사용하는 것입니다. 이를 확인하려면 config 객체에서 해당 기능을 활성화해야 합니다.

void setPreinstallTrackingEnabled (boolean preinstallTrackingEnabled)

Java

Javascript

adjustConfig.setPreinstallTrackingEnabled(true);

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

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

void setNeedsCost (boolean needsCost)

Java

Javascript

adjustConfig.setNeedsCost(true);

데이터 레지던시 설정

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

void setUrlStrategy (String urlStrategy)

Java

Javascript

adjustConfig.setUrlStrategy(AdjustConfig.DATA_RESIDENCY_EU);

파라미터

표준 값	웹뷰 값	설명
`AdjustConfig.DATA_RESIDENCY_EU`	`AdjustConfig.DataResidencyEU`	EU를 GDPR을 위한 레지던시 지역으로 설정.
`AdjustConfig.DATA_RESIDENCY_TR`	`AdjustConfig.DataResidencyTR`	터키를 레지던시 국가로 설정.
`AdjustConfig.DATA_RESIDENCY_US`	`AdjustConfig.DataResidencyUS`	USA를 레지던시 국가로 설정.
`AdjustConfig.URL_STRATEGY_CHINA`	`AdjustConfig.UrlStrategyChina`	URL 전략을 `app.adjust.world` 도메인으로 설정합니다.
`AdjustConfig.URL_STRATEGY_CN`	`AdjustConfig.UrlStrategyCn`	URL 전략을 `app.adjust.cn` 도메인으로 설정합니다.
`AdjustConfig.URL_STRATEGY_CN_ONLY`	`AdjustConfig.UrlStrategyCnOnly`	URL strategy를 `app.adjust.cn` 도메인으로 설정하지만 요청 실패 시 다른 도메인으로 되돌릴 수 없습니다.
`AdjustConfig.URL_STRATEGY_INDIA`	`AdjustConfig.UrlStrategyIndia`	URL 전략을 `app.adjust.net.in` 도메인으로 설정합니다.