> 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)                                                                                                                      |
| 设置自动化转换报告       | ​[转化 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. 从顶部导航栏中选择 ![](/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 %}

### 查看你的文件提交

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

<details>

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

| 问题                                    | 采取的操作                                                                                                                             |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Records 列显示为 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.
