Danh mục

Tài liệu tham khảo - Danh mục

Định dạng nguồn cấp dữ liệu được hỗ trợ

Bạn phải tải danh sách cung ứng lên Facebook theo danh mục. Đối với mỗi danh mục, bạn phải cung cấp nguồn cấp dữ liệu sản phẩm ở một trong những định dạng được hỗ trợ, đó là: CSV, TSV, RSS XML, ATOM XML hoặc Google Trang tính.

Định dạngMô tả

CSV

Giá trị được phân tách bằng dấu phẩy. Phù hợp với hầu hết các chương trình bảng tính. Hàng đầu tiên chỉ định tiêu đề cột. Các hàng tiếp theo cung cấp giá trị tương ứng cho mỗi lộ trình.


Các trường chứa khoảng trống hoặc dấu phẩy phải được đặt trong "ngoặc kép". Dấu ngoặc kép bên trong trường có dấu ngoặc kép phải được thoát bằng 2 dấu ngoặc kép liên tiếp.

Ví dụ: "Join our ""Royal"" membership program".


Đối với những trường lồng nhau hoặc có nhiều giá trị như hình ảnh, bạn có thể biểu thị bằng các giá trị mã hóa JSON hoặc một tập hợp các cột văn bản thuần túy "đã làm phẳng" được gắn nhãn theo cú pháp đường dẫn JSON.

Ví dụ: image[0].url, image[0].tag[0], image[0].tag[1])


Bạn có thể sử dụng cả hai quy ước thay cho nhau trong cùng một file.

Hãy xem ví dụ về nguồn cấp dữ liệu CSV cho quảng cáo danh mục Advantage+ và nguồn cấp dữ liệu CSV cho mục đích thương mại.


Tải xuống (Nhấp chuột phải > Lưu liên kết dưới dạng)

Bạn có thể tham khảo file CSV (.csv) mẫu của chúng tôi khi tạo nguồn cấp dữ liệu, nhưng nên sử dụng Công cụ quản lý thương mại làm nguồn chính.

TSV

Giá trị được phân tách bằng tab. Phù hợp với hầu hết các chương trình bảng tính. Hãy xem nguyên tắc đối với CSV.

Tải xuống (Nhấp chuột phải > Lưu liên kết dưới dạng)

RSS XML

Rich-Site Summary, Ngôn ngữ đánh dấu mở rộng. Nút XML gốc chứa một tập hợp các nút, mỗi nút biểu thị một lộ trình. File phải bắt đầu bằng thẻ declaration. Định dạng thường được tạo bằng các hệ thống cung cấp nguồn cấp dữ liệu tự động hoặc máy chủ web. Tập hợp nút XML mặt hàng biểu thị danh sách sản phẩm và phải bắt đầu bằng thẻ khai báo <?xml.

Thường được tạo bằng các hệ thống cung cấp nguồn cấp dữ liệu tự động hoặc máy chủ web.

Tải xuống (Nhấp chuột phải > Lưu liên kết dưới dạng)

Nếu bạn nhận được lỗi, tức là một dòng nào đó trong file nguồn cấp dữ liệu XML của bạn quá dài và vượt quá giới hạn kích thước 5.242.880 byte hoặc ký tự. Vui lòng định dạng lại file XML thành nhiều dòng với 1 trường mỗi dòng và tải file này lên lần nữa. Để biết thêm thông tin, hãy xem bài viết Khắc phục lỗi nguồn cấp dữ liệu.

Atom XML

Định dạng phân phối Atom là một ngôn ngữ XML được dùng cho nguồn cấp dữ liệu trên web, còn Giao thức phát hành Atom (AtomPub hoặc APP) là một giao thức đơn giản dựa trên HTTP để tạo và cập nhật tài nguyên trên web. Định dạng thường được tạo bằng các hệ thống cung cấp nguồn cấp dữ liệu tự động hoặc máy chủ web. Tập hợp nút XML mặt hàng biểu thị danh sách sản phẩm và phải bắt đầu bằng thẻ khai báo <?xml. Thường được tạo bằng các hệ thống cung cấp nguồn cấp dữ liệu tự động hoặc máy chủ web. Hãy xem nguồn cấp dữ liệu XML mẫu (Atom) cho mục đích thương mại.

