# 通过 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>

正在跟踪通话转化数据的品牌可以将该数据批量报告为 .CSV 文件，并使用唯一凭据上传到 Impact FTP 服务器。

通过 FTP 批量向 impact.com 报告的通话转化数据通常在 24 小时内处理，并将作为待处理操作出现在 impact.com 平台中。

#### 上传您的 .CSV 文件

![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ce68cfb317a0bdf2b9e82f3df63b400f7764cbf2%2F6b9ec025210c2878ab8e126697a41af04cef94403a452d5dee89cf87e9f2cf2d.svg?alt=media) 此功能仅对特定的 impact.com 版本或附加组件开放。 [联系我们](https://app.impact.com/support/portal.ihtml?createTicket=true) 以升级您的帐户并获得访问权限！

要提交到 impact.com 的 FTP 服务器，您需要先检索帐户凭据。按照以下说明了解如何将现有凭据通过电子邮件发送给您。

{% hint style="warning" %}
**注意：** 如果您尚未收到电子邮件，请联系创建您 impact.com 帐户的人员，或者 [联系支持](https://app.impact.com/secure/mediapartner/support/customer-support-portal-flow.ihtml?execution=e1s1).
{% endhint %}

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) **\[用户资料] → 设置**.&#x20;
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) **\[更多] → 查看/编辑**.
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. 选择 **自动化退货处理（高级）→ 批量上传**.
6. 通过选择来选择 FTP 连接 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[未选中框]**.
   * 或者，选择 **创建新连接**。了解如何 [创建数据上传连接](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection).
7. 一旦您获得 FTP 凭据，使用 FTP 客户端连接到 impact.com。
   * FTP 地址是 `ftp://import.impact.com/{name}`
   * 您可以使用现有的一组凭据或自动生成的一组凭据。
8. 连接后，将文件上传到服务器的主目录。

#### 通话转化文件格式规范

通话转化数据以 .CSV 文件填充。请参阅下面的规范，了解 .CSV 文件中所需的所有列标题。

<details>

<summary>通话转化文件格式参考</summary>

