> 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/advocate-program/best-practices-for-referral-programs/troubleshoot-your-advocate-referrals.md).

# Advocateの紹介をトラブルシューティングする

Advocate には、紹介の不一致、エラー、またはプログラム内の個々の紹介に関する問題を調査・トラブルシューティングするためのいくつかのツールがあります。これは、紹介ステータス、適格性、報酬に関する参加者からの質問を管理する際に特に役立ちます。

紹介を効果的に調査するには、次の手順に従ってください:

{% stepper %}
{% step %}

## **プログラムルールを確認する**

特定の紹介に入る前に、まず次を確認してください: [プログラムルール](/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) を理解するために:

* 何がコンバージョンとしてカウントされるか（例： *成約*, *購入イベント*, *デモ完了*)
* どのイベントでメール送信と報酬配布がトリガーされるか
* 90日間の適格期間などの遅延や条件
* 報酬上限（例：アドボケートごとの報酬最大数）

次の場所に移動してルールを確認できます: ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → プログラムルール** を Advocate プログラム内で。
{% endstep %}

{% step %}

## **参加者情報を収集する**

調査を開始するには、参加者の以下の識別子の少なくとも1つを収集してください:

* メールアドレス
* Advocate アカウントまたはユーザー ID

この情報を使って次を検索します: [参加者フィード](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/filter-and-manage-advocate-participants.md).
{% endstep %}

{% step %}

## **紹介の関連付けを確認する**

で、 *参加者フィード*:

1. アドボケートのプロフィールを見つけます。
2. までスクロールします *紹介* セクション。
3. 次を確認してください:
   * 紹介先ユーザーが表示されている
   * 紹介ステータスが **開始済み**

紹介が見つからない場合、共有リンクが正しく使用されていないか、アトリビューションに失敗した可能性があります。
{% endstep %}

{% step %}

## **プログラムルールの条件を確認する**

紹介先ユーザーの参加者レコードを開き、次を確認します:

1. 下にスクロールして *イベント* セクション。
2. ドロップダウンメニューを使って次に切り替えます: **すべてのイベント**.
3. 次に一致するイベントを探します: [プログラムのコンバージョン条件](/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) （例：成約、アポイント設定、デモ完了）。

次の条件を満たしていることを確認してください:

* Advocate に受信されている（UTT、API、または連携経由）
* 必要な期間内に発生している
* すべての適格条件に一致している（例：正しい製品または商談ステージ）
  {% endstep %}

{% step %}

## **報酬の付与を確認する**

再び次に *参加者フィード*、次を確認します [*報酬*](/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) アドボケートと紹介先ユーザーの両方についてのセクション。

次を確認してください:

* 報酬が付与された
* 報酬の種類と金額がプログラムルールに一致している

もし [Tango ギフトカード](/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/gift-card-rewards-explained.md)を使用している場合、参加者が Tango からのメールを受け取っていることを確認してください。配信を確認するには、Tango アカウントにログインするか、Tango サポートに連絡してください。

報酬が付与されているのに参加者が見えていないと報告する場合、報酬自体は正しい可能性が高く、問題は残高の表示方法にあります。次の順に確認してください:

1. **統計コンポーネントがプログラムに接続されている。** ウィジェットエディタでコンポーネントを選択し、 *追加設定*を展開して、Advocate プログラムが *プログラム ID* ドロップダウンメニューで選択されていることを確認します。ユーザー統計、共有リンク、共有ボタン、紹介履歴テーブルなど、プログラム固有のデータを取得するコンポーネントは、これが設定されるまで何も表示されません。
2. **正しいウィジェットタイプを使用している。** グローバルウィジェットは複数の Advocate プログラムを参照するため、1つのプログラムに紐付けることはできません。プログラムが1つだけの場合は、代わりに Verified Access または In-App ウィジェットを使用してください。
3. **報酬ステータスフィルターが想定どおりである。** 次に設定されたコンポーネントは *利用可能* 、まだ次の状態にある報酬は表示しません *保留中* 精算期間。参照: [ウィジェットとマイクロサイトの統計の説明](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-statistics-explained.md).

{% hint style="info" %}
**注:** 支払い残高の統計は、参加者の生涯獲得額ではなく、現在支払い可能な金額を表示します。支払いが参加者の impact.com パートナーアカウントに送金されると、その金額は支払いキューから外れ、統計は正しくゼロに戻ります。
{% endhint %}
{% endstep %}

{% step %}

## **紹介メールを確認する（該当する場合）**

ユーザーが予期しない、または不明瞭なメールを受信したと報告した場合は、メッセージが明確であることを確認するためにプログラムメールを確認してください:

1. 次へ移動: ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[エンゲージ]** → **プログラムルール → メール**.
2. 各紹介段階でどのメールがトリガーされるか確認します。
3. 選択 **編集** メール内容をプレビューするために（変更を保存する必要はありません）。

よくある誤解:

* 「あなたの紹介は承認されました」は、紹介がコンバージョンしたという意味ではなく、見込み客が適格になったことを意味することがよくあります
* アドボケートは、紹介ステータスメールとコンバージョン通知を混同することがあります

件名を更新するか、次を追加して、わかりやすさを向上させることを検討してください: [マージタグ](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/merge-tags-for-program-emails.md) （例：紹介名）を追加してパーソナライズします。次をカスタマイズしてください: [アドボケートプログラムのメール](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/create-and-customize-advocate-program-emails.md).
{% endstep %}

{% step %}

## **サポートにお問い合わせください**

次の場合はサポートに連絡してください:

* 期待されるコンバージョンイベントが見つからない
* メールが誤って送信された
* 条件を満たしているのに報酬がトリガーされなかった

サポートに連絡するには:

1. 次の方法でお問い合わせください: [チケットを送信する](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml?) またはメールを送る [サポート](mailto:saasquatch-support@impact.com).
2. 次の情報を提供してください:
   * アドボケートまたは紹介先ユーザーのメールアドレス
   * 紹介のおおよその日付
   * 問題の詳細な説明
     {% endstep %}
     {% endstepper %}


---

# 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/advocate-program/best-practices-for-referral-programs/troubleshoot-your-advocate-referrals.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.