Переменные и условия

Реклама отелей и бесплатные ссылки для бронирования включают ссылки на целевые страницы, где пользователи могут забронировать номера. Вы можете настроить, как Google будет формировать ссылку, чтобы включить в неё всю дополнительную информацию о пользователе и его маршруте. Например, можно включить в URL такую ​​информацию, как идентификатор отеля, язык, коды валют и даты заезда.

Обзор

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

<URL>https://partner_url?param_id=(variable_name)</URL>

В следующих примерах показан URL-адрес, в котором вместо фактического идентификатора отеля и маршрута используются имена переменных Google:

Пример 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

Пример 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

При создании ссылки на целевую страницу для страницы результатов поиска Google заменяет переменные фактическими значениями, чтобы URL включал динамическую информацию. Например, если пользователь бронирует номер на 6 ночей, начиная с 23.05.2023, в отеле № 42, Google отображает предыдущую ссылку следующим образом:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

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

Например, значение переменной LENGTH присваивается элементу <Nights> из фида цен соответствующего маршрута. Аналогично, значение переменной PARTNER-HOTEL-ID определяется в элементе <id> из фида списка отелей, соответствующих критериям поиска пользователя.

Некоторые переменные являются подмножествами элементов фида цен. Например, переменные CHECKINDAY , CHECKINMONTH и CHECKINYEAR извлекаются из одного элемента <Checkin> в фиде цен. Другие переменные рассчитываются на основе региональных настроек пользователя и других настроек клиента.

Более подробную информацию об источниках переменных значений см. в разделах Обзор цен и Список отелей .

URL-переменные

В следующей таблице описаны доступные переменные, которые можно использовать для построения URL-адреса целевой страницы:

Условная логика в URL-адресах

Для условного построения конечных точек можно использовать специальные директивы в элементе <URL> файла целевых страниц.

Условная логика поддерживает следующие утверждения:

• if_statement : Если true , то значения, следующие за этим условием, вставляются в URL, в противном случае вставляются значения, следующие за директивой ELSE .

• for_statement : Создает условие цикла FOR, которое повторяется по количеству предоставленных значений.

Операторы IF и FOR включают следующее:

Пример IF-AD-CLICK

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

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

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

В этом примере, если пользователь не нажал на объявление, результатом будет следующий URL:

https://www.partner.com?hid=123&adType=0

Если пользователь нажал на объявление, результатом будет следующий URL:

https://www.partner.com?hid=123&adType=1

Пример IF-CLICK-TYPE-HOTEL

Вы можете создать условный блок, который проверяет, выбрал ли пользователь отель без явного пакета номеров. Значение элемента <RatePlanID> в блоке <Room Bundle> сообщения о транзакции будет установлено на основе неявно связанной цены пакета номеров, выбранного пользователем.

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

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

В этом примере, если пользователь выбрал Room Bundle, результатом будет следующий URL:

https://partner.com/landing_room?hid=123

Если пользователь не выбрал пакет номеров, результатом будет следующий URL-адрес:

https://partner.com/landing?hid=123

Пример IF-CLICK-TYPE-ROOM

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

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

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

В этом примере, если пользователь не выбрал Room Bundle, результатом будет следующий URL:

https://partner.com/landing?hid=123

Если пользователь выбрал Room Bundle, результатом будет следующий URL:

https://partner.com/landing_room?hid=123

Пример IF-DEFAULT-DATE

Используйте условный оператор IF-DEFAULT-DATE чтобы задать параметр, не являющийся датой, который ваш веб-сайт затем сможет использовать для запуска настраиваемого поведения, если пользователь не выбрал дату.

В следующем примере проверяется, использовалась ли дата по умолчанию:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

В этом примере, если пользователь не выбрал дату, результат может быть похож на следующий URL-адрес, показывающий выбор дат по умолчанию:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Если пользователь выбрал дату, результат может быть похож на следующий URL-адрес, в зависимости от выбранного им маршрута:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

Пример IF-HOTEL-CAMPAIGN (клики по рекламе отелей и бесплатным ссылкам бронирования)

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

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

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

В этом примере, если пользователь нажимает на URL-адрес кампании по бронированию отелей, результатом будет следующий URL-адрес:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

