使用百度基木鱼落地页、百度爱番番咨询组件,均可通过百度营销通的线索API推送功能,将落地到基木鱼站点转化的线索/爱番番咨询组建收集到的线索自动推送进入CRM线索池,并自动关联百度广告计划、关键词,实现广告投放到基木鱼落地的百度搜索广告的端到端投放ROI分析。
一、百度营销通线索推送介绍
二、进行百度营销通线索推送接口配置
2.1 配置说明
登录至百度营销后台,访问【账户设置】-【线索接收】-【API导出(账户)】,点击【推送接口配置】进入API配置页面。
2.2 设置字段和接口类型
2.2.1 基础信息及通知接口设置
- 规则名称:用户可以自定义
- 通知URL:填写固定地址//www.sxgtbz.com/marketing/adThridCallBack/recvData
- 签名参数名、签名参数值、自定义Header 可不用填写
2.2.2 规则生效条件设置
基于当前需要同步的需求自定义选择,根据需要同步的线索规则,配置企业的生效条件。对于不同组件类型(表单\电话\咨询)若字段映射有不同需求的,每个组件类型建议建立单独的推送规则。
2.2.3 映射关系设置
配置映射关系设置,由于基木鱼的线索字段和crm销售线索字段并非一一对映(包括名称、类型等),因此,需要在这里将基木鱼的线索字段和该企业的crm销售线索字段进行一一映射对应,以保证基木鱼所获取的信息能够一一正确的存入CRM线索的相应字段上。
标准字段:标准字段是百度营销通提供基础信息,每个企业都是相同的,映射了标准字段后,同步销售线索时,将配置的信息存入销售线索,其中以下ucid,clueId,keyword,planName,unitid字段为必须配置项,且映射参数名固定对应英文单词,其他标准字段可以自定义新增,映射参数名填写销售线索的apiName。
原始参数名 | 映射参数名 |
ucid | ucid |
clueId | clueId |
keyword | keyword |
planName | planName |
unitid | unitid |
其他参数 | 和以上4个不同,上面是填写固定值。若是其他参数映射需要找CRM线索字段的apiname |
表单字段:表单字段C端显示名字填写做的落地页中的表单显示名称,若有多个表单中的名称不一样,均需要配置。比如姓名、名称、称呼,其实都是对应CRM中线索的姓名字段,apiName是name,则均需要列出来,映射参数名均是销售线索的apiName。
自定义字段设置:自定义字段用来映射固定字段企业帐号(ea)、来源(Source)、广告来源(adSource),以及一些线索的必填字段。
具体配置见下表:
字段名 | 具体值 |
ea | 必填。纷享企业账号,在管理页右上角可以获取 |
source | 必填。销售线索中“来源”字段的具体选项apiName,此处为头条广告选项的apiName |
adSource | 必填。填写固定值字段“百度“ |
leads_pool_id | 非必填。销售线索中“线索池”的具体选项apiName,如选择销售线索 |
funApiName | 非必填。映射后台配置的函数名,函数可以支撑多选项相关映射 |
其他必填字段apiName | 非必填。其他必填字段,比如:销售线索中有必填字段公司company,但是基木鱼线索中可能没有这个字段,为了保证线索顺利保存到CRM销售线索,可以设置一下默认值如“未知” |
2.3 设置数据发送格式
复制左侧的数据改成右侧对应的数据格式:
数据格式不能采用默认格式需要改成带data的格式,其中ucid、clueId、ea、planName、keyword、adSource、funApiName (如有)不放到data中,其他需要传递参数均放入data中。如下示例:
{
"funApiName":"函数名称",
"ucid": "88888888",
"clueId": "20082016933312218",
"ea": "企业EA",
"planName": "奶茶加盟业务",
"keyword": "奶茶加盟多少钱",
"adSource": "baidu",
"unitId": "5465644",
"data": {
"source": "cm8o5E3oz",
"field_v1gms__c": "example",
"name": "example",
"mobile": "13888888888"
}
}
2.4 推送测试数据
测试数据时,可以修改右侧数据值,尤其是手机号,需要更新成手机号格式数据。数据整理完成后点击下一步进行数据测试,点击发送测试数据,发送成功后到CRM后台销售线索中查看推送的线索数据。
检查线索是否进入CRM销售线索对象中,若没有进入,则前往【营销通】-【系统设置】-【线索设置】-【营销线索同步日志】查看线索是否进入营销通。
如图所示,同步失败的原因是因为线索重复,若线索基于手机号查重,则可尝试修改手机号码或线索ID,重新测试推送。
线索推送或者映射不成功原因有多种,常见如下:
- 手机号格式不对
- 必填字段为空,未设置默认值
- 线索开启了查重规则,重复线索不能插入
- 测试数据这个clueId已经使用了,记得修改下ID再测试
- 检查作废数据中是否存在有与该数据重复的情况
- 推送数据格式没改,或者格式改不对
- 部分字段没放入data格式内,导致部分字段推送失败
数据正确则编辑完成后默认没有打开,打开推送设置
查看推送历史数据结构,若是广告关联的线索,有20分钟延时,其他线索实时推送。
三、特殊情况注意事项
3.1 复杂字段映射
对于复杂字段的映射,例如:多选,或者有客户逻辑的映射,需要通过在CRM自定义函数来实现.
基本原理:营销通收到基木鱼的数后,调用自定义函数,重新做下数据映射,满足存入CRM销售线索的条件。
3.1.1 单选字段映射
例子1:客户表单中有一个字段“客户爱好”,有四个选项A,排球 B,足球 C,羽毛球 D,乒乓球每个用户提交的线索,表单中的值都不一样,加入用户1选的是A,B,C,那么映射规则的客户爱好字段值是“A,B,C", 但是CRM销售线索的"客户爱好”多选项是不接受"A,B,C"的,需要做选项值的映射;
这个时候就需要在定义函数中将“客户爱好”数据映射为:[option1,2sy2dVjkh,T3KR33tVC]。
创建完自定义函数后,需要将自定义函数的apiname在基木鱼映射中做配置,如下:
自定义函数示例:
3.1.2 多选字段映射
代码示例:
String companyEmployees__c=Data["companyEmployees__c"];
switch (companyEmployees__c)
{
case "200人以下":
Data.put("companyEmployees__c", "1");
break;
case "200-500人":
Data.put("companyEmployees__c", "2");
break;
case "500-1000人":
Data.put("companyEmployees__c", "3");
break
case "1000-5000人":
Data.put("companyEmployees__c", "4");
break;
case "5000人以上":
Data.put("companyEmployees__c", "5");
break;
default:
Data.put("companyEmployees__c", "other");
}
return Data
3.2 销售线索必填字段
如果CRM销售线索有必填字段,但是基木鱼线索没有该字段,可以在前面自定义字段映射中,映射一个默认值。例如:未填写。写到销售线索,就会把“未填写”写入这个必填字段; 也可以在自定义函数中对必填字段做映射.