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 salas de reuniones. Puedes definir cómo Google construye el vínculo para incluir todas información adicional sobre el usuario y su itinerario. Por ejemplo: puede 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 el anuncio o el archivo Se muestra un vínculo para reservar, 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 variables de Google en lugar de Itinerario y ID del hotel 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 con los valores reales para garantizar que la URL incluya el la información dinámica. Por ejemplo, si el usuario reserva una sala para 6 noches a partir del 23/5/2023 para el hotel n.o 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 del 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> de la lista de hoteles Feed que coincidió con los criterios de búsqueda del usuario.

Algunas variables son subconjuntos de los elementos del feed de precios. Por ejemplo, el Las variables CHECKINDAY, CHECKINMONTH y CHECKINYEAR se extraen del elemento <Checkin> único en el feed de precios. Se calculan otras variables 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 Descripción general de precios y Lista de hoteles.

Variables de URL

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

Variable Recomendada/opcional Descripción
ADVANCE-BOOKING-WINDOW Optional La cantidad de días de reserva anticipada antes de la fecha de entrada en el 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. El nombre de este 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 identificador de propiedad de tu motor de reservas.
CAMPAIGN-ID Recommended El ID de la campaña de Google Ads que deseas asociar con la URL. Este campo se muestra en blanco si el clic no está asociado a una cuenta de Google Ads campaña.
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 (de Monday a Sunday) el momento del registro de entrada, en la zona horaria del hotel. Por ejemplo, Tuesday.
CHECKINMONTH Recommended El mes de dos dígitos definido en <Checkin> del feed de precios de hoteles. Por ejemplo, 05
CHECKINYEAR Recommended El año de cuatro dígitos definido en <Checkin> del feed de precios de hoteles. Por ejemplo, 2023
CHECKOUTDAY Recommended El día de dos dígitos calculado a partir de <Nights> y Elementos <Checkin> del feed de precios de hoteles Por ejemplo, 26.
CHECKOUTMONTH Recommended El mes de dos dígitos calculado a partir del <Nights> y los elementos <Checkin> del feed de precios de hoteles. Por ejemplo, 05.
CHECKOUTYEAR Recommended El año de cuatro dígitos calculado a partir del <Nights> y los elementos <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 hijo o hija según se especifica en las 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 por cada elemento secundario la edad del inquilino y del niño 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 un hotel estándar. o por un paquete de habitación. Los valores posibles son los siguientes:
  • hotel: El usuario hizo clic en la ficha de una tarifa de la habitación.
  • room: El usuario hizo clic en la ficha de una sala. Paquete.
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 se disponible, pero podría haber estado disponible si el usuario hubiera tomado una acción menor. Ten en cuenta que los IDs de reglas de tarifas para tarifas privadas siempre se propagan aquí cuando se muestra el tratamiento de IU correspondiente para el usuario.
CUSTOM[1-5] Optional Los valores para los campos personalizados definidos en el archivo <Result> con un límite de 200 caracteres por campo personalizado. Para ver más información, consulta Descripción general de 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 la fecha indicada en la búsqueda. Los valores posibles son los siguientes:
  • default: El usuario hizo clic en un anuncio de hotel o vínculo para reservar en el que se usaron las fechas predeterminadas.
  • selected: El usuario hizo clic en un anuncio de hotel o vínculo 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 realizar 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 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 La duración de la estadía en términos de la cantidad de noches definida por el <Nights> del 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 (entre 0 y 17 años) especificada en el itinerario por el usuario. NUM-CHILDREN, Se requieren FOR-EACH-CHILD-AGE o ambos para completar participar en itinerarios con ocupantes infantiles.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) La cantidad total de ocupantes, tanto adultos como niños, especificada para el itinerario por el usuario. Este valor es una suma de Valores NUM-ADULTS y NUM-CHILDREN. Para maximizar la participación, se recomienda encarecidamente utilizar ambos 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. Para un Paquete estándar, el ID del paquete es el valor del Elemento <PackageID> en un <Result> bloque. Para un paquete de habitación, el ID del paquete es el valor del <PackageID> dentro del Bloques <RoomBundle> o <PackageData> del mensaje de transacción.
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, definido por el <id> del 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 un habitación estándar, el ID de habitación es un valor del elemento <RoomID> en <Result> bloque. Para un paquete de habitación, el ID de habitación es el valor asignado a la <RoomID> dentro del 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 valor de número IATA asignado (por ejemplo, “01234567”), si usas una o en una agencia de cobranzas. Para cambiar el formato de tu número IATA o o 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 de El 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 la moneda local. El valor de PRICE-DISPLAYED-TOTAL es el la suma de <Baserate>, <Tax> y Elementos <OtherFees> del feed de precios de hoteles. Por ejemplo, “152.13”.
PROMO-CODE (Optional)

