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 la 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 tu página de destino, usa la siguiente sintaxis:

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

En los siguientes ejemplos, se muestra una URL que usa los nombres de 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 por los valores reales para garantizar que la URL incluya la información dinámica. Por ejemplo, si el usuario reserva una habitación para 6 noches a partir del 23/5/2023 para el hotel n° 42, Google renderiza 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. Del mismo modo, 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> en el feed de precios. Otras variables se calculan según la configuración regional del usuario y otros parámetros de configuración 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 crear 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. Contar con IDs independientes es útil si necesitas un identificador de propiedad para la información del feed y otro para el motor de reservas.
CAMPAIGN-ID Recommended Es el ID de la campaña de Google Ads que deseas asociar a la URL. Este campo queda 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 Es 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 calculado 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 calculado 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) Es la edad máxima de cada niño, como 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 Es una variable de bucle indexada en 0 que representa un contador para cada ocupante infantil y la edad del niño o niña 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 de una tarifa de hotel estándar o de un paquete de habitaciones. Los valores posibles son los siguientes:
  • hotel: El usuario hizo clic en la ficha de una tarifa de habitación estándar.
  • room: El usuario hizo clic en la ficha de un paquete de habitaciones.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) Es una lista separada por comas de los IDs de reglas de tarifas que no estaban disponibles, pero que podrían haberlo estado si el usuario hubiera realizado una acción menor. Ten en cuenta que los IDs de las reglas de tarifas para las tarifas privadas siempre se completan aquí cuando se muestra un tratamiento de la IU correspondiente al usuario.
Optional Obsoleto: Son 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. Las variables CUSTOM solo se indican cuando envías los precios en el mensaje de transacción.
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 usaron 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-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 anuncios de búsqueda
  • pm: Campañas de máximo rendimiento o de máximo rendimiento para objetivos de viaje
  • dg: Campaña de generación de demanda

    • Nota: Si el clic se originó en la Búsqueda de Google en lugar de 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 un hotel a través de la búsqueda de google.com.
  • mapresults: El usuario encontró el vínculo para reservar un hotel a través de maps.google.com.
  • verification: Google usa este valor cuando realiza pruebas de calidad de los datos en tu sitio. No se te facturarán estas consultas. Google Analytics puede usar este parámetro y su valor para identificar el tráfico de verificación de los anuncios de hotel.
  • 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.
MODIFICATION-IDS Optional

Si usas las modificaciones de tarifas de ARI, el valor de esta variable es el atributo id del mensaje de modificación de tarifa. Si se aplican varias modificaciones de tarifa, se trata de una lista separada por comas de IDs de modificación en un orden arbitrario.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Es 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 ambas.
NUM-CHILDREN Recommended Es la cantidad de ocupantes menores de edad (de 0 a 17 años) que el usuario especificó en el itinerario. Se requiere NUM-CHILDREN, FOR-EACH-CHILD-AGE o ambos para participar correctamente en itinerarios con niños.
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. En el caso de 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 definido por 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>. 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.
Optional (only applies to Ads) Obsoleto: 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 de IATA o la cadena predefinida, comunícate con tu administrador técnico de cuentas (TAM).
PRICE-DISPLAYED-FEES (Optional) Es el importe de las tarifas incluidas en el total de impuestos y tarifas, que se muestra al usuario en su moneda local. El valor de PRICE-DISPLAYED-FEES es el valor del elemento <Fee> en el mensaje de transacción. Para ARI, este es el importe de la tarifa calculada según el mensaje TaxFeeInfo. Por ejemplo, "60.14".
PRICE-DISPLAYED-TAX (Optional) Es el importe de 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) 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 tarifa, el valor de esta variable se asigna al elemento PromoCode si se aplica la regla de tarifa 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. <RatePlanID> representa el identificador único para una combinación de datos de habitación y paquete, y debe tener una longitud de 50 caracteres o menos para un rendimiento óptimo. Para obtener más información, consulta Paquetes de Room.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Es el ID que se define con 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 el 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 lista de público con el ajuste de la oferta más alto. 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 realizar pruebas o validaciones. Es true si Google generó el vínculo para realizar pruebas o validaciones; 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 crear extremos de forma condicional.

La lógica condicional admite las siguientes declaraciones:

  • if_statement: Si es true, los valores que siguen a 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 en 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ó en 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 hizo clic en una ficha de un hotel; de lo contrario, se resuelve como false.
IF-CLICK-TYPE-ROOM Optional Se resuelve como true si el usuario hizo clic en una ficha de un paquete de habitaciones; 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 cumplía con los requisitos; de lo contrario, se resuelve como false. De forma predeterminada, es truesi se mostró al usuario un tratamiento de la IU de tarifa privada .
IF-DEFAULT-DATE Optional Se resuelve como true si el usuario hizo clic en una ficha de hotel en la que se usaron fechas predeterminadas; de lo contrario, se resuelve como false.
IF-HOTEL-CAMPAIGN Optional Se resuelve como true si el clic del usuario se originó en 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-MODIFICATION-IDS Optional Se resuelve como true si el usuario hizo clic en una tarifa que se modificó con una modificación de tarifa de ARI; de lo contrario, se resuelve como false.
(solo para anuncios de hotel) Recommended (if you use pay-per-stay Google Ads campaigns) Obsoleto: 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 que se basa en una promoción de ARI o una regla de tarifas con un PromoCode determinado; de lo contrario, se resuelve como false.
IF-PROMOTED (solo para anuncios de hoteles) Recommended (if you use Promoted hotels) Se resuelve como true si el usuario hizo 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, se 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 realizar pruebas o validaciones; 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"> del 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 de IF-AD-CLICK

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 de IF-CLICK-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 habitaciones asociado de forma implícita que el usuario haya seleccionado.

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

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

