腾讯广告线索接入有两种方式,一种是腾讯线索平台直接推送线索,另一种是由营销通直接拉取线索。对接腾讯广告线索到CRM前,需要开通营销通,并在营销通接入腾讯广告。
一、方式一:腾讯线索平台直接推送线索
使用腾讯线索平台可直接将腾讯落地页收集到的线索自动推送进入CRM线索池,并自动关联腾讯广告计划,最终实现腾讯展示广告的端到端投放ROI分析。通过该方式,可灵活配置需要推送的表单字段,并满足实时性要求,推荐使用该方式对接腾讯落地页收集到的线索。不过通过该方式只能收集后续新增的线索,历史线索无法同步。在使用该功能之前,可以先了解腾讯线索推送接口说明和推送操作引导。
1.1 配置入口
登录腾讯广告,进入腾讯广告投放管理平台,访问【工具】-【线索管理平台】。
进入腾讯线索管理平台后,访问【系统设置】-【线索转发设置】-【线索转发API配置】-【线索数据转发】-【方式一:推送】-【接口配置】。
点击【新建配置】弹出配置弹窗。
1.2 基础信息及通知接口设置
规则名称:用户可以自定义
密钥和TOKEN:请联系客户经理或CSM获取
1.3 映射关系设置
配置映射关系设置,由于腾讯的线索字段和crm销售线索字段并非一一对映(包括名称、类型等),因此,需要在这里将腾讯的线索字段和该企业的crm销售线索字段进行一一映射对应,以保证腾讯所获取的线索信息能够一一正确的存入CRM线索的相应字段上。
1.3.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?示意图如下:
1.3.2 表单字段
由于标准字段中有姓名和电话字段,一般情况下,如果表单仅收集姓名和电话信息,则标准字段的映射已经足够,表单字段可以不设置。若收集的表单有比较多自定义字段,例如需要用户在表单填写产品线、试用产品、所在行业、客户类型等字段,则可以使用表单字段配置映射到CRM中。
表单字段C端显示名字填写做的腾讯落地页中的表单显示名称,若有多个表单中的名称不一样,均需要配置。比如“您的需求是什么”、“您要咨询的问题”、“请选择您的问题”,其实都是对应CRM中线索的同一“市场需求”字段,映射参数名均是销售线索该字段的apiName。简单一对一的参数可以直接通过此映射插入线索。若有复杂多选或单项配置,需要写函数映射。以下为示例:
原始字段名 | 转化后的字段名 | 说明 |
您的需求是什么 | field_I1xbb__c | 填需要映射到CRM字段的apiName |
您要咨询的问题 | field_I1xbb__c | 若多个表单均使用这一套映射规则,则每个原始字段名均需映射到同一个CRM字段的apiName。在本案例中,这是第2个表单,有“您要咨询的问题”字段,映射到CRM的同一个“市场需求”字段的apiName |
请选择您的问题 | field_I1xbb__c | 在本案例中,这是第3个表单中的“请选择您的问题”字段,映射到CRM的同一个“市场需求”字段的apiName |
1.3.3 自定义字段
自定义字段用来映射固定字段企业帐号(ea)、来源(Source)、广告来源(adSource),以及一些线索的必填字段。
字段名 | 字段值 |
ea | 必填。纷享企业账号,在管理页右上角可以获取 |
adSource | 必填。固定值字段“腾讯” |
leads_pool_id | 非必填。销售线索中“线索池”的具体选项apiName |
source | 非必填。销售线索中“来源字段”的具体选项apiName,此处为头条广告选项的apiName |
funApiName | 非必填。映射后台配置的函数名,函数可以支撑多选项相关映射 |
其他必填字段apiName | 非必填。其他必填字段,比如:销售线索中有必填字段公司company,但是飞鱼线索中可能没有这个字段,为了保证线索顺利保存到CRM销售线索,可以设置一下默认值如“未知” |
1.3.4 使用函数特别说明
需要使用函数的情况包括:推送时间字段、单选字段或多选字段,或者推送城市字段对应CRM的省市区字段。
若需要用到函数,首先在CRM中可添加函数,函数的类型为Map,且入参需为Data。
然后,需要在腾讯后台配置函数apiname。
1.4 适用范围设置
可设置该规则生效的范围,可按表单字段、标准字段进行区分。例如表单字段中,“意向产品”字段值为“营销通”的走该映射规则,若字段值为“订货通”,则可另外设置其他映射规则。
1.5 推送测试
完成映射配置后,即可进行推送测试。
检查线索是否进入CRM中,若没有进入,则前往【营销通】-【系统设置】-【线索设置】-【营销线索同步日志】查看线索是否进入营销通。
点击查看从腾讯推送过来的线索情况,确认同步至CRM的情况,以及同步失败的原因。
如图所示,同步失败的原因是因为线索重复,若线索基于手机号查重,则可尝试修改手机号码或线索ID,重新测试推送。
解决完失败的原因后,再次测试同步,同步成功,即可启用规则开关。由此完成腾讯线索管理平台的线索接入。
1.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;
完成后,点击【立即同步】,同步腾讯广告账户的历史广告计划和线索数据,后续将每日自动更新。