# 通过 FTP 提交通话转化数据
参加 PXA 课程
正在跟踪通话转化数据的品牌可以将该数据批量报告为 .CSV 文件，并使用唯一凭据上传到 Impact FTP 服务器。
通过 FTP 批量向 impact.com 报告的通话转化数据通常在 24 小时内处理，并将作为待处理操作出现在 impact.com 平台中。
#### 上传您的 .CSV 文件
 此功能仅对特定的 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. 从顶部导航栏，选择  **\[用户资料] → 设置**.
2. 在右侧栏，“在” *跟踪*下，选择 **事件类型**.
3. 将光标悬停在您想提交数据的事件类型上，然后选择  **\[更多] → 查看/编辑**.
4. 在……旁边 *退货处理*下，选择  **要返回编辑界面，请选择**.
5. 选择 **自动化退货处理（高级）→ 批量上传**.
6. 通过选择来选择 FTP 连接  **\[未选中框]**.
* 或者，选择 **创建新连接**。了解如何 [创建数据上传连接](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 文件中所需的所有列标题。
通话转化文件格式参考
| 字段 | 类型 | 必填 | 说明 |
| ----------------------------- | ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `CampaignId` | 整数 | **必填** | 与通话转化关联的广告活动（或项目）的唯一标识符。 |
| `MediaId` | 整数 | **必填** | 合作伙伴或媒体来源的唯一标识符。 |
| `EventDate` | datetime (ISO 8601) | **必填** | 发生通话转化事件的日期和时间的 ISO 8601 格式。 |
| `ActionTrackerId` | 整数 | **必填** | 用于跟踪电话的操作追踪器（即事件类型）的唯一标识符。 |
| `CallProvider` | 字符串 | **必填** | 发送通话事件数据的供应商或客户 |
| `CallSessionId` | 字符串 | **必填** | 供应商或客户用于识别通话的唯一会话 ID。 |
| `CallerId` | 字符串 | **必填** | 始发通话的电话号码，用于匹配最终转化。 |
| `CalledPhoneNumber` | 字符串 | **必填** | 目标电话号码或接听电话的电话号码。 |
| `CallDuration` | 字符串 | **必填** | 通话的总时长（以秒为单位）。 |
| `TalkDuration` | 字符串 | **必填** | 通话的实际通话时长（以秒为单位）。 |
| `AdId` | 整数 | 可选 | 与通话转化关联的广告的唯一标识符。 |
| `通话状态` | 字符串 | 可选 | 此值表示通话的最终结果。如果请求中未提供此字段，我们将其设为 ANSWER 作为默认值。有效值为：
UNKNOWN\_CALLERID
FAILURE
CONGESTION
INCOMPLETE
CANCEL
IVR\_DROPOFF
NO\_TRANSFER\_ATTEMPT
ANSWER
|
| `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` | 字符串 | 可选 | |
#### 示例 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,
```