المرجع - الكتالوج

تنسيقات قوائم البيانات المدعومة

يجب تحميل المخزون على فيسبوك باستخدام كتالوج. لكل كتالوج، يجب توفير قائمة منتجات بأحد التنسيقات المدعومة: 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])` يمكن استخدام المصطلحين بالتبادل في الملف نفسه. راجع أمثلة على قائمة البيانات بتنسيق CSV لإعلانات كتالوج Advantage+ وقائمة البيانات بتنسيق CSV للمعاملات التجارية. تنزيل (النقر بزر الماوس الأيمن > حفظ الرابط بتنسيق) يمكنك الرجوع إلى أمثلة ملفات CSV (.csv) التي نوفرها أثناء إنشاء قائمة البيانات، ولكننا نوصي باستخدام مدير المعاملات التجارية كمصدر أساسي لك.
TSV	قيمة مفصولة بعلامات تبويب. مناسب للغالبية العظمى من برامج جداول البيانات. راجع إرشادات CSV. تنزيل (النقر بزر الماوس الأيمن > حفظ الرابط بتنسيق)
RSS XML	ملخص الموقع التفصيلي، لغة الترميز القابلة للتوسيع. تتضمن عقدة XML مجموعة من العُقد، تُمثل كل واحدة منها مسارًا. يجب أن يبدأ الملف بإشارة `declaration`. عادة ما يتم إنشاء التنسيق بواسطة الأنظمة التلقائية لموفري خدمات قائمة البيانات أو خوادم الويب. تمثل مجموعة عُقد XML للعناصر قائمة منتجات ويجب أن تبدأ بإشارة التعريف `<?xml`. عادة ما يتم إنشاؤها بواسطة الأنظمة التلقائية لموفري خدمات قائمة البيانات أو خوادم الويب. تنزيل (النقر بزر الماوس الأيمن > حفظ الرابط بتنسيق) إذا تلقيت خطأً، فهذا يعني أن سطرًا في ملف قائمة بيانات XML طويل جدًا ويتجاوز الحد الأقصى للحجم البالغ 5,242,880 بايت أو حرفًا. يرجى إعادة تنسيق ملف XML إلى سطور متعددة بحقل واحد لكل سطر، وإعادة تحميل الملف. لمزيد من المعلومات، راجع استكشاف أخطاء قائمة البيانات وإصلاحها.
Atom XML	تنسيق Atom Syndication هو لغة XML تستخدم لقوائم بيانات الويب، في حين أن بروتوكول نشر Atom (AtomPub أو APP) هو بروتوكول بسيط يعتمد على HTTP لإنشاء موارد الويب وتحديثها. عادة ما يتم إنشاء التنسيق بواسطة الأنظمة التلقائية لموفري خدمات قائمة البيانات أو خوادم الويب. تمثل مجموعة عُقد XML للعناصر قائمة منتجات ويجب أن تبدأ بإشارة التعريف `<?xml`. عادة ما يتم إنشاؤها بواسطة الأنظمة التلقائية لموفري خدمات قائمة البيانات أو خوادم الويب. راجع مثال قائمة بيانات XML (Atom) للمعاملات التجارية. تنزيل (النقر بزر الماوس الأيمن > حفظ الرابط بتنسيق)

Google Sheets

يدعم مدير المعاملات التجارية الآن أيضًا Google Sheets لقوائم البيانات المجدولة:

قم بإنشاء قائمة بياناتك كجدول بيانات في Google Sheets واحصل على الرابط القابل للمشاركة.
عندما تضيف منتجات في مدير المعاملات التجارية، حدد خيار Google Sheets. انسخ الرابط القابل للمشاركة والصقه وأكمل عملية التحميل.
استمر في إدارة مخزونك في جدول بيانات 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` لمجموعة فرعية من العناصر	تنزيل (النقر بزر الماوس الأيمن وحفظ الرابط بتنسيق)

حقول الكتالوج المدعومة

تُعد حقول الكتالوج أساسية لضمان جودة تجربة العملاء الذين يشترون المنتجات على متجرك على فيسبوك أو Instagram.

تُستخدم حقول الكتالوج لتعبئة صفحة تفاصيل المنتج المرتبطة بكل عنصر. يتضمن ذلك معلومات مهمة، مثل وصف المنتج والصور ومتغيرات الحجم/اللون والسعر والتوّفر. يمكن أن تؤثر البيانات المفقودة أو غير الصالحة سلبًا على تجربة المستخدم أو تؤثر على التحويل إلى عمليات الشراء أو يمكن أن تكون مضللة وتؤدي إلى إضعاف الثقة.

