إنشاء جمهور للعقارات

بدءًا من طرح API التسويق بالإصدار 15.0، لن تتمكن من إنشاء جماهير الإعلانات الخاصة بعد الآن. راجع جماهير الإعلانات الخاصة لمزيد من المعلومات.

إنشاء جمهور للعقارات:

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

الخطوة الأولى: إعداد إشارات المستخدمين لأحداث العقارات

تمثل أسماء أحداث محددة مسبقًا يمكنك إرسالها من موقعك على الويب أو تطبيقك بحيث تتيح لك قياس أداء حملاتك الإعلانية وتسجيل النية المُسجلة من جماهيرك. ويمكنك الرجوع إلى إعداد بيكسل Facebook.

تتطلب إعلانات العقارات الأحداث القياسية هذه من بيكسل موقعك على الويب وتطبيق الهاتف المحمول لديك:

حدث البيكسل	حدث التطبيق	مستوى المطلب	الوصف
`Search`	`fb_mobile_search`	◉	بحث أحد الأشخاص عن قوائم منتجات منزلية
`ViewContent`	`fb_mobile_content_view`	◉	عرض أحد الأشخاص قائمة منتجات محددة
`InitiateCheckout`	`fb_mobile_initiated_ checkout`	◉	حفظ أحد الأشخاص قائمة منتجات أو أبدى إعجابه أو اهتمامًا خاصًا بها
`Purchase`	`fb_mobile_purchase`	◉	اتصل أحد الأشخاص بوكيل بشأن إحدى قوائم المنتجات

◉ مطلوب: لن تعمل الإعلانات بدون هذه المعلمات.
◎ موصى به: ليس مطلوبًا بالتحديد، ولكنه يتيح توفير توصيات أفضل وخيارات استهداف أكثر لإعلاناتك. لذا أدخل أكبر قدر ممكن من هذه العناصر.
◯ غير مطلوب: غير مطلوب ويمكن تجاهله.

فعلى سبيل المثال، للإبلاغ عن حدث بحث عن قائمة منتجات باستخدام بيكسل FB أو أحداث التطبيق، أدخل هذا الرمز البرمجي في صفحة نتائج البحث:

<!-- Facebook Pixel Code -->

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "home_listing");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"1234\", \"2345\", \"3456\", \"4567\"]"); // top search results

// we must prefix all travel-specific parameters with fb_
parameters.putString("fb_city", "New York City"); // Required for Search event
parameters.putString("fb_region", "New York"); // region is the state for the US. Required for Search event
parameters.putString("fb_country", "US"); // Required for Search event

logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);

[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
  parameters:@{
    FBSDKAppEventParameterNameContentType : @"home_listing",
    FBSDKAppEventParameterNameContentID : @"[\"1234\", \"2345\", \"3456\", \"4567\"]", // top search results
		// we must prefix all travel-specific parameters with fb_
		@"fb_city" : @"New York City", //Required for Search event
	  @"fb_region" : @"New York", // region is the state for the US. Required for Search event
	  @"fb_country" : @"US", // Required for Search event
  }
];

بمجرد تحديد للأحداث التي يجب تشغيلها، يجب عليك إدخال معلمات كل حدث.

معلمات الأحداث

يتضمن الجدول أدناه المعلمات المطلوبة والموصى بها.

معلمة البيكسل	معلمة الهاتف المحمول	مستوى المطلب
`content_ids`	`fb_content_id`	◉
`content_type`	`fb_content_type`	◯
`lease_start_date`		◎
`lease_end_date`		◎
`preferred_baths_range`		◎
`preferred_beds_range`		◎
`preferred_price_range`		◎
`currency`	`fb_currency`	◎
`property_type`		◎
`listing_type`		◎
`availability`		◎
`city`	`fb_city`	◎
`neighborhood`		◎
`region`	`fb_region`	◎
`country`	`fb_country`	◎

تفاصيل حول المعلمات

