adjust-icon

ディープリンク

ディープリンクを作成して、ユーザーをアプリ内の特定の場所に誘導します。Adjust SDKは、ユーザーがデバイスにアプリをインストール済みかどうかによって、異なるロジックを使用します。

  • ダイレクトディープリンクは、ユーザーがアプリをすでにデバイスにインストールしている場合に使用されます。そのリンクは、リンクで指定されたページにユーザーをリダイレクトします。
  • ディファードディープリンクは、ユーザーがアプリをデバイスにインストールしていない場合に使用されます。そのリンクは、ユーザーをアプリストアに送り、アプリを先にインストールしてもらいます。ユーザーがアプリをインストールすると、リンクで指定されたページが開きます。

SDKは、ユーザーがリンクからアプリを起動した後にディープリンクの情報を読み取ることができます。

ディープリンクを設定する

ユーザーがアプリをインストールしている場合、ユーザーがディープリンクの情報を含むリンクをクリックするとアプリが起動します。Adjust SDKには、アプリ全体にディープリンクの情報を解析するツールが含まれます。

v4.30以降、SDKは、必要な設定をAndroidとiOSのプロジェクトに注入します。ディープリンクを設定するには、Unityエディター（Unity Editor）のInspectorウィンドウでURLスキームを追加してください。

React Nativeアプリでディープリンクを設定するには、以下の手順に従ってください。

  1. ディープリンクは、アプリレベルで設定します。使用するプラットフォームに合わせて、以下のリンク先のディープリンク設定手順に従ってください。

  2. React Nativeのドキュメントを参照し、指示に従って、両方のプラットフォームをサポートする方法を確認します。

  3. 取得したディープリンクURLをJavaScriptコードで使用します。

ディファードディープリンク

ディファードディープリンクを無効にする

メソッドシグネチャー
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);

例

この例では、ユーザーがディファードディープリンクを開いたときに、ディープリンクのアドレスをログに記録する方法を示しています。

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));
}

LinkMeを有効化する

メソッドシグネチャー
public enableLinkMe(): void

Adjust SDKでは、デバイスのペーストボードからディープリンクの情報をコピーすることが可能です。AdjustのLinkMeソリューションを組み合わせることで、iOS 15以降のデバイスでディファードディープリンクを有効化することができます。

ユーザーがLinkMeのURLをクリックすると、そのリンク情報をシステムのペーストボードにコピーするオプションがあります。Adjust SDKを使用してシステムのペーストボードを読み、ディープリンクの情報を確認することができます。ディープリンクがある場合、SDKはユーザーをアプリ内の正しいページに転送します。

アプリ内でペーストボードの確認を有効化するには、configオブジェクトのenableLinkMeメソッドを呼び出します：

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


adjustConfig.enableLinkMe();


Adjust.initSdk(adjustConfig);