> 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`。然后，该状态标签将与转化数据一起传递给 impact.com，作为以下参数中的一个值： `customerStatus={-动态值-}` 参数。

在你这边实现此逻辑后，你就可以在 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` 参数：

* 新客与回头客报表

  该 [新客与回头客报表](/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) 将向你显示由以下客户创建的操作数据： *新*, *现有*，以及 *重新激活* 客户在你选择的日期范围内的数据。由每种类型客户产生的操作、操作成本和收入会按带来该操作的合作伙伴汇总。
* 按日按客户状态表现报表

  该 [按日按客户状态表现报表](/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) 汇总了以下报表中的数据： [新客与回头客](/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) 和 [按日表现](/brand/zh/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-report.md) 报表。操作、操作成本和收入数据会先按天汇总，然后再按客户状态进一步细分。
* 高级操作列表

  该 [高级操作列表](/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 %}

## 更新你的支付

在成功将客户状态映射实施到你的跟踪代码中后，你可以创建合作伙伴 *支付调整* 或 *付款组*。这些设置可让你根据合作伙伴带来转化所对应的客户状态类别，调整或增加支付给合作伙伴的金额（例如，为 `新` 客户提供更高的支付）。

### 创建支付调整

在 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) **\[Engage]** → **合同 →** [**模板条款**](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. 设置支付调整 [*规则*](/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/yong-jin-gui-ze-ru-he-yun-zuo.md) 基于 *客户状态*.
   * 请参见下面的示例设置，其中带来 `新` 客户可获得 10% 的支付增加，而带来 `现有` 客户则会使支付降低 50%。
5. 在屏幕底部，选择 **下一步**.
6. 选择这些修改何时开始适用于该模板条款下的有效合同。
7. 选择 **下一步**.
8. 你也可以选择为合作伙伴添加一条评论，说明所做的更改。
9. 选择 **保存**.

### 创建支付组

在 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) 到 **彻底更改** 合作伙伴应得的佣金。通常在创建新的模板条款时会创建支付组，但你也可以将其添加到现有条款，并 [稍后切换合同](/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) **\[Engage]** → **合同 →** [**模板条款**](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;，选择支付组 [*规则*](/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/yong-jin-gui-ze-ru-he-yun-zuo.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 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/zh/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.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.
