> 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/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md).

# 提交批量修改和冲销

当合作伙伴促成一次转化——例如一笔销售——且该动作的锁定期尚未结束时，你可以通过提交修改或撤销来更正任何不正确的动作数据。这样可确保在锁定期结束时，向合作伙伴正确支付佣金。

当客户退货、在结账时出错，或商品缺货时，通常会对动作进行修改或撤销。

你可以通过 API 批量提交修改和撤销，或按照本文所述通过 FTP/电子邮件提交。你所需的 FTP/电子邮件提交模板取决于你是按订单级还是商品级进行跟踪，因为两者需要不同的字段。如果不确定应使用哪个文件，请咨询你的 CSM 或 [联系支持团队](https://app.impact.com/support/portal.ihtml).

### 哪种提交方式适合你？

| 如果你想要……        | 使用此方法……                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 无需编码，手动提交一次性文件 | [电子邮件](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md#before-you-start) 批处理或 [通过 FTP 上传文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server)                                                                                                                                                                                                                              |
| 设置自动转化报告       | [转化](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [操作](https://integrations.impact.com/brand-api-reference/reference/actions) API， [通过 FTP 推送文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server)，或 [通过 FTP 拉取文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#pull-file-from-your-own-ftp-server) |

### 需要注意的事项：

* **使用受支持的文件格式** — 你的提交文件必须为 .CSV 或 .XML 格式。
* **不要添加新的数据点** — 你不能为交易添加新字段，只能更新现有字段。
* **了解去重处理** — 当多个动作共享相同的 *Oid/OrderId*，impact.com 会将更新应用于最新的 *ActionId*。若要覆盖此行为，请指定所需的 *ActionId*.
* **使用&#x20;*****金额*****&#x20;正确地用于撤销** — 要撤销一个动作，你可以设置 *金额 = 0*。但是，如果原始 *金额 = 0*，将其保留为 0 会被记录为修改，而该动作不会被撤销。

{% stepper %}
{% step %}

#### 第 1 步：准备你的数据文件

1. 确定与你的使用场景相关的模板文件。
   * 请参见 [批量修改与撤销参考](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) ，其中包含模板文件示例数据。
2. 将模板内容粘贴到电子表格应用程序（例如 Microsoft Excel）或文本编辑器（例如 Notepad）中。
3. 在表头下方，开始添加已更正的动作数据。

   * 如果你使用文本编辑器，请使用逗号分隔每个数据点。
   * 如果你使用电子表格编辑器，请将每个数据点填入单独的单元格。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>注意：</strong> 请确保将电子表格单元格编辑为“纯文本”或“文本”格式，以免值被意外省略。</p></div>
4. 请将文件保存为一个易于识别的名称，例如： `Batch_Mods/Reversals_2025_02_12.csv`
   * 如需查看 FTP/电子邮件批量处理中的常用字段列表，请参阅 [批量修改与撤销参考](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md)。或者，请参阅我们的 [动作与转化字段参考](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) 以获取受支持字段的完整列表。
     {% endstep %}

{% step %}
impact.com 允许每次操作最多进行 1,000 次修改。如果此后您需要进行更多修改， [联系支持团队](https://app.impact.com/support/portal.ihtml).

1. 在顶部导航栏中，选择 ![](/files/7e98afd4e334c165e5d5781599a29836d600e210) **\[用户资料] → 设置**.
2. 在右侧栏中，位于 *跟踪*，选择 [**事件类型**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 选择 **名称** 的事件类型，您要为其提交批量修改。
4. 在……旁边 *退货处理*，选择 ![](/files/ae87ea28f541bc1749d482fcfdb423e5cb4965f8) **\[编辑]**.
5. 选择 **自动化退货处理（高级）**.
6. 请选择以下与 FTP 或电子邮件相关的方法之一来提交您的文件：

<details>

<summary>将文件上传到系统 FTP 服务器</summary>

{% hint style="info" %}
我们建议拆分 FTP/SFTP 文件，以将每个文件中的最大条目数保持在 10,000 以下。
{% endhint %}

1. 选择 **将文件上传到系统 FTP 服务器。**
2. 选择 **通过电子邮件发送 FTP 用户名和密码** 和 **保存**.
3. 一旦您通过电子邮件收到 FTP 凭据，请使用 FTP 客户端并使用以下信息连接到 impact.com：

   |         | FTP                            | SFTP                            |
   | ------- | ------------------------------ | ------------------------------- |
   | **服务器** | batch.impact.com               | sftp\://batch.impact.com        |
   | **端口**  | 21                             | 22                              |
   | **用户名** | （您的区分大小写的 impact.com FTP 用户名。） | （您的区分大小写的 impact.com SFTP 用户名。） |
   | **密码**  | （您的区分大小写的 impact.com FTP 密码。）  | （您的区分大小写的 impact.com SFTP 密码。）  |
4. 连接后，将您的文件上传到服务器的主目录。
   * 如果您尚未收到 FTP 凭据邮件，请联系创建您 impact.com 账户的人员。或者， [联系支持团队](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>从您自己的 FTP 服务器提取文件</summary>

{% hint style="info" %}
我们建议拆分 FTP/SFTP 文件，以将每个文件中的最大条目数保持在 10,000 以下。
{% endhint %}

1. 选择 **从您自己的 FTP 服务器提取文件**.
2. 请输入 **服务器 URL**, **端口**，以及 **目录** 您 FTP 服务器上批量修改文件的路径。输入 **用户名** 和 **密码** impact.com 将用于连接到您的 FTP 服务器的。
3. 选择 **保存** 并继续。
4. 将您的文件上传到 *目录* 您上面指定的目录中。
   * impact.com 会每 24 小时尝试连接并从您的 FTP 服务器下载文件，因此您的文件在上传后最多可能需要 24 小时才能处理完毕。

</details>

<details>

<summary>将文件通过电子邮件发送到系统 SMTP 服务器</summary>

1. 选择 **将文件通过电子邮件发送到系统 SMTP 服务器。**
2. 在您所选方法下方将提供一个唯一的电子邮件地址。请复制此电子邮件地址。
3. 使用任意电子邮件客户端，向该唯一地址发送电子邮件，并将您的批量修改文件作为附件。
   * 仅在 *收件人：* 字段中包含该事件类型的唯一电子邮件地址。如果您需要将此文件发送给其他人，请将他们添加到 *抄送：* 字段中。
4. 您可以将主题字段和邮件正文留空。
   * 请参见下面的电子邮件地址示例（您的地址会略有不同）：

<div data-with-frame="true"><figure><img src="/files/3a7b8023ca15b3bacf4f5352752ce14998b315b6" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### 第 3 步：审核你的文件提交

一旦你已将 .CSV 或 .XML 文件发送至 impact.com，你可以返回查看其状态，以确认是否已处理。

1. 从顶部导航栏中，选择 ![](/files/7e98afd4e334c165e5d5781599a29836d600e210) **\[用户资料] → 设置**.
2. 在左侧列中，滚动到 *技术* 部分并选择 [**文件提交**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. 使用表格查看 impact.com 最近收到的文件提交，包括当前处理状态。
   * 已提交的文件会在提交后 10–15 分钟内显示，而常规报告更新可能需要 2 小时以上。
   * 以下是你在查看文件提交时可能遇到的各种问题，以及可用于排查问题的操作。

<details>

<summary>提交故障排除参考</summary>

| 问题                                    | 采取的操作                                                                                                                                                                                |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 记录列显示为 0                              | 请确保文件扩展名为 .CSV 或 .XML。                                                                                                                                                               |
| `NO_CHANGE`                           | 该操作未做任何更改。请确保将最终金额输入到 *Amount* 列中（例如，如果您想撤销操作，请输入 0）。                                                                                                                                |
| `BAD_DISPOSITION`                     | <p>您提供的原因代码无效。请使用标准的 <a href="/pages/73d86cbc9340800ac1deebeed7bcb40645fc4f96">原因代码</a>.</p><p>或者，您可以设置一个 <a href="/pages/e3e08d2a70b519195027fa14e3f87e1da5adbaee">自定义处置代码</a>.</p> |
| `ALREADY_LOCKED`                      | 操作锁定期已过。该操作不再能够进行修改或撤销。                                                                                                                                                              |
| `ActionTrackerld:ActionTrackerld 值无效` | 这应对应于 [事件类型 ID](/brand/zh/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) 已输入。                                                  |
| `ACTION_NOT_FOUND`                    | 该 `OID` 您提供的内容不正确。请提供正确的 `OID`.                                                                                                                                                      |
| `ALREADY_REVERSED`                    | 该操作已被撤销。                                                                                                                                                                             |
| `ALREADY_APPROVED`                    | 该操作已被批准。                                                                                                                                                                             |

</details>
{% 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 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/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.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.
