adjust-icon

딥링킹

사용자를 앱의 특정 페이지로 이동시키기 위해 딥링크를 생성할 수 있습니다. Adjust SDK는 사용자 기기에 앱이 이미 설치되어 있는지 여부에 따라 다른 로직을 적용합니다.

  • 다이렉트 딥링킹: 사용자 기기에 앱이 이미 설치되어 있는 경우에 사용됩니다. 사용자는 링크가 의도한 페이지로 이동됩니다.
  • 디퍼드 딥링킹: 사용자가 아직 앱을 설치하지 않은 경우에 사용됩니다. 링크는 먼저 사용자를 앱을 설치할 수 있는 스토어 페이지로 이동시킵니다. 사용자가 앱을 설치한 이후에 링크는 의도한 페이지를 엽니다.

SDK는 사용자가 링크를 통해 앱을 실행한 이후에 딥링크 데이터를 읽을 수 있습니다.

Set up deep linking

사용자가 앱을 설치한 경우, 사용자가 딥링크 정보가 포함된 링크를 클릭하면 딥링크가 실행됩니다. Adjust SDK는 앱에서 사용하기 위해 딥링크 정보를 파싱할 수 있는 툴을 포함하고 있습니다.

v4.30부터 SDK는 필요한 설정을 Android 및 iOS 프로젝트에 주입합니다. 딥링크를 구성하려면 Unity Editor 인스펙터 윈도우에서 URL 스킴을 추가하시기 바랍니다.

React Native 앱에 대한 딥링크 설정 방법:

  1. 앱 레벨에서의 딥링킹 설정. 아래의 플랫폼별 딥링크 설정 가이드 링크를 참조하시기 바랍니다.

  2. React Native 문서를 참조하고 지침에 따라 두 플랫폼을 모두 지원하는 방법을 확인합니다.

  3. 딥링크 URL을 자바스크립트 코드에 사용합니다.

Deferred deep linking

Disable deferred deep linking

메서드 서명
public disableDeferredDeeplinkOpening(): void

SDK는 기본 설정에 따라 디퍼드 딥링크를 실행합니다. disableDeferredDeeplinkOpening 메서드를 호출하여 이 설정을 구성할 수 있습니다.

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);


adjustConfig.disableDeferredDeeplinkOpening();


Adjust.initSdk(adjustConfig);
메서드 서명
public setDeferredDeeplinkCallback(callback: (deeplink: AdjustDeeplink) => void): void

디퍼드 딥링크 수신 시 델리게이트 함수를 호출하도록 Adjust SDK를 구성할 수 있습니다. 이 델리게이트 함수는 딥링크를 string 인수로 수신합니다.

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);


adjustConfig.setDeferredDeeplinkCallback(function (deeplink) {
   console.log("Deferred deep link URL content: " + deeplink.deeplink);
});


Adjust.initSdk(adjustConfig);

Example

이 예시에서는 사용자가 디퍼드 딥링크를 열 때 Adjust가 딥링크 주소를 기록하는 방법을 보여줍니다.

var LogDeepLink = function (deeplinkURL) {
   console.log("Deeplink URL: " + deeplinkURL);
};


const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setDeferredDeeplinkCallback(LogDeepLink);


Adjust.initSdk(adjustConfig);
메서드 서명
processDeeplink: (adjustDeeplink: AdjustDeeplink) => void

Adjust를 사용하면 딥링크를 사용하여 리타겟팅 캠페인을 진행할 수 있습니다. 자세한 내용은 Campaign Lab에서 딥링크를 설정하는 방법을 확인하시기 바랍니다.

사용자를 리어트리뷰션하려면 앱에서 딥링크 콘텐츠를 수신할 때 Adjust.processDeeplink 메서드를 호출해야 합니다. 이후 Adjust SDK는 딥링크 내에서 새로운 어트리뷰션 데이터를 찾습니다. SDK가 새로운 정보를 찾으면 이는 리어트리뷰션을 위해 Adjust 서버로 전달됩니다.

componentDidMount() {
    Linking.addEventListener('url', this.handleDeepLink);
    Linking.getInitialURL().then((url) => {
        if (url) {
            this.handleDeepLink({ url });
        }
    })
}


componentWillUnmount() {
    Linking.removeEventListener('url', this.handleDeepLink);
}


handleDeepLink(deeplink) {
    Adjust.processDeeplink(new AdjustDeeplink(deeplink.url));
}

Enable LinkMe

메서드 서명
public enableLinkMe(): void

Adjust SDK를 사용하면 디바이스 페이스트보드에서 딥링크 정보를 복사할 수 있습니다. Adjust LinkMe 솔루션과 함께 사용 시 Adjust SDK는 iOS 15 이후 버전이 지원되는 기기에서 디퍼드 딥링킹을 활성화합니다.

사용자가 LinkMe URL을 클릭하면 링크 정보를 시스템 페이스트보드에 복사할 수 있는 옵션이 주어집니다. Adjust SDK는 딥링크 정보에 대한 시스템 페이스트보드를 읽고 딥링크 정보가 있는 경우 사용자를 의도한 페이지로 이동시킬 수 있습니다.

앱에서 페이스트보드 확인을 활성화하려면 config 객체에서 enableLinkMe 메서드를 호출합니다.

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);


adjustConfig.enableLinkMe();


Adjust.initSdk(adjustConfig);