巨量引擎/企业号/飞鱼线索接入

概述

巨量引擎/企业号/飞鱼线索接入的操作说明。

开始之前

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

操作说明

https://1500020151.vod2.myqcloud.com/43a59459vodtranscq1500020151/2ec1542a1397757905425525423/v.f100040.mp4

前往 飞鱼CRM，将使用头条自己的建站工具生成的线索自动同步到 CRM 销售线索池，并自动关联巨量引擎广告组、广告计划。

推送配置入口：设置>API 设置>线索推送规则>新建规则。

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 设置接口类型及维度

服务设置：秘钥和 token 不填

http_post url：

https://www.fxiaoke.com/marketing/adThridCallBack/recvData

筛选条件：看具体需求，没需求可不设置

失败通知：可以设置失败了通知相关责任人

完成后点击下一步。

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

注意：如果标准字段修改过，这里推送格式也要修改。数据格式不懂怎么调整的话，可以联系客户经理协助配置。

4 设置返回状态

返回状态修改成以下两个英文符：

状态码 key：errCode

消息 key：errMsg

完成后点击下一步。

5 接口调试

点击发送测试。

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

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

解决完失败的原因后，再次测试同步，同步成功，即可启用规则开关。

6 启用推送规则及查看推送历史

特殊情况注意事项

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

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 Data

3 省区市选择器字段映射

线索推送失败常见原因

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

常见问题

1、抖音企业号上收集的线索怎么同步飞鱼，再同步纷享营销通中？

****---参考飞鱼帮助手册绑定抖音企业号    https://feiyu.oceanengine.com/help-center/knowledge/115448  ，再按上面步骤配置同步数据到营销通

2、配置了推送规则后，营销线索同步记录没有数据怎么办？

（1）有可能是飞鱼系统没有推送过来，需要前往飞鱼平台进行确认。首先观察是否有数据？飞鱼没进入数据，则也不会推送到 CRM。

（2）其次，检查规则开关是否打开了？未打开也不会推送。

（3）如果开关打开也没推送，则观察规则监控，如果有线索数据的时间范围内没有推送日志，则需要联系飞鱼客服人员排查。

3、线索成功推送能推送到 CRM，后面在推送规则新增字段后，新增字段不能推送到 CRM？

检查数据推送格式是否有修改，如下图：

4. 线索成功推送能推送到 CRM，为什么表单字段总是推送不到 CRM？

需要注意，落地页表单的字段需要和规则中的表单字段保持一致，否则无法识别表单中的数据。

落地页表单可以从已有的线索列表去查看。

预期结果与验证

完成上述操作后，在对应页面检查处理结果，并与本步骤的目标核对。