# 通过 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，以便可视化您的项目表现、将归因分配给合作伙伴，并在动作锁定之前修改或撤销任何动作。

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

#### 在开始之前

* 如果您在使用非像素跟踪收集转化数据方面需要帮助，请联系您的 CSM 或 [联系支持](https://app.impact.com/support/portal.ihtml?createTicket=true)。要了解更多关于您的跟踪方法和集成的信息，我们建议查阅技术服务团队提供给您的原始技术集成计划。
* 如果您已 *连接* 为您的账户开启，设置转化数据管道对您来说将有所不同。了解如何 [创建连接](https://help.impact.com/brand/zh/account-administration/account-settings/send-data-to-impactcom/data-connections-overview).
* 网络动作和移动应用动作所需的参数不同。请参阅 [移动特定参数](https://help.impact.com/brand/zh/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 %}

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

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

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

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>注意：</strong> 对于商品级批量文件，具有多个关联 SKU 的订单 ID 必须连续列出。未将具有相同订单 ID 但不同 SKU 的行项目归组在一起将导致 <code>OID_DUPLICATE</code> 错误出现在文件后面列出的那些 SKU 上。</p></div>

#### 第 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. 在右侧栏，“在” *跟踪*下，选择 **事件类型**.
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) **\[More]** 右侧的，然后选择 **查看 / 编辑**.
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. 在右侧栏，“在” *跟踪*下，选择 **事件类型**.
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) **\[More]** 右侧的，然后选择 **查看 / 编辑**.
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. 在右侧栏，“在” *跟踪*下，选择 **事件类型**.
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) **\[More]** 右侧的，然后选择 **查看 / 编辑**.
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 %}

#### 第 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. 在左侧列，在 *技术* 部分，选择 **文件提交**.
3. 使用该表查看 impact.com 已接收的近期文件提交，包括当前的处理状态。
   * 下面，您可以查看在审核文件提交时可能遇到的各种错误以及可采取的纠正措施。

<details>

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

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

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

</details>
