# URIスキームでディープリンクロジックを構成する

カスタムのインアプリブラウザを持つ一部のモバイルアプリはすべてのディープリンク技術に対応していないため、標準のディープリンクが失敗した場合の一貫したトラッキングを確保するために [URIスキーム](https://en.wikipedia.org/wiki/List_of_URI_schemes) を使用する必要があります。ユーザーがこれらのカスタムインアプリブラウザ経由であなたの販売ランディングページにアクセスしたときのコンバージョントラッキングの精度を向上させるために、本記事の手順に従ってください。

#### 期待される結果のフローチャート

以下のフローチャートは、目指している結果を表しています。簡単に言うと、impact.com上でリダイレクトルールを設定し、トラッキングリンクをクリックしたユーザーを可能な場合は該当のモバイルアプリページにルーティングしたいということです。ユーザーの端末にアプリがインストールされていないなどの理由で不可能な場合は、そのページのウェブ版に誘導する必要があります。impact.com上でインタースティシャルのランディングページを設定することも可能で、これによりユーザーがあなたのアプリが認識する宛先ページにのみリダイレクトされることを保証できます。

<div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-fed65268965e8e1db8473062d52095b14b220e3d%2F260dbc4571ab3a646158dccf6f817e64888da69f1fe481f7a4d9c2f90fe73003.png?alt=media" alt="" width="296"><figcaption></figcaption></figure></div>

#### 前提条件

* あなたのモバイルアプリのURIスキーム、例： **`acmeapp://`**`item/view/12345`は、Android版とiOS版のアプリで同じである必要があります。
* リダイレクトを機能させるには、ウェブのURLパスをモバイルアプリのURIスキームにマップしておく必要があります。例えば、ACME社のURLが `https://acme.com/item/view/12345`であれば、そのURIは `acmeapp://item/view/12345`.
* となります。リダイレクトルールの条件内でインタースティシャルページに対応するフィルタを実装できるよう、マップされていないパス（サポートされていないパス）を把握しておく必要があります。詳細は以下を参照してください。

#### URIスキームのトラッキングを設定する

{% stepper %}
{% step %}

#### **ステップ1：アプリでのURIスキームトラッキングを設定する**

リファラーがURIスキームである場合をトラックするようにモバイルアプリを設定してください。

1. URIスキームから `clickid` およびその他の関連するゲートウェイトラッキングパラメータを解析します。
2. アプリ起動イベントでPageUrlフィールドにURIを渡して、PageLoad APIを呼び出します。

   * 詳細については [Page Loadの作成](https://integrations.impact.com/impact-brand/reference/create-a-pageload) APIリファレンスを参照してください。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>例：</strong> <code>acmeapp://item/view/12345?clickid=abcdef12345</code>.</p></div>

{% endstep %}

{% step %}

#### **ステップ2：プログラムのURIスキームを設定する**

1. 上部ナビゲーションバーから、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[ユーザープロファイル] → 設定**.&#x20;
2. 右側の列で、 *トラッキング*の下にある **一般**.
3. のURIスキーム欄で、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a600f51d86cbf3c02c36ea5cf311867b2bb4cf89%2F00a06da7505c774dc36762a66bcd169b1d62cb35af729e3383729755194758fb.svg?alt=media) **\[編集]**.
4. を選択します。あなたのモバイルアプリの **URIスキーム**を入力してください（末尾の `://` は含めないでください）。
   * 複数のURIスキームがリストされている場合、impact.comは最初のスキームをデフォルトとして使用します。
5. 選択 **保存**.
   {% endstep %}

{% step %}

#### **ステップ3：リダイレクトルールを作成する**

1. 上部ナビゲーションバーから、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[ユーザープロファイル] → 設定**.&#x20;
2. 右側の列で、 *技術*の下にある **ブロック＆リダイレクト**.
3. 右上隅で、 **ルールを設定**.
4. **を選択します。** ルールにわかりやすい名前を付けてください。
   * 名前はルールの目的を示すべきです。
5. 追加 *条件* を **アプリ名** パラメータで設定し、ルールが適用されるモバイルアプリプラットフォームを入力します。
   * impact.comは次を含めることを推奨します： *Facebook*, *Instagram*、および *X*.
6. オプションで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[別の追加]** を選択し、 **ランディングページ** パラメータで、リダイレクトしたいパスとドメインを指定します。

   * この手順を推奨します。これにより、アプリが認識できるパスのみに機能を適用できます。
   * 特定のパスを含むランディングページにマッチさせるには [正規表現](https://en.wikipedia.org/wiki/Regular_expression) を使用してください — 以下の例を参照。

   ```programlisting
   ^(https?:\/\/)?(www\.)?(domain\.com|sub\.domain\.com)(\/(shop|product)(\/[^?]*?)?)?(\/?(\?.*)?)?$
   ```
7. オプションで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[別の追加]** を選択し、 **確率** パラメータを使用して、A/Bテストのためにリルートするトラフィックの割合を指定します。

   <div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-05f2884f968b97207049961a1cd2ce056a3bc4b1%2F1744c6326d9b8b16c9d5495cb7869eaf1a4cd0a19b02dbcf3b851af38154ee8b.png?alt=media" alt="" width="536"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

#### **ステップ4：モバイルディープリンク用インタースティシャルをカスタマイズする**

1. アクション *欄で、* ドロップダウンメニュー ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **を使用して** モバイルディープリンク **を選択します。**.
2. インタースティシャルのテンプレートをブランドに合わせてカスタマイズしてください：

| 項目                 | 説明                                                                                                                                        |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| ヘッダーテキストとフォントカラー   | ヘッダーテキストはインタースティシャルに大きな文字で表示される短いフレーズです。このテキストの内容を指定でき、カラーピッカーや [16進数](https://en.wikipedia.org/wiki/Hexadecimal) 表記でフォントカラーを定義できます。      |
| サブヘッダーテキストとフォントカラー | サブヘッダーテキストはヘッダーテキストの下に表示される短いフレーズです。このテキストの内容を指定でき、カラーピッカーや [16進数](https://en.wikipedia.org/wiki/Hexadecimal) 表記でフォントカラーを定義できます。          |
| ロゴのアップロード          | ブランドロゴを .gif、.jpg、.png、または .svg 形式でアップロードしてください。画像サイズは1MBを超えてはいけません。                                                                      |
| カバー画像のアップロード       | 適切な背景画像を .gif、.jpg、.png、または .svg 形式でアップロードしてください。画像サイズは1MBを超えてはいけません。                                                                     |
| アプリを開くボタンのラベルと色    | ボタンラベルはURIスキームであなたのモバイルアプリを開くボタンに表示されるテキストです。このテキストの内容を指定でき、カラーピッカーや [16進数](https://en.wikipedia.org/wiki/Hexadecimal) 表記でフォントカラーを定義できます。 |
| 続行リンクのラベルとフォントカラー  | リンクラベルは宛先のウェブページURLを開くリンクに表示されるテキストです。このテキストの内容を指定でき、カラーピッカーや [16進数](https://en.wikipedia.org/wiki/Hexadecimal) 表記でフォントカラーを定義できます。        |

<div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-05ea3ea50f8f93b549691e27fe0bc882cd02a9c9%2Fbdbeb71e1227b728b8a97a7b0fa9083cd676a5ab73dd505b312ee1a60c80f751.png?alt=media" alt="" width="373"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **ステップ5：アプリ起動ロジックと自動リダイレクトを設定する**

1. アクション *欄で、* 欄で、ビジュアルカスタマイズオプションの最後までスクロールし、次のフィールドに入力してください。

   | フィールド       | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | アプリ起動       | <p>モバイルアプリをいつ開くかを示します：</p><p>• <strong>インタースティシャルが読み込まれたらすぐに</strong> <mark style="color:$success;">［推奨］</mark> — インタースティシャルが読み込まれたら直ちにユーザーの端末でモバイルアプリを自動的に開きます。</p><p>• <strong>ボタンがタップされたとき</strong> — インタースティシャルが読み込まれた後、ユーザーの端末でアプリを開くことをユーザーの承認に依存します。</p>                                                                                                                                                                                                                                                     |
   | 自動リダイレクト    | タイムアウトを定義するには、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **［チェックなしのボックス］** を選択します。アプリの起動が失敗した場合、指定したタイムアウト後に自動的にウェブリンクへリダイレクトされます。impact.comは **10**秒のタイムアウトを推奨します。                                                                                                                           |
   | デフォルトURIパス  | URLから抽出されない場合に使用される、サイトのホームページなどのURIパスを入力してください。これにより、カスタムインアプリブラウザがアプリの起動に失敗する場合でもアプリが正常に開くことが保証されます。例えば、宛先ページのURLが `https://acme.com`で、デフォルトのURIパスに `home`と入力すると、生成されるURIスキームリンクは `acmeapp://home`.                                                                                                                                                                                                                                                                                                               |
   | カスタムURI正規表現 | <p>デフォルトでは、impact.comは宛先ランディングページURLのパスをURIスキームに追加してURIスキームリンクを作成します。例えば、宛先ページのURLが <code><https://acme.com/product/12345></code>で、あなたのURIスキームが <code>acmeapp</code>であれば、生成されるURIスキームは <code>acmeapp\://product/12345</code>.</p><p>となります。ただし、 <a href="https://en.wikipedia.org/wiki/Regular_expression">正規表現</a> を使用して、宛先ページURLのどの部分を抽出してURIスキームに追加するかを指定することもできます。例えば、宛先ページのURLが <code><https://acme.com/product/12345></code>の場合に、正規表現として <code>acme.com.\*$</code>であれば、生成されるURIスキームは <code>を入力すると、</code>.</p> |
2. acmeapp\://acme.com/product/12345 **保存** 入力が完了したら、ルールを
   {% endstep %}
   {% endstepper %}

#### 保存

してください。 [ポストバックを伴うインタースティシャルの使用](https://help.impact.com/brand/ja/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands) もしあなたがコンバージョンを様々なimpact.comプログラムタイプに渡ってトラッキングするために、ポストバックを使用する場合、impact.comはインタースティシャルを主要なプログラムのみに実装することを推奨します。主要プログラムは宛先ページの直前に行われる最後のリダイレクトを処理し、モバイルアプリを開く前にすべてのクリックがトラッキングされることを保証します。このアプローチにより、コンバージョンが子プログラムのいずれかにポストされた場合でも正確なアトリビューションが行われます。
