改用 Feed 标签

您可以使用 feedLabel 字段为商品和数据 Feed 添加标签。

Feed 标签可以采用以下格式:

  • 类型字符串
  • 少于或等于 20 个字符
  • 大写字母 (A-Z)
  • 数字 (0-9)
  • 短线 (-)

以下资源提供了 feedLabel

REST ID

对于新产品,feedLabel 取代了 REST ID 中的 targetCountry

对于新产品,REST ID 现在的格式应为 online:language:feedLabel:offerId,而非 online:language:targetCountry:offerId。这不会更改现有产品的 REST ID。

获取并列出商品

系统会始终为所有返回的商品填充 feedLabel 字段。

如果 feedLabel 是有效的 CLDR 地区代码,我们会自动回填 targetCountry 字段以确保兼容性。如果 feedLabel 不是有效的 CLDR 地区代码,则我们将 targetCountry 留空。

相同的更改也适用于 productstatuses 端点。

对于 feedLabel 并非 CLDR 地区代码的商品,国家/地区特定字段为空。

插入和更新商品

必须提供 feedLabeltargetCountry 才能插入新产品。如果您使用 feedLabeltargetCountry 插入或更新商品,则它们的值必须匹配。

如果这些字段均为空或其值不匹配,您会收到 API 发出的错误。

如需了解详情,请参阅使用 Feed 标签宣传特定 Feed 中的商品

指定国家/地区

请采取以下措施之一,确保您的商品定位到正确的国家/地区:

产品

productstargetCountry 字段已弃用。请改为使用 shipping 字段指定您的目标国家/地区。

如果您想定位到多个国家/地区,可以继续使用 shipping 添加其他国家/地区。

有关详情,请参阅在多个国家/地区定位广告

数据 Feed

您现在可以在 targets 中查看 datafeed 明确定位到的国家/地区。当您在 datafeedtarget 配置中使用 feedLabel(而非 country)时,会出现这种情况。

我们还为 datafeeds 添加了 targetCountries 字段,以便您可以直接为 datafeeds 配置定位。您仍然可以在 Feed 之外配置定位条件,例如通过设置商品资源的 shipping 属性来配置。

从英国转换为 GB

目前,我们允许 targetCountry 字段使用 UK 值,即使它不是有效的国家/地区代码。我们会自动将 UK 转换为 GBtargetCountryUK 的商品通过 GB 存储在其 REST ID 和 offerId 中。

如果您将 UK 设置为 feedLabel 的值,它不会自动转换为 GBUKGBfeedLabel 的不同字符串,将创建不同的优惠。

如果您插入 UKtargetCountry,并将其转换为 GB,则必须更新商品的 REST ID 以包含 GB 而不是 UK,以使用 get 方法检索商品。