目录

参考文档 - 目录

支持的信息库格式

应使用目录将库存上传至 Facebook。对于每个目录，应使用以下其中一种受支持的格式提供商品信息库：CSV、TSV、RSS XML、ATOM XML 或 Google 表格。

格式描述

CSV

以英文逗号分隔的值。此格式适用于大多数电子表格程序。第一行是列标题，后续行会为每个路由提供相应的值。


包含空格或逗号的字段应使用英文双引号括起来。如要在已使用英文双引号括起来的字段中使用英文双引号，必须用两个连续的英文双引号进行转义。

示例："Join our ""Royal"" membership program"。


嵌套或多值字段（例如图片）可使用 JSON 编码值表示，也可以通过用 JSON 路径语法标记的一组“平展”纯文本列来表示。

示例：image[0].url、image[0].tag[0]、image[0].tag[1])


您可以在同一个文件中交替使用这两种惯例做法。

请参阅适用于进阶赋能型目录广告的 CSV 信息库示例和适用于电商的 CSV 信息库示例。


下载（右键点击 > 链接另存为）

在创建信息库时，您可以引用我们的 CSV (.csv) 示例文件，但我们建议使用电商管理工具作为您的主要来源。

TSV

以制表符分隔的值。此格式适用于大多数电子表格程序。请参阅适用于 CSV 的准则。

下载（右键点击 > 链接另存为）

RSS XML

丰富站点摘要可扩展标记语言。一个根 XML 节点包含一组节点，每个节点代表一个路由。文件必须以 declaration 标签开头。此格式的文件通常由自动化信息库提供方系统或网络服务器生成。代表商品清单的一组商品 XML 节点，必须以 <?xml 声明标签开头。

通常由自动化信息库提供方系统或网络服务器生成。

下载（右键点击 > 链接另存为）

如果您收到错误，这表示 XML 数据信息库文件中的行过长，超过 5,242,880 个字节或字符的大小限制。请将 XML 文件重新调整为每行包含 1 个字段的多行文件，然后再次上传您的文件。如需了解详情，请参阅数据信息库错误疑难解答。

Atom XML

Atom 联合格式是用于网络信息库的 XML 语言，而 Atom 发布协议（简称 AtomPub 或 APP）是基于 HTTP 的简单协议，用于创建和更新网络资源。此格式的文件通常由自动化信息库提供方系统或网络服务器生成。代表商品清单的一组商品 XML 节点，必须以 <?xml 声明标签开头。通常由自动化信息库提供方系统或网络服务器生成。请参阅适用于电商的 XML 信息库 (Atom) 示例。

下载（右键点击 > 链接另存为）

Google 表格

电商管理工具现在还支持将 Google 表格用于定期更新信息库：

  1. 使用 Google 表格，以电子表格形式创建数据信息库并获取可分享的链接。
  2. 在电商管理工具中添加商品时，选择“Google 表格”选项。复制可分享的链接并粘贴到相应字段，完成上传。
  3. 之后继续在该 Google 电子表格中管理您的库存，我们会在预定的时间提取该表格的数据。

详细了解

信息库示例

CSV 信息库示例 — 进阶赋能型目录广告

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, unique manufacturer part number (MPN) or Global Trade Item Number (GTIN) of the item. You only need to enter one of these, not all of them. For GTIN, enter the item's UPC, EAN, JAN or ISBN.


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

product_tags

Type:

array<string>

Max array size: 5000

Max single tag size: 110 characters


Array of technical tags which can be applied to a product for the purpose of creating product sets.


The content of this field is never displayed to consumers; therefore, updating it will not trigger an integrity review.


Use lowercase letters only, leading and trailing whitespaces are not allowed.


Example: [luxury,winter]

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

Product's Global Trade Item Number (GTINs). Exclude dashes and spaces. Submit only valid GTINs as defined by the GTIN validation guide. Supported values are UPC (North America, 12 digits), EAN (Europe, 13 digits), JAN (Japan, 8 or 13 digits), ISBN (books, 13 digits).


Example: 4011200296908

This field is supported by supplementary feeds.

mpn

Type: string

Max characters: 100.

Unique manufacturer ID for item. For commerce, Daily Deals inventory must also include brand if mpn is provided.


