إعلانات الفنادق - الأحداث

تستخدم إعلانات الفنادق أربعة أحداث. ويتوفر في لكل حدث مجموعة من المعلمات (تتوفر قائمة كاملة في تفاصيل حول معلمات الأحداث). ويمكنك استخدام بيكسل Facebook على موقعك على الويب وأحداث تطبيق الهواتف المحمولة في تطبيقك بنظام Android وتطبيقك بنظام iOS.

الحدثوقت التشغيلعينة من الرمز البرمجي

البحث

في صفحة نتائج البحث عن الفنادق

البيكسل ونظام Android ونظام iOS

ViewContent

في صفحة تفاصيل الفندق

البيكسل ونظام Android ونظام iOS

InitiateCheckout

عندما ينتقل المستخدم إلى شاشة الدفع

البيكسل ونظام Android ونظام iOS

Purchase

في صفحة تم تأكيد الحجز

البيكسل ونظام Android ونظام iOS

بيكسل فيسبوك (لمواقع الويب)

يفترض هذا الدليل تثبيت بيكسل فيسبوك بالفعل. إذا لم تقم بتثبيته بعد، راجع استخدام واجهة API التسويق مع البيكسل.

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

حدث البيكسل Search

// This sample assumes the FB Pixel base code is already loaded

fbq('track', 'Search', {
  // Fire the 'Search' event on the search results page

  // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

  // RECOMMENDED: set to 'hotel'
  content_type: 'hotel',

  // HIGHLY RECOMMENDED: checkin date
  // Allows you to target people based on their travel dates (using a booking window)
  // Improves the landing experience with travel dates filled in (using template tags)
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkin_date: '2018-04-01',

  // HIGHLY RECOMMENDED: checkout date
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkout_date: '2018-04-05',

  // RECOMMENDED: content ids - include eg top 5 search results
  content_ids: '["123", "234", "345", "456", "567"]',

  // REQUIRED: city, don't use abbreviations
  city: 'New York',

  // REQUIRED: region, don't use abbreviations
  region: 'New York',

  // REQUIRED: country, don't use abbreviations
  country: 'United States',

  // RECOMMENDED: number of adults
  num_adults: 1,

  // RECOMMENDED: number of children
  num_children: 0
});

حدث البيكسل ViewContent

// This sample assumes the FB Pixel base code is already loaded

fbq('track', 'ViewContent', {
  // Fire the 'ViewContent' event on the hotel details page

  // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

  // RECOMMENDED: set to 'hotel'
  content_type: 'hotel',

  // HIGHLY RECOMMENDED: checkin date
  // Allows you to target people based on their travel dates (using a booking window)
  // Improves the landing experience with travel dates filled in (using template tags)
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkin_date: '2018-04-01',

  // HIGHLY RECOMMENDED: checkout date
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkout_date: '2018-04-05',

  // REQUIRED: content id of hotel that is shown
  content_ids: '123',

  // RECOMMENDED: city, don't use abbreviations
  city: 'New York',

  // RECOMMENDED: region, don't use abbreviations
  region: 'New York',

  // RECOMMENDED: country, don't use abbreviations
  country: 'United States',

  // RECOMMENDED: number of adults
  num_adults: 1,

  // RECOMMENDED: number of children
  num_children: 0
});

حدث البيكسل InitiateCheckout

// This sample assumes the FB Pixel base code is already loaded

fbq('track', 'InitiateCheckout', {
  // Fire the 'InitiateCheckout' event when the user enters the payment screen

  // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

  // RECOMMENDED: set to 'hotel'
  content_type: 'hotel',

  // HIGHLY RECOMMENDED: checkin date
  // Allows you to target people based on their travel dates (using a booking window)
  // Improves the landing experience with travel dates filled in (using template tags)
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkin_date: '2018-04-01',

  // HIGHLY RECOMMENDED: checkout date
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkout_date: '2018-04-05',

  // REQUIRED: content id of hotel that being booked
  content_ids: '123',

  // RECOMMENDED: city, don't use abbreviations
  city: 'New York',

  // RECOMMENDED: region, don't use abbreviations
  region: 'New York',

  // RECOMMENDED: country, don't use abbreviations
  country: 'United States',

  // RECOMMENDED: number of adults
  num_adults: 1,

  // RECOMMENDED: number of children
  num_children: 0
});

