> 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 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 文件所需的所有必填列标题。
呼叫转化文件格式参考
| 字段 | 类型 | 必填 | 说明 |
| ----------------------------- | ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `活动 ID` | 整数 | **必填** | 与该呼叫转化相关联的活动（或项目）的唯一标识符。 |
| `MediaId` | 整数 | **必填** | 合作伙伴或媒体来源的唯一标识符。 |
| `事件日期` | datetime（ISO 8601） | **必填** | 呼叫转化事件发生时间的 ISO 8601 日期和时间格式。 |
| `ActionTrackerId` | 整数 | **必填** | 用于跟踪电话呼叫的操作跟踪器（即事件类型）的唯一标识符。 |
| `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 的地区——由呼叫跟踪供应商识别。 |
| `Zip` | 整数 | 可选 | CallerId 的邮政编码——由呼叫跟踪供应商识别。 |
| `RepeatCaller` | 字符串 | 可选 | 重复来电或新来电，用于指示来电者是否被呼叫跟踪供应商记录为重复来电者。 |
| `PhoneType` | 字符串 | 可选 | 电话类型（即固定电话、手机）。 |
| `CallRecording` | 字符串 | 可选 | 通话录音的唯一 URL。 |
| `IvrDuration` | 字符串 | 可选 | 通话在 IVR 树中停留的时长（秒）。 |
| `Keypresses` | 字符串 | 可选 | 通话过程中按下的唯一按键名称列表。 |
| `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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.