> 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;正确用于撤销** — 若要撤销某个行为，你可以将 *Amount = 0*。但是，如果原始 *Amount = 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）或文本编辑器（例如记事本）中。
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. 在顶部导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[用户资料] → 设置**.
2. 在右侧栏中，在 *跟踪*，选择 [**事件类型**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 选择 **名称** 您要为其提交批量修改的事件类型。
4. 在……旁边 *退货处理*，选择 ![](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) **\[编辑]**.
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="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FbTqEWPIFtSUGlMvxsfbw%2FScreenshot_2026-03-27_at_8_36_19%E2%80%AFAM.png?alt=media&amp;token=eeaa8a95-fe91-427a-9db7-7b55def0db1b" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### 步骤 3：查看你的文件提交

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

1. 在顶部导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[用户资料] → 设置**.
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。                                                                                                                                                                                                                                                                                                                                                                  |
| `无更改`                                 | 该操作未作更改。请确保您将最终金额输入到 *金额* 列中（例如，如果您想撤销操作，请输入 0）。                                                                                                                                                                                                                                                                                                                                        |
| `错误处置`                                | <p>您提供的原因代码无效。请使用一种标准的 <a href="/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">原因代码</a>.</p><p>或者，您可以设置一个 <a href="/brand/zh/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">自定义处理代码</a>.</p> |
| `已锁定`                                 | 操作锁定期已经过去。该操作已无法再进行修改或撤销。                                                                                                                                                                                                                                                                                                                                                               |
| `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) 已输入。                                                                                                                                                                                                                                                     |
| `未找到操作`                               | 该 `OID` 您提供的内容不正确。请提供正确的 `OID`.                                                                                                                                                                                                                                                                                                                                                         |
| `已撤销`                                 | 该操作已被撤销。                                                                                                                                                                                                                                                                                                                                                                                |
| `已批准`                                 | 该操作已被批准。                                                                                                                                                                                                                                                                                                                                                                                |

</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.
