本地促销活动的数据源规范

您为本地促销活动提供的信息会分发到“购物”标签页上的本地广告中，并在桌面设备和移动设备上展示。为此，您需要上传促销活动来源，其中包含用于实体店促销的相关信息。这些信息应准确无误，并包含所有用于说明本地促销活动的属性。

数据源是上传到 Google Merchant Center 的 XML 文件、制表符分隔文件或 Google 电子表格，可以包含多个条目。请将促销活动来源上传到商品数据源所用的 Merchant Center 账号。

注意：同一促销活动来源可同时用于线上和实体店促销。

在本文中，您将了解针对本地促销活动的促销活动来源的适用属性。如需查看促销活动来源示例，请点击下方按钮。

下载数据源示例

注意事项

• 我们会根据促销计划政策和编辑要求来审核所有促销活动。
• 建议您将结构化数据属性应用于通过促销活动来源提交的优惠。详细了解结构化数据属性。
• 本地促销活动不接受与运费有关的优惠。
• 提供促销活动来源不会影响 Google 上的任何排名。

必需属性

促销 ID [promotion_id]

此属性是促销活动的唯一 ID。对于指定商品的实体店促销，促销活动来源中的“promotion_id”值应与商品数据源中的“promotion_id”值一致。这样 Google 就可以确定将促销活动应用于哪些商品。

重要提示：

• 促销 ID 区分大小写。两种数据源中的促销 ID 必须完全一致，才可将特定促销活动映射到商品数据源中的一组商品。
• 促销 ID 不得包含空格或符号（例如 %、! 等）。
• 如需为商品添加多个促销 ID 值（每件商品最多可添加 10 个），请在商品数据源的“promotion id”列提供这些值，并用英文逗号分隔开。
• 促销 ID 的长度不得超过 60 个字符。

符合促销条件的商品 [product_applicability]

此属性用于指明促销活动适用于所有商品还是仅适用于指定商品。

有效值：

• 所有商品 [all_products]
• 指定商品 [specific_products]

重要提示：

• 如果将此值设置为 specific_products，系统会使用商品定位属性来确定促销活动适用于哪些商品（如需了解商品定位，请参阅下文中的可选属性）。
• 如果将此值设置为 all_products，系统会忽略商品定位过滤条件。

必须提供优惠券代码 [offer_type]

此属性用于指明线上买家是否需要使用代码才能兑换优惠。

有效值：

• 无需代码 [no_code]
• 通用代码 [generic_code]

注意：如果将“必须提供优惠券代码”[offer_type] 属性设置为 generic_code（即所有买家通用的同一个代码），则还必须提供通用兑换码 [generic_redemption_code] 属性。

通用兑换码 [generic_redemption_code]

此属性用于指定买家在线兑换促销优惠所用的代码（例如：EXTRA20）。

重要提示：

• 如果将“必须提供优惠券代码”[offer_type] 属性设置为 generic_code，则必须提供此属性。
• 为通用兑换码 [generic_redemption_code] 属性提交的值不得超过 20 个字符。

促销活动标题 [long_title]

此属性是促销活动的完整标题。这些编辑要求介绍了标题指南和格式，并提供了符合要求和不符合要求的示例。

重要提示：

• 促销活动标题 [long_title] 应完整准确地描述促销活动。
• 不应超过 60 个字符。

促销开始日期 [promotion_effective_dates]

此属性用于指明促销活动有效的日期和时间范围。语法：

• 日期格式：YYYY-MM-DD
• 时间格式：HH:MM:SS，不包括与格林尼治标准时间相关的调整（请参阅下文）。
  • 以格林尼治标准时间 (GMT) 为准。因此，您还必须在提供的日期和时间后面附上与格林尼治标准时间相差的小时和分钟数（+HH:MM 或 -HH:MM）。
    • 例如，如果促销活动采用的是太平洋标准时间 (PST)，则需要添加“-08:00”，因为太平洋标准时间比格林尼治标准时间早 8 小时。
• 日期和时间应使用字母“T”分隔。
• 先列出开始日期 + 时间，随后列出结束日期 + 时间，中间使用正斜线 (/) 分隔。

示例：

• 如果促销有效期为美国东部标准时间 (EST) 2019 年 7 月 19 日凌晨 3:00 到 2019 年 7 月 26 日晚上 9:00，那么您应提交：
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• 如果促销有效期为格林尼治标准时间 2019 年 7 月 19 日凌晨 3:00 到 2019 年 7 月 26 日晚上 9:00，那么您应提交：
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

重要提示：

