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

ユニバーサルリンクはオペレーティングシステム（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` で、次のURLでは有効になりません。 `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) Universal Linkを処理するオブジェクトがない場合、iOSはアプリを開かずにSafariでWebサイトを開きます。ただし、ユーザーが埋め込みの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.
