Variables y condiciones

Los anuncios de hoteles y los vínculos gratuitos para reservar incluyen vínculos a páginas de destino en las que los usuarios pueden reservar habitaciones. Puedes definir la forma en que Google construye el vínculo para que incluya toda la información adicional sobre el usuario y su itinerario. Por ejemplo, puedes incluir información como el ID del hotel, el idioma, los códigos de moneda y las fechas de entrada en la URL.

Descripción general

La URL de página de destino se define en el archivo de páginas de destino. Cuando se muestra el anuncio o el vínculo gratuito para reservar, la información dinámica de la URL se reemplaza por valores reales. Para agregar valores dinámicos a las URLs de 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 del ID de 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 por 6 noches a partir del 23/5/2023 en el hotel núm. 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 la 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 en función de 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:

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 instrucciones:

• 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:

Ejemplo de IF-AD-CLICK

Puedes crear un bloque condicional que verifique si el usuario hizo clic en un anuncio o en un vínculo gratuito para reservar y, luego, 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 Transaction se establecerá en el precio del paquete de habitaciones asociado de forma implícita que el usuario había 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 seleccionó un paquete de habitación, el resultado es la siguiente URL:

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

Si el usuario no seleccionó un paquete de habitaciones, el resultado es la siguiente URL:

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

Ejemplo de IF-CLICK-TYPE-ROOM

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

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

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

En este ejemplo, si el usuario no seleccionó un paquete de habitaciones, el resultado es la siguiente URL:

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

Si el usuario seleccionó un paquete de habitación, el resultado es la siguiente URL:

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

Ejemplo de IF-DEFAULT-DATE

Usa la instrucción 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)<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 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 hoteles y vínculos gratuitos para reservar)

Puedes crear un bloque condicional que verifique si el usuario hizo clic en un anuncio que se originó en una campaña de hotel.

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

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

En este ejemplo, si el usuario hace clic en una 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 realiza en una 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 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 instrucción condicional IF-AD-CLICK para evitar que el ID de la campaña esté en blanco, como se muestra en el siguiente ejemplo:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Ejemplo de IF-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 la 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 la propiedad, 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 es así, 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 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 pertenezca a una determinada lista de público de Google Ads. Es posible que desees hacerlo para realizar un seguimiento o 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 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 la prueba o la validación, el resultado es la siguiente URL:

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

Si Google generó la URL para la prueba o la 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 menor que ocupa la habitación, 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 tenía 2 adultos y 0 niños, el resultado es la siguiente URL:

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

Reglas generales para crear URLs

Todas las variables son opcionales. No es necesario que insertes ninguna variable en la URL de tu página de destino. Sin embargo, usar variables para pasar información del itinerario y del usuario generalmente crea 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 creadas en un archivo de páginas de destino:

• Todas las variables están entre paréntesis de apertura y cierre.

• Los parámetros de la cadena de consulta deben separarse con un signo de unión (“&”) en el resultado final. Esto se debe a que el signo et es un carácter especial en XML y el formato del archivo de páginas de destino es XML. Por lo tanto, debes usar la entidad codificada "&" en su lugar. La salida 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 incluyas 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 como URL. Por ejemplo, los guiones ("-") no necesitan codificarse como URL. Para obtener una lista de los caracteres comunes que deben codificarse como 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.