adjust-icon

ディープリンク

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

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

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

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

Adjust SDKでディープリンクを使用するには、まずアプリ内でディープリンク情報を開き、読み取りができるようにする必要があります。

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

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

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

SDKはデフォルトでディファードディープリンクを開きます。disableDeferredDeeplinkOpeningメソッドを呼び出すことで、これを構成できます。

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


adjustConfig.disableDeferredDeeplinkOpening();


Adjust.initSdk(adjustConfig);
メソッドシグネチャー
setDeferredDeeplinkCallback(deferredDeeplinkCallback: (deeplink: string) => void): void

Adjust SDKがディファードディープリンクを受け取った際に、デリゲート関数を呼び出すように設定することができます。このデリゲート関数は、ディープリンクをstring引数で受け取ります。

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


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


Adjust.initSdk(adjustConfig);

例

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

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setDeferredDeeplinkCallback(function(deeplink) {
    console.log("Deferred deep link URL: " + deeplink);
)};


Adjust.initSdk(adjustConfig);
メソッドシグネチャー
processDeeplink(adjustDeeplink: AdjustDeeplink): void

Adjustはディープリンクを使ったリエンゲージメントキャンペーンをサポートしています。詳細は、Campaign Labでディープリンクを設定する方法をご覧ください。

ユーザーをリアトリビュートするには、アプリがディープリンクコンテンツを受け取る時にprocessDeeplinkメソッドを呼び出す必要があります。Adjust SDKは次に、ディープリンク内の新しいアトリビューションデータを検索します。SDKが新しい情報を見つけた場合、その情報をAdjustのサーバーに転送し、リアトリビューションを行います。

function handleOpenURL(url) {
   setTimeout(function () {
      // Check content of the url object and get information about the URL.
      Adjust.appWillOpenUrl(new AdjustDeeplink(url));
   }, 300);
}

ユニバーサルリンクを開くには、didLaunchAppFromLinkメソッド内でAdjust.processDeeplink関数を呼び出します。

var app = {
   initialize: function () {
      this.bindEvents();
   },


   bindEvents: function () {
      document.addEventListener("deviceready", this.onDeviceReady, false);
   },


   onDeviceReady: function () {
      if (device.platform == "iOS") {
         universalLinks.subscribe(
            "adjustDeepLinking",
            app.didLaunchAppFromLink,
         );
      }
   },


   didLaunchAppFromLink: function (eventData) {
      // Check content of the url object and get information about the URL.
      Adjust.appWillOpenUrl(new AdjustDeeplink(eventData.url));
   },
};

LinkMeを有効化する

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