إعلانات العقارات - بدء الاستخدام

الخطوة الأولى: إنشاء كتالوج قوائم المنازل.

الخطوة الثانية: إعداد القوائم والتسعير.

الخطوة الثالثة: تحديث الخيارات.

الخطوة الرابعة: فلترة كتالوج القوائم لمجموعة القوائم.

الخطوة الخامسة: إرسال التحويلات بلا اتصال (اختياري)

الخطوة السادسة: إنشاء جمهور العقارات. بشكل مختلف عما يحدث مع قوائم العقارات التي ينشرها المستخدمون، بالنسبة إلى عمليات دمج الشركاء، يتم إرسال بيانات العملاء المحتملين إلى الشركاء عن طريق نموذج تجميع بيانات العملاء المحتملين، بدلاً من الدردشة في Messenger. تعرف على المزيد حول استرداد بيانات العملاء المحتملين للمعاملات التجارية.

الخطوة السابعة: إنشاء الإعلانات وعرضها لقوائم المنازل.

الخطوة الثامنة: الحصول على معلومات العرض لمعرفة كيفية تفاعل الأشخاص على فيسبوك مع الإعلانات. راجع رؤى الإعلانات.

الخطوة التاسعة: استخدام أدوات تصحيح الأخطاء لتشخيص المشاكل وحلها. راجع أدوات تصحيح أخطاء إعلانات كتالوج Advantage+.

الخطوة الأولى: إنشاء كتالوج قوائم المنازل

بالنسبة إلى إعلانات كتالوج Advantage+

يجب على الكتالوج أن يحتوي على قائمة العقارات التي تريد الإعلان عنها. راجع مرجع الكتالوج.

لإنشاء كتالوج قوائم المنازل لإعلانات كتالوج Advantage+، قم بتعيين vertical على home_listings:

curl \
  -F 'name=Home Listing Catalog Name' \
  -F 'vertical=home_listings' \
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/<API_VERSION>

لاستخدام API الكتالوج، تحتاج إلى مستوى وصول إلى API التسويق وإلى قبول شروط الخدمة عن طريق إنشاء الكتالوج الأول من خلال مدير الأعمال.

بالنسبة إلى المعاملات التجارية

للتعليمات حول كيفية إنشاء كتالوج للمعاملات التجارية، تفضل بزيارة وثائق منصة Marketplace.

الخطوة الثانية: إعداد القوائم والتسعير

تتضمن القائمة معلومات عن العقارات مثل معرف قائمة المعروضات والاسم والتوفر والوصف والعنوان وغرف النوم والحمامات وغيرها. يمكنك الحصول على مجموعة من قوائم المعروضات التي تم تحميلها أو إحضارها من نشاطك التجاري. عنصر قائمة المعروضات عبارة عن عقار واحد معروض بموقعك على الويب أو بتطبيقك.

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

يمكن أن يكون لديك قائمة بيانات واحدة تضم جميع العقارات التي بالكتالوج أو يكون لديك عدة قوائم بيانات، حيث تمثل إحداها العقارات التي في أحد البلدان أو التابعة لهيئة عقارات واحدة أو لوسيط واحد.

بالنسبة إلى إعلانات كتالوج Advantage+، عليك تقديم قائمة بيانات القوائم بأحد هذه التنسيقات:

بالنسبة إلى المعاملات التجارية، عليك تقديم قائمة بيانات القوائم بتنسيق XML:

يكتشف محلل قوائم البيانات تلقائيًا تشفيرات النصوص UTF8 أو UTF16 أو UTF32، حيث يعود مرة أخرى إلى LATIN1 إذا ظهرت تسلسلات بايت غير متوقعة.

مثال على قائمة بيانات XML

<?xml version="1.0" encoding="UTF-8"?>
<listings>
    <title>example.com Feed</title>
    <link rel="self" href="http://www.example.com"/>
    <listing>
        <home_listing_id>12345678</home_listing_id>
        <name>1 Hacker Way, Menlo Park, CA 94025</name>
        <availability>for_rent</availability>
        <description>An amazing listing</description>
        <address format="simple">
            <component name="addr1">1 Hacker Way</component>
            <component name="city">Menlo Park</component>
            <component name="region">California</component>
            <component name="country">United States</component>
            <component name="postal_code">94025</component>
        </address>
        <latitude>1.11414</latitude>
        <longitude>-1.835003</longitude>
        <neighborhood>Menlo Oaks</neighborhood>
        <image>
            <url>http://example.com/12345678-1.jpg</url>
        </image>
        <image>
            <url>http://example.com/12345678-2.jpg</url>
        </image>
        <image>
            <url>http://example.com/12345678-3.jpg</url>
        </image>
        <listing_type>for_rent_by_agent</listing_type>
        <num_baths>6</num_baths>
        <num_beds>5</num_beds>
        <num_units>1</num_units>
        <price>110000 USD</price>
        <property_type>house</property_type>
        <url>http://www.example.com/link_to_listing</url>
        <year_built>2007</year_built>
    </listing>
