구성

Adjust.initSdk 메서드의 속성을 지정해 Adjust SDK의 행동을 설정할 수 있습니다.

필요 구성

function initSdk({ logLevel, logOutput, ...options }: InitOptions): void;

Adjust SDK를 구성하려면 다음 인수로 Adjust.initSdk 메서드를 호출해야 합니다.

• appToken string: Adjust 앱 토큰입니다.
• environment (string): SDK를 실행할 환경입니다. 테스트를 위해 샌드박스 모드에서 SDK를 실행하려면 sandbox를 전달합니다. 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 production을 전달합니다.

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
});

로깅 옵션

export type LogOptionsT = $ReadOnly<
   $Shape<{|
      logLevel: "none" | "error" | "warning" | "info" | "verbose",
      logOutput: string,
   |}>
>;

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

initSdk 메서드에 logLevel 인수를 지정하여 로그 수준을 설정할 수 있습니다. 값을 전달하지 않으면 SDK의 기본값은 error입니다.

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
   logLevel: "verbose",
});

로그 출력 설정

웹 앱의 로그 출력 위치를 위임하여 화면에 바로 로그를 표시할 수 있습니다. 이를 위해 initSdk 메서드의 logOutput 인수에 HTML 선택자를 지정합니다. SDK 로그가 이 컨테이너에 출력됩니다.

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
   logOutput: "#logDiv",
});

초기화 옵션

export type InitOptionsT = $ReadOnly<
   $Shape<{|
      appToken: $PropertyType<BaseParamsT, "appToken">,
      environment: $PropertyType<BaseParamsT, "environment">,
      defaultTracker: $PropertyType<BaseParamsT, "defaultTracker">,
      externalDeviceId: $PropertyType<BaseParamsT, "externalDeviceId">,
      customUrl: $PropertyType<CustomConfigT, "customUrl">,
      dataResidency: $PropertyType<CustomConfigT, "dataResidency">,
      urlStrategy: $PropertyType<CustomConfigT, "urlStrategy">,
      eventDeduplicationListLimit: $PropertyType<
         CustomConfigT,
         "eventDeduplicationListLimit"
      >,
      namespace: $PropertyType<CustomConfigT, "namespace">,
      attributionCallback: (string, Object) => mixed,
   |}>
>;

외부 디바이스 ID 설정

externalDeviceId: string;

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

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

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
   externalDeviceId: "YOUR_EXTERNAL_DEVICE_ID",
});

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

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

디폴트 링크 토큰 설정

defaultTracker: string;

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

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
   defaultTracker: "YOUR_LINK_TOKEN",
});

스토리지 네임스페이스 설정

namespace: string;

Adjust SDK는 데이터를 저장할 스토리지 네임스페이스를 기본 설정에 따라 생성합니다. 데이터가 저장될 위치를 제어하려면 커스텀 네임스페이스를 지정해 재정의할 수 있습니다.

설정된 경우 SDK가 기본 네임스페이스에 저장한 모든 데이터는 커스텀 네임스페이스로 이동됩니다.

initSdk 메서드의 namespace 속성을 지정하면 커스텀 네임스페이스를 설정할 수 있습니다.

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
   namespace: "myCustomNamespace",
});

동적 구성

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

오프라인 모드 토글

function switchToOfflineMode(): void;

Adjust SDK는 실시간으로 이벤트와 세션 데이터를 Adjust 서버로 전송합니다. SDK를 오프라인 모드로 설정하면 정보 전송이 일시 중단됩니다. 오프라인 모드에서 SDK는 모든 데이터를 브라우저의 IndexedDB에 저장하거나 IndexedDB가 지원되지 않는 경우 localStorage에 저장합니다.

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

Adjust.switchToOfflineMode();

이벤트 버퍼링

function switchBackToOnlineMode(): void;

이후 SDK의 오프라인 모드가 해제되면 Adjust 서버로 저장된 모든 정보가 전송됩니다. 해당 기능 사용을 원하는 경우 switchBackToOnlineMode 메서드를 호출합니다.

Adjust.switchBackToOnlineMode();

SDK 비활성화

function stop(): void;

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

stop 메서드를 호출하여 언제든지 SDK를 비활성화할 수 있습니다.

Adjust.stop();

SDK 재활성화

function restart(): void;

restart 메서드를 호출하여 언제든지 SDK를 재시작할 수 있습니다.

Adjust.restart();