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

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

概述

百度基木鱼/爱番番/营销通线索接入的操作说明。

开始之前

[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。

操作说明

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

https://1500020151.vod2.myqcloud.com/43a59459vodtranscq1500020151/9c141a171397757905423864099/v.f100040.mp4

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

1 配置说明

登录至百度营销后台，从首页下拉，点击访问营销通。

在该界面，查看该广告账户有哪些类型的组件来收集线索：在线咨询、表单、电话、加微信，一般是这四种组件，应用在不同的场景（咨询、表单、电话、卡券、抽奖、百家号、微信）；

以设置表单组件收集的线索推送规则的为例：

点击表单，查看表单列表，确认哪些是当前和后续会用到的

分别查看当前和后期要使用的表单，记录下来其表单字段的名称

然后在百度营销通界面往下拉左边列表，进入爱番番-设置-线索设置-选择推送接口配置，进入 API 配置页面。

进入 API 配置界面-点击右上角的新建规则，然后按照下方流程进行字段和接口类型设置

2 设置字段和接口类型

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

规则名称：用户可以自定义
通知 URL：填写固定地址https://www.fxiaoke.com/marketing/adThridCallBack/recvData
签名参数名、签名参数值、自定义 Header 可不用填写

2 规则生效条件设置

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

3 映射关系设置

配置映射关系设置，由于基木鱼的线索字段和 crm 销售线索字段并非一一对映（包括名称、类型等），因此，需要在这里将基木鱼的线索字段和该企业的 crm 销售线索字段进行一一映射对应，以保证基木鱼所获取的信息能够一一正确的存入 CRM 线索的相应字段上。

**标准字段：**标准字段是百度营销通提供基础信息，每个企业都是相同的，映射了标准字段后，同步销售线索时，将配置的信息存入销售线索，其中以下 ucid，clueId，keyword，planName，unitid 字段为必须配置项，且映射参数名固定对应英文单词，其他标准字段可以自定义新增，映射参数名填写销售线索的 apiName。

原始参数名	映射参数名
ucid	ucid
clueId	clueId
keyword	keyword
planName	planName
unitid	unitid
其他参数	和以上 4 个不同，上面是填写固定值。若是其他参数映射需要找 CRM 线索字段的 apiname

表单字段：即将我们进入表单组件时，复制到的表单字段，分别填入，若有多个表单中的名称不一样，均需要配置。比如姓名、名称、称呼，其实都是对应 CRM 中线索的姓名字段，apiName 是 name，则均需要列出来，映射参数名均是销售线索的 apiName。

**自定义字段设置：**自定义字段用来映射固定字段企业帐号(ea)、来源(Source)、广告来源(adSource)，以及一些线索的必填字段。

具体配置见下表：

字段名	具体值
ea	必填。纷享企业账号，在管理页右上角可以获取
source	必填。销售线索中“来源”字段的具体选项 apiName，此处为头条广告选项的 apiName
adSource	必填。填写固定值字段“百度“
leads_pool_id	非必填。销售线索中“线索池”的具体选项 apiName，如选择销售线索
funApiName	非必填。映射后台配置的函数名，函数可以支撑多选项相关映射
其他必填字段 apiName	非必填。其他必填字段，比如：销售线索中有必填字段公司 company，但是基木鱼线索中可能没有这个字段，为了保证线索顺利保存到 CRM 销售线索，可以设置一下默认值如“未知”

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"
  }
}

4 推送测试数据

测试数据时，可以修改右侧数据值，尤其是手机号，需要更新成手机号格式数据。数据整理完成后点击下一步进行数据测试，点击发送测试数据，发送成功后到 CRM 后台销售线索中查看推送的线索数据。

检查线索是否进入 CRM 销售线索对象中，若没有进入，则前往营销通-系统设置-线索设置-营销线索同步日志查看线索是否进入营销通。

如图所示，同步失败的原因是因为线索重复，若线索基于手机号查重，则可尝试修改手机号码或线索 ID，重新测试推送。

线索推送或者映射不成功原因有多种，常见如下：

手机号格式不对
必填字段为空，未设置默认值
线索开启了查重规则，重复线索不能插入
测试数据这个 clueId 已经使用了，记得修改下 ID 再测试
检查作废数据中是否存在有与该数据重复的情况
推送数据格式没改，或者格式改不对
部分字段没放入 data 格式内，导致部分字段推送失败

数据正确则编辑完成后默认没有打开，打开推送设置

查看推送历史数据结构，若是广告关联的线索，有 20 分钟延时，其他线索实时推送。

特殊情况注意事项

1 复杂字段映射

对于复杂字段的映射，例如：多选，或者有客户逻辑的映射，需要通过在 CRM 自定义函数来实现.

基本原理：营销通收到基木鱼的数后，调用自定义函数，重新做下数据映射，满足存入 CRM 销售线索的条件。

1 单选字段映射

例子 1：客户表单中有一个字段“客户爱好”，有四个选项 A，排球 B，足球 C，羽毛球 D，乒乓球每个用户提交的线索，表单中的值都不一样，加入用户 1 选的是 A,B,C，那么映射规则的客户爱好字段值是“A,B,C", 但是 CRM 销售线索的"客户爱好”多选项是不接受"A,B,C"的，需要做选项值的映射；

这个时候就需要在定义函数中将“客户爱好”数据映射为：[option1,2sy2dVjkh,T3KR33tVC]。

创建完自定义函数后，需要将自定义函数的 apiname 在基木鱼映射中做配置，如下：

自定义函数示例：

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

2 多选字段映射

代码示例：



String city = Data["aaaa"];

List city_list = ["长沙市"]  //Data["companyEmployees__c"];
city_list.add(city)
List to_crm = []

city_list.each { item ->
  log.info(item)
  switch (item)
    {
        case "均可":
            to_crm.add("4vrsE2Rka")
            break;
        case "长沙市":
            to_crm.add("UgM1z8f6m")
            break;
        case "株洲市":
            to_crm.add("2mOF48nqO")
            break
        case "湘潭市":
            to_crm.add("k8wwo8s8H")
            break;
        case "娄底市":
            to_crm.add("yY1X1Qi22")
            break;
         case "邵阳市":
            to_crm.add("J2O9za4f5")
            break;
        default:
            break;
    }

}
log.info(to_crm)
Data.put("field_YwIf8__c",to_crm)

return Data

3 省市区字段

2 销售线索必填字段

如果 CRM 销售线索有必填字段，但是基木鱼线索没有该字段，可以在前面自定义字段映射中，映射一个默认值。例如：未填写。写到销售线索，就会把“未填写”写入这个必填字段；也可以在自定义函数中对必填字段做映射.

线索推送失败常见原因