اسم المعلمة	نوع البيانات	الوصف
`availability`	`string`	يجب أن تكون القيمة `available_soon` أو `for_rent` أو `for_sale` أو `off_market` أو `recently_sold` أو `sale_pending`.
`city`	`string`	أدخل المدينة محل اهتمام المستخدم، فعلى سبيل المثال `'Menlo Park'`
`content_ids`	`string` أو `string[]`	يمثل أي معرفات في كتالوج قوائم منتجاتك. فعلى سبيل المثال، بالنسبة لحدث `ViewContent`، أرسل معرف العنصر الذي تم عرضه، أو بالنسبة لحدث `Search`، أرسل مصفوفة المعرفات لأهم النتائج: `['1234', '2345', '3456', '4567']`
`content_type`	`string` أو `string[]`	فعلى سبيل المثال `'home_listing'` `['home_listing', 'product']` `['home_listing', 'hotel']`
`country`	`string`	يمثل البلد المستهدف محل الاهتمام، مثل `'United States'`
`currency`	`string`	يتم التحديد باستخدام تنسيق العملة ISO 4217 التالي: `'USD'`
`lease_start_date`	`string`	يمكن السماح لنا بتوصية العقارات بناءً على تاريخ توفّرها (باستخدام `available_dates_price_config` في الكتالوج)، وتحسين تجربة المستخدم المطلوبة (باستخدام إشارات القوالب). يتم التحديد باستخدام تنسيق التاريخ ISO 8601 التالي: `'YYYY-MM-DD'` (فعلى سبيل المثال، `2018-01-01`).
`lease_end_date`	`string`	يتم التحديد باستخدام تنسيق التاريخ ISO 8601 التالي: `'YYYY-MM-DD'` (فعلى سبيل المثال، `'2018-02-01'`).
`listing_type`	`string`	يجب أن تكون القيمة `for_rent_by_agent` أو `for_rent_by_owner` أو `for_sale_by_agent` أو `for_sale_by_owner` أو `foreclosed` أو `new_construction` أو `new_listing`.
`neighborhood`	`string`	يمثل المنطقة محل الاهتمام: `'Menlo Oaks'`
`preferred_baths_range`	`[int`(min)`, int`(max)`]`	يمثل عدد الحمامات المختارة كنطاق: `[1, 2]`
`preferred_beds_range`	`[int`(min)`, int`(max)`]`	يمثل عدد غرف النوم المختارة كنطاق: `[1, 2]`
`preferred_price_range`	`[float`(min)`, float`(max)`]`	يمثل نطاق الأسعار: `[1000.99, 2000.99]`
`property_type`	`string`	يجب أن يكون `apartment` أو `condo` أو `house` أو `land` أو `manufactured` أو `other` أو `townhouse`.
`region`	`string`	يمثل الولاية أو الدائرة أو المنطقة محل الاهتمام: `'California'`

الخطوة الثانية: ربط الإشارات بكتالوج قوائم المنتجات

يمكنك ربط مصادر الأحداث بجميع كتالوجات قوائم المنتجات. ويمكنك الرجوع إلى صفحة كتالوج مدير الأعمال ولتحديد البيكسل والتطبيق عبر واجهة API التي ترسل الأحداث، قم بإجراء طلب HTTP POST:

curl \
  -F '0=

حدد هذه المعلمات:

اسم الحقل	نوع البيانات	الوصف
`external_event_sources` (مطلوب)	`int[]`	يمثل قائمة معرفات التطبيق والبيكسل المطلوب ربطها بالكتالوج.

الخطوة الثالثة: إنشاء مجموعات مصادر أحداث العقارات ومشاركتها

لإنشاء جمهور، يتعين على مسؤول نشاطك التجاري إنشاء مجموعة مصادر أحداث. يؤدي ذلك إلى تجميع كل المصادر التي ترسل إشارات الاهتمام بقوائم المنتجات. إجراء طلب HTTP POST:

curl \
  -F 'name=My Real Estate Company Events' \
  -F 'event_sources=['

