تقييم الرسالة

نظرة عامة

تحدِّد رسالة السعر (OTA_HotelRateAmountNotifRQ) أسعار الإشغال لكل نوع من الغرف وخطة الأسعار في نطاقات زمنية محدّدة. كجزء من رسالة "السعر"، تدعم Google الأسعار المستندة إلى الإشغال، ما يتيح تحديد أسعار مختلفة في الليلة بناءً على الحد الأقصى لعدد النزلاء المقصودين.

تتناول الأقسام التالية الإرشادات العامة، ومثالاً أساسيًا، وسيناريوهات إرشادية لمساعدتك في البدء بإضافة الأسعار وتعديلها وإرسال رسالة "السعر".

سلوك نسبة المطابقة

بناءً على طلب المستخدمين لإشغالات معيّنة، يعتمد السعر الذي يرونه على كيفية تحديد الأسعار في رسالة "السعر". يتناول هذا القسم كيفية مطابقة طلبات المستخدمين هذه مع أسعارك بناءً على إشغال طلباتهم والأسعار التي تحدّدها.

المبادئ الأساسية

  • ينطبق السعر المحدّد لإشغال معيّن على جميع النزلاء الأقل، ما لم يتم تحديد خلاف ذلك.

  • تُعتبَر طلبات الحصول على إقامة أعلى من تلك المحدّدة غير ممكنة.

  • تسري الأسعار المستندة إلى الإشغال على كلّ من الأسعار في التاريخ ونماذج التسعير المستندة إلى LOS الموضّحة أدناه. هذا يعني أنه يمكنك تحديد الأسعار لكل إشغال. إذا لم يكن سعر لإشغال معيّن موجودًا، سيتم استخدام سعر أعلى سعر لإشغال معيّن. ويمكنك أيضًا تحديد رسوم للنزلاء الإضافيين والأطفال الذين يستخدمون AdditionalGuestAmounts أو ExtraGuestCharges ويتم تطبيق هذه الرسوم على السعة المحدّدة للغرفة.

الفوائد والأمثلة

الكفاءة

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

مثال: الأسعار لنوع الغرفة وخطة الأسعار هي نفسها للإشغالات من واحد إلى أربعة. استخدِم رسالة "التقييم" لتحديد سعر واحد للإشغال كحد أقصى يبلغ 4 أفراد. وسيشاهد المستخدمون الذين يبحثون عن إقامة فردية ومزدوجة وثلاثية المعدل نفسه. ولن تظهر الأسعار للمستخدمين الذين يبحثون عن 5 أو أكثر.

التحكّم

ويمكن تقديم أسعار مختلفة للإقامة البديلة بشكل صريح. أرسِل سعرًا مختلفًا لكل قيمة إشغال إذا أردت مزيدًا من التحكم في كيفية مطابقة Google للطلبات مع معدلات الإشغال.

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

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

العناصر المطلوبة والاختيارية

يوفر مرجع XML أوصافًا للعناصر المطلوبة والاختيارية. لمعرفة التفاصيل حول السمات والعناصر الفرعية، يُرجى الاطّلاع على تقييم العناصر والسمات.

البنية والمخططات

استخدِم مثال بنية التقييم كمرجع عند إنشاء رسالة "السعر" للتأكّد من اتّباع التنسيق الصحيح.

يمكنك استخدام أداة XML تابعة لجهة خارجية، مثل xmllint، للتحقق من صحة خلاصاتك باستخدام المخططات المنشورة قبل إرسالها إلى Google. وبالنسبة إلى مخطط رسالة "السعر"، اطّلِع على مخططات إعلانات الفنادق.

نماذج الأسعار

التسعير حسب التاريخ

هذا هو نموذج الأسعار العادي المستخدَم في معظم المواقع. يستند نموذج الأسعار per-date إلى أسعار الإعداد التي يتم تلخيصها على مستوى تواريخ الإقامة للوصول إلى السعر الإجمالي. في هذا النموذج، يتم تفسير جميع الأسعار ضمن العنصر Rate على أنّها تنطبق على مجموعة من تواريخ الإقامة المحدّدة في <StatusApplicationControl>.

الأسعار المستندة إلى LOS

