本页面提供了创建目录信息和填充目录数据的最佳做法。
概览
导入零售行业的 Vertex AI Search 中的目录数据会对 质量，进而影响搜索和 推荐结果。通常，您提供的目录信息越准确、具体，您的模型质量就越高。
您的目录应保持最新。您可以根据需要随时上传目录更改；理想情况下，对于变化率较高的目录，每天都应该如此。您可以上传（补丁）现有产品项；系统只会更新更改后的字段。上传目录信息不收取任何费用。如需了解详情，请参阅使目录保持最新状态。
目录分支
如果您使用搜索功能，则可以使用目录分支测试您离线上传的新数据，然后在您的网站上发布。
您最多可以使用三个分支，标识为 0、1 和 2。实际网站指向其目录数据的 default_branch。指定哪个分支当前是您的活动 default_branch（默认设置为
分支 0）使用 setDefaultBranch 或
Search for Retail 控制台。然后，您的网站会使用所提供的目录数据
由 default_branch 指向的分支指定。
例如，假设 default_branch 设置为分支 ID 0，因此您的网站正在使用已上传到该分支的目录数据。您可以将新的目录数据上传到分支 1 并进行预览。确认目录已正确上传后，您可以切换到分支 1 作为实际 default_branch。
在切换分支后，目录缓存最多可能需要 30 分钟才能更新。
如果您使用“建议”，建议您仅使用默认 更新分支。如果分支之间的数据差异很大，更新延迟可能会对预测结果产生负面影响。
产品
目录是一系列产品对象的集合。
必需的产品信息
以下字段为必填字段；在目录中创建产品项时，您必须提供这些值。它们还应与您内部产品数据库中使用的值对应，并且应准确反映所表示的产品，因为它们包含在训练模型中。
在某些情况下，还需要填写其他字段。如需查看所有产品字段的完整列表，请参阅 Product 参考页面。
您提供的所有商品信息都可以用来提高推荐内容和搜索结果的质量。请务必提供尽可能多的字段。
| 字段 | 备注 |
|---|---|
name
|
产品的完整、唯一资源名称。必需（针对所有广告）
Product 方法（import 除外）。中
导入时，该名称是自动生成的，无需
。
|
id
|
产品数据库使用的产品 ID。ID 字段在整个目录中必须是唯一的。记录用户事件时，也会使用同一个值，predict 和 search 方法也会返回该值。 |
title
|
产品数据库中的产品标题。UTF-8 编码的字符串。字符数不得超过 1250 个。 |
categories
|
商品类别。每件商品都必须分配到至少一个类别。
如果某件商品属于多个类别，请为每个类别重复填写此字段。
该值必须是非空的 UTF-8 编码字符串，长度限制为
5,000 个字符。始终指定完整的类别路径，例如：
["Sports & Fitness > Athletic Clothing > Shoes"]。
|
商品特性
强烈建议您在 Product 中为预定义系统特性提供值，如品牌、颜色和尺寸。您还可以添加使用 Product.attributes 定义的自定义特性。
如果您使用搜索，商品会包含属性。
（如果您在搜索响应中将其标记为可检索），
Product.retrievableFields。然后这些特性可用于其他搜索功能，例如过滤和构面。
如需了解详情，请参阅商品属性简介。
产品级别
商品 SKU 指定决定了目录中的层次结构。
产品标识类型
商品指定类型有三种：
主要项会在推荐内容或搜索结果中返回。 主要资源可以是单独的（SKU 级）商品和群组 （SKU 组）。
变体项是 SKU 组主商品的各个版本。变体 只能是单独的（SKU 级）商品。例如，如果主商品是“V 领衬衫”，变体可能是“棕色 V 领衬衫，XL 码”和“白色 V 领衬衫，S 码”。主项和变体有时被称为父项和子项。
合集项是商品的集合。合集是主要商品或款式/规格商品的套装。例如，集合可以是包含项链、耳环和戒指的珠宝套装。集合只能 只可在搜索中使用，且未得到广泛使用。
商品示例
根据这些商品指定类型，例如，日杂商品将由 "bananas, fresh" 等单 SKU 商品组成。
另一方面，最好将 T 恤按层次结构进行设置，将其作为主要商品，并附上相应的一组款式/规格。每个变体代表一个 SKU（每个尺寸一个），每个主要商品代表一组 SKU，其中每个 SKU 都是一个总体 T 恤款式的不同尺寸。这种按 SKU 结构进行分组的组织方式让搜索结果和推荐面板可以显示各种 T 恤款式。买家可以通过它展开特定的主要（样式）细目，以选择款式/规格 (size) 即可购买。
此外，还有一种仅包含款式/规格的目录类型，但目前已废弃。此目录
只能与建议搭配使用。对于仅含款式/规格的商品
目录中，ingestionProductType 会在导入期间设置为 variant。主要
系统会根据为每个款式/规格指定的主要商品 ID 来推断出每个款式/规格
变体。
设置商品清单
规划产品目录时，您需要确定目录中包含的商品是仅指定为主项、主项和变体，还是这两种安排的混合。不妨从商品的 SKU 结构方面考虑。您的商品可以是主商品，主商品不一定有款式/规格。
根据您指定商品 SKU 的方式，考虑设置商品目录的选项：
- 您希望自己的 SKU 显示为单个搜索结果或建议：SKU=primary
- 您的 SKU 应属于一组类似的 SKU：SKU=variant、SKU 组=主要
这两种组合混合使用：SKU=主要，SKU=变体，SKU 组=主要
如果您的商品详情页面上显示的是选项/尺寸/颜色选择器，则这些选项通常作为不同款式/规格上传到您的商品目录中。考虑您是否希望尺寸和颜色等不同属性的同一商品的不同类型显示为单个搜索结果或单独的搜索结果。例如，对于某本图书，您想决定是将同一图书的精装版 SKU 和简装版 SKU 作为单独的搜索结果显示（SKU = 主要搜索结果），还是显示为一个搜索结果（SKU = 变体，SKU 组 = 主搜索结果）。
设置商品目录时，请注意推荐内容和搜索结果只会返回主商品。
最少的主要商品
如果您确定您的目录应同时包含原版和变体， 也就是 SKU 群组和 SKU，而您现在只有 SKU，则需要创建 SKU 群组的初选者。这些主元素有时被称为“虚拟主元素”或“虚假主元素”。
这些主实例只需要包含最基本的信息：id、title 和
categories。
如果未指定 type，则商品类型默认为主要商品。如果您要导入，则无需指定 name。如需了解详情，请参阅
上一部分必需的商品信息。
类型不可变
您无法更改商品的类型，例如，将变体更改为主商品，或将主商品更改为变体。
如果您确实需要更改商品的类型，请删除该商品，然后使用其他类型重新创建商品。您必须先删除关联的款式/规格，然后才能删除主商品。
目录导入
如果您在 Merchant Center 中拥有产品目录 建议您通过将 Merchant Center 账号。
如果您的目录不在 Merchant Center 中，而是在 Cloud Storage、BigQuery 或其他存储空间中，请执行批量数据导入。
如果您打算将来从 Merchant Center 导入目录数据，请按照 Merchant Center 导入的说明检查数据，以确保您对目录做出正确的选择。这很重要 因为更改现有目录的配置需要删除 然后再重新上传 更改产品级配置）。
如需详细了解如何上传目录，请参阅导入目录 信息。
商品目录
商品目录包含：
价格，包括现价和原价
库存状况，例如有货、缺货、缺货待补和预订
可售数量
履单信息，例如店内自提、店内取货和次日送达
商品目录分为两个级别：商品级和本地。
商品级目录
对于仅在线上销售的零售商，商品目录是在商品一级指定的。您需要为 目录。
如需详细了解商品级商品目录（包括如何维护商品目录数据），请参阅更新 Vertex AI Search 零售解决方案的商品目录。
本地商品目录
拥有实体店和网店的零售商需要 显示每个商店的商品目录信息。它们使用本地商品目录来实现这一点。
有两个商品字段可用于存储本地商品目录。两者都有 字段会列出包含相关商品目录信息的地理位置（地点 ID）：
Product.fulfillmentInfo.取货方式和送货方式位于 每个商店的位置
Product.localInventories。每个实体店位置的价格信息、商品属性以及自提和配送方式
您可以使用其中一个或两个字段来提供商店级信息。
如需详细了解本地商品目录，请参阅更新 Vertex AI Search for Retail 的本地商品目录。
目录数据质量指标
Search for Retail 控制台中的数据质量页面会评估您是否需要更新目录数据，以提升搜索结果的质量并解锁搜索效果层级。
下表介绍了 Vertex AI Search for Retail 用于帮助您评估商品数据的质量指标。详细了解如何查看数据质量 Search for Retail 控制台中的指标和搜索效果层级， 请参阅了解搜索效果层级。
| 目录质量指标 | 质量规则 | 备注 |
|---|---|---|
| 存在 URI 且可访问 | 商品具有有效的 Product.uri。URI 必须可访问且与您的网域匹配。 |
Google 搜索会利用通过此 URI 抓取的网络信号来提高搜索质量。 |
| 符合时间一致性 | Product.availableTime 早于当前时间，Product.expireTime 晚于当前时间。 |
只有符合时间一致性的商品可供搜索。 |
| 存在可搜索特性 | 商品至少有一个设置为可搜索的 attribute。 |
标记为可搜索的自定义特性可通过文本查询进行搜索。 |
| 说明存在 | 产品包含非空的 Product.description。 |
全面的说明有助于提高搜索质量。 |
| 标题至少包含两个字词 | Product.title 至少包含两个字词。 |
全面的标题有助于提高搜索质量。 |
| 包含不同的图片 | variant 商品至少有一个 Product.image。如果您的所有商品均处于 primary 级别，则您可以忽略此指标。 |
该指标仅供参考，不会影响搜索质量。 |
| 包含不同的价格信息 | variant 商品设置了 Product.priceInfo。如果您的所有商品均处于 primary 级别，则您可以忽略此指标。 |
该指标仅供参考，不会影响搜索质量。 |
Vertex AI Search for Retail 的产品架构
从 BigQuery 导入目录时，请使用下方的 Vertex AI Search for Retail 产品架构创建一个格式正确的 BigQuery 表，并将其与您的目录数据一起加载。然后，导入目录。