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

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

Обзор

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

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

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

<URL>https://www.partnerdomain.com?hotelID=(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-адреса целевой страницы:

Переменная Рекомендуется/необязательно Описание
ADVANCE-BOOKING-WINDOW Optional Количество дней предварительного бронирования до даты заезда в часовом поясе отеля на момент бронирования. Например, 36 .
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) Альтернативный идентификатор вашего объекта. Имя этого атрибута указано в фиде списка отелей. Наличие отдельных идентификаторов полезно, если вам нужен один идентификатор объекта для информации вашего фида и другой идентификатор объекта для вашей системы бронирования.
CAMPAIGN-ID Recommended Идентификатор кампании Google Рекламы, которую вы хотите связать с URL-адресом. Это поле пустое, если клик не связан с кампанией Google Рекламы.
CHECKINDAY Recommended Двузначный день, определенный в элементе <Checkin> фида цен на отели. Например, 20 .
CHECKINDAY-OF-WEEK Optional День недели — Monday по Sunday , в который происходит заселение, в часовом поясе отеля. Например, Tuesday .
CHECKINMONTH Recommended Двузначный месяц, определенный в элементе <Checkin> фида цен на отели. Например, 05 .
CHECKINYEAR Recommended Четырехзначный год, определенный в элементе <Checkin> фида цен на отели. Например, 2023 .
CHECKOUTDAY Recommended Двузначный день, рассчитанный на основе элементов <Nights> и <Checkin> фида цен на отели. Например, 26 .
CHECKOUTMONTH Recommended Двузначный месяц, рассчитанный на основе элементов <Nights> и <Checkin> фида цен на отели. Например, 05 .
CHECKOUTYEAR Recommended Четырехзначный год, рассчитанный на основе элементов <Nights> и <Checkin> фида цен на отели. Например, 2023 .
CHILD-AGE Recommended (must be provided for child occupancy pricing) Максимальный возраст каждого дочернего элемента, указанный в элементах <Child "age"> фида цен. Эту переменную необходимо использовать вместе с условным блоком FOR-EACH-CHILD-AGE .
CHILD-INDEX Optional Переменная цикла с индексом 0, представляющая счетчик для каждого ребенка-жильца и возраста ребенка, указанного в маршруте. Хотя это не является обязательным, эту переменную можно использовать только в сочетании с условным блоком FOR-EACH-CHILD-AGE .
CLICK-TYPE Optional Указывает, нажал ли пользователь на объявление, выбрав стандартный тариф отеля или пакет номеров. Возможные значения:
  • hotel : пользователь нажал на объявление, чтобы узнать стандартную стоимость номера.
  • room : пользователь нажал на объявление о пакете номеров.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) Разделенный запятыми список идентификаторов правил тарифов для тарифов, которые были недоступны, но могли бы быть доступны, если бы пользователь предпринял незначительное действие. Обратите внимание, что идентификаторы правил тарифов для частных тарифов всегда заполняются здесь, когда пользователю отображается соответствующая обработка пользовательского интерфейса.
CUSTOM[1-5] Optional Значения для настраиваемых полей, определенных в элементе <Result> , с ограничением в 200 символов на настраиваемое поле. Для получения дополнительной информации см. Обзор сообщений о транзакциях . Пользовательские поля недоступны при использовании ARI .
DATE-TYPE Optional Указывает, выбрал ли пользователь дату по умолчанию или конкретную дату, указанную при поиске. Возможные значения:
  • default : пользователь нажал на рекламу отеля или ссылку на бесплатное бронирование, где использовались даты по умолчанию.
  • selected : пользователь нажал на объявление отеля или ссылку на бесплатное бронирование с установленными датами.
GOOGLE-SITE Optional Ресурс Google, на котором пользователь просматривал данные о ценах на ваши отели. Возможные значения:
  • localuniversal : пользователь нашел ссылку для бронирования отеля с помощью поиска google.com .
  • mapresults : пользователь нашел ссылку для бронирования гостиницы на сайте maps.google.com .
  • verification : Google использует это значение при выполнении автоматических тестов качества данных на вашем сайте. Плата за эти запросы не взимается. Google Analytics может использовать этот параметр и его значение для идентификации трафика автоматической проверки Hotel Ads.
  • unknown : пользователь нашел объявление или ссылку на бесплатное бронирование из неопределенного источника.
