ข้อมูลอ้างอิง - แค็ตตาล็อก

รูปแบบฟีดที่รองรับ

สินค้าคงคลังควรได้รับการอัพโหลดลงใน Facebook โดยใช้แค็ตตาล็อก สำหรับแค็ตตาล็อกแต่ละรายการ คุณควรระบุฟีดสินค้าในรูปแบบใดรูปแบบหนึ่งที่รองรับ ได้แก่ CSV, TSV, RSS XML, ATOM XML หรือ Google Sheets (ดูคำแนะนำเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ)

รูปแบบคำอธิบาย

CSV

ค่าที่คั่นด้วยเครื่องหมายจุลภาค สามารถใช้ร่วมกับโปรแกรมสเปรดชีทส่วนใหญ่ได้ โดยแถวแรกจะระบุส่วนหัวของคอลัมน์ ส่วนแถวที่ตามมาจะแสดงค่าที่สอดคล้องกันสำหรับเส้นทางแต่ละเส้น


ควรใส่เครื่องหมาย “อัญประกาศคู่” ล้อมช่องที่มีการเว้นวรรคหรือเครื่องหมายจุลภาค ให้เลี่ยงการใช้เครื่องหมายอัญประกาศคู่ในช่องที่มีเครื่องหมายอัญประกาศคู่คลุมอยู่ โดยใช้เครื่องหมายอัญประกาศคู่ซ้อนกันแทน

ตัวอย่าง: "Join our ""Royal"" membership program"


ช่องที่ซ้อนกันหรือมีหลายค่า เช่น รูปภาพ จะสามารถแสดงได้โดยใช้ค่าที่เข้ารหัส JSON หรือชุดคอลัมน์ข้อความธรรมดาที่ “ปรับให้เป็นระนาบเดียว” ซึ่งมีป้ายกำกับโดยใช้รูปแบบคำสั่งพาธ JSON

ตัวอย่าง: image[0].url, image[0].tag[0], image[0].tag[1])


ทั้ง 2 รูปแบบสามารถใช้แทนกันได้ในไฟล์เดียวกัน

ดูตัวอย่างฟีด CSV สำหรับโฆษณาแค็ตตาล็อก Advantage+ และฟีด CSV เพื่อการค้า


ดาวน์โหลด (คลิกขวา > บันทึกลิงก์เป็น)

คุณสามารถใช้ไฟล์ตัวอย่าง CSV (.csv) ของเราเพื่ออ้างอิงได้ในขณะที่คุณกำลังสร้างฟีด แต่เราขอแนะนำให้ใช้ตัวจัดการการค้าเป็นแหล่งข้อมูลหลักของคุณ

TSV

ค่าที่คั่นด้วยแท็บ สามารถใช้ร่วมกับโปรแกรมสเปรดชีทส่วนใหญ่ได้ ดูแนวทางของ CSV

ดาวน์โหลด (คลิกขวา > บันทึกลิงก์เป็น)

RSS XML

Rich-Site Summary, Extensible Markup Language โหนด XML ต้นทางประกอบด้วยชุดโหนด ซึ่งแต่ละโหนดจะแสดงถึงเส้นทาง ไฟล์จะต้องขึ้นต้นด้วยแท็ก declaration โดยปกติแล้ว รูปแบบจะสร้างด้วยระบบของผู้ให้บริการฟีดอัตโนมัติหรือเว็บเซิร์ฟเวอร์ ชุดโหนด XML ของสินค้าจะแสดงถึงรายการสินค้าและต้องขึ้นต้นด้วยแท็กประกาศ <?xml

โดยปกติแล้วจะสร้างด้วยระบบของผู้ให้บริการฟีดอัตโนมัติหรือเว็บเซิร์ฟเวอร์

ดาวน์โหลด (คลิกขวา > บันทึกลิงก์เป็น)

