> 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 提交通话转化数据

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

正在跟踪通话转化数据的品牌，可以将这些数据以 .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. 在顶部导航栏中，选择 ![](/files/1cbb667ec4878308f24ec4acd13cbf03ede0bdfe) **\[用户资料] → 设置**.
2. 在右侧栏中，在 *跟踪*下，选择 **事件类型**.
3. 将鼠标悬停在要提交数据的事件类型上，然后选择 ![](/files/48274f9251fd79e93a99aad7b4393690b07a61c9) **\[更多] → 查看/编辑**.
4. 在 *退货处理*下，选择 ![](/files/4d0611ed182e303ebde008ef2f389098391c41fe) **\[编辑]**.
5. 选择 **自动化退货处理（高级）→ 批量上传**.
6. 通过选择以下项来选择一个 FTP 连接 ![](/files/48509e0f0c9ae68203294f8aae7777211a4315e1) **\[未勾选的框]**.
   * 或者，选择 **创建新连接**。了解如何 [创建数据上传连接](/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 文件所需的所有必填列标题。

<details>

<summary>通话转化文件格式参考</summary>

| 字段                            | 类型             | 必填     | 描述                                                                                                                                                                                                                                                                                                                              |
| ----------------------------- | -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CampaignId`                  | 整数             | **必填** | 与该通话转化相关联的活动（或项目）的唯一标识符。                                                                                                                                                                                                                                                                                                        |
| `MediaId`                     | 整数             | **必填** | 合作伙伴或媒体来源的唯一标识符。                                                                                                                                                                                                                                                                                                                |
| `EventDate`                   | 日期时间（ISO 8601） | **必填** | 通话转化事件发生时间的 ISO 8601 格式日期和时间。                                                                                                                                                                                                                                                                                                   |
| `ActionTrackerId`             | 整数             | **必填** | 用于跟踪电话呼叫的动作跟踪器（即事件类型）的唯一标识符。                                                                                                                                                                                                                                                                                                    |
| `CallProvider`                | 字符串            | **必填** | 发送通话事件数据的供应商或客户                                                                                                                                                                                                                                                                                                                 |
| `CallSessionId`               | 字符串            | **必填** | 供应商或客户用于识别通话的唯一会话 ID。                                                                                                                                                                                                                                                                                                           |
| `CallerId`                    | 字符串            | **必填** | 来电号码，用于匹配最终转化。                                                                                                                                                                                                                                                                                                                  |
| `CalledPhoneNumber`           | 字符串            | **必填** | 被拨叫的电话号码或接听来电的电话号码。                                                                                                                                                                                                                                                                                                             |
| `CallDuration`                | 字符串            | **必填** | 通话总时长（秒）。                                                                                                                                                                                                                                                                                                                       |
| `TalkDuration`                | 字符串            | **必填** | 实际通话时长（秒）。                                                                                                                                                                                                                                                                                                                      |
| `AdId`                        | 整数             | 可选     | 与通话转化相关联的广告的唯一标识符。                                                                                                                                                                                                                                                                                                              |
| `CallStatus`                  | 字符串            | 可选     | <p>此值表示通话的最终结果。如果请求中未包含该字段，我们会将其设为 <code>ANSWER</code> ，默认值。有效值如下：</p><p><code>UNKNOWN\_CALLERID</code></p><p><code>FAILURE</code></p><p><code>CONGESTION</code></p><p><code>INCOMPLETE</code></p><p><code>CANCEL</code></p><p><code>IVR\_DROPOFF</code></p><p><code>NO\_TRANSFER\_ATTEMPT</code></p><p><code>ANSWER</code></p> |
| `CallerPhoneNumberCountry`    | 字符串            | 可选     | 发起方电话号码的两位国家代码（ISO 3166 alpha-2）。当为 NULL 时，默认为 US。                                                                                                                                                                                                                                                                              |
| `CalledPhoneNumberCountry`    | 字符串            | 可选     | 被拨叫电话号码的两位国家代码（ISO 3166 alpha-2）。当为 NULL 时，默认为 US。                                                                                                                                                                                                                                                                              |
| `SubId1`                      | 字符串            | 可选     | 该值为特定值，仅媒体合作伙伴可用。此处是一个占位符，媒体合作伙伴可以在此添加希望让 impact.com 向他们回传的数据点。                                                                                                                                                                                                                                                                 |
| `SubId2`                      | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `SubId3`                      | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `ClickId`                     | 字符串            | 可选     | 由 impact.com 生成的、区分大小写的推荐点击唯一标识符，用于构建消费者旅程。                                                                                                                                                                                                                                                                                     |
| `Country`                     | 字符串            | 可选     | 由来电追踪供应商识别的 CallerId 所属国家/地区。                                                                                                                                                                                                                                                                                                   |
| `City`                        | 字符串            | 可选     | 由来电追踪供应商识别的 CallerId 所属城市。                                                                                                                                                                                                                                                                                                      |
| `Region`                      | 字符串            | 可选     | 由来电追踪供应商识别的 CallerId 所属区域。                                                                                                                                                                                                                                                                                                      |
| `Zip`                         | 整数             | 可选     | 由来电追踪供应商识别的 CallerId 邮编。                                                                                                                                                                                                                                                                                                        |
| `RepeatCaller`                | 字符串            | 可选     | 重复来电或新来电，用于指示来电者是否被来电追踪供应商记录为重复来电者。                                                                                                                                                                                                                                                                                             |
| `PhoneType`                   | 字符串            | 可选     | 电话类型（即固定电话、手机）。                                                                                                                                                                                                                                                                                                                 |
| `CallRecording`               | 字符串            | 可选     | 通话录音的唯一 URL。                                                                                                                                                                                                                                                                                                                    |
| `IvrDuration`                 | 字符串            | 可选     | 通话在 IVR 树中停留的时长（秒）。                                                                                                                                                                                                                                                                                                             |
| `Keypresses`                  | 字符串            | 可选     | 通话期间按下的唯一按键名称列表。                                                                                                                                                                                                                                                                                                                |
| `Key1`                        | 字符串            | 可选     | 按下的第一个按键名称。                                                                                                                                                                                                                                                                                                                     |
| `Key2`                        | 字符串            | 可选     | 按下的第二个按键名称。                                                                                                                                                                                                                                                                                                                     |
| `Key3`                        | 字符串            | 可选     | 按下的第三个按键名称。                                                                                                                                                                                                                                                                                                                     |
| `Key4`                        | 字符串            | 可选     | 按下的第四个按键名称。                                                                                                                                                                                                                                                                                                                     |
| `TrafficSource`               | 字符串            | 可选     | 交易来源（引流媒体来源）。                                                                                                                                                                                                                                                                                                                   |
| `OptInSms`                    | 字符串            | 可选     | 来电者是否选择接收短信促销信息。                                                                                                                                                                                                                                                                                                                |
| `UserAgent`                   | 字符串            | 可选     | 转化生成器的用户代理。                                                                                                                                                                                                                                                                                                                     |
| `DispositionName`             | 字符串            | 可选     | 转化事件名称。                                                                                                                                                                                                                                                                                                                         |
| `SaleAmount`                  | Currency       | 可选     | 如果是销售转化，则为销售金额                                                                                                                                                                                                                                                                                                                  |
| `ReferenceId`                 | 字符串            | 可选     | 用于参考的客户处置代码。                                                                                                                                                                                                                                                                                                                    |
| `CustomConversionEvent1Name`  | 字符串            | 可选     | 用于转化事件报告的自定义名称                                                                                                                                                                                                                                                                                                                  |
| `CustomConversionEvent2Name`  | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `CustomConversionEvent3Name`  | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `CustomConversionEvent1Value` | 字符串            | 可选     | 用于转化事件报告的自定义值                                                                                                                                                                                                                                                                                                                   |
| `CustomConversionEvent2Value` | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `CustomConversionEvent3Value` | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `VendorEventId`               | 字符串            | 可选     | 对于通话事件和转化事件都将是唯一的。                                                                                                                                                                                                                                                                                                              |
| `PromoNumberDescription`      | 字符串            | 可选     | 描述被拨叫的电话号码                                                                                                                                                                                                                                                                                                                      |
| `CustomCallEvent1Name`        | 字符串            | 可选     | 用于通话事件报告的自定义名称                                                                                                                                                                                                                                                                                                                  |
| `CustomCallEvent2Name`        | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `CustomCallEvent3Name`        | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `CustomCallEvent1Value`       | 字符串            | 可选     | 用于通话事件报告的自定义值                                                                                                                                                                                                                                                                                                                   |
| `CustomCallEvent2Value`       | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |
| `CustomCallEvent3Value`       | 字符串            | 可选     |                                                                                                                                                                                                                                                                                                                                 |

</details>

#### 示例 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:

```
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=<question>
```

The question should be specific, self-contained, and written in natural language.
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.