カタログ

リファレンス - カタログ

サポートされるフィードフォーマット

インベントリーは、カタログを使ってFacebookにアップロードする必要があります。カタログごとに、サポートされているフォーマットで商品フィードを提供する必要があります。フォーマットは、CSV、TSV、RSS XML、ATOM XML、Googleスプレッドシート(詳しいガイダンスについては、ヘルプセンターの記事をご覧ください)のいずれかです。

フォーマット説明

CSV

コンマ区切り値。ほとんどのスプレッドシートプログラムが対応しています。最初の行は列見出しを指定します。それ以降の行は、各ルートの対応する値を提供します。


空白またはコンマを含むフィールドは"二重引用符"で囲む必要があります。二重引用符で囲まれたフィールド内の二重引用符は、2つの連続した二重引用符でエスケープする必要があります。

例: "Join our ""Royal"" membership program"。


画像などのネストされたフィールドや複数値フィールドは、JSONエンコード値を使うか、またはJSONパス構文を使ってラベルが付けられた「フラット化」プレーンテキスト列のセットを使って表記できます。

例: image[0].url、image[0].tag[0]、image[0].tag[1])


両方の表現方法を同じファイルで同時に使用できます。

Advantage+ カタログ広告用CSVフィードとコマース用CSVフィードの例をご覧ください。


[ダウンロード] (右クリック > [名前を付けてリンク先を保存])

フィードの作成でMetaのCSV (.csv)サンプルファイルを参考にすることはできますが、コマースマネージャを主な情報源として使うことをおすすめします。

TSV

タブ区切り値。ほとんどのスプレッドシートプログラムが対応しています。CSVのガイドラインをご覧ください。

[ダウンロード] (右クリック > [名前を付けてリンク先を保存])

RSS XML

リッチサイトの概要、拡張可能マークアップ言語。それぞれが1つのルートを表す一連のノードを、1つのルートXMLノードで囲みます。ファイルの先頭にdeclarationタグが必要です。これは、通常、自動フィード提供システムまたはウェブサーバーによって生成されるフォーマットです。アイテムXMLノードセットは商品リストを表し、<?xml宣言タグで始まっていなければなりません。

通常は、自動化されたフィードプロバイダーシステムやウェブサーバーで生成されます。

[ダウンロード] (右クリック > [名前を付けてリンク先を保存])

エラーになった場合、XMLデータフィードファイルの行の長さが、上限である5,242,880バイト(または文字)を超えているということを意味しています。XMLのフォーマットを複数行に変更して1行を1つのフィールドとし、ファイルをアップロードし直してください。詳しくは、データフィードエラーのトラブルシューティングをご覧ください。

Atom XML

Atom Syndication Formatはウェブフィード用に使うXML言語です。Atom Publishing Protocol (AtomPubまたはAPP)は、ウェブリソースの作成と更新のための、シンプルなHTTPベースのプロトコルです。これは、通常、自動フィード提供システムまたはウェブサーバーによって生成されるフォーマットです。アイテムXMLノードセットは商品リストを表し、<?xml宣言タグで始まっていなければなりません。通常は、自動化されたフィードプロバイダーシステムやウェブサーバーで生成されます。コマース用XMLフィード(Atom)の例をご覧ください。

[ダウンロード] (右クリック > [名前を付けてリンク先を保存])

Googleスプレッドシート

コマースマネージャで、定期フィード用にGoogleスプレッドシートもサポートされるようになりました。

  1. Googleスプレッドシートでデータフィードをスプレッドシートとして作成し、共有可能なリンクを入手してください。
  2. コマースマネージャに商品を追加する際に、Googleスプレッドシートを選択してください。共有可能なリンクの中にコピー＆ペーストして、アップロードを完了します。
  3. Googleスプレッドシートでインベントリーの管理を続けてください。予定されているタイミングでそれが取り出されます。

詳しくはこちら

フィードの例

CSVフィードの例 — Advantage+ カタログ広告

id,title,description,availability,condition,price,link,image_link,brand,additional_image_link,age_group,color,gender,item_group_id,google_product_category,pattern,product_type,sale_price,sale_price_effective_date,size,FB_product_1234,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,in stock,new,9.99 USD,https://www.facebook.com/facebook_t_shirt,https://www.facebook.com/t_shirt_image_001.jpg,Facebook,https://www.facebook.com/t_shirt_image_002.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts,stripes1,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,small,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300

CSVフィードの例 — コマース

id,title,description,rich_text_description,availability,condition,price,link,image_link,brand,additional_image_link,age_group,color,gender,item_group_id,google_product_category,product_type,sale_price,sale_price_effective_date,size,status,inventory
FB_product_1234,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,small,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200
FB_product_1235,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,medium,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200
FB_product_1236,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,large,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200
FB_product_1237,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,black,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,small,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200
FB_product_1238,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,black,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,medium,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200
FB_product_1239,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,black,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,large,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200

