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

نظرة عامة

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

تتناول الأقسام التالية الإرشادات العامة ومثالاً أساسيًا وطريقة تنفيذ. لتبدأ في إضافة الأسعار وتحديثها وإرسال تقييم الرسالة

سلوك معدّل المطابقة

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

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

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

• وفي هذه الحالة، لا يمكن تقديم طلبات لمعدلات إشغال أعلى من تلك المحددة.

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

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

الكفاءة

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

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

التحكّم

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

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

للاطّلاع على مزيد من الأمثلة على السيناريوهات المختلفة ذات الصلة بالأسعار، راجِع المقالة: الإرشادات:

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

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

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

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

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

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

الأسعار لكل تاريخ

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

التسعير المستنِد إلى خدمة مقارنة الأسعار (LOS)

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

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

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

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

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

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

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

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

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

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

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

التسعير المستنِد إلى خدمة مقارنة الأسعار (LOS)

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

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

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

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: كيفية تغيير السعر لكل إشغال

الوصف

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

الحل

يمكنك إرسال سعر الإشغال 1 الجديد باستخدام التعديل التلقائي على مستوى Delta. لا تؤثّر هذه القيمة الجديدة في سعر الإقامة لشخصَين.

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

الوصف

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

الحل

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

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

الوصف

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

الحل

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