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

نظرة عامة

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

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

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

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

الإرشادات

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

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

المهام

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

أسئلة عامة

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

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

  • يرتبط كل عرض ترويجي بموقع معيّن. وفي حال استخدام العرض الترويجي نفسه لمواقع متعدّدة، يجب إرساله بشكل منفصل لكل موقع. لتحديد معرّف موقعك، استخدِم السمة hotel_id للعنصر <HotelPromotions>.

  • يمكنك تضمين ما يصل إلى 99 عرضًا ترويجيًا. يمكنك التواصل مع مدير الحسابات التقنية (TAM) في Google إذا كنت بحاجة إلى تضمين أكثر من ذلك.

  • يمكنك استخدام العنصر <Stacking> لتحديد كيفية دمج العروض الترويجية. تستخدم Google تلقائيًا نوع التجميع base، ما يعني أنّه يتم اختيار أفضل عرض ترويجي أساسي مؤهل وتطبيقه أولاً، قبل العروض الترويجية الأخرى. تجدر الإشارة إلى أنّه لا يمكن دمج base إلا مع second أو any، ولا يمكن دمجها مع base أو none آخرَين.

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

  • أرسل رسالة ترويجية كلما طرأت أي تغييرات تؤثر في عروضك الترويجية.

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

مثال

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

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

لمعرفة المزيد من المعلومات حول طريقة إرسال الرسالة أو نشرها، يمكنك الاطّلاع على الرسائل الفورية.

بالنسبة إلى السمة 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 × .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.