Tải xuống (Nhấp chuột phải > Lưu liên kết dưới dạng)

Google Trang tính

Công cụ quản lý thương mại hiện cũng hỗ trợ Google Trang tính cho nguồn cấp dữ liệu đã lên lịch:

  1. Tạo nguồn cấp dữ liệu của bạn dưới dạng bảng tính trong Google Trang tính và lấy liên kết có thể chia sẻ.
  2. Khi bạn thêm sản phẩm vào Công cụ quản lý thương mại, hãy chọn Google Trang tính. Sao chép và dán vào liên kết có thể chia sẻ rồi hoàn tất quá trình tải lên.
  3. Tiếp tục quản lý danh sách cung ứng của bạn trong bảng tính Google trong tương lai và chúng tôi sẽ tìm nạp từ bảng tính đó theo thời gian đã lên lịch.

Tìm hiểu thêm

Nguồn cấp dữ liệu mẫu

Nguồn cấp dữ liệu CSV mẫu - Quảng cáo danh mục 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

Nguồn cấp dữ liệu CSV mẫu - Thương mại

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

Nguồn cấp dữ liệu XML mẫu (Atom) - Thương mại

<?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>

Định dạng nguồn cấp dữ liệu - Lên lịch tìm nạp nguồn cấp dữ liệu

Để lên lịch tìm nạp nguồn cấp dữ liệu, hãy xem các định dạng gợi ý ở bên dưới.

Định dạng nguồn cấp dữ liệu Trường hợp sử dụng Nguồn cấp dữ liệu mẫu

CSV

Cập nhật price và availability cho một nhóm nhỏ các mặt hàng.

Tải xuống (Nhấp chuột phải và Lưu liên kết dưới dạng)

TSV

Đặt lại sale_price và cập nhật custom_label_0 cho một nhóm nhỏ các mặt hàng

Tải xuống (Nhấp chuột phải và Lưu liên kết dưới dạng)

Trường danh mục được hỗ trợ

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 của bạn trên Facebook hoặc Instagram.

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ư nội dung mô tả sản phẩm, hình ảnh, mẫu kích cỡ/màu sắc, giá và tình trạng còn hàng. Dữ liệu bị thiếu hoặc không hợp lệ 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 mua hàng hoặc gây hiểu nhầm và hủy hoại niềm tin.

Trường được hỗ trợ cho sản phẩm

Bảng dưới đây xác định các trường được dùng để tạo danh mục, bao gồm cả mức độ yêu cầu (bắt buộc và không bắt buộc). Để đặt tên cột hiệu quả nhất theo quy ước, hãy dùng tiếng Anh Mỹ cho tất cả các trường.

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.

Trường được hỗ trợ - Danh mục đã bản địa hóa

Yêu cầu

  • Bạn phải thêm trường id vào file nguồn cấp dữ liệu phụ của mình. Để chạy quảng cáo danh mục Advantage+, ID của từng mặt hàng phải khớp với ID trong nguồn cấp dữ liệu danh mục gốc và ID nội dung của mặt hàng đó trong pixel.
  • Bạn phải thêm trường override. Trong trường này, hãy nhập mã ISO cho ngôn ngữ hoặc quốc gia mà bạn muốn cung cấp thông tin được bản địa hóa. Trong trường này, hãy nhập mã ISO cho ngôn ngữ hoặc quốc gia mà bạn muốn cung cấp thông tin được bản địa hóa. Giá trị trong cột override phải là mã ngôn ngữ theo tiêu chuẩn ISO được hỗ trợ hoặc mã quốc gia theo tiêu chuẩn ISO được hỗ trợ. Tìm hiểu thêm về mã ngôn ngữ và mã quốc gia được hỗ trợ.

Tìm hiểu thêm về các trường id và override trong bài viết Tạo nguồn cấp dữ liệu bằng thông tin danh sách cung ứng đã bản địa hóa, bước 2 và 3.

