Se usó la API de Cloud Translation para traducir esta página.

Variables y condiciones

Los anuncios de hoteles y los vínculos gratuitos para reservar incluyen vínculos a páginas de destino en las que los usuarios pueden reservar habitaciones. Puedes definir la forma en que Google construye el vínculo para incluir toda la información adicional sobre el usuario y su itinerario. Por ejemplo, puedes incluir información como el ID del hotel, el idioma, los códigos de moneda y las fechas de entrada en la URL.

Descripción general

La URL de página de destino se define en el archivo de páginas de destino. Cuando se muestra el anuncio o el vínculo gratuito para reservar, la información dinámica de la URL se reemplaza por valores reales. Para agregar valores dinámicos a las URLs de página de destino, utiliza la siguiente sintaxis:

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

En el siguiente ejemplo, se muestra una URL que utiliza los nombres de las variables de Google en lugar del ID del hotel y el itinerario reales:

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

Cuando se crea el vínculo de la página de destino para la página de resultados de búsqueda, Google reemplaza las variables por los valores reales para garantizar que la URL incluya información dinámica. Por ejemplo, si el usuario reserva una habitación por 6 noches a partir del 23/5/2023 para el hotel n.o 42, Google procesa el vínculo anterior de la siguiente manera:

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

Los valores que Google asigna a las variables en la cadena de consulta dependen de los datos correspondientes en tu feed de precios de hoteles, feed de lista de hoteles y configuración del usuario.

Por ejemplo,el valor de la variable LENGTH se asigna al elemento <Nights> del feed de precios del itinerario relacionado. De manera similar, el valor de la variable PARTNER-HOTEL-ID se define en el elemento <id> del feed de lista de hoteles que coincidió con los criterios de búsqueda del usuario.

Algunas variables son subconjuntos de los elementos del feed de precios. Por ejemplo, las variables CHECKINDAY, CHECKINMONTH y CHECKINYEAR se extraen del único elemento <Checkin> del feed de precios. Otras variables se calculan según la configuración regional del usuario y otros ajustes del cliente.

Para obtener más información sobre las fuentes de los valores de las variables, consulta la Descripción general de precios y la Lista de hoteles.

Variables de URL

En la siguiente tabla, se describen las variables disponibles que puedes usar para crear la URL de página de destino:

