> 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) 在某些情况下这样做，例如当客户漏用了某个合作伙伴的促销代码时。提交这些数据可确保你将归因正确分配给相应合作伙伴，保持报告准确，并可在操作锁定前选择修改或撤销操作。
* 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](/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](/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、数量等信息）；或者按 *订单层级* （即，仅跟踪订单本身，而不跟踪其中的商品）。你也可以提交 [链式操作](/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 的明细行分组在一起，否则你可能会遇到 `OID_DUPLICATE` 文件更下方所列 SKU 的错误。
{% endhint %}
{% endstep %}
{% step %}
### 选择你的提交方式
你可以通过 FTP/SFTP 或电子邮件来格式化并提交数据。请选择最适合你的目标的方法。
| If you want to... | Use this method... |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Submit a manual, one-time file with no coding | [Email](/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](/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](/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](/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. 从顶部导航栏中，选择  **\[用户资料] → 设置**.
2. 在右侧栏中，位于 *跟踪*中，选择 [**事件类型**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 选择 **名称** 下，找到你要提交批量修改的事件类型的名称。
4. 在 *退货处理*中，选择  **\[编辑]**.
5. 选择 **自动化退货处理（高级）**.
6. 请选择以下与 FTP 或电子邮件相关的方法之一来提交你的文件：
将文件上传到系统 FTP 服务器
{% 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).
从你自己的 FTP 服务器拉取文件
{% hint style="info" %}
我们建议拆分 FTP/SFTP 文件，以将每个文件的最大条目数保持在 10,000 以下。
{% endhint %}
1. 选择 **从你自己的 FTP 服务器拉取文件**.
2. 输入 **服务器 URL**, **端口**，以及 **目录** 你 FTP 服务器上批量修改文件的路径。输入 **用户名** 和 **密码** impact.com 将用于连接到你 FTP 服务器的
3. 选择 **保存** 并继续。
4. 将你的文件上传到 *目录* 你在上方指定的
* impact.com 会每 24 小时尝试连接并从你的 FTP 服务器下载文件，因此你的文件在上传后最多可能需要 24 小时才能处理完成。
将文件通过电子邮件发送到系统 SMTP 服务器
1. 选择 **将文件通过电子邮件发送到系统 SMTP 服务器。**
2. 在你所选方法的下方会提供一个唯一的电子邮件地址。请复制该地址。
3. 使用任意电子邮件客户端，向该唯一地址发送邮件，并将你的批量修改文件作为附件。
* 在 *收件人：* 字段中只填写该事件类型的唯一电子邮件地址。如果你需要将此文件发送给其他人，请将他们添加到 *抄送：* 字段中。
4. 主题字段和邮件正文可以留空。
* 请参见下面的电子邮件地址示例（你的地址会略有不同）：
{% endstep %}
{% step %}
### 查看你的文件提交
1. 从顶部导航栏中，选择  **\[用户资料] →** **设置**.
2. 在左侧栏中，位于 *技术* 部分中，选择 [**文件提交**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. 使用该表查看 impact.com 最近收到的文件提交，包括当前处理状态。
* 下方可查看你在审查文件提交时可能遇到的各种错误，以及可采取的修正操作。
Submission troubleshooting reference
| 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` | The reason code you provided is not valid. Please use one of the standard reason codes.
Alternatively, you can set up a custom disposition code.
|
| `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](/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. |
{% 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=&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.