Sản phẩm

  • 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

Để bản địa hóa các trường applink, bạn phải cung cấp tất cả những trường đó. Hãy tìm hiểu thêm về liên kết sâu đến sản phẩm.

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

Để bản địa hóa hình ảnh, bạn phải sử dụng các trường hình ảnh lồng nhau, đó là image[0].url và image[0].tag[0]. Không hỗ trợ bản địa hóa trường image_link.

Để tham khảo, hãy xem danh sách chính các trường cho sản phẩm.

Khách sạn

  • 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

Để bản địa hóa các trường applink, bạn phải cung cấp tất cả những trường đó. Hãy tìm hiểu thêm về liên kết sâu đến sản phẩm.

Để tham khảo, hãy xem danh sách chính các trường cho khách sạn.

Chuyến bay

  • 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

Để bản địa hóa các trường applink, bạn phải cung cấp tất cả những trường đó. Hãy tìm hiểu thêm về liên kết sâu đến sản phẩm.

Để tham khảo, hãy xem danh sách chính các trường cho chuyến bay.

Điểm đến

  • 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

Để bản địa hóa các trường applink, bạn phải cung cấp tất cả những trường đó. Hãy tìm hiểu thêm về liên kết sâu đến sản phẩm.

Để tham khảo, hãy xem danh sách chính các trường cho điểm đến.

Bài niêm yết nhà

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

Để tham khảo, hãy xem danh sách chính các trường cho bài niêm yết nhà.

Xe cộ

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

Để tham khảo, hãy xem danh sách chính các trường cho xe cộ.

Thẻ OpenGraph

Mỗi trường có tối đa 500 ký tự.

Bắt buộc phải có liên kết hình ảnh chính. Mọi liên kết hình ảnh bổ sung là không bắt buộc.
TênMô tả

og:title

Bắt buộc.

Tên mặt hàng. Hỗ trợ danh mục dựa trên pixel.

og:description

Bắt buộc.

Nội dung mô tả mặt hàng. Hỗ trợ danh mục dựa trên pixel.

og:url

Bắt buộc.

URL hoàn chỉnh cho trang sản phẩm. Hỗ trợ danh mục dựa trên pixel.

og:image

Bắt buộc đối với liên kết chính. Không bắt buộc đối với liên kết hình ảnh bổ sung.

Liên kết đến hình ảnh được dùng trên trang sản phẩm. Bắt buộc phải có liên kết hình ảnh chính. Mọi liên kết hình ảnh bổ sung là không bắt buộc. Hỗ trợ danh mục dựa trên pixel.

og:locale

Bắt buộc nếu sử dụng danh mục đa ngôn ngữ.

Chỉ định phiên bản trang web của sản phẩm, chẳng hạn như en_GB cho trang web ở Vương quốc Anh. Hỗ trợ danh mục dựa trên pixel.

og:price:amount

Bắt buộc.

Giá hiện tại của mặt hàng. Đối với dấu phân cách, hãy sử dụng dấu "." thay cho dấu "," để ngăn cách phần thập phân. Không thêm các ký hiệu như "$" vào giá. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: 1500.00

og:price:currency

Bắt buộc.

Đơn vị tiền tệ của giá ở định dạng theo tiêu chuẩn ISO. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: USD

product:brand

Bắt buộc.

Tên thương hiệu của mặt hàng. Hỗ trợ danh mục dựa trên pixel.

product:availability

Bắt buộc.

Tình trạng còn hàng hiện tại của mặt hàng: in stock, out of stock, available for order, discontinued. Hỗ trợ danh mục dựa trên pixel.

product:catalog_id

Không bắt buộc.

ID danh mục duy nhất cho mặt hàng. Có thể là mẫu mã của sản phẩm. ID này sẽ ánh xạ đến retailer_id sau khi bạn nhập sản phẩm. Trường id phải khớp với ID nội dung cho pixel của bạn. Hỗ trợ danh mục dựa trên pixel.

product:category

Không bắt buộc.

