概述
腾讯广告线索接入的操作说明。
开始之前
[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。
操作说明
腾讯广告线索接入有两种方式，一种是腾讯线索平台直接推送线索，另一种是由营销通直接拉取线索。对接腾讯广告线索到 CRM 前，需要开通营销通，并在营销通接入腾讯广告。
使用腾讯线索平台可直接将腾讯落地页收集到的线索自动推送进入 CRM 线索池，并自动关联腾讯广告计划，最终实现腾讯展示广告的端到端投放 ROI 分析。通过该方式，可灵活配置需要推送的表单字段，并满足实时性要求，推荐使用该方式对接腾讯落地页收集到的线索。不过通过该方式只能收集后续新增的线索，历史线索无法同步。在使用该功能之前，可以先了解腾讯线索推送接口说明和推送操作引导。
1 配置入口
登录腾讯广告，进入腾讯广告投放管理平台，访问工具-线索管理平台。
进入腾讯线索管理平台后，访问系统设置-线索转发设置-线索转发 API 配置-线索数据转发-方式一：推送-接口配置。
点击新建配置弹出配置弹窗。
2 基础信息及通知接口设置
规则名称：用户可以自定义
推送地址：填写固定地址https://www.fxiaoke.com/marketing/adThridCallBack/tencent/recvData
密钥和 TOKEN：请联系客户经理或 CSM 获取
3 映射关系设置
配置映射关系设置，由于腾讯的线索字段和 crm 销售线索字段并非一一对映（包括名称、类型等），因此，需要在这里将腾讯的线索字段和该企业的 crm 销售线索字段进行一一映射对应，以保证腾讯所获取的线索信息能够一一正确的存入 CRM 线索的相应字段上。
1 标准字段
****标准字段是腾讯线索管理平台提供基础信息，每个企业都是相同的，映射了标准字段后，同步销售线索时，将配置的信息存入销售线索，其中以下 leads_id，adgroup_id，page_url，page_name，leads_name，leads_tel，leads_email 字段为必须配置项，其中部分映射参数名固定对应英文单词，其他标准字段可以自定义新增，映射参数名填写销售线索的 apiName。 （补充说明：原始字段不要传 account_id 字段，若需要，转化后的字段名请不要用“account_id”。）
| 原始字段名 | 转化后的字段名 |
|---|---|
| leads_id | 填写固定值“leads_id”，不可更改 |
| adgroup_id | 填写固定值“adgroup_id”，不可更改 |
| page_url | 填写固定值“page_url”，不可更改 |
| page_name | 填写固定值“page_name”，不可更改 |
| leads_name | 填写 CRM 中姓名字段的 apiname，一般为“name”。注意：如果表单字段有名字，这里就不需要了。 |
| leads_tel | 填写 CRM 中电话字段的 apiname，需注意在 CRM 中使用的是“mobile”还是“tel”。注意：如果表单字段有电话，这里就不需要了。 |
附：如何在 CRM 中寻找销售线索对象字段的 apiname？示意图如下：
2 表单字段
由于标准字段中有姓名和电话字段，一般情况下，如果表单仅收集姓名和电话信息，则标准字段的映射已经足够，表单字段可以不设置。若收集的表单有比较多自定义字段，例如需要用户在表单填写产品线、试用产品、所在行业、客户类型等字段，则可以使用表单字段配置映射到 CRM 中。
表单字段 C 端显示名字填写做的腾讯落地页中的表单显示名称，若有多个表单中的名称不一样，均需要配置。比如“您的需求是什么”、“您要咨询的问题”、“请选择您的问题”，其实都是对应 CRM 中线索的同一“市场需求”字段，映射参数名均是销售线索该字段的 apiName。简单一对一的参数可以直接通过此映射插入线索。若有复杂多选或单项配置，需要写函数映射。以下为示例：
| 原始字段名 | 转化后的字段名 | 说明 |
|---|---|---|
| 您的需求是什么 | field_I1xbb__c | 填需要映射到 CRM 字段的 apiName |
| 您要咨询的问题 | field_I1xbb__c | 若多个表单均使用这一套映射规则，则每个原始字段名均需映射到同一个 CRM 字段的 apiName。在本案例中，这是第 2 个表单，有“您要咨询的问题”字段，映射到 CRM 的同一个“市场需求”字段的 apiName |
| 请选择您的问题 | field_I1xbb__c | 在本案例中，这是第 3 个表单中的“请选择您的问题”字段，映射到 CRM 的同一个“市场需求”字段的 apiName |
3 自定义字段
自定义字段用来映射固定字段企业帐号(ea)、来源(Source)、广告来源(adSource)，以及一些线索的必填字段。
| 字段名 | 字段值 |
|---|---|
| ea | 必填。纷享企业账号，在管理页右上角可以获取 |
| adSource | 必填。固定值字段“腾讯” |
| leads_pool_id | 非必填。销售线索中“线索池”的具体选项 apiName |
| source | 非必填。销售线索中“来源字段”的具体选项 apiName，此处为头条广告选项的 apiName |
| funApiName | 非必填。映射后台配置的函数名，函数可以支撑多选项相关映射 |
| 其他必填字段 apiName | 非必填。其他必填字段，比如：销售线索中有必填字段公司 company，但是飞鱼线索中可能没有这个字段，为了保证线索顺利保存到 CRM 销售线索，可以设置一下默认值如“未知” |
4 使用函数特别说明
需要使用函数的情况包括：推送时间字段、单选字段或多选字段，或者推送城市字段对应 CRM 的省市区字段。
若需要用到函数，首先在 CRM 中可添加函数，函数的类型为 Map，且入参需为 Data。
然后，需要在腾讯后台配置函数 apiname。
4 适用范围设置
可设置该规则生效的范围，可按表单字段、标准字段进行区分。例如表单字段中，“意向产品”字段值为“营销通”的走该映射规则，若字段值为“订货通”，则可另外设置其他映射规则。
5 推送测试
完成映射配置后，即可进行推送测试。
检查线索是否进入 CRM 中，若没有进入，则前往营销通-系统设置-线索设置-营销线索同步日志查看线索是否进入营销通。
点击查看从腾讯推送过来的线索情况，确认同步至 CRM 的情况，以及同步失败的原因。
如图所示，同步失败的原因是因为线索重复，若线索基于手机号查重，则可尝试修改手机号码或线索 ID，重新测试推送。
解决完失败的原因后，再次测试同步，同步成功，即可启用规则开关。由此完成腾讯线索管理平台的线索接入。
6 常见问题
（1）如果有多个广告账号，每个广告账号都需要配置一遍规则吗？
为了避免每个广告账号都需要配置一遍，可以通过绑定账号权限，实现所有广告账号线索数据都从一个账号推送。
注意，在添加完绑定账号后，需要登录被绑定的账号上去确认绑定。
（2）一般线索推送失败会有哪些原因？
线索推送不成功原因有多种，常见如下：
- 手机号格式不对
- 必填字段为空，未设置默认值
- 线索开启了查重规则，重复线索不能插入
- 测试数据这个 leads_id 已经使用了，记得修改下 ID 再测试
- 检查作废数据中是否存在有与该数据重复的情况
方式二：由营销通直接拉取线索
从由营销通从腾讯线索管理平台拉取线索并同步到 CRM。使用该方式的场景一般是表单字段较使用的是标准字段，如电话、姓名，并且对线索实时推送要求不高的情况（线索数据每日凌晨才进行同步）。但是通过该方式，可以拉取腾讯线索平台的历史线索数据。
通过方式二需通过函数配置字段映射，设置后将自动同步腾讯线索管理平台线索存入 CRM，可配置存入的线索池。此项为高级配置项，涉及到函数设置，可联系纷享 CSM 咨询如何设置。
腾讯广告线索接入需要写函数，函数示例如下：
String leadsName = Data["leads_name"]
String phone = Data["leads_telephone"]
String location = Data["telephone_location"]
Data.remove("account_id")
if( leadsName ){
Data.put("name", leadsName)
}
if( phone ){
Data.put("tel", phone)
Data.put("mobile", phone)
}
if( location ){
Data.put("address", location)
}
if( Data["leads_email"] ){
Data.put("email", Data["leads_email"])
}
if( Data["leads_create_time"] ){
DateTime createTime = DateTime.of(Data["leads_create_time"] as Long)
Data.put("create_time", createTime.toTimestamp())
}
if( Data["leads_tags"] ){
Data.put("remark", Data["leads_tags"])
}
Data.put("company", "纷享专用内测企业")
Data.put("source", "4")
return Data;
完成后，点击立即同步，同步腾讯广告账户的历史广告计划和线索数据，后续将每日自动更新。
预期结果与验证
完成上述操作后，在对应页面检查处理结果，并与本步骤的目标核对。
常见问题与故障排除
无法继续操作时，先核对上文说明的条件和输入信息；遇到权限提示时，请管理员确认访问权限。