Example: 100020003

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 字段。如要投放进阶赋能型目录广告，每件商品的编号必须与该商品在原始目录数据信息库中的编号以及 Pixel 像素代码中的内容编号一致。
  • 您必须加入 override 字段。如果您想要提供特定语言版本的本地化信息，或在特定国家/地区提供本地化信息，请在此字段中输入相关语言或国家/地区的 ISO 代码。如果您想要提供特定语言版本的本地化信息，或在特定国家/地区提供本地化信息，请在此字段中输入相关语言或国家/地区的 ISO 代码。override 列中的值应该是支持的 ISO 语言代码或支持的 ISO 国家/地区代码。进一步了解支持的语言代码和国家/地区代码。

查看“使用本地化库存信息创建数据信息库”的第 2 步和第 3 步，进一步了解 id 和 override 字段。

商品

  • 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]

如需参考信息，请参阅车辆字段的主要清单。

开放图谱标签

每个字段最多可使用 500 个字符。

主要图片的链接是必要项。任何其他图片的链接是可选项。
名称描述

og:title

必要。

商品的名称。支持基于 Pixel 像素代码的目录。

og:description

必要。

商品的描述。支持基于 Pixel 像素代码的目录。

og:url

必要。

商品页面的完整网址。支持基于 Pixel 像素代码的目录。

og:image

对于主要图片的链接，此为必要项。对于其他图片的链接，此为可选项。

在商品页面上使用的图片的链接。主要图片的链接是必要项。任何其他图片的链接是可选项。支持基于 Pixel 像素代码的目录。

og:locale

如果使用多语言目录，此为必要项。

指定商品来自哪个版本的网站；例如，设置为 en_GB，可指定商品来自英国网站。支持基于 Pixel 像素代码的目录。

og:price:amount

必要。

商品的当前价格。对于分隔符，请使用英文句点（“.”）来表示小数点，而不是英文逗号（“,”）。请勿在 price 字段中加入类似“$”的符号。支持基于 Pixel 像素代码的目录。

示例：1500.00

og:price:currency

必要。

价格所使用的货币，使用 ISO 格式。支持基于 Pixel 像素代码的目录。

示例：USD

product:brand

必要。

商品的品牌名称。支持基于 Pixel 像素代码的目录。

product:availability

必要。

商品的当前库存情况：in stock、out of stock、available for order、discontinued。支持基于 Pixel 像素代码的目录。

product:catalog_id

可选。

商品的独立目录编号。可以是商品的一个款式。导入商品后，此字段会映射到 retailer_id。id 字段必须与您 Pixel 像素代码的内容编号相一致。支持基于 Pixel 像素代码的目录。

product:category

可选。

字符数上限：250。支持基于 Pixel 像素代码的目录。

对于进阶赋能型目录广告，此字段是来自 Google 产品分类的预先定义值（字符串或类别编号）。

对于电商，此字段是根据 Google 产品分类确定的商品类别。详细了解有关电商的商品类别。

详情请参阅广告帮助中心 > 目录商品的 Google 商品类别。

product:condition

必要。

商品的当前状态：new、refurbished、used。支持基于 Pixel 像素代码的目录。

product:custom_label_[0-4]

可选。

字符数上限：100

您想要添加的与商品相关的其他信息。支持基于 Pixel 像素代码的目录。

product:gender

可选。

确定尺寸适合的性别：Female、Male、Unisex。支持基于 Pixel 像素代码的目录。

product:item_group_id

可选。

对于进阶赋能型目录广告 - 商品的款式。请为商品的所有不同款式提供相同的 item_group_id。例如，红色 Polo 衫是 Polo 衫的一种款式。在获取您的信息库后，Facebook 会将该参数映射到 retailer_product_group_id。借助进阶赋能型目录广告，Facebook 会根据通过 Pixel 像素代码事件或应用事件收到的信号，从商品组中仅选择一个商品。

对于电商 - 请为商品的所有款式提供相同的 product_group_id。例如，红色 Polo 衫是 Polo 衫的一种款式。在获取您的信息库后，Facebook 会将该参数映射到 retailer_product_group_id。详细了解商品款式。支持基于 Pixel 像素代码的目录。

示例：FB1234_shirts

product:gtin

可选。

商品的全球贸易商品代码 (GTIN)。其中不能有破折号和空格。请仅提交 GTIN 验证指南规定的有效 GTIN。支持的值：UPC（北美，12 个数字）、EAN（欧洲，13 个数字）、JAN（日本，8 或 13 个数字）、ISBN（书籍，13 个数字）。支持基于 Pixel 像素代码的目录。

示例：4011200296908

product:isbn

可选。

国际标准书号 (ISBN)。ISBN 由 13 个数字组成。支持基于 Pixel 像素代码的目录。

product:mfr_part_no

可选。