Số ký tự tối đa: 250. Hỗ trợ danh mục dựa trên pixel.

Đối với quảng cáo danh mục Advantage+, trường này biểu thị các giá trị định sẵn (chuỗi hoặc ID hạng mục) trong hệ thống phân loại sản phẩm của Google.

Đối với mục đích thương mại, trường này biểu thị hạng mục của sản phẩm theo hệ thống phân loại sản phẩm của Google. Tìm hiểu thêm về hạng mục sản phẩm cho mục đích thương mại.

Tìm hiểu thêm về Hạng mục sản phẩm của Google cho mặt hàng trong danh mục, Trung tâm trợ giúp quảng cáo.

product:condition

Bắt buộc.

Tình trạng hiện tại của mặt hàng: new, refurbished, used. Hỗ trợ danh mục dựa trên pixel.

product:custom_label_[0-4]

Không bắt buộc.

Số ký tự tối đa: 100

Thông tin bổ sung về mặt hàng mà bạn muốn thêm. Hỗ trợ danh mục dựa trên pixel.

product:gender

Không bắt buộc.

Xác định giới tính để định cỡ: Female, Male, Unisex. Hỗ trợ danh mục dựa trên pixel.

product:item_group_id

Không bắt buộc.

Đối với quảng cáo danh mục Advantage+ - Mặt hàng là các mẫu mã của một sản phẩm. Hãy cung cấp cùng một item_group_id cho tất cả mặt hàng là mẫu mã. Ví dụ: Áo thun có cổ màu đỏ là một mẫu mã của Áo thun có cổ. Facebook sẽ ánh xạ thông tin này đến retailer_product_group_id sau khi chúng tôi nhận được nguồn cấp dữ liệu của bạn. Với quảng cáo danh mục Advantage+, Facebook chỉ chọn duy nhất 1 mặt hàng trong nhóm dựa trên tín hiệu mà chúng tôi nhận được từ sự kiện pixel hoặc sự kiện trong ứng dụng.

Đối với mục đích thương mại - Hãy cung cấp cùng một product_group_id cho tất cả mặt hàng là mẫu mã. Ví dụ: Áo thun có cổ màu đỏ là một mẫu mã của Áo thun có cổ. Facebook sẽ ánh xạ thông tin này đến retailer_product_group_id sau khi chúng tôi nhận được nguồn cấp dữ liệu của bạn. Tìm hiểu thêm về Mẫu mã sản phẩm. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: FB1234_shirts

product:gtin

Không bắt buộc.

Mã số sản phẩm thương mại toàn cầu (GTIN) của sản phẩm. Không bao gồm dấu gạch ngang và dấu cách. Chỉ gửi GTIN hợp lệ theo quy định trong hướng dẫn xác thực GTIN. Các giá trị được hỗ trợ là UPC (Bắc Mỹ, 12 chữ số), EAN (Châu Âu, 13 chữ số), JAN (Nhật Bản, 8 hoặc 13 chữ số), ISBN (sách, 13 chữ số). Hỗ trợ danh mục dựa trên pixel.

Ví dụ: 4011200296908

product:isbn

Không bắt buộc.

Mã số tiêu chuẩn quốc tế cho sách (ISBN). ISBN gồm 13 chữ số. Hỗ trợ danh mục dựa trên pixel.

product:mfr_part_no

Không bắt buộc.

Mã số linh kiện duy nhất của nhà sản xuất cho mặt hàng. Đối với mục đích thương mại, danh sách cung ứng Ưu đãi hàng ngày phải có cả thương hiệu nếu bạn cung cấp mpn. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: 100020003

material

Không bắt buộc.

Vật liệu của mặt hàng. Giá trị được hỗ trợ: cotton, denim, leather. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: cotton

product:locale

Bắt buộc nếu sử dụng danh mục đa ngôn ngữ.

Chỉ định phiên bản trang web của sản phẩm, chẳng hạn như en_GB cho trang web ở Vương quốc Anh. Hỗ trợ danh mục dựa trên pixel.

product:price:amount

Bắt buộc.

