ディープリンクの設定

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

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

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

スキーム名を設定する

ユーザーがアプリをインストールしている場合、ユーザーがディープリンク情報を含むリンクをクリックするとアプリが起動します。Adjust SDKには、ディープリンク情報を解析してアプリ全体で利用するためのツールが備わっています。ディープリンクを設定するには、一意の スキーム名 を選択する必要があります。

ユーザーがディープリンクをクリックしたときに、特定のアクティビティを起動できます。これを行うには、以下の手順に従ってください。

AndroidManifest.xmlファイルでアクティビティに スキーム名 を割り当てます。
アクティビティ定義欄にintent-filterノードを追加します。
intent-filterノード内に、 スキーマ名 を含むandroid:schemeデータノードを追加します。

例

この例は、MainActivityというアクティビティを スキーム名 adjustExampleで開くように設定する方法を示します。

<activity    android:name=".MainActivity"    android:configChanges="orientation|keyboardHidden"    android:label="@string/app_name"    android:screenOrientation="portrait">

   <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>

   <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="adjustExample" />
   </intent-filter>

   <intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="http" android:host="insights.go.link" />
    <data android:scheme="https" android:host="insights.go.link" />
   </intent-filter>

</activity>

これでアプリでURIスキームを処理できるようになります。ユーザーが スキーム名 を含むdeep_linkパラメーターを持つリンクをクリックすると、アクティビティが起動します。

https://app.adjust.com/abc123?deep_link=adjustExample%3A%2F%2F

Android アプリリンクを設定する

Android アプリリンクを使用してディープリンクを設定する場合でも、スキーム名の設定を必ず行ってください。

Android アプリリンクには、 AndroidManifest.xmlファイルにintentフィルターを追加して、アプリが処理できるURLを指定します。intentフィルターに、 data要素をandroid:autoVerify="true"アトリビュートとともに含めます。

これで、アプリでAndroid アプリリンクを処理できるようになります。insights.go.linkドメインを含むリンクをユーザーがクリックすると、アプリが自動的に開きます。

1
https://insights.go.link/login?adj_t=abc123

ディープリンク情報にアクセスする

deep_linkパラメーターコンテンツの配信場所を指定できます。これを行うには、AndroidManifest.xmlファイルでアクティビティにandroid:launchModeプロパティを設定してください。

Adjust SDKは、onCreateまたはonNewIntentメソッドを使ってアクティビティ内のintentオブジェクトにディープリンク情報を送信します。アプリが起動し、これらのメソッドのいずれかが起動すれば、ディープリンクコンテンツにアクセスできます。その後、アプリの他の部分でこの情報をアクセスできます。

onCreateまたはonNewIntentメソッド内でgetData()メソッドを呼び出すことで、ディープリンク情報を抽出できます。

Kotlin
Java

1
override fun onCreate(savedInstanceState: Bundle?) {
2
   super.onCreate(savedInstanceState)
3
   setContentView(R.layout.activity_main)
4

5
   val intent = intent
6
   val data = intent.data
7
   // data.toString() -> This is your deep_link parameter value.
8
}

1
@Override
2
protected void onCreate(Bundle savedInstanceState) {
3
   super.onCreate(savedInstanceState);
4
   setContentView(R.layout.activity_main);
5

6
   Intent intent = getIntent();
7
   Uri data = intent.getData();
8
   // data.toString() -> This is your deep_link parameter value.
9
}

Kotlin
Java

1
override fun onNewIntent(intent: Intent?) {
2
   super.onNewIntent(intent)
3
   val data = intent?.data
4
   // data.toString() -> This is your deep_link parameter value.
5
}

1
@Override
2
protected void onNewIntent(Intent intent) {
3
   super.onNewIntent(intent);
4

5
   Uri data = intent.getData();
6
   // data.toString() -> This is your deep_link parameter value.
7
}

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

Adjust SDKは、デフォルトでディファードディープリンクを開きます。追加の設定は必要ありません。この動作を無効化するには、setOnDeeplinkResponseListenerメソッドを使用して、ディファードディープリンクコールバックを設定する必要があります。

ディファードディープリンクのコールバックを設定する

public void setOnDeeplinkResponseListener(OnDeeplinkResponseListener onDeeplinkResponseListener)

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

ディープリンクを開く場合は、デリゲート関数でtrueを返してください。ファイルを開かない場合は、 falseを返します。

