> 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/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.md).

# 配置客户状态映射

impact.com 的 *客户状态映射* 功能可帮助您区分现有客户、从未在您这里购物过的客户、常客等。在查看项目的新客户获取率或常客人数时，这些信息对报告很有用。创建合作伙伴付款调整时，也可以使用这些信息，激励合作伙伴为特定客户状态类别带来转化。

{% hint style="warning" %}
**警告：** 启用 *客户状态映射* 设置会更改您的跟踪代码，并可能导致项目运行中断。请在以下整个过程中与您的客户成功经理（CSM）协作，以避免出现问题。
{% endhint %}

{% stepper %}
{% step %}

## 在您的网站上创建身份识别逻辑

默认情况下，impact.com 无法识别访问您网站的访客是新客户、现有客户还是常客等。impact.com 收到的唯一数据是购买完成后的转化数据。因此，您的团队必须创建基础逻辑，以动态识别访问您网店的客户，并为其添加相应的 `CustomerStatus`。随后，此状态标签将与转化数据一起作为  `customerStatus={-the dynamic value-}`  参数的值传递给 impact.com。

在您的系统中实现此逻辑后，您可以在 impact.com 上配置相应的客户状态映射值。
{% endstep %}

{% step %}

## 在 impact.com 上配置映射值

“ *客户状态映射* ”开关在事件类型级别启用，因此您可以为项目中选定的事件类型启用此设置。请注意，客户状态映射中的 *新* 和 *现有* （不区分大小写）在提交转化或修改付款时应默认生效，即使您未开启此设置。

1. 在顶部导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户个人资料] → 设置**.
2. 在右侧的 *跟踪*下，选择 **事件类型**.
3. 在要添加客户状态映射值的事件类型旁边，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[更多]** → **查看/编辑**.
4. 在底部，选择 **显示高级设置**.
5. 在 *客户状态映射*，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[编辑]**.
   * 找不到 *客户状态映射* 设置？请联系您的客户成功经理 (CSM)，或 [创建支持工单](https://app.impact.com/support/portal.ihtml) ，以便将其添加到您的 impact.com 账户。
6. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[开启切换开关] 添加值映射，以便为新客户设置不同的佣金**.
7. 在您想使用的客户状态旁边，输入与您的身份识别逻辑所用值相对应的值。
8. 选择 **保存**.
   {% endstep %}

{% step %}

## 确保将该参数传递给 impact.com

作为预防措施，您需要测试该参数是否随转化数据传递给 impact.com。您可以通过 3 份报告查看客户状态数据，以确保传递了 `customerStatus` 参数：

* 新客户与回头客报告

  该 [新客户与回头客报告](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) 将显示由以下客户创建的操作数据： *新客户*, *现有客户*，以及 *重新互动* 您所选日期范围内的客户。每种客户类型带来的操作、操作成本和收入，均按促成该操作的合作伙伴汇总。
* 按客户状态划分的每日绩效报告

  「 [按客户状态划分的每日绩效报告](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-by-customer-status-report.md) 整合了以下报告中的数据： [新客户与回头客](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) 和 [每日绩效](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-report.md) 。操作、操作成本和收入数据先按天汇总，然后进一步按客户状态细分。
* 高级操作列表

  「 [高级操作列表](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/advanced-action-listing-report.md) 会提供您所选日期范围内每项操作的多种数据点。若要查看此报告所列操作关联的客户状态（如有），请选择 **显示** 筛选器，勾选 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[未勾选的复选框]** **客户状态** 复选框，然后选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-26956d35e17c61868ca8dba76097721fd6066ab4%2F69945c787eb2db89761c82e0cd32fb31d2fc690bfb8592d9a08b7e7983b7445b.svg?alt=media) **\[搜索]**.
  {% endstep %}

{% step %}

## 更新您的付款

成功将客户状态映射添加到跟踪代码后，您可以为合作伙伴创建 *付款调整* 或 *付款组*。这些设置可根据合作伙伴促成转化时对应的客户状态类别，调整或增加支付给合作伙伴的金额（例如，为 `New` 客户支付更高的金额）。

### 创建付款调整

在 impact.com 上，您可以根据非常具体的条件创建规则，以调整某项操作的付款金额，其中包括 *客户状态*. *付款调整* **调整** 应付给合作伙伴的佣金，金额以 *默认付款* （或在适用情况下， *付款组*）为基准，按金额或百分比进行调整。