Giá hiện tại của mặt hàng. Đối với dấu phân cách, hãy sử dụng dấu "." thay cho dấu "," để ngăn cách phần thập phân. Không thêm các ký hiệu như "$" vào giá. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: 1500.00

product:price:currency

Bắt buộc.

Đơn vị tiền tệ của giá ở định dạng theo tiêu chuẩn ISO. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: USD

product:retailer_item_id

Bắt buộc.

ID nhà bán lẻ cho mặt hàng. Hỗ trợ danh mục dựa trên pixel.

product:sale_price:amount

Không bắt buộc.

Giá đã giảm nếu mặt hàng đang được giảm giá. Hãy sử dụng dấu "." để ngăn cách phần thập phân cho giá khuyến mãi. Giá khuyến mãi là thông tin bắt buộc nếu bạn định sử dụng lớp phủ cho giá đã giảm. Hỗ trợ danh mục dựa trên pixel.


Lưu ý: Nhìn chung, đối với danh mục dựa trên pixel, bạn chỉ nên ghi lại mọi thay đổi về giá bằng thẻ chính og:price:amount. Nếu bạn có sử dụng thẻ giá khuyến mãi, hãy đảm bảo sử dụng cả thẻ product:sale_price_dates:start và product:sale_price_dates:end để chỉ ra thời điểm bắt đầu và kết thúc khuyến mãi. Nếu không có ngày kết thúc, giá khuyến mãi có thể hiển thị vô thời hạn.


Ví dụ: 9.99

product:sale_price:currency

Không bắt buộc.

Đơn vị tiền tệ của giá đã giảm nếu mặt hàng đang được giảm giá, ở định dạng mã đơn vị tiền tệ gồm 3 chữ số theo tiêu chuẩn ISO. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: USD

product:sale_price_dates:start

Không bắt buộc.

Ngày và giờ bắt đầu khuyến mãi theo múi giờ của bạn, ở định dạng YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59 được phân tách bằng dấu gạch chéo. Ghi ngày bắt đầu và ngày kết thúc theo định dạng YYYY-MM-DD. Ghi thời gian theo định dạng 24 giờ (0:00 đến 23:59). Thêm chữ "T" vào giữa mỗi ngày và thời gian, trong đó thời gian kết thúc biểu thị múi giờ. Trong ví dụ, 03:00 biểu thị múi giờ. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: 2017-11-01T12:00-03:00/2017-12-01T00:00-03:00

product:sale_price_dates:end

Không bắt buộc.

Ngày và giờ kết thúc khuyến mãi theo múi giờ của bạn, ở định dạng YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59 được phân tách bằng dấu gạch chéo. Ghi ngày bắt đầu và ngày kết thúc theo định dạng YYYY-MM-DD. Ghi thời gian theo định dạng 24 giờ (0:00 đến 23:59). Thêm chữ "T" vào giữa mỗi ngày và thời gian, trong đó thời gian kết thúc biểu thị múi giờ. Trong ví dụ, 03:00 biểu thị múi giờ. Hỗ trợ danh mục dựa trên pixel.

Ví dụ: 2017-11-01T12:00-03:00/2017-12-01T00:00-03:00

Schema.org - Thẻ bắt buộc

Mỗi trường có tối đa 500 ký tự.

TênMô tả

name

Tên mặt hàng.

brand

Thương hiệu của mặt hàng.

description

Nội dung mô tả mặt hàng.

productID

ID nhà bán lẻ cho mặt hàng.

url

URL hoàn chỉnh cho trang sản phẩm.

image

Liên kết đến hình ảnh được dùng trên trang sản phẩm.

price

Giá hiện tại của mặt hàng. Không thêm các ký hiệu như "$" vào giá. Thêm mục nhập này trong phần "ưu đãi". Hãy đặt định dạng giá như sau: chi phí rồi đến dấu cách, tiếp đó là mã đơn vị tiền tệ ISO gồm 3 chữ số (tiêu chuẩn ISO 4217). Sử dụng dấu chấm (".") để ngăn cách phần thập phân.

