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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример правила IF-CLOSE-RATE-RULE-IDS

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

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

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

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

https://partner.com?hid=123

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

https://partner.com?hid=123&rate_rule=sample_qr

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

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

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

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr

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

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users

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

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

Пример 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)(IF-DEFAULT-DATE)&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&utm_campaign=87654321

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

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

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

Пустые идентификаторы кампаний с кликами 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-MODIFICATIONS-IDS

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

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

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

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

https://partner.com?hid=123

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

https://partner.com?hid=123&promo_applied=true&mod_ids=7

ПРОМОКОД ЕСЛИ

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

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

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

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

https://partner.com?hid=123

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

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

Пример рекламы в условиях IF-PROMOTED (только для рекламы отелей)

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

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

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

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

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

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

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

Пример правила IF-RATE-RULE-ID

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

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

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

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

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

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

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

Пример использования 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-адрес для тестирования или проверки, результат будет следующим:

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

Пример "Для каждого ребенка по возрасту"

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

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

<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
  

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

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