adjust-icon

구성

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

config 객체 인스턴스화

메서드 서명
public AdjustConfig(string appToken, AdjustEnvironment environment, bool allowSuppressLogLevel)

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

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

  • appToken string: Adjust 앱 토큰입니다.
  • environment (AdjustEnvironment): SDK를 실행할 환경입니다. 테스트를 위해 샌드박스 모드에서 SDK를 실행하려면 AdjustEnvironment.Sandbox를 전달합니다. 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 AdjustEnvironment.Production을 전달합니다.
  • allowSuppressLogLevel (bool): 모든 로깅의 비활성화 여부입니다. true로 설정하여 로깅을 비활성화하거나 false로 설정하여 로깅을 활성화합니다.
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, false);
// ...
Adjust.InitSdk(adjustConfig);

읽기 전용 구성

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

로깅 수준 설정

속성 선언
public AdjustLogLevel? LogLevel { get; set; }

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

logLevel설명
AdjustLogLevel.Verbose모든 로깅 활성화
AdjustLogLevel.Debug디버그 로깅 활성화
AdjustLogLevel.Info정보 수준 로그만 표시(기본 설정)
AdjustLogLevel.Warn정보 로깅 비활성화
AdjustLogLevel.Error경고 수준 로깅 이하 비활성화
AdjustLogLevel.Assert오류 수준 로깅 이하 비활성화
AdjustLogLevel.Suppress모든 로깅 비활성화

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

AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
config.LogLevel = AdjustLogLevel.Error;
//...
Adjust.InitSdk(config);

외부 디바이스 ID 설정

속성 선언
public string ExternalDeviceId { get; set; }

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

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.ExternalDeviceId = "{Your-External-Device-Id}";
//...
Adjust.InitSdk(adjustConfig);

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

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

속성 선언
public string DefaultTracker { get; set; }

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
//...
adjustConfig.DefaultTracker = "{TrackerToken}";
//...
Adjust.InitSdk(adjustConfig);

어트리뷰션에서 광고 비용 데이터 수신

속성 선언
public bool? IsCostDataInAttributionEnabled { get; set; }

기본 설정에 따라 Adjust SDK는 사용자의 어트리뷰션에서 비용 데이터를 전송하지 않습니다. AdjustConfig 인스턴스의 IsCostDataInAttributionEnabled 속성을 true 로 설정하여 SDK가 이 정보를 요청하도록 구성할 수 있습니다.

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

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.LogLevel = AdjustLogLevel.Verbose;
adjustConfig.IsCostDataInAttributionEnabled = true;
Adjust.InitSdk(adjustConfig);

백그라운드 기록 활성화

속성 선언
public bool? IsSendingInBackgroundEnabled { get; set; }

기본값에 따라 Adjust SDK는 앱이 백그라운드에서 실행 중일 때 요청 전송을 일시 중지합니다. AdjustConfig 인스턴스의 IsSendingInBackgroundEnabled 속성을 true 로 설정하여 앱이 백그라운드에서 실행되는 동안 정보를 전송하도록 SDK를 구성할 수 있습니다.

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
//...
adjustConfig.IsSendingInBackgroundEnabled = true;
//...
Adjust.InitSdk(adjustConfig);

동적 구성

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

오프라인 모드 활성화

메서드 서명
public static void SwitchToOfflineMode();

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

오프라인 모드를 활성화하려면 Adjust.SwitchToOfflineMode 메서드를 호출합니다.

Adjust.SwitchToOfflineMode();

오프라인 모드 비활성화

메서드 서명
public static void SwitchBackToOnlineMode();

Adjust.SwitchBackToOnlineMode 메서드를 호출하여 SDK를 재활성화할 수 있습니다. 이렇게 하면 SDK가 정보 전송을 재개합니다.

Adjust.SwitchBackToOnlineMode();

푸시 토큰 설정

메서드 서명
public static void SetPushToken(string pushToken)

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

Adjust.SetPushToken 메서드를 호출하고 다음 인수를 전달하여 언제든지 푸시 토큰을 업데이트할 수 있습니다.

  • pushToken (string): 푸시 토큰
Adjust.SetPushToken("{YourPushToken}");

SDK 비활성화

메서드 서명
public static void Disable()

Adjust SDK는 기본 설정에 따라 앱이 열려 있을 때 실행됩니다. Adjust.Disable 메서드를 호출하여 Adjust SDK를 비활성화하고 Adjust로 정보를 전송하는 것을 일시 중지할 수 있습니다. Adjust SDK를 비활성화하면 Adjust로 데이터가 전송되지 않으며, SDK에 어떠한 정보도 기록되지 않습니다. 즉, SDK가 비활성화되었을 때 호출된 Adjust 메서드는 아무것도 기록하지 않습니다.

Adjust.Disable();

SDK 활성화

메서드 서명
public static void Enable()

SDK를 비활성화한 후에 다시 활성화하려면 Adjust.Enable 메서드를 호출합니다. SDK가 활성화되면 Adjust 서버로 정보를 전송합니다.

Adjust.Enable();

활성화 상태 조회

메서드 서명
public static void IsEnabled(Action<bool> callback)

Adjust.IsEnabled 메서드를 호출하고 콜백 함수를 전달하여 언제든지 Adjust SDK가 활성화되었는지 확인할 수 있습니다. 상태는 비동기적으로 반환되며 boolean 값으로 콜백 함수에 전달됩니다.

Adjust.IsEnabled(isEnabled =>
{
// Your callback function
});