Unreal Engine SDK: 기본 연동

소개

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

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

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

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

참고:

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

딥링킹 전제 조건

iOS 및 Android 설정

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

딥 링크 처리하기

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

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

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

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


  // 앱의 포함 섹션에 추가
  #include "SingularLinkParams.h"
  #include "SingularDelegates.h"
  
  // 이 메소드를 클래스에 추가하세요
  void YourClass::SingularLinksResolved(const FSingularLinkParams& linkParams) { 
const FString deeplink = linkParams.SingularLinksParams["deeplink"]; const FString passthrough = linkParams.SingularLinksParams["passthrough"]; const bool isDeferred = linkParams.SingularLinksParams["isDeferred"]; } ... // 초기화를 호출하기 전에 이 코드를 호출하세요. USingularDelegates* singularDelegates = CreateDefaultSubobject<USingularDelegates>(TEXT("SingularLinksHandler")); singularDelegates->OnSingularLinksResolved.AddDynamic(this, &YourClass::SingularLinksResolved); ...
싱귤러링크 해결 메서드 세부 정보
설명 단일 링크에 대한 콜백 메서드입니다. 추적 링크 세부 정보를 읽고 처리합니다.
서명
public void OnSingularLinksResolved(const FSingularLinkParams& linkParams)

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

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