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

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

يجب تحميل المخزون على فيسبوك باستخدام كتالوج. بالنسبة لكل كتالوج، يجب توفير قائمة منتجات بأحد التنسيقات المدعومة: CSV أو TSV أو RSS XML أو ATOM XML أو Google Sheets (راجع مقالة مركز المساعدة لمزيد من الإرشادات).

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>

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

لجدولة عمليات الاستدعاء من قائمة البيانات، راجع التنسيقات المقترحة أدناه.

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

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

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

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

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

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

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

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

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

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

المتطلبات

• يجب تضمين حقل id في ملف قائمة البيانات الثانوي. لتشغيل إعلانات كتالوج Advantage+، يجب أن يطابق معرف كل عنصر معرفه في قائمة بيانات الكتالوج الأصلي ومعرف المحتوى من البيكسل الخاص بك.
• يجب تضمين حقل 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

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

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

الفنادق

• 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 حرف كحد أقصى.

Schema.org - الإشارات المطلوبة

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

JSON-LD في Schema.org — الإشارات المطلوبة

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

يتم الحصول عليه من schema.org/Product

يتم الحصول عليه من schema.org/Offer (كجزء من عروض المنتجات)

تصدير مخطط 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 الموجز
• العنصر
• البحث عن العنصر في الكتالوج
• مجموعات المنتجات

API التسويق

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