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 que incluya 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 los siguientes ejemplos, se muestra una URL que utiliza los nombres de las variables de Google en lugar del ID del hotel y el itinerario reales:

Ejemplo 1

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

Ejemplo 2

<URL>https://www.partnerdomain.com/hotel/(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 con los valores reales para garantizar que la URL incluya información dinámica. Por ejemplo, si el usuario reserva una habitación para 6 noches a partir del 23/5/2023 en el hotel n.° 42, Google muestra 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 los precios y la lista de hoteles.

Variables de URL

En la siguiente tabla, se describen las variables disponibles que puedes usar para construir la URL de tu 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. Aparece 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 que se calcula 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 se debe usar 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 obligatoria, 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 del hotel o un paquete de habitaciones. Los valores posibles son los siguientes: `hotel`: El usuario hizo clic en la ficha para obtener una tarifa de habitación estándar. `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 las reglas de tarifas para las tarifas privadas siempre se propagan aquí cuando se muestra al usuario un tratamiento de IU correspondiente.
CUSTOM[1-5]	Optional	Los valores de 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 de reserva gratuita con las fechas establecidas.
GOOGLE-ADS-CLICK-SOURCE	Optional	Indica que Google Ads fue la fuente del clic. Los valores posibles son los siguientes: `bl`: Vínculos para reservar pagados `tpa`: Anuncios de promoción de viajes `tfsa`: Feeds de viajes en los anuncios de búsqueda `pm`: Son las campañas de máximo rendimiento o de máximo rendimiento para objetivos de viaje. Nota: Si el clic se originó en la Búsqueda de Google en lugar de en Google Ads, este parámetro estará vacío.
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 cobrará por estas consultas. Google Analytics puede usar este parámetro y su valor para identificar el tráfico de verificación automática de Anuncios de hoteles. `unknown`: El usuario encontró el anuncio o el vínculo de reserva gratuita 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	Es la cantidad de ocupantes menores de edad (de 0 a 17 años) que el usuario especifica en el itinerario. Se requieren `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` o ambos para participar correctamente en itinerarios con ocupantes menores de edad.
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`.
PACKAGE-ID	Recommended (applies if you use Room Bundles)	Es el identificador único del paquete en el feed de precios de hoteles. Para un paquete estándar, el ID del paquete es el valor del elemento `<PackageID>` dentro de un bloque `<Result>`. En el caso de un paquete de habitaciones, el ID del paquete es el valor del elemento `<PackageID>` dentro de los bloques `<RoomBundle>` o `<PackageData>` del mensaje de transacción.
PARTNER-CURRENCY	Optional	Es el código de moneda de tres letras que define 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. Para una habitación estándar, el ID de la habitación es un valor del elemento `<RoomID>` dentro del bloque `<Result>`. En el caso de un paquete de habitaciones, el ID de la habitación es el valor asignado al elemento `<RoomID>` dentro de los bloques `<RoomBundle>` o `<RoomData>` en el mensaje de transacción.
PAYMENT-ID	Optional (only applies to Ads)	Se resuelve como una cadena predefinida `commission` o el número IATA asignado de Google (por ejemplo, "01234567") si usas una agencia para la cobranza de las comisiones. Para cambiar el formato de tu número IATA o la cadena predefinida, comunícate con tu administrador técnico de cuentas (TAM).
PRICE-DISPLAYED-TAX	(Optional)	Es el importe de los impuestos 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)	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` del `<Promotion>` aplicado. Si se aplican varias promociones, es una lista de IDs de promoción separados por comas 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 que define 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	Es 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)	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 usan 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 empates entre los públicos con el ajuste de la oferta más alto se deciden de forma aleatoria.
VERIFICATION	Optional	Es 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 itera sobre la cantidad de valores proporcionados.

Las instrucciones IF y FOR incluyen lo siguiente:

Condición	Recomendada/opcional	Descripción
IF-AD-CLICK (solo para 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 en `true` si el usuario hizo clic en una ficha de un paquete de habitaciones; de lo contrario, se resuelve en `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 le mostró al usuario un tratamiento de IU de tarifa privada.
IF-DEFAULT-RATE	Optional	Se resuelve en `true` si el usuario hizo clic en una ficha de hotel en la que se usaron fechas predeterminadas; de lo contrario, se resuelve en `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 que los socios que tienen varios tipos de campañas presentes en Google Ads asignen la atribución.
IF-PAYMENT-ID (solo para 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 en `true` si el usuario hizo clic en una tarifa que se basa en una promoción de ARI o una regla de tarifas con un `PromoCode` determinado; de lo contrario, se resuelve en `false`.
IF-PROMOTED (solo para 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 en `true` si el usuario seleccionó una tarifa condicional; de lo contrario, se resuelve en `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 en `true` si Google generó el vínculo para pruebas o validación automática; de lo contrario, se resuelve en `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 el `<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 un vínculo gratuito para reservar para redireccionarlo 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 IF-CLI-TYPE-HOTEL

Puedes crear un bloque condicional que verifique si el usuario seleccionó un hotel sin un paquete de habitaciones 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 habitaciones, el resultado es la siguiente URL:

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

Ejemplo de IF-CLICK-TYPE-ROOM

Puedes crear un bloque condicional que verifique si el usuario seleccionó un paquete de habitaciones.

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 habitaciones, el resultado es la siguiente URL:

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

Si el usuario seleccionó un paquete de habitaciones, 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 que el ID de campaña esté 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 según si el clic es un resultado del programa de comisiones de PPS o no. En el siguiente ejemplo, se verifica si un clic proviene del programa de comisiones de PPS y se 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 forma 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 de 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 propiedad.

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 de IF-RATE-RULE-ID

Puedes crear un bloque condicional que verifique si el usuario seleccionó una tarifa condicional y, si ese es el caso, 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 estableces multiplicadores de ofertas para las listas de público en una campaña de hoteles en Google Ads, puedes usar IF-USER-LIST-ID junto con USER-LIST-ID para establecer un parámetro en tu sitio web para un cliente que pertenece a una lista de público de Google Ads determinada. 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 tenía 2 adultos y 0 niños, el resultado es la siguiente URL:

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

Reglas generales para crear URLs

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

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

Todas las variables están entre paréntesis de apertura y cierre.
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)&amp;nights=(LENGTH)</URL>


<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
```
También debes codificar en formato URL los caracteres especiales que puedas incluir en la URL de la 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 que no sean alfabéticos deben estar codificados en formato URL. Por ejemplo, no es necesario que los guiones ("-") estén codificados en URL. Para obtener una lista de caracteres comunes que deben estar codificados como URL, consulta 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 genera una URL que podría verse de la siguiente manera:
```
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.