您可以使用 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 地区代码,则特定于国家/地区的字段为空。
插入和更新商品
必须提供 feedLabel
或 targetCountry
才能插入新商品。如果您要插入或更新包含 feedLabel
和 targetCountry
的商品,则它们的值必须匹配。
如果这两个字段均为空,或者它们的值不匹配,您会收到 API 返回的错误。
如需了解详情,请参阅使用 Feed 标签来宣传特定 Feed 中的产品。
指定国家/地区
请使用以下方法之一,确保您的商品定位到正确的国家/地区:
products
资源的shipping
字段datafeeds
资源的targetCountries
字段
产品
products
的 targetCountry
字段已废弃。请改用 shipping
字段指定目标国家/地区。
如果您想定位多个国家/地区,可以继续使用 shipping
添加其他国家/地区。
如需了解详情,请参阅在多个国家/地区投放广告。
数据 Feed
现在,您可以在 targets
中查看 datafeed
明确定位到哪些国家/地区。当您在 datafeedtarget
配置中使用 feedLabel
而非 country
时,此规则适用。
我们还为 datafeeds
添加了 targetCountries
字段,以便您直接为 datafeeds
配置定位条件。您仍然可以在 Feed 之外配置定位条件,例如,通过设置商品资源的 shipping
属性。
将英国转换为 GB
我们目前允许为 targetCountry
字段使用 UK
值,即使它不是有效的国家/地区代码。我们会自动将 UK
转换为 GB
。UK
作为 targetCountry
的商品会在 REST ID 和 offerId
中存储 GB
。
如果您将 UK
设置为 feedLabel
的值,系统不会自动将其转换为 GB
。UK
和 GB
是 feedLabel
的不同字符串,会创建不同的优惠。
如果您插入 UK
的 targetCountry
,并且我们将其转换为 GB
,则您必须更新商品的 REST ID 以包含 GB
(而非 UK
),才能使用 get
方法检索商品。