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

نظرة عامة

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

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

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

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

الإرشادات

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

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

المهام

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

بنود عامة

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

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

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

  • يمكنك تضمين ما يصل إلى 99 عرضًا ترويجيًا. يمكنك التواصل مع مدير الحسابات التقنية في 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 × 0 .85 × 0 .75 × .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.