フィードラベルへの移行

feedLabel フィールドを使用して、商品とデータフィードにラベルを追加できます。

フィードラベルの形式は次のとおりです。

  • 文字列を入力
  • 20 文字以下
  • 大文字(A ~ Z)
  • 数字(0 ~ 9)
  • ダッシュ(-)

feedLabel は次のリソースで入手できます。

REST ID

feedLabel は、新しい商品の REST IDtargetCountry に代わるものです。

新しい商品の REST ID は、online:language:targetCountry:offerId から online:language:feedLabel:offerId の形式になりました。既存の商品の REST ID は変更されません。

商品を取得して一覧表示する

返されるすべての商品について、常に feedLabel フィールドにデータが入力されます。

feedLabel が有効な CLDR テリトリー コードの場合は、互換性を確保するために targetCountry フィールドが自動的にバックフィルされます。feedLabel が有効な CLDR テリトリー コードでない場合は、targetCountry を空のままにします。

productstatuses エンドポイントにも同じ変更が適用されます。

国別のフィールドは、CLDR 地域コードではない feedLabel の商品の場合、空になります。

商品の挿入と更新

新しい商品を挿入するには、feedLabel または targetCountry が必要です。feedLabeltargetCountry を使用して商品を挿入または更新する場合は、それらの値が一致する必要があります。

フィールドの両方が空の場合、または値が一致しない場合、API からエラーが返されます。

詳しくは、フィードラベルを使用して特定のフィードの商品を宣伝するをご覧ください。

国によるターゲットの設定

次のいずれかを使用して、商品のターゲットを適切な国に設定します。

商品

productstargetCountry フィールドは非推奨となりました。その代わりに、shipping フィールドを使用して対象国を指定します。

複数の国を対象とする場合は、引き続き shipping を使用して国を追加できます。

詳しくは、複数の国を対象として広告をターゲットに設定するをご覧ください。

データフィード

targetsdatafeed が明示的にターゲットとする国を確認できるようになりました。これは、datafeedtarget 構成で country ではなく feedLabel を使用する場合に適用されます。

また、datafeedstargetCountries フィールドが追加され、datafeeds のターゲティングを直接設定できるようになりました。商品リソースの shipping 属性を設定するなど、フィードの外部でターゲティングを構成することもできます。

英国から英国への変換

現在、targetCountry フィールドは有効な国コードではありませんが、UK 値を使用できます。UK は自動的に GB に変換されます。targetCountryUK であるプロダクトは、REST ID と offerIdGB とともに保存されます。

feedLabel の値として UK を設定しても、自動的に GB に変換されることはありません。UKGBfeedLabel 用の異なる文字列で、異なるオファーを作成します。

UKtargetCountry を挿入し、それを GB に変換する場合、get メソッドで商品を取得するには、UK ではなく GB が含まれるように商品の REST ID を更新する必要があります。