حدث البيكسل Purchase

// This sample assumes the FB Pixel base code is already loaded

fbq('track', 'Purchase', {
  // Fire the 'Purchase' event on the booking confirmed page

  // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

  // RECOMMENDED: set to set to 'hotel'
  content_type: 'hotel',

  // HIGHLY RECOMMENDED: checkin date
  // Allows you to target people based on their travel dates (using a booking window)
  // Improves the landing experience with travel dates filled in (using template tags)
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkin_date: '2018-04-01',

  // HIGHLY RECOMMENDED: checkout date
  // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
  checkout_date: '2018-04-05',

  // REQUIRED: content id of hotel that was booked
  content_ids: '123',

  // RECOMMENDED: city, don't use abbreviations
  city: 'New York',

  // RECOMMENDED: region, don't use abbreviations
  region: 'New York',

  // RECOMMENDED: country
  country: 'United States',

  // RECOMMENDED: number of adults
  num_adults: 1,

  // RECOMMENDED: number of children
  num_children: 0,

  // REQUIRED: total value of booking
  value: 1200,

  // REQUIRED: currency of booking
  currency: 'USD'
});

أحداث تطبيق الهواتف المحمولة لنظام Android

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

حدث Search في نظام Android

Bundle parameters = new Bundle();
// IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

// RECOMMENDED: set to 'hotel'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "hotel");

// RECOMMENDED: content ids - include eg top 5 search results
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"123\", \"234\", \"345\", \"456\", \"567\"]"); // top search results

// HIGHLY RECOMMENDED: checkin date
// Allows you to target people based on their travel dates (using a booking window)
// Improves the landing experience with travel dates filled in (using template tags)
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkin_date", "2018-04-01");

// HIGHLY RECOMMENDED: checkout date
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkout_date", "2018-04-05");

// REQUIRED: city, don't use abbreviations
parameters.putString("fb_city", "New York");

// REQUIRED: region, don't use abbreviations
parameters.putString("fb_region", "New York");

// REQUIRED: country
parameters.putString("fb_country", "United States");

// RECOMMENDED: number of adults
parameters.putInt("fb_num_adults", 1);

// RECOMMENDED: number of children
parameters.putInt("fb_num_children", 0);

// Fire the 'Search' event on the search results page
logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);

حدث ViewContent في نظام Android

Bundle parameters = new Bundle();
// IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

// RECOMMENDED: set to 'hotel'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "hotel");

// REQUIRED: content id of hotel that is shown
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "123");

// HIGHLY RECOMMENDED: checkin date
// Allows you to target people based on their travel dates (using a booking window)
// Improves the landing experience with travel dates filled in (using template tags)
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkin_date", "2018-04-01");

// HIGHLY RECOMMENDED: checkout date
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkout_date", "2018-04-05");

// RECOMMENDED: city, don't use abbreviations
parameters.putString("fb_city", "New York");

// RECOMMENDED: region, don't use abbreviations
parameters.putString("fb_region", "New York");

// RECOMMENDED: country
parameters.putString("fb_country", "United States");

// RECOMMENDED: number of adults
parameters.putInt("fb_num_adults", 1);

// RECOMMENDED: number of children
parameters.putInt("fb_num_children", 0);

// Fire the 'ViewContent' event on the hotel details page
logger.logEvent(
  AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
  parameters
);

حدث InitiateCheckout في نظام Android

Bundle parameters = new Bundle();
// IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

// RECOMMENDED: set to 'hotel'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "hotel");

// REQUIRED: content id of hotel that is being booked
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "123");

// HIGHLY RECOMMENDED: checkin date
// Allows you to target people based on their travel dates (using a booking window)
// Improves the landing experience with travel dates filled in (using template tags)
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkin_date", "2018-04-01");

// HIGHLY RECOMMENDED: checkout date
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkout_date", "2018-04-05");

// RECOMMENDED: city, don't use abbreviations
parameters.putString("fb_city", "New York");

// RECOMMENDED: region, don't use abbreviations
parameters.putString("fb_region", "New York");

// RECOMMENDED: country
parameters.putString("fb_country", "United States");

// RECOMMENDED: number of adults
parameters.putInt("fb_num_adults", 1);