• 请务必对夏令时（如适用）进行调整：
  • 在标准时间中，“-05:00”表示美国东部标准时间，而“-08:00”表示太平洋标准时间。
  • 在夏令时期间，“-04:00”表示美国东部夏令时 (EDT)，而“-07:00”表示太平洋夏令时 (PDT)。

合格促销渠道 [redemption_channel]

此属性用于指明促销渠道。

有效值：

• in_store
• online
• online_and_in_store

重要提示：

• 如需开展全渠道促销（同时应用于线上和实体店渠道），请提交“online_and_in_store”值。
• 如果此值留空，则默认促销活动适用于线上渠道。
  • 在线促销不受地区商店辐射半径范围的限制，并且会在您的在线购物广告中展示。

商店适用性 [store_applicability]

此属性用于指明促销活动适用于所有商店还是仅适用于指定商店。

有效值：

• all_stores
• specific_stores

重要提示：

• 如果选择 specific_stores，您还必须使用“包含的实体店代码”[store_codes_inclusion] 属性或“排除的实体店代码”[store_codes_exclusion] 属性。
• 如果选择 all_stores，系统会忽略“包含的实体店代码”属性和“排除的实体店代码”属性（请参阅下文）。

促销网址 [promotion_url]

促销网址的链接必须指向您网站上可供客户查看促销活动详情的网页。这可以是您网站上介绍促销活动的页面、展示促销横幅的页面，也可以是托管促销横幅图片的页面。我们将在促销活动审批流程中使用此链接核实促销适用于当地，以及促销优惠可在实体店或路边自提点兑换。此链接还可用于核实客户在实体店内兑换促销优惠时，除了出示优惠券代码或条形码外，不需要再执行任何其他步骤。促销活动详情页面上显示的信息必须与提交的促销数据一致。

促销平台 [promotion_destination]

此属性用于指明促销活动的目标平台。

有效值：

• promotion_destination: local_inventory_ads
• promotion_destination: Shopping_ads
• promotion_destination: Buy_on_Google_listings
• promotion_destination: Free_listings

与实体店有关的属性

包含的实体店代码 [store_codes_inclusion]

此属性用于指明促销活动适用的指定商店。

重要提示：

• 如果促销活动适用于 specific_stores，请列出已提交到商家资料中的相应实体店代码。
• 您可以使用“包含的实体店代码”[store_codes_inclusion] 属性或“排除的实体店代码”[store_codes_exclusion] 属性，但不能同时使用这两个属性。

排除的实体店代码 [store_codes_exclusion]

此属性用于指明促销活动不适用的指定商店。

重要提示：

• 如果促销活动排除了 specific_stores，请列出已提交到商家资料中的相应实体店代码。
• 您可以使用“排除的实体店代码”[store_codes_exclusion] 属性或“包含的实体店代码”[store_codes_inclusion] 属性，但不能同时使用这两个属性。

可选属性

商品定位属性

商品定位属性是可选的“过滤条件”，让您可以直接在促销活动来源中指定促销活动适用的商品。

或者，您也可以通过商品数据源直接向商品添加促销 ID [promotion_id] 属性。

促销商品 ID [item_id]

此属性用于将促销活动映射到商品数据源中的指定商品。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置此商品 ID 属性会将促销活动映射到商品数据源中由关联 ID 表示的商品。

重要提示：

• 最多可以将 20 个商品 ID 映射到促销活动来源中的单个促销活动。
• 如果您想将促销活动分配给超过 20 件商品，请勿使用促销商品 ID [item_id] 属性，而是为商品数据源中的商品直接添加促销 ID。

Google 商品类别 [google_product_category]

此属性用于将促销活动映射到商品数据源中的指定商品类别。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置此 Google 商品类别 [google_product_category] 属性可将促销活动映射到指定的 Google 商品类别。

重要提示：

• 如果类别中有任何排除对象，请勿设置此属性。在这种情况下，您需要手动将促销 ID [promotion_id] 映射到商品数据源中符合条件的商品，或者使用促销商品 ID [item_id] 属性（请参阅上文）来映射促销活动来源中符合条件的商品。如需了解更多映射详情，请参阅促销活动实施指南中的为促销活动选择商品一文。
• 不支持最高层级类别，例如“服装与配饰”(166) 或“媒体”(783)。如果商品属于最高层级类别，则需要提供更精细的类别。例如：服装与配饰 > 服装 > 运动服 > 自行车运动服 (5697)。

商品类型 [product_type]

商品类型属性用于将促销活动映射到商品数据源中的指定商品类型。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置此商品类型 [product_type] 属性可将促销活动映射到一个或多个商品类型。

重要提示：

