رسالة العروض الترويجية

نظرة عامة

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

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

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

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

الإرشادات

يتناول هذا القسم الإرشادات الشائعة والتعليمات الخاصة المتعلقة بإعداد العروض الترويجية.

اتّبِع الإرشادات التالية بشأن العروض الترويجية:

الإجراءات

حذف: استخدِم الإجراء delete في العنصر <Promotion> لحذف عرض ترويجي واحد حسب رقم تعريفه.
النافذة المرافِقة: استخدِم إجراء overlay في العنصر <HotelPromotions> لاستبدال جميع العروض الترويجية الخاصة بمكان إقامة.
دلتا: في حال عدم تحديد أي إجراء، تتم إضافة جميع العروض الترويجية المحدّدة ضمن <HotelPromotions> أو استبدالها. إذا لم تتم إضافة عرض ترويجي بهذا المعرّف من قبل أو تم حذفه، تتم إضافة العرض الترويجي. إذا كان هناك عرض ترويجي يحمل هذا المعرّف، سيتم استبداله بالتعريف الجديد.

للجمهور العام

يمكن أن يتوفّر عرض ترويجي واحد أو مجموعة من العروض الترويجية لكل موقع، ولكل عرض ترويجي مجموعة من الشروط. ولا يمكن تطبيق هذا العرض الترويجي إلا في حال استيفاء الشروط.
تنطبق العروض الترويجية على سعر خط سير الرحلة. لا يمكن تحديد حد أقصى للخصم لكل شخص يشغل الغرفة.
إذا أردت أن يسري عرض ترويجي على تاريخ أو نوع غرفة أو خطة أسعار محدّدة فقط، حدِّد ذلك في شروط العرض الترويجي. إذا لم يكن العرض الترويجي ساريًا في تاريخ معيّن أو لنوع غرفة أو لخطة أسعار معيّنة، ليس عليك ضبط أيّ من هذه الخيارات.
يرتبط كل عرض ترويجي بموقع معيّن. إذا كنت تستخدم العرض الترويجي نفسه لمواقع متعدّدة، عليك إرساله بشكل منفصل لكل موقع. لتحديد معرّف العقار، استخدِم السمة hotel_id الخاصة بالعنصر <HotelPromotions>.
يمكنك تضمين ما يصل إلى 99 عرضًا ترويجيًا. يُرجى التواصل مع مدير الحسابات التقنية في Google إذا كنت بحاجة إلى تضمين أكثر من ذلك.
استخدِم العنصر <Stacking> لتحديد كيفية دمج العروض الترويجية. تستخدم Google تلقائيًا base نوع التجميع، ما يعني أنّه يتم اختيار أفضل عرض ترويجي أساسي مؤهّل وتطبيقه أولاً، قبل العروض الترويجية الأخرى. يُرجى العِلم أنّه لا يمكن الجمع بين base وbase أو none، بل يمكن الجمع بين base وsecond أو any فقط.
حتى إذا كان هناك مجموعة من العروض الترويجية التي يمكن تطبيقها معًا، قد لا يتم استخدام هذه المجموعة إذا كان هناك عرض ترويجي واحد أو مجموعة من العروض الترويجية الأخرى التي تقدّم خصمًا أكبر. يتم تطبيق العرض الترويجي (المجموعة) الذي يقدّم أكبر خصم على الحجز عندما تكون عروض ترويجية متعددة (مجموعات من العروض) مؤهَّلة.
إرسال إشعار بتعديل رسالة العروض الترويجية عند حدوث أي تغييرات تؤثّر في عروضك الترويجية

نقطة أساسية: هناك حدّ أقصى يبلغ 500 عرض ترويجي لكلّ فندق. يمكنك استخدام الرسالة <Promotions> لإزالة العروض الترويجية من موقع.

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

مثال

يقدّم هذا القسم مثالاً أساسيًا على رسالة "عروض ترويجية" تستخدم عناصر إلزامية واختيارية. بعد إعداد ملفك، أرسِله إلى Google من خلال رسالة POST إلى نقطة النهاية التالية:

https://www.google.com/travel/hotels/uploads/promotions

لمزيد من المعلومات حول كيفية إرسال الرسالة باستخدام طريقة POST، يُرجى الاطّلاع على إرسال الرسائل.

بالنسبة إلى السمة hotel_id الخاصة بالعنصر <HotelPromotions>، استخدِم معرّف الفندق الفريد الذي استخدمته في نظامك لتحديد المكان المخصّص للاستئجار. يجب أن تتطابق هذه القيمة مع معرّف الفندق المحدّد باستخدام <id> في العنصر <listing> في خلاصة بيانات الفنادق. من الضروري أن تكون البيانات متسقة مع نظامك لضمان عرض Google لها بشكل صحيح.

يُستخدَم UserCountry لإدراج المواقع الجغرافية (البلدان) للمستخدمين المؤهّلين للعرض الترويجي. في حال تحديدها، لن يتم عرض السعر المخفَّض إلا للمستخدمين في البلدان المدرَجة.

يوضّح المثال التالي كيفية تحديد خصم بنسبة% 15 على الإقامة الممتدة للمستخدمين في الولايات المتحدة وإيطاليا:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

للاطّلاع على المزيد من الأمثلة، راجِع أمثلة على العروض الترويجية.

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

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

السيناريو 1: كيفية إضافة عرض ترويجي بخصم على الإقامة لفترة أطول

الوصف

