> 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 を開きません。これは最も一般的なシナリオです。これを解決するには、アプリを起動する Universal Link として、WebView（WKWebView、UIWebView、または SFSafariViewController）内の通常のアンカーリンクを使用することを検討してください。

ユーザー起点ではないクリックの他の例としては、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 からのさらなる説明

をインスタンス化して [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) , [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview) 、または [UIWebView](https://developer.apple.com/documentation/uikit/uiwebview) Universal Link を処理するオブジェクトをインスタンス化した場合、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 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=<question>&goal=<endgoal>
```

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