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

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

| 如果你想……         | 请使用此方法……                                                                                                                                                                                                                                                                    |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 无需编码，手动提交一次性文件 | [电子邮件](#step-2-submit-your-data-file) 批量处理或 [通过 FTP 上传文件](#step-2-submit-your-data-file)                                                                                                                                                                                  |
| 设置自动化转化报告      | [转化](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [转化](https://integrations.impact.com/brand-api-reference/reference/actions) API， [通过 FTP 推送文件](#step-2-submit-your-data-file)，或 [通过 FTP 拉取文件](#step-2-submit-your-data-file) |

### 请注意：

* **使用受支持的文件格式** — 你的提交文件必须为 .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 %}

#### 第 2 步：提交你的数据文件

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%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户资料] → 设置**.
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://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F4KrGuAmvXvwqwYUxauT0%2FScreenshot%202026-10-07%20at%2023.37.54.png?alt=media&amp;token=5835d762-9ad4-41c3-9715-d79be84c5af9" alt="" width="563"><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 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/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.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.