// RECOMMENDED: number of children
parameters.putInt("fb_num_children", 0);

// Fire the 'InitiateCheckout' event when the user enters the payment screen
logger.logEvent(
  AppEventsConstants.EVENT_NAME_INITIATED_CHECKOUT,
  parameters
);

حدث Purchase في نظام Android

// total value of booking
BigDecimal purchaseAmount = BigDecimal.valueOf(1200);

// REQUIRED: currency of booking
Currency currency = Currency.getInstance("USD");

Bundle parameters = new Bundle();
// IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY

// RECOMMENDED: set to 'hotel'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "hotel");

// REQUIRED: content id of hotel that was booked
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "123");

// HIGHLY RECOMMENDED: checkin date
// Allows you to target people based on their travel dates (using a booking window)
// Improves the landing experience with travel dates filled in (using template tags)
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkin_date", "2018-04-01");

// HIGHLY RECOMMENDED: checkout date
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_checkout_date", "2018-04-05");

// RECOMMENDED: city, don't use abbreviations
parameters.putString("fb_city", "New York");

// RECOMMENDED: region, don't use abbreviations
parameters.putString("fb_region", "New York");

// RECOMMENDED: country
parameters.putString("fb_country", "United States");

// RECOMMENDED: number of adults
parameters.putInt("fb_num_adults", 1);

// RECOMMENDED: number of children
parameters.putInt("fb_num_children", 0);

// Use the built-in SDK method when the booking is confirmed
logger.logPurchase(
  purchaseAmount,
  currency,
  parameters
);

أحداث تطبيق الهواتف المحمولة لنظام iOS

يفترض هذا الدليل تثبيت مجموعة Facebook SDK بالفعل في تطبيقك للهواتف المحمولة بنظام iOS. إذا لم يكن الوضع كذلك، راجع iOS SDK. إذا كنت تستخدم أحد شركاء القياس، يجب التأكد من قيامه بتمرير الأحداث المطلوبة إلى فيسبوك.

