フィードラベルへの移行

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

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

  • 文字列を入力する
  • 20 文字以下
  • 大文字（A ～ Z）
  • 数字（0 ～ 9）
  • ダッシュ（-）

feedLabel は次のリソースで使用できます。

REST ID

feedLabel は、新しい商品の REST ID の targetCountry に置き換えられます。

新しい商品の REST ID は、online:language:targetCountry:offerId ではなく online:language:feedLabel:offerId で構成されるようになりました。これにより、既存の商品の REST ID は変更されません。

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

feedLabel フィールドは、返されたすべての商品に常に入力されます。

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

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

CLDR 地域コードではない feedLabel が設定されている商品の場合、国固有のフィールドは空になります。

商品の挿入と更新

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

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

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

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

商品が正しい国をターゲットに設定されていることを確認するには、次のいずれかの方法を使用します。

商品

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

複数の国をターゲットとする場合は、引き続き shipping を使用して国を追加できます。

詳しくは、複数の国で広告をターゲティングするをご覧ください。

データフィード

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

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

英国から英国への変換

現在、targetCountry フィールドには、有効な国コードでなくても UK 値を使用できます。UK は自動的に GB に変換されます。targetCountry が UK の商品は、REST ID と offerId に GB とともに保存されます。

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

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