{% hint style="success" %}
**注意：** 对于按 *线上销售额百分比* 支付佣金而非 *版位费用*的品牌，impact.com 建议使用 *付款组* 设置最终付款比例，而不要尝试通过 *付款调整*.
{% endhint %}

1. 在左侧导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[合作]** → **合约 →** [**Template Terms**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. 在要更改的模板条款旁边，在 *操作* 列中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[更多]** → **修改条款**.
3. 在 *付款调整*旁边，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[开启]** **根据特定条件调整付款**.
4. 设置付款调整 [*规则*](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md) 依据 *客户状态*.
   * 请参阅以下示例设置：带来 `New` 客户可获得 10% 的付款增幅，而带来 `Existing` 客户则会使付款减少 50%。
5. 在屏幕底部，选择 **下一步**.
6. 选择这些修改何时对使用该模板条款的有效合同生效。
7. 选择 **下一步**.
8. 可选：添加备注，向合作伙伴说明所做的更改。
9. 选择 **保存**.

### 创建付款组

在 impact.com 上，您可以根据非常具体的规则将合作伙伴分入不同的付款类别，包括使用 [*付款组*](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md) 来 **彻底更改** 应付给合作伙伴的佣金。通常，您会在创建新的模板条款时创建付款组，但也可以将其添加到现有条款中，并 [稍后切换合同](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/replace-a-partners-contract.md).

1. 在左侧导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[合作]** → **合约 →** [**Template Terms**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. 在要更改的模板条款旁边，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[更多] → 修改条款**.
3. 在 *事件类型*旁边，选择此模板条款适用的事件类型。
4. 在 *付款组*旁边，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[开启]** **设置自定义付款组**.
5. 如要逐个添加付款组，请选择 **添加新项**.
   * 在第一个 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]**&#x4E2D;，选择付款组 [*规则*](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md).
   * 在第二个 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]**&#x4E2D;，选择该规则应用于付款组的方式。
   * 接下来，选择适用于所选付款规则的值（例如，如果您选择了 *货币* 作为规则，则必须选择您要用于向合作伙伴付款的货币类型）
   * 在 *付款* 部分中，选择付款指标（即百分比或固定金额）以及相应的数值。
   * 选择 **添加**.
6. 要创建另一个组，请再次选择 **添加新项** 。
   * 如果您在每个付款组中添加多个规则，则必须满足所有规则，该付款组才会生效。
   * 对于每种需要自定义付款的 *客户状态* ，您都应该创建一个新的付款组。
7. 选择 **下一步**.
8. 查看您对模板条款所做的更改，然后选择 **下一步**.
9. 选择这些模板条款的有效合同何时开始应用修改。
10. 选择是否允许合作伙伴在 *修改开始日期*.
11. 可选：添加备注，向合作伙伴说明所做的更改。
12. 选择 **保存**.
    {% endstep %}
    {% endstepper %}

{% hint style="success" %}
**注意：** 如果 impact.com 找不到适用于合作伙伴促成操作的付款组，则将应用 *默认付款* 。
{% endhint %}

## 实际示例

Barb Dwyer 为您的品牌促成了一笔铁砧销售（$100），带来了一位 **新** 客户。该合同的默认付款为销售额的 10%，因此 Barb Dwyer 将获得 $10 佣金。不过，您希望奖励为品牌带来新客户的合作伙伴，因此决定将合作伙伴带来新客户时获得的付款提高 5%，并尝试使用 *付款组* 和 *付款调整*.

首先，您决定在合同中设置一个 **付款组** ，付款金额为 **商品销售额的 15%** （比默认付款高 5%）。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FHCTLWwaGnyuj4Nj5NCaL%2FScreenshot%202026-05-06%20at%2011.18.07.png?alt=media&amp;token=c18c92fc-e087-4b27-80ac-f71d562a4e48" alt="" width="563"><figcaption></figcaption></figure></div>

现在，Barb Dwyer 将获得 $100 的 15%，即 $15 佣金。

接下来，您停用该付款组，并尝试设置一项 **付款调整** ，将新客户的付款提高 5%。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fl4ZWk1s1g9RVXmmPI054%2FScreenshot%202026-05-06%20at%2011.30.10.png?alt=media&amp;token=3ce198d5-0c42-401d-842d-955006d4e06e" alt="" width="563"><figcaption></figcaption></figure></div>

现在，Barb Dwyer 将获得其 *默认付款* 10%（$10），再加上所获佣金的 5%。$10 + 5% = 收到 $10.50 佣金。


---

# 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/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.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.
