> 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/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
   * [订单级动作/转化数据模板](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
   * [链式动作转化数据模板](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. 将你的转化数据添加到文件中。
   * 请参阅 [impact.com 动作与转化数据参考](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) 示例文档，并将此文件作为已接受参数的参考。联系你的 CSM，了解在转化数据模板中应包含哪些参数最合适。
3. 将你想要报告的任何可选参数作为新列追加到文件中。
4. 将文件保存为 .CSV 格式，并使用一个易于识别的标题和日期（例如， `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**注意：** 对于商品级批量文件，具有多个相关 SKU 的订单 ID 必须连续列出。确保具有相同订单 ID 且 SKU 不同的行项目分组在一起，否则你可能会在文件靠后位置列出的 SKU 上收到 `OID_DUPLICATE` 错误。
{% endhint %}
{% endstep %}

{% step %}

### 选择你的提交方式

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

| 如果你想要……        | 使用此方法……                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 无需编码，手动提交一次性文件 | ​[电子邮件](/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) 批量处理或 [通过 FTP 上传文件](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md)                                                                                                                                |
| 设置自动转化报告       | ​[Conversions API](https://integrations.impact.com/integration-guides/for-brands/tracking-integrations/api-online-sale/implementation), [通过 FTP 推送文件](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md)，或 [通过 FTP 拉取文件](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md) |
| {% endstep %}  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

{% step %}

### 提交你的数据文件

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 %}

### 查看你的文件提交

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/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. 使用表格查看 impact.com 已接收的近期文件提交，包括当前处理状态。
   * 下面，你可以查看在审查文件提交时可能遇到的各种错误，以及可采取的修正措施。

<details>

<summary>提交排查参考</summary>

| 问题                                    | 应采取的操作                                                                                                                                 |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| 记录列显示为 0                              | 确保文件扩展名为 .CSV 或 .XML。                                                                                                                  |
| `NO_CHANGE`                           | 未对该动作做任何更改。请确保将最终金额输入到 *金额* 列中（例如，如果你想撤销动作，请输入 0）。                                                                                     |
| `ALREADY_LOCKED`                      | 动作的锁定期已经过去。该动作不再能进行修改或撤销。                                                                                                              |
| `ActionTrackerId:ActionTrackerId 值无效` | 这应对应于 [事件类型 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.
