في قائمة الفنادق الثابتة، يمكنك توفير سعر واحد لكل فندق. ولا يمكنك توفير تسعير مختلف قائم على تاريخ الدخول إلى المكان أو مدة الإقامة أو نوع الغرفة. لعرض أسعار أكثر دقة في إعلاناتك القائمة على هذه المتغيرات، يمكنك استخدام تسعير ديناميكي (خاص بالتاريخ) لتوفير أسعار لتواريخ مختلفة وأنواع مختلفة للغرف ومدد مختلفة للإقامة. وبمجرد توفير الأسعار، يمكنك استخدام إشارات قالب الفندق لاستخدام هذه الأسعار في إعلاناتك.
استخدم التحميل المُجمع لأنوع الغرف وبيانات التسعير لمشاركة تفاصيل التسعير مع Facebook.
اطّلع على معلمات الغرفة والتسعير للحصول على شرح لكل المعلمات.
يتكوّن التحميل على دُفعات من جزأين:
إذا كنت تستخدم التحميل على دُفعات، فعليك تقييد عمليات التحميل إلى 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 | تأكد من أن أنواع الغرف التي تريد توفير أسعار لها موجودة بالفعل. يمكنك تحديد التسعير ( يجب أن يبدأ الملف بإشارة التعريف |
XML بدون أنواع الغرف | عينة من XML | يمكنك تحديد التسعير ( يجب أن يبدأ الملف بإشارة التعريف |
لمزيد من التفاصيل حول كيفية تحديث متغيرات التسعير وحذفها بشكل مُجمّع، اطّلع على مرجع التجميع الخاص بمتغير التسعير.
اسم الحقل والنوع | الوصف |
---|---|
النوع: string (سلسلة) | مطلوب. يمثل معرف فريد للفندق يتم توفيره بواسطة المعلن كـ |
النوع: string (سلسلة) | مطلوب. يمثل معرف فريد لنوع الغرفة يتم توفيره بواسطة المعلن. |
النوع: string (سلسلة) | مطلوب. يمثل اسم نوع غرفة الفندق. |
النوع: string (سلسلة) | مطلوب. يمثل وصف نوع غرفة الفندق. |
النوع: float (رقم عشري) | مطلوب. يمثل أقل سعر لغرفة الفندق. ويجب عليك تضمين العملة. المثال: |
النوع: string (سلسلة) | يمثل رابط إلى صفحة غرفة الفندق. |
النوع: date (التاريخ) | مطلوب. يمثل تاريخ تسجيل الدخول مقابل |
النوع: int (عدد صحيح) | مطلوب. يمثل عدد ليالي الإقامة في الفندق مقابل |
النوع: float (رقم عشري) | مطلوب. السعر قائم على المثال: |
النوع: float (رقم عشري) | مطلوب. يمثل قيمة ضريبة الإقامة. |
النوع: float (رقم عشري) | مطلوب. يمثل رسوم الإقامة السارية. |
النوع: float (رقم عشري) | يمثل السعر المخفّض إن أمكن. المثال: |
النوع: float (رقم عشري) | يمثل قيمة الضريبة للسعر المخفّض. |