一、飞鱼CRM配置
前往 飞鱼CRM，将使用头条自己的建站工具生成的线索自动同步到CRM销售线索池，并自动关联巨量引擎广告组、广告计划。
支持同步的线索
推送配置入口：设置>API设置>线索推送规则>新建规则。
2.1 设置字段映射关系
A.设置标准字段：以下五个为必须设置参数，且映射字段的api名称不允许修改，如果还需要获取其他相关参数也可以选择新增，右侧映射字段填写CRM销售线索里面的对应字段apiName名称。简单一对一的参数可以直接通过此映射插入线索。若有复杂多选或单项配置，需要写函数映射。
| 原始字段名称 | 映射字段 |
| 线索id（id） | 填写固定值“clueId”，此处不需要找CRM线索字段的apiname，固定值即可 |
| 姓名（name） | 填写CRM中姓名字段的apiname，一般为“name” |
| 电话（telphone） | 填写CRM中电话字段的apiname，需注意在CRM中使用的是“mobile”还是“tel” |
| 创建时间（adv_id） | 填写固定值“create_time”，此处不需要找CRM线索字段的apiname，固定值即可 |
| 计划id（ad_id） | 若使用头条广告旧版做投放，则填写固定值“ad_id”，此处不需要找CRM线索字段的apiname，固定值即可 |
| 广告id（promotion_id） | 若使用头条广告新版做投放，则填写固定值“promotion_id”，此处不需要找CRM线索字段的apiname，固定值即可 |
| 广告主id（adv_id） | 填写固定值“accountId”，此处不需要找CRM线索字段的apiname，固定值即可 |
B.表单字段和行业字段可以不设置，有需求可以类似配置。例如在表单中需要客户填写一些信息，比如姓名、电话、职位、行业，则需要填写表单的字段（注意：需要一字不漏，才能识别到表单字段），右边则填写CRM系统中对应线索需要映射的字段的apiname。
用户填写的表单字段，可以通过以下路径查找：
C.自定义字段设置：
| 字段名 | 具体值 |
| ea | 必填。纷享企业账号，在管理页右上角可以获取 |
| source | 销售线索中“来源字段”的具体选项apiName，此处可选头条广告选项的apiName |
| adSource | 必填。固定值字段“巨量引擎” |
| leads_pool_id | 非必填。销售线索中“线索池”的具体选项apiName |
| funApiName | 非必填。映射后台配置的函数名，函数可以支撑多选项相关映射 |
| 其他必填字段apiName | 非必填。其他必填字段，比如：销售线索中有必填字段公司company，但是飞鱼线索中可能没有这个字段，为了保证线索顺利保存到CRM销售线索，可以设置一下默认值如“未知” |
| record_type | 非必填。该项为“业务类型”，若CRM有较多必填项，但是表单字段较少，可以单独给广告同步的线索设置一个单独业务类型，广告同步的线索仅设置几个表单字段为必填项 |
字段设置完成后点击下一步。
2.2 设置接口类型及维度
服务设置：秘钥和token不填
http_post url：
//www.sxgtbz.com/marketing/adThridCallBack/recvData
筛选条件：看具体需求，没需求可不设置
失败通知：可以设置失败了通知相关责任人
完成后点击下一步。
2.3 设置数据发送格式
数据格式不能采用默认格式需要改成带data的格式,其中函数名称、企业账号ID、线索ID、adSource、funApiName （如有）不放到data中，其他需要传递参数均放入data中。如下示例：
{
"funApiName":"函数名称",
"ea": "企业账号ID",
"clueId": "",
"adSource": "巨量引擎",
"data": {
"name": "",
"mobile": "",
"create_time": "",
"source": "naask_kakd",
"ad_id": "",
"company":"未知",
"promotion_id": ""
}
}
注意：如果标准字段修改过，这里推送格式也要修改。数据格式不懂怎么调整的话，可以联系客户经理协助配置。
2.4 设置返回状态
返回状态修改成以下两个英文符：
状态码key：errCode
消息key：errMsg
完成后点击下一步。
2.5 接口调试
点击发送测试。
检查线索是否进入CRM中，若没有进入，则前往【营销通】-【系统设置】-【线索设置】-【营销线索同步日志】查看线索是否进入营销通。
如图所示，同步失败的原因是因为线索重复，若线索基于手机号查重，则可尝试修改手机号码或线索ID，重新测试推送。
解决完失败的原因后，再次测试同步，同步成功，即可启用规则开关。
2.6 启用推送规则及查看推送历史
三、特殊情况注意事项
3.1 复杂字段映射
3.1.1 单选字段映射
例子1：客户表单中有一个字段“客户爱好”，有四个选项A，排球 B，足球 C，羽毛球 D，乒乓球每个用户提交的线索，表单中的值都不一样，加入用户1选的是A,B,C，那么映射规则的客户爱好字段值是“A,B,C", 但是CRM销售线索的"客户爱好”多选项是不接受"A,B,C"的，需要做选项值的映射；
创建完自定义函数后，需要将自定义函数的apiname在飞鱼映射中做配置（当数据推送到CRM时，识别到有配置函数，则数据进CRM时会执行函数，调整数据格式以便存入CRM），如下：
自定义函数示例：
参考代码：
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.1.2 多选字段映射
同单选字段一样，创建完自定义函数后，需要将自定义函数的apiname在飞鱼映射中做配置（当数据推送到CRM时，识别到有配置函数，则数据进CRM时会执行函数，调整数据格式以便存入CRM），如下：
参考代码：
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 Data3.1.3 省区市选择器字段映射
四、线索推送失败常见原因
- 手机号格式不对
- 必填字段为空，未设置默认值
- 线索开启了查重规则，重复线索不能插入，重复测试数据这个手机号或者id已经使用了，记得修改下手机号或者id再测试
- 检查作废数据中是否存在有与该数据重复的情况
- 推送数据格式没改，或者格式改不对
- 部分字段没放入data格式内，导致部分字段推送失败