إذا كنت تريد تقديم ليالٍ مخفّضة السعر في أيام معيّنة من الإقامة الممتدة

الحل

استخدِم الإعداد FreeNights لتخصيص نوع الخصم المطبَّق حسب عدد ليالي الإقامة.

عيّنة

يوضّح هذا المثال كيفية إضافة خصم بنسبة% 20 على ليلتين مقابل كل 7 ليالٍ يتم حجزها في النطاق الزمني المحدّد لتواريخ الحجز. في برنامج رحلة لمدة 15 ليلة، ينطبق خصم بنسبة% 20 على إجمالي 4 ليالٍ.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

السيناريو 2: كيفية ضبط أنواع الأجهزة

عليك ضبط devices لتحديد أجهزة المستخدمين المؤهَّلة للاستفادة من العرض الترويجي. في حال تحديدها، لن يتم تقديم السعر المخفَّض إلا للمستخدمين على الأجهزة المدرَجة.

الوصف

عليك تحديد نوع جهاز المستخدِم المؤهَّل للاستفادة من العرض الترويجي.

الحل

اضبط نوع الجهاز على إحدى القيم التالية أو أكثر: desktop أو tablet أو mobile.

عيّنة

يوضّح المثال التالي كيفية تحديد خصم بنسبة% 25 لمستخدمي الأجهزة الجوّالة والأجهزة اللوحية:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

السيناريو 3: كيفية استبدال العروض الترويجية القديمة بالعروض الترويجية الجديدة

الوصف

مجموعة العروض الترويجية الحالية الخاصة بمكان الإقامة قديمة أو غير صحيحة ويجب استبدالها بمجموعة جديدة تمامًا.

الحل

استخدِم الإجراء overlay لاستبدال العروض الترويجية.

عيّنة

يعرض المثال التالي الخصمين الأصليين بنسبة% 20 و% 30 للسمة.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

يوضّح هذا المثال كيفية استخدام overlay لاستبدال العرضَين الترويجيَين الحاليَين بعرض ترويجي واحد يقدّم خصمًا بنسبة% 15 على الموقع.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

السيناريو 4: كيفية إزالة عرض ترويجي واحد أو كل العروض الترويجية

الوصف

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

الحل

استخدِم الإجراء delete إذا أردت حذف عروض ترويجية فردية معيّنة فقط لموقع ما، واستخدِم الإجراء overlay (وليس delete) لإزالة جميع العروض الترويجية الحالية بدون استبدالها.

للاطّلاع على تفاصيل حول كيفية استبدال العروض الترويجية باستخدام overlay، راجِع السيناريو 3.

نماذج

يوضّح المثال التالي كيفية حذف عرض ترويجي واحد فقط لموقع:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

يوضّح هذا النموذج كيفية إزالة جميع العروض الترويجية بدون استبدالها لموقع معيّن:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

السيناريو 5: كيفية الجمع بين العروض الترويجية

تحدّد هذه السمة كيفية دمج العروض الترويجية. في حال عدم تحديد ذلك، يُفترض أنّ type هي base، ما يعني أنّه يتم اختيار أفضل عرض ترويجي أساسي مؤهّل وتطبيقه أولاً، قبل العروض الترويجية الأخرى. عندما تكون قيمة السمة type الخاصة بـ Stacking هي any، يمكن دمجها مع أي عرض ترويجي آخر.

الوصف

تريد أن يتوفّر للمستخدم خيار استخدام عروض ترويجية متعددة في الوقت نفسه للعقار نفسه.

الحل

استخدِم ميزة "الخصومات المتعدّدة" لضبط خصومات متعدّدة لكل مكان للإقامة. يمكن أن يحتوي الحزمة على base واحدة وsecond واحدة على الأكثر، ولكن يمكن أن يحتوي على عدد غير محدود من any، ويمكن الجمع بين any والأنواع الأخرى باستثناء none.

عيّنة

يوضّح هذا المثال كيفية تكديس أنواع التكديس base وsecond وany. للحصول على خصم مجمّع بنسبة %15 و%25 و%10، يبلغ إجمالي سعر 100 دولار أمريكي 57.38 دولار أمريكي (100 × 0 .85 × 0 .75 × 0 .9).

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

يُرجى العِلم أنّ الخصم المجمّع للعروض الترويجية من 1 إلى 3 أفضل من الخصم المقدَّم في العرض الترويجي 4. لا يمكن دمج العرض الترويجي 4 مع عروض ترويجية أخرى بسبب نوع التجميع (none). إذا كان العرض الترويجي 4 يتضمّن خصمًا بنسبة% 43 أو أكثر، سيتم استخدامه بدلاً من دمج العروض الترويجية من 1 إلى 3.

رسالة العروض الترويجية تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

نظرة عامة

الإرشادات

الإجراءات

للجمهور العام

أسباب تتعلّق بالضرائب

مثال

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

السيناريو 1: كيفية إضافة عرض ترويجي بخصم على الإقامة لفترة أطول

الوصف

الحل

عيّنة

السيناريو 2: كيفية ضبط أنواع الأجهزة

الوصف

الحل

عيّنة

السيناريو 3: كيفية استبدال العروض الترويجية القديمة بالعروض الترويجية الجديدة

الوصف

الحل

عيّنة

السيناريو 4: كيفية إزالة عرض ترويجي واحد أو كل العروض الترويجية

الوصف

الحل

نماذج

السيناريو 5: كيفية الجمع بين العروض الترويجية

الوصف

الحل

عيّنة

رسالة العروض الترويجية