> 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` | datetime（ISO 8601） | **必填** | 通话转化事件发生时的 ISO 8601 日期和时间格式。 |
| `ActionTrackerId` | 整数 | **必填** | 跟踪电话号码呼叫的操作跟踪器（即事件类型）的唯一标识符。 |
| `通话提供方` | 字符串 | **必填** | 发送通话事件数据的供应商或客户 |
| `通话会话 ID` | 字符串 | **必填** | 供应商或客户用于标识通话的唯一会话 ID。 |
| `来电号码` | 字符串 | **必填** | 用于匹配最终转化的来电电话号码。 |
| `被叫电话号码` | 字符串 | **必填** | 目标电话号码或接听来电的电话号码。 |
| `通话时长` | 字符串 | **必填** | 通话总时长（秒）。 |
| `通话时长` | 字符串 | **必填** | 通话的实际通话时长（秒）。 |
| `广告ID` | 整数 | 可选 | 与通话转化相关的广告的唯一标识符。 |
| `CallStatus` | 字符串 | 可选 | 此值表示通话的最终结果。如果请求中不存在此字段，我们将其设为 接听 ，默认值。有效值为：
未知来电号码
失败
拥塞
不完整
取消
IVR 中途退出
未尝试转接
接听
|
| `来电号码国家/地区` | 字符串 | 可选 | 来电电话号码的两位国家/地区代码（ISO 3166 alpha-2）。当为 NULL 时，默认为 US。 |
| `被叫电话号码国家/地区` | 字符串 | 可选 | 被叫电话号码的两位国家/地区代码（ISO 3166 alpha-2）。当为 NULL 时，默认为 US。 |
| `SubId1` | 字符串 | 可选 | 此值是特定的，仅媒体合作伙伴可用。这里是媒体合作伙伴可添加数据点的占位符，供 impact.com 向其回传报告。 |
| `子ID2` | 字符串 | 可选 | |
| `子ID3` | 字符串 | 可选 | |
| `点击ID` | 字符串 | 可选 | 由 impact.com 生成的、区分大小写的唯一引用点击标识符，用于构建消费者旅程。 |
| `国家` | 字符串 | 可选 | 来电号码所属国家/地区 - 由呼叫跟踪供应商识别。 |
| `城市` | 字符串 | 可选 | 来电号码所属城市 - 由呼叫跟踪供应商识别。 |
| `地区` | 字符串 | 可选 | 来电号码所属地区 - 由呼叫跟踪供应商识别。 |
| `邮政编码` | 整数 | 可选 | 来电号码的邮政编码 - 由呼叫跟踪供应商识别。 |
| `重复来电者` | 字符串 | 可选 | 重复来电与新来电，用于指示来电者是否被呼叫跟踪供应商记录为重复来电者。 |
| `电话类型` | 字符串 | 可选 | 电话类型（即，固定电话、手机）。 |
| `通话录音` | 字符串 | 可选 | 通话录音的唯一 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.