LENGTH Recommended Продолжительность пребывания в виде количества ночей, определяемая элементом <Nights> в фиде цен на отели. Например, 3 .
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Количество взрослых пассажиров, указанное пользователем для маршрута. Эту переменную необходимо использовать вместе с NUM-CHILDREN , FOR-EACH-CHILD-AGE или с ними обоими.
NUM-CHILDREN Recommended Количество детей (0–17 лет), указанное пользователем в маршруте. NUM-CHILDREN , FOR-EACH-CHILD-AGE или оба необходимы для успешного участия в маршрутах с детьми в пассажирах.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) Общее количество пассажиров, как взрослых, так и детей, указанное пользователем для маршрута. Это значение представляет собой сумму значений NUM-ADULTS и NUM-CHILDREN . Чтобы максимизировать участие, настоятельно рекомендуется использовать вместо этого значения NUM-ADULTS и NUM-CHILDREN .
PACKAGE-ID Recommended (applies if you use Room Bundles) Уникальный идентификатор пакета в фиде цен на отели. Для стандартного пакета идентификатор пакета — это значение элемента <PackageID> в блоке <Result> . Для пакета Room Bundle идентификатор пакета — это значение элемента <PackageID> в блоках <RoomBundle> или <PackageData> сообщения транзакции.
PARTNER-CURRENCY Optional Трехбуквенный код валюты , определенный атрибутом currency элемента <Baserate> в фиде цен отелей. Например, USD или CAD .
PARTNER-HOTEL-ID Recommended Уникальный идентификатор отеля, определенный элементом <id> в фиде списка отелей.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) Уникальный идентификатор номера в фиде цен на отели. Для стандартной комнаты идентификатор комнаты — это значение элемента <RoomID> в блоке <Result> . Для пакета комнаты идентификатор комнаты — это значение, присвоенное элементу <RoomID> в блоках <RoomBundle> или <RoomData> в сообщении транзакции.
PAYMENT-ID Optional (only applies to Ads) Соответствует предопределенной строке commission или присвоенному Google номеру IATA (например, «01234567»), если вы пользуетесь услугами агентства по сбору комиссий. Чтобы изменить формат вашего номера IATA или предопределенной строки, обратитесь к своему техническому менеджеру по работе с клиентами (TAM).
PRICE-DISPLAYED-TAX (Optional) Сумма налога, отображаемая пользователю в местной валюте пользователя. Значение PRICE-DISPLAYED-TAX — это значение элемента <Tax> в фиде цен отеля. Например, «3,14».
PRICE-DISPLAYED-TOTAL (Optional) Общая стоимость комнаты, которая отображается пользователю в местной валюте пользователя. Значение PRICE-DISPLAYED-TOTAL — это сумма элементов <Baserate> , <Tax> и <OtherFees> из фида цен отеля. Например, «152,13».
PROMO-CODE (Optional)

Если вы используете рекламные акции ARI , значение этой переменной присваивается атрибуту id примененного <Promotion> . Если применяется несколько рекламных акций, это список идентификаторов рекламных акций, разделенных запятыми, в произвольном порядке.

Если вы используете правила тарифов , значение этой переменной присваивается элементу PromoCode , если применяется соответствующее правило тарифов.

RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Идентификатор, определенный элементом <RatePlanID> в блоке <RoomBundle> канала цен. <RatePlanID> представляет собой уникальный идентификатор для комбинации данных о номере и пакете. Дополнительную информацию см. в разделе Пакеты номеров .
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Идентификатор, определенный rate_rule_id в блоке <Rate> канала цен. Дополнительную информацию см. в разделе «Условные ставки» .
USER-COUNTRY Recommended Двухбуквенный код страны , указывающий местоположение пользователя. Эта информация извлекается из настроек клиента пользователя. Например, US или FR .
USER-CURRENCY Recommended Трехбуквенный код валюты , обозначающий местную валюту пользователя. Значение переменной USER-CURRENCY выводится из настроек клиента пользователя. Например, USD или CAD .
USER-DEVICE Recommended Тип устройства пользователя. Значение USER-DEVICE может быть одним из следующих:
  • mobile
  • tablet
  • desktop
  • unknown

Значение переменной USER-DEVICE выводится из настроек клиента пользователя.

