您可以使用 feedLabel
欄位,為產品和資料動態饋給新增標籤。
動態饋給標籤的格式如下:
- 類型:字串
- 長度不得超過 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 傳回的錯誤訊息。
詳情請參閱「使用動態饋給標籤宣傳特定動態饋給中的產品」。
指定國家/地區
請使用下列任一方法,確保產品指定正確的國家/地區:
products
資源的shipping
欄位datafeeds
資源的targetCountries
欄位
產品
products
的 targetCountry
欄位已淘汰。請改用 shipping
欄位指定目標國家/地區。
如要指定多個國家/地區,您可以繼續使用 shipping
新增其他國家/地區。
詳情請參閱「指定多個國家/地區的廣告目標」。
資料動態饋給
您現在可以在 targets
中查看 datafeed
明確指定的國家/地區。這項做法適用於您在 datafeedtarget
設定中使用 feedLabel
而非 country
的情況。
我們也為 datafeeds
新增了 targetCountries
欄位,方便您直接設定 datafeeds
的指定目標。您仍可設定動態饋給以外的指定目標,例如設定產品資源的 shipping
屬性。
從英國 (UK) 轉換為英國 (GB)
目前允許 targetCountry
欄位使用 UK
值,即使它不是有效的國家/地區代碼也沒關係。我們會自動將 UK
轉換為 GB
。UK
為 targetCountry
的產品會在 REST ID 和 offerId
中儲存 GB
。
如果您將 UK
設為 feedLabel
的值,系統不會自動將其轉換為 GB
。UK
和 GB
是 feedLabel
的不同字串,會建立不同的產品。
如果您插入 UK
的 targetCountry
,且我們將其轉換為 GB
,則您必須更新產品的 REST ID,以便透過 get
方法擷取產品,並納入 GB
而非 UK
。