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

Обзор

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

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

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

Примеры различных сценариев, связанных с продвижением, см. в разделе How-tos .

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

Рекомендации

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

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

Действия

Удалить

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

Наложение

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

Дельта

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

Общий

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

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

• Каждая акция привязана к определенному объекту недвижимости. Если вы используете одну и ту же рекламную акцию для нескольких объектов, вам необходимо отправить ее отдельно для каждого объекта. Чтобы указать идентификатор вашего объекта, используйте атрибут 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: Как складывать рекламные акции

Стекинг определяет, как можно комбинировать рекламные акции. Если не указано иное, предполагается, что 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.