adjust-icon

구성

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

config 객체 인스턴스화

메서드 서명
AdjustConfig(this._appToken, this._environment) {
   _initCallbackHandlers();
   _skAdNetworkHandling = true;
}

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

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

  • appToken String: Adjust 앱 토큰입니다.
  • environment (String): SDK를 실행할 환경입니다. 테스트를 위해 샌드박스 모드에서 SDK를 실행하려면 AdjustEnvironment.sandbox를 전달합니다. 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 AdjustEnvironment.production을 전달합니다.
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
Adjust.start(adjustConfig);

읽기 전용 구성

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

로깅 수준 설정

속성 선언
AdjustLogLevel? logLevel;

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

logLevel설명
AdjustLogLevel.verbose모든 로깅 활성화
AdjustLogLevel.debug디버그 로깅 활성화
AdjustLogLevel.info정보 수준 로그만 표시(기본 설정)
AdjustLogLevel.warn정보 로깅 비활성화
AdjustLogLevel.error경고 수준 로깅 이하 비활성화
AdjustLogLevel.assert오류 수준 로깅 이하 비활성화
AdjustLogLevel.suppress모든 로깅 비활성화

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

  • logLevel (AdjustLogLevel): 사용할 로그 수준
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.logLevel = AdjustLogLevel.verbose;
//...
Adjust.start(adjustConfig);

외부 디바이스 ID 설정

속성 선언
String? externalDeviceId;

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

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

  • externalDeviceId (String): 외부 기기 ID. 이 값은 대소문자를 구분 합니다. 외부 기기 ID를 불러오기한 경우, 전달한 값이 불러온 값과 일치하는지 확인하시기 바랍니다.
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.externalDeviceId = '{Your-External-Device-Id}';
//...
Adjust.start(adjustConfig);

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

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

속성 선언
String? defaultTracker;

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

AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.defaultTracker = '{TrackerToken}';
//...
Adjust.start(adjustConfig);

비용 데이터 전송 활성화

속성 선언
bool? needsCost;

기본 설정에 따라 Adjust SDK는 사용자의 어트리뷰션에서 비용 데이터를 전송하지 않습니다. 비용 데이터 전송을 활성화하여 이 데이터를 전송하도록 SDK를 구성할 수 있습니다. 비용 데이터 전송을 활성화하려면 config 인스턴스의 needsCost 속성에 bool 값을 할당합니다.

  • needsCost (bool): 비용 데이터 전송을 활성화하거나 true, 비용 데이터 전송을 비활성화하려면 false로 설정합니다.

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

AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.needsCost = true;
//...
Adjust.start(adjustConfig);

백그라운드 기록 활성화

속성 선언
bool? sendInBackground;

기본값에 따라 Adjust SDK는 앱이 백그라운드에서 실행 중일 때 요청 전송을 일시 중지합니다. 백그라운드 기록을 활성화하여 백그라운드에서 요청을 보내도록 SDK를 구성할 수 있습니다. 백그라운드 기록을 활성화하려면 config 인스턴스의 sendInBackground 속성에 bool 값을 할당합니다.

  • sendInBackground (bool): 백그라운드 전송을 활성화하거나 true, 백그라운드 전송을 비활성화하려면 false로 설정합니다.
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.sendInBackground = true;
//...
Adjust.start(adjustConfig);

이벤트 버퍼링 활성화

속성 선언
bool? eventBufferingEnabled;

Adjust SDK는 사용자가 앱에서 이벤트를 트리거하면 즉시 이벤트 정보를 전송합니다. 이벤트 버퍼링을 사용하면 이벤트 정보 전송을 스케줄할 수 있습니다. 이벤트 버퍼링은 기기의 로컬 버퍼에 이벤트를 저장하고 분당 한 번 모든 요청을 보냅니다.

config 객체에는 해당 동작을 제어하는 boolean eventBufferingEnabled 속성이 포함되어 있습니다. 이벤트 버퍼링을 활성화하려면 config 인스턴스의 eventBufferingEnabled 속성에 bool 값을 할당합니다.

  • eventBufferingEnabled (bool): 이벤트 버퍼링을 활성화하거나 true, 이벤트 버퍼링을 비활성화하려면 false로 설정합니다.
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.eventBufferingEnabled = true;
//...
Adjust.start(adjustConfig);

SDK 시작 지연

속성 선언
double? delayStart;

기본 설정에 따라 Adjust SDK는 앱이 실행되자마자 시작됩니다. 시작할 때 사용할 수 없는 데이터를 세션 파라미터로 전송하려면 SDK의 시작을 지연시킬 수 있습니다. 이는 고유 ID와 같은 정보를 전송할 때 유용합니다.

시작 지연을 설정하려면 config 인스턴스의 delayStart 속성에 double 값을 할당합니다.

  • delayStart (double): SDK 시작이 지연된 시간(초)입니다. SDK 작동 시작은 최대 10초 간 지연시킬 수 있습니다.
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.Sandbox);
//...
adjustConfig.delayStart(5.5);
//...
Adjust.start(adjustConfig);

동적 구성

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

오프라인 모드 토글

메서드 서명
static void setOfflineMode(bool isOffline)

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

다음 인수로 setOfflineMode 메서드를 호출하여 언제든지 오프라인 모드를 토글할 수 있습니다.

  • isOffline (bool): 오프라인 모드를 활성화하거나 true, 오프라인 모드를 비활성화하려면 false로 설정합니다.
Adjust.setOfflineMode(true);

푸시 토큰 설정

메서드 서명
static void setPushToken(String token)

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

config 객체에는 푸시 토큰을 저장할 수 있는 pushToken 속성이 포함되어 있습니다. setPushToken 메서드를 호출하고 다음 인수를 전달하여 언제든지 이 속성을 업데이트할 수 있습니다.

  • token (String): 푸시 토큰
Adjust.setPushToken('{PushNotificationsToken}');

SDK 비활성화 또는 활성화

메서드 서명
static void setEnabled(bool isEnabled)

Adjust SDK는 기본 설정에 따라 앱이 열려 있을 때 실행됩니다. Adjust SDK를 비활성화하거나 재활성화하여 기록을 일시 중지하거나 재개할 수 있습니다. Adjust SDK를 비활성화하면 Adjust 서버로 데이터가 전송되지 않습니다.

다음 인수로 setEnabled 메서드를 호출하여 Adjust SDK를 언제든지 활성화 또는 비활성화할 수 있습니다.

  • isEnabled (bool): SDK를 활성화하거나 true, SDK를 비활성화하려면 false로 설정합니다.
Adjust.setEnabled(false);

활성화 상태 조회

메서드 서명
static Future<bool> isEnabled() async

언제든지 isEnabled 메서드를 호출하여 Adjust SDK가 활성화되어 있는지 확인할 수 있습니다. 이 메서드는 SDK의 활성화 (true) 또는 비활성화 (false) 여부를 나타내는 bool 값을 반환합니다.

Adjust.isEnabled();