搜狗线索接入

概述

搜狗线索接入的操作说明。

开始之前

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

操作说明

见 线索收集连接器开通和配置入口。

连接器管理配置

该步骤主要目的是将搜狗线索通线索数据同步至平台连接器,连接器需要进行配置并生成用于接收数据的 URL。以下为通用的配置指导,可根据实际情况进行修改。

1 新建连接对象

  1. 进入搜狗线索通连接器,选择连接对象 tab,点击新建按钮。

  1. 填写基本信息,点击添加中间对象。

  1. 填写中间对象名称,完成后点击保存按钮。

需要单独新建 5 个连接对象,填写信息分别如下:

基本信息 中间对象
ERP 对象名称 ERP 对象编码 拆分类型 对象名称 拆分类型
搜狗销售线索 sogou_clue ERP 对象不拆分,就是独立的中间对象 销售线索 主对象
搜狗关键词 sogou_keyword ERP 对象不拆分,就是独立的中间对象 营销关键词 主对象
搜狗落地页 sogou_page ERP 对象不拆分,就是独立的中间对象 落地页 主对象
搜狗市场活动 sogou_marketing ERP 对象不拆分,就是独立的中间对象 市场活动 主对象
搜狗关键词投放计划 sogou_keynamePlan ERP 对象不拆分,就是独立的中间对象 关键词投放计划 主对象

新建连接对象完成页面如下:

2 编辑字段

  1. 点击编辑字段按钮。

  1. 进入编辑字段页面,点击添加字段,填写字段信息。

各个对象,需要填写字段信息分别如下:

中间对象 字段名称 字段编码 字段类型 是否必填
销售线索 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

  1. 点击“销售线索”对象生成 API按钮,进入 API 格式页面。

  1. 点击如下位置的添加函数按钮。

  1. 填写描述,点击下一步。

  1. 复制填写以下函数:
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];//返回数组类型的

  1. 粘贴复制的函数,并设置参数。

  1. 完成后保存函数,最后复制如下生成的 API 地址,并前往搜狗线索通粘贴绑定地址(具体见 4.在搜狗线索通里绑定线索接收 URL)。

连接器数据集成流配置

该步骤主要目的是,将搜狗同步至连接器的数据,按照集成流规则同步至 CRM。以下为预设字段的配置指导,需要同步的字段和字段值需根据实际情况进行配置。

  1. 进入数据集成流页面,点击新建数据集成流添加集成流。

a. 添加市场活动集成流

按如下图选择源系统/源对象和目标系统/目标对象。

点击字段映射进行同步至 CRM 的字段映射配置。

b.添加销售线索集成流

c.添加营销关键词集成流

d.添加关键词投放计划集成流

e.添加落地页集成流

  1. 添加完成后,分别启用各个集成流,即可进行搜狗线索收集。

在搜狗线索通里绑定线索接收 URL

  1. 登录搜狗推广管理平台,打开推广菜单,选择搜狗线索通。

  1. 进入设置页面,点击「API 接收」旁的绑定设置,在「接口地址」中粘贴复制的接收线索 URL,然后点击测试,验证通过后保存。

数据同步监控

  1. 线索数据同步至连接器的情况可在接口管理页面点击调用记录查看。

  1. 连接器数据同步至 CRM 的情况可在数据监控页面点击详情进行查看。

  1. 数据同步失败,前往数据维护页面重新同步。

预期结果与验证

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

常见问题与故障排除

无法继续操作时,先核对上文说明的条件和输入信息;遇到权限提示时,请管理员确认访问权限。

2026-10-09
0 0