Danh mục sản phẩm là một vùng chứa thông tin về sản phẩm của bạn. Mỗi sản phẩm riêng lẻ được mô tả qua một tập hợp trường sẽ được sử dụng khác nhau tùy theo cách bạn sử dụng danh mục của mình.
Có thể bạn đã có danh mục sản phẩm dành cho quảng cáo danh mục Advantage+ trên Facebook. Danh mục này chứa tập hợp các trường bắt buộc có thể được dùng làm nền tảng cho danh mục Thương mại của bạn.
Hãy sử dụng hướng dẫn này để tìm hiểu thêm về các yêu cầu và đề xuất đối với trường bổ sung:
Trường danh mục là công cụ để đánh giá chất lượng trải nghiệm cho khách hàng mua sản phẩm tại Cửa hàng trên Facebook hoặc các kênh Mua sắm trên Instagram của bạn:
Chi tiết sản phẩm - Trường danh mục được dùng để điền thông tin cho từng mặt hàng trên trang Chi tiết sản phẩm. Trường này bao gồm những thông tin quan trọng như mô tả sản phẩm, hình ảnh, mẫu kích cỡ/màu sắc, giá và danh sách cung ứng. Dữ liệu bị thiếu hoặc không chính xác có thể ảnh hưởng tiêu cực đến trải nghiệm người dùng, tác động đến tỷ lệ chuyển đổi thành mua hàng hoặc gây hiểu nhầm và hủy hoại niềm tin.
Logic kinh doanh - Một số trường được dùng để thông báo logic kinh doanh trên hệ thống phụ trợ của chúng tôi. Ví dụ: trường google_product_category
xác định thuế suất áp dụng cho sản phẩm của bạn. Trường này cũng được dùng để xác định xem sản phẩm có đủ điều kiện áp dụng Quy định bảo vệ mua hàng hay không. Hạng mục sản phẩm không đúng có thể ảnh hưởng đến việc tính thuế và dẫn đến số tiền nộp thuế không chính xác.
Đối với Cửa hàng trên Facebook, khách hàng cần cung cấp tập hợp thông tin tối thiểu về các món sản phẩm của họ để tải lên Cửa hàng. Chúng tôi cũng yêu cầu tương tự khi bạn chạy chiến dịch quảng cáo danh mục Advantage+. Nếu doanh nghiệp của bạn đang sử dụng phương thức thanh toán trực tiếp, bạn cần có thêm trường bắt buộc khác, ví dụ: quantity_to_sell_on_fb
. Tìm hiểu thêm về các trường được hỗ trợ cho danh mục của bạn.
Khi sử dụng các trường dành riêng cho hạng mục, bạn phải cung cấp thông tin nhận dạng hạng mục - Hạng mục sản phẩm của Google hoặc Hạng mục sản phẩm của Facebook. Nếu cung cấp một trong các trường hạng mục này, bạn cũng có thể sử dụng các trường bổ sung dành riêng cho hạng mục đó để cung cấp thêm thông tin chi tiết về mặt hàng của mình.
Khi chúng tôi mở rộng tính năng của nền tảng, bạn có thể được hỗ trợ thêm về các trường hợp sử dụng khác từ trường danh mục.
Mỗi mặt hàng trong nguồn cấp dữ liệu sản phẩm của bạn đều hỗ trợ các thuộc tính cơ bản phổ biến sau.
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 |
---|---|
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: 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. |
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: This field is supported by supplementary feeds. |
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. |
Type: string | The current availability of the item. Must be written in U.S. English. Supported values:
Items that are out of stock display as "sold out" in your shop. They don't display at all in your ads. Example: |
Type: string | The condition of the item. Supported values: Example: |
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: |
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: |
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: 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. |
Type: string | Max characters: 100 The brand name of the item. Example: |
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 |
---|---|
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 Example: This field was previously called |
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: This field is supported by supplementary feeds. |
You can also include many optional fields to share more product information with customers or control how items are displayed.
Attribute and Type | Description |
---|---|
Type: string | If the item is on sale, enter its discounted price. Use the same formatting as the Example: |
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
Example (using PST time zone -08:00):
|
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: |
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: Example: Note: Some partner platforms such as Shopify may sync items to your catalog with a status called staging, which behaves the same as This field was previously called |
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 Since this field takes a string, the entire list of URLs must be formatted with double quotes. For example: To display additional images in your ads, see Dynamic Ads, Ad Template This field is supported by supplementary feeds. |
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: 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. |
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: 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 ( This field is supported by supplementary feeds. |
Type: string | Max character limit: 200 The main color of the item. Describe the color in words, not a hex code. Example: This field is supported by supplementary feeds. |
Type: string | The gender your item is targeted towards. Supported values: Example: This field is supported by supplementary feeds. |
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: This field is supported by supplementary feeds. |
Type: string | The age group the item is targeted towards. Accepted values: Example: This field is supported by supplementary feeds. |
Type: string | Character limit: 200 Example: This field is supported by supplementary feeds. |
Type: string | Max character limit: 100 The pattern or graphic print on the item. Example: This field is supported by supplementary feeds. |
Type: string | This allows you to use a shipping-related overlay in your ads. Shipping details for the item, formatted as:
Example: |
Type: string | Shipping weight of the item in Example: |
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 ( This field was previously called |
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: This field is supported by supplementary feeds. |
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: |
Type: string | Max characters: 9999 The rich text (HTML) description for item. Note: If this field is provided, we use it instead of Supported tags include:
Note: Any attributes of the html tags such as 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. |
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: |
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. |
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: This field is supported by supplementary feeds. |
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 Centiliters: This information is uploaded via feed uploads in the {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 |
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:
Example: This field is supported by supplementary feeds. |
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: |
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. |
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"} |
Type: string | Link to mobile-optimized page for item on the merchant's website. |
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: For Android, we require Learn more about product deep links. |
| 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 |
Attribute and Type | Description |
---|---|
| The item's country of origin. Enter the two-letter ISO country code Example value: This field is supported by supplementary feeds. |
| If the country of origin is not India, provide the legal entity name of the item's importer Example value: This field is supported by supplementary feeds. |
| 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:
The overall address will be displayed to users in the following format:
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. |
| 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. |
| 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 ( Supported values (case sensitive):
|
Tìm hiểu thêm về các định dạng nguồn cấp dữ liệu được hỗ trợ.
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 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 & 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 & 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>