Bạn chỉ nên thêm một (1) đơn vị tiền tệ vào danh mục để khách hàng không nhìn thấy nhiều đơn vị tiền tệ cho các sản phẩm trong quảng cáo hoặc kênh thương mại của bạn. Nếu bạn muốn thêm giá và thông tin sản phẩm mà các quốc gia hoặc ngôn ngữ khác sẽ nhìn thấy, hãy tải nguồn cấp dữ liệu quốc gia hoặc nguồn cấp dữ liệu ngôn ngữ lên danh mục của bạn.

priceCurrency

Đơn vị tiền tệ của giá ở định dạng theo tiêu chuẩn ISO (ví dụ: USD). Thêm mục nhập này trong phần "ưu đãi". Đối với dấu phân cách, hãy sử dụng dấu "." thay cho dấu "," để ngăn cách phần thập phân. Không thêm các ký hiệu như "$" vào giá. Ví dụ: 1500,00.

availability

Tình trạng còn hàng hiện tại của mặt hàng: in stock, out of stock, available for order, discontinued. Thêm mục nhập này trong phần "ưu đãi".

condition

Tình trạng hiện tại của mặt hàng: new, refurbished hoặc used. Thêm mục nhập này trong phần "ưu đãi".

JSON-LD cho Schema.org - Thẻ bắt buộc

Mỗi trường có tối đa 500 ký tự.

Trích xuất từ schema.org/Product

TênMô tả

name

Tên mặt hàng.

brand

Thương hiệu của mặt hàng.

description

Nội dung mô tả mặt hàng.

productID

ID nhà bán lẻ cho mặt hàng.

url

URL hoàn chỉnh cho trang sản phẩm.

offers

Mảng các đối tượng thuộc loại schema.org/Offer.

image

Liên kết đến hình ảnh được dùng trên trang sản phẩm.

Trích xuất từ schema.org/Offer (trong phần ưu đãi sản phẩm)

TênMô tả

price

Giá hiện tại của mặt hàng. Không thêm các ký hiệu như "$" vào giá. Thêm mục nhập này trong phần "ưu đãi".

priceCurrency

Đơn vị tiền tệ của giá ở định dạng theo tiêu chuẩn ISO (ví dụ: USD). Thêm mục nhập này trong phần "ưu đãi".

availability

Tình trạng còn hàng hiện tại của mặt hàng: in stock, out of stock, available for order, discontinued. Thêm mục nhập này trong phần "ưu đãi".

condition

Tình trạng hiện tại của mặt hàng: new, refurbished hoặc used. Thêm mục nhập này trong phần "ưu đãi".

Xuất lược đồ JSON

Chúng tôi đã cung cấp bản tải xuống lược đồ JSON cho tất cả trường danh mục chính và trường hạng mục ở đây:

Hãy lưu ý rằng lược đồ JSON này không phải định dạng nguồn cấp dữ liệu có thể tải lên, mà được cung cấp dưới dạng tài liệu tham khảo thay thế cho các trường nguồn cấp dữ liệu, ví dụ và loại dữ liệu khác với những gì đã có trong tài liệu của chúng tôi. Đây là lược đồ chủ yếu dành cho các nhà phát triển muốn căn chỉnh hạng mục nội bộ và ánh xạ trường với lược đồ danh mục của Meta theo cách lập trình. Vui lòng làm theo cách định dạng nguồn cấp dữ liệu ở phần khác trong tài liệu này đối với nguồn cấp dữ liệu có thể tải lên.

Tất cả các trường thuộc khóa common sẽ là trường chính. Nếu không, tên hạng mục sẽ là khóa chính. Định dạng của mỗi trường sẽ như ví dụ dưới đây:

"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
      },

Lưu ý rằng chỉ các trường dành riêng cho hạng mục mới có giá trị "recommended": true (vì nếu không, những trường này đều không bắt buộc) để nắm rõ nhất về mức độ ưu tiên.

Tìm hiểu thêm

Trung tâm trợ giúp quảng cáo

Tài liệu tham khảo về API

API Marketing