商品仕様ガイド

mobile_link

形式: 文字列

モバイル向けに最適化された商品のページのURLです。ここでアイテムを購入できます。モバイル端末を使用する利用者には、mobile_link属性で指定されたURLが表示されます。

URLは、RFCに準じている必要があります。具体的には、「https」または「http」を含める必要があります。

サンプル値:

• https://lite.twttr.com/twtr_blue

additional_image_link

形式: 文字列

アイテムの画像を追加するには、additional_image_linkを使用します。URLはコンマで区切る必要があります。image_link属性で説明した仕様に従います。画像は最大10点追加できます。

サンプル値:

• https://t.co/jeans_1.jpg, https://t.co/jeans_2.jpg, https://t.co/demin_jeans_3.jpg

google_product_category

形式: 文字列

Googleの商品カテゴリーに従った商品カテゴリーです。カテゴリーの分類パスまたはカテゴリーID番号を使用します。このカテゴリーはX利用者に表示される場合があります。

サンプル値:

• 電気製品 > テレビゲーム機器
• 1294

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

product_type

形式: 文字列

社内で従来から使用している商品分類がある場合に、その分類を使用した商品カテゴリーです。Google商品カテゴリー（google_product_category）を使用することもできます。サブカテゴリーは、「>」で区切る必要があります。> の前後にはスペースを入れる必要があります。このカテゴリーはX利用者に表示される場合があります。

サンプル値:

• 衣料品 > 男性用 > パンツ・ズボン > デニム

inventory

形式: 整数

0以上である必要があります。

X上での販売用に保有している、このアイテムの数量です。これを含め、利用者に表示されるアイテムのavailabilityフィールドが「在庫あり」に設定されている場合には、inventoryの値は1以上でなければなりません。ただし、利用者に表示されるアイテムのavailabilityフィールドが「注文受付中」または「事前予約」に設定されている場合は、この値を0以上にすることができます。

サンプル値:

• 10000
  

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

sale_price

形式: 文字列

0以上である必要があります。

アイテムの割引後の単価です。単価は数字で記載し、その後に3桁のISO通貨コード（ISO 4217標準）を記載します。価格と通貨の間にはスペースを入れます。小数点にはピリオド（「.」）を使用します。sale_priceは、priceよりも低くする必要があります。セール価格が存在しない場合、このオプションフィールドには「価格」と同じ値を入力せず、空欄のままにしてください。

サンプル値:

• 89.99 USD
• 15.00 CAD

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

sale_price_effective_date

形式: 1つまたは2つのISO-8601形式の日付と時間

アイテムのセール期間です。セールを開始および終了する日付、時刻、タイムゾーンを含めます。セールの日付が入力されておらず、なおかつsale_priceが設定されたアイテムは、そのセール価格が削除されるまでセール価格で販売されます。

終了日を入れずに開始日だけを入力することもできます。この場合、当該アイテムは開始日からセール価格が削除されるまでセール価格で販売されます。

フォーマット: YYYY-MM-DDT23:59+00:00Z/YYYY-MM-DDT23:59+00:00Z

開始日は終了日より前にする必要があります。

詳細な手順:

1. 開始日をYYYY-MM-DDの形式で入力します。
2. 開始日の後に 「T」 を入力します。
3. 開始時刻を24時間形式（00:00～23:59）で入力し、その後にUTCタイムゾーン（-12:00～+14:00）を入力してから、最後に「Z」を入力します。
4. 「/」 を入力し、同じ形式でアイテムの販売終了日時を入力します。

以下の例は、PSTのタイムゾーン（-08:00）を使用しています。

サンプル値:

• 2020-06-28T09:00-08:00Z/2020-07-28T23:59-08:00Z

item_group_id

形式: 文字列

最大文字数: 100文字

item_group_id属性を使用して、商品のバリエーションを分類することができます。バリエーションとは、商品のサイズ、色、年齢層、性別などの詳細のみが異なる類似アイテムのグループのことです。このフィールドは、商品にバリエーションがある場合は必須です。

サンプル値:

• twtrshoes1234_12

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

gender

形式: 文字列

アイテムのサイズ設定のために性別を指定します。以下のリストの指定可能な値から1つ選択します。

指定可能な値:

• 女性
• 男性
• ユニセックス

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

color

形式: 文字列

最大文字数: 100文字

商品のメインカラーです。1つ以上の単語を使ってカラーを表してください。16進数コードは使用しないでください。

サンプル値:

• ブルー
• フォレストグリーン

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

size

形式: 文字列

最大文字数: 100

単語、略語、または数字で書かれたアイテムのサイズです。

サンプル値:

• ミディアム
• M
• 6

age_group

形式: 文字列

アイテムに関連付けられる年齢層です。以下のリストの指定可能な値から1つ選択します。

指定可能な値:

• 大人
• 全年齢
• 10代
• 子供
• 幼児
• 乳児
• 新生児
  

注記: ダイナミック商品広告の商品カタログをアップロードする場合、このフィールドを設定しておくことを強く推奨します。

custom_label

形式: 文字列

追加情報を含めるカスタムフィールド（custom_label_0、custom_label_1、custom_label_2、custom_label_3、custom_label_4）を最大5つまで含めることができます。商品セットを作成する際にアイテムをカスタムフィールドの情報で絞り込むことができます。

たとえば、カスタムフィールドを使用して、サマーセールに含めるすべての商品に専用のラベルを付けると、それらの商品をフィルターで絞り込んで商品セットにまとめることができます。これらのフィールドでは、いかなる文字列も使用することができます。

例:

• ホリデーセール