XMLフィード(Atom)の例 — コマース

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel> 
    <title>My Deal Shop Products</title>
    <description>Product Feed for Facebook</description> 
    <link>https://www.mydealsshop.foo</link>
    <atom:link href="https://www.mydealsshop.foo/pages/test-feed" rel="self" type="application/rss+xml" />
    
     
        <item>
            <g:item_group_id>SKU-123123</g:item_group_id>
            <g:gtin>12345678912345</g:gtin>
            <g:google_product_category>Toys &amp; Games > Toys > Executive Toys > Magnet Toys</g:google_product_category>            
            <g:id>SKU-123123-RED</g:id>
            <g:title>WidgetThing</g:title>            
            <g:description>This product is the product you need to do the thing</g:description>
            <g:link>https://www.mydealsshop.foo/products/widgetthing</g:link>
            <g:image_link>https://cdn.mycdn.foo/files/123123123.jpg</g:image_link>  
            
            <additional_image_link>https://cdn.mycdn.foo/files/123123123_image2.jpg</additional_image_link>            
            <additional_image_link>https://cdn.mycdn.foo/files/123123123_image3.jpg</additional_image_link>
                        
            <color>Red</color>           
                    
            <additional_variant_attribute>
                <label>Style</label>
                <value>Cool</value>
            </additional_variant_attribute>
                    
            <g:brand>AcmeCo</g:brand>
            <g:condition>New</g:condition>  
          
            <g:availability>in stock</g:availability>
            
            <g:price>19.99 USD</g:price>
            <g:sale_price>9.99 USD</g:sale_price>
           
        </item>  

        <item>
            <g:item_group_id>SKU-123123</g:item_group_id>
            <g:gtin>12345678912346</g:gtin>
            <g:google_product_category>Toys &amp; Games > Toys > Executive Toys > Magnet Toys</g:google_product_category>            
            <g:id>SKU-123123-GREEN</g:id>
            <g:title>WidgetThing</g:title>            
            <g:description>This product is the product you need to do the thing</g:description>
            <g:link>https://www.mydealsshop.foo/products/widgetthing</g:link>
            <g:image_link>https://cdn.mycdn.foo/files/123123123.jpg</g:image_link>  
            
            <additional_image_link>https://cdn.mycdn.foo/files/123123123_image2.jpg</additional_image_link>            
            <additional_image_link>https://cdn.mycdn.foo/files/123123123_image3.jpg</additional_image_link>
                        
            <color>Green</color>           
                    
            <additional_variant_attribute>
                <label>Style</label>
                <value>Cool</value>
            </additional_variant_attribute>
                    
            <g:brand>AcmeCo</g:brand>
            <g:condition>New</g:condition>  
          
            <g:availability>in stock</g:availability>
            
            <g:price>19.99 USD</g:price>
            <g:sale_price>9.99 USD</g:sale_price>
            
        </item>   
         

    </channel>
</rss>

フィードのフォーマット — データフィードの取得をスケジューリングする

データフィード取得のスケジューリングについては、以下のおすすめフォーマットをご覧ください。

フィードのフォーマット 使用事例 サンプルフィード

CSV

アイテムのサブセットについてpriceとavailabilityを更新する。

[ダウンロード] (右クリックしてから[名前を付けてリンク先を保存])

TSV

アイテムのサブセットについて、sale_priceをリセットし、custom_label_0を更新する

[ダウンロード] (右クリックしてから[名前を付けてリンク先を保存])

サポートされているカタログフィールド

カタログフィールドは、FacebookまたはInstagramのショップで商品を購入する顧客のエクスペリエンスの質を決める最も重要な要素です。

カタログフィールドを使って、各アイテムの商品詳細ページのデータを入力します。それには、商品の説明、画像、サイズ/色のバリエーション、価格、在庫状況などの重要な情報が含まれます。データが欠落していたり不正確だったりすると、ユーザーエクスペリエンスを損なったり、購入コンバージョンに影響したり、誤解を招いたり信頼を損なったりする可能性があります。

商品でサポートされるフィールド

カタログ作成で使われるフィールドは、次の表に示されているとおりです。必須レベル(必須か任意か)も示されています。列の命名規則のベストプラクティスとして、すべての分野で米国英語を使ってください。

Required Fields (for Ads and Commerce)

Each field in your data feed represents information about your products. All field names and certain supported values must be in US English. The following fields are required for each product in your catalog. Note: If any required fields are missing or formatted incorrectly, products may not upload to your catalog.

Attribute and Type Description

id

Type: string

Max character limit: 100

A unique content ID for the item. Use the item's SKU if possible. Each content ID must appear only once in your catalog. If there are multiple instances of the same ID, we ignore all instances.


Note: For dynamic ads, this ID must exactly match the content ID for the same item in your Meta Pixel.


Example: 12345

This field is required for supplementary feeds. Each item’s content ID must exactly match in the supplementary feed and the main feed it’s linked to. This indicates it’s the same item in both feeds.

title

Type: string

Character limit: 200, but we recommend a maximum of 65 to avoid longer titles being cut off.


A specific, relevant title for the item. See product title specifications.

Example: Blue Cotton T-Shirt

This field is supported by supplementary feeds.

description

type: string

Max character limit: 9999

A relevant description of the item. Include specific and unique product features, such as material or color. Use plain text (not HTML) and don't enter text in all capital letters or include any links. The description should be different than the title. See product description specifications.


Example: A comfortable royal blue women's T-shirt in organic cotton. Cap sleeves and relaxed fit. Perfect for warm summer days.

This field is supported by supplementary feeds.

availability

Type: string

The current availability of the item. Must be written in U.S. English. Supported values:


  • in stock

  • out of stock

Items that are out of stock display as "sold out" in your shop. They don't display at all in your ads.


