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

نمای کلی

پیام «تبلیغات» (Promotions) با استفاده از OTA_HotelRateAmountNotifRQ قوانینی را برای نرخ‌های تخفیف تعریف می‌کند. برای هر نرخ، تخفیف‌های تعریف‌شده ارزیابی می‌شوند و بیشترین تخفیف مجاز برای نرخ اعمال می‌شود. این نوع پیام اختیاری است و شما فقط در صورتی که از تخفیف‌ها در سیستم خود برای اعمال تخفیف‌های نرخ استفاده می‌کنید، باید آنها را تعریف کنید.

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

نکته کلیدی: وقتی چندین پیشنهاد ویژه برای نرخ‌های خاص محصول (نوع اتاق + طرح نرخ + ظرفیت) اعمال می‌شود، کاربر ارزان‌ترین پیشنهاد ویژه یا ترکیبی از پیشنهادهای ویژه مجاز را دریافت می‌کند و تخفیف‌ها به طور خودکار اعمال می‌شوند.

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

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

دستورالعمل‌ها

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

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

اقدامات

حذف

از یک عمل delete در عنصر <Promotion> برای حذف یک تبلیغ واحد بر اساس شناسه آن استفاده کنید.

روکش

از یک اکشن overlay در عنصر <HotelPromotions> برای جایگزینی تمام تبلیغات یک ملک استفاده کنید.

دلتا

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

عمومی

• برای هر ملک می‌توان یک یا چند پیشنهاد ویژه داشت و هر پیشنهاد ویژه دارای مجموعه‌ای از شرایط است. آن پیشنهاد ویژه فقط در صورت برآورده شدن شرایط قابل اعمال است.

• تخفیف‌ها برای نرخ برنامه سفر اعمال می‌شوند. تعیین حداکثر تخفیف برای هر مسافر امکان‌پذیر نیست.

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

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

• شما می‌توانید تا ۹۹ پیشنهاد ویژه را در نظر بگیرید. در صورت نیاز به اضافه کردن تعداد بیشتری، با Google TAM خود تماس بگیرید.

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

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

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

  نکته کلیدی: محدودیت ۵۰۰ تبلیغ برای هر ملک وجود دارد. می‌توانید از پیام <Promotions> برای حذف تبلیغات از یک ملک استفاده کنید.

مربوط به مالیات

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

مثال

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

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

برای کسب اطلاعات بیشتر در مورد نحوه ارسال/POST پیام، به ارسال پیام‌ها مراجعه کنید.

نکته کلیدی: هر بار که تبلیغات شما تغییر می‌کند، یک پیام تبلیغاتی به‌روز شده برای گوگل ارسال کنید.

برای ویژگی hotel_id مربوط به <HotelPromotions> ، از شناسه هتل منحصر به فردی که در سیستم خود برای شناسایی هتل استفاده کرده‌اید، استفاده کنید. این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید فهرست هتل‌ها مطابقت داشته باشد. سازگاری با سیستم شما برای اطمینان از نمایش صحیح داده‌های شما توسط گوگل بسیار مهم است.

UserCountry برای فهرست کردن مکان‌های کاربری (کشورهایی) است که واجد شرایط این پیشنهاد هستند. در صورت مشخص شدن، فقط به کاربران کشورهای فهرست‌شده نرخ تخفیف ارائه می‌شود.

توجه: تنظیم کد کشور اختیاری است و در صورت عدم مشخص کردن، به کاربران در هر کشوری نرخ تخفیف ارائه می‌شود.

این مثال نحوه‌ی اعمال تخفیف ۱۵٪ برای اقامت طولانی مدت کاربران در ایالات متحده و ایتالیا را نشان می‌دهد:

<?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>

برای مثال‌های بیشتر، به نمونه‌های تبلیغاتی مراجعه کنید.

چگونه‌ها

این بخش راه‌حل‌هایی برای سناریوهایی که ممکن است هنگام تنظیم تبلیغات با آنها مواجه شوید، ارائه می‌دهد.

سناریو ۱: نحوه اضافه کردن تخفیف برای اقامت طولانی مدت

توضیحات

شما می‌خواهید در روزهای خاصی از اقامت طولانی، شب‌های تخفیف‌دار ارائه دهید.

راه حل

از تنظیمات FreeNights برای سفارشی‌سازی نوع تخفیف اعمال شده بسته به تعداد شب‌های اقامت استفاده کنید.

نمونه