หากคุณได้รับข้อผิดพลาด ข้อผิดพลาดนี้จะหมายความว่าบรรทัดในไฟล์ฟีดข้อมูล XML ของคุณยาวเกินไปจนมีขนาดเกินขีดจำกัดของเราที่ 5,242,880 ไบต์หรืออักขระ โปรดจัดรูปแบบ XML ของคุณใหม่ให้มีหลายบรรทัด โดยมี 1 ช่องต่อบรรทัด และอัพโหลดไฟล์ของคุณอีกครั้ง คุณสามารถดูข้อมูลเพิ่มเติมได้ที่ "แก้ไขข้อผิดพลาดเกี่ยวกับฟีดข้อมูล"

Atom XML

Atom Syndication Format เป็นภาษา XML ที่ใช้สำหรับฟีดของเว็บ ในขณะที่ Atom Publishing Protocol (AtomPub หรือ APP) เป็นโปรโตคอลที่ใช้ HTTP แบบง่ายสำหรับการสร้างและอัพเดตแหล่งข้อมูลบนเว็บ โดยปกติแล้ว รูปแบบจะสร้างด้วยระบบของผู้ให้บริการฟีดอัตโนมัติหรือเว็บเซิร์ฟเวอร์ ชุดโหนด XML ของสินค้าจะแสดงถึงรายการสินค้าและต้องขึ้นต้นด้วยแท็กประกาศ <?xml โดยปกติแล้วจะสร้างด้วยระบบของผู้ให้บริการฟีดอัตโนมัติหรือเว็บเซิร์ฟเวอร์ ดูตัวอย่างฟีด XML (Atom) เพื่อการค้า

ดาวน์โหลด (คลิกขวา > บันทึกลิงก์เป็น)

Google Sheets

ขณะนี้ตัวจัดการการค้ารองรับ Google Sheets สำหรับฟีดแบบกำหนดเวลาแล้ว โดยมีวิธีดังนี้

  1. สร้างฟีดข้อมูลของคุณเป็นสเปรดชีตใน Google Sheets แล้วรับลิงก์ที่แชร์ได้
  2. เมื่อคุณเพิ่มสินค้าในตัวจัดการการค้า ให้เลือกตัวเลือก "Google Sheets" คัดลอกและวางลิงก์ที่แชร์ได้ จากนั้นอัพโหลดให้เสร็จ
  3. จัดการสินค้าคงคลังของคุณในสเปรดชีตของ Google ต่อในอนาคต แล้วเราจะดึงข้อมูลจากสเปรดชีตดังกล่าวตามเวลาที่กำหนดไว้

เรียนรู้เพิ่มเติม

ตัวอย่างฟีด

ตัวอย่างฟีด CSV — โฆษณาแค็ตตาล็อก Advantage+

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

ตัวอย่างฟีด CSV — การค้า

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

ตัวอย่างฟีด XML (Atom) — การค้า

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

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

    </channel>
</rss>

รูปแบบฟีด — กำหนดเวลาการดึงฟีดข้อมูล

สำหรับการกำหนดเวลาการดึงฟีดข้อมูล โปรดดูรูปแบบที่แนะนำด้านล่าง

รูปแบบฟีด กรณีการใช้งาน ฟีดตัวอย่าง

CSV

อัพเดต price และ availability สำหรับชุดย่อยของรายการสินค้า

ดาวน์โหลด (คลิกขวาแล้วเลือก "บันทึกลิงก์เป็น")

TSV

รีเซ็ต sale_price และอัพเดต custom_label_0 สำหรับชุดย่อยของรายการสินค้า

ดาวน์โหลด (คลิกขวาแล้วเลือก "บันทึกลิงก์เป็น")

ช่องแค็ตตาล็อกที่รองรับ

ช่องแค็ตตาล็อกเป็นเครื่องมือที่ช่วยให้ลูกค้าได้รับประสบการณ์ที่มีคุณภาพระหว่างซื้อสินค้ากับร้านค้าของคุณบน Facebook หรือ Instagram

