# 商品搜索插件 {% hint style="info" %} 您需要先在「数据集成」>「商品 Feed」中添加好至少一个验证通过的商品 Feed，才可以成功使用这个插件。如果您还没有创建，可以点击下方链接查看如何创建。👇 {% endhint %} {% content-ref url="../product/product-feed" %} [product-feed](https://bothub.gitbook.io/project/advanced-tool/product/product-feed) {% endcontent-ref %} ## 这个插件能做什么 * 设置不同的方式来搜索到相应的商品（关键词、属性值、ID） * 设置商品的排序方式（录入时间、价格等） * 设置商品显示的模板 ## 如何使用这个插件 下面，我们来具体介绍一下上述功能如何实现 ![](https://3545383198-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://3545383198-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://3545383198-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://3545383198-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/untitled-2/untitled/shang-pin-feed#ru-he-tian-jia-kuo-zhan-zi-duan)），将包含该属性值的商品显示出来 ![](https://3545383198-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://3545383198-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://3545383198-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://3545383198-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://3545383198-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://3545383198-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.布局** 根据您的商品图片比例，来选择合适的布局（长方形布局适用于**横图，**正方形布局适用于**竖图**） **2.卡片模板** 该插件支持以“模板”的形式编辑您的商品卡片。我们已经为您预置好了最实用的模板样式，您也可以根据您的需求修改您需要的内容（比如按钮文字等）。 模板支持使用参数，您可以在下方的表格中查看所有支持的参数。 ![修改了“布局”和按钮名称](https://3545383198-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://3545383198-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) ### 显示模板中支持的参数 | 参数 | 说明 | | -------------------- | -------------------------- | | {{sku\_title}} | 商品名称（80个字符以内） | | {{sku\_description}} | 商品描述（80个字符以内） | | {{sku\_image\_link}} | 商品图片链接 | | {{sku\_link}} | 商品链接 | | {{sku\_price}} | 商品价格(纯数字，可能是最多2位的小数，不包括货币) | ### 搜索结果为“空”时 您的用户在使用 Bot 搜索商品的时候，搜索结果很有可能是没有满足其要求的商品。因此我们提供了特殊情况设置的选项，即需要您设置“若没有商品”时，需要显示的内容块。 ![选择一个已创建的内容块即可](https://3545383198-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://3545383198-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)