Compartir a través de

Crear una fuente de páginas de aterrizaje (anteriormente fuente de puntos de venta (POS)

  • Artículo

Nota:

Esta versión beta de Hotel Price Ads solo está disponible para seleccionar participantes. Para obtener información sobre cómo participar en el programa de versión beta, póngase en contacto con el administrador de cuentas o inscríbase aquí.

Para proporcionar a Bing los datos de las páginas de aterrizaje, cree un documento XML que contenga un punto de venta (POS) para cada sitio de reserva que admita. Un POS describe el nombre para mostrar, la dirección URL y los criterios del POS para hacer coincidir al usuario con un PDV.

El documento debe usar la codificación UTF-8 y debe cumplir con pointsofsale XSD.

Nota:

Bing no admite todos los elementos XSD. Bing omite cualquier elemento o atributo del documento que no admita. La referencia de las páginas de aterrizaje solo incluye los elementos y atributos compatibles con Bing.

Nota:

El documento debe especificar los elementos en el orden definido en pointsofsale XSD (o como se muestra en la referencia).

Elemento de nivel superior de la fuente

La fuente de páginas de aterrizaje contiene un único elemento PointsOfSale de nivel superior. El PointsOfSale elemento requiere un elemento secundario PointOfSale para cada sitio que los usuarios pueden usar para reservar una habitación.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <PointOfSale>
    . . .
  </PointOfSale>
  ...
</PointsOfSale>

El PointOfSale elemento describe el nombre para mostrar, la dirección URL y los criterios del PDV para hacer coincidir al usuario con un PDV. Para obtener información sobre cómo definir un PUNTO de venta, consulte Definición de un punto de venta.

Definición de un punto de venta

El PointsOfSale elemento contiene una lista de elementos PointOfSale , uno para cada sitio de PDV que los usuarios pueden usar para reservar salas. La lista debe contener páginas de aterrizaje para un único asociado.

A continuación se muestran PointOfSale los elementos que definen las páginas de aterrizaje para los usuarios de habla inglesa. El primer PointOfSale elemento define un PDV para los usuarios finales de habla inglesa en cualquier dispositivo y el segundo PointOfSale elemento define un POS para los usuarios finales de habla inglesa en dispositivos móviles. La dirección URL del PDV incluye detalles sobre la transacción, como las fechas de registro y de salida, el identificador de hotel y el idioma del usuario. Bing usa el nombre para mostrar y la dirección URL de POS para crear un hipervínculo que se agrega al anuncio. Cuando el usuario hace clic en el vínculo, se le lleva al sitio de reserva. Si usa plantillas de seguimiento para el seguimiento del rendimiento, el elemento LPURL url de la página de aterrizaje debe configurarse en el archivo de fuente del PDV para que el seguimiento funcione. Bing usa el nombre para mostrar y la dirección URL de POS o LPURL para crear un hipervínculo que se agrega al anuncio. Cuando el usuario hace clic en el vínculo, se le lleva al sitio de reserva.

  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>

Incluya el DisplayNames elemento solo para las agencias de viajes en línea. No incluya DisplayNames para proveedores del sistema central de reservas (CRS) (también conocidos como asociados de integración) y proveedores directos (como propietarios de hoteles o cadenas). Para proveedores de CRS y proveedores directos, Bing usa el nombre del hotel en la fuente de propiedades.

Si incluye DisplayNames, debe incluir un Match elemento que tenga el criterio de idioma establecido en el mismo idioma.

Bing usa el PDV que mejor coincide con el usuario en función de los criterios de coincidencia del PDV. En función de los criterios de coincidencia anteriores, los usuarios de dispositivos móviles usarán el pos de English-Mobile y todos los demás usarán el PDV en inglés. Para obtener información sobre cómo Bing coincide con los usuarios con un POS, consulte Páginas de aterrizaje coincidentes. Para obtener una lista de criterios en los que puede coincidir, vea el elemento Match .

El URL elemento especifica el vínculo al sitio donde el usuario puede reservar la sala. En el ejemplo se muestra el uso de parámetros de consulta dinámica. Bing sustituye los valores de las variables dinámicas en tiempo de ejecución. Para obtener información sobre el uso de parámetros de consulta dinámicos, consulte Uso de parámetros de consulta dinámica.

Nota:

Si especifica el criterio de coincidencia de idioma y país, deben establecerse solo en y EN .

A continuación se muestra un documento XML de páginas de aterrizaje completo.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
</PointsOfSale>

Páginas de aterrizaje coincidentes

Las páginas de aterrizaje incluyen un Match elemento que contiene los criterios que Bing usa para hacer coincidir un usuario con un PDV. A continuación se indica el criterio que Usa Bing para hacer coincidir los usuarios con las páginas de aterrizaje. La lista está en orden de preferencia.

  • country
  • divisa
  • language
  • dispositivo
  • sitetype

Bing usa las siguientes reglas para buscar la mejor coincidencia de POS.

  • Bing da la mayor preferencia a las coincidencias de país y la menor preferencia a las coincidencias de dispositivo.

  • Si Match no especifica uno de los criterios, Bing coincide implícitamente con todos los valores del criterio. Por ejemplo, si Match especifica el idioma y la moneda, Bing coincide implícitamente con cualquier país y dispositivo.

  • Si Match especifica uno o varios criterios, Bing usa el POS con las coincidencias más explícitas.

  • Si el usuario coincide con varias páginas de aterrizaje, Bing usa el PDV con la mejor calidad de coincidencia. Si varias páginas de aterrizaje tienen la misma calidad de coincidencia, Bing usa el primer POS que encontró con esa calidad de coincidencia. La calidad de la coincidencia se basa en:

    • Coincide con la preferencia más alta. Por ejemplo, si un POS solo coincide con la moneda del usuario y otro solo coincide con el dispositivo del usuario, Bing usa el POS que coincide con la moneda del usuario porque es mayor en el orden preferido.
    • Las coincidencias explícitas se prefieren sobre las coincidencias implícitas. Por ejemplo, si un PDV coincide explícitamente con el país del usuario y otro coincide implícitamente con el país del usuario, Bing usa el PDV que coincide explícitamente.

El Match atributo de estado del elemento determina si se debe incluir o excluir el POS en función de la coincidencia. Si el estado nunca es y Bing coincide con todos los criterios, Bing no usará el PDV. Para excluir un POS, todos los criterios deben coincidir. En el ejemplo siguiente, Bing excluye explícitamente el PDV si el usuario es de Estados Unidos o Francia, e lo incluye implícitamente si el usuario es de cualquier otro país.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='never' country='US' />
  <Match status='never' country='FR' />
  . . .
</PointOfSale>

Si el estado es sí, Bing no eliminará ninguna página de aterrizaje de consideración que no coincida explícitamente con todos los criterios, pero se dará preferencia al PDV que coincida con el criterio más importante. En el ejemplo siguiente, Bing coincide explícitamente con el usuario con el PDV si el país del usuario es Francia. Si el país del usuario no es Francia, el PDV se seguirá teniendo en cuenta hasta que se encuentre una mejor coincidencia. Si no se encuentra una mejor coincidencia, Bing usará el PDV.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='yes' country='FR' />
  . . .
</PointOfSale>

Bing recomienda usar los mismos criterios de coincidencia para cada PDV. Esto minimiza la complejidad a la hora de determinar por qué un POS coincidió con otro.

Uso de parámetros de consulta dinámica

Un punto de venta (POS) contiene un URL elemento que identifica el sitio donde los usuarios pueden reservar salas. La dirección URL puede contener parámetros de consulta dinámicos, que son parámetros definidos por el usuario que contienen un token predefinido para su valor. A continuación, Bing sustituye el token por un valor antes de agregar la dirección URL al anuncio. Mediante el uso de parámetros de consulta dinámica, puede incluir el identificador del hotel, la fecha de registro, la duración de la estancia y mucho más en la dirección URL.

A continuación se muestra la sintaxis que se usa para especificar parámetros de consulta dinámicos en la dirección URL del PDV. Dado que los parámetros de consulta dinámica son parámetros de consulta, deben seguir el símbolo de signo de interrogación (?) en la dirección URL.

http://domain.com/path?param-name=(dynamic-variable-name)

A continuación se muestran los posibles nombres de variables dinámicas que distinguen mayúsculas de minúsculas que puede especificar en la dirección URL.

Nombre Descripción
ADGROUP-ID Identificador del grupo de anuncios que desencadenó el anuncio. Por ejemplo, supongamos que la dirección URL es www.northwindtraders.com/(ADGROUP-ID). Suponiendo que el identificador del grupo de anuncios está 2410012280, la dirección URL de la página de aterrizaje del anuncio será www.northwindtraders.com/2410012280.
ADVANCE-BOOKING-WINDOW Número de días antes de la fecha de registro de entrada que se realizó la reserva. Por ejemplo, 36.
BING-SITE Propiedad de Bing que originó la solicitud de anuncio. A continuación se muestran los valores posibles.
  • localuniversal: el anuncio se originó en una página de resultados de búsqueda.
  • mapresults: el anuncio se originó en un sitio de mapas.
  • PropertyPromotionAd: el anuncio se originó en la primera página de resultados que se muestra en una búsqueda de mapas.
  • unknown: el anuncio se originó en una fuente no determinada.
  • verificación: Bing usa este valor al realizar pruebas de calidad de datos en el sitio. No se le facturará por estas consultas. Bing Analytics usa este parámetro y su valor para identificar el tráfico de verificación de Hotel Price Ads.
IDENTIFICADOR DE CAMPAÑA Identificador de la campaña que desencadenó el anuncio. Por ejemplo, supongamos que la dirección URL es www.northwindtraders.com/(CAMPAIGN-ID). Suponiendo que el identificador de la campaña esté 2410012280, la dirección URL de la página de aterrizaje del anuncio será www.northwindtraders.com/2410012280.
CHECKINDAY Día de dos dígitos especificado en el Checkin elemento de la fuente Price. Por ejemplo, 20.
CHECKINDAY-OF-WEEK El día de la semana en que se realiza el registro de entrada. Bing usa dígitos del 0 al 6 para representar de lunes a domingo. Por ejemplo, 1 es martes.
CHECKINMONTH Mes de dos dígitos especificado en el Checkin elemento de la fuente Price. Bing usa dígitos del 00 al 11 para representar de enero a diciembre. Por ejemplo, 05 es junio.
CHECKINYEAR Año de cuatro dígitos especificado en el Checkin elemento de la fuente Price. Por ejemplo, 2021.
CHECKOUTDAY El día de dos dígitos que el usuario comprueba. Bing usa los Nights elementos y Checkin de TransactionMessage para calcular el día. Por ejemplo, 23.
CHECKOUTMONTH Mes de dos dígitos que el usuario comprueba. Bing usa los Nights elementos y Checkin de la fuente Price para calcular el mes. Por ejemplo, 07.
CHECKOUTYEAR Año de cuatro dígitos que el usuario comprueba. Bing usa los Nights elementos y Checkin de la fuente Precio para calcular el año. Por ejemplo, 2021.
CLICK-TYPE Indica si el usuario ha hecho clic en un anuncio de hotel o en un anuncio de paquete de habitación. A continuación se muestran los valores posibles.
  • hotel: el usuario ha hecho clic en un anuncio de hotel.
  • room: el usuario ha hecho clic en un anuncio de paquete de sala.
NOTA: Bing no admite la opción de sala.
CUSTOM[1-5] Valores de los campos personalizados (por ejemplo, Custom1) especificados en el elemento Result de la fuente Price.
DATE-TYPE Indica si el usuario especificó las fechas de check-in y check-out. A continuación se muestran los valores posibles.
  • default: el usuario ha hecho clic en un anuncio de hotel que usaba fechas predeterminadas.
  • seleccionado: el usuario ha hecho clic en un anuncio de hotel con fechas de check-in y check-out específicas.
HOTELGROUP_ID Nota: HOTELGROUP_ID es un parámetro heredado que hace referencia a Hotel Center. Use ADGROUP-ID en su lugar.

El identificador del grupo hotelero al que pertenece el anuncio del hotel.
LARGURA Longitud de la estancia especificada en el Nights elemento de la fuente Price. Por ejemplo, 3.
NETWORK Tipo de red de anuncios en el que se ha servido el anuncio.
  • o = propiedad y operación (bing, AOL y resultados de búsqueda de Yahoo)
  • s = sindicado (resultados del sitio del asociado de búsqueda)
  • a = audiencia (ubicaciones de Microsoft Audience Network)
Por ejemplo, supongamos que la dirección URL es www.northwindtraders.com/network=(NETWORK). Suponiendo que la red (distribución de anuncios) solo es Bing, AOL y Yahoo search (propiedad y operada), la dirección URL de la página de aterrizaje del anuncio será www.northwindtraders.com/network=o.
NUM-ADULTS El número de adultos que ocupan la habitación. El valor predeterminado es 2.
PARTNER-CURRENCY Código de moneda de tres letras especificado en el atributo currency del Baserate elemento en la fuente Price. Por ejemplo, USD.
PARTNER-HOTEL-ID Id. del hotel especificado en el id elemento de la fuente Property.
PARTNER-ROOM-ID Identificador que identifica de forma única la sala. Este es el identificador especificado en <el elemento RoomID> del <bloque Result>, <RoomBundle> o <RoomData> , en función del uso.
PRICE-DISPLAYED-TAX Importe de impuestos en la moneda local del usuario. El importe de impuestos se basa en el Tax elemento especificado en la fuente precio. Por ejemplo, 3.14.
PRICE-DISPLAYED-TOTAL El costo total de la habitación en la moneda local del usuario. El importe se basa en la suma de los Baserateelementos , Taxy OtherFees especificados en la fuente Precio. Por ejemplo, 152.13.
SLOT_TYPE Ubicación del anuncio en la página de resultados. El parámetro puede contener los siguientes valores posibles:
  • R: la ranura de prioridad donde los anuncios se muestran en la página de resultados cuando se cargan.
  • B: la ranura secundaria donde los anuncios se muestran solo después de que el usuario haga clic en Más tasas.
SUBACCOUNT_ID Nota: SUBACCOUNT_ID es un paramater heredado que hace referencia a Hotel Center. Use CAMPAIGN-ID en su lugar.

El identificador de la subcuenta a la que pertenece la campaña de anuncios de precios del hotel.
PAÍS DEL USUARIO Código de país de dos letras del país donde se encuentra el usuario. El valor se extrae de la configuración de cliente del usuario final. Por ejemplo, EE. UU.
MONEDA DEL USUARIO Código de moneda de tres letras de la moneda local utilizada por el usuario. El valor se deduce de la configuración de cliente del usuario final. Por ejemplo, USD.
USER-DEVICE Tipo de dispositivo del usuario final. A continuación se muestran los valores posibles.
  • móvil
  • tableta
  • escritorio
  • desconocido
El valor se deduce de la configuración de cliente del usuario final.
IDIOMA DEL USUARIO Código de idioma de dos letras que especifica el idioma para mostrar del anuncio. El valor se deduce de la configuración de cliente del usuario final. Por ejemplo, en.
VERIFICACIÓN Boolean que indica si Bing generó el vínculo. Si Bing generó el vínculo, el valor es true. De lo contrario, false.

Todas las fechas, como CHECKINDAY, se encuentran en la zona horaria del hotel.

A continuación se muestra una dirección URL de ejemplo que contiene parámetros de consulta dinámica y entidades codificadas.

<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Antes de que Bing use la dirección URL en el anuncio, sustituye los valores por los nombres de variables dinámicas. Por ejemplo, si el usuario reserva una habitación durante 6 noches a partir del 7/6/2021 para el hotel 42, Bing representa la dirección URL como:

http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6

Bing obtiene valores para los parámetros dinámicos de la fuente de precios y la fuente de propiedades, así como la configuración específica del usuario. Por ejemplo, el valor de la variable LENGTH procede del Nights elemento de la fuente Price y el valor de la variable PARTNER-HOTEL-ID procede del id elemento de la fuente Property.

Algunas variables son subconjuntos de elementos de fuente price. Por ejemplo, las variables CHECKINDAY, CHECKINMONTH y CHECKINYEAR se extraen del Checkin elemento . Otras variables se calculan en función de la configuración regional del usuario y de otras configuraciones de cliente.

Reglas de dirección URL generales

Las siguientes son reglas generales que se deben seguir al usar variables dinámicas.

  • Todos los parámetros dinámicos son opcionales. No es necesario insertar ningún parámetro dinámico en la dirección URL de POS. Sin embargo, el uso de variables para pasar información específica del itinerario y del usuario generalmente crea una mejor experiencia para el usuario final.

  • Envuelve los nombres de variables dinámicas con paréntesis abiertos y cerrados.

  • Use entidades codificadas para caracteres especiales. Por ejemplo, reemplace las y comercial (&) por &, el espacio por %20 y la barra diagonal (/) por %2F.

  • Los valores de un solo parámetro se pueden construir a partir de varias variables. Por ejemplo, puede construir el valor de un parámetro de consulta checkinDate a partir de las variables CHECKINDAY, CHECKINMONTH y CHECKINYEAR.

    <URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

  • En el caso de las variables dinámicas que Bing reconoció pero no admite, Bing reemplaza la cadena de variable por una cadena vacía.

  • Dado que los parámetros de consulta dinámica son parámetros de consulta, deben seguir el símbolo de signo de interrogación (?) en la dirección URL.

Uso de directivas condicionales

Además de las variables enumeradas anteriormente, también puede usar las siguientes directivas para crear lógica condicional.

  • IF-DEFAULT-DATE: se resuelve en true si el usuario hizo clic en un anuncio de hotel que usaba fechas predeterminadas (el usuario no seleccionó las fechas). Si es true, Bing inserta los valores que siguen esta directiva en la dirección URL. De lo contrario, Bing inserta los valores siguientes a la directiva ELSE.

  • ELSE: si no se cumple la condición anterior, Bing inserta los valores que siguen esta directiva.

  • ENDIF: finaliza el bloque condicional.

Por ejemplo, la siguiente dirección URL establece el parámetro de consulta popup_datepicker en true si el usuario usó fechas predeterminadas en lugar de especificar fechas.

<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)
&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)
&amp;popup_datepicker=false(ENDIF)</URL>

