> 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 日期和时间格式。 |
| `ActionTrackerId` | 整数 | **必填** | 跟踪电话号码的操作跟踪器（即事件类型）的唯一标识符。 |
| `呼叫提供方` | 字符串 | **必填** | 发送通话事件数据的供应商或客户 |
| `通话会话 ID` | 字符串 | **必填** | 供应商或客户用于标识该通话的唯一会话 ID。 |
| `主叫号码` | 字符串 | **必填** | 用于匹配最终转化的来电源电话号码。 |
| `被叫电话号码` | 字符串 | **必填** | 目的电话号码或接听来电的电话号码。 |
| `通话时长` | 字符串 | **必填** | 通话总时长（秒）。 |
| `交谈时长` | 字符串 | **必填** | 通话实际交谈时长（秒）。 |
| `广告 ID` | 整数 | 可选 | 与通话转化相关的广告的唯一标识符。 |
| `通话状态` | 字符串 | 可选 | 此值表示通话的最终结果。如果请求中未包含该字段，我们会默认将其设为 接通 。有效值为：
未知来电号码
失败
拥塞
未完成
取消
IVR 流失
未尝试转接
接通
|
| `主叫电话号码国家/地区` | 字符串 | 可选 | 主叫电话号码的两位国家代码（ISO 3166 alpha-2）。当为 NULL 时，默认为 US。 |
| `被叫电话号码国家/地区` | 字符串 | 可选 | 被叫电话号码的两位国家代码（ISO 3166 alpha-2）。当为 NULL 时，默认为 US。 |
| `SubId1` | 字符串 | 可选 | 此值为媒体合作伙伴专用，仅媒体合作伙伴可用。这是媒体合作伙伴可以添加希望 impact.com 向其回传的数据点的占位符。 |
| `子 ID2` | 字符串 | 可选 | |
| `子 ID3` | 字符串 | 可选 | |
| `点击 ID` | 字符串 | 可选 | 由 impact.com 生成的、区分大小写的唯一标识符，表示一次引用点击，用于构建消费者旅程。 |
| `国家` | 字符串 | 可选 | 来电号码的国家/地区——由通话跟踪供应商识别。 |
| `城市` | 字符串 | 可选 | 来电号码所在城市——由通话跟踪供应商识别。 |
| `地区` | 字符串 | 可选 | 来电号码所在地区——由通话跟踪供应商识别。 |
| `邮编` | 整数 | 可选 | 来电号码的邮编——由通话跟踪供应商识别。 |
| `重复来电者` | 字符串 | 可选 | 重复来电 vs 新来电，用于指示通话跟踪供应商是否将来电者记录为重复来电者。 |
| `电话类型` | 字符串 | 可选 | 电话类型（例如：固定电话、移动电话）。 |
| `通话录音` | 字符串 | 可选 | 通话录音的唯一 URL。 |
| `IVR 时长` | 字符串 | 可选 | 通话在 IVR 树中停留的时长（秒）。 |
| `按键` | 字符串 | 可选 | 通话过程中按下的唯一按键名称列表。 |
| `按键 1` | 字符串 | 可选 | 按下的第一个键的名称。 |
| `按键 2` | 字符串 | 可选 | 按下的第二个键的名称。 |
| `按键 3` | 字符串 | 可选 | 按下的第三个键的名称。 |
| `按键 4` | 字符串 | 可选 | 按下的第四个键的名称。 |
| `流量来源` | 字符串 | 可选 | 交易来源（引用的媒体来源）。 |
| `短信订阅` | 字符串 | 可选 | 来电者是否选择接收短信促销。 |
| `用户代理` | 字符串 | 可选 | 转化生成器的用户代理。 |
| `结果名称` | 字符串 | 可选 | 转化事件名称。 |
| `销售金额` | 货币 | 可选 | 如果是销售转化，则为销售金额 |
| `参考 ID` | 字符串 | 可选 | 供参考的客户结果代码。 |
| `自定义转化事件1名称` | 字符串 | 可选 | 用于报告转化事件的自定义名称 |
| `自定义转化事件2名称` | 字符串 | 可选 | |
| `自定义转化事件3名称` | 字符串 | 可选 | |
| `自定义转化事件1值` | 字符串 | 可选 | 用于报告转化事件的自定义值 |
| `自定义转化事件2值` | 字符串 | 可选 | |
| `自定义转化事件3值` | 字符串 | 可选 | |
| `供应商事件 ID` | 字符串 | 可选 | 在通话事件中将是唯一的，在转化事件中也将是唯一的。 |
| `促销号码描述` | 字符串 | 可选 | 描述被叫电话号码 |
| `自定义通话事件1名称` | 字符串 | 可选 | 用于报告通话事件的自定义名称 |
| `自定义通话事件2名称` | 字符串 | 可选 | |
| `自定义通话事件3名称` | 字符串 | 可选 | |
| `自定义通话事件1值` | 字符串 | 可选 | 用于报告通话事件的自定义值 |
| `自定义通话事件2值` | 字符串 | 可选 | |
| `自定义通话事件3值` | 字符串 | 可选 | |
#### CSV 示例
复制此示例 CSV 数据以用于文件导入。
```programlisting
活动ID,媒体ID,事件日期,操作跟踪器ID,呼叫提供方,通话会话ID,主叫号码,被叫电话号码,通话时长,交谈时长,广告ID,通话状态,主叫电话号码国家/地区,被叫电话号码国家/地区,子ID1,子ID2,子ID3,点击ID,城市,地区,邮编,重复来电者,电话类型,通话录音,IVR时长,按键,按键1,按键2,按键3,按键4,短信订阅,用户代理,结果名称,销售金额,参考ID,自定义转化事件1名称,自定义转化事件2名称,自定义转化事件3名称,自定义转化事件1值,自定义转化事件2值,自定义转化事件3值,供应商事件ID,促销号码描述,自定义通话事件1名称,自定义通话事件2名称,自定义通话事件3名称,自定义通话事件1值,自定义通话事件2值,自定义通话事件3值
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.