はじめに

ディープリンクは、アプリ内の特定のコンテンツにつながるリンクです。アプリがインストールされたデバイス上でユーザーがディープリンクをクリックすると、アプリが開き、特定の商品や体験が表示されます。

シンギュラートラッキングリンクは、ディープリンクだけでなく、ディファードディープリンクも含むことができます（詳しくはディープリンクFAQと シンギュラートラッキングリンクFAQをご覧ください）。

以下の手順で方法を説明します：

1. アプリを開くきっかけとなったトラッキングリンクにアクセスする、
2. ディープリンク先を読み取る
3. 適切なコンテンツを表示する。

ディープリンクの前提条件

iOSおよびAndroidのセットアップ

Singular Links Prerequisitesの指示に従って、ディープリンクを有効にします。

ディープリンクの処理

Singular SDKは、アプリを開くきっかけとなったトラッキングリンクの詳細を読み取るハンドラメカニズムを提供します。

ハンドラを使用するには

1. OnSingularLinkResolvedインターフェースを実装します。
2. Singular SDKを初期化する前にOnSingularLinkResolvedデリゲートに登録し、クラスをディープリンクのハンドラーとして登録します。
3. Singular SDKを初期化すると、トラッキングリンクを取得し、OnSingularLinkResolvedメソッドを呼び出し、トラッキングリンクの詳細を渡します。リンクの詳細を読み込んで処理するには、このメソッドをオーバーライドします。

以下のサンプルコードは3つのステップを示しています：

  // アプリの include セクションに追加します
  #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)