Xショッピングマネージャー

商品仕様ガイド

Xショッピングマネージャーは、販売者研修および商品カタログ管理の機能を一元化したツールです。以下のガイドでは、CSV形式の商品カタログファイルを適切に構成してXショッピングマネージャーにアップロードする方法を説明します。Xショッピングマネージャーには、いつでも最大100MBのファイルをアップロードできます。

これらの商品は、商品セットの作成や自分のショップの視認性を高めるためのショップスポットライト、Xショップ、ライブショッピング、ダイナミック広告などを活用する際に使用されます。

該当セクションへ移動: 必須の仕様 || オプションの仕様

 

必須の仕様

CSVファイルをXショッピングマネージャーにアップロードするときは、以下のすべてのフィールドがファイルに含まれていることを確認してください。

商品の属性と形式

説明

商品の属性と形式

id

形式: 文字列

説明

最大文字数: 100

アイテム固有のIDです。可能な場合はSKUを使用します。同じIDで複数のインスタンスがある場合は、すべてのインスタンスが無視されます。

サンプル値:

  • TWSHOES-22

商品の属性と形式

title

形式: 文字列

説明

最大文字数: 150

商品名です。link属性またはmobile_link属性で指定された商品のランディングページの商品名と同じにする必要があります。

サンプル値:

  • X Premiumスニーカー

商品の属性と形式

description

形式: 文字列

説明

最大文字数: 5,000(オープンテキスト)

商品の説明です。このフィールドは、HTMLに対応していないので、プレーンテキストで入力する必要があります。

サンプル値:

  • X初のX Premiumスニーカーは、洗練されたファッショナブルなスニーカーです。素材は通気性のよいソフトコットンでXのブランドカラーのブルーでデザインされました。

商品の属性と形式

availability

形式: 文字列

説明

アイテムのリアルタイムでの販売状況です。以下のリストの指定可能な値から1つ選択します。

指定可能な値:

  • 在庫あり
  • 注文受付中
  • 事前予約
  • 在庫切れ
  • 生産中止

商品の属性と形式

condition

形式: 文字列

説明

販売するアイテムの状態です。以下のリストの指定可能な値から1つ選択します。

指定可能な値:

  • 新品
  • 中古
  • 整備済み

商品の属性と形式

price

形式: 文字列

説明

アイテムの単価です。単価は数字で記載し、その後に3桁のISO通貨コード(ISO 4217標準)を記載します。価格と通貨の間にはスペースを入れます。小数点にはピリオド(「.」)を使用します。

サンプル値:

  • 99.99 USD
  • 20.00 CAD

商品の属性と形式

link

形式: 文字列

説明

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

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

サンプル値:

  • https://www.X.com/twtr_blue

商品の属性と形式

image_link

形式: 文字列

説明

アイテムのメイン画像のURLです。後で画像を変更する場合は、新しい画像に異なるURLを使用する必要があります。そうしないと画像は更新されません。

画像の仕様:

  • すべての画像は、JPG、GIF、WEBP、またはPNG形式にする必要があります。
  • 商品の画像は、正方形(1:1)のフォーマットにすることを強くおすすめします。
  • 画像の最小サイズは500 x 500ピクセルです。
  • 画像ファイルサイズの制限: 5MB。

サンプル値:

  • https://t.co/demin_jeans_452.jpg

商品の属性と形式

brand、gtin、およびmpn

形式: 文字列

説明

brand、gtin、mpn属性のいずれか1つのみが必須ですが、可能な場合はすべてを含めることをおすすめします。

最大文字数: 100文字

  • brandは、アイテムのブランド名です。サンプル値: X
  • gtinとは、グローバル貿易アイテム番号(固有のユニバーサル商品識別コード)のことです。アイテムのUPC、EAN、JANまたはISBNを入力します。サンプル値: 012345678901
  • mpnは、アイテムの製造元部品番号です。サンプル値: TW123456TTER

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

 

オプションの仕様

以下のフィールドは、XショッピングマネージャーにCSVファイルをアップロードする際に含めるかどうかは任意ですが、X上で展開する商品の追加情報を提供できますので含めることをおすすめします。

商品の属性と形式

説明

商品の属性と形式

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つまで含めることができます。商品セットを作成する際にアイテムをカスタムフィールドの情報で絞り込むことができます。

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

例:

  • ホリデーセール

始める準備はできましたか?