Example: in stock

condition

Type: string

The condition of the item. Supported values: new, refurbished, used.


Example: new

price

type: string

The price of the item. Format the price as a number, followed by a space and then the 3-letter ISO 4217 currency code (ISO 4217 standards). Always use a period (.) as the decimal point, not a comma (,). Don't include currency symbols such as $, € or £.

To add product information and prices that will display for other countries or languages, upload a country feed or language feed to your catalog.

Example: 9.99 USD, 7.99 EUR

link

Type: string

The URL to the specific product page for the item on your business's website where people can learn more about or buy that exact item. Links must begin with http:// or https://, be valid and be hosted on your business’s website domain. Don't provide a link to a Facebook domain (such as your business's Facebook Page) or somewhere else.


Example: http://www.jaspersmarket.com/products/shirt

image_link

Type: string

The URL for the main image of your item. Images must be in JPEG or PNG format, at least 500 x 500 pixels and up to 8 MB. See product image specifications.


Example: http://www.jaspersmarket.com/products/shirt.jpg


Note: If you change the image later, the new image must use a different URL or the change won't be recognized.

This field is supported by supplementary feeds.

brand

Type: string

Max characters: 100

The brand name of the item.

Example: Jasper's Market

Additional Required Fields for Checkout on Facebook and Instagram (US Only)

Checkout on Facebook and Instagram (US only) allows customers to complete purchases directly on Facebook and Instagram. To sell items with this checkout method, provide the following additional fields for each product in your catalog. If items are missing these fields, people won't be able to buy them or they may not show in your shop at all.

Attribute and Type Description

quantity_to_sell_on_facebook

Type: integer

The quantity of this item that you have available to sell on Facebook and Instagram. Enter a whole number. To prevent overselling, the item's quantity will be automatically reduced each time a purchase order is confirmed through checkout.


Note: To display as in stock for checkout, an item's quantity_to_sell_on_facebook must be 1 or higher and its availability must also be set to in stock.


Example: 150

This field was previously called inventory. While we still support the old field name, we recommend that you use the new name.

size

Type: string

Required for items in specific product categories including clothing and shoes.

Max character limit: 200


The size of the item. Enter the size as a word, abbreviation or number, such as "Small", "XL", "12" or "One Size".


Example: Medium

This field is supported by supplementary feeds.

Optional Fields

You can also include many optional fields to share more product information with customers or control how items are displayed.

Attribute and Type Description

sale_price

Type: string

If the item is on sale, enter its discounted price. Use the same formatting as the price field.


Example: 7.99 USD

sale_price_effective_date

Type: two ISO-8601 timestamp

The date, time and time zone when your sale starts and ends. If you don't add this field, any items with a sale_price remain on sale until you remove their sale price. Use this format:


YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00


  • Enter the sale start date as YYYY-MM-DD followed by a "T".
  • Enter the start time in 24-hour format (00:00 to 23:59) followed by the UTC time zone (-12:00 to +14:00).
  • Enter a "/". Then, repeat the same format for the date and time when your sale ends.

Example (using PST time zone -08:00):

2020-04-30T09:30-08:00/2020-05-30T23:59-08:00

item_group_id

Type: string

Max character limit: 100

Allows you to set up variants of the same product, such as different sizes, colors or patterns. Enter the same group ID in this field for all variants of the same product to indicate they're part of a group. Learn more about product variants.


Example: Shirt_1

status

Type: string

Controls whether the item is active or archived in your catalog. Only active items can be seen by people in your ads, shops or any other channels. Supported values: active, archived. Items are active by default. Learn more about archiving items.


Example: active


Note: Some partner platforms such as Shopify may sync items to your catalog with a status called staging, which behaves the same as archived.

This field was previously called visibility. While we still support the old field name, we recommend that you use the new name.

additional_image_link

Type: string

Maximum character limit: 2000

URLs for up to 20 additional images of your item, separated by a comma (,), semicolon (;), space ( ) or vertical bar (|). Follow the same image specifications as image_link.


Since this field takes a string, the entire list of URLs must be formatted with double quotes. For example: "http://www.jaspersmarket.com/products/shirt2.jpg, http://www.jaspersmarket.com/products/shirt3.jpg"


To display additional images in your ads, see Dynamic Ads, Ad Template


This field is supported by supplementary feeds.

google_product_category

Type: string

Provide the most specific Google product category possible from this list: Excel (.xls) or Plain text (.txt). Enter either the category name (not case sensitive) or its ID number.


Example: Apparel & Accessories > Clothing > Shirts & Tops or 212


Learn more about product categories (Business Help Center article).


Note: The category lists above are in US English. You can download other languages from Google Merchant Help Center.

This field is supported by supplementary feeds.

fb_product_category

Type: string

Provide the most specific Facebook product category possible from this list: Spreadsheet (.csv) or Plain text (.txt). Enter either the category name (not case sensitive) or its ID number.


Example: Clothing & Accessories > Clothing > Women's Clothing > Tops & T-Shirts or 430


Learn more about product categories (Business Help Center article).


Note: The category lists above are in US English. You can download other languages here.

This field is supported by supplementary feeds.

Category-specific fields

When you provide a Google or Facebook product category (google_product_category or fb_product_category), we recommend that you add more fields that are specific to that category. This gives people more information to make a purchase decision. For example, for beauty products, you could provide ingredients. View the list of category-specific fields.

This field is supported by supplementary feeds.

color

Type: string

Max character limit: 200

The main color of the item. Describe the color in words, not a hex code.


Example: Royal Blue

This field is supported by supplementary feeds.

gender

Type: string

The gender your item is targeted towards. Supported values: female, male, unisex.


Example: unisex

This field is supported by supplementary feeds.

size

Type: string

Max character limit: 200

The size of the item. Enter the size as a word, abbreviation or number, such as "Small", "XL", "12" or "One Size".


Example: Medium

This field is supported by supplementary feeds.

age_group

Type: string

The age group the item is targeted towards. Accepted values: adult, all ages, teen, kids, toddler, infant, newborn.


Example: adult

This field is supported by supplementary feeds.

material

Type: string

Character limit: 200
The material the item is made from, such as cotton, polyester, denim or leather.


Example: Organic Cotton

This field is supported by supplementary feeds.

pattern

Type: string

Max character limit: 100

The pattern or graphic print on the item.


Example: Flannel, Gingham, Polka dots, stripes

This field is supported by supplementary feeds.

shipping

Type: string

This allows you to use a shipping-related overlay in your ads.

Shipping details for the item, formatted as: Country:Region:Service:Price


  • Enter the country as a 2-letter ISO 3166 country code.
  • Enter the region, state or province. If shipping information is the same for an entire country, you can leave out the region but keep the :: as shown in the Philippines (PH) example below.
  • Enter a description of the shipping service such as Ground or Air.
  • Enter the price as a number followed by a space and then the 3-letter ISO 4217 currency code. Note: To use the "Free Shipping" overlay for ads, enter the price as 0.0.
  • If you offer different shipping details by region or country, separate them with a comma (,) as shown in the example.

Example: US:NY:Ground:9.99 USD, PH::Air:300 PHP

shipping_weight

Type: string

Shipping weight of the item in lb, oz, g, or kg.


Example: 10 kg

internal_label

Type: string

Add internal labels to help filter items when you create product sets. For example, you could add a “summer” label to all items that are part of a summer promotion and then filter those items into a set. Labels are only visible to you

Enclose each label in single quotes (') and separate multiple labels with commas (,). Don’t include white spaces at the beginning or end of a label. Character limit: Up to 5,000 labels per product and 110 characters per label.

Example (TSV, XLSX, Google Sheets): ['summer','trending']

Example (CSV): “['summer','trending']”

Note: If you’re currently using custom labels (custom_label_0 to custom_label_4) for filtering product sets, switching to internal labels (internal_label) instead is recommended. Unlike custom labels, you can add or update internal labels as often as needed without sending items through policy review each time, which can impact ad delivery.

This field was previously called product_tags. While we still support the old field name, we recommend that you use the new name.

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

Type: string

Max character limit: 100

Up to five custom fields for any additional information you want to filter items by when you create sets. For example, you could use a custom field to indicate all items that are part of a summer sale, and then filter those items into a set. This field supports any text value, including numbers.


Example: Summer Sale

This field is supported by supplementary feeds.

custom_number_0
custom_number_1
custom_number_2
custom_number_3
custom_number_4

Type: int

Up to five custom fields for any additional number-related information you want to filter items by when you create sets. This field allows you to filter by number ranges (is greater than and is less than) when you create a set. For example, you could use this field to indicate the year an item was produced, and then filter a certain year range into a set.


This field supports whole numbers between 0 and 4294967295. It doesn't support negative numbers, decimal numbers or commas, such as -2, 5.5 or 10,000.


Example: 2022

rich_text_description

Type: string

Max characters: 9999

The rich text (HTML) description for item. Note: If this field is provided, we use it instead of description; however, the description field is still required because it's a fallback.


Supported tags include:

  • <form>, <fieldset>, <div>, <span>, <section>
  • All Header tags: <header>, <h1> thru <h6>
  • Table tags: <table>, <tbody>, <tfoot>, <thead>, <td>, <th>, <tr>
  • List tags: <ul>, <li>, <ol>, <dl>, <dd>, <dt>
  • Other formatting tags: <b>, <u>, <i>, <em>, <strong>, <title>, <small>, <br>, <p>, <div>, <sub>, <sup>, <pre>, <q>, <s>

Note: Any attributes of the html tags such as <style> will be stripped off from the field.


Example:

<html>
<p>Unisex cotton T-shirt with 3/4 length sleeves in royal blue. Great for everyday casual wear. Features graphic print of logo in white on upper left sleeve.</p>
<ul>
<li>100% Cotton</li>
<li>Relaxed Fit</li>
</ul>
</html>

This field is supported by supplementary feeds.

product_type

Type: string

Max character limit: 750

Category the item belongs to, according to your business's product categorization system, if you have one. You can also enter a Google product category. For commerce, represents the product category in your internal system. Learn more about product categories for commerce.


Example: Home & Garden > Kitchen & Dining > Appliances > Refrigerators

video[0].url

video[1].url

video[2].url

video[3].url ... up to

video[19].url

Type: string

Up to 20 fields each containing a link to a video of your item. Must be a direct link to download the video file, not a link to a video player such as YouTube.


The maximum video file size is 200 MB. Supported formats include: .3g2, .3gp, .3gpp, .asf, .avi, .dat, .divx, .dv, .f4v, .flv, .gif, .m2ts, .m4v, .mkv, .mod, .mov, .mp4, .mpe, .mpeg, .mpeg4, .mpg, .mts, .nsv, .ogm, .ogv, .qt, .tod, .ts, .vob and .wmv


Example:

http://www.jaspersmarket.com/product_video.avi

This field is supported by supplementary feeds.

additional_variant_attribute

Type: string

Additional attributes that are not core attributes (size, color, gender, pattern, and so on). Do not use a core attribute as an additional attribute. Learn more about Product Variants.


Example: Scent:Fruity, Flavor:Strawberry

This field is supported by supplementary feeds.

unit_price

Type: string

Provide this information for any products customarily sold by a unit of measurement (for example "$10 / pound"). To specify this information, provide the following:

Amount value: this is a float
Currency: any supported currency
Unit type: any of the following measurements:


Centiliters: cl
Centimeters: cm
Count: ct
Cubic Meters: cbm
Feet: ft
Fluid Ounces: fl oz
Gallons: gal
Grams: g
Inches: in
Kilograms: kg
Liters: l
Meters: m
Milligrams: mg
Milliliters: ml
Ounces: oz
Pints: pt
Pounds: lb
Quarts: qt
Square Feet: sqft
Square meters: sqm
Yards: yd


This information is uploaded via feed uploads in the unit_price field in a JSON format as follows:

{value: 10.0, currency: "USD", unit: "lb"}

It can also be uploaded via XML as follows:

<unit_price>
 <value>10</value>
 <currency>USD</currency>
 <unit>lb</unit>
</unit_price>

Example: Download a sample CSV file with an example of adding unit_price to products.

gtin

Type: string

The item’s Global Trade Item Number (GTIN). Providing a GTIN is recommended to help classify the item. The GTIN may appear on the barcode, packaging or book cover. Not all items have a GTIN. Only provide one if you’re sure it’s correct. Don’t include dashes or spaces.

GTIN types:

  • UPC (North America / GTIN-12): 12-digit number.
  • EAN (Europe / GTIN-13): 13-digit number.
  • JAN (Japan / GTIN-13): 8 or 13-digit number.
  • ISBN (for books / ISBN-13): 13-digit number. Convert any 10-digit ISBN-10 numbers to ISBN-13.
  • ITF-14 (for multipacks / GTIN-14): 14-digit number.

Example: 4011200296908

This field is supported by supplementary feeds.

mpn

Type: string

Max characters: 100.

The item’s manufacturer part number (MPN), a unique alphanumeric code assigned by the manufacturer in some industries to identify a specific item or part. It may appear on the packaging, label or etched directly onto the item. Providing a MPN is recommended to help classify the item if there is no GTIN. Not all items have a MPN. Only provide one if you’re sure it’s correct.

Example: JAS12345PER

expiration_date

Type: date

Product expiration. If the product is expired, it won't be shown on Facebook. This date should follow the ISO‑8601 (YYYY‑MM‑DD) format.

return_policy_info

Type: string

Specify a return window for this item, which overrides your shop's default return window. Using this field in your data feed is an alternative to setting up a custom return window manually in Commerce Manager. Learn more about return windows.


Indicate whether the item is final sale (true or false) and the number of days of the the return window (for final sale, enter 0 days).


Example of an item with a 30 day return window: {is_final_sale: "false", return_policy_days: "30"}


Example of a final sale item:

{is_final_sale: "true", return_policy_days: "0"}


mobile_link

Type: string

Link to mobile-optimized page for item on the merchant's website.

applink

Type: string

Provide deep links in feed following the App Links specification. Deep link information in feed takes precedence over any information we collect with App Links metadata with our web crawler.


If you already have deep link information from App Links, you don't need to specify this data. Information from App Links is used to display the correct deep link. To display deep links in your ads, see Dynamic Ads, Ad Template.


Supported applinks: applink.ios_url, applink.ios_app_store_id, applink.ios_app_name, applink.android_url, applink.android_package, applink.android_app_name, applink.windows_phone_url, applink.windows_phone_app_id, applink.windows_phone_app_name, applink.ipad_url, applink.ipad_app_store_id, applink.ipad_app_name.

For Android, we require applink.android_package and url is optional. For other applinks, a valid url is required.

Learn more about product deep links.


disabled_capabilities

Used to control the channel visibility of each specific product in your catalog. With this feature, you can enable or disable your products from being displayed in Shops, Marketplace Shops, Instagram Product Tagging, Dynamic Ads, and Mini Shops.

Learn more about disabled_capabilities.

Additional Required Fields for Selling in India

Attribute and Type Description

origin_country
Type: ISOCountryCode (2 letter country code)

The item's country of origin. Enter the two-letter ISO country code


Example value: US

This field is supported by supplementary feeds.

importer_name
Type: string

If the country of origin is not India, provide the legal entity name of the item's importer


Example value: Jasper's Market Inc.

This field is supported by supplementary feeds.

importer_address
Type: JSON structure

If the country of origin is not India, provide the operational address of the importer. This field uses a JSON structure, which contains the following fields:


street1 - string, required. The first line of the street address
street2 - string, optional. The second line of the street address.
city - string, required. The city name.
region - string, optional. The region, state or province. (In the US this is to be used for US State)
postal_code - string, optional (in the US this is to be used for Zip Code)
country - required. Enter the ISO Country code (2-letter country code)


The overall address will be displayed to users in the following format: street1, street2 (if present), city, region (if present) postal_code (if present), country (full name, localized for the user).


This example value: `

{ street1: "1 Hacker Way", street2: "Building 18", city: "Menlo Park", region: "CA", postal_code: "94025", country: "US" }

will be rendered as "1 Hacker Way, Building 18, Menlo Park, CA 94025 United States of America"

This field is supported by supplementary feeds.

manufacturer_info
Type: string

Required for Shops only.

Information about the product's manufacturer, such as the manufacturer name and address.


Example: The Manufacturer Co. - 1 Hacker Way, Menlo Park, CA 94025 USA

This field is supported by supplementary feeds.

wa_compliance_category
Type: string

Required for selling on WhatsApp only.

If the item is a non-physical good sold in India, such as a service, use this field to indicate that the item is exempt from providing the country of origin (origin_country), importer name (importer_name) and importer address (importer_address).


Supported values (case sensitive):

COUNTRY_ORIGIN_EXEMPT: The item is exempt.

DEFAULT: The item is not exempt. This is the default value if you leave the field blank.

サポートされているフィールド — ローカライズされたカタログ

要件

  • セカンダリデータフィードファイルにidフィールドを含める必要があります。Advantage+ カタログ広告を掲載するには、各商品のIDが、オリジナルのカタログデータフィードのIDおよびピクセル内のコンテンツIDと一致している必要があります。
  • overrideフィールドを含める必要があります。このフィールドには、ローカライズ対象の言語や国のISOコードを入力します。このフィールドには、ローカライズ対象の言語や国のISOコードを入力します。override列の値は、サポートされるISO言語コードまたはサポートされるISO国コードのどちらかでなければなりません。サポートされる言語コードと国コードについて、詳しくはこちらをご覧ください。
  • price、sale_price、unit_price、base_price、status (可視性)、availabilityは、国フィードでのみ提供する必要があります。これらのフィールドは言語フィードでは提供できません。これにより、顧客はローカライズされた正しい製品データを見ることができます。

idとoverrideのフィールドについて詳しくは、ローカライズされたインベントリー情報でデータフィードを作成する、ステップ2と3をご覧ください。

製品

  • title
  • description
  • availability
  • link
  • brand
  • price
  • sale_price
  • sale_price_effective_date
  • color
  • size
  • material
  • pattern
  • custom_label_0
  • custom_label_1
  • custom_label_2
  • custom_label_3
  • custom_label_4
  • short_description
  • additional_variant_attribute
  • applink.ios_url、applink.ios_app_store_id、applink.ios_app_name、applink.android_url、applink.android_package、applink.android_app_name、applink.windows_phone_url、applink.windows_phone_app_id、applink.windows_phone_app_name、applink.ipad_url、applink.ipad_app_store_id、applink.ipad_app_name

アプリリンクフィールドをローカライズするには、すべてのフィールドを提供する必要があります。商品ディープリンクについて、詳細をご確認ください。

  • image[0].url、image[0].tag[0]

画像をローカライズするには、入れ子になった画像フィールドimage[0].url、image[0].tag[0]を使う必要があります。image_linkフィールドはローカライズに対応していません。

参考として、商品のフィールドのメインリストをご覧ください。

ホテル

  • name
  • description
  • base_price
  • sale_price
  • brand

  • url

  • neighborhood

  • longitude
  • latitude
  • image[0].url、image[0].tag[0]
  • applink.ios_url、applink.ios_app_store_id、applink.ios_app_name、applink.android_url、applink.android_package、applink.android_app_name、applink.windows_phone_url、applink.windows_phone_app_id、applink.windows_phone_app_name、applink.ipad_url、applink.ipad_app_store_id、applink.ipad_app_name

アプリリンクフィールドをローカライズするには、すべてのフィールドを提供する必要があります。商品ディープリンクについて、詳細をご確認ください。

参考として、ホテルのフィールドのメインリストをご覧ください。

フライト

  • description
  • url
  • origin_city
  • destination_city
  • price
  • one_way_price
  • image[0].url、image[0].tag[0]
  • applink.ios_url、applink.ios_app_store_id、applink.ios_app_name、applink.android_url、applink.android_package、applink.android_app_name、applink.windows_phone_url、applink.windows_phone_app_id、applink.windows_phone_app_name、applink.ipad_url、applink.ipad_app_store_id、applink.ipad_app_name

アプリリンクフィールドをローカライズするには、すべてのフィールドを提供する必要があります。商品ディープリンクについて、詳細をご確認ください。

参考として、フライトのフィールドのメインリストをご覧ください。

目的地

  • name
  • description
  • url
  • price
  • neighborhood
  • longitude
  • latitude
  • image[0].url、image[0].tag[0]
  • applink.ios_url、applink.ios_app_store_id、applink.ios_app_name、applink.android_url、applink.android_package、applink.android_app_name、applink.windows_phone_url、applink.windows_phone_app_id、applink.windows_phone_app_name、applink.ipad_url、applink.ipad_app_store_id、applink.ipad_app_name

アプリリンクフィールドをローカライズするには、すべてのフィールドを提供する必要があります。商品ディープリンクについて、詳細をご確認ください。

参考として、目的地のフィールドのメインリストをご覧ください。

不動産・住宅

  • name
  • description
  • price
  • url
  • image[0].url、image[0].tag[0]

参考として、不動産・住宅のフィールドのメインリストをご覧ください。

自動車

  • title
  • description
  • price
  • sale_price
  • url
  • image[0].url、image[0].tag[0]

参考として、自動車のフィールドのメインリストをご覧ください。

OpenGraphタグ

各フィールドは最大500文字です。

主要画像リンクは必須です。追加の画像リンクは任意です。
名前説明

og:title

必須。

アイテムのタイトル。ピクセルベースのカタログに対応。

og:description

必須。

アイテムの説明。ピクセルベースのカタログに対応。

og:url

必須。

商品ページの完全なURL。ピクセルベースのカタログに対応。

og:image

主要リンクでは必須。追加の画像リンクでは任意。

商品ページに使われている画像へのリンク。主要画像リンクは必須です。追加の画像リンクは任意です。ピクセルベースのカタログに対応。

og:locale

多言語カタログを使う場合は必須。

商品がウェブサイトのどのバージョンのものかを指定します。例えば、英国ウェブサイトの場合はen_GB。ピクセルベースのカタログに対応。

og:price:amount

必須。

アイテムの現在の価格。小数点には「,」ではなく「.」を使います。価格に「$」などの記号は含めないでください。ピクセルベースのカタログに対応。

例: 1500.00

og:price:currency

必須。

価格の通貨(ISO形式)。ピクセルベースのカタログに対応。

例: USD

product:brand

必須。

アイテムのブランド名。ピクセルベースのカタログに対応。

product:availability

必須。

商品の現在の在庫状況: in stock、out of stock、available for order、discontinued。ピクセルベースのカタログに対応。

product:catalog_id

任意。

アイテムのユニークなカタログID。商品のバリエーションも指定できます。商品のインポート後、これはretailer_idにマッピングされます。idフィールドはピクセルのコンテンツIDと一致している必要があります。ピクセルベースのカタログに対応。

product:category

任意。

最大文字数: 250。ピクセルベースのカタログに対応。

Advantage+ カタログ広告の場合、Googleの商品分類法による事前定義済みの値(文字列またはカテゴリID)を表します。

コマースの場合、Googleの商品分類法による商品カテゴリを表します。コマースの商品カテゴリについて詳しくは、こちらをご確認ください。

詳しくは、カタログアイテムのGoogle商品カテゴリ、広告ヘルプセンターをご覧ください。

product:condition

必須。

アイテムの現在の状態: new、refurbished、used。ピクセルベースのカタログに対応。

product:custom_label_[0-4]

任意。

最大文字数:100

含めるアイテムに関する追加情報。ピクセルベースのカタログに対応。

product:gender

任意。

サイズ決定のための性別情報: Female、Male、Unisex。ピクセルベースのカタログに対応。

product:item_group_id

任意。

Advantage+ カタログ広告の場合 - 商品のバリエーションであるアイテム。バリエーションであるアイテムのitem_group_idは、すべて同じにしてください。例えば、赤いポロシャツはポロシャツの1つのバリエーションです。Facebookにより、受け取ったフィードがretailer_product_group_idに対応付けられます。Advantage+ カタログ広告の場合、ピクセルまたはアプリイベントから受け取るシグナルに基づき、Facebookによってグループから1つのアイテムだけが選ばれます。

コマースの場合 - バリエーションであるアイテムのproduct_group_idは、すべて同じにしてください。例えば、赤いポロシャツはポロシャツの1つのバリエーションです。Facebookにより、受け取ったフィードがretailer_product_group_idに対応付けられます。商品バリエーションについて詳しくはこちら。ピクセルベースのカタログに対応。

例: FB1234_shirts

product:gtin

任意。

商品の国際取引商品コード(GTIN)。ダッシュやスペースは含めません。GTIN確認ガイドに従っている有効なGTINのみを送信してください。サポートされる値は、UPC (北米、12桁)、EAN (ヨーロッパ、13桁)、JAN (日本、8桁または13桁)、ISBN (本、13桁)です。ピクセルベースのカタログに対応。

例: 4011200296908

product:isbn

任意。

国際標準図書番号。ISBNは13桁の数字です。ピクセルベースのカタログに対応。

product:mfr_part_no

任意。

アイテムのユニークなメーカー部品番号。コマースの場合、mpnが指定されているなら、日替わりセールのインベントリーにブランドも含める必要があります。ピクセルベースのカタログに対応。

例: 100020003

material

任意。

アイテムの原材料。サポートされる値: cotton、denim、leather。ピクセルベースのカタログに対応。

例: cotton

product:locale

多言語カタログを使う場合は必須。

商品がウェブサイトのどのバージョンのものかを指定します。例えば、英国ウェブサイトの場合はen_GB。ピクセルベースのカタログに対応。

product:price:amount

必須。

アイテムの現在の価格。小数点には「,」ではなく「.」を使います。価格に「$」などの記号は含めないでください。ピクセルベースのカタログに対応。

例: 1500.00

product:price:currency

必須。

価格の通貨(ISO形式)。ピクセルベースのカタログに対応。

例: USD

product:retailer_item_id

必須。

アイテムの小売店のID。ピクセルベースのカタログに対応。

product:sale_price:amount

任意。

アイテムがセール中であれば、割引価格。販売価格の小数点には「.」を使います。割引価格にオーバーレイを使う予定の場合、販売価格は必須です。ピクセルベースのカタログに対応。


注: 一般に、ピクセルベースのカタログの場合、メインのog:price:amountタグを使って価格の変更を把握するだけにするよう、おすすめします。販売価格タグを使う場合は、product:sale_price_dates:startとproduct:sale_price_dates:endのタグを使ってセールの開始と終了を指定してください。終了日がない場合、販売価格が無期限に表示される可能性があります。


例: 9.99

product:sale_price:currency

任意。

アイテムがセール中の場合の割引価格の通貨(3桁のISO通貨コード)。ピクセルベースのカタログに対応。

例: USD

product:sale_price_dates:start

任意。

自分のタイムゾーンでのセール開始日時。YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59のようにスラッシュで区切って表記します。開始日と終了日はYYYY-MM-DDのように表記します。時間は24時間形式(0:00～23:59)です。各日付の後に「T」を付加し、その後に時刻を指定します。終了時刻がタイムゾーンを表します。この例では03:00がタイムゾーンを表します。ピクセルベースのカタログに対応。

例: 2017-11-01T12:00-03:00/2017-12-01T00:00-03:00

product:sale_price_dates:end

任意。

自分のタイムゾーンでのセール終了日時。YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59のようにスラッシュで区切って表記します。開始日と終了日はYYYY-MM-DDのように表記します。時間は24時間形式(0:00～23:59)です。各日付の後に「T」を付加し、その後に時刻を指定します。終了時刻がタイムゾーンを表します。この例では03:00がタイムゾーンを表します。ピクセルベースのカタログに対応。

例: 2017-11-01T12:00-03:00/2017-12-01T00:00-03:00

Schema.org – 必須タグ

各フィールドは最大500文字です。

名前説明

name

アイテムのタイトル。

brand

アイテムのブランド。

description

アイテムの説明。

productID

アイテムの小売店のID。

url

商品ページの完全なURL。

image

商品ページに使われている画像へのリンク。

price

アイテムの現在の価格。価格に「$」などの記号は含めないでください。この項目はoffersの下に含めてください。価格を示す数値の後に3桁のISO通貨コード(ISO 4217標準規格)を表記し、金額と通貨コードの間にスペースを1個入れます。小数点にはピリオド「.」を使います。

広告やコマースチャネルで顧客に対して表示される商品価格で複数の通貨が混在することがないようにするため、カタログに含める通貨は1つだけにすることをおすすめします。外国向けまたは他言語向けに表示する商品情報や価格を追加する場合は、国フィードまたは言語フィードをカタログにアップロードします。

priceCurrency

価格の通貨(USDなどのISO形式)。この項目はoffersの下に含めてください。小数点には「,」ではなく「.」を使います。価格に「$」などの記号は含めないでください。例: 1500.00。

availability

商品の現在の在庫状況: in stock、out of stock、available for order、discontinued。この項目はoffersの下に含めてください。

condition

アイテムの現在の状態: new、refurbished、used。この項目はoffersの下に含めてください。

Schema.orgのJSON-LD — 必須タグ

各フィールドは最大500文字です。

schema.org/Productからの抜粋

名前説明

name

アイテムのタイトル。

brand

アイテムのブランド。

description

アイテムの説明。

productID

アイテムの小売店のID。

url

商品ページの完全なURL。

offers

schema.org/Offer型オブジェクトの配列。

image

商品ページに使われている画像へのリンク。

schema.org/Offerからの抜粋(商品オファーの一部として)

名前説明

price

アイテムの現在の価格。価格に「$」などの記号は含めないでください。この項目はoffersの下に含めてください。

priceCurrency

価格の通貨(USDなどのISO形式)。この項目はoffersの下に含めてください。

availability

商品の現在の在庫状況: in stock、out of stock、available for order、discontinued。この項目はoffersの下に含めてください。

condition

アイテムの現在の状態: new、refurbished、used。この項目はoffersの下に含めてください。

JSONスキーマエクスポート

カタログのメインフィールドとカテゴリフィールドのJSONスキーマダウンロードが以下のように提供されています。

このJSONスキーマは、アップロード可能なフィードフォーマットではありません。フィードフィールド、例、データタイプのうち、Metaのドキュメントに既存ではないものに関する代替リファレンスとして提供されていることに注意してください。このスキーマは主に、開発者が内部カテゴリとフィールドマッピングを、プログラムによりMetaのカタログスキーマに揃えるために使うことを意図したものです。アップロード可能なフィードについては、このドキュメントの他の場所に示されているフィードフォーマットをご覧ください。

commonキーの下にあるすべてのフィールドがメインフィールドになります。それ以外は、カテゴリ名が親キーになります。各フィールドのフォーマットは、次の例に示すとおりです。

"item_group_id": {
          "description": "Use this field to create variants of the same item. Enter the same group ID for all variants within a group. Learn more about variants: https:\/\/www.facebook.com\/business\/help\/2256580051262113 Character limit: 100.",
          "example": "K456653443",
          "type": "String",
          "required": false,
          "recommended": false
      },

優先順位をしっかり把握するため、"recommended": trueの値はカテゴリ固有のフィールドだけであること(本来はすべて任意指定)に注意してください。

詳しくはこちら

広告ヘルプセンター

APIリファレンス

マーケティングAPI