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

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

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

En el siguiente ejemplo, se muestra una URL que usa los nombres de las variables de Google en lugar del ID de 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 a fin de garantizar que la URL incluya la 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° 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 la 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> 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 Descripción general de los precios y 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 el feed de lista de hoteles. Tener IDs independientes es útil si necesitas un identificador de propiedad para la información de tu feed y otro identificador de propiedad para tu motor de reservas.
CAMPAIGN-ID Recommended Es el ID de la campaña de Google Ads que desea asociar con la URL. Este campo estará en blanco si el clic no está asociado a una campaña de Google Ads.
CHECKINDAY Recommended 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 (desde el Monday hasta el Sunday, momento en que se realiza el registro de entrada) en la zona horaria del hotel. Por ejemplo, Tuesday.
CHECKINMONTH Recommended 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 El día de dos dígitos se calcula a partir de los elementos <Nights> y <Checkin> del feed de precios de hoteles. Por ejemplo, 26.
CHECKOUTMONTH Recommended El mes de dos dígitos 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) Es la edad máxima de cada hijo o hija, 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 Es una variable de bucle indexada en 0 que representa un contador para cada ocupante secundario y edad secundaria especificada 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 habitación. 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 podrían haber estado disponibles si el usuario hubiera realizado una acción menor. Ten en cuenta que los IDs de reglas de tarifas para las tarifas privadas siempre se propagan aquí cuando se muestra al usuario un tratamiento de la IU correspondiente.
CUSTOM[1-5] Optional 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 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 los 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 facturan 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 gratuito para reservar a través de una fuente indeterminada.
LENGTH Recommended Duración de la estadía en términos de la cantidad de noches definida por 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) Es la cantidad de ocupantes adultos que especifica el usuario 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 (entre 0 y 17 años) que el usuario especifica en el itinerario. Se requiere 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 especifica para el itinerario. Este valor es una suma de los valores de NUM-ADULTS y NUM-CHILDREN. Para maximizar la participación, te recomendamos que uses 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>. En el caso de un paquete de habitación, 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 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 habitación, el ID de habitación es el valor asignado al elemento <RoomID> dentro de los bloques <RoomBundle> o <RoomData> del mensaje de transacción.
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 de cobranza de 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 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 del <Promotion> aplicado. Si se aplican varias promociones, es una lista separada por comas de ID 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 tarifa correspondiente.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Es el ID, tal como lo 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 en el bloque <Rate> de un feed de precios. Para obtener más información, consulta Tarifas condicionales.
USER-COUNTRY Recommended Es 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 especifique 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 sobre el 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 seleccionará la que tenga el ajuste de la oferta más alto. Los vínculos entre los públicos con el mayor ajuste de la oferta se deciden de forma aleatoria.
VERIFICATION Optional Es un valor booleano que verifica si Google generó el vínculo para prueba o validación automática. 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 instrucciones:

  • 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 en la cantidad de valores proporcionados.

Las sentencias IF y FOR incluyen lo siguiente:

Condición Recomendada/opcional Descripción
IF-AD-CLICK (solo en Anuncios de hoteles) Optional Se resuelve como true si el clic del usuario se originó de un anuncio. Se resuelve como false si el clic del usuario se originó desde 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 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 truesi se le mostró al usuario un tratamiento de la IU de tarifa privada .
IF-DEFAULT-RATE Optional Se resuelve como true si el usuario hizo clic en una ficha de hotel en la que se usaron las 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 en 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 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 en 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 al establecer multiplicadores de ofertas para 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 prueba 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 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">, entonces 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 crear 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 seleccionó el usuario.

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 será la siguiente URL:

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

Ejemplo de IF-CLI-TYPE-ROOM

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

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 Room, 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 una 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 que seleccionó:

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ó a partir de 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 se encuentra 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 de 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 de CAMPAIGN-ID se establece en blanco, como se observa 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 IF-PAYMENT-ID (solo para Anuncios de hoteles)

Usa la sentencia condicional IF-PAYMENT-ID para variar la URL en función de si el clic es o no del programa de comisiones de PPS. En el siguiente ejemplo, se verifica si un clic provino 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 es parte del programa Comisiones, el resultado es una de las siguientes URLs:

  • Si no se asignó ningún número IATA a Google, ocurrirá lo siguiente:
    https://partner.com?hid=123&amp;booking_source=commissions
  • Si se asignó un número IATA a Google:
    https://partner.com?hid=123&amp;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 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 usará 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 de IF-USER-LIST-ID (definido en Google Ads)

Si estableces 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 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 para la 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 FOR-EACH-CHILD-AGE

Puedes crear un bloque condicional que propague la edad máxima de cada pasajero infantil, 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 tenía 2 adultos y 2 niños de 0 a 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 al 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, por lo general, el uso de variables para pasar información del itinerario y del usuario crea una mejor experiencia para el usuario y te ayuda a cumplir con las políticas de Google.

Las siguientes reglas generales se aplican 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 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. 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 muestra un carácter "&" real. Por ejemplo:

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

    También debes codificar en URL los caracteres especiales que podrías 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 alfanuméricos deben tener codificación URL. Por ejemplo, no es necesario codificar los guiones ("-") como URL. Para obtener una lista de los caracteres comunes que deben codificarse como URL, consulta la Tabla de codificación de URL.

  • Los valores para un solo parámetro se pueden crear 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>

    En este ejemplo, se muestra 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 pases estarán limitados a la lista de variables disponibles.

  • Puedes usar hasta cinco variables personalizadas además de la lista de variables disponibles.