Si es true, Bing representa la dirección URL como:

http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true

De lo contrario, Bing representa la dirección URL como:

http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false

Reglas generales

  • Use pointsOfSale XSD para validar el archivo de fuente de páginas de aterrizaje antes de enviarlo a Bing.

  • El documento de fuente de páginas de aterrizaje debe usar la codificación UTF-8.

  • La fuente debe incluir páginas de aterrizaje para todos los sitios que los usuarios usan para reservar salas; el proceso de fuente no admite actualizaciones parciales.

  • Bing omite cualquier elemento o atributo que no admita.

  • Los elementos deben estar en el orden especificado en pointsofsale XSD.

  • Si los datos incluyen caracteres especiales como apóstrofos o comillas, escútelos o use secciones CDATA. Si se les escapa, puede usar códigos de entidad o códigos de caracteres. Por ejemplo, puede escapar de Paul como Paul' s o Paul's.

  • No incluya elementos que no contengan datos. Por ejemplo, si no proporciona un nombre para mostrar para un hotel, no incluya un elemento DisplayNames> vacío<.

  • No use HTML en los elementos XML.

Pasos siguientes

Después de crear el archivo de fuente, use el XSD PointsOfSale para validarlo.

Pida al administrador de cuentas que importe el archivo de fuente.

Asegúrese de importar también los datos del hotel. Para obtener información sobre cómo crear el archivo de fuente de propiedades, consulte Fuente de propiedades (anteriormente Fuente de hoteles).

Después de importar correctamente la fuente de páginas de aterrizaje y la fuente de propiedades, puede empezar a enviar los datos de precios y disponibilidad del hotel. Para obtener información, consulte Fuentes de precios.