Синтаксис файла целевых страниц

Корневой элемент файла целевых страниц – <PointsOfSale>. Он содержит один дочерний элемент <PointOfSale> и не имеет атрибутов. В файле целевых страниц может быть несколько дочерних элементов <PointOfSale>.

Каждая целевая страница, которую вы определяете в файле целевых страниц, включается в элемент <PointOfSale>. Этот элемент принимает один атрибут id, который определяет уникальный идентификатор целевой страницы. Значение id можно использовать для фильтрации подходящих целевых страниц для соответствующей гостиницы. Для этого используйте элемент <AllowablePointsOfSale> в <Transaction>.

Синтаксис

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale>
  <PointOfSale id="landing_page_id">
    <DisplayNames display_text="landing_page_display_name" display_language="language_code"/>
    <Match status="[yes|never]"
      country="country_code"
      language="language_code"
      brand="booking_engine or brand"
      currency="currency_code"
      sitetype="[localuniversal|mapresults]"
      device="[desktop|mobile|tablet]"/>
    <!-- The dynamic landing page URL -->
    <URL>landing_page_url</URL>
  </PointOfSale>
</PointsOfSale>

В таблице ниже описаны дочерние элементы элемента <PointOfSale>.

Элемент Обязательно Описание
<DisplayNames> Optional

Содержит текст для показа в онлайн-турагентствах. Этот элемент принимает следующие атрибуты:

  • display_text: содержит текст, который показывается в объявлении или бесплатной ссылке для бронирования. Это должно быть название партнера.
  • display_language – двухбуквенный код языка, который определяет отображаемый язык объявления или бесплатной ссылки для бронирования. Значение этого атрибута должно соответствовать поддерживаемому языку, указанному в элементе <Match>.

Ниже приведен пример отображаемого названия для французского турагентства:

  <DisplayNames
    display_text="TravelAgency.com.fr"
    display_language="fr"
  />

Элемент <DisplayNames> не нужно добавлять в фиды поставщиков централизованных систем бронирования (партнеров по интеграции) и прямых поставщиков, например владельцев отелей или гостиничных сетей. Для таких партнеров текст объявлений и бесплатных ссылок для бронирования берется из элемента <Name> в списке гостиниц.

Примечание. Если вы настроили отображаемое название по умолчанию через службу поддержки Google, то это поле заполнять необязательно. В противном случае турагентства должны указать <DisplayNames>.
<Match> Required

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

Этот элемент принимает следующие атрибуты:

  • status – определяет, включает ли совпадение результаты по указанному критерию или исключает их. Допустимые значения: yes (должно совпадать) или never (не должно совпадать).
  • country – сопоставление по домену Google, связанному с пользователем и гостиницей. В качестве значения атрибута указывается двухбуквенный код страны. например, US и FR.
  • language – совпадение по языку пользователя и гостиницы. В качестве значения этого атрибута используется двухбуквенный код языка. Примеры: en или fr.
  • brand – сопоставление по значению атрибута hotel_brand, указанного в списке гостиниц. Этот фильтр может быть полезен, если у вас разные URL для систем бронирования или брендов.
  • currency – совпадение по валюте страны пользователя или гостиницы. Значение атрибута должно состоять из трехбуквенного кода валюты. Примеры: USD или EUR.
  • sitetype – сопоставление по сервису Google, в котором пользователь просматривал данные о ценах в вашей гостинице. Этот атрибут принимает следующие значения:
    • localuniversal – пользователь нашел объявление или бесплатную ссылку для бронирования через поиск, обычно в google.com.
    • mapresults – пользователь нашел ссылку для бронирования гостиницы через maps.google.com.

      • Примечание. Нельзя задать значение never для всех типов сайтов. В этом случае sitetype будет игнорироваться.

  • device – тип устройства, с которого пользователь выполняет поиск. Этот атрибут принимает значения mobile, desktop или tablet.

    Примечание. Вы не можете задать для status значение never, если для device задано значение tablet.

Пример:

<PointOfSale id="test1">
  <Match status="yes" country="US"/>
  <Match status="yes" currency="USD"/>
  <Match status="yes" device="mobile"/>
  <Match status="yes" language="en"/>
  <URL>www.google.com</URL>
</PointOfSale>

Вы можете комбинировать атрибуты элемента <Match>, чтобы упростить правила сопоставления, как показано в следующем примере:

<PointOfSale id="test1">
  <Match
    status="yes"
    country="US"
    language="en"
    currency="USD"
    device="mobile"/>
  <URL>www.google.com</URL>
</PointOfSale>

Подробнее о правилах сопоставления целевых страниц…
<URL> Required Ссылка на ваш сайт, где пользователь может забронировать номер. Вы можете вставить динамическую информацию о пользователе и его маршруте в качестве параметров строки запроса. Например, вы можете включить идентификатор гостиницы, используя переменную PARTNER-HOTEL-ID в URL: 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Когда ссылка создается и показывается пользователю, Google заменяет переменную PARTNER-HOTEL-ID на идентификатор гостиницы. Когда пользователь переходит на ваш сайт, система может извлечь и обработать значения всех параметров строки запроса, чтобы обеспечить удобство работы. Полный список переменных, которые можно использовать в URL целевой страницы, приведен в статье Использование переменных и условий.

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

https://example.tracker.com?campaign_id=(CAMPAIGN-ID)&amp;t_url=
http://partner.com/landing%3Fhid%3D(PARTNER-HOTEL-ID)

Параметры ValueTrack нельзя использовать в атрибуте <URL>.

Для каждой целевой страницы можно определить только один элемент <URL>.
<LPURL> Optional

Используется для поддержки динамического отслеживания в URL целевой страницы. Указывает на сегмент URL, не предназначенный для отслеживания, который задан в элементе <URL>. Сегменты отслеживания URL целевой страницы необходимо указывать с помощью шаблонов отслеживания Google Рекламы, которые доступны в вашем аккаунте Google Рекламы, и суффикса конечного URL. Если в Google Рекламе нет URL отслеживания, элемент <LPURL> игнорируется.

Значение <LPURL> не нужно экранировать. При правильной настройке ValueTrack в Google Рекламе экранирование выполняется автоматически. Пример:

http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Параметры ValueTrack нельзя использовать в атрибуте <LPURL>. Подробнее о том, как настроить динамическое отслеживание в кампании для гостиниц…

Схема файла целевых страниц определяет структуру и ограничения файла целевых страниц. Подробнее о схемах объявлений для рекламы отелей…