الحقول المدعومة للمنتجات

يحدد الجدول التالي الحقول المستخدمة لإنشاء كتالوج، بما في ذلك مستوى المتطلبات (المطلوب مقابل الاختياري). لأفضل ممارسات اصطلاحات تسمية الأعمدة، استخدم اللغة الإنجليزية الأمريكية لجميع الحقول.

Required Fields (for Ads and Commerce)
Additional Required Fields for Checkout on Facebook and Instagram (US Only)
Optional Fields
Additional Required Fields for Selling in India

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

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`

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

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.

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

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`.

sale_price

Type: string

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

Example: 7.99 USD

sale_price_effective_date

Type: two ISO-8601 timestamp

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

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

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

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

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

item_group_id

Type: string

Max character limit: 100

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

Example: Shirt_1

status

Type: string

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

Example: active

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

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

additional_image_link

Type: string

Maximum character limit: 2000

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

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

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

This field is supported by supplementary feeds.

google_product_category

Type: string

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

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

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

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

This field is supported by supplementary feeds.

fb_product_category

Type: string

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

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

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

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

This field is supported by supplementary feeds.

Category-specific fields

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

This field is supported by supplementary feeds.

color

Type: string

Max character limit: 200

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

Example: Royal Blue

This field is supported by supplementary feeds.

gender

Type: string

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

Example: unisex

This field is supported by supplementary feeds.

size

Type: string

Max character limit: 200

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

Example: Medium

This field is supported by supplementary feeds.

age_group

Type: string

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

Example: adult

This field is supported by supplementary feeds.

material

Type: string

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

Example: Organic Cotton

This field is supported by supplementary feeds.

pattern

Type: string

Max character limit: 100

The pattern or graphic print on the item.

Example: Flannel, Gingham, Polka dots, stripes

This field is supported by supplementary feeds.

shipping

Type: string

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

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

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

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

shipping_weight

Type: string

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

Example: 10 kg

product_tags

Type:

array<string>

Max array size: 5000

Max single tag size: 110 characters

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

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

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

Example: [luxury,winter]

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

Type: string

Max character limit: 100

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

Example: Summer Sale

This field is supported by supplementary feeds.

custom_number_0
custom_number_1
custom_number_2
custom_number_3
custom_number_4

Type: int

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

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

Example: 2022

rich_text_description

Type: string

Max characters: 9999

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

Supported tags include:

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

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

Example:

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

This field is supported by supplementary feeds.

product_type

Type: string

Max character limit: 750

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

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

video[0].url

video[1].url

video[2].url

video[3].url ... up to

video[19].url

Type: string

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

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

Example:

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

This field is supported by supplementary feeds.

additional_variant_attribute

Type: string

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

Example: Scent:Fruity, Flavor:Strawberry

This field is supported by supplementary feeds.

unit_price

Type: string

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

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

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

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

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

It can also be uploaded via XML as follows:

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

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

gtin

Type: string

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

Example: 4011200296908

This field is supported by supplementary feeds.

mpn

Type: string

Max characters: 100.

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

Example: 100020003

expiration_date

Type: date

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

return_policy_info

Type: string

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

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

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

Example of a final sale item:

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

mobile_link

Type: string

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

applink

Type: string

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

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

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

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

Learn more about product deep links.

disabled_capabilities

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

Learn more about disabled_capabilities.

Additional Required Fields for Selling in India

Attribute and Type	Description
`origin_country` Type: ISOCountryCode (2 letter country code)	The item's country of origin. Enter the two-letter ISO country code Example value: `US` This field is supported by supplementary feeds.
`importer_name` Type: string	If the country of origin is not India, provide the legal entity name of the item's importer Example value: `Jasper's Market Inc.` This field is supported by supplementary feeds.
`importer_address` Type: JSON structure	If the country of origin is not India, provide the operational address of the importer. This field uses a JSON structure, which contains the following fields: `street1` - string, required. The first line of the street address `street2` - string, optional. The second line of the street address. `city` - string, required. The city name. `region` - string, optional. The region, state or province. (In the US this is to be used for US State) `postal_code` - string, optional (in the US this is to be used for Zip Code) `country` - required. Enter the ISO Country code (2-letter country code) The overall address will be displayed to users in the following format: `street1`, `street2` (if present), `city`, `region` (if present) `postal_code` (if present), `country` (full name, localized for the user). This example value: ` { street1: "1 Hacker Way", street2: "Building 18", city: "Menlo Park", region: "CA", postal_code: "94025", country: "US" } will be rendered as "1 Hacker Way, Building 18, Menlo Park, CA 94025 United States of America" This field is supported by supplementary feeds.
`manufacturer_info` Type: string	Required for Shops only. Information about the product's manufacturer, such as the manufacturer name and address. Example: The Manufacturer Co. - 1 Hacker Way, Menlo Park, CA 94025 USA This field is supported by supplementary feeds.
`wa_compliance_category` Type: string	Required for selling on WhatsApp only. If the item is a non-physical good sold in India, such as a service, use this field to indicate that the item is exempt from providing the country of origin (`origin_country`), importer name (`importer_name`) and importer address (`importer_address`). Supported values (case sensitive): `COUNTRY_ORIGIN_EXEMPT`: The item is exempt. `DEFAULT`: The item is not exempt. This is the default value if you leave the field blank.