بعد ذلك شارك مجموعة مصادر الأحداث هذه مع أي حسابات إعلانية ستعرض الإعلانات للجماهير التي يتم إنشاؤها بواسطة مصادر الأحداث هذه. إجراء طلب HTTP POST:

curl \
  -F 'accounts=['

الخطوة الرابعة: إنشاء الجماهير

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

لإعداد جمهور جديد، قم بإجراء طلب HTTP POST إلى /act_<AD_ACCOUNT_ID>/customaudiences.

المعلمات المطلوبة

اسم الحقل	نوع البيانات	الوصف
`name`	`string`	يمثل اسم الجمهور.
`subtype`	`enum {CLAIM}`	يمثل نوع الجمهور المخصص. ويجب تعيينه إلى `CLAIM`.
`claim_objective`	`enum {HOME_LISTING}`	يمثل هدف الجمهور. يجب تعيينه على `HOME_LISTING`.
`event_source_group`	`id`	يمثل مجموعة مصادر الأحداث لإنشاء الجمهور.
`inclusions`	`object[]`	يمثل مصفوفة كائنات بلغة JSON. ويمكن سرد جميع إشارات النية التي تجعل الشخص مؤهلًا لهذا الجمهور.
عمليات التضمين: `event` (مطلوب)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	يمثل اسم حدث إشارة. ويتم استخدامه للتضمين في جمهور: `{'event': 'Search', …}`.
عمليات التضمين: `retention` (مطلوب)	`object`	يمثل الحد الأدنى والحد الأقصى للمدة الزمنية منذ تلقي الحدث. ويحدد ما إذا كانت تتم مراعاة الحدث لتضمينه أم لا. المثال: `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. يتعين أن تكون مدة الاحتفاظ أربع ساعات على الأقل.
عمليات التضمين: `count`	عوامل تشغيل `JSON`	يمثل عدد مرات تشغيل الحدث. ويمكنك استخدام عوامل تشغيل المقارنة الرقمية والمساواة، مثل `{…'count': {'lte': 3}, …}`.

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

اسم الحقل	نوع البيانات	الوصف
`content_type`	`enum {HOME_LISTING}`	نوع الإشارات المُستخدمة لإنشاء هذا الجمهور.
`description`	`string`	يمثل وصف الجمهور.
`exclusions`	`object[]`	يمثل مصفوفة كائنات بلغة JSON تسرد جميع إشارات النية التي تستبعد الشخص من هذا الجمهور.
عمليات الاستبعاد: `event` (مطلوب)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	يمثل اسم حدث الإشارة المُستخدمة للاستبعاد: `{'event': 'Search', …}`.
عمليات الاستبعاد: `retention` (مطلوب)	`object`	الحد الأدنى والحد الأقصى للمدة الزمنية منذ تلقي الحدث. ويمكن تحديد ما إذا كانت تتم مراعاة الحدث لاستبعاده أم لا، فعلى سبيل المثال `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. ويتعين أن تكون مدة الاحتفاظ أربع ساعات على الأقل.
`rule`	`object`	يمثل قاعدة الجمهور من الجماهير المخصصة لموقع الويب. ويمكنك فلترة بث الأحداث باستخدام هذه القواعد قبل معالجة `inclusions` و`exclusions`. يمكنك الرجوع إلى قائمة الحقول المحددة المتوفرة. ويمكنك استخدامها مع أحد عوامل تشغيل `JSON` القياسية لقواعد الجمهور.
القاعدة: `home_listing_set_id` (مطلوب)	`object`	يمثل معرف مجموعة قوائم المنتجات: `{'eq': '1234'}}`

فعلى سبيل المثال، لإنشاء جمهور يستهدف الأشخاص الذين عرضوا أو اشتروا منتجات خلال آخر 14 يومًا:

curl \
  -F 'name=Viewed or Purchased Last 14 days' \
  -F 'subtype=CLAIM' \
  -F 'claim_objective=HOME_LISTING' \
  -F 'content_type=HOME_LISTING' \
  -F 'event_source_group=