# 商品显示插件

想要在自己的 Messenger 里直接售卖商品，如何批量导入这些商品呢？[商品 Feed](https://bothubdocs.gitbook.io/project/~/edit/drafts/-LCSGofMAEV9JH_Gus5r/untitled-2/untitled/shang-pin-feed) 可以帮助到您。\
那如何将这些批量导入的商品再批量地在 Messenger 端显示呢？如何根据不同的商品类别显示不同的商品呢？**商品显示插件**可以帮助到您。\
下面，让我们一起来探索一下如何通过商品显示插件帮助您实现上述目的。

## 标签设置

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCTP74r2kiHQREtcIPb%2F-LCTSXaRKoDOnAzqT16u%2Fp3f1p1201.jpg?alt=media\&token=3b25ccd8-252d-496c-af5b-db7623e0476d)

我们的后台目前提供了两种商品显示方式（如上图）：

* 每个商品显示**默认** SKU 即每个商品（product）仅显示一个默认设置的 SKU；选择了此种商品显示方式，可以根据商品标签对商品进行筛选，显示符合标签的商品； 支持输入多个标签，在输入框输入后按“回车”键↩️即可完成一个标签的输入。

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCTP74r2kiHQREtcIPb%2F-LCTQZWncNN9FPfQNibW%2Fp3f1p1202.jpg?alt=media\&token=3cbc7405-a52f-48bc-9d4a-f0591d136810)

* 每个商品显示**所有** SKU 即每个商品（product）依次显示所有的 SKU； 选择此种商品显示方式，可以根据商品 ID 对商品进行筛选，显示符合 ID 的商品。

**这里，我们仅支持输入以下两种 ID 形式：**

1. 单一固定的商品 ID：只显示符合这个 ID 的商品，通常情况下一个 ID 对应一个商品。
2. 商品 ID 变量：例如 ，这时则会显示符合这个变量的所有商品。

## 排序方式

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCTP74r2kiHQREtcIPb%2F-LCTRyumnQJKLNfxnB_d%2Fp3f1p1203.jpg?alt=media\&token=6d016b94-3e79-4d01-bc54-0089ec8ecdae)

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

* 按照录入时间从低到高
* 按照录入时间从高到低
* 按照价格从低到高
* 按照价格从高到低
* 按照销量从低到高
* 按照销量从高到低
* 按照优先级从低到高（选择此排序方式，将会按照您在后台录入商品时自定义的排序方式进行排序）
* 按照优先级从高到低（选择此排序方式，将会按照您在后台录入商品时自定义的排序方式进行排序）

## 显示模版

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCTP74r2kiHQREtcIPb%2F-LCTSfVBD40-oQKsFpNB%2Fp3f1p1204.jpg?alt=media\&token=b326d750-d674-4765-bcfa-0d5965bfeea5)

我们目前对商品的显示提供一个通用模板，只要编辑好模板，便可以轻松地批量生成多个商品的橱窗卡片。

***图片***：显示模板里的图片地址是无需您再设置的，我们的系统会根据商品自动读取图片。但您仍可以更改商品图片的尺寸以保证良好的显示效果。

***大小标题：***&#x6211;们对模板里的标题提供了默认的参数（目前支持的参数查看本文最下方表格），同时模板里的标题仍是可编辑的，您可以自定义想要呈现的内容。

***按钮：***&#x6309;钮里所有可编辑文本与网址都支持参数（目前支持的参数查看本文最下方表格）

1. 购买按钮：由于显示模板会自动读取商品信息，因此目前购买按钮不支持选择具体的商品，但您可以对“当用户不支持购买时”这一情景进行相应设置。
2. 支持根据不同商品类型显示不同按钮：Facebook Messenger 里显示的橱窗卡片最多允许添加三个按钮，但考虑到商品的特殊性，即不同商品会带有不同的属性，因此在显示模板里我们允许您添加超过三个最多五个按钮。这些按钮会按照您的添加顺序依次显示，如果当前按钮不符合显示规则时，我们将会隐藏这个按钮继而显示下一个按钮，以此来达到您个性化设置的目的。
3. 特殊情况设置： 您的用户在使用 Bot 搜索商品的时候，搜索结果很有可能是没有满足其要求的商品，这是我们建议您最好设置一些内容对这个情况做出说明。因此提供了特殊情况设置的选项，即需要您设置“若没有商品”时，需要显示的内容块。

***特殊情况设置：*** 您的用户在使用 Bot 搜索商品的时候，搜索结果很有可能是没有满足其要求的商品，这是我们建议您最好设置一些内容对这个情况做出说明。因此提供了特殊情况设置的选项，即需要您设置“若没有商品”时，需要显示的内容块。

{% hint style="info" %}
您进行完所有设置后，不要忘记点击插件右下角的“保存”按钮来完成设置。
{% endhint %}

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCTP74r2kiHQREtcIPb%2F-LCTUsQFjeHsnDU8V9xP%2Fp3f1p1205.jpg?alt=media\&token=c69621e4-b5ec-4a27-91f4-eca6ebf5770e)

## 支持的参数

下表参数在使用时请在前后加花括号👇

| **参数**               | **说明**                     |
| -------------------- | -------------------------- |
| product\_id          | 商品 id                      |
| sku\_name            | 商品名称 (80字以下)               |
| sku\_description     | 商品描述（80字以下)                |
| sku\_image           | 商品图片链接                     |
| sku\_stock           | 商品库存（纯数字，不包括量词）            |
| sku\_purchase\_limit | 商品购买限制（纯数字，不包括量词）          |
| sku\_url             | 商品链接（通常是通往官网或Amazon等）      |
| sku\_price           | 商品价格(纯数字，可能是最多2位的小数，不包括货币) |
| sku\_currency        | 商品货币(例如USD, CNY)           |
| sku\_weight          | 商品重量，纯数字不包含单位              |