الحقول المدعومة - الكتالوجات المترجمة

المتطلبات

يجب تضمين حقل id في ملف قائمة البيانات الثانوي. لتشغيل إعلانات كتالوج Advantage+، يجب أن يطابق معرف كل عنصر معرفه في قائمة بيانات الكتالوج الأصلي ومعرف المحتوى من البيكسل الخاص بك.
يجب تضمين حقل override. في هذا الحقل، أدخل رموز ISO للغات أو البلدان التي تريد توفير معلومات مترجمة لها. في هذا الحقل، أدخل رموز ISO للغات أو البلدان التي تريد توفير معلومات مترجمة لها. يجب أن تكون القيمة في عمود override إما رمز لغة بتنسيق ISO مدعومًا أو كود بلد بتنسيق ISO مدعومًا. تعرف على المزيد عن رموز اللغة المدعومة وأكواد البلدان.

تعرف على المزيد عن الحقول id وoverride في إنشاء قائمة بيانات تتضمن معلومات المخزون المحلية، الخطوتين 2 و3.

المنتجات

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

لتطويع أي حقول لرابط التطبيق محليًا، يجب توفير كل الحقول. تعرف على المزيد حول الروابط لمواضع معينة للمنتجات.

image[0].url، image[0].tag[0]

لتطويع الصورة محليًا، يجب استخدام حقول الصور image[0].url، image[0].tag[0] المضمنة. حقل image_link غير مدعوم للتطويع المحلي.

للاطلاع على المرجع، راجع قائمة الحقول الرئيسية للمنتجات.

الفنادق

name
description
base_price
sale_price
brand
url
neighborhood
longitude
latitude
image[0].url، image[0].tag[0]
applink.ios_url، applink.ios_app_store_id، applink.ios_app_name، applink.android_url، applink.android_package، applink.android_app_name، applink.windows_phone_url، applink.windows_phone_app_id، applink.windows_phone_app_name، applink.ipad_url، applink.ipad_app_store_id، applink.ipad_app_name

لتطويع أي حقول لرابط التطبيق محليًا، يجب توفير كل الحقول. تعرف على المزيد حول الروابط لمواضع معينة للمنتجات.

للاطلاع على مرجع، راجع القائمة الرئيسية للحقول في الفنادق.

رحلات الطيران

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

لتطويع أي حقول لرابط التطبيق محليًا، يجب توفير كل الحقول. تعرف على المزيد حول الروابط لمواضع معينة للمنتجات.

للاطلاع على مرجع، راجع القائمة الرئيسية للحقول في رحلات الطيران.

الوجهات

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

لتطويع أي حقول لرابط التطبيق محليًا، يجب توفير كل الحقول. تعرف على المزيد حول الروابط لمواضع معينة للمنتجات.

للاطلاع على مرجع، راجع القائمة الرئيسية للحقول في الوجهات.

قوائم المعروضات المنزلية

name
description
price
url
image[0].url، image[0].tag[0]

للاطلاع على مرجع، راجع القائمة الرئيسية للحقول في قوائم المعروضات المنزلية.

المركبات

title
description
price
sale_price
url
image[0].url، image[0].tag[0]

للاطلاع على مرجع، راجع القائمة الرئيسية للحقول في المركبات.

إشارات OpenGraph

يحتوي كل حقل على 500 حرف كحد أقصى.

رابط الصورة الأساسي مطلوب. أي روابط صور إضافية تكون اختيارية.