Если клик не относится к URL-адресу кампании по поиску отелей (например, обычной поисковой кампании), результатом будет следующий URL-адрес:

https://www.partner.com?hotelID=123&utm_campaign=87654321

Это полезно, когда вы хотите отделить трафик кликов по рекламным кампаниям отелей от любых других кликов.

Пустые идентификаторы кампаний с кликами FBL

Если клик произошел по бесплатной ссылке бронирования, то IF-HOTEL-CAMPAIGN возвращает TRUE , а значение CAMPAIGN-ID устанавливается пустым, как показано в следующем URL-адресе:

https://www.partner.com?hotelID=123&hotel_campaign=

Вы можете использовать условный оператор IF-AD-CLICK чтобы предотвратить появление пустого идентификатора кампании, как показано в следующем примере:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Пример IF-PROMOTED (только реклама отелей)

Вы можете создать условный блок, который будет проверять, нажал ли пользователь на рекламу объекта недвижимости.

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

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

В этом примере, если пользователь выбрал рекламу недвижимости, результатом будет следующий URL-адрес:

https://partner.com/1?hid=123

Если пользователь не выбрал рекламу недвижимости, результатом будет следующий URL-адрес:

https://partner.com/0?hid=123

Пример IF-RATE-RULE-ID

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

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

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

В этом примере, если пользователь не выбрал условную ставку, результатом будет следующий URL:

https://www.partner.com?hid=123

Если пользователь выбрал условную ставку, результатом будет следующий URL:

https://www.partner.com?hid=123&customerType=42

Пример IF-USER-LIST-ID (определен в Google Ads)

Если вы устанавливаете мультипликаторы ставок для списков аудитории в кампании Google Ads, посвященной отелям, вы можете использовать IF-USER-LIST-ID вместе с USER-LIST-ID чтобы задать на вашем сайте параметр для клиента, принадлежащего к определённому списку аудитории Google Ads. Это может пригодиться для отслеживания или настройки вашего сайта для пользователей списков аудитории.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

В этом примере, если пользователь не был участником списка аудитории, результатом будет следующий URL:

https://www.partner.com?hid=123

Если пользователь был членом списка аудитории 12345678 , результатом будет следующий URL:

https://www.partner.com?hid=123&audience_list=12345678

Пример IF-ПРОВЕРКИ

Если вам нужно проверить, сгенерировал ли Google URL-адрес для тестирования или автоматической проверки, вы можете использовать IF-VERIFICATION .

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

В этом примере, если Google не сгенерировал URL для тестирования или проверки, результатом будет следующий URL:

https://www.partner.com?hid=123

Если Google сгенерировал URL для тестирования или проверки, результатом будет следующий URL:

https://www.partner.com?hid=123&isgoogle=true

Пример FOR-EACH-CHILD-AGE

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

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

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

В этом примере, если маршрут включает 2 взрослых и 2 детей в возрасте 0 и 17 лет соответственно, результатом будет следующий URL:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Если в маршруте 2 взрослых и 0 детей, то результатом будет следующий URL:

https://www.partner.com?adults=2&children=0&hid=123

Общие правила построения URL-адресов

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

При определении сконструированных URL-адресов в файле целевых страниц применяются следующие общие правила:

• Все переменные заключены в открывающиеся и закрывающиеся скобки.

• Параметры строки запроса в конечном результате должны быть разделены амперсандом ("&"). Поскольку амперсанд — это специальный символ в XML, а формат файла целевых страниц — XML , вместо него необходимо использовать закодированную сущность "&". В конечном результате отображается настоящий символ "&". Например:

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

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

  • пробел (" "): замените символы пробела на "%20;" в элементе <URL>
  • Косая черта ("/"): замените косую черту на "%2F;" в элементе <URL>

  Не все небуквенные символы должны быть закодированы в URL. Например, дефисы («-») не требуют URL-кодирования. Список распространённых символов, которые должны быть закодированы в URL, см. в разделе Кодировка URL .

• Значения одного параметра могут быть сформированы из нескольких переменных. В следующем примере формируется один параметр checkinDate из переменных CHECKINDAY , CHECKINMONTH и CHECKINYEAR :

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  В этом примере URL-адрес может выглядеть следующим образом:

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

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

• В дополнение к списку доступных переменных вы можете использовать до пяти пользовательских переменных.