> 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/zh/what-would-you-like-to-learn-about/advocate-program/best-practices-for-referral-programs/troubleshoot-your-advocate-referrals.md).

# 排查你的 Advocate 推荐问题

Advocate 提供了多种工具，帮助你调查并排查项目中单个推荐的推荐差异、错误或问题。在管理参与者关于推荐状态、资格和奖励的疑问时，这尤其有用。

按照以下步骤有效调查推荐：

{% stepper %}
{% step %}

## **查看你的项目规则**

在深入查看某个具体推荐之前，先查看你的 [项目规则](/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) 以了解：

* 什么算作转化（例如， *已成交*, *购买事件*, *演示已完成*)
* 哪些事件会触发电子邮件和奖励发放
* 延迟或条件，例如 90 天资格窗口
* 奖励上限，例如每位 advocate 的最大奖励数量

你可以通过导航到以下位置找到你的规则： ![](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 %}

## **收集参与者信息**

开始调查时，请收集参与者的以下至少一种标识信息：

* 电子邮件地址
* Advocate 账户或用户 ID

使用此信息在以下位置搜索： [参与者动态](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/filter-and-manage-advocate-participants.md).
{% endstep %}

{% step %}

## **确认推荐关联**

在……中 *参与者动态*:

1. 找到 advocate 的个人资料。
2. 滚动到 *推荐* 部分。
3. 确认：
   * 被推荐用户已列出
   * 推荐状态为 **已开始**

如果没有找到推荐，可能是 sharelink 使用不正确，或者归因失败。
{% endstep %}

{% step %}

## **检查项目规则条件**

打开被推荐用户的参与者记录，并：

1. 向下滚动到 *事件* 部分。
2. 使用下拉菜单切换到 **所有事件**.
3. 查找与以下内容匹配的事件： [项目的转化标准](/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) （例如，已成交、已安排预约、演示已完成）。

确认该事件：

* 已在 Advocate 中收到（通过 UTT、API 或集成）
* 在所需时间窗口内发生
* 符合所有资格条件（例如，正确的产品或商机阶段）
  {% endstep %}

{% step %}

## **确认奖励发放**

返回到 *参与者动态*，查看 [*奖励*](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) 部分，针对 advocate 和被推荐用户。

验证：

* 已发放奖励
* 奖励类型和金额与项目规则一致

如果使用 [Tango 礼品卡](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/gift-card-rewards-explained.md)，请检查参与者是否收到来自 Tango 的电子邮件。要确认送达情况，请登录你的 Tango 账户或联系 Tango 支持。

如果奖励已发放，但参与者表示没有看到它，那么奖励大概率是正确的，问题出在余额如何展示给他们。请按以下顺序检查：

1. **stat 组件已连接到你的项目。** 在小组件编辑器中选择该组件，展开 *其他设置*，并确认你的 Advocate 项目已在 *项目 ID* 下拉菜单中选中。拉取项目特定数据的组件——用户统计、分享链接、分享按钮以及推荐历史表——在设置完成前都不会显示任何内容。
2. **你使用的是正确的小组件类型。** 全局小组件会调用多个 Advocate 项目，无法绑定到单个项目。如果你只运行一个项目，请改用 Verified Access 或 In-App 小组件。
3. **奖励状态筛选器与你的预期一致。** 设置为 *可用* 的组件不会显示仍处于 *待处理* 清算期中的奖励。请参阅 [小组件与微站统计说明](/brand/zh/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) **\[Engage]** → **项目规则 → 邮件**.
2. 查看每个推荐阶段会触发哪些电子邮件。
3. 选择 **编辑** 以预览邮件内容（无需保存更改）。

常见误解：

* “你的推荐已被接受”通常表示线索已符合资格，而不是推荐已转化
* advocate 有时会把推荐状态邮件和转化通知混淆

可通过更新主题行或添加以下内容来提高清晰度： [合并标签](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/merge-tags-for-program-emails.md) （例如，推荐名称）用于个性化。自定义你的 [advocate 项目邮件](/brand/zh/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. 请提供以下信息：
   * Advocate 或被推荐用户的电子邮件
   * 推荐的大致日期
   * 问题的详细描述
     {% 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/zh/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.