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

# 批量提交转化数据

如果你的转化数据未被自动跟踪，无论你是在服务器端收集数据还是依赖 cookie，都可以使用批量处理直接向 impact.com 提交转化数据。你还可能需要 [追溯提交转化数据](/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) 有时这样做，例如当客户错过了合作伙伴的促销码时。提交这些数据可确保你将归因正确分配给合适的合作伙伴，保持报告准确，并可在锁定前选择修改或撤销操作。

* 如果您需要使用非像素跟踪收集转化数据的帮助，请联系您的 CSM 或 [联系支持团队](https://app.impact.com/support/portal.ihtml?createTicket=true)。要了解有关您的跟踪方法和集成的更多信息，我们建议查阅我们的技术服务团队提供给您的原始技术集成计划。
* 如果你有 *连接* 在您的账户中开启后，设置转化数据管道的方式会有所不同。了解如何 [创建连接](/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* 网页操作和移动应用操作所需的参数不同。请参见 [移动端特定参数](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting.md) 以了解有关提交移动应用转化的更多信息。

{% stepper %}
{% step %}

### 准备你的数据文件

按照以下说明查看模板文件，添加你的转化数据，并将其保存为 .csv 格式。你所需的模板取决于你是按 *商品级别* （即包含订单中每个商品的 SKU、数量等）还是按 *订单级别* （即仅跟踪订单本身，而不跟踪其中的商品）。你也可以提交 [链式操作](/brand/zh/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions.md) 数据。

{% hint style="warning" %}
**警告：** 我们强烈建议不要提交超过 88 天的操作，因为 impact.com 目前不会处理事件日期超出该时间窗口的通过 FTP 提交的转化。最早可追溯至 398 天前的转化也可以处理，但前提是归因使用 `MediaId`.
{% endhint %}

1. 请选择下面的一个链接来查看与您跟踪操作级别相匹配的 .csv 文件模板。
   * [商品级操作/转化数据模板](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/item-level-template)
   * [订单级操作/转化数据模板](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/order-level-template)
   * [链式操作转化数据模板](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/chained-actions-template)
2. 将你的转化数据添加到文件中。
   * 请参阅 [impact.com 操作与转化数据参考](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) 文档中的示例，并将此文件作为可接受参数的参考。请联系你的 CSM，了解在转化数据模板中最适合包含哪些参数。
3. 将你希望报告的任何可选参数作为新列追加到文件中。
4. 请以易于识别的标题和日期将文件保存为 .CSV 格式（例如， `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**注意：** 对于商品级批处理文件，具有多个关联 SKU 的订单 ID 必须连续列出。请确保具有相同订单 ID 但不同 SKU 的行项目被归为一组，否则你可能会收到 `OID_DUPLICATE` 文件中较下方列出的 SKU 的错误。
{% endhint %}
{% endstep %}

{% step %}

### 选择你的提交方式

你可以通过 FTP/SFTP 或电子邮件来格式化并提交数据。请选择最适合你的目标的方法。

| 如果你想要……         | 使用此方法……                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 无需编码即可手动提交一次性文件 | ​[电子邮件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#email-file-to-system-smtp-server) 批量处理或 [通过 FTP 上传文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#upload-file-to-system-ftp-server)                                                                                                       |
| 设置自动转化报告        | ​[转化](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) API， [通过 FTP 推送文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#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/submit-conversion-data/batch-submit-conversion-data#pull-file-from-your-own-ftp-server) |
| {% endstep %}   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

{% step %}

### 提交你的数据文件

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. 使用任意电子邮件客户端，将你的批量修改文件作为附件发送到该唯一地址。
   * 仅在 *收件人：* 字段中包含该事件类型的唯一电子邮件地址。如果你需要将此文件发送给其他人，请将他们添加到 *抄送：* 字段中添加 1 个。
4. 你可以将主题字段和邮件正文留空。
   * 请参见下面电子邮件地址的示例（你的会略有不同）：

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

</details>
{% endstep %}

{% step %}

### 查看你的文件提交

1. 从顶部导航栏中，选择 ![](/files/34cff7cafbbfcd416778a35b63cb058c27bcda8b) **\[用户资料] →** **设置**.
2. 在左侧栏中，位于 *技术* 部分下，选择 [**文件提交**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. 使用表格查看 impact.com 最近收到的文件提交，包括当前处理状态。
   * 下方可查看你在审查文件提交时可能遇到的各种错误，以及可采取的修复措施。

<details>

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

| 问题                                    | 采取的操作                                                                                                                                 |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| 记录列显示 0                               | 确保文件扩展名为 . CSV 或 .XML。                                                                                                                |
| `NO_CHANGE`                           | 未对该操作做出任何更改。请确保你将最终金额输入到 *金额* 列中（例如，如果你想撤销操作，请输入 0）。                                                                                  |
| `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/submit-conversion-data/batch-submit-conversion-data.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.
