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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)
</URL>
Ejemplo 2
<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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:
| 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. 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 | Es el ID de la campaña de Google Ads que deseas asociar con la URL. Aparece 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 | 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 | 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 que se calcula 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 que se calcula a partir de los elementos <Nights> y <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 niño o niña, 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 con índice 0 que representa un contador para cada ocupante infantil y la edad infantil especificada en el itinerario. Si bien no es obligatoria, 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 para obtener una tarifa estándar del hotel o un paquete de habitaciones. Los valores posibles son los siguientes:
|
| CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | Una lista separada por comas de los IDs de las 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 de tarifas privadas siempre se propagan aquí cuando se muestra el tratamiento de IU correspondiente para el usuario. |
| CUSTOM[1-5] | Optional | 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 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
la fecha indicada en la búsqueda. Los valores posibles son los siguientes:
|
| GOOGLE-ADS-CLICK-SOURCE | Optional | Indica que Google Ads fue la fuente del clic. Los valores posibles son los siguientes:
Nota: Si el clic se originó en la Búsqueda de Google en lugar de en 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:
|
| 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. |
| 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 | Es la cantidad de ocupantes menores de edad (de 0 a 17 años) que el usuario especifica en el itinerario. 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 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. Para un
Paquete estándar, el ID del paquete es el valor del
Elemento <PackageID> en un <Result>
bloque. 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 | 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 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. Para una habitación estándar, el ID de la habitación es un valor del elemento <RoomID> dentro del bloque <Result>. 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 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 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) | El costo total de la habitación que se muestra al usuario en la
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
ARI
promociones, el valor de esta variable se asigna al atributo Si utilizas
reglas de tarifas, el valor de esta variable se asigna al elemento |
| 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 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 que define el atributo rate_rule_id dentro del bloque <Rate> de un feed de precios. Para obtener más información,
consulta
Tarifas condicionales.
Nota: Solo se muestran las 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 información se extrae de la configuración del cliente del usuario. Por ejemplo, US o FR. |
| USER-CURRENCY | Recommended | Un código de moneda de tres letras que indica la moneda local del usuario. 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 | Es el tipo de dispositivo del usuario. El valor de USER-DEVICE puede ser uno de los siguientes:
El valor de la variable |
| USER-LANGUAGE | Recommended | 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 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 la información del 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, el se selecciona la lista de público con el ajuste de la oferta más grande. 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 pruebas o validación automatizada. Es true si se generó el vínculo.
por Google para pruebas o validación automatizada; de lo contrario, será false.
|
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 directivaELSE.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 en false si el clic del usuario se originó en un vínculo gratuito para reservar. |
| IF-CLICK-TYPE-HOTEL | Optional | Se resuelve en true si el usuario hizo clic en una ficha de un hotel; de lo contrario, se resuelve en false. |
| IF-CLICK-TYPE-ROOM | Optional | Se resuelve en true si el usuario hizo clic en una ficha de un paquete de habitaciones; de lo contrario, se resuelve en 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 en true si el usuario hizo clic en una ficha de hotel en la que se usaron fechas predeterminadas; de lo contrario, se resuelve en 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 programa de comisiones de pago por estadía (PPS). De lo contrario, se resuelve como false. |
| IF-PROMO-CODE | Optional | Se resuelve en 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 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 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. 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 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)&adType=1(ELSE)&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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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)&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)&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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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)&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.
- espacio (" "): Reemplaza los caracteres de espacio por "%20;" en el elemento
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 variablesCHECKINDAY,CHECKINMONTHyCHECKINYEAR:<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/1971Puedes 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.