> 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/submit-call-conversion-data-via-ftp.md).
# 通过 FTP 提交通话转化数据
参加 PXA 课程
正在跟踪通话转化数据的品牌可以将这些数据批量上报为一个 .CSV 文件，并使用唯一凭据上传到 impact.com 的 FTP 服务器。
通过 FTP 批量上报到 impact.com 的通话转化数据通常会在 24 小时内处理，并会以待处理操作的形式显示在 impact.com 平台中。
#### 上传您的 .CSV 文件
要提交到 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 连接  **\[未勾选框]**.
* 或者，选择 **创建新连接**. 了解如何 [创建数据上传连接](/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection.md).
7. 一旦您拥有 FTP 凭据，请使用 FTP 客户端连接到 impact.com。
* FTP 地址是 `ftp://import.impact.com/{name}`
* 您可以使用现有的一组凭据或自动生成的一组凭据。
8. 连接后，请将您的文件上传到服务器的主目录。
#### 通话转化文件格式规范
通话转化数据会填充到一个 .CSV 文件中。请参考下面的规范，了解您的 .CSV 文件所需的所有必填列标题。
通话转化文件格式参考
| 字段 | 类型 | 必填 | 说明 |
| ----------------------------- | -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CampaignId` | 整数 | **必填** | 与该通话转化相关联的活动（或项目）的唯一标识符。 |
| `MediaId` | 整数 | **必填** | 合作伙伴或媒体来源的唯一标识符。 |
| `EventDate` | 日期时间（ISO 8601） | **必填** | 通话转化事件发生时的 ISO 8601 格式日期和时间。 |
| `操作跟踪器 ID` | 整数 | **必填** | 跟踪该电话的操作跟踪器（即事件类型）的唯一标识符。 |
| `CallProvider` | 字符串 | **必填** | 发送通话事件数据的供应商或客户 |
| `CallSessionId` | 字符串 | **必填** | 供应商或客户用来标识该通话的唯一会话 ID。 |
| `CallerId` | 字符串 | **必填** | 发起呼叫的电话号码，用于匹配最终转化。 |
| `CalledPhoneNumber` | 字符串 | **必填** | 目的电话号码或接听来电的电话号码。 |
| `CallDuration` | 字符串 | **必填** | 通话总时长（以秒为单位）。 |
| `TalkDuration` | 字符串 | **必填** | 通话实际通话时长（以秒为单位）。 |
| `AdId` | 整数 | 可选 | 与该通话转化相关的广告唯一标识符。 |
| `CallStatus` | 字符串 | 可选 | 此值表示通话的最终结果。如果请求中未提供此字段，我们将其设为 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 生成的、区分大小写的唯一引用点击标识符，用于构建消费者旅程。 |
| `国家/地区` | 字符串 | 可选 | CallerId 的国家/地区——由通话跟踪供应商识别。 |
| `城市` | 字符串 | 可选 | CallerId 的城市——由通话跟踪供应商识别。 |
| `地区` | 字符串 | 可选 | CallerId 的地区——由通话跟踪供应商识别。 |
| `邮政编码` | 整数 | 可选 | CallerId 的邮政编码——由通话跟踪供应商识别。 |
| `RepeatCaller` | 字符串 | 可选 | 重复来电 vs 新来电，用于指示通话跟踪供应商是否将该来电者记录为重复来电者。 |
| `PhoneType` | 字符串 | 可选 | 电话类型（即座机、手机）。 |
| `CallRecording` | 字符串 | 可选 | 通话录音的唯一 URL。 |
| `IvrDuration` | 字符串 | 可选 | 通话在 IVR 流程树中停留的时长（秒）。 |
| `按键` | 字符串 | 可选 | 通话期间按下的唯一按键名称列表。 |
| `Key1` | 字符串 | 可选 | 按下的第一个按键名称。 |
| `Key2` | 字符串 | 可选 | 按下的第二个按键名称。 |
| `Key3` | 字符串 | 可选 | 按下的第三个按键名称。 |
| `Key4` | 字符串 | 可选 | 按下的第四个按键名称。 |
| `TrafficSource` | 字符串 | 可选 | 交易来源（引用的媒体来源）。 |
| `OptInSms` | 字符串 | 可选 | 来电者是否选择接收 SMS 推广。 |
| `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,
```
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-call-conversion-data-via-ftp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.