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 cómo Google construye el vínculo para incluir todas 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 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 los siguientes ejemplos, se muestra una URL que usa los nombres de las variables de Google en lugar del ID y el itinerario reales del hotel:

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 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. Del mismo modo, el valor de la variable PARTNER-HOTEL-ID se define en el elemento <id> del feed de lista de hoteles que coincide 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 Cree la URL de su página de destino:

Lógica condicional en 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 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. según la cantidad de valores proporcionados.

Las instrucciones IF y FOR incluyen lo siguiente:

Ejemplo de IF-AD-CLICK

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 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 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 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 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 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 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 podría ser similar a la siguiente URL, según el itinerario que haya elegido:

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 una URL de 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 una URL de 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 de cualquier otro clic.

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 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 de Comisiones, el resultado es una de las siguientes URLs:

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

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

• Si se asignó un número IATA a Google, haz lo siguiente:

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

De lo contrario, el resultado es la siguiente URL:

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

Ejemplo IF-PROMOTED (solo para Anuncios de hoteles)

Puedes 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 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 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 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 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 automática, 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 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 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 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, 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.

Cuando se definen URLs construidas en una página de destino, se aplican las siguientes reglas generales. Archivo de páginas:

• 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 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 “&” 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 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 no alfabéticos deben estar codificados en formato URL. Por ejemplo, los guiones ("-") no necesitan estar codificados como URL. Para obtener una lista de caracteres que deben estar codificados en formato URL, consulta Codificación de URL.

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