> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md).

# アプリ間トラッキングでユニバーサルリンクの問題をトラブルシュート

<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>

Universal Links はオペレーティングシステム（OS）レベルで検証され、モバイルアプリを開くには、Webリンクをクリックするなどユーザーが起点となる操作が必要です。

#### Universal Links のトラブルシューティング

{% stepper %}
{% step %}

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

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

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

{% step %}

#### **ユーザーを送信するページが Universal Links を許可しているか確認してください**

場合によっては、impact.com は Universal Links が後続のリダイレクト、通常は広告主ドメインで設定されていることに依存します。

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

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

たとえば、以下の関連付けファイルでは `advertiser.com/item/123` に対しては Universal Links を許可しますが、 `advertiser.com` または `advertiser.com/section/furniture`.

```programlisting
{
   "applinks":{
      "apps":[
      ],
      "details":[
         {
            "appID":"A1AAA22BBB.com.advertiser.Advertiser",
            "paths":[
               "NOT /section/*",
               "/item/*"
            ]
         }
      ]
   }
} 
```

{% endstep %}

{% step %}

#### **最初に開く WebView も Universal Links によるリダイレクトをサポートしていることを確認してください**

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

{% step %}

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

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

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

Universal Link を処理するために [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 でウェブサイトを開きます。ただし、ユーザーが埋め込みの SFSafariViewController、WKWebView、または UIWebView オブジェクト内から Universal Link をタップした場合、iOS はアプリを開きます。

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