Ejemplo de IF-CLICK-TYPE-ROOM

Puedes crear un bloque condicional que verifique si el usuario seleccionó un RoomBundle.

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

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

Ejemplo de IF-CLOSE-RATE-RULE-IDS

Puedes crear un bloque condicional que verifique si el usuario tiene precios reducidos especiales o tarifas privadas para los miembros de un programa de lealtad.

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-CLOSE-RATE-RULE-IDS)&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>

En este ejemplo, si el usuario no es apto para la tarifa privada, el resultado es la siguiente URL:

https://partner.com?hid=123

Si el usuario es miembro de un programa de lealtad y cumple con los requisitos para obtener una tarifa privada, el resultado es la siguiente URL:

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

En el siguiente ejemplo, se muestra una lógica de tarifa condicional con detalles de la fecha de entrada, la fecha de salida y la ocupación con condiciones IF anidadas para verificar si el usuario cumple con los requisitos para obtener una tarifa privada, una tarifa privada condicional o una tarifa pública:

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

Si el usuario es apto para una tarifa privada, el resultado es la siguiente URL:

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

Si el usuario cumple con los requisitos para obtener una tarifa privada condicional, el resultado es la siguiente URL:

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

Si el usuario es apto para una tarifa pública, el resultado es la siguiente URL:

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

Ejemplo de IF-DEFAULT-DATE

Usa la sentencia condicional IF-DEFAULT-DATE para establecer un parámetro que no sea de fecha y 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)(IF-DEFAULT-DATE)&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 podría ser similar a la siguiente URL, según el itinerario que haya 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 hotel 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 clic no se realiza en una URL de campaña de hoteles (p.ej., una campaña de Búsqueda normal), el resultado es la siguiente URL:

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

Si el usuario hace clic en una URL de campaña de hotel, el resultado es la siguiente URL:

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

Esto es útil cuando deseas distinguir el tráfico de los clics de las campañas de hoteles de cualquier otro clic.

IDs de CAMPAIGN en blanco con clics en FBL

Si el clic proviene de un vínculo gratuito para reservar, IF-HOTEL-CAMPAIGN devuelve TRUE y el valor de CAMPAIGN-ID se establece 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 quede 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>

IF-MODIFICATIONS-IDS

Puedes crear un bloque condicional que verifique si el usuario actualizó el mensaje de Modificaciones de tarifas de ARI.

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-MODIFICATION-IDS)&amp;promo_applied=true&amp;mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>

En este ejemplo, si el usuario no modificó el mensaje de modificaciones de tarifas de ARI, el resultado es la siguiente URL:

https://partner.com?hid=123

Si el usuario actualizó el mensaje de modificaciones de tarifas de ARI, el resultado es la siguiente URL:

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

IF-PROMO-CODE

Puedes crear un bloque condicional que verifique si el código promocional para el descuento está vinculado a la tarifa del usuario especificado, que se configura a través de los mensajes de promociones de ARI o de reglas de tarifas.

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

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

En este ejemplo, si el código promocional no es válido, el resultado es la siguiente URL:

https://partner.com?hid=123

Si el usuario tiene un código promocional válido y cumple con los requisitos para obtener un descuento, el resultado es la siguiente URL:

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

Ejemplo de IF-PROMOTED (solo para anuncios de hotel)

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 no seleccionó un anuncio de promoción de hotel, el resultado es la siguiente URL:

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

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

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

Ejemplo de IF-RATE-RULE-ID

Puedes crear un bloque condicional que verifique si el usuario seleccionó una tarifa condicional y, si es así, se usa el valor del elemento <RateRuleID> en el bloque <Rate> del mensaje de transacción. Obtén más informació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;rate_rule=(RATE-RULE-ID)(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&rate_rule=(RATE-RULE-ID)

Ejemplo de 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 de 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. Es posible que quieras hacerlo 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 de IF-VERIFICATION

Si necesitas verificar si Google generó la URL para pruebas o validación, 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 URL:

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 crear un bloque condicional que complete la edad máxima de cada niño que se hospede, 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 tuviera 2 adultos y 2 niños de 0 y 17 años, respectivamente, el resultado sería la siguiente URL:

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

Si el itinerario tuviera 2 adultos y 0 niños, el resultado sería 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 información del itinerario y 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 rodeadas de 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. Porque el signo de unión 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 "&amp;" en su lugar. El resultado final renderiza un carácter "&" real. Por ejemplo:

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

    También debes codificar como URL los caracteres especiales que incluyas 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 de URL. Por ejemplo, los guiones ("-") no necesitan codificarse como URL. Para obtener una lista de los caracteres comunes que deben codificarse en la URL, consulta Codificación de URL.

  • Los valores de un solo parámetro se pueden construir a partir de varias 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.