# 通过 FTP 或电子邮件提交转换数据

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

如果您通过服务器端或通过 cookie 收集转化数据（即操作），则需要将数据提交到 impact.com，以便可视化您的项目表现、将归因分配给合作伙伴，并在操作锁定之前修改或撤销任何操作。

本文档将指导您如何格式化并提交转化数据，并假设您已开始收集数据。

#### 在开始之前

* 如果您在使用非像素跟踪收集转化数据时需要帮助，请联系您的客户成功经理或 [联系客服](https://app.impact.com/support/portal.ihtml?createTicket=true)。要了解有关您的跟踪方法和集成的更多信息，我们建议参阅我们技术服务团队提供给您的原始技术集成计划。
* 如果您已启用 *Connections* 您的账户设置转换数据管道的方式将有所不同。了解如何 [创建 Connection](https://help.impact.com/brand/zh/ni-xiang-liao-jie-shen-me/account-administration/account-settings/send-data-to-impactcom/data-connections-overview).
* 网页操作和移动应用操作所需的参数不同。请参见 [移动特定参数](https://help.impact.com/brand/zh/ni-xiang-liao-jie-shen-me/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting) 以获取有关提交移动应用转化的更多信息。

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

{% stepper %}
{% step %}

### 步骤 1：准备您的数据

按照下面的说明查看模板文件，将您的转化数据添加进去，并以 .csv 格式保存。您需要的模板取决于您是按 *商品级别* （即包括订单中每件商品的 SKU、数量等）还是按 *订单级别* （即仅跟踪订单本身，而不是其中的商品）。您也可以提交 [链式操作](https://help.impact.com/brand/zh/ni-xiang-liao-jie-shen-me/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions) 数据。

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

{% hint style="info" %}
**注意：** 对于商品级批量文件，具有多个关联 SKU 的订单 ID 必须按顺序列出。未将具有相同订单 ID 但不同 SKU 的行项分组在一起将导致文件较下方列出的 SKU 出现 `OID_DUPLICATE` 错误。
{% endhint %}
{% endstep %}

{% step %}

### 步骤 2：提交您的数据文件

{% tabs %}
{% tab title="通过 FTP/SFTP 上传" %}

* 我们建议拆分 FTP/SFTP 文件，以使每个文件的最大条目数保持在 10000 以下。
* 要将文件提交到 impact.com 的 FTP/SFTP 服务器，您需要先检索账户凭证。按照下面的说明了解如何将现有凭证通过电子邮件发送给您。

1. 从顶部导航栏，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **［用户资料］→** **设置**.
2. 在右侧列的 *跟踪*下，选择 [**事件类型**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 将鼠标悬停在要提交服务器端操作跟踪数据的事件类型上，选择右侧的 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **［更多］** ，然后选择 **查看 / 编辑**.
4. 在 *退货处理*下，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **旁边选择［编辑］**.
5. 选择 **自动化退货处理（高级）→ 上传文件到系统 FTP 服务器**.
6. 选择 **通过电子邮件发送 FTP 用户名和密码** 并 **保存**.

   * 收到 FTP/SFTP 凭证后，使用 FTP/SFTP 客户端使用以下信息连接到 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 密码。）  |
7. 连接后，将文件上传到服务器的主目录。上传成功后，转到 **步骤 3：审核文件提交** 部分。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>注意：</strong> 如果您尚未收到 FTP/SFTP 凭证电子邮件，请联系创建您 impact.com 帐户的人。或者， <a href="https://app.impact.com/secure/mediapartner/support/customer-support-portal-flow.ihtml">联系客服</a>.</p></div>

{% endtab %}

{% tab title="通过 FTP/SFTP 拉取文件" %}

1. 从顶部导航栏，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **［用户资料］→** **设置**.
2. 在右侧列的 *跟踪*下，选择 [**事件类型**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 将鼠标悬停在要提交服务器端操作跟踪数据的事件类型上，选择右侧的 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **［更多］** ，然后选择 **查看 / 编辑**.
4. 在 *退货处理*下，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **旁边选择［编辑］**.
5. 选择 **从您自己的 FTP 服务器拉取文件**.
6. 输入 **服务器 URL**, **端口**，以及您 FTP/SFTP/FTPS 服务器上操作数据文件的目录路径。输入 **用户名** 并 **密码** impact.com 将用于连接到您 FTP/SFTP/FTPS 服务器的
7. 选择 **保存** 并继续。
8. 将您的操作数据文件上传到您在上文第 6 点指定的目录。impact.com 每 24 小时尝试连接并从您的 FTP/SFTP/FTPS 服务器下载文件。请至少等待 24 小时以便 impact.com 下载您的文件。
   {% endtab %}

{% tab title="通过电子邮件附加文件" %}

1. 从顶部导航栏，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **［用户资料］→** **设置**.
2. 在右侧列的 *跟踪*下，选择 [**事件类型**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 将鼠标悬停在要提交服务器端操作跟踪数据的事件类型上，选择右侧的 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **［更多］** ，然后选择 **查看 / 编辑**.
4. 在 *退货处理*下，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **旁边选择［编辑］**.
5. 选择 **将文件通过电子邮件发送到系统 SMTP 服务器**，然后复制您的唯一电子邮件地址。
6. 使用任何电子邮件客户端，向该唯一地址发送包含您的操作数据文件作为附件的电子邮件。（仅在 **事件类型的唯一电子邮件地址** 在 *收件人：* 字段中包含。如果您需要将此文件发送给其他人，请在 *抄送：* 一行中包括他们。）

   您可以将主题字段和邮件正文留空。
   {% endtab %}
   {% endtabs %}
   {% endstep %}

{% step %}

### 步骤 3：审核文件提交

1. 从顶部导航栏，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **［用户资料］→** **设置**.
2. 在左侧列的 *技术* 部分，选择 [**文件提交**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. 使用表格查看 impact.com 已接收的最近文件提交，包括当前的处理状态。
   1. 下面您可以查看在审核文件提交时可能遇到的各种错误以及您可以采取的纠正措施。

<details>

<summary>审核文件提交时的错误</summary>

审核文件提交时的一些常见错误可能包括：

| 问题                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 采取的操作                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 记录列显示为 0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 确保文件扩展名为 .CSV 或 .XML。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `ActionTrackerId：无效值`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>该 <code>ActionTrackerId</code> 不属于已提交的 <code>事件类型。</code> 1. 导航到</p><p>［用户资料］→ 设置 → 跟踪 <img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media" alt=""> <strong>2. 选择</strong>.</p><p>并检查正确的 <a href="https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml"><strong>事件类型</strong></a> NO\_REFERRERS\_FOUND <code>事件类型。</code>.</p> |
| <p><code>或者需要以下参数之一：</code> •</p><p>ClickId <code>CustomerId</code></p><p>ClickId <code>CustomProfileId</code></p><p>ClickId <code>CustomClickId</code></p><p>ClickId <code>OrderPromoCode</code></p><p>ClickId <code>MediaPartnerId</code></p><p>ClickId <code>UniqueUrl</code></p><p>ClickId <code>CallerId</code></p><p>ClickId <code>GoogAId</code></p><p>ClickId <code>AndroidId</code></p><p>ClickId <code>AppleIfa</code></p><p>ClickId <code>AppleIfv</code></p><p>ClickId <code>WinId</code></p><p>ClickId <code>PhoneNumber</code></p><p>ClickId <code>Odin1</code></p><p>ClickId <code>DeviceId</code></p><p>ClickId <code>OpenUdId</code></p><p>ClickId <code>Mac</code></p><p>ClickId <code>MacMd5</code></p><p>ClickId <code>为必填项</code> 您未提供任何与归因相关的参数。</p> | <p>请至少提供一个归因参数，以便系统能够识别应将归因分配给哪个合作伙伴。</p><p>OID\_Duplicate</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `OID`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>该 <code>已存在于 impact.com 系统中。请提供唯一的事件 ID。</code> 如果您正尝试上传之前已向我们报告过的未归因转化，请使用稍有不同的 OID。例如 xxxxxx</p><p><strong>注意：</strong> CLICK\_AFTER\_CONVERSION\_EVENT <strong>\_1</strong>.</p>                                                                                                                                                                                                                                                                                                                                                                                                               |
| `提交的 clickid 发生在转化事件之后。请确保提交的`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 事件日期 `CustomerId` 并 `是正确的。` NO\_VALID\_REFERRERS\_FOUND ACTIONTERMS\_NOT\_FOUND                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `合作伙伴在该`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 期间的合同不包含此特定事件类型。请务必在 `是正确的。` 下检查您与合作伙伴的合同 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **［Engage］→ 合同 →** [**合同**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-contracts-flow.ihtml).                                                                                                                                                                  |
| `NO_VALID_REFERRERS _ FOUND CONTRACT_NOT_FOUND`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>在该 <code>是正确的。</code>.</p><p>期间没有与该合作伙伴的有效合同。 <img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media" alt=""> <strong>［Engage］→ 合同 →</strong> <a href="https://app.impact.com/secure/advertiser/engage/contracts/library/view-contracts-flow.ihtml"><strong>合同</strong></a> • 选择</p>                                                                                                |
| `以检查合同历史记录。`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>NO\_VALID\_REFERNO\_VALID\_REFERRERS\_FOUND OUTSIDE\_ASSOCIATION\_WINDOW</p><p>期间没有与该合作伙伴的有效合同。 <img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media" alt=""> <strong>［Engage］→ 合同 →</strong> <a href="https://app.impact.com/secure/advertiser/engage/contracts/library/view-contracts-flow.ihtml"><strong>合同</strong></a> 该转化超出了合同条款中规定的点击归属窗口。默认设置为 30 天。请查看特定合作伙伴的归属窗口。</p>   |

</details>
{% endstep %}
{% endstepper %}
