إعلانات الفنادق - التسعير الخاص بالتاريخ

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

استخدم التحميل المُجمع لأنوع الغرف وبيانات التسعير لمشاركة تفاصيل التسعير مع Facebook.

اطّلع على معلمات الغرفة والتسعير للحصول على شرح لكل المعلمات.

التحميل المُجمع لأنواع الغرف وبيانات التسعير

يتكوّن التحميل على دُفعات من جزأين:

  1. تحميل أنواع الغرف
  2. تحميل التسعير

إذا كنت تستخدم التحميل على دُفعات، فعليك تقييد عمليات التحميل إلى 50 ميجابايت لكل ملف وهو حوالي 50,000 عنصر في ملف. نوصي بإجراء تحديثات أصغر وأكثر تكرارًا لمتغيرات التسعير.


تحميل أنواع الغرف

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

ملاحظة: إذا لم يكن لديك أنواع غرف مختلفة، فيمكنك تخطي هذه الخطوة.

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

تنسيق ملف أنواع الغرف

يمكنك تقديم أنواع الغرف في تنسيق XML؛ اطّلع على العينة.

ينبغي تحديد كل فندق بواسطة <property> في عقدة XML <PropertyDataSet> وتوفير نوع الغرفة حسب <RoomData>. ويجب أن يبدأ ملفك بإشارة توضيح <?xml.

لمزيد من التفاصيل حول تحديث أنواع الغرف وحذفها من خلال واجهة API التجميع، اطّلع على غرف الفنادق، مرجع التجميع.


تحميل التسعير

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

ملاحظة: إذا كان لديك عدد صغير من الغرف، فيمكنك أيضًا استخدام واجهة API غرفة الفندق لإنشاء أنواع الغرف وإعداد التسعير.

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

تنسيق ملف التسعير

قبل تحميل أنواع الغرف، تأكد من وجود الفنادق التي تحتوي على هذه الغرف بالفعل في الكتالوج. ويمكنك تقديم متغيرات التسعير بهذا التنسيق:

عينة من الملف وتنسيقهالوصف

XML مع أنواع الغرف | عينة من XML

تأكد من أن أنواع الغرف التي تريد توفير أسعار لها موجودة بالفعل.


يمكنك تحديد التسعير (<Baserate>) ضمن كل نوع غرفة (<RoomBundle>) استنادًا إلى كل من تاريخ الدخول إلى المكان (<Checkin>) ومدة الإقامة (<Nights>).


يجب أن يبدأ الملف بإشارة التعريف <?xml.

XML بدون أنواع الغرف | عينة من XML

يمكنك تحديد التسعير (<Baserate>) لكل من معرف الفندق (<Property>) وتاريخ الدخول إلى المكان (<Checkin>) ومدة الإقامة (<Nights>).


يجب أن يبدأ الملف بإشارة التعريف <?xml.

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

معلمات الغرف والتسعير

اسم الحقل والنوعالوصف

Property

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

مطلوب. يمثل معرف فريد للفندق يتم توفيره بواسطة المعلن كـ hotel_id في قائمة الفندق.

RoomID

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

مطلوب. يمثل معرف فريد لنوع الغرفة يتم توفيره بواسطة المعلن.

Name

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

مطلوب. يمثل اسم نوع غرفة الفندق.

Description

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

مطلوب. يمثل وصف نوع غرفة الفندق.

BasePrice

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

مطلوب. يمثل أقل سعر لغرفة الفندق. ويجب عليك تضمين العملة.

المثال: 159 USD

URL

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

يمثل رابط إلى صفحة غرفة الفندق.

CheckinDate

النوع: date (التاريخ)

مطلوب. يمثل تاريخ تسجيل الدخول مقابل price. وندعم ما يصل إلى 180 يومًا من تاريخ تحميل قائمة المنتجات. استخدم ISO‑8601 (YYYY‑MM‑DD).

Nights

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

مطلوب. يمثل عدد ليالي الإقامة في الفندق مقابل price. أقصى قيمة: 14

Baserate

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

مطلوب. السعر قائم على checkin_date وlength_of_stay.

المثال: 180

Tax

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

مطلوب. يمثل قيمة ضريبة الإقامة.

OtherFees

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

مطلوب. يمثل رسوم الإقامة السارية.

SalePrice

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

يمثل السعر المخفّض إن أمكن.

المثال: 159

SalePriceTax

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

يمثل قيمة الضريبة للسعر المخفّض.