</listings>

الحقول المدعومة - قوائم المنازل

صُممت الحقول المدعومة التالية للعناصر التي تضيفها إلى كتالوج المنتجات.

بالنسبة للكتالوجات التي تم تطويعها محليًا، يمكنك الرجوع إلى الحقول المدعومة لإعلانات قوائم المنازل.

يكتشف محلل قوائم البيانات تلقائيًا تشفيرات النصوص UTF8 أو UTF16 أو UTF32، حيث يعود مرة أخرى إلى LATIN1 إذا ظهرت تسلسلات بايت غير متوقعة. وعلى الرغم من أن النص الذي داخل قيم الحقول يمكن أن يكون بأي لغة، فإن أسماء الحقول يجب أن تكون مطابقة تمامًا للمذكور أدناه، وباللغة الإنجليزية.

الحقول المطلوبة الخاصة بكل بلد - المعاملات التجارية فقط

تفضل بزيارة وثائق منصة Marketplace للحقول المطلوبة الخاصة بكل بلد للمعاملات التجارية.

معلمات كائن الصورة

معلمات كائن العنوان

تكوين أسعار التواريخ المتوفرة

مع available_dates_price_config، يمكنك تقديم التوّفر والأسعار لكل عقار لنطاق تاريخ محدد. عند تضمين نطاقات التواريخ في هذا الحقل، يضع فيسبوك في الاعتبار هذا التوفر في توصيات المنتجات ويحاول عرض القوائم المتوفرة للتواريخ التي قام الشخص بالبحث عنها في الموقع. وبشكل اختياري، إذا قمت بتضمين التسعير، فيمكننا أيضًا عرض الأسعار المحددة بتواريخ في تصميم الإعلان. لتمكين هذه الميزة، يجب عليك أيضًا إرسال lease_start_date وlease_end_date فيسبوك في أحداث البيكسل.

معلمات كائن التواريخ المتوفرة

هذا مثال على توّفر القوائم وكيفية ظهورها في JSON:

"available_dates_price_config": [
    {
        // available until 11/01 at $150/night
        "end_date": "2018-11-01",
        "rate": "15000",
        "currency": "USD",
        "interval": "nightly",
    },
    {
        // available from 11/01 - 12/01 at $200/night
        "start_date": "2018-11-01",
        "end_date": "2018-12-01",
        "rate": "20000",
        "currency": "USD",
        "interval": "nightly",
    },
    {
        // available from 11/01 onward at $500/week
        "start_date": "2018-11-01",
        "rate": "50000",
        "currency": "USD",
        "interval": "weekly",
    },
]

روابط لمواضع معينة للمنتجات

قم بتوفير روابط لمواضع معينة في قائمة المنتجات من خلال اتباع مواصفات روابط التطبيق. وتحتل معلومات الروابط لمواضع معينة في قائمة المنتجات الأولوية بالنسبة لأي معلومات يجمعها فيسبوك من خلال بيانات تعريف روابط التطبيق عن طريق متتبع الويب.

إذا كان لديك معلومات حول الروابط لمواضع معينة من روابط التطبيق بالفعل، فلن تحتاج إلى تحديد هذه البيانات. يستخدم فيسبوك هذه المعلومات من روابط التطبيق لعرض رابط صحيح لموضع معين. لعرض الروابط لمواضع معينة في الإعلانات، يمكنك الرجوع إلى إعلانات كتالوج Advantage+، قالب الإعلان.

الخطوة الثالثة: تحديث الخيارات

إعلانات كتالوج Advantage+

بالنسبة إلى إعلانات كتالوج Advantage+، يمكنك تحديث معلومات قوائم المنازل التي بالكتالوج عبر الطرق التالية باستخدام التحميل المباشر. راجع التحميل المباشر لمرجع قائمة البيانات

مثال - يمكنك إجراء تحميل لمرة واحدة يدويًا:

curl \
  -F "url=http://www.example.com/sample_feed.xml" \
  -F "access_token=

المعاملات التجارية

بالنسبة إلى المعاملات التجارية، يمكنك تحديث معلومات قوائم المنازل في الكتالوج من خلال إعداد تحميل قائمة بيانات متكرر (مجدول) وتحديث قائمة البيانات. في Marketplace، نوصي بشدة باستخدام خيار تعيين جدول.

تعيين جدول زمني لتحميل قائمة بيانات الكتالوج