ช่องแค็ตตาล็อกใช้เพื่อใส่ข้อมูลลงในหน้ารายละเอียดสินค้าสำหรับสินค้าแต่ละรายการ ซึ่งจะประกอบด้วยข้อมูลที่สำคัญ เช่น คำอธิบายสินค้า รูปภาพ ตัวเลือกขนาด/สี ราคา และจำนวนที่มีจำหน่าย หากมีข้อมูลขาดหายไปหรือไม่ถูกต้องอาจส่งผลเสียต่อประสบการณ์ของผู้ใช้ กระทบต่อการทำให้คอนเวอร์ชั่นกลายเป็นการซื้อ หรืออาจชวนให้เข้าใจผิดและบั่นทอนความน่าเชื่อถือ

ช่องที่รองรับสำหรับสินค้า

ตารางต่อไปนี้อธิบายช่องที่ใช้ในการสร้างแค็ตตาล็อก รวมถึงระดับความจำเป็น (จำเป็นต้องระบุหรือระบุหรือไม่ก็ได้) สำหรับหลักปฏิบัติที่ดีที่สุดในการตั้งชื่อคอลัมน์ ให้ใช้ภาษาอังกฤษแบบอเมริกันสำหรับทุกช่อง

Required Fields (for Ads and Commerce)

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

Attribute and Type Description

id

Type: string

Max character limit: 100

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


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


Example: 12345

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

title

Type: string

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


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

Example: Blue Cotton T-Shirt

This field is supported by supplementary feeds.

description

type: string

Max character limit: 9999

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


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

This field is supported by supplementary feeds.

availability

Type: string

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


  • in stock

  • out of stock

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


Example: in stock

condition

Type: string

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


Example: new

price

type: string

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

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

Example: 9.99 USD, 7.99 EUR

link

Type: string

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


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

image_link

Type: string

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


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


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

This field is supported by supplementary feeds.

brand

Type: string

Max characters: 100

The brand name of the item.

Example: Jasper's Market

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

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

Attribute and Type Description

quantity_to_sell_on_facebook

Type: integer

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


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


Example: 150

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

size

Type: string

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

Max character limit: 200


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


Example: Medium

This field is supported by supplementary feeds.

Optional Fields

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

Attribute and Type Description

sale_price

Type: string

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


Example: 7.99 USD

sale_price_effective_date

Type: two ISO-8601 timestamp

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


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


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

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

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

item_group_id

Type: string

Max character limit: 100

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


Example: Shirt_1

status

Type: string

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


Example: active


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

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

additional_image_link

Type: string

Maximum character limit: 2000

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


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


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


This field is supported by supplementary feeds.

google_product_category

Type: string

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


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


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


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

This field is supported by supplementary feeds.

fb_product_category

Type: string

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


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


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


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

This field is supported by supplementary feeds.

Category-specific fields

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

This field is supported by supplementary feeds.

color

Type: string

Max character limit: 200

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


Example: Royal Blue

This field is supported by supplementary feeds.

gender

Type: string

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


Example: unisex

This field is supported by supplementary feeds.

size

Type: string

Max character limit: 200

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


Example: Medium

This field is supported by supplementary feeds.

age_group

Type: string

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


Example: adult

This field is supported by supplementary feeds.

material

Type: string

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


Example: Organic Cotton

This field is supported by supplementary feeds.

pattern

Type: string

Max character limit: 100

The pattern or graphic print on the item.


Example: Flannel, Gingham, Polka dots, stripes

This field is supported by supplementary feeds.

shipping

Type: string

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

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


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

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

shipping_weight

Type: string

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


Example: 10 kg

internal_label

Type: string

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

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

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

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

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

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

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

Type: string

Max character limit: 100

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


Example: Summer Sale

This field is supported by supplementary feeds.

custom_number_0
custom_number_1
custom_number_2
custom_number_3
custom_number_4

Type: int

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


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


Example: 2022

rich_text_description

Type: string

Max characters: 9999

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


Supported tags include:

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

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


Example:

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

This field is supported by supplementary feeds.

product_type

Type: string

Max character limit: 750

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


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

video[0].url

video[1].url

video[2].url

video[3].url ... up to

video[19].url

Type: string

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


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


Example:

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

This field is supported by supplementary feeds.

additional_variant_attribute

Type: string

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


