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

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

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

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

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

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

Пустые идентификаторы CAMPAIGN-ID с кликами 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-PAYMENT-ID (только для рекламы отелей)

Используйте условный оператор IF-PAYMENT-ID чтобы изменить URL-адрес в зависимости от того, является ли клик результатом программы комиссий PPS или нет. В приведенном ниже примере проверяется, пришел ли клик из программы комиссий PPS, и присваивается значение параметру booking_source на основе результата:

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

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

• Если Google не присвоен номер IATA:

  https://partner.com?hid=123&booking_source=commissions

• Если номер IATA был присвоен Google:

  https://partner.com?hid=123&booking_source=01234567

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

https://partner.com?hid=123&booking_source=cpc

Пример 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 Рекламе)

Если вы устанавливаете мультипликаторы ставок для списков аудитории в гостиничной кампании в Google Рекламе, вы можете использовать IF-USER-LIST-ID в сочетании с USER-LIST-ID , чтобы установить на своем веб-сайте параметр для клиента, принадлежащего определенному Google. Список аудитории рекламы. Возможно, вы захотите сделать это в целях отслеживания или настроить свой веб-сайт для членов списков аудитории.

<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

Пример ЕСЛИ-ВЕРИФИКАЦИИ

Если вам нужно проверить, сгенерировал ли 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

Пример ДЛЯ КАЖДОГО-РЕБЕНКА-ВОЗРАСТА

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

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

<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>

В этом примере, если в маршруте указано двое взрослых и двое детей в возрасте 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-адресе, которые вы можете включить в 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
  

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

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