一、飞鱼CRM配置
前往 飞鱼CRM，将使用头条自己的建站工具生成的线索自动同步到CRM销售线索池，并自动关联巨量引擎广告组、广告计划。
支持同步的线索
推送配置入口：设置>API设置>线索推送规则>新建规则。
2.1 设置字段映射关系
A.设置标准字段：以下五个为必须设置参数，且映射字段的api名称不允许修改，如果还需要获取其他相关参数也可以选择新增，右侧映射字段填写CRM销售线索里面的对应字段apiName名称。简单一对一的参数可以直接通过此映射插入线索。若有复杂多选或单项配置，需要写函数映射。
| 原始字段名称 | 映射字段 |
| 线索id | 填写固定值“clueId” |
| 姓名 | 填写CRM中姓名字段的apiname，一般为“name” |
| 电话 | 填写CRM中电话字段的apiname，需注意在CRM中使用的是“mobile”还是“tel” |
| 创建时间 | 填写固定值“create_time” |
| 计划id | 若使用头条广告旧版做投放，则填写固定值“ad_id” |
| 广告id | 若使用头条广告新版做投放，则填写固定值“promotion_id” |
B.表单字段和行业字段可以不设置，有需求可以类似配置
C.自定义字段设置：
| 字段名 | 具体值 |
| ea | 必填。纷享企业账号，在管理页右上角可以获取 |
| source | 必填。销售线索中“来源字段”的具体选项apiName，此处为头条广告选项的apiName |
| adSource | 必填。固定值字段“巨量引擎” |
| leads_pool_id | 非必填。销售线索中“线索池”的具体选项apiName |
| funApiName | 非必填。映射后台配置的函数名，函数可以支撑多选项相关映射 |
| 其他必填字段apiName | 非必填。其他必填字段，比如：销售线索中有必填字段公司company，但是飞鱼线索中可能没有这个字段，为了保证线索顺利保存到CRM销售线索，可以设置一下默认值如“未知” |
2.2 设置接口类型及维度
服务设置：秘钥和token不填
http_post url：
https://www.fxiaoke.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在飞鱼映射中做配置，如下：
自定义函数示例：
参考代码：
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 多选字段映射
参考代码：
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