# アプリ間トラッキングにおけるユニバーサルリンクのトラブルシューティング

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">PXAコースを受講する</a>

ユニバーサルリンクはオペレーティングシステム（OS）レベルで検証され、モバイルアプリを開くには、Webリンクのクリックなどユーザーが開始したアクションが必要です。

#### ユニバーサルリンクのトラブルシューティング

{% stepper %}
{% step %}

#### **パートナーのアプリからのクリックが、ユーザーによって発生したクリックであることを確認する**

リンクが通常のアンカータグではなく、代わりに新しい **WebView** （このページの下部にある補足説明を参照）。この場合、これはユーザーが開始したナビゲーションとは見なされないため、OS はユニバーサルリンクを開きません。これは最も一般的なシナリオです。これを解決するには、アプリを起動するユニバーサルリンクのために、WebView（WKWebView、UIWebView、または SFSafariViewController）内の通常のアンカーリンクの使用を検討してください。

ユーザーによる発生ではないクリックの他の例としては、URL を検索バーに直接コピー＆ペーストする、または JavaScript でリンクへ移動する際に `onload()` または `click()`.
{% endstep %}

{% step %}

#### **ユーザーを送信しているページがユニバーサルリンクを許可しているかどうかを確認する**

場合によっては、impact.com は、次のリダイレクト、通常は広告主ドメイン上でユニバーサルリンクが設定されていることに依存します。

* たとえば、impact.com のトラッキングドメイン（`goto.advertiser.com`）は `advertiser.com`へリダイレクトします。ユニバーサルリンクは `advertiser.com` ドメインに設定されています。したがって、ユーザーを送信しているページでユニバーサルリンクが有効になっていることを確認することが重要です。これは、広告主ドメインにある Apple の関連付けファイルを確認することで行えます。
* この例では、 `http://advertiser.com/.well-known/apple-app-site-association`、impact.com のトラッキングドメインの関連付けファイルには、デフォルトですべてのサブディレクトリが含まれることがわかります。

{% hint style="info" %}
**注:** JavaScript リダイレクトを使用している場合はユニバーサルリンクは機能しませんが、HTTP 3xx リダイレクトは元のユーザーイベントへの参照を保持します。impact.com はトラッキングに HTTP 3xx リダイレクトを使用しているため、トラッキングドメインのクリックに続くリンクは、他の条件が満たされていれば広告主アプリを正常に起動します。
{% endhint %}

たとえば、以下の関連付けファイルでは、 `advertiser.com/item/123` のユニバーサルリンクは許可されますが、 `advertiser.com` または `advertiser.com/section/furniture`.

```programlisting
{
   は許可されません。
      "apps":[
      ],
      "details":[
         {
            "appID":"A1AAA22BBB.com.advertiser.Advertiser",
            "paths":[
               "NOT /section/*",
               "/item/*"
            ]
         }
      ]
   }
} 
```

{% endstep %}

{% step %}

#### **最初に開く WebView も、ユニバーサルリンク経由のリダイレクトをサポートしていることを確認する**

一部の WebView ではユニバーサルリンクがブロックされることがあり、その場合、トラッキングリンクは広告主アプリを開くのではなく WebView 内で開かれます。一般的ではありませんが、WebView のナビゲーションポリシーが WKNavigationActionPolicyAllow + 2 に設定されている場合に発生することがあります。これにより、WebView はユニバーサルリンクを試行せずにリンクへ移動してしまうことがあります。
{% endstep %}

{% step %}

#### **ソーシャルメディアのポリシーを確認する**

Facebook など一部のソーシャルメディアアプリはユニバーサルリンクをブロックします。この場合、 **モバイルアプリのインタースティシャル** を使用すると役立つ可能性があり、これについては CSM に支援を依頼することをお勧めします（または [サポートに問い合わせる](https://app.impact.com/support/portal.ihtml?createTicket=true)）。impact.com は、ソーシャルメディアアプリからのディープリンクとアトリビューションを改善する方法の開発に積極的に取り組んでいます。
{% endstep %}
{% endstepper %}

#### Apple からのさらなる説明

ユニバーサルリンクを処理するために [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) , [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview) 、または [UIWebView](https://developer.apple.com/documentation/uikit/uiwebview) オブジェクトを生成すると、iOS はアプリを開く代わりに Safari で Web サイトを開きます。ただし、ユーザーが埋め込みの SFSafariViewController、WKWebView、または UIWebView オブジェクト内からユニバーサルリンクをタップした場合、iOS はアプリを開きます。

Apple の [ユニバーサルリンクをサポートする](https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html) ヘルプ記事を参照して、詳細を確認してください。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/platform-features/tracking/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
