> 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 提交转化数据。您也可能需要 [追溯提交转化数据](https://help.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) ，例如客户漏用了合作伙伴的促销代码时。提交这些数据可确保将功劳归于正确的合作伙伴，保持报告准确，并可选择在操作锁定前修改或撤销操作。

* If you need help collecting conversion data with non-pixel tracking, reach out to your CSM or [contact support](https://app.impact.com/support/portal.ihtml?createTicket=true). To learn more about your tracking method and integration, we recommend consulting the original Technical Integration Plan provided to you by our Technical Services team.
* If you have *Connections* turned on for your account, setting up a conversion data pipeline will look different for you. Learn how to [create a Connection](https://help.impact.com/brand/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* The required parameters for web actions and mobile app actions are different. See [Mobile-Specific Parameters](https://help.impact.com/brand/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) for more information on submitting mobile app conversions.

{% stepper %}
{% step %}

### 准备数据文件

按照以下说明查看模板文件、添加转化数据，并将文件另存为 .csv 格式。所需模板取决于您是在 *商品级别* （即包含订单中每件商品的 SKU、数量等信息），还是在 *订单级别* （即仅跟踪订单本身，而不跟踪订单中的商品）跟踪转化。您也可以提交 [链式操作](https://help.impact.com/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 或电子邮件整理并提交数据。请选择最适合您需求的方式。

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](https://help.impact.com/brand/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) batch processing or [upload file via 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.md)​                                                                                                                       |
| Set up automated conversion reporting         | ​[Conversions API](https://integrations.impact.com/integration-guides/for-brands/tracking-integrations/api-online-sale/implementation), [push file via 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.md), or [pull file via 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.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>Submission troubleshooting reference</summary>

| Issue                                              | Action to take                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Records column shows 0                             | Make sure the file extension is . CSV or .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `NO_CHANGE`                                        | There is no change made to the action. Please ensure you enter the final amount into the *Amount* column (e.g., enter 0 if you want to reverse actions).                                                                                                                                                                                                                                                                                                                                                                           |
| `BAD_DISPOSITION`                                  | <p>The reason code you provided is not valid. Please use one of the standard <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md">reason codes</a>.</p><p>Alternatively, you can set up a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p> |
| `ALREADY_LOCKED`                                   | The action locking period has already passed. The action can no longer undergo modifications or reversals.                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ActionTrackerld:ActionTrackerld value is invalid` | This should correspond to the [Event Type ID](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) entered.                                                                                                                                                                                                                                                                                                                                          |
| `ACTION_NOT_FOUND`                                 | The `OID` you provided is incorrect. Please provide a correct `OID`.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ALREADY_REVERSED`                                 | The action has already been reversed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `ALREADY_APPROVED`                                 | The action has already been 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 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/submit-conversion-data/batch-submit-conversion-data.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.
