百度基木鱼/爱番番/营销通线索接入

使用百度基木鱼落地页、百度爱番番咨询组件,均可通过百度营销通的线索API推送功能,将落地到基木鱼站点转化的线索/爱番番咨询组建收集到的线索自动推送进入CRM线索池,并自动关联百度广告计划、关键词,实现广告投放到基木鱼落地的百度搜索广告的端到端投放ROI分析。

一、百度营销通线索推送介绍

前往 百度营销-商业开发者中心-开发文档-线索管理-线索推送服务 了解百度基木鱼营销通线索推送介绍。

二、进行百度营销通线索推送接口配置

2.1 配置说明

登录至百度营销后台,访问【账户设置】-【线索接收】-【API导出(账户)】,点击【推送接口配置】进入API配置页面。

2.2 设置字段和接口类型

2.2.1 基础信息及通知接口设置

2.2.2 规则生效条件设置

基于当前需要同步的需求自定义选择,根据需要同步的线索规则,配置企业的生效条件。对于不同组件类型(表单\电话\咨询)若字段映射有不同需求的,每个组件类型建议建立单独的推送规则。

2.2.3 映射关系设置

配置映射关系设置,由于基木鱼的线索字段和crm销售线索字段并非一一对映(包括名称、类型等),因此,需要在这里将基木鱼的线索字段和该企业的crm销售线索字段进行一一映射对应,以保证基木鱼所获取的信息能够一一正确的存入CRM线索的相应字段上。
标准字段:标准字段是百度营销通提供基础信息,每个企业都是相同的,映射了标准字段后,同步销售线索时,将配置的信息存入销售线索,其中以下ucid,clueId,keyword,planName,unitid字段为必须配置项,且映射参数名固定对应英文单词,其他标准字段可以自定义新增,映射参数名填写销售线索的apiName。
原始参数名映射参数名
uciducid
clueIdclueId
keywordkeyword
planNameplanName
unitidunitid
其他参数和以上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销售线索有必填字段,但是基木鱼线索没有该字段,可以在前面自定义字段映射中,映射一个默认值。例如:未填写。写到销售线索,就会把“未填写”写入这个必填字段; 也可以在自定义函数中对必填字段做映射.  
2024-10-30
5 2