USER-LANGUAGE Recommended Двухбуквенный код языка по стандарту ISO 639-1 , определяющий язык отображения объявления или ссылки на бесплатное бронирование. Значение переменной USER-LANGUAGE выводится из настроек клиента пользователя. Например, en или fr .
USER-LIST-ID (определено в Google Рекламе) Optional (only applies if you use Audience Lists in Google Ads) Идентификатор списка пользователей Google Рекламы, который содержит список аудитории или информацию о пользователе. Списки аудиторий используются в качестве основы для настройки корректировок ставок . Если пользователь входит в несколько списков аудитории, выбирается список аудитории с наибольшей корректировкой ставок. Связи между аудиториями с наибольшей корректировкой ставок определяются случайным образом.
VERIFICATION Optional Логическое значение, проверяющее, была ли ссылка создана Google для тестирования или автоматической проверки. Это true , если ссылка была создана Google для тестирования или автоматической проверки, в противном случае это false .

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

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

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

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

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

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

Состояние Рекомендуется/необязательно Описание
IF-AD-CLICK (только реклама отелей) Optional Возвращает значение true , если клик пользователя был вызван рекламой. Возвращает значение false , если клик пользователя произошел по ссылке бесплатного бронирования.
IF-CLICK-TYPE-HOTEL Optional Возвращает значение true , если пользователь нажал на объявление об отеле, в противном случае принимает значение false .
IF-CLICK-TYPE-ROOM Optional Возвращает значение true , если пользователь щелкнул объявление о пакете номеров , в противном случае принимает значение false .
IF-CLOSE-RATE-RULE-IDS Optional Возвращает значение true , если одна или несколько условных ставок были недоступны из-за того, что пользователь не имел права на участие, в противном случае принимает значение false . По умолчанию это true , если пользователю была показана обработка пользовательского интерфейса с частной ставкой .
IF-DEFAULT-RATE Optional Возвращает значение true , если пользователь щелкнул список отелей, в котором использовались даты по умолчанию, в противном случае принимает значение false .
IF-HOTEL-CAMPAIGN Optional Возвращает значение true , если клик пользователя был вызван кампанией для отелей, в противном случае — false . Это различие полезно партнерам, у которых в Google Рекламе присутствует несколько типов кампаний, для распределения атрибуции.
IF-PAYMENT-ID (только реклама отелей) Recommended (if you use pay-per-stay Google Ads campaigns) Принимает значение true для отелей, участвующих в программе комиссий с оплатой за пребывание (PPS), в противном случае принимает значение false .
IF-PROMO-CODE Optional Возвращает значение true , если пользователь щелкнул тариф, основанный на рекламной акции ARI или правиле тарифов с данным PromoCode ; в противном случае принимает значение false .
IF-PROMOTED (только реклама отелей) Recommended (if you use Promoted hotels) Возвращает значение true , если пользователь нажал на объявление о рекламе недвижимости, в противном случае принимает значение false .
IF-RATE-RULE-ID Optional Возвращает значение true если пользователь выбрал условную ставку , в противном случае принимает значение false .
IF-USER-LIST-ID (определено в Google Рекламе) Optional Принимает значение true если пользователь является участником идентификатора списка клиентов Google Рекламы, который вы указали при настройке мультипликаторов ставок для списков аудитории, в противном случае принимает значение false .
IF-VERIFICATION Optional Возвращает значение true , если ссылка была создана Google для тестирования или автоматической проверки, в противном случае принимает значение false .
ELSE Recommended (if you use any conditional IF statements) Если предыдущее условие не выполняется, то в URL-адрес вставляются значения, следующие за этим условием.
END-IF Optional (required if you have any IF conditional statements) Завершает условный блок оператора IF .
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) Выполняется один раз для каждого элемента <Child "age"> в фиде цен. Например, если <OccupancyDetails> включает два элемента <Child age="17"> и <Child age= "17"> , директива выполняется два раза.
END-FOR-EACH Optional (required if using FOR-EACH block) Завершает условный блок оператора FOR-EACH .

Пример 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&amp;booking_source=commissions
  • Если номер IATA был присвоен Google:
    https://partner.com?hid=123&amp;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-адресов в файле целевой страницы применяются следующие общие правила:

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

  • Параметры строки запроса можно передавать только после вопросительного знака ("?") в URL-адресе.

  • Параметры строки запроса в конечном выводе должны быть разделены амперсандом («&»). Потому что амперсанд — это специальный символ в XML, а формат файла целевых страниц — XML . Поэтому вы должны использовать закодированный объект «&amp;» на своем месте. Конечный результат отображает фактический символ «&». Например:

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&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

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

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