Variable	Recomendada/opcional	Descripción
ADVANCE-BOOKING-WINDOW	Optional	Es la cantidad de días de reserva anticipada antes de la fecha de entrada en la zona horaria del hotel en el momento de la reserva. Por ejemplo, `36`.
ALTERNATE-HOTEL-ID	Recommended (if you have separate IDs to identify properties versus booking engines)	Un identificador alternativo para su propiedad. Este nombre de atributo se especifica en tu feed de lista de hoteles. Tener ID independientes es útil si necesitas un identificador de propiedad para la información de tu feed y otro para tu motor de reservas.
CAMPAIGN-ID	Recommended	Es el ID de la campaña de Google Ads que deseas asociar con la URL. Este campo se deja en blanco si el clic no está asociado a una campaña de Google Ads.
CHECKINDAY	Recommended	Es el día de dos dígitos definido en el elemento `<Checkin>` del feed de precios de hoteles. Por ejemplo, `20`
CHECKINDAY-OF-WEEK	Optional	El día de la semana (de `Monday` a `Sunday`, en el que se realiza el registro de entrada) en la zona horaria del hotel Por ejemplo, `Tuesday`.
CHECKINMONTH	Recommended	Es el mes de dos dígitos definido en el elemento `<Checkin>` del feed de precios de hoteles. Por ejemplo, `05`
CHECKINYEAR	Recommended	Es el año de cuatro dígitos definido en el elemento `<Checkin>` del feed de precios de hoteles. Por ejemplo, `2023`
CHECKOUTDAY	Recommended	Es el día de dos dígitos que se calcula a partir de los elementos `<Nights>` y `<Checkin>` del feed de precios de hoteles. Por ejemplo, `26`.
CHECKOUTMONTH	Recommended	Es el mes de dos dígitos que se calcula a partir de los elementos `<Nights>` y `<Checkin>` del feed de precios de hoteles. Por ejemplo, `05`.
CHECKOUTYEAR	Recommended	Es el año de cuatro dígitos calculado a partir de los elementos `<Nights>` y `<Checkin>` del feed de precios de hoteles. Por ejemplo, `2023`.
CHILD-AGE	Recommended (must be provided for child occupancy pricing)	La edad máxima de cada niño o niña, según se especifica en los elementos `<Child "age">` del feed de precios. Esta variable debe usarse junto con un bloque condicional `FOR-EACH-CHILD-AGE`.
CHILD-INDEX	Optional	Una variable de bucle con índice 0 que representa un contador para cada ocupante secundario y edad secundaria especificados en el itinerario Si bien no es obligatorio, esta variable solo se puede usar junto con un bloque condicional `FOR-EACH-CHILD-AGE`.
CLICK-TYPE	Optional	Indica si el usuario hizo clic en la ficha para obtener una tarifa estándar de hotel o un paquete de habitación. Los valores posibles son los siguientes: `hotel`: El usuario hizo clic en la ficha y obtuvo una tarifa estándar de la habitación. `room`: El usuario hizo clic en la ficha de un paquete de habitación.
CLOSE-RATE-RULE-IDS	Optional (only applies if you are using conditional or private rates)	Una lista separada por comas de los IDs de reglas de tarifas para las tarifas que no estaban disponibles, pero que podrían estar disponibles si el usuario realizó una acción menor. Ten en cuenta que los IDs de reglas de tarifas para tarifas privadas siempre se propagan aquí cuando se muestra al usuario el tratamiento de la IU correspondiente.
CUSTOM[1-5]	Optional	Los valores para los campos personalizados definidos en el elemento `<Result>` con un límite de 200 caracteres por campo personalizado. Para obtener más información, consulta la Descripción general de los mensajes de transacción. Los campos personalizados no están disponibles cuando se usa ARI.
DATE-TYPE	Optional	Indica si el usuario seleccionó la fecha predeterminada o una fecha específica proporcionada en la búsqueda. Los valores posibles son los siguientes: `default`: El usuario hizo clic en un anuncio de hotel o en un vínculo gratuito para reservar en el que se utilizaron las fechas predeterminadas. `selected`: El usuario hizo clic en un anuncio de hotel o en un vínculo gratuito para reservar con las fechas establecidas.
GOOGLE-SITE	Optional	Es la propiedad de Google en la que un usuario vio los datos de precios de tu hotel. Los valores posibles son los siguientes: `localuniversal`: El usuario encontró el vínculo para reservar el hotel a través de la búsqueda de `google.com`. `mapresults`: El usuario encontró el vínculo para reservar el hotel a través de `maps.google.com`. `verification`: Google usa este valor cuando realiza pruebas automatizadas de calidad de los datos en tu sitio. No se te factura por estas consultas. Google Analytics puede usar este parámetro y su valor para identificar el tráfico de verificación automática de los Anuncios de hoteles. `unknown`: El usuario encontró el anuncio o el vínculo gratuito para reservar a través de una fuente indeterminada.
LENGTH	Recommended	Es la duración de la estadía en términos de la cantidad de noches que define el elemento `<Nights>` en el feed de precios de hoteles. Por ejemplo, `3`.
NUM-ADULTS	Recommended (must be used with the `NUM-CHILDREN` or `FOR-EACH-CHILD-AGE` condition)	Indica la cantidad de ocupantes adultos que el usuario especificó para el itinerario. Esta variable se debe usar junto con `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` o ambos.
NUM-CHILDREN	Recommended	La cantidad de ocupantes infantiles (de 0 a 17 años) que el usuario especificó en el itinerario. Se requieren `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` o ambos para participar correctamente en itinerarios con ocupantes secundarios.
NUM-GUESTS	Recommended (if you don't send child occupancy pricing)	Es la cantidad total de ocupantes, tanto adultos como niños, que el usuario especificó para el itinerario. Este valor es una suma de los valores `NUM-ADULTS` y `NUM-CHILDREN`. Para maximizar la participación, se recomienda usar `NUM-ADULTS` y `NUM-CHILDREN` en su lugar.
PACKAGE-ID	Recommended (applies if you use Room Bundles)	Es el identificador único del paquete en el feed de precios de hoteles. En el caso de un paquete estándar, el ID del paquete es el valor del elemento `<PackageID>` dentro de un bloque `<Result>`. Para un paquete de habitación, el ID del paquete es el valor del elemento `<PackageID>` dentro de los bloques `<RoomBundle>` o `<PackageData>` del mensaje Transaction.
PARTNER-CURRENCY	Optional	El código de moneda de tres letras definido por el atributo `currency` del elemento `<Baserate>` en el feed de precios de hoteles. Por ejemplo: `USD` o `CAD`.
PARTNER-HOTEL-ID	Recommended	Es el identificador único del hotel que define el elemento `<id>` en el feed de lista de hoteles.
PARTNER-ROOM-ID	Recommended (applies if you use Room Bundles)	Es el identificador único de la habitación en el feed de precios de hoteles. En el caso de una habitación estándar, el ID de habitación es un valor del elemento `<RoomID>` dentro del bloque `<Result>`. Para un paquete de habitación, el ID de habitación es el valor asignado al elemento `<RoomID>` dentro de los bloques `<RoomBundle>` o `<RoomData>` en el mensaje Transaction.
PAYMENT-ID	Optional (only applies to Ads)	Se resuelve como una string predefinida `commission` o el número IATA asignado de Google (por ejemplo, “01234567”) si usas una agencia para la cobranza de comisiones. Para cambiar el formato de tu número IATA o la string predefinida, comunícate con tu administrador técnico de cuentas (TAM).
PRICE-DISPLAYED-TAX	(Optional)	Es el importe del impuesto que se muestra al usuario en su moneda local. El valor de `PRICE-DISPLAYED-TAX` es el valor del elemento `<Tax>` en el feed de precios de hoteles. Por ejemplo, “3.14”.
PRICE-DISPLAYED-TOTAL	(Optional)	Es el costo total de la habitación que se muestra al usuario en su moneda local. El valor de `PRICE-DISPLAYED-TOTAL` es la suma de los elementos `<Baserate>`, `<Tax>` y `<OtherFees>` del feed de precios de hoteles. Por ejemplo, “152.13”.
PROMO-CODE	(Optional)	Si usas promociones de ARI, el valor de esta variable se asigna al atributo `id` de la `<Promotion>` aplicada. Si se aplican varias promociones, se trata de una lista separada por comas de IDs de promoción en un orden arbitrario. Si usas reglas de tarifas, el valor de esta variable se asigna al elemento `PromoCode` si se aplica la regla de tarifas correspondiente.
RATE-PLAN-ID	Recommended (only applies if you use RoomBundles)	Es el ID definido por el elemento `<RatePlanID>` en el bloque `<RoomBundle>` de un feed de precios. El `<RatePlanID>` representa el identificador único de una combinación de datos de habitación y paquete. Para obtener más información, consulta Paquetes de habitaciones.
RATE-RULE-ID	Recommended (only applies if you use conditional rates or private rates)	Es el ID definido por el atributo `rate_rule_id` dentro del bloque `<Rate>` de un feed de precios. Para obtener más información, consulta las Tarifas condicionales. Nota: Solo se muestran las tarifas condicionales o privadas que no están ocultas.
USER-COUNTRY	Recommended	Un código de país de dos letras que indica la ubicación del usuario. Esta información se extrae de la configuración del cliente del usuario. Por ejemplo, `US` o `FR`.
USER-CURRENCY	Recommended	Es un código de moneda de tres letras que indica la moneda local del usuario. El valor de la variable `USER-CURRENCY` se infiere de la configuración del cliente del usuario. Por ejemplo, `USD` o `CAD` .
USER-DEVICE	Recommended	El tipo de dispositivo del usuario. El valor de `USER-DEVICE` puede ser uno de los siguientes: `mobile` `tablet` `desktop` `unknown` El valor de la variable `USER-DEVICE` se infiere de la configuración del cliente del usuario.
USER-LANGUAGE	Recommended	Es un código de idioma ISO 639-1 de dos letras que especifica el idioma de visualización del anuncio o del vínculo gratuito para reservar. El valor de la variable `USER-LANGUAGE` se infiere de la configuración del cliente del usuario. Por ejemplo, `en` o `fr`.
USER-LIST-ID (definido en Google Ads)	Optional (only applies if you use Audience Lists in Google Ads)	Es el ID de la lista de usuarios de Google Ads que contiene la lista de público o la información del usuario. Las listas de público se utilizan como base para establecer ajustes de la oferta. Si el usuario forma parte de varias listas de público, se selecciona la que tenga el ajuste de la oferta más grande. Los vínculos entre los públicos con el ajuste de la oferta más alto se deciden de forma aleatoria.
VERIFICATION	Optional	Un valor booleano que verifica si Google generó el vínculo para pruebas o validación automatizada. Es `true` si Google generó el vínculo para pruebas o validación automatizada. De lo contrario, es `false`.

Lógica condicional en las URLs

Puedes usar directivas especiales en el elemento <URL> de un archivo de páginas de destino para compilar extremos de forma condicional.

La lógica condicional admite las siguientes sentencias:

if_statement: Si es true, los valores que siguen esta condición se insertan en la URL; de lo contrario, se insertan los valores que siguen a la directiva ELSE.
for_statement: Crea una condición de bucle FOR que se itera en la cantidad de valores proporcionados.

Las instrucciones IF y FOR incluyen lo siguiente:

Condición	Recomendada/opcional	Descripción
IF-AD-CLICK (solo Anuncios de hoteles)	Optional	Se resuelve como `true` si el clic del usuario se originó desde un anuncio. Se resuelve como `false` si el clic del usuario se originó en un vínculo gratuito para reservar.
IF-CLICK-TYPE-HOTEL	Optional	Se resuelve como `true` si el usuario hace clic en la ficha de un hotel; de lo contrario, se resuelve como `false`.
IF-CLICK-TYPE-ROOM	Optional	Se resuelve como `true` si el usuario hace clic en la ficha de un paquete de habitación; de lo contrario, se resuelve como `false`.
IF-CLOSE-RATE-RULE-IDS	Optional	Se resuelve como `true` si una o más tarifas condicionales no estaban disponibles porque el usuario no era apto. De lo contrario, se resuelve como `false`. De forma predeterminada, es `true` si se muestra al usuario un tratamiento de la IU de tarifa privada .
IF-DEFAULT-RATE	Optional	Se resuelve como `true` si el usuario hace clic en una ficha de hotel en la que se utilizaron fechas predeterminadas; de lo contrario, se resuelve como `false`.
IF-HOTEL-CAMPAIGN	Optional	Se resuelve como `true` si el clic del usuario se originó de una campaña de hotel; de lo contrario, se resuelve como `false`. Esta distinción es útil para los socios que tienen varios tipos de campañas presentes en Google Ads para asignar la atribución.
IF-PAYMENT-ID (solo Anuncios de hoteles)	Recommended (if you use pay-per-stay Google Ads campaigns)	Se resuelve como `true` para los hoteles del programa de comisiones de pago por estadía (PPS) de lo contrario, se resuelve como `false`.
IF-PROMO-CODE	Optional	Se resuelve como `true` si el usuario hizo clic en una tarifa basada en una promoción de ARI o en una regla de tarifas con un `PromoCode` determinado. De lo contrario, se resuelve como `false`.
IF-PROMOTED (solo Anuncios de hoteles)	Recommended (if you use Promoted hotels)	Se resuelve como `true` si el usuario hace clic en un anuncio de promoción de hotel; de lo contrario, se resuelve como `false`.
IF-RATE-RULE-ID	Optional	Se resuelve como `true` si el usuario seleccionó una tarifa condicional ; de lo contrario, resuelve como `false`.
IF-USER-LIST-ID (definido en Google Ads)	Optional	Se resuelve como `true` si el usuario es miembro de un ID de lista de clientes de Google Ads que especificaste cuando configuraste los multiplicadores de ofertas para las listas de público; de lo contrario, se resuelve como `false`.
IF-VERIFICATION	Optional	Se resuelve como `true` si Google generó el vínculo para pruebas o validación automatizada; de lo contrario, se resuelve como `false`.
ELSE	Recommended (if you use any conditional IF statements)	Si no se cumple la condición anterior, los valores que siguen a esta condición se insertan en la URL.
END-IF	Optional (required if you have any IF conditional statements)	Finaliza el bloque condicional de la sentencia `IF`.
FOR-EACH-CHILD-AGE	Optional (required for child occupancy pricing)	Se ejecuta una vez para cada elemento `<Child "age">` en el feed de precios. Por ejemplo, si `<OccupancyDetails>` incluye los dos elementos `<Child age="17">` y `<Child age= "17">`, la directiva se ejecuta dos veces.
END-FOR-EACH	Optional (required if using FOR-EACH block)	Finaliza el bloque condicional de la sentencia `FOR-EACH`.

Ejemplo IF-AD-CLI

Puedes crear un bloque condicional que verifique si el usuario hizo clic en un anuncio o en un vínculo gratuito para reservar a fin de redireccionar a los usuarios a tu página de destino.

En el siguiente ejemplo, se usa esta directiva en un archivo de página de destino:

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

En este ejemplo, si el usuario no hizo clic en un anuncio, el resultado es la siguiente URL:

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

Si el usuario hizo clic en el anuncio, el resultado es la siguiente URL:

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

Ejemplo de IF-CLI-TYPE-HOTEL

Puedes construir un bloque condicional que verifique si el usuario seleccionó un hotel sin un paquete de habitación explícito. El valor del elemento <RatePlanID> en el bloque <Room Bundle> de un mensaje de transacción se establecerá en el precio del paquete de habitación asociado implícitamente que el usuario seleccionó.

En el siguiente ejemplo, se usa esta directiva en un archivo de páginas de destino:

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

En este ejemplo, si el usuario seleccionó un paquete de habitación, el resultado es la siguiente URL:

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

Si el usuario no seleccionó un paquete de habitación, el resultado es la siguiente URL:

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

Ejemplo IF-CLI-TYPE-ROOM

Puedes construir un bloque condicional que verifique si el usuario seleccionó un paquete de habitación.

En el siguiente ejemplo, se usa esta directiva en un archivo de páginas de destino:

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

En este ejemplo, si el usuario no seleccionó un paquete de habitación, el resultado es la siguiente URL:

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

Si el usuario seleccionó un paquete de habitación, el resultado es la siguiente URL:

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

Ejemplo IF-DEFAULT-DATE

Usa la sentencia condicional IF-DEFAULT-DATE para establecer un parámetro que no sea de fecha que tu sitio web pueda usar para activar un comportamiento personalizado si el usuario no seleccionó una fecha.

En el siguiente ejemplo, se verifica si se usó la fecha predeterminada:

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

En este ejemplo, si el usuario no seleccionó una fecha, el resultado podría ser similar a la siguiente URL que muestra las selecciones de fecha predeterminadas:

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

Si el usuario seleccionó una fecha, el resultado puede ser similar a la siguiente URL, según el itinerario seleccionado:

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

Ejemplo de IF-HOTEL-CAMPAIGN (clics en anuncios de hoteles y vínculos gratuitos para reservar)

Puedes crear un bloque condicional que verifique si el usuario hizo clic en un anuncio que se originó en una campaña de hotel.

En el siguiente ejemplo, se usa esta directiva en un archivo de página de destino:

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

En este ejemplo, si el usuario hace clic en la URL de una campaña de hotel, el resultado es la siguiente URL:

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

Si el clic no está en la URL de una campaña de hotel (p.ej., una campaña de Búsqueda normal), el resultado es la siguiente URL:

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

Esto es útil cuando deseas distinguir el tráfico de los clics en las campañas de hoteles del resto de los clics.

ID de CAMPAÑA en blanco con clics del FBL

Si el clic proviene de un vínculo gratuito para reservar, IF-HOTEL-CAMPAIGN muestra TRUE, y el valor CAMPAIGN-ID queda en blanco, como se muestra en la siguiente URL:

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

Puedes usar la sentencia condicional IF-AD-CLICK para evitar un ID de campaña en blanco, como se muestra en el siguiente ejemplo:

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

Ejemplo de IF-PAYMENT-ID (solo en Anuncios de hoteles)

Usa la sentencia condicional IF-PAYMENT-ID para variar la URL en función de si el clic es o no un resultado del programa de comisiones de PPS. En el siguiente ejemplo, se verifica si un clic provino del programa de comisiones de PPS y asigna un valor al parámetro booking_source según el resultado:

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

Si el hotel es parte del programa Comisiones, el resultado es una de las siguientes URLs:

Si no se asignó ningún número IATA a Google, haz lo siguiente:

https://partner.com?hid=123&booking_source=commissions
Si se asignó un número IATA a Google, haz lo siguiente:

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

De lo contrario, el resultado es la siguiente URL:

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

Ejemplo IF-PROMOTED (solo para Anuncios de hoteles)

Puedes crear un bloque condicional que verifique si el usuario hizo clic en un anuncio de promoción de hotel.

En el siguiente ejemplo, se usa esta directiva en un archivo de páginas de destino:

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

En este ejemplo, si el usuario seleccionó un anuncio de promoción de hotel, el resultado es la siguiente URL:

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

Si el usuario no seleccionó un anuncio de promoción de hotel, el resultado es la siguiente URL:

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

Ejemplo IF-RATE-RULE-ID

Puedes construir un bloque condicional que verifique si el usuario seleccionó una tarifa condicional y, de ser así, se usa el valor del elemento <RateRuleID> en el bloque <Rate> del mensaje de transacción.

En el siguiente ejemplo, se usa esta directiva en un archivo de páginas de destino:

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

En este ejemplo, si el usuario no seleccionó una tarifa condicional, el resultado es la siguiente URL:

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

Si el usuario seleccionó una tarifa condicional, el resultado es la siguiente URL:

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

Ejemplo IF-USER-LIST-ID (definido en Google Ads)

Si configuras multiplicadores de ofertas para listas de público en una campaña de hotel en Google Ads, puedes usar IF-USER-LIST-ID junto con USER-LIST-ID a fin de establecer un parámetro en tu sitio web para un cliente que pertenece a una determinada lista de público de Google Ads. Te recomendamos que lo hagas con fines de seguimiento o para personalizar tu sitio web para los miembros de las listas de público.

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

En este ejemplo, si el usuario no era miembro de una lista de público, el resultado es la siguiente URL:

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

Si el usuario era miembro de la lista de público 12345678, el resultado es la siguiente URL:

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

Ejemplo IF-VERIFICATION

Si necesitas verificar si Google generó la URL para pruebas o validación automatizada, puedes usar IF-VERIFICATION.

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

En este ejemplo, si Google no generó la URL para pruebas o validación, el resultado es la siguiente:

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

Si Google generó la URL para pruebas o validación, el resultado es la siguiente URL:

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

Ejemplo de FOR-EACH-CHILD-AGE

Puedes construir un bloque condicional que propague la edad máxima de cada ocupante secundario, como se especifica en el feed de precios de hoteles.

En el siguiente ejemplo, se usa esta directiva en un archivo de páginas de destino:

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

En este ejemplo, si el itinerario tiene 2 adultos y 2 niños de 0 y 17 años, respectivamente, el resultado es la siguiente URL:

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

Si el itinerario tiene 2 adultos y 0 niños, el resultado es la siguiente URL:

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

Reglas generales al crear URLs

Todas las variables son opcionales. No es necesario que insertes ninguna variable en tu URL de página de destino. Sin embargo, el uso de variables para pasar la información del itinerario y la información del usuario, por lo general, crea una mejor experiencia para este y te ayuda a cumplir con las políticas de Google.

Cuando se definen URLs construidas en un archivo de páginas de destino, se aplican las siguientes reglas generales:

Todas las variables están entre paréntesis de apertura y cierre.
Los parámetros de la cadena de consulta solo se pueden pasar después del signo de interrogación ("?") en la URL.
Los parámetros de la cadena de consulta deben estar separados por un signo de unión ("&") en el resultado final. El signo et es un carácter especial en XML y el formato de archivo de las páginas de destino es XML. Por lo tanto, debes usar la entidad codificada "&" en su lugar. El resultado final renderiza un carácter “&” real. Por ejemplo:
```

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>


<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
```
También debes codificar en URL los caracteres especiales que puedes incluir en la URL de página de destino. Por ejemplo:
- espacio (" "): Reemplaza los caracteres de espacio por "%20;" en el elemento <URL>
- barra diagonal ("/"): Reemplaza las barras diagonales por "%2F;" en el elemento <URL>.
No todos los caracteres no alfabéticos deben estar codificados en formato URL. Por ejemplo, no es necesario que los guiones ("-") estén codificados en URL. Para ver una lista de caracteres comunes que deben estar codificados en formato URL, consulta la Tabla de codificación de URL.
Los valores para un solo parámetro se pueden construir a partir de múltiples variables. En el siguiente ejemplo, se construye un solo parámetro, checkinDate,a partir de las variables CHECKINDAY, CHECKINMONTH y CHECKINYEAR:
```
<URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
```
Este ejemplo da como resultado una URL que podría ser similar a la siguiente:
```
https://www.partnerdomain.com?checkinDate=7/23/1971
```
Puedes usar cualquier ID para el nombre de los parámetros de la cadena de consulta. Tu servidor procesa estos valores. Sin embargo, los valores que pasas se limitan a la lista de variables disponibles.
Puedes usar hasta cinco variables personalizadas además de la lista de variables disponibles.