概述
搜狗线索接入的操作说明。
开始之前
[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。
操作说明
连接器管理配置
该步骤主要目的是将搜狗线索通线索数据同步至平台连接器,连接器需要进行配置并生成用于接收数据的 URL。以下为通用的配置指导,可根据实际情况进行修改。
1 新建连接对象
- 进入搜狗线索通连接器,选择连接对象 tab,点击新建按钮。
- 填写基本信息,点击添加中间对象。
- 填写中间对象名称,完成后点击保存按钮。
需要单独新建 5 个连接对象,填写信息分别如下:
| 基本信息 | 中间对象 | |||
|---|---|---|---|---|
| ERP 对象名称 | ERP 对象编码 | 拆分类型 | 对象名称 | 拆分类型 |
| 搜狗销售线索 | sogou_clue | ERP 对象不拆分,就是独立的中间对象 | 销售线索 | 主对象 |
| 搜狗关键词 | sogou_keyword | ERP 对象不拆分,就是独立的中间对象 | 营销关键词 | 主对象 |
| 搜狗落地页 | sogou_page | ERP 对象不拆分,就是独立的中间对象 | 落地页 | 主对象 |
| 搜狗市场活动 | sogou_marketing | ERP 对象不拆分,就是独立的中间对象 | 市场活动 | 主对象 |
| 搜狗关键词投放计划 | sogou_keynamePlan | ERP 对象不拆分,就是独立的中间对象 | 关键词投放计划 | 主对象 |
新建连接对象完成页面如下:
2 编辑字段
- 点击编辑字段按钮。
- 进入编辑字段页面,点击添加字段,填写字段信息。
各个对象,需要填写字段信息分别如下:
| 中间对象 | 字段名称 | 字段编码 | 字段类型 | 是否必填 |
|---|---|---|---|---|
| 销售线索 | id | id | 主键字段 | 是 |
| 姓名 | name | 文本 | 是 | |
| 电话 | phoneNumber | 手机 | 是 | |
| 线索提交时间 | createTime | 日期时间 | 是 | |
| 市场活动 id | marketingId | 查找关联:市场活动 | 是 | |
| 市场活动 | id | id | 主键 | 是 |
| 推广计划名称 | planName | 文本 | 是 | |
| 线索提交时间 | createTime | 日期时间 | 是 | |
| 负责人 | principal | 人员 | 是 | |
| 营销关键词 | id | id | 主键 | 是 |
| 关键词 | keyword | 文本 | 是 | |
| 负责人 | principal | 人员 | 是 | |
| 关键词投放计划 | id | id | 主键 | 是 |
| 市场活动 id | marketingId | 查找关联:市场活动 | 是 | |
| 关键词 id | keywordId | 查找关联:营销关键词 | 是 | |
| 负责人 | principal | 人员 | 是 | |
| 落地页 | id | id | 主键 | 是 |
| 落地页名称 | pageName | 文本 | 是 | |
| 落地页 url | pageUrl | 文本 | 是 | |
| 负责人 | principal | 人员 | 是 |
3 插入函数,生成线索接收 URL
- 点击“销售线索”对象生成 API按钮,进入 API 格式页面。
- 点击如下位置的添加函数按钮。
- 填写描述,点击下一步。
- 复制填写以下函数:
log.info("请求参数:"+Fx.json.toJson(syncArg))
String dataStr=syncArg["objectData"]["pushData"];
List pushDatas=Fx.json.parseList(dataStr);
List resultList=[];
pushDatas.each{
map->
//搜狗市场活动
Map<String,String>sogou_marketing=[:];
String createTime=map["createTime"];
sogou_marketing.put("createTime",createTime);
String planName=map["planName"];
sogou_marketing.put("planName",planName);
String marketingId = Fx.crypto.MD5.encode(planName);
sogou_marketing.put("id",marketingId);
sogou_marketing.put("principal","10000");
resultList.add(["objAPIName":"sogou_marketing","masterFieldVal":sogou_marketing])
//营销线索
Map<String,String>sogou_clue=[:];
List<Map> formdata = map["data"] as List;
formdata.each{
map1->
String label = map1["label"];
String value = map1["value"];
if(label.contains("姓名")||label.contains("用户")||label.contains("名称")||label.contains("名字")||label.contains("人名")||label.contains("贵姓")){
sogou_clue.put("name",value);
}
}
String phoneNumber=map["phoneNumber"];
sogou_clue.put("phoneNumber",phoneNumber);
String clueId = map["clueId"];
sogou_clue.put("id",clueId);
sogou_clue.put("marketingId",marketingId);
resultList.add(["objAPIName":"sogou_clue","masterFieldVal":sogou_clue])
//营销关键词
Map<String,String>sogou_keyword=[:];
String keyword=map["keyword"];
String keywordId = Fx.crypto.MD5.encode(keyword);
sogou_keyword.put("id",keywordId);
sogou_keyword.put("keyword",keyword);
sogou_keyword.put("principal","10000");
resultList.add(["objAPIName":"sogou_keyword","masterFieldVal":sogou_keyword])
//搜狗关键词投放计划
Map<String,String>sogou_keynamePlan=[:];
String keywordPlan = keyword + planName;
sogou_keynamePlan.put("keywordPlan",keywordPlan);
String keynamePlanId = Fx.crypto.MD5.encode(keywordPlan);
sogou_keynamePlan.put("id",keynamePlanId);
sogou_keynamePlan.put("marketingId",marketingId);
sogou_keynamePlan.put("keywordId",keywordId);
sogou_keynamePlan.put("principal","10000");
resultList.add(["objAPIName":"sogou_keynamePlan","masterFieldVal":sogou_keynamePlan])
//落地页
Map<String,String>sogou_page=[:];
String pageName=map["pageName"];
String pageUrl=map["pageUrl"];
String pageUrlId = Fx.crypto.MD5.encode(pageUrl);
sogou_page.put("id",pageUrlId);
sogou_page.put("pageName",pageName);
sogou_page.put("pageUrl",pageUrl);
sogou_page.put("principal","10000");
resultList.add(["objAPIName":"sogou_page","masterFieldVal":sogou_page])
}
return ["dataList":resultList];//返回数组类型的
- 粘贴复制的函数,并设置参数。
- 完成后保存函数,最后复制如下生成的 API 地址,并前往搜狗线索通粘贴绑定地址(具体见 4.在搜狗线索通里绑定线索接收 URL)。
连接器数据集成流配置
该步骤主要目的是,将搜狗同步至连接器的数据,按照集成流规则同步至 CRM。以下为预设字段的配置指导,需要同步的字段和字段值需根据实际情况进行配置。
- 进入数据集成流页面,点击新建数据集成流添加集成流。
a. 添加市场活动集成流
按如下图选择源系统/源对象和目标系统/目标对象。
点击字段映射进行同步至 CRM 的字段映射配置。
b.添加销售线索集成流
c.添加营销关键词集成流
d.添加关键词投放计划集成流
e.添加落地页集成流
- 添加完成后,分别启用各个集成流,即可进行搜狗线索收集。
在搜狗线索通里绑定线索接收 URL
- 登录搜狗推广管理平台,打开推广菜单,选择搜狗线索通。
- 进入设置页面,点击「API 接收」旁的绑定设置,在「接口地址」中粘贴复制的接收线索 URL,然后点击测试,验证通过后保存。
数据同步监控
- 线索数据同步至连接器的情况可在接口管理页面点击调用记录查看。
- 连接器数据同步至 CRM 的情况可在数据监控页面点击详情进行查看。
- 数据同步失败,前往数据维护页面重新同步。
预期结果与验证
完成上述操作后,在对应页面检查处理结果,并与本步骤的目标核对。
常见问题与故障排除
无法继续操作时,先核对上文说明的条件和输入信息;遇到权限提示时,请管理员确认访问权限。