# 商品搜索插件

{% hint style="info" %}
您需要先在「数据集成」>「商品 Feed」中添加好至少一个验证通过的商品 Feed，才可以成功使用这个插件。如果您还没有创建，可以点击下方链接查看如何创建。👇
{% endhint %}

{% content-ref url="../untitled/shang-pin-feed" %}
[shang-pin-feed](https://bothub.gitbook.io/project/bothub.ai-2.0/untitled-2/untitled/shang-pin-feed)
{% endcontent-ref %}

## 这个插件能做什么

* 设置不同的方式来搜索到相应的商品（关键词、属性值、ID）
* 设置商品的排序方式（录入时间、价格等）
* 设置商品显示的模板

## 如何使用这个插件

下面，我们来具体介绍一下上述功能如何实现

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXBJNQcw2NOZ4HmiMF%2F-LCXBKyfkq9NU3hqGm2H%2Fimage.png?alt=media\&token=10adfe3b-6cb2-405c-91eb-53657898f7bc)

### 搜索范围

默认选择在所有商品 Feeds 中搜索，您也可以选择在某一个特定的商品 Feed 中进行搜索

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXa8A_Pef3T3224Ab7%2F-LCXaJ06iPworSgMH6_i%2Fimage.png?alt=media\&token=b812224b-d406-4b68-b0b6-d37a884a8a61)

### 搜索方式

默认选择在所有商品 Feeds 中搜索，您也可以选择在某一个特定的商品 Feed 中进行搜索

**1.关键字**

设置特定的关键字，则**商品名称**中包含这个关键词的商品会显示出来

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXa8A_Pef3T3224Ab7%2F-LCXaS7lMx3XbcKSCXn-%2Fimage.png?alt=media\&token=57e29ab6-4baf-46e4-9acf-114cf4cb58ad)

![名称中包含“Hello”这个关键词的商品会显示出来](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXaU7bRe4NUj6REMEn%2F-LCXar10_Dp2ou0Zak98%2Fhello.JPG?alt=media\&token=8ee3457a-440f-4488-af95-f4b7abb930b4)

**2.属性值**

设置特定的属性值（需要您先添加扩展字段，具体方式[点此查看](https://bothubdocs.gitbook.io/project/~/drafts/-LCXD4V48QFe4aZ9WMWR/primary/untitled-2/untitled/shang-pin-feed#ru-he-zai-feed-zhong-tian-jia-kuo-zhan-zi-duan)），将包含该属性值的商品显示出来

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXZDUrpN18zxvnnR28%2F-LCXZXin5Ayz42seShT3%2Fimage.png?alt=media\&token=17a28be5-fe82-4d63-a2b5-0cdf3cac41e7)

![属性值中包含“panpan”这个关键词的商品会显示出来](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXaU7bRe4NUj6REMEn%2F-LCXawcOyGoLkgYA0WTz%2F%E5%B1%9E%E6%80%A7%E5%80%BC.JPG?alt=media\&token=21bc05b8-0367-4c59-9234-26daa58d3f65)

**3.ID**

设置一个商品 ID（\`item\_group\_id\`），将符合该 ID的所有商品显示出来

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXZDUrpN18zxvnnR28%2F-LCXZrsAIKrYpolyVzBi%2Fimage.png?alt=media\&token=2dcfd309-1832-41f6-8a9f-629386744866)

![\`item\_group\_id\`为“ECHO123”的商品会全部以 SKU 的形式显示出来（如果选择了“在 Group 中”则只会显示一个商品卡片）](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXaU7bRe4NUj6REMEn%2F-LCXb2EzXCwV37ZO4-u_%2Fid.JPG?alt=media\&token=5c77f8e3-ebd5-4cb1-b854-3f70b4ac9cab)

**在 Group 中 & 在 SKU 中**

* 在 Group 中：选择此项，则搜索结果会以 Group 的形式呈现
* 在 SKU 中：选择此项，则搜索结果会以 SKU 的形式呈现

### 排序方式

提供了多种排序方式供您选择，选择一个排序方式后商品便会按照该排序规则进行显示。目前支持的排序方式有：

* 录入时间：指录入的商品的时间顺序
* 价格：指商品价格
* 优先级：指录入时的商品 ID 序号顺序

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCX_-9eWRO5zGGooCdJ%2F-LCX_NL8U48qIaSxvvxg%2Fimage.png?alt=media\&token=35612692-61b3-42b0-b956-2ee5394126b6)

![实际的商品会按照价格从低到高排序](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCX__uIdi6_VfLNInF_%2F-LCX_dMzWPiU-ywOwq6Z%2FArtboard.png?alt=media\&token=66f80e42-9517-4258-ab25-ab0da13c245a)

### 显示模板

**1.布局**

根据您的商品图片比例，来选择合适的布局（长方形布局适用于**横图，**&#x6B63;方形布局适用于**竖图**）

**2.卡片模板**

该插件支持以“模板”的形式编辑您的商品卡片。我们已经为您预置好了最实用的模板样式，您也可以根据您的需求修改您需要的内容（比如按钮文字等）。

模板支持使用参数，您可以在下方的表格中查看所有支持的参数。

![修改了“布局”和按钮名称](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCX__uIdi6_VfLNInF_%2F-LCX_v9xNNI5w3qg6V2j%2Fimage.png?alt=media\&token=4d8a4423-1ff6-4b02-bd93-22304b20ebc1)

![修改了模板后，实际按照“正方形布局”显示，且按钮文本也相应更新了](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCX__uIdi6_VfLNInF_%2F-LCXa-INNdDlR80pMIdg%2FTEMPLATE.png?alt=media\&token=18b29817-0afb-48ab-9fe8-739a1c1b593d)

### 显示模板中支持的参数

| 参数                         | 说明                           |
| -------------------------- | ---------------------------- |
| {{product\_id}}            | 商品组 ID（即\`item\_group\_id\`） |
| {{sku\_name}}              | 商品名称（80个字符以内）                |
| {{sku\_description}}       | 商品描述（80个字符以内）                |
| {{sku\_image}}             | 商品图片链接                       |
| {{sku\_url}}               | 商品链接                         |
| {{sku\_price}}             | 商品价格(纯数字，可能是最多2位的小数，不包括货币)   |
| {{sku\_currency}}          | 商品货币(例如USD, CNY)             |
| {{sku\_weight}}            | 商品重量，纯数字不包含单位                |
| {{sku\_stock}}             | 商品库存（纯数字，不包括量词）              |
| {{sku\_*purchase\_limit*}} | 商品购买限制（纯数字，不包括量词）            |

### 搜索结果为“空”时

您的用户在使用 Bot 搜索商品的时候，搜索结果很有可能是没有满足其要求的商品。因此我们提供了特殊情况设置的选项，即需要您设置“若没有商品”时，需要显示的内容块。

![选择一个已创建的内容块即可](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXbTxhZ-dRPHRHcfzX%2F-LCXbciaKaUl3qP2pM2s%2Fimage.png?alt=media\&token=fbc90340-3930-48e0-8142-0fc6de48b7b1)

### 最重要的一步：保存！💾

设置好了插件里的各项内容后，请不要忘记点击插件右下角的“保存”来使插件生效。

![保存保存保存](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCXbTxhZ-dRPHRHcfzX%2F-LCXc-DEZ1qXnhhz2Eks%2Fimage.png?alt=media\&token=1758c9c5-de0c-4fbc-81ce-cfd942498eec)