商品的专属制造商零件号。对于电商，如果提供 mpn，则每日优惠库存必须还包含 brand。支持基于 Pixel 像素代码的目录。

示例：100020003

material

可选。

商品的材质。支持的值：cotton、denim、leather。支持基于 Pixel 像素代码的目录。

示例：cotton

product:locale

如果使用多语言目录，此为必要项。

指定商品来自哪个版本的网站；例如，设置为 en_GB，可指定商品来自英国网站。支持基于 Pixel 像素代码的目录。

product:price:amount

必要。

商品的当前价格。对于分隔符，请使用英文句点（“.”）来表示小数点，而不是英文逗号（“,”）。请勿在 price 字段中加入类似“$”的符号。支持基于 Pixel 像素代码的目录。

示例：1500.00

product:price:currency

必要。

价格所使用的货币，使用 ISO 格式。支持基于 Pixel 像素代码的目录。

示例：USD

product:retailer_item_id

必要。

商品的零售商编号。支持基于 Pixel 像素代码的目录。

product:sale_price:amount

可选。

促销商品的折扣价。请使用英文句点（“.”）作为优惠价的小数点。如果您计划使用折扣价标签，必须设置优惠价。支持基于 Pixel 像素代码的目录。


注意：一般而言，对于基于 Pixel 像素代码的目录，我们建议使用主要的 og:price:amount 标签来获取任何价格方面的变动情况。如果您使用优惠价标签，请务必同时使用 product:sale_price_dates:start 标签和 product:sale_price_dates:end 标签，以显示促销的开始日期和结束日期。如果没有结束日期，优惠价可能会一直显示。


示例：9.99

product:sale_price:currency

可选。

当商品处于促销期间，折扣价使用的货币，格式为 3 个数字组成的 ISO 货币代码。支持基于 Pixel 像素代码的目录。

示例：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 表示时区。支持基于 Pixel 像素代码的目录。

示例：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 表示时区。支持基于 Pixel 像素代码的目录。

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

Schema.org – 必要的标签

每个字段最多可使用 500 个字符。

名称描述

name

商品的名称。

brand

商品的品牌。

description

商品的描述。

productID

商品的零售商编号。

url

商品页面的完整网址。

image

在商品页面上使用的图片的链接。

price

商品的当前价格。请勿在 price 字段中加入类似“$”的符号。在“offers”下加入此条目。价格格式为数字后加 3 个数字的 ISO 货币代码（ISO 4217 标准），价格与货币之间应留有一个空格。请使用英文句点（“.”）作为小数点。

建议您在目录中仅加入一 (1) 种货币，以免顾客在广告或电商渠道中看到的商品货币不一致。如要添加在其他国家/地区显示的商品信息和价格，或其他语言版本的商品信息和价格，请改为将特定国家/地区信息库或语言信息库上传到您的目录。

priceCurrency

价格所使用的货币，使用 ISO 格式（例如 USD）。在“offers”下加入此条目。对于分隔符，请使用英文句点（“.”）来表示小数点，而不是英文逗号（“,”）。请勿在 price 字段中加入类似“$”的符号。示例：1500.00。

availability

商品的当前库存情况：in stock、out of stock、available for order、discontinued。在“offers”下加入此条目。

condition

商品的当前状态：new、refurbished、used。在“offers”下加入此条目。

JSON-LD for Schema.org – 必要标签

每个字段最多可使用 500 个字符。

从 schema.org/Product 中提取

名称描述

name

商品的名称。

brand

商品的品牌。

description

商品的描述。

productID

商品的零售商编号。

url

商品页面的完整网址。

offers

由 schema.org/Offer 类型的对象组成的数组。

image

在商品页面上使用的图片的链接。

从 schema.org/Offer（作为商品优惠的一部分）中提取

名称描述

price

商品的当前价格。请勿在 price 字段中加入类似“$”的符号。在“offers”下加入此条目。

priceCurrency

价格所使用的货币，使用 ISO 格式（例如 USD）。在“offers”下加入此条目。

availability

商品的当前库存情况：in stock、out of stock、available for order、discontinued。在“offers”下加入此条目。

condition

商品的当前状态：new、refurbished、used。在“offers”下加入此条目。

JSON 架构文件导出

我们在这里提供了包含所有目录主要字段和类别字段的 JSON 架构文件下载地址：

请注意，此 JSON 架构文件未使用可上传的信息库格式，而是提供作为我们文档中已介绍的信息库字段、示例和数据类型的补充参考资料。此 JSON 架构主要面向以下开发者：试图通过编程方式，实现内部类别和字段映射与 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