Example: Scent:Fruity, Flavor:Strawberry

This field is supported by supplementary feeds.

unit_price

Type: string

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

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


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


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

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

It can also be uploaded via XML as follows:

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

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

gtin

Type: string

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

GTIN types:

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

Example: 4011200296908

This field is supported by supplementary feeds.

mpn

Type: string

Max characters: 100.

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

Example: JAS12345PER

expiration_date

Type: date

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

return_policy_info

Type: string

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


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


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


Example of a final sale item:

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


mobile_link

Type: string

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

applink

Type: string

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


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


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

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

Learn more about product deep links.


disabled_capabilities

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

Learn more about disabled_capabilities.

Additional Required Fields for Selling in India

Attribute and Type Description

origin_country
Type: ISOCountryCode (2 letter country code)

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


Example value: US

This field is supported by supplementary feeds.

importer_name
Type: string

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


Example value: Jasper's Market Inc.

This field is supported by supplementary feeds.

importer_address
Type: JSON structure

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


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


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


This example value: `

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

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

This field is supported by supplementary feeds.

manufacturer_info
Type: string

Required for Shops only.

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


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

This field is supported by supplementary feeds.

wa_compliance_category
Type: string

Required for selling on WhatsApp only.

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


Supported values (case sensitive):

COUNTRY_ORIGIN_EXEMPT: The item is exempt.

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

ช่องที่รองรับ — แค็ตตาล็อกที่ปรับให้เข้ากับท้องถิ่น

ข้อกำหนด

  • คุณต้องระบุช่อง id ในไฟล์ฟีดข้อมูลรอง หากต้องการเรียกใช้โฆษณาแค็ตตาล็อก Advantage+, ID ของสินค้าแต่ละรายการต้องตรงกับ ID สินค้าในฟีดข้อมูลแค็ตตาล็อกเดิมและ ID เนื้อหาสินค้าจากพิกเซลของคุณ
  • คุณจะต้องระบุช่อง override ในช่องนี้ ให้ใส่รหัส ISO สำหรับภาษาหรือประเทศที่คุณต้องการระบุข้อมูลที่ได้รับการแปลเป็นภาษาท้องถิ่น ในช่องนี้ ให้ใส่รหัส ISO สำหรับภาษาหรือประเทศที่คุณต้องการระบุข้อมูลที่ได้รับการแปลเป็นภาษาท้องถิ่น ค่าในคอลัมน์ override ควรเป็นรหัสภาษา ISO ที่รองรับหรือรหัสประเทศ ISO ที่รองรับ เรียนรู้เพิ่มเติมเกี่ยวกับรหัสภาษาและรหัสประเทศที่รองรับ
  • ต้องระบุ price, sale_price, unit_price, base_price, status (การแสดงผล) และ availability ในฟีดประเทศเท่านั้น ช่องเหล่านี้ไม่สามารถระบุไว้ในฟีดภาษาได้ ซึ่งช่วยให้ลูกค้าพบข้อมูลสินค้าที่ปรับให้เข้ากับท้องถิ่นและถูกต้อง

เรียนรู้เพิ่มเติมเกี่ยวกับช่อง id และ override ในสร้างฟีดข้อมูลที่มีข้อมูลสินค้าคงคลังที่ได้รับการปรับให้เข้ากับท้องถิ่น, ขั้นตอนที่ 2 และ 3

สินค้า

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

หากต้องการปรับช่อง applink ให้เข้ากับท้องถิ่น คุณต้องระบุช่องเหล่านั้นให้ครบถ้วน เรียนรู้เพิ่มเติมเกี่ยวกับ Deep Link ของสินค้า

  • 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

หากต้องการปรับช่อง applink ให้เข้ากับท้องถิ่น คุณต้องระบุช่องเหล่านั้นให้ครบถ้วน เรียนรู้เพิ่มเติมเกี่ยวกับ Deep Link ของสินค้า

หากต้องการข้อมูลอ้างอิง โปรดดูรายการช่องหลักสำหรับโรงแรม


เที่ยวบิน

  • 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

หากต้องการปรับช่อง applink ให้เข้ากับท้องถิ่น คุณต้องระบุช่องเหล่านั้นให้ครบถ้วน เรียนรู้เพิ่มเติมเกี่ยวกับ Deep Link ของสินค้า

หากต้องการข้อมูลอ้างอิง โปรดดูรายการช่องหลักสำหรับเที่ยวบิน


ปลายทาง

  • 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

หากต้องการปรับช่อง applink ให้เข้ากับท้องถิ่น คุณต้องระบุช่องเหล่านั้นให้ครบถ้วน เรียนรู้เพิ่มเติมเกี่ยวกับ Deep Link ของสินค้า

หากต้องการข้อมูลอ้างอิง โปรดดูรายการช่องหลักสำหรับจุดหมายปลายทาง


การลงประกาศขายบ้าน

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

หากต้องการข้อมูลอ้างอิง โปรดดูรายการช่องหลักสำหรับการลงประกาศขายบ้าน


ยานพาหนะ

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

หากต้องการข้อมูลอ้างอิง โปรดดูรายการช่องหลักสำหรับยานพาหนะ

แท็ก OpenGraph

แต่ละช่องมีอักขระได้สูงสุด 500 ตัว

จำเป็นต้องระบุลิงก์รูปภาพหลัก ส่วนลิงก์รูปภาพเพิ่มเติมจะระบุหรือไม่ก็ได้
ชื่อคำอธิบาย

og:title

จำเป็นต้องระบุ

ชื่อของสินค้า รองรับแค็ตตาล็อกที่ใช้พิกเซล

og:description

จำเป็นต้องระบุ

คำอธิบายสินค้า รองรับแค็ตตาล็อกที่ใช้พิกเซล

og:url

จำเป็นต้องระบุ

URL แบบเต็มสำหรับหน้าสินค้า รองรับแค็ตตาล็อกที่ใช้พิกเซล

og:image

จำเป็นต้องระบุสำหรับลิงก์หลัก และระบุหรือไม่ก็ได้สำหรับลิงก์รูปภาพเพิ่มเติม

ลิงก์ไปยังรูปภาพที่ใช้ในหน้าสินค้า จำเป็นต้องระบุลิงก์รูปภาพหลัก ส่วนลิงก์รูปภาพเพิ่มเติมจะระบุหรือไม่ก็ได้ รองรับแค็ตตาล็อกที่ใช้พิกเซล

og:locale

จำเป็นต้องระบุหากใช้แค็ตตาล็อกหลายภาษา

ระบุว่าสินค้ามาจากเว็บไซต์เวอร์ชั่นใด ตัวอย่างเช่น en_GB สำหรับเว็บไซต์เวอร์ชั่นสหราชอาณาจักร รองรับแค็ตตาล็อกที่ใช้พิกเซล

og:price:amount

จำเป็นต้องระบุ

ราคาสินค้าในปัจจุบัน สำหรับตัวคั่น ให้ใช้ "." แทน "," เพื่อระบุจุดทศนิยม ห้ามมีสัญลักษณ์ เช่น “$” ในราคา รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: 1500.00

og:price:currency

จำเป็นต้องระบุ

สกุลเงินสำหรับราคาในรูปแบบ ISO รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: USD

product:brand

จำเป็นต้องระบุ

ชื่อแบรนด์ของสินค้า รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:availability

จำเป็นต้องระบุ

จำนวนสินค้าที่มีจำหน่ายในปัจจุบัน: in stock, out of stock, available for order, discontinued รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:catalog_id

ระบุหรือไม่ก็ได้

ID แค็ตตาล็อกที่ไม่ซ้ำกันของสินค้า โดยอาจเป็นแบบสินค้าก็ได้ ช่องนี้จะแมปกับ retailer_id หลังจากนำเข้าสินค้าแล้ว ช่อง id ต้องตรงกับ ID เนื้อหาสำหรับพิกเซลของคุณ รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:category

ระบุหรือไม่ก็ได้

จำกัดอักขระสูงสุด 250 ตัว รองรับแค็ตตาล็อกที่ใช้พิกเซล

สำหรับโฆษณาแค็ตตาล็อก Advantage+ จะแสดงถึงค่าที่กำหนดไว้ล่วงหน้า (สตริงหรือ ID หมวดหมู่) จากการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

สำหรับการค้า จะแสดงถึงหมวดหมู่ของสินค้าของคุณตามการจัดหมวดหมู่ผลิตภัณฑ์ของ Google เรียนรู้เพิ่มเติมเกี่ยวกับหมวดหมู่สินค้าสำหรับการค้า

เรียนรู้เพิ่มเติมเกี่ยวกับหมวดหมู่สินค้าสำหรับสินค้าในแค็ตตาล็อกของ Google, ศูนย์ช่วยเหลือโฆษณา

product:condition

จำเป็นต้องระบุ

สภาพสินค้าในปัจจุบัน: new, refurbished, used รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:custom_label_[0-4]

ระบุหรือไม่ก็ได้

จำกัดอักขระสูงสุด 100 ตัว

ข้อมูลเพิ่มเติมเกี่ยวกับสินค้าที่คุณต้องการเพิ่ม รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:gender

ระบุหรือไม่ก็ได้

กำหนดเพศเพื่อการวัดขนาด: Female, Male, Unisex รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:item_group_id

ระบุหรือไม่ก็ได้

สำหรับโฆษณาแค็ตตาล็อก Advantage+ - รายการสินค้าที่เป็นแบบสินค้า ระบุ item_group_id เดียวกันสำหรับรายการสินค้าทั้งหมดที่เป็นแบบสินค้า ตัวอย่างเช่น เสื้อโปโลสีแดงเป็นแบบสินค้าของเสื้อโปโล Facebook จะแมปข้อมูลนี้กับ retailer_product_group_id เมื่อเราได้รับฟีดของคุณ โดย Facebook จะเลือกสินค้าเพียงรายการเดียวจากกลุ่มตามสัญญาณที่เราได้รับจากพิกเซลหรือเหตุการณ์ในแอพ เมื่อใช้โฆษณาแค็ตตาล็อก Advantage+

เพื่อการค้า - จะระบุ product_group_id เดียวกันสำหรับรายการสินค้าทั้งหมดที่เป็นแบบสินค้า ตัวอย่างเช่น เสื้อโปโลสีแดงเป็นแบบสินค้าของเสื้อโปโล Facebook จะแมปข้อมูลนี้กับ retailer_product_group_id เมื่อเราได้รับฟีดของคุณ เรียนรู้เพิ่มเติมเกี่ยวกับแบบสินค้า รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: FB1234_shirts

product:gtin

ระบุหรือไม่ก็ได้

หมายเลขประจำรายการสินค้าสากล (GTIN) ของสินค้า ไม่รวมเครื่องหมายขีดกลางและเว้นวรรค ส่งได้เฉพาะ GTIN ที่ถูกต้องตามที่อธิบายไว้ในคู่มือการตรวจสอบของ GTIN ค่าที่รองรับ ได้แก่ UPC (อเมริกาเหนือ 12 หลัก), EAN (ยุโรป 13 หลัก), JAN (ญี่ปุ่น 8 หรือ 13 หลัก), ISBN (หนังสือ 13 หลัก) รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: 4011200296908

product:isbn

ระบุหรือไม่ก็ได้

เลขมาตรฐานสากลประจำหนังสือ ISBN ประกอบด้วยตัวเลข 13 หลัก รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:mfr_part_no

ระบุหรือไม่ก็ได้

หมายเลขชิ้นส่วนของผู้ผลิตที่ไม่ซ้ำกันสำหรับสินค้า สำหรับการค้าแล้ว สินค้าคงคลังของข้อเสนอประจำวันจะต้องมีแบรนด์ด้วย หากมีการระบุ mpn โดยรองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: 100020003

material

ระบุหรือไม่ก็ได้

วัสดุที่ใช้ทำสินค้า ค่าที่รองรับ: cotton, denim, leather รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: cotton

product:locale

จำเป็นต้องระบุหากใช้แค็ตตาล็อกหลายภาษา

ระบุว่าสินค้ามาจากเว็บไซต์เวอร์ชั่นใด ตัวอย่างเช่น en_GB สำหรับเว็บไซต์เวอร์ชั่นสหราชอาณาจักร รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:price:amount

จำเป็นต้องระบุ

ราคาสินค้าในปัจจุบัน สำหรับตัวคั่น ให้ใช้ "." แทน "," เพื่อระบุจุดทศนิยม ห้ามมีสัญลักษณ์ เช่น “$” ในราคา รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: 1500.00

product:price:currency

จำเป็นต้องระบุ

สกุลเงินสำหรับราคาในรูปแบบ ISO รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: USD

product:retailer_item_id

จำเป็นต้องระบุ

ID ของผู้ขายสินค้า รองรับแค็ตตาล็อกที่ใช้พิกเซล

product:sale_price:amount

ระบุหรือไม่ก็ได้

ราคาสินค้าที่ลดราคาแล้ว หากสินค้านั้นกำลังลดราคา ใช้ "." เป็นทศนิยมของราคาขาย ต้องระบุราคาขายหากคุณวางแผนที่จะใช้โอเวอร์เลย์สำหรับราคาที่มีส่วนลด รองรับแค็ตตาล็อกที่ใช้พิกเซล


หมายเหตุ: โดยทั่วไปแล้ว สำหรับแค็ตตาล็อกที่ใช้พิกเซล เราขอแนะนำให้บันทึกการเปลี่ยนแปลงราคาโดยใช้แท็ก og:price:amount หลัก หากคุณใช้แท็กราคาขาย อย่าลืมใช้แท็ก product:sale_price_dates:start และ product:sale_price_dates:end เพื่อระบุเวลาเริ่มต้นและสิ้นสุดการลดราคาด้วย หากไม่มีวันที่สิ้นสุด อาจมีการแสดงราคาขายดังกล่าวต่อไปอย่างไม่มีกำหนด


ตัวอย่าง: 9.99

product:sale_price:currency

ระบุหรือไม่ก็ได้

สกุลเงินของราคาส่วนลดหากสินค้ากำลังลดราคา โดยอยู่ในรูปแบบรหัสสกุลเงิน ISO แบบ 3 หลัก รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: USD

product:sale_price_dates:start

ระบุหรือไม่ก็ได้

วันที่และเวลาเริ่มต้นการลดราคาในเขตเวลาของคุณจะเขียนเป็น YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59 โดยคั่นด้วยเครื่องหมายทับ เขียนวันที่เริ่มต้นและสิ้นสุดเป็น YYYY-MM-DD เขียนเวลาในรูปแบบ 24 ชั่วโมง (0:00 ถึง 23:59 น.) เพิ่มตัว "T" ไว้หลังวันที่แต่ละวัน จากนั้นระบุเวลา โดยที่เวลาสิ้นสุดจะแสดงถึงเขตเวลา ในตัวอย่าง 03:00 จะหมายถึงเขตเวลา รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: 2017-11-01T12:00-03:00/2017-12-01T00:00-03:00

product:sale_price_dates:end

ระบุหรือไม่ก็ได้

วันที่และเวลาสิ้นสุดการลดราคาในเขตเวลาของคุณจะเขียนเป็น YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59 โดยคั่นด้วยเครื่องหมายทับ เขียนวันที่เริ่มต้นและสิ้นสุดเป็น YYYY-MM-DD เขียนเวลาในรูปแบบ 24 ชั่วโมง (0:00 ถึง 23:59 น.) เพิ่มตัว "T" ไว้หลังวันที่แต่ละวัน จากนั้นระบุเวลา โดยที่เวลาสิ้นสุดจะแสดงถึงเขตเวลา ในตัวอย่าง 03:00 จะหมายถึงเขตเวลา รองรับแค็ตตาล็อกที่ใช้พิกเซล

ตัวอย่าง: 2017-11-01T12:00-03:00/2017-12-01T00:00-03:00

Schema.org – แท็กที่ต้องระบุ

แต่ละช่องมีอักขระได้สูงสุด 500 ตัว

ชื่อคำอธิบาย

name

ชื่อของสินค้า

brand

แบรนด์ของสินค้า

description

คำอธิบายสินค้า

productID

ID ของผู้ขายสินค้า

url

URL แบบเต็มสำหรับหน้าสินค้า

image

ลิงก์ไปยังรูปภาพที่ใช้ในหน้าสินค้า

price

ราคาสินค้าในปัจจุบัน ห้ามมีสัญลักษณ์ เช่น “$” ในราคา รวมรายการนี้ไว้ใน "ข้อเสนอ" จัดรูปแบบราคาให้เป็นตัวเลข ตามด้วยรหัสสกุลเงิน ISO แบบ 3 หลัก (มาตรฐาน ISO 4217) โดยเว้นวรรคระหว่างราคากับสกุลเงิน ใช้เครื่องหมายจุด (".") เป็นจุดทศนิยม

เราขอแนะนำให้คุณใส่สกุลเงินเดียว (1 สกุลเงิน) ในแค็ตตาล็อกของคุณ เพื่อไม่ให้ลูกค้าเห็นสกุลเงินของสินค้าปะปนกันในโฆษณาหรือช่องทางการค้าของคุณ หากต้องการเพิ่มข้อมูลสินค้าและราคาที่จะแสดงในประเทศหรือภาษาอื่นๆ ให้อัพโหลดฟีดประเทศหรือฟีดภาษาลงในแค็ตตาล็อกของคุณแทน

priceCurrency

สกุลเงินสำหรับราคาในรูปแบบ ISO (ตัวอย่างเช่น USD) รวมรายการนี้ไว้ใน "ข้อเสนอ" สำหรับตัวคั่น ให้ใช้ "." แทน "," เพื่อระบุจุดทศนิยม ห้ามมีสัญลักษณ์ เช่น “$” ในราคา ตัวอย่าง: 1500.00

availability

จำนวนสินค้าที่มีจำหน่ายในปัจจุบัน: in stock, out of stock, available for order, discontinued รวมรายการนี้ไว้ใน "ข้อเสนอ"

condition

สภาพสินค้าในปัจจุบัน: new, refurbished หรือ used รวมรายการนี้ไว้ใน "ข้อเสนอ"

JSON-LD สำหรับ Schema.org — แท็กที่ต้องระบุ

แต่ละช่องมีอักขระได้สูงสุด 500 ตัว

แยกออกมาจาก schema.org/Product

ชื่อคำอธิบาย

name

ชื่อของสินค้า

brand

แบรนด์ของสินค้า

description

คำอธิบายสินค้า

productID

ID ของผู้ขายสินค้า

url

URL แบบเต็มสำหรับหน้าสินค้า

offers

อาร์เรย์ของอ็อบเจ็กต์ของประเภท schema.org/Offer

image

ลิงก์ไปยังรูปภาพที่ใช้ในหน้าสินค้า

แยกออกมาจาก schema.org/Offer (เป็นส่วนหนึ่งของข้อเสนอสินค้า)

ชื่อคำอธิบาย

price

ราคาสินค้าในปัจจุบัน ห้ามมีสัญลักษณ์ เช่น “$” ในราคา รวมรายการนี้ไว้ใน "ข้อเสนอ"

priceCurrency

สกุลเงินสำหรับราคาในรูปแบบ ISO (ตัวอย่างเช่น USD) รวมรายการนี้ไว้ใน "ข้อเสนอ"

availability

จำนวนสินค้าที่มีจำหน่ายในปัจจุบัน: in stock, out of stock, available for order, discontinued รวมรายการนี้ไว้ใน "ข้อเสนอ"

condition

สภาพสินค้าในปัจจุบัน: new, refurbished หรือ used รวมรายการนี้ไว้ใน "ข้อเสนอ"

การส่งออกสกีมา 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 การตลาด