스마트 배너 SDK 초기화 옵션

다음 파라미터를 설정하여 스마트 배너 SDK의 작동 방식을 제어합니다.

필수 파라미터

앱 토큰 설정

스마트 배너 SDK를 초기화하려면 AdjustSmartBanner.init 메서드를 호출합니다.

AdjustSmartBanner.init({
   appToken: "APP_TOKEN",
});

이 메서드를 호출하면 SDK는 기기 플랫폼을 감지합니다. 모바일 플랫폼 기기인 경우 SDK는 사용 가능한 스마트 배너를 로딩하고, 초기화 이후 대상 배너가 즉시 표시됩니다.

프로젝트가 단일 플랫폼 앱을 타겟팅하는 경우, 각 플랫폼 토큰을 appToken 객체의 키로 전달합니다.

AdjustSmartBanner.init({
   appToken: {
      ios: "IOS_APP_TOKEN",
      android: "ANDROID_APP_TOKEN",
   },
});

선택적 파라미터

로그 수준 설정

SDK가 수행하는 로깅의 verbosity를 구성합니다.

AdjustSmartBanner.init({
   logLevel: "verbose",
});

배너 언어 설정

배너 표시 시 사용되는 언어를 설정하려면 language 파라미터를 설정합니다.

AdjustSmartBanner.init({
   language: "fr",
});

딥링크 구성

딥링크 설정을 통해 사용자가 스마트 배너를 클릭할 때 앱의 어느 위치로 랜딩할지 지정할 수 있습니다.

스마트 배너와의 딥링크를 제어하려면 다음의 파라미터를 사용하시기 바랍니다.

• context (객체): 딥링크 경로에서 플레이스홀더({})를 채우기 위한 데이터를 포함하는 객체.
• androidDeepLinkPath (String): Android 기기에서 사용자가 리디렉션되는 앱 내 위치.
• iosDeepLinkPath (String): iOS 기기에서 사용자가 리디렉션되는 앱 내 위치.
• context (객체): androidDeepLinkPath 및 iosDeepLinkPath 경로에서 보간된 값을 포함하는 객체.

예시

본 예시에서는 배너는 context 객체로부터 item_id 를 보간하여 iOS 사용자를 products/product=cool_jeans_123 의 딥링크 path로 리디렉션합니다.

AdjustSmartBanner.init({
   // other initialisation parameters including mandatory ones
   iosDeepLinkPath: "products/product={item_id}",
   context: {
      item_id: "cool_jeans_123",
   },
});

본 예시에서는 배너는 context 객체로부터 item_id 를 보간하여 Android 사용자를 products/product=cool_jeans_123 의 딥링크 path로 리디렉션합니다.

AdjustSmartBanner.init({
   // other initialisation parameters including mandatory ones
   androidDeepLinkPath: "products/{item_id}",
   context: {
      item_id: "cool_jeans_123",
   },
});

본 예시에서 배너는 context 객체로부터 item_id 를 보간하여 iOS 사용자와 Android 사용자 모두를 products/product=cool_jeans_123 에 있는 딥링크 path로 리디렉션합니다.

AdjustSmartBanner.init({
   // other initialisation parameters including mandatory ones
   androidDeepLinkPath: "products/{item_id}",
   iosDeepLinkPath: "products/product={item_id}",
   context: {
      item_id: "cool_jeans_123",
   },
});

context 객체를 사용하여 플랫폼별로 각기 다른 컨텍스트 변수를 정의할 수 있습니다. 예시:

• Android 사용자는 promo/new_user 으로 이동됩니다.
• iOS 사용자는 main/registrationFinished 으로 이동됩니다.
• unused_variable 는 무시됩니다.

AdjustSmartBanner.init({
   // other initialisation parameters including mandatory ones
   androidDeepLinkPath: "promo/{android_promo}",
   iosDeepLinkPath: "main/{ios_promo}",
   context: {
      android_promo: "new_user",
      ios_promo: "registrationFinished",
      unused_variable: "this will be ignored",
   },
});

배너 상위 요소 설정

상위 요소를 지정하여 스마트 배너의 위치를 지정할 수 있습니다. 기본 설정에 따라 배너는 document.body에 첨부되어 있습니다. 기존의 HTMLElement를 지정하여 이를 재정의할 수 있습니다.

아래의 예시에서는 스마트 배너가 ID가 root-for-banner인 요소에 첨부되어 있습니다.

const element = document.querySelector("#root-for-banner");

AdjustSmartBanner.init({
   bannerParent: element,
});

배너 종료 시 함수 실행

onCreated 파라미터를 사용하여 스마트 배너가 생성된 즉시 실행되는 함수를 구성할 수 있습니다.

이 예시에서는 배너가 생성될 때 콘솔에 로그가 출력됩니다.

AdjustSmartBanner.init({
   onCreated: () => console.log("Smart banner shown"),
});

배너 종료 시 함수 실행

스마트 배너가 닫힐 때마다 실행되는 함수를 구성하려면 onDismissed 파라미터를 사용합니다.

이 예시에서는 배너가 닫혔을 때 콘솔에 로그가 출력됩니다.

AdjustSmartBanner.init({
   onDismissed: () => console.log("Smart banner dismissed"),
});