1
val config = AdjustConfig(this, appToken, environment)
2
//...
3
config.setOnDeeplinkResponseListener { deeplink ->
4
   Log.d("example", "Deferred deep link callback called!")
5
   Log.d("example", "Deep link URL: $deeplink")
6
   true
7
}
8
//...
9
Adjust.onCreate(config)

1
AdjustConfig config = new AdjustConfig(this, appToken, environment);
2
//...
3
// Evaluate the deeplink to be launched.
4
config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() {
5
   @Override
6
   public boolean launchReceivedDeeplink(Uri deeplink) {
7
      Log.d("example", "Deferred deep link callback called!");
8
      Log.d("example", "Deep link URL: " + deeplink);
9

10
      return true;
11
   }
12
});
13
//...
14
Adjust.onCreate(config);

1
function deferredDeeplinkCallback(deeplink) {
2
   console.log("Deferred deep link callback called!");
3
   console.log(`Deep link URL: ${deeplink}`);
4
}
5
//...
6
let adjustConfig = new AdjustConfig(yourAppToken, environment);
7
adjustConfig.setOpenDeferredDeeplink(true);
8
adjustConfig.setDeferredDeeplinkCallback(deferredDeeplinkCallback);
9
//...
10
Adjust.start(adjustConfig);

例

この例では、コールバック関数で false値を返すことで、SDKがアクティビティを起動しないようにする方法を示しています。

Kotlin
Java

1
config.setOnDeeplinkResponseListener { deeplink ->
2
   false
3
}

1
config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() {
2
   @Override
3
   public boolean launchReceivedDeeplink(Uri deeplink) {
4
      return false;
5
   }
6
});

ディープリンクによるリアトリビューション

public static void appWillOpenUrl(Uri url, Context context)

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

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

1
override fun onCreate(savedInstanceState: Bundle?) {
2
   super.onCreate(savedInstanceState)
3
   setContentView(R.layout.activity_main)
4

5
   val intent = intent
6
   val data = intent.data
7
   Adjust.appWillOpenUrl(data, getApplicationContext())
8
}

1
@Override
2
protected void onCreate(Bundle savedInstanceState) {
3
    super.onCreate(savedInstanceState);
4
    setContentView(R.layout.activity_main);
5

6
    Intent intent = getIntent();
7
    Uri data = intent.getData();
8
    Adjust.appWillOpenUrl(data, getApplicationContext());
9
}

1
Adjust.appWillOpenUrl(deeplinkUrl);

リンクのresolution（解析と変換）

public static void resolveLink(final String url,
                               final String[] resolveUrlSuffixArray,
                               final AdjustLinkResolutionCallback adjustLinkResolutionCallback)

一部のEメールサービスプロバイダー（ESP）は、マーケティングキャンペーンに独自のカスタムドメインを使用しています。カスタムドメインでクリックを計測する場合は、SDKを設定してリンクを解析する必要があります。これを行うには、 AdjustLinkResolutionクラスのresolveLinkメソッドを呼び出します。Adjust SDKはカスタムリンクをたどって、ディープリンクを開いた時にそれを解析します。これにより、Eメール計測キャンペーンとのやり取りを記録することが可能です。

resolveLinkWithUrlメソッドは以下の引数を受け取ります：

url （String）：アプリを起動したディープリンク
resolveUrlSuffixArray （String[]）：解析する必要がある設定済みキャンペーンのカスタムドメイン。
adjustLinkResolutionCallback （AdjustLinkResolutionCallback）：最終URLを返すコールバック

このメソッドは、resolveUrlSuffixArray内のドメインに対してディープリンクを確認します。一致するものが見つからない場合、ディープリンクURLをそのまま転送します。一致するものが見つかった場合、リンクの解析を試み、結果のディープリンクを返します。その後、これをコールバックパラメーターに保管します。

その後、返されたディープリンクを使用してユーザーをリアトリビュートできます。これを行うには、ディープリンクをAdjust.appWillOpenUrlメソッドにパスします。

Kotlin
Java

1
AdjustLinkResolution.resolveLink(url, arrayOf("example.com"), object : AdjustLinkResolution.AdjustLinkResolutionCallback {
2
   override fun resolvedLinkCallback(resolvedLink: Uri) {
3
         Adjust.appWillOpenUrl(resolvedLink, applicationContext)
4
   }
5
})

1
AdjustLinkResolution.resolveLink(url, new String[]{"example.com"}, new AdjustLinkResolution.AdjustLinkResolutionCallback() {
2
   @Override
3
   public void resolvedLinkCallback(Uri resolvedLink) {
4
      Adjust.appWillOpenUrl(resolvedLink, getApplicationContext());
5
   }
6
});