> 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/how-payout-rules-work.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/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.
