搜索

search支持配置自动化上报

自动上报

在腾讯有数数据管理端配置参数即可实现，可微信联系”数据接入SDK助手“咨询进行配置。

---

手动上报

在小程序点击搜索时上报。

数据规范

新增属性

名称	类型	必填	描述
keyword	string	Y	搜索关键词

公共属性

名称	类型	必填	描述
page	string	Y	行为发生的小程序页面路径，开头不要加 /，路径后可带查询参数 例pages/product?sku_id=AOdjf7u
page_title	string		行为发生的小程序页面标题 例商品详情、商城首页
sr_sdk_version	string		sdk版本号 例1.1.6
time	datetime	Y	行为发生时间 13位时间戳 例1560409473714
wx_user	object	Y	用户相关属性
app_id	string	Y	公众号或小程序唯一标识 例wx9d4f5f22pa099f82
open_id	string	Y	微信用户在小程序下的唯一标识符 例ogN6X0T-ilsH-XmIdzXtuR1f1r3Q
user_id	string		用户在商户的唯一标识符 例548019854034
union_id	string		微信用户在开放平台账号下的唯一标识符 例o6_bmlsdaXds8d6_sgVt7hM3OPfL
local_id	string		用户在有数的唯一标识符 例360b8853-64bf-3fba-e9a0-5abb1e4d7721
tag	array		用户的个性化标签
tag_id	string	C	标签ID，唯一标识符 例游客，若填写了`tag_name`则必填
tag_name	string	C	标签名称 例游客，若填写了`tag_id`则必填
extra	object
chan	object	Y	渠道相关属性
chan_wxapp_scene	integer	Y	小程序场景值，必填 例1037
chan_id	string		引流渠道的标识符
chan_refer_app_id	string		来源小程序或公众号appid 例wx9d6f5f6gea059654
chan_shop_id	string		微信用门店ID，若需要计算门店业务则必填
chan_shop_name	string		用户在有数的门店名称，展示字段，若chan_shop_id存在则必填
chan_custom	object		自定义渠道
chan_custom_id	string	C	4级自定义渠道的标识符，是自定义渠道的最小粒度 例mp-article-12375，若填写了chan_custom相关任一字段需必填
chan_custom_id_desc	string	C	4级自定义渠道的描述 例公众号文章(id=12375)，若填写了chan_custom相关任一字段需必填
chan_custom_cat_3	string	C	3级自定义渠道的标识符，3级是针对4级的分类，要求4级数据必须存在 例mp-article，若填写了chan_custom相关任一字段需必填
chan_custom_cat_3_desc	string	C	3级自定义渠道的描述，若chan_custom_cat_3存在则必须存在 例公众号文章，若填写了chan_custom相关任一字段需必填
chan_custom_cat_2	string	C	2级自定义渠道的标识符，2级是针对3级的分类，要求34级数据必须存在 例media，若填写了chan_custom相关任一字段需必填
chan_custom_cat_2_desc	string	C	2级自定义渠道的描述，若chan_custom_cat_2存在则必须存在 例媒体，若填写了chan_custom相关任一字段需必填
chan_custom_cat_1	string	C	1级自定义渠道的标识符，1级是针对2级的分类，要求234级数据必须存在 例wechat，若填写了chan_custom相关任一字段需必填
chan_custom_cat_1_desc	string	C	1级自定义渠道的描述，若chan_custom_cat_1存在则必须存在 例微信，若填写了chan_custom相关任一字段需必填
extra	object
component	object		组件是视图上的一个区块元素
component_id	string		组件ID
component_name	string		组件名称

信息

公共属性可以由 SDK 自动采集，一般情况下不需要开发回填，具体方法见可代理属性。

请求示例

let app = getApp()
app.sr.track('search', {
    "keyword": "口罩",
    // more...
})

::: tips

点击获取数据采集代码示例

:::

---

常见FAQ

问：我的小程序支持用户不输入搜索内容且搜索框中也为提供任何默认搜索词的操作，该如何上报？

答：keywords 上报 "null"，表示为空搜索。