# 添加目录列表

> 直接从 Unity Dashboard（Unity 后台）在目录中创建新列表。

在 Unity Dashboard（Unity 后台）中，可在 **Add catalog listing（添加目录列表**）对话框中创建和配置单个目录列表。

## 添加目录列表##add-a-catalog-listing

在 Unity Dashboard（Unity 后台）中打开 **In-App Purchase（应用内购**）以添加目录列表：

1. 选择 **Catalog**（目录）> **Add catalog listing（添加目录列表**）。
2. 配置目录列表。请参阅[添加目录列表参考](#add-catalog-listing-reference)。
3. 选择 **Add（添加）**。

## 添加目录列表参考##add-catalog-listing-reference

请参阅下表以了解您的配置选项。

### 添加目录列表字段##add-catalog-listing-fields

**Add catalog listing** 对话框包含以下字段。

| **字段**          | **必需**       | **描述**                                                                                                 |
| :-------------- | :----------- | :----------------------------------------------------------------------------------------------------- |
| **目录列表 ID**     | 是            | 设置此列表的唯一标识符，与 **uSKU** 不同。Dashboard（后台）使用此值作为配置文件名称。同一游戏内物品可以有多个列表，每个列表都有一个唯一的列表 ID。                   |
| **uSKU**        | 是            | 设置商品的唯一标识符 (SKU)，用于标识购买后要授予的游戏内奖励。同一 uSKU 可以出现在多个列表中。更改此值可能会影响现有的收据解析。                                 |
| **Type（类型）**    | 是            | 设置商品类型。选择 **Consumable**（对于玩家可重复购买的物品）、\*\*Non-consumable（\*\*对于一次性购买）或 \*\*Subscription（\*\*对于经常性购买）。 |
| **图像 URL**      | 否            | 设置列表卡上显示的图像的 URL。                                                                                      |
| **Webshop 可用性** | 对于网上商店列表是必需的 | 选择 **Sell this SKU on Webshop** 时，使此商品清单在 Webshop 目录中可用。                                               |

如果启用 **Webshop 可用性**，以下 Webshop 部分也适用于列表：

* [网上商店推荐](#webshop-promotions)
* [Webshop 标示](#webshop-badge)
* [Webshop 字段](#webshop-fields)
* [Webshop 定价](#webshop-pricing)

有关网上商店列表的更多信息，请参阅 [Catalog and payments in webshops](../webshop/catalog-and-payments)（目录和付款）。

#### 网上商店推荐##webshop-promotions

以下字段仅在启用 **Webshop 可用性**时适用。

| **字段**           | **必需** | **描述**                                                                                                                                                                                 |
| :--------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **网上商店推荐**       | 否      | 将推荐处理应用于网上商店中的推荐卡。选择 **None**、**Sale**、**Bonus** 或 **Limited**。**Sale** 会自动填充具有基础价格和网上商店价格之间百分比差异的\*\* Badge 文本\*\*。**Limited** 自动填充结束日期之前剩余时间的 **Badge 文本**。您可以在**商品详细信息**中覆盖自动填充的文本。 |
| **Schedule（排期）** | 否      | 如果选择网上商店推荐，则会设置**开始日期**和**结束日期**，用于控制推荐处理的显示时间。使用 `MM/DD/YYYY hh:mm` 格式。仅在设置**网上商店推荐**时适用。                                                                                             |

### 本地化##localization

**Localization** 部分包含以下字段。

| **字段**   | **必需** | **描述**                                                  |
| :------- | :----- | :------------------------------------------------------ |
| **主要语言** | 是      | 设置列表显示详细信息的默认语言。选择 **+ Language** 可将另一种语言添加到列表中。        |
| **本地化**  | 否      | 列出为列表添加的区域设置。在添加语言之前显示**未添加区域**设置。添加一个区域设置以提供本地化显示详细信息。 |

### 产品详细信息##product-details

**商品详细信息**部分包含以下字段。选择字段旁边的 **Localize** 可为每种添加的语言提供值。

| **字段**    | **必需** | **描述**           |
| :-------- | :----- | :--------------- |
| **Title** | 是      | 设置向玩家显示的列表显示名称。  |
| **副标题**   | 否      | 设置与标题一起显示的可选辅助行。 |
| **描述**    | 否      | 设置列表面向玩家的描述。     |

#### 网上商店标示##webshop-badge

仅当选择 **Sell this SKU on Webshop 时**，以下字段才适用：

| **字段**       | **必需** | **描述**                                               |
| :----------- | :----- | :--------------------------------------------------- |
| **边框文本**     | 否      | 设置列表卡上显示的芯片的文本，最多 32 个字符。自动填充用于网上商店销售和限时列表，但可以在此处覆盖。 |
| **边框图像 URL** | 否      | 为标示文本旁边显示的图标设置可选`imageUrl`的 URL。                     |

### 定价##pricing

**Pricing** 部分包含以下字段。

| **字段**    | **必需** | **描述**                                                            |
| :-------- | :----- | :---------------------------------------------------------------- |
| **基础价格**  | 是      | 设置为列表收取的价格。至少需要一个`USD`价格。选择 **Add** (**+**) 可添加货币，或选择计算器可从其他货币转换。 |
| **本地化价格** | 否      | 列出为列表添加的每种货币的价格。显示添加货币之前**不添加货币**。                                |

### Store ID 覆盖##store-id-overrides

**Store ID overrides** 部分包含以下字段。使用这些字段可将列表映射到特定于商店的商品 ID。只能将这些字段用于平台原生商店。

| **字段**              | **必需** | **描述**                             |
| :------------------ | :----- | :--------------------------------- |
| **Apple App Store** | 否      | 设置要在 Apple App Store 中用于此列表的商品 ID。 |
| **Google Play**     | 否      | 设置要在 Google Play 中用于此列表的商品 ID。     |

### Webshop 字段##webshop-fields

**Webshop** 部分包含以下字段。这些字段仅在启用 **Webshop 可用性**时适用。

| **字段**          | **必需**       | **描述**                                                                    |
| :-------------- | :----------- | :------------------------------------------------------------------------ |
| **Webshop 类别**  | 对于网上商店列表是必需的 | 将列表项分配给一个网上商店类别。选择为网上商店定义的类别。一个列表最多可以属于 16 个类别。                           |
| **SKU 显示顺序**    | 否            | 设置列表在商店中的显示顺序。较低的值首先出现。                                                   |
| **hdImage URL** | 否            | 设置列表详细信息对话框中显示的高分辨率图像，以及可选的 **Alt 文本**。选择 **Add** (**+**) 可添加更多图像，最多 8 张。 |

### Webshop 定价##webshop-pricing

**Webshop 定价**部分包含以下字段。这些字段仅在启用 **Webshop 可用性**时适用。

当您设置的网上商店价格低于基本价格时，系统会自动应用`N% OFF`标示。您可以使用**商品详细信息**中的 **Badge 文本**覆盖它。

| **字段**            | **必需**       | **描述**                                        |
| :---------------- | :----------- | :-------------------------------------------- |
| **Webshop 基础价格**  | 对于网上商店列表是必需的 | 设置网上商店上显示的价格，该价格可能与**基本价格**不同。选择要从其他货币转换的计算器。 |
| **Webshop 本地化价格** | 否            | 列出为列表添加的每种货币的网上商店价格。显示添加货币之前**不添加货币**。        |