الاسم	الوصف
`og:title`	مطلوب. عنوان العنصر. يدعم الكتالوجات التي تستند إلى البيكسل.
`og:description`	مطلوب. وصف العنصر. يدعم الكتالوجات التي تستند إلى البيكسل.
`og:url`	مطلوب. عنوان URL الكامل لصفحة المنتج. يدعم الكتالوجات التي تستند إلى البيكسل.
`og:image`	مطلوب للرابط الأساسي. اختياري لروابط الصور الإضافية. رابط الصورة المستخدمة في صفحة المنتج. رابط الصورة الأساسي مطلوب. تكون أي روابط صور إضافية اختيارية. يدعم الكتالوجات التي تستند إلى البيكسل.
`og:locale`	مطلوب إذا كان يتم استخدام كتالوجات متعددة اللغات. يحدد إصدار موقع الويب الذي ينتمي إليه المنتج؛ على سبيل المثال، `en_GB` لموقع الويب في المملكة المتحدة. يدعم الكتالوجات التي تستند إلى البيكسل.
`og:price:amount`	مطلوب. السعر الحالي للعنصر. بالنسبة لعلامات الفصل، استخدم "." بدلاً من "," للإشارة إلى العلامة العشرية. لا تقم بتضمين رموز، مثل "$" في السعر. يدعم الكتالوجات التي تستند إلى البيكسل. مثال: `1500.00`
`og:price:currency`	مطلوب. عملة السعر بتنسيق ISO. يدعم الكتالوجات التي تستند إلى البيكسل. المثال: `USD`
`product:brand`	مطلوب. اسم العلامة التجارية للعنصر. يدعم الكتالوجات التي تستند إلى البيكسل.
`product:availability`	مطلوب. التوّفر الحالي للعنصر: `in stock`، `out of stock`، `available for order`، `discontinued`. يدعم الكتالوجات التي تستند إلى البيكسل.
`product:catalog_id`	اختياري. معرف الكتالوج الفريد للعنصر. يمكن أن يكون شكلاً متنوعًا لكل منتج. يتم تعيين هذه السمة على `retailer_id` بعد استيراد المنتج. يجب أن يطابق الحقل `id` معرف المحتوى للبيكسل الخاص بك. يدعم الكتالوجات التي تستند إلى البيكسل.
`product:category`	اختياري. الحد الأقصى لعدد الأحرف: 250. يدعم الكتالوجات التي تستند إلى البيكسل. بالنسبة إلى إعلانات كتالوج Advantage+، تمثل القيم المحددة مسبقًا (معرف السلسلة أو الفئة) من تصنيف منتجات 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 نفسه لجميع العناصر التي تمثل أشكالاً متنوعة. على سبيل المثال، قميص بولو أحمر هو شكل متنوع من قميص بولو. يقوم فيسبوك بتعيين هذا على retailer_product_group_id بمجرد الحصول على قائمة البيانات. من خلال إعلانات كتالوج Advantage+، يختار فيسبوك عنصرًا واحدًا فقط من المجموعة استنادًا إلى الإشارة التي نتلقاها من حدث البيكسل أو التطبيق. بالنسبة للمعاملات التجارية - قم بتوفير product_group_id نفسه لجميع أشكال العناصر المتنوعة. على سبيل المثال، قميص بولو الأحمر هو شكل متنوع من قميص بولو. يقوم فيسبوك بتعيين هذا على 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`	مطلوب. معرف بائع التجزئة لهذا العنصر. يدعم الكتالوجات التي تستند إلى البيكسل.
`product:sale_price:amount`	اختياري. السعر المخفض إذا كان هناك خصم على العنصر. استخدم "." كعلامة عشرية للسعر بعد الخصم. السعر بعد الخصم مطلوب إذا كنت تخطط لاستخدام تراكب لأسعار مخفضة. يدعم الكتالوجات التي تستند إلى البيكسل. ملاحظة: بشكل عام، بالنسبة للكتالوجات القائمة على البيكسل، نوصي فقط بتسجيل أي تغييرات في السعر باستخدام إشارة og:price:amount الأساسية. إذا كنت تستخدم إشارة السعر بعد الخصم، فتأكد من استخدام الإشارات `product:sale_price_dates:start` و`product:sale_price_dates:end` للإشارة إلى موعد بدء الخصم وانتهائه. إذا لم يكن هناك تاريخ انتهاء، فقد يتم عرض السعر بعد الخصم إلى أجل غير مسمى. مثال: `9.99`
`product:sale_price:currency`	اختياري. عملة السعر المخفض إذا كان هناك خصم على العنصر بتنسيق 3 رمز عملة ISO المكون من 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`	معرف بائع التجزئة لهذا العنصر.
`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`	معرف بائع التجزئة لهذا العنصر.
`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 التسويق

إعلانات الفنادق، الحقول المدعومة
إعلانات رحلات الطيران، الحقول المدعومة
إعلانات الوجهة، الحقول المدعومة
إعلانات مخزون السيارات، الحقول المدعومة - المركبات والوكيل
إعلانات العقارات، الحقول المدعومة
روابط المنتجات لمواضع معينة