• 如果商品类型中有任何排除对象，请勿设置此属性。在这种情况下，您需要手动将促销 ID [promotion_id] 映射到商品数据源中符合条件的商品，或者使用促销商品 ID [item_id] 属性（请参阅上文）来映射促销活动来源中符合条件的商品（最多 20 件商品）。如需了解更多映射详情，请参阅促销活动实施指南中的为促销活动选择商品一文。

品牌 [brand]

品牌属性用于将促销活动映射到商品数据源中的指定品牌。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置此品牌属性可将促销活动映射到特定品牌。

重要提示：

• 最多可以指定 10 个品牌。请使用英文逗号分隔列出的每个品牌。
• 品牌区分空格和大小写，而且必须与商品数据源中的拼写完全一致。
• 如果品牌中有任何排除对象，请勿设置此属性。在这种情况下，您需要手动将促销 ID [promotion_id] 映射到商品数据源中符合条件的商品，或者使用促销商品 ID [item_id] 属性（请参阅上文）来映射促销活动来源中符合条件的商品（最多 20 件商品）。如需了解更多映射详情，请参阅促销活动实施指南中的为促销活动选择商品一文。

排除的商品 ID [item_id_exclusion]

您可以通过“排除的商品 ID”属性，将商品数据源中的指定商品从促销活动中排除。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置这个“排除的商品 ID”[item_id_exclusion] 属性会将促销活动映射到商品数据源中除此处注明的商品 ID 之外的所有商品 ID。

排除 Google 商品类别 [google_product_category_exclusion]

您可以通过“排除 Google 商品类别”属性，将商品数据源中指定商品类别的所有商品从促销活动中排除。

如果将促销活动的适用商品 [product_applicability] 属性设置为 specific_products，则设置此“排除 Google 商品类别”属性会将商品数据源中具有相同商品类别的所有商品从促销活动中排除。

重要提示：

• 如果类别中有任何符合条件的商品，请勿设置此属性。在这种情况下，您需要手动将促销 ID [promotion_id] 映射到商品数据源中符合条件的商品，或者使用促销商品 ID [item_id] 属性（请参阅上文）来映射促销活动来源中符合条件的商品（最多 20 件商品）。如需了解更多映射详情，请参阅促销活动实施指南中的为促销活动选择商品一文。

排除的商品类型 [product_type_exclusion]

您可以通过“排除的商品类型”属性，将商品数据源中的一个或多个商品类型从促销活动中排除。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置这个“排除的商品类型”[product_type_exclusion] 属性会将商品数据源中具有相同商品类型的所有商品从促销活动中排除。

重要提示：

• 最多可以指定 10 种商品类型。请使用英文逗号分隔列出的每个商品类型。
• 如果商品类型中有任何符合条件的商品，请勿设置此属性。在这种情况下，您需要手动将促销 ID [promotion_id] 映射到商品数据源中符合条件的商品，或者使用促销商品 ID [item_id] 属性（请参阅上文）来映射促销活动来源中符合条件的商品（最多 20 件商品）。如需了解更多映射详情，请参阅促销活动实施指南中的为促销活动选择商品一文。

排除的品牌 [brand_exclusion]

您可以通过“排除的品牌”属性，将商品数据源中的一个或多个品牌从促销活动中排除。

如果将促销活动中“符合促销条件的商品”[product_applicability] 属性设置为 specific_products，则设置这个“排除的品牌”[brand_exclusion] 属性会将商品数据源中相应品牌的所有商品从促销活动中排除。

重要提示：

• 最多可以指定 10 个品牌。请使用英文逗号分隔列出的每个品牌。
• 品牌区分空格和大小写，而且必须与商品数据源中的拼写完全一致。
• 如果品牌中有任何符合条件的商品，请勿设置此属性。在这种情况下，您需要手动将促销 ID [promotion_id] 映射到商品数据源中符合条件的商品，或者使用促销商品 ID [item_id] 属性（请参阅上文）来映射促销活动来源中符合条件的商品（最多 20 件商品）。如需了解更多映射详情，请参阅促销活动实施指南中的为促销活动选择商品一文。

促销标签 [promotion_tags]

您可以通过“促销标签”属性，指定商品类别、商品类型和品牌中适用促销活动的部分商品。您可以通过将此属性设置为此前成对列出的属性及其具体值，指定商品数据源中的部分商品。

语法：

• 可接受的键：google_product_category、product_type、brand
• 格式：{attribute1: “valueA”, attribute2: “valueB”}
• 长度上限为 500 个字符。

示例：

• {brand: “Nike”, google_product_category: “Apparel & Accessories > Shoes”}

重要提示：

• 如果促销活动适用于某个类别、类型或品牌中的部分（而非全部）商品，并且具体商品 ID 未知，则应使用促销标签 [promotion_tags] 属性。

返回“商家促销信息”首页