딥링크 구현하기

문서

언리얼 엔진 SDK 연동 가이드

다음 대상 가이드 개발자 변경 로그
전제 조건
호환성 언리얼 엔진 4.23 이상
연동 가이드
  1. 기본 연동
  2. 이벤트 및 구매 추적
  3. 딥링크 구현하기
  4. SKAdNetwork 지원 추가
  5. 고급 옵션

소개

딥링크는 앱 내부의 특정 콘텐츠로 연결되는 링크입니다. 사용자가 앱이 설치된 기기에서 딥링크를 클릭하면 앱이 열리고 특정 제품이나 경험이 표시됩니다.

Singular 추적 링크에는 딥링킹뿐만 아니라 디퍼드 딥링킹도 포함될 수 있습니다(자세한 내용은 딥링킹 FAQSingular 링크 FAQ 참조).

아래 지침은 방법을 보여줍니다:

  1. 앱을 열도록 유도한 추적 링크에 액세스합니다,
  2. 딥링크 대상을 읽고
  3. 적절한 콘텐츠를 표시합니다.

참고:

  • 이 문서에서는 2019년에 출시된 Singular의 새로운 트래킹 링크 기술인 Singular 링크를 사용하고 있다고 가정합니다. Singular의 이전 고객은 Singular의 이전 트래킹 링크(레거시 링크)를 사용하고 있을 수 있습니다. 레거시 링크를 사용한 딥링크를 지원하려면 레거시 링크를 사용한 딥링크 처리하기를 참조하세요.
  • 앱의 딥링크 대상은 Singular의 페이지에서 설정해야 합니다( 딥링크 URL 구성하기 참조).

딥링킹 전제 조건

iOS 및 Android 설정

딥링킹을 사용하려면 Singular 링크 전제 조건의 지침을 따르세요.


딥 링크 처리하기

Singular SDK는 앱이 열리게 된 추적 링크의 세부 정보를 읽을 수 있는 핸들러 메커니즘을 제공합니다.

핸들러를 사용하려면 다음과 같이 하세요:

  1. OnSingularLinkResolved 인터페이스를 구현합니다.
  2. Singular SDK를 초기화하기 전에 OnSingularLinkResolved 델리게이트에 등록하여 클래스를 딥링크의 핸들러로 등록합니다.
  3. Singular SDK를 초기화하면 추적 링크를 가져와서 OnSingularLinkResolved 메서드를 호출하여 추적 링크 세부 정보를 전달합니다. 링크 세부 정보를 읽고 처리하려면 이 메서드를 재정의하세요.

다음 샘플 코드는 세 단계를 보여줍니다:


  // Add to the include section of your app

  #include "SingularLinkParams.h"
  #include "SingularDelegates.h"
  
  // Add this method to your class

  void YourClass::SingularLinksResolved(const FSingularLinkParams& linkParams) { 
const FString deeplink = linkParams.SingularLinksParams["deeplink"];
  const FString passthrough = linkParams.SingularLinksParams["passthrough"];
  const bool isDeferred = linkParams.SingularLinksParams["isDeferred"];
  }
  
  ...
  // Call this code before calling initialize

  USingularDelegates* singularDelegates =
  CreateDefaultSubobject<USingularDelegates>(TEXT("SingularLinksHandler"));
  singularDelegates->OnSingularLinksResolved.AddDynamic(this, &YourClass::SingularLinksResolved);
  ...
  

Singular링크 해결 메서드 세부 정보
설명 Singular 링크에 대한 콜백 메서드입니다 . 추적 링크 세부 정보를 읽고 처리합니다.
서명
public void OnSingularLinksResolved(const FSingularLinkParams& linkParams)

참고: FSingularLinkParams 객체에는 다음 값이 포함됩니다:

  • Deeplink - Singular 플랫폼의 링크 관리 페이지에서 구성한 딥링크 대상.
  • Passthrough - 링크에 추가된 패스스루 매개변수(있는 경우).
  • IsDeferred - 링크가 디퍼드 딥링크로 구성되어 있는지 여부.