حدث Search في نظام iOS

  // Fire the 'Search' event on the search results page  
  [[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameSearched

  // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY
  parameters:@{

    // REQUIRED: DO NOT change this, must be set to 'hotel'
    FBSDKAppEventParameterNameContentType : @"hotel",

    // RECOMMENDED: content ids - include eg top 5 search results
    FBSDKAppEventParameterNameContentID : @"[\"123\", \"234\", \"345\", \"456\", \"567\"]",

    // HIGHLY RECOMMENDED: checkin date
    // Allows you to target people based on their travel dates (using a booking window)
    // Improves the landing experience with travel dates filled in (using template tags)
    // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
    @"fb_checkin_date" : @"2018-04-01",

    // HIGHLY RECOMMENDED: checkout date
    // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
    @"fb_checkout_date" : @"2018-04-15",

    // REQUIRED: city, don't use abbreviations
    @"fb_city" : @"New York",

    // REQUIRED: region, don't use abbreviations
    @"fb_region" : @"New York",

    // REQUIRED: country, don't use abbreviations
    @"fb_country" : @"United States",

    // RECOMMENDED: number of adults
    @"fb_num_adults" : @1,

    // RECOMMENDED: number of children
    @"fb_num_children" : @0
  }
];

حدث ViewContent في نظام iOS

// Fire the 'ViewContent' event on the hotel details page
[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent

    // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY
    parameters:@{

      // REQUIRED: DO NOT change this, must be set to 'hotel'
      FBSDKAppEventParameterNameContentType : @"hotel",

      // REQUIRED: content id of hotel that is shown
      FBSDKAppEventParameterNameContentID : @"123",

      // HIGHLY RECOMMENDED: checkin date
      // Allows you to target people based on their travel dates (using a booking window)
      // Improves the landing experience with travel dates filled in (using template tags)
      // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
      @"fb_checkin_date" : @"2018-04-01",

      // HIGHLY RECOMMENDED: checkout date
      // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
      @"fb_checkout_date" : @"2018-04-15",

      // RECOMMENDED: city, don't use abbreviations
      @"fb_city" : @"New York",

      // RECOMMENDED: region, don't use abbreviations
      @"fb_region" : @"New York",

      // RECOMMENDED: country, don't use abbreviations
      @"fb_country" : @"United States",

      // RECOMMENDED: number of adults
      @"fb_num_adults" : @1,

      // RECOMMENDED: number of children
      @"fb_num_children" : @0
    }
];

حدث InitiateCheckout في نظام iOS

// Fire the 'InitiateCheckout' event when the user enters the payment screen
[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameInitiatedCheckout

    // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY
    parameters:@{

      // REQUIRED: DO NOT change this, must be set to 'hotel'
      FBSDKAppEventParameterNameContentType : @"hotel",

      // REQUIRED: content id of hotel that is shown
      FBSDKAppEventParameterNameContentID : @"123",

      // HIGHLY RECOMMENDED: checkin date
      // Allows you to target people based on their travel dates (using a booking window)
      // Improves the landing experience with travel dates filled in (using template tags)
      // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
      @"fb_checkin_date" : @"2018-04-01",

      // HIGHLY RECOMMENDED: checkout date
      // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
      @"fb_checkout_date" : @"2018-04-15",

      // RECOMMENDED: city, don't use abbreviations
      @"fb_city" : @"New York",

      // RECOMMENDED: region, don't use abbreviations
      @"fb_region" : @"New York",

      // RECOMMENDED: country, don't use abbreviations
      @"fb_country" : @"United States",

      // RECOMMENDED: number of adults
      @"fb_num_adults" : @1,

      // RECOMMENDED: number of children
      @"fb_num_children" : @0
    }
];

حدث Purchase في نظام iOS

// Fire the 'Purchase' event when the booking is confirmed

// total value of booking
[[FBSDKAppEvents shared] logPurchase:1200

    // currency of booking
    currency:@"USD"

    // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY
    parameters:@{

      // REQUIRED: DO NOT change this, must be set to 'hotel'
      FBSDKAppEventParameterNameContentType : @"hotel",

      // REQUIRED: content id of hotel that is shown
      FBSDKAppEventParameterNameContentID : @"123",

      // HIGHLY RECOMMENDED: checkin date
      // Allows you to target people based on their travel dates (using a booking window)
      // Improves the landing experience with travel dates filled in (using template tags)
      // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
      @"fb_checkin_date" : @"2018-04-01",

      // HIGHLY RECOMMENDED: checkout date
      // use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
      @"fb_checkout_date" : @"2018-04-15",

      // RECOMMENDED: city, don't use abbreviations
      @"fb_city" : @"New York",

      // RECOMMENDED: region, don't use abbreviations
      @"fb_region" : @"New York",

      // RECOMMENDED: country, don't use abbreviations
      @"fb_country" : @"United States",

      // RECOMMENDED: number of adults
      @"fb_num_adults" : @1,

      // RECOMMENDED: number of children
      @"fb_num_children" : @0
    }
];

تفاصيل حول معلمات الأحداث

في الهواتف المحمولة، تختلف أسماء المعلمات عن الأسماء في بيكسل Facebook. غالبًا ما تبدأ بالحرفين fb_ مع بعض الاستثناءات مثل content_ids مقابل fb_content_id وvalue مقابل _valueToSum.

عندما ترسل عدة قيم، على سبيل المثال، عند استخدام content_ids أو content_type، قم بتوفير مصفوفة مشفّرة بلغة JSON من القيم: '["value1", "value2"]'. يجب عدم تعيين تسلسل القيم باستخدام الفاصلة.

اسم المعلمة ونوعهاالوصف

checkin_date (البيكسل)

fb_checkin_date (التطبيق)

النوع: string (سلسلة)

موصى به بشدة.

يمثل التاريخ الذي يريد المستخدم تسجيل الدخول فيه إلى الفندق تبعًا للمنطقة الزمنية الخاصة بموقع الفندق. ونقبل التواريخ بتنسيقات YYYYMMDD وYYYY-MM-DD وYYYY-MM-DDThh:mmTZD وYYYY-MM-DDThh:mm:ssTZD. وفي حالة توفره، يمكنك استخدام ذلك في الإعلان باستخدام علامات القوالب واستهداف الأشخاص استنادًا إلى تواريخ السفر الخاصة بهم باستخدام فترة الحجز لدى جماهيرك.

أمثلة:

  • 20180623
  • 2018-06-23
  • 2017-06-23T15:30GMT
  • 2017-06-23T15:30:00GMT

checkout_date (البيكسل)

fb_checkout_date (التطبيق)

النوع: string (سلسلة)

موصى به بشدة.

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

content_ids (البيكسل)

fb_content_id (التطبيق)

النوع: string (سلسلة) أو string[] (سلسلة[])

موصى به لحدث search، ومطلوب لكل الأنواع الأخرى.

يمثل أي معرفات ذات صلة مُدرجة في كتالوج السفر، فعلى سبيل المثال، بالنسبة للحدث ViewContent، يمكنك إرسال معرف العنصر المعروض، أو بالنسبة للحدث Search، يمكنك إرسال مصفوفة من المعرفات الخاصة بأبرز نتائج البحث.

أمثلة:

  • "1234"
  • '["1234", "2345", "3456"]'

content_type (البيكسل)

fb_content_type (التطبيق)

النوع: string (سلسلة) أو string[] (سلسلة [])

موصى به.

يجب أن يكون hotel.

city (البيكسل)

fb_city (التطبيق)

النوع: string (سلسلة)

مطلوب للحدث search.

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

المثال: Auckland.

region (البيكسل)

fb_region (التطبيق)

النوع: string (سلسلة)

مطلوب للحدث search.

قم بتوفير الولاية/الدائرة/المنطقة الخاصة بالموقع من نية المستخدم.

المثال: Manhattan

country (البيكسل)

fb_country (التطبيق)

النوع: string (سلسلة)

مطلوب للحدث search.

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

المثال: New Zealand

value (البيكسل)

_valueToSum (التطبيق)

النوع: float (رقم عشري)

مطلوب للحدث purchase.

يمثل إجمالي سعر الحجز (رقم يشير إلى قيمة هذا الحدث بالنسبة للمُعلن).

المثال: 155

currency (البيكسل)

fb_currency (التطبيق)

النوع: string (سلسلة)

مطلوب للحدث purchase.

يمثل عملة value. ويتم تحديدها باستخدام تنسيق العملة بمعيار ISO 4217.

المثال: USD

destination_ids (البيكسل)

fb_destination_ids (التطبيق)

النوع: string (سلسلة) أو string[] (سلسلة [])

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

المثال: '["dest2", "dest5", "dest8"]'

hotel_score (البيكسل)

fb_hotel_score (التطبيق)

النوع: float (رقم عشري)

يمثل مؤشر يوضح القيمة النسبية لهذا الفندق بالنسبة للمُعلن مقارنة بالفنادق الأخرى التابعة له.

المثال: 3

num_adults (البيكسل)

fb_num_adults (التطبيق)

النوع: string (سلسلة)

يمثل عدد النزلاء من البالغين. ويمكنك استخدام هذا العدد في الإعلان من خلال علامات القوالب عند توفيره.

المثال: 2.

num_children (البيكسل)

fb_num_children (التطبيق)

النوع: int (عدد صحيح)

يمثل عدد النزلاء من الأطفال. ويمكنك استخدام هذا العدد في الإعلان من خلال علامات القوالب عند توفيره.

المثال: 2.

preferred_neighborhoods (البيكسل)

fb_preferred_neighborhoods (التطبيق)

النوع: string[] (سلسلة[])

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

المثال: '["Brooklyn", "Manhattan"]'

preferred_price_range (البيكسل)

fb_preferred_price_range (التطبيق)

النوع: [int (min), int (max)] [عدد صحيح (الحد الأدنى)، عدد صحيح (الحد الأقصى)]

يمثل مجموعة من الحد الأدنى والحد الأقصى لأسعار الغرف والتي يقوم المستخدم بالفلترة للحصول عليها.

المثال [100, 150]

preferred_star_ratings (البيكسل)

fb_preferred_star_ratings (التطبيق)

النوع: [int (min), int (max)] [عدد صحيح (الحد الأدنى)، عدد صحيح (الحد الأقصى)]

يمثل مجموعة من الحد الأدنى والحد الأقصى لتصنيف الفندق بالنجوم والتي يقوم المستخدم بالفلترة للحصول عليها.

المثال [100, 150]

user_score (البيكسل)

fb_user_score (التطبيق)

النوع: float (رقم عشري)

يمثل مؤشر يوضح القيمة النسبية لهذا المستخدم بالنسبة للمُعلن.

المثال: 50