این نمونه نشان می‌دهد که چگونه می‌توان به ازای هر ۷ شب اقامت در محدوده تاریخ رزرو مشخص شده، برای دو شب، ۲۰٪ تخفیف اضافه کرد. برای یک برنامه سفر ۱۵ شبه، ۲۰٪ تخفیف برای مجموع ۴ شب اعمال می‌شود.

<?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>

سناریو ۲: نحوه تنظیم انواع دستگاه

شما devices تنظیم می‌کنید که دستگاه‌های کاربر واجد شرایط برای این پیشنهاد ویژه را مشخص کنند. در صورت مشخص شدن، فقط به کاربران دستگاه‌های ذکر شده نرخ تخفیف ارائه می‌شود.

توجه: در صورت عدم ذکر، به کاربران هر دستگاهی نرخ تخفیف ارائه می‌شود.

توضیحات

شما می‌خواهید مشخص کنید که کدام نوع دستگاه کاربر واجد شرایط دریافت این پیشنهاد ویژه است.

راه حل

نوع دستگاه را روی یک یا چند مورد از مقادیر زیر تنظیم کنید: desktop ، tablet یا mobile .

نمونه

نمونه زیر نحوه تعیین تخفیف ۲۵٪ برای کاربران موبایل و تبلت را نشان می‌دهد:

<?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>

سناریو ۳: چگونه تبلیغات قدیمی را با تبلیغات جدید جایگزین کنیم

توضیحات

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

راه حل

از اکشن overlay برای جایگزینی تبلیغات استفاده کنید.

توجه: استفاده از overlay (به جای استفاده delete تکی) روش پیشنهادی برای بازنویسی همه تبلیغات یک ملک است. اگر می‌خواهید فقط تبلیغات خاصی را برای یک ملک حذف کنید، از عمل delete استفاده کنید.

نمونه

نمونه زیر دو تخفیف اصلی ۲۰٪ و ۳۰٪ را برای ملک نشان می‌دهد.

<?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 برای جایگزینی دو پیشنهاد موجود با یک پیشنهاد تخفیف ۱۵٪ برای ملک استفاده کرد.

<?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>

سناریو ۴: نحوه حذف یک یا همه تبلیغات

توضیحات

شما می‌خواهید یک یا همه تبلیغات (بدون جایگزینی) را حذف کنید، زیرا ملک تمام تبلیغات خود را بدون تنظیم تبلیغات جدید حذف کرده است، یا شما خطایی مرتکب شده‌اید و باید آن را اصلاح کنید.

راه حل

اگر می‌خواهید فقط تبلیغات خاص یک ملک را حذف کنید، از عمل delete استفاده کنید و برای حذف همه تبلیغات موجود بدون جایگزینی، از عمل overlay (نه delete ) استفاده کنید.

توجه: استفاده از overlay (به جای اقدامات delete تکی) روش پیشنهادی برای بازنویسی همه تبلیغات یک ملک است.

برای جزئیات بیشتر در مورد نحوه جایگزینی تبلیغات با استفاده از overlay ، به سناریوی ۳ مراجعه کنید.

نمونه‌ها

نمونه زیر نحوه حذف فقط یک تبلیغ برای یک ملک را نشان می‌دهد:

<?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>

سناریوی ۵: نحوه‌ی جمع‌آوری تبلیغات

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

توجه: در صورت واجد شرایط بودن چندین ترکیب تخفیف، پیشنهاد (ترکیبی) با بیشترین تخفیف برای رزرو اعمال می‌شود.

توضیحات

شما می‌خواهید کاربر بتواند همزمان از چندین پیشنهاد ویژه برای یک ملک استفاده کند.

راه حل

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

نمونه

این نمونه نحوه‌ی روی هم چیدن base ، second و any نوع روی هم چیدن دیگری را نشان می‌دهد. برای تخفیف ترکیبی ۱۵٪، ۲۵٪، ۱۰٪، قیمت ۱۰۰ دلار در مجموع ۵۷.۳۸ دلار می‌شود (۱۰۰ × ۰.۸۵ × ۰.۷۵ × ۰.۹).

<?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>

توجه داشته باشید که تخفیف ترکیبی برای طرح‌های تشویقی ۱ تا ۳ بهتر از تخفیف طرح تشویقی ۴ است. طرح تشویقی ۴ به دلیل نوع ترکیبی‌اش ( none ) قابل ترکیب با سایر طرح‌های تشویقی نیست. اگر طرح تشویقی ۴ تخفیف ۴۳٪ یا بالاتر داشت، به جای ترکیب طرح‌های تشویقی ۱ تا ۳ از آن استفاده می‌شد.