网站商品搜索

商品搜索是网站上的搜索框：输入时显示联想提示，并提供由 OneTrace.ru 用您目录中的商品填充的结果页。搜索能识别错别字、词形变化以及用错键盘布局输入的查询，并按访客的兴趣（浏览和购买过的商品）排列靠前的结果。

使用搜索需要已安装追踪器（接入网站）和商品目录（推荐与商品目录）。并非所有套餐都包含搜索：如果您的套餐不包含，安装选项卡中不会显示代码区块，搜索请求会收到“功能不可用”错误。

如何搜索商品

查询词会在商品的名称、品牌、分类和规格中搜索；货号则按精确匹配。
支持项目语言的词形变化：“куртки”能找到“Куртка зимняя”。语言在项目设置中指定，参见项目设置、套餐与审计。
自动纠正错别字：“крутка”能找到“куртку”，“dres”能找到“dress”。
用错键盘布局输入的查询同样有效：“ghbdtn”会按“привет”搜索。
如果没有同时包含所有词的结果，搜索会显示至少包含其中一个词的商品。
热门商品和有货商品排名更靠前。热度取自推荐，每天更新一次。
靠前的结果会按访客的兴趣重新排序：访客浏览和购买过的分类与品牌中的商品会排得更高。
如果店铺行业支持，查询中的尺寸和参数（“205/55 r16”“5x112”“冬季”）会变成筛选条件。

目录中新增和修改的商品会在上传商品源或发出 API 请求后一分钟内进入搜索。

为您网站的搜索字段添加 data-cdp-search 属性：

<form action="/search">
  <input name="q" data-cdp-search data-category-url="/catalog/{id}">
</form>

输入时，字段下方会出现联想提示：网站的热门搜索、匹配的分类，以及带图片和价格的商品。可以用方向键浏览，Enter 打开所选行，Esc 关闭提示。未选择任何行时按 Enter，会照常提交网站表单。

属性	作用
`data-cdp-search`	为字段启用联想提示
`data-category-url`	分类页面链接，`{id}` 会替换为目录分类的 id；没有此属性时，提示中不显示分类
`data-search-url`	不在表单中的字段所用的结果页地址，`{query}` 会替换为查询内容

联想提示使用网站的字体，不含界面文字，因此适用于任何语言的网站。

结果页

现成的网店插件会自动将结果填入商店的搜索页。在您自己的网站上，请通过追踪器获取商品：

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items — 商品，result.total — 找到的数量，result.facets — 用于筛选的分类、品牌、价格和特征
});

参数：category、brand、priceMin、priceMax、sort（relevance、popular、price_asc、price_desc）、page、perPage、attributes。点击商品时，请调用 cdp.searchResultClicked(商品)。

特征筛选。 result.facets.attributes 中是店铺行业的特征，带有访客语言的名称以及每个取值对应的商品数量，例如“轮辋直径（英寸）”：16、17、18。将所选取值传入 attributes：cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } })。同一特征的多个取值按“或”组合，不同特征之间按“且”组合。result.filters 中是从查询文本中识别出的尺寸和参数：请将它们展示给访客，让访客知道结果为何被筛选。需要追踪器 1.15.0。

如果该搜索词设置了重定向规则（参见搜索词规则），result.redirect 中为页面地址：请打开该页面，而不是显示结果。

服务器可以使用写入密钥发起相同的请求：https://cdp.onetrace.ru/api/v1/search 和 https://cdp.onetrace.ru/api/v1/search/suggest。完整的参数列表请参阅 API 参考：https://cdp.onetrace.ru/api/v1/openapi.json。

搜索词报告

“网站”部分的搜索选项卡显示访客在过去 7、30 或 90 天内在您的网站上搜索了什么：

搜索次数和访客——搜索了多少次、有多少不同的人搜索。
无结果——什么都没找到的搜索所占比例。
点击率——在自己搜索词的结果中点击了商品的访客比例。
购买和收入——在搜索结果中被点击、并由同一顾客在 7 天内购买的商品。收入按目录中的商品价格计算。在推荐设置中设置了购买事件时显示，参见推荐和商品目录。

图表下方的表格：

表格	内容
热门	按搜索次数排列的搜索词
无结果	从未找到任何结果的搜索词：提示缺少哪些商品或同义词
低点击率	至少搜索 5 次且点击率低于 10% 的搜索词：结果不符合预期

比较搜索词时忽略大小写和多余空格。您可以直接从表格行为搜索词添加同义词或规则。

同义词

同义词是一起搜索的词和短语：包含组内任一词的搜索也会按其他词查找商品。例如，有了“运动鞋, 球鞋, sneakers”这组同义词，搜索“白色球鞋”也会找到白色运动鞋。

双向组——每个词都按其他词搜索。
单向组——只有第一个词按其他词搜索：“苹果手机 → iphone”在搜索“苹果手机”时会找到 iPhone，但搜索“iphone”不会按“苹果手机”查找。

只有当组内的词或短语在搜索词中完整出现时才会被替换。同义词保存后立即生效，适用于搜索结果和建议。每个项目最多 500 组，每组最多 20 个词。

搜索词规则

当访客搜索的正是该搜索词（忽略大小写、多余空格和首尾标点）时，规则生效，并执行以下一项或两项操作：

置顶商品——最多 24 个商品按您设定的顺序显示在结果顶部，即使搜索本身找不到它们。其他结果紧随其后，不会重复。置顶在按相关性排序且未筛选时生效；缺货商品不显示。
重定向——打开您网站的某个页面，而不是显示结果，例如“配送” → 配送条款页面。

重定向由跟踪器的搜索框（对有规则的搜索词按 Enter）、您自己结果页面上的 cdp.search()（redirect 字段）以及 WooCommerce 和 Magento 2 插件执行。每个项目最多 1000 条规则。

统计

追踪器会记录两个事件：

事件	时机
`search`	显示了第一页结果；属性 `query` 为查询内容，`results` 为找到的数量
`search_result_clicked`	在结果或联想提示中点击商品；属性 `query`、`product_id`、`position`、`source`

提示中的热门搜索由 30 天内的 search 事件汇总而成。这些事件可在客户的档案卡片中查看，也可在分群中使用，例如“搜索过但未购买”，参见分群。