> 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).
# アプリ間トラッキングにおけるユニバーサルリンクのトラブルシューティング
PXAコースを受講する
ユニバーサルリンクはオペレーティングシステム（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
{
"applinks":{
"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 でウェブサイトを開きます。ただし、ユーザーが埋め込みの SFSafariViewController、WKWebView、または UIWebView オブジェクト内からユニバーサルリンクをタップした場合、iOS はアプリを開きます。
Appleの [ユニバーサルリンクのサポート](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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.