Сообщение об акциях

Обзор

Сообщение «Акции» определяет правила предоставления скидок на тарифы с помощью OTA_HotelRateAmountNotifRQ . Для каждого тарифа оцениваются определенные акции, и к тарифу применяется максимально допустимая скидка. Этот тип сообщения является необязательным, и вам нужно определять акции только в том случае, если они используются в вашей системе для применения скидок на тарифы.

Вы можете комбинировать акции и применять их к различным атрибутам пользователей, таким как типы устройств (мобильный телефон, планшет, настольный компьютер) и коды стран.

Ключевой момент: если к определенному тарифу (тип номера + тарифный план + количество проживающих) применяется несколько акций, пользователь получает самую выгодную из возможных акций или комбинаций акций, и скидки применяются автоматически.

Примеры различных сценариев, связанных с продвижением, см. в разделе «Инструкции» .

В следующих разделах представлены общие рекомендации, базовый пример и пошаговые инструкции, которые помогут вам начать добавлять и обновлять рекламные акции.

Руководящие принципы

В этом разделе изложены общие правила и специальные инструкции по проведению рекламных акций.

Для проведения рекламных акций используйте следующие правила:

Действия

Удалить

Используйте действие delete в элементе <Promotion> , чтобы удалить отдельную акцию по ее ID.

Наложение

Используйте действие overlay в элементе <HotelPromotions> , чтобы заменить все рекламные акции для данного объекта размещения.

Дельта

Если действие не указано, то все акции, указанные в <HotelPromotions> , добавляются или заменяются. Если акция с таким ID никогда не добавлялась или была удалена, то она добавляется. Если акция с таким ID уже существует, она перезаписывается новым определением.

Общий

• Для каждого объекта недвижимости может быть одна акция или несколько акций, и каждая акция имеет набор условий. Акция может быть применена только при соблюдении этих условий.

• Акционные предложения распространяются на стоимость поездки. Установить максимальную скидку на одного пассажира невозможно.

• Если вы хотите, чтобы акция применялась только к определенной дате, типу номера или тарифному плану, укажите это в условиях акции. Если акция не распространяется на определенную дату, тип номера или тарифный план, то эти параметры указывать не нужно.

• Каждая акция привязана к конкретному объекту размещения. Если вы используете одну и ту же акцию для нескольких объектов, ее необходимо отправлять отдельно для каждого объекта. Чтобы указать идентификатор объекта, используйте атрибут hotel_id элемента <HotelPromotions> .

• Вы можете добавить до 99 рекламных акций. Если вам нужно добавить больше, свяжитесь со своим техническим менеджером Google.

• Используйте элемент <Stacking> , чтобы указать, как можно комбинировать рекламные акции. По умолчанию Google использует base тип комбинирования, то есть сначала выбирается и применяется наиболее подходящая базовая акция, а затем уже другие. Обратите внимание, что base может быть объединена только со second или any и не может быть объединена с другой base или none .

• Даже если существует несколько акций, которые можно применить одновременно, на самом деле может быть использована не та акция, которая предлагает большую скидку, если есть другая акция или группа акций, предлагающих более выгодную комбинацию. При наличии нескольких акций (комбинаций) к бронированию применяется акция (комбинация) с наибольшей скидкой.

• Отправляйте уведомления о новых акциях при любых изменениях, затрагивающих ваши рекламные предложения.

  Важный момент: на один объект недвижимости действует ограничение в 500 рекламных акций. Для удаления рекламных акций из списка объектов недвижимости можно использовать сообщение <Promotions> .

Налоговые вопросы

Наилучшая акция (или набор акций) применяется к сумме AmountAfterTax . Если указана только AmountBeforeTax , то акции применяются к AmountBeforeTax .

Пример

В этом разделе представлен базовый пример рекламного сообщения с использованием обязательных и необязательных элементов. После подготовки файла отправьте его в Google с помощью POST-запроса на следующий адрес:

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

Чтобы узнать больше о том, как отправить/загрузить сообщение (POST), см. раздел «Отправка сообщений» .

Ключевой момент: отправляйте Google обновленное рекламное сообщение каждый раз, когда ваши рекламные акции меняются.

Для атрибута 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 , чтобы заменить рекламные объявления.

Примечание: Для перезаписи всех рекламных акций для объекта недвижимости рекомендуется использовать overlay (а не delete отдельных элементов). Используйте действие delete если хотите удалить только определенные рекламные акции для объекта недвижимости.

Образец

В приведенном ниже примере показаны первоначальные две скидки в размере 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 (а не отдельные действия 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 типы суммирования. При суммарной скидке 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.