يستند نموذج الأسعار المستنِد إلى LOS (مدة الإقامة) إلى الأسعار المحدَّدة لتاريخ الوصول ومدة الإقامة. إنّ الأسعار المحددة بموجب نموذج الأسعار المستند إلى LOS هي لكل يوم. على سبيل المثال، إذا أرسلت سعرًا بقيمة 100 دولار أمريكي (أو ما يعادله بالعملة المحلية) لمدة إقامة قدرها 3 دقائق، سيتم احتساب السعر الإجمالي على النحو التالي: 3×100 دولار أمريكي=300 دولار أمريكي.

يمكنك الاستفادة من نموذج التسعير المستند إلى LOS من خلال تحديد RatePlanType="26" على عناصر StatusApplicationControl. ويجب أيضًا ضبط السمتَين RateTimeUnit وUnitMultiplier على عناصر Rate في XML. يؤدي ذلك إلى تطبيق جميع الأسعار ضمن عنصر Rate المحدّد على الإقامة المحددة من خلال تواريخ الوصول المحددة في <StatusApplicationControl> وقيمة LOS المحدّدة لـ UnitMultiplier.

يمكنك الاستفادة من نموذجَي الأسعار لكل تاريخ واستنادًا إلى LOS ضمن حساب واحد، ولكن يجب أن يستخدم كل موقع نموذج أسعار واحدًا فقط. يُرجى وضع النقاط التالية في الاعتبار عند تطبيق الأسعار المستندة إلى LOS:

  • لا يتم الجمع بين أسعار مدد الإقامة المختلفة عند استخدام الأسعار المستندة إلى LOS. على سبيل المثال، لا يتم دمج معدّل LOS الذي يبلغ 3 مع معدّل LOS بقيمة 1 من أجل تحديد معدّل LOS الذي يبلغ 4. يجب تحديد معدل LOS البالغ 4 بشكل صريح.
  • إنّ سعر الإقامة لليلة واحدة وفقًا لسعر الإقامة في LOS لا يُستخدم كسعر ليلة فردية وفقًا للسعر المحدّد في التاريخ.
  • يجب أن يستخدم كل موقع الأسعار المستندة إلى LOS أو الأسعار لكل تاريخ فقط، بناءً على كيفية تمثيل الأسعار في نظامك.

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

الإرشادات أو الإجراءات

التسعير حسب التاريخ

Delta: يمكنك إضافة أو تعديل الأسعار لكلّ إقامة على مستوى المجموعات المحدّدة فقط من نوع الغرفة وخطة السعر وتواريخ الإقامة المحدَّدة في <StatusApplicationControl>.

  • تستخدِم تعديلات الأسعار إجراء Delta تلقائيًا.
  • لا يغيّر تعديل "Delta" أي أسعار سبق الاحتفاظ بها في الغرف الأخرى. على سبيل المثال، إذا حددت أسعارًا للغرف الفردية والغرف المزدوجة، وأرسلت تعديل Delta للغرفة للإقامة الفردية، لن يتغيّر معدّل الإشغال المزدوج.

Overlay: حذف جميع أسعار الإشغال الحالية لنوع الغرفة وخطة الأسعار والتواريخ المحددة في <StatusApplicationControl> واستبدالها بالأسعار الجديدة. على سبيل المثال، إذا حددت أسعارًا للغرف الفردية والغرف المزدوجة، وأرسلت تعديل Overlay لغرفة الإقامة الفردية، ستزيل Google جميع الأسعار السابقة (الإقامة الفردية والمزدوجة) وسيظل سعر الإقامة الفردي فقط بعد التحديث.

Remove: حذف كل أسعار الإشغال الحالية لنوع الغرفة وخطة السعر والتواريخ المحددة في <StatusApplicationControl>.

الأسعار المستندة إلى LOS

Delta: يمكنك إضافة الأسعار لكل قيمة LOS أو تعديلها للمجموعات المحدّدة فقط من نوع الغرفة وخطة السعر وتواريخ تسجيل الوصول المحدّدة في <StatusApplicationControl>. لاستبدال جميع معدلات الإشغال المرتبطة بقيم LOS المحدثة.

  • تستخدِم تعديلات الأسعار إجراء Delta تلقائيًا.
  • ولا يغيّر تعديل "Delta" أي أسعار سبق أن تم تخزينها لمدد الإقامة الأخرى. على سبيل المثال، إذا حدّدت أسعارًا لل"، LOS 1 و 2، وأرسلت تعديلاً لسعر Delta لـ LOS 1، ستبقى أسعار الإشغال لكل إقامة في LOS 2 بدون تغيير.
  • وسيحلّ تعديل "Delta" محلّ جميع أسعار الإشغال المخزَّنة سابقًا لفترة الإقامة المحدّدة. على سبيل المثال، إذا حددت أسعار الإقامة الفردية والمزدوجة لـ LOS 1، وأرسلت Delta تحديثًا لأسعار LOS 1 مع تحديد سعر إشغال واحد فقط، ستتم إزالة نسبة الإشغال المزدوج.