1. انتقل إلى مدير المعاملات التجارية.
2. انقر على مصادر البيانات.
3. انقر على إضافة مصدر بيانات.
4. انقر على استخدام قوائم البيانات وانقر على التالي.
5. انقر على تعيين جدول.
   
6. اختر معدل التكرار الذي تريد فيسبوك استخدامه للتحقق من قائمة البيانات للتحديثات: كل يوم وكل ساعة وكل أسبوع. إذا اخترت كل ساعة أو كل أسبوع كمعدل للتكرار، يمكنك أيضًا تحديد موعد تكرار التحميل المجدول.
7. أدخل عنوان URL المباشر لقائمة البيانات. يمكنك استخدام عناوين URL تستخدم تنسيقات HTTP أو HTTPS أو FTP أو SFTP. ملاحظة: يجب أن يشير عنوان URL مباشرة إلى ملف قائمة البيانات الذي تستخدمه، وإلا ستفشل عملية التحميل.
8. (اختياري) أدخل اسم المستخدم وكلمة السر لموفر قائمة البيانات. يختلف ذلك عن اسم المستخدم وكلمة السر التي تستخدمها لتسجيل الدخول إلى حسابك الإعلاني على فيسبوك.
9. أدخل اسمًا لقائمة بياناتك.
10. اختر نوع عملة قائمة بياناتك. يتم استخدام نوع العملة لقائمة بياناتك إذا لم تحدد النوع في ملف قائمة البيانات.
11. انقر على التالي.
12. راجع ملف قائمة البيانات للتأكد من عدم وجود أي أخطاء. إذا وجدت أن بعض الأعمدة المطلوبة غير متوفرة في ملفك، أو عدم قدرة فيسبوك على التعرف على بعض الأعمدة، يمكنك تعيينها إلى الأعمدة المناسبة هنا. يتم الاحتفاظ بأي أعمدة يتم تعيينها هنا لعمليات تحميل قوائم البيانات في المستقبل.
13. انقر على التالي.

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

تدعم المعاملات التجارية تجربة متعددة اللغات. عند إضافة قائمة بيانات بلغة ثانوية إلى الكتالوج، يمكنك إنشاء قائمة بيانات أخرى بلغة ثانوية من هذا الكتالوج الواحد. تتجاوز المعلومات الموجودة في قوائم البيانات الثانوية اللغة الافتراضية عندما تظهر القوائم للجمهور المعني.

تنطبق هذه الميزة فقط على شركاء البلدان المحددة. يُرجى التواصل مع ممثل فيسبوك لمعرفة الإمكانيات في السوق.

1. يمكنك إنشاء كتالوج بقائمة البيانات للغة والبلد الافتراضية.
2. يمكنك إنشاء ملف XML فقط بمعرف القوائم (home_listing_id) والحقول الإضافية التي تتطلب تجاوز لغة محلية مثل الاسم أو الوصف أو الحقول الإضافية. لتجاوز المعلومات، يجب أن يطابق home_listing_id تلك الموجودة في قائمة بيانات الكتالوج الأصلية.
3. أضف قائمة بيانات المعلومات الإضافية من مدير المعاملات التجارية.
   
   إضافة قائمة البيانات الإضافية من مدير المعاملات التجارية [إضافة معلومات قوائم المنازل] - [إضافة معلومات اللغة]
   
   
   
4. قم بتأكيد مصدري البيانات ضمن الكتالوج ذاته.
   

الخطوة الرابعة: فلترة كتالوج القوائم لمجموعة القوائم

هذه عبارة عن مجموعة عناصر في كتالوج تعلن عنها في إعلانات كتالوج Advantage+. كل كتالوج قوائم يضم كثيرًا من مجموعات القوائم.

curl \
  -F "name=test set" \
  -F 'filter={"availability":{"eq":"for_sale"}}' \
  -F "access_token=" \
  https://graph.facebook.com/

الفلتر filter أعلاه مكون من عوامل التشغيل والبيانات التالية:

الخطوة الخامسة: إرسال التحويلات بلا اتصال

يمكنك إرسال أحداث التحويل بلا اتصال ومعرفة عدد العملاء الذين شاهدوا إعلانات فيسبوك وقوائم المعاملات التجارية أو نقروا عليها قبل التحويل؛ استخدم API التحويلات بلا اتصال وأضف الحقول التالية في الخطوة الرابعة. قم بتحميل الأحداث بلا اتصال.

مفاتيح المطابقة

تقارن مفاتيح المطابقة التحويل بالمستخدم.

البيانات المخصصة

تقارن البيانات المخصصة التحويل بالتاجر.

تفاصيل الحدث

تصف "تفاصيل الحدث" حدث التحويل بلا اتصال الذي حدث. معدل تكرار التحميل يومي، خلال 48 ساعة من الحدث.