| 字段                            | 类型                  | 必填     | 说明                                                                                                                                                                                                                                                                                                                             |
| ----------------------------- | ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `CampaignId`                  | 整数                  | **必填** | 与通话转化关联的广告活动（或项目）的唯一标识符。                                                                                                                                                                                                                                                                                                       |
| `MediaId`                     | 整数                  | **必填** | 合作伙伴或媒体来源的唯一标识符。                                                                                                                                                                                                                                                                                                               |
| `EventDate`                   | datetime (ISO 8601) | **必填** | 发生通话转化事件的日期和时间的 ISO 8601 格式。                                                                                                                                                                                                                                                                                                   |
| `ActionTrackerId`             | 整数                  | **必填** | 用于跟踪电话的操作追踪器（即事件类型）的唯一标识符。                                                                                                                                                                                                                                                                                                     |
| `CallProvider`                | 字符串                 | **必填** | 发送通话事件数据的供应商或客户                                                                                                                                                                                                                                                                                                                |
| `CallSessionId`               | 字符串                 | **必填** | 供应商或客户用于识别通话的唯一会话 ID。                                                                                                                                                                                                                                                                                                          |
| `CallerId`                    | 字符串                 | **必填** | 始发通话的电话号码，用于匹配最终转化。                                                                                                                                                                                                                                                                                                            |
| `CalledPhoneNumber`           | 字符串                 | **必填** | 目标电话号码或接听电话的电话号码。                                                                                                                                                                                                                                                                                                              |
| `CallDuration`                | 字符串                 | **必填** | 通话的总时长（以秒为单位）。                                                                                                                                                                                                                                                                                                                 |
| `TalkDuration`                | 字符串                 | **必填** | 通话的实际通话时长（以秒为单位）。                                                                                                                                                                                                                                                                                                              |
| `AdId`                        | 整数                  | 可选     | 与通话转化关联的广告的唯一标识符。                                                                                                                                                                                                                                                                                                              |
| `通话状态`                        | 字符串                 | 可选     | <p>此值表示通话的最终结果。如果请求中未提供此字段，我们将其设为 <code>ANSWER</code> 作为默认值。有效值为：</p><p><code>UNKNOWN\_CALLERID</code></p><p><code>FAILURE</code></p><p><code>CONGESTION</code></p><p><code>INCOMPLETE</code></p><p><code>CANCEL</code></p><p><code>IVR\_DROPOFF</code></p><p><code>NO\_TRANSFER\_ATTEMPT</code></p><p><code>ANSWER</code></p> |
| `CallerPhoneNumberCountry`    | 字符串                 | 可选     | 始发电话号码的两位国家代码（ISO 3166 alpha-2）。为 NULL 时默认为 US。                                                                                                                                                                                                                                                                                |
| `CalledPhoneNumberCountry`    | 字符串                 | 可选     | 被叫电话号码的两位国家代码（ISO 3166 alpha-2）。为 NULL 时默认为 US。                                                                                                                                                                                                                                                                                |
| `SubId1`                      | 字符串                 | 可选     | 此值是特定于媒体合作伙伴且仅对其可用。媒体合作伙伴可以在此占位符中添加他们希望 impact.com 返回给他们的数据点。                                                                                                                                                                                                                                                                  |
| `SubId2`                      | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `SubId3`                      | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `ClickId`                     | 字符串                 | 可选     | 由 impact.com 为引用点击生成的区分大小写的唯一标识符，用于构建消费者路径。                                                                                                                                                                                                                                                                                    |
| `国家`                          | 字符串                 | 可选     | 呼叫者 ID 所在国家/地区 —— 由通话跟踪供应商识别。                                                                                                                                                                                                                                                                                                  |
| `城市`                          | 字符串                 | 可选     | 呼叫者 ID 所在城市 —— 由通话跟踪供应商识别。                                                                                                                                                                                                                                                                                                     |
| `地区`                          | 字符串                 | 可选     | 呼叫者 ID 所在地区/州 —— 由通话跟踪供应商识别。                                                                                                                                                                                                                                                                                                   |
| `Zip`                         | 整数                  | 可选     | 呼叫者 ID 的邮政编码 —— 由通话跟踪供应商识别。                                                                                                                                                                                                                                                                                                    |
| `RepeatCaller`                | 字符串                 | 可选     | 重复来电与新来电，用于指示通话跟踪供应商是否将呼叫者记录为重复来电者。                                                                                                                                                                                                                                                                                            |
| `PhoneType`                   | 字符串                 | 可选     | 电话类型（例如：座机、手机）。                                                                                                                                                                                                                                                                                                                |
| `CallRecording`               | 字符串                 | 可选     | 通话录音的唯一 URL。                                                                                                                                                                                                                                                                                                                   |
| `IvrDuration`                 | 字符串                 | 可选     | 通话在 IVR 树中停留的时长（以秒为单位）。                                                                                                                                                                                                                                                                                                        |
| `Keypresses`                  | 字符串                 | 可选     | 通话期间按下的唯一按键名称列表。                                                                                                                                                                                                                                                                                                               |
| `Key1`                        | 字符串                 | 可选     | 第一个按下的按键名称。                                                                                                                                                                                                                                                                                                                    |
| `Key2`                        | 字符串                 | 可选     | 第二个按下的按键名称。                                                                                                                                                                                                                                                                                                                    |
| `Key3`                        | 字符串                 | 可选     | 第三个按下的按键名称。                                                                                                                                                                                                                                                                                                                    |
| `Key4`                        | 字符串                 | 可选     | 第四个按下的按键名称。                                                                                                                                                                                                                                                                                                                    |
| `TrafficSource`               | 字符串                 | 可选     | 交易的来源（引用媒体来源）。                                                                                                                                                                                                                                                                                                                 |
| `OptInSms`                    | 字符串                 | 可选     | 表示呼叫者是否选择接收短信促销。                                                                                                                                                                                                                                                                                                               |
| `UserAgent`                   | 字符串                 | 可选     | 生成转化的用户代理。                                                                                                                                                                                                                                                                                                                     |
| `DispositionName`             | 字符串                 | 可选     | 转化事件名称。                                                                                                                                                                                                                                                                                                                        |
| `SaleAmount`                  | 货币                  | 可选     | 如果为销售转化，销售金额                                                                                                                                                                                                                                                                                                                   |
| `ReferenceId`                 | 字符串                 | 可选     | 用于参考的客户处置代码。                                                                                                                                                                                                                                                                                                                   |
| `CustomConversionEvent1Name`  | 字符串                 | 可选     | 用于报告转化事件的自定义名称                                                                                                                                                                                                                                                                                                                 |
| `CustomConversionEvent2Name`  | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `CustomConversionEvent3Name`  | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `CustomConversionEvent1Value` | 字符串                 | 可选     | 用于报告转化事件的自定义值                                                                                                                                                                                                                                                                                                                  |
| `CustomConversionEvent2Value` | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `CustomConversionEvent3Value` | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `VendorEventId`               | 字符串                 | 可选     | 对于通话事件和转化事件将是唯一的。                                                                                                                                                                                                                                                                                                              |
| `PromoNumberDescription`      | 字符串                 | 可选     | 描述被叫电话号码                                                                                                                                                                                                                                                                                                                       |
| `CustomCallEvent1Name`        | 字符串                 | 可选     | 用于报告通话事件的自定义名称                                                                                                                                                                                                                                                                                                                 |
| `CustomCallEvent2Name`        | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `CustomCallEvent3Name`        | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `CustomCallEvent1Value`       | 字符串                 | 可选     | 用于报告通话事件的自定义值                                                                                                                                                                                                                                                                                                                  |
| `CustomCallEvent2Value`       | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |
| `CustomCallEvent3Value`       | 字符串                 | 可选     |                                                                                                                                                                                                                                                                                                                                |

</details>

#### 示例 CSV

复制此示例 CSV 数据以用于您的文件导入。

```programlisting
CampaignId,MediaId,EventDate,ActionTrackerId,CallProvider,CallSessionId,CallerId,CalledPhoneNumber,CallDuration,TalkDuration,AdId,CallStatus,CallerPhoneNumberCountry,CalledPhoneNumberCountry,SubId1,SubId2,SubId3,ClickId,City,Region,Zip,RepeatCaller,PhoneType,CallRecording,IvrDuration,Keypresses,Key1,Key2,Key3,Key4,OptInSms,UserAgent,DispositionName,SaleAmount,ReferenceId,CustomConversionEvent1Name,CustomConversionEvent2Name,CustomConversionEvent3Name,CustomConversionEvent1Value,CustomConversionEvent2Value,CustomConversionEvent3Value,VendorEventId,PromoNumberDescription,CustomCallEvent1Name,CustomCallEvent2Name,CustomCallEvent3Name,CustomCallEvent1Value,CustomCallEvent2Value,CustomCallEvent3Value
1000,987654,2022-03-01T04:10:49-05:00,19283,Acme,1A5B9C4D0E0F7G1H0I,8005550100,11,8,
```