Overlay: احذف جميع الأسعار الحالية لكل إقامة في فندق LOS ونوع الغرفة وخطة السعر وتواريخ تسجيل الوصول المحدّدة في <StatusApplicationControl> واستبدلها بأسعار جديدة. على سبيل المثال، إذا حدّدت أسعارًا للخسارة 1 و2، وأرسلت تعديلاً لـ "Overlay" لـ LOS 1، ستزيل Google جميع الأسعار السابقة (كلاهما 1 و2) ولن يبقى سوى نسبة خسارة الأرباح كلّها بعد التعديل.

Remove: حذف كل أسعار الإشغال الحالية لجميع LOS من نوع الغرفة وخطة السعر وتواريخ تسجيل الوصول المحدّدة في <StatusApplicationControl>.

مرتبط بالضرائب

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

بشكل عام، تنصح Google باستخدام TaxFeeInfo بدلاً من AmountAfterTax.

إن أمكن، عليك تضمين AmountBeforeTax (حتى في حال تحديد AmountAfterTax) لأنّ بعض اللغات (مثل الولايات المتحدة) تعرض السعر قبل احتساب الضريبة تلقائيًا.

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

مثال

يقدم هذا القسم مثالاً أساسيًا لرسالة "تقييم" باستخدام العناصر المطلوبة والاختيارية. بعد تحضير ملفك، عليك إرساله إلى Google باستخدام رسالة POST إلى نقطة النهاية التالية: https://www.google.com/travel/hotels/uploads/property_data

لمعرفة المزيد من المعلومات عن كيفية إرسال/مشاركة الرسالة، يُرجى الاطّلاع على الرسائل الفورية.

بالنسبة إلى HotelCode، استخدِم رقم تعريف الفندق الفريد الذي استخدمته داخل نظامك لتحديد الفندق. يجب أن تتطابق هذه القيمة مع رقم تعريف الفندق المحدّد باستخدام <id> في العنصر <listing> في خلاصة قائمة الفنادق. بالنسبة إلى <PackageID> و<RoomID>، استخدِم أرقام التعريف نفسها التي تستخدمها داخل نظامك لخطط الأسعار وأنواع الغرف (على التوالي). يُعدّ الاتساق مع نظامك أمرًا مهمًا لضمان عرض Google لأسعارك وبياناتك بشكل صحيح.

يوضّح هذا المثال كيفية ضبط الأسعار باستخدام إجراء Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

فيديوهات إرشادية

يقدم هذا القسم حلولاً للسيناريوهات التي قد تواجهها أثناء إرسال رسائل "السعر".

للحصول على أمثلة حول كيفية إضافة الأسعار وإزالتها وتعديلها، يُرجى الاطّلاع على أمثلة على التقييم.

السيناريو 1: كيفية تغيير السعر لكل إقامة

الوصف

كان يتم تحديد أسعار الإقامة في الليلة للإقامة المزدوجة فقط (وينطبق ذلك أيضًا على الإقامة الفردية)، ولكن يتوفّر الآن سعر أرخص للإقامة الفردية.

الحلّ

أرسِل سعر الإشغال الجديد واحدًا باستخدام التعديل التلقائي للنطاق الخاص بميزة "Delta". لا تؤثر هذه القيمة الجديدة على معدل الإشغال 2.

السيناريو 2: كيفية استبدال أسعار الإشغال لأحد المواقع

الوصف

لقد حددت سابقًا أسعار الإقامة من 1 إلى 4، ولكن الآن الإشغالات 1 و2 فقط صالحتان.

الحلّ

استخدِم السمة NotifType="Overlay" لاستبدال جميع أسعار الإشغال في فندق معيّن ونوع غرفة وخطة أسعار وتواريخ معيّنة. في هذا السيناريو، سيسرد الإجراء Overlay أسعار الإشغالَين 1 و2.

السيناريو 3: كيفية ضبط السعر نفسه لإشغالات متعدّدة

الوصف

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

الحلّ

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