Si usas ARI promociones, el valor de esta variable se asigna al atributo id de la <Promotion> aplicada. Si se aplican varias promociones, es una lista separada por comas de los IDs de promoción en un orden arbitrario.

Si utilizas 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) El ID, tal como lo define el elemento <RatePlanID> en una el bloqueo <RoomBundle> del feed de precios. El <RatePlanID> representa el identificador único. para una combinación de datos de habitaciones y paquetes. Para ver más consulta Paquetes de habitación
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) El ID, según lo define el atributo rate_rule_id dentro de un el bloqueo <Rate> del feed de precios. Para obtener más información, consulta Tarifas condicionales.

Nota: Solo tarifas condicionales o privadas que no están ocultas.

USER-COUNTRY Recommended Una de dos letras código de país, que indica la ubicación del usuario. Esta se extrae la información de la configuración del cliente del usuario. Para Por ejemplo, US o FR.
USER-CURRENCY Recommended Un código de moneda de tres letras que indica la ubicación local del usuario moneda. El valor de la variable USER-CURRENCY es inferido 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 una de las siguientes opciones:
  • mobile
  • tablet
  • desktop
  • unknown

El valor de la variable USER-DEVICE se infiere de la la configuración del cliente del usuario.

USER-LANGUAGE Recommended Una de dos letras Código de idioma ISO 639-1 que especifica el idioma de visualización del o un vínculo gratuito para reservar. El valor de USER-LANGUAGE variable 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 el usuario información. Las listas de público se utilizan como base para configuración de la oferta ajustes. Si el usuario forma parte de varias listas de público, el se selecciona la lista de público con el ajuste de la oferta más grande. Empate entre públicos con el mayor ajuste de la oferta se deciden de forma aleatoria.
VERIFICATION Optional Un valor booleano que verifica si Google generó el vínculo para pruebas o validaciones automatizadas. Es true si se generó el vínculo. Google 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 lo siguiente: compilar extremos de forma condicional.

La lógica condicional admite las siguientes sentencias:

  • if_statement: Si es true, los valores que le siguen se insertan en la URL; de lo contrario, los valores después del Se insertó la directiva ELSE.

  • for_statement: Crea una condición de bucle FOR que itera. según 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ó de una conversión gratuita vínculo para reservar.
