پیام تبلیغاتی

بررسی اجمالی

پیام تبلیغاتی قوانینی را برای تخفیف نرخ ها با استفاده از OTA_HotelRateAmountNotifRQ تعریف می کند. برای هر نرخ، تبلیغات تعریف شده ارزیابی می شود و بیشترین تخفیف مجاز روی نرخ اعمال می شود. این نوع پیام اختیاری است و فقط در صورتی نیاز به تعریف تبلیغات دارید که در سیستم شما برای اعمال تخفیف در نرخ استفاده شود.

می‌توانید تبلیغات را ترکیب کنید و آنها را برای ویژگی‌های مختلف کاربر، مانند انواع دستگاه (موبایل، تبلت، دسکتاپ) و کدهای کشور اعمال کنید.

برای نمونه‌هایی از سناریوهای مختلف مرتبط با تبلیغات، به دستورالعمل‌ها مراجعه کنید.

بخش‌های زیر دستورالعمل‌های کلی، یک مثال اساسی و سناریوهای چگونگی شروع کار با افزودن و به‌روزرسانی تبلیغات را پوشش می‌دهند.

رهنمودها

این بخش دستورالعمل های رایج و دستورالعمل های ویژه برای تنظیم تبلیغات را پوشش می دهد.

از دستورالعمل های زیر برای تبلیغات استفاده کنید:

اقدامات

حذف
از یک اقدام delete در عنصر <Promotion> برای حذف یک تبلیغ با شناسه آن استفاده کنید.
پوشش
از یک عمل overlay در عنصر <HotelPromotions> برای جایگزینی همه تبلیغات یک دارایی استفاده کنید.
دلتا
اگر هیچ اقدامی مشخص نشده باشد، تمام تبلیغات مشخص شده در <HotelPromotions> اضافه یا جایگزین می شوند. اگر تبلیغی با آن شناسه هرگز اضافه نشده یا حذف شده باشد، تبلیغات اضافه می‌شود. اگر تبلیغی با آن شناسه وجود داشته باشد، با تعریف جدید بازنویسی می شود.

عمومی

  • برای هر ملک می تواند یک یا مجموعه ای از تبلیغات وجود داشته باشد و هر تبلیغ دارای یک سری شرایط است. این ترفیع فقط در صورت رعایت شرایط قابل اعمال است.

  • اگر می‌خواهید تبلیغات فقط برای یک تاریخ خاص، نوع اتاق یا طرح نرخ اعمال شود، آن را در شرایط آن تبلیغ مشخص کنید. اگر تبلیغات برای تاریخ، نوع اتاق یا طرح نرخ خاصی اعمال نمی‌شود، لازم نیست آن‌ها تنظیم شوند.

  • هر تبلیغی به یک ویژگی خاص گره خورده است. اگر از یک تبلیغ برای چندین ملک استفاده می کنید، باید آن را به طور جداگانه برای هر ملک ارسال کنید. برای تعیین شناسه دارایی خود، از ویژگی hotel_id عنصر <HotelPromotions> استفاده کنید.

  • می توانید حداکثر 99 تبلیغات را اضافه کنید. اگر نیاز به اضافه کردن بیش از این دارید، با Google TAM خود تماس بگیرید.

  • از عنصر <Stacking> برای تعیین نحوه ترکیب تبلیغات استفاده کنید. به‌طور پیش‌فرض، Google از نوع انباشته base استفاده می‌کند، به این معنی که بهترین تبلیغ پایه واجد شرایط قبل از تبلیغات دیگر، ابتدا انتخاب و اعمال می‌شود. توجه داشته باشید که base فقط می توان با second یا any ترکیب کرد و نمی توان آن را با base دیگر یا none ترکیب کرد.

  • حتی اگر پشته‌ای از چندین تبلیغ وجود داشته باشد که بتوان با هم اعمال کرد، اگر تبلیغات واحد دیگری یا دسته‌ای از تبلیغات وجود داشته باشد که تخفیف عمیق‌تری ارائه می‌دهد، ممکن است این پشته در واقع همانی نباشد که استفاده می‌شود. تبلیغات (ترکیب) با بیشترین تخفیف زمانی برای رزرو اعمال می شود که چندین (ترکیبی از) تبلیغات واجد شرایط باشند.

  • هر زمان که تغییراتی رخ می دهد که بر تبلیغات شما تأثیر می گذارد، به روز رسانی پیام تبلیغاتی ارسال کنید.

بهترین تبلیغات (یا پشته تبلیغات) به مقدار AmountAfterTax اعمال می شود. اگر فقط AmountBeforeTax مشخص شده باشد، تبلیغات برای AmountBeforeTax اعمال می شود.

مثال

این بخش یک مثال اساسی از پیام تبلیغاتی را با استفاده از عناصر ضروری و اختیاری ارائه می دهد. هنگامی که فایل خود را آماده کردید، آن را از طریق یک پیام POST به این نقطه پایانی برای Google ارسال کنید:

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 برای سفارشی کردن نوع تخفیف اعمال شده بسته به تعداد شب های اقامت استفاده کنید.

نمونه

این نمونه نشان می‌دهد که چگونه می‌توان به ازای هر ۷ شب اقامت در محدوده تاریخ رزرو، ۲۰٪ تخفیف برای دو شب اضافه کرد. برای یک برنامه سفر 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: چگونه تبلیغات را روی هم قرار دهیم

Stacking نحوه ترکیب تبلیغات را مشخص می کند. اگر مشخص نشده باشد، type base در نظر گرفته می‌شود، به این معنی که بهترین تبلیغ پایه واجد شرایط قبل از تبلیغات دیگر، ابتدا انتخاب و اعمال می‌شود. وقتی ویژگی type Stacking any باشد، می‌توان آن را با هر تبلیغ دیگری ترکیب کرد.

شرح

شما می خواهید که کاربر گزینه ای برای استفاده همزمان از چندین تبلیغات برای یک ملک داشته باشد.

راه حل

از انباشته برای تنظیم تخفیف های متعدد در هر ملک استفاده کنید. یک پشته می تواند حداکثر یک base و یک second داشته باشد، اما تعداد نامحدودی از any . و any را می توان با انواع دیگر ترکیب کرد جز none .

نمونه

این نمونه نحوه انباشتن base ، second و any نوع Stacking را نشان می دهد. برای تخفیف ترکیبی 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 استفاده می شود.