IF-CLICK-TYPE-HOTEL Optional Se resuelve como true si el usuario hace clic en una ficha de una hotel; de lo contrario, se resolverá como false.
IF-CLICK-TYPE-ROOM Optional Se resuelve como true si el valor El usuario hizo clic en un directorio de una Paquete de habitación; de lo contrario, se resolverá como false.
IF-CLOSE-RATE-RULE-IDS Optional Se resuelve como true si una o más tarifas condicionales fueron no disponible porque el usuario no era apto; de lo contrario, resuelve false De forma predeterminada, es truesi una tarifa privada El tratamiento de la IU se mostró al usuario.
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ó a partir de una de hotel; de lo contrario, se resuelve como false. Esta es útil para los socios que tienen varios tipos de campaña 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 pago por estadía (PPS). de comisiones, que se resuelve en false.
IF-PROMO-CODE Optional Se resuelve como true si el usuario hace clic en una tarifa que es de Se basan 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 Anuncios de hoteles) Recommended (if you use Promoted hotels) Se resuelve como true si el usuario hace clic en una propiedad. Anuncio promocional; de lo contrario, se resuelve como false.
IF-RATE-RULE-ID Optional Se resuelve como true si el usuario seleccionó un 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 una cuenta de Google Ads. ID de la lista de clientes que especificó al configurar los multiplicadores de ofertas para público de lista; 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 a esta 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. Para Por ejemplo, si <OccupancyDetails> incluye los dos los elementos <Child age="17"> y <Child age= "17">, y, luego, 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 vínculo gratuito para reservar que te redireccione 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 será el 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 El bloque <Room Bundle> de un mensaje Transaction se establecerá como el valor precio del paquete de habitación asociado 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 será el 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ó una sala Paquete.

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 será 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 sin fecha que su sitio web puede usarlo 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 predeterminada:

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 construir un bloque condicional que verifique si el usuario hizo clic en un anuncio que Se originó a partir de una campaña de hoteles.

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 siguiente URL:

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

Si el clic no se realiza 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. de otros clics.

ID de CAMPAÑA en blanco con clics del FBL

Si el clic proviene de un vínculo gratuito para reservar, se mostrará IF-HOTEL-CAMPAIGN. Los valores de TRUE y CAMPAIGN-ID se establecen 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 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 el resultado del programa de comisiones de PPS. El siguiente ejemplo verifica si un clic provino del programa de comisiones de PPS y asigna un valor a El parámetro booking_source en función del 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 uno de los siguientes URL:

  • Si no se asignó ningún número IATA a Google, haz lo siguiente:
    https://partner.com?hid=123&amp;booking_source=commissions
  • Si se asignó un número IATA a Google, haz lo siguiente:
    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 construir 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 siguiente URL:

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

Ejemplo IF-RATE-RULE-ID

Puedes construir un bloque condicional que verifique si el usuario seleccionó un tarifa condicional y, si ese es el caso, el valor de <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 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 hotel en Google Ads Puedes usar IF-USER-LIST-ID junto con USER-LIST-ID para establecer un parámetro de su sitio web para un cliente que pertenece a una cuenta de Google Ads determinada lista de público. Te recomendamos que lo hagas con fines de seguimiento o para personalizar tus sitio web para miembros de 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 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 automatización de 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 el siguiente URL:

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

Ejemplo de FOR-EACH-CHILD-AGE

Puedes construir un bloque condicional que complete la antigüedad máxima de cada uno ocupante 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 tiene 2 adultos y 2 niños de entre 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 el 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, si usas variables para pasar los datos de itinerario y usuario, información en general crea una mejor experiencia para el usuario y te ayuda a conforme a las políticas de Google.

Las siguientes reglas generales se aplican al definir las URLs construidas en una página de destino. Archivo de páginas:

  • 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 la resultado final. Dado que el signo et es un carácter especial en XML, y el 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 “&” real carácter. 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 debe codificar en formato URL los caracteres especiales que puede incluir en el URL de página de destino. Por ejemplo:

    • espacio (" "): Sustituye los caracteres de espacio por "%20;" en el elemento <URL>
    • barra diagonal ("/"): reemplaza las barras diagonales por "%2F;". por la <URL> elemento

    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 formato URL. Para obtener una lista de caracteres que deben estar codificados en formato URL, consulta Tabla de codificación de URLs.

  • Los valores para un solo parámetro se pueden construir a partir de múltiples variables. El El siguiente ejemplo construye un solo parámetro, checkinDate, a partir del 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 lista de variables disponibles.

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