Crear un archivo de fuente de propiedades XML (anteriormente fuente de hoteles)
Nota:
A partir del 9 de abril, ya no tendrá acceso completo al Hotel Center. Estamos deseando presentarle a Property Center, que proporcionará capacidades interesantes de autoservicio. Gracias por esperar pacientemente mientras actualizamos nuestro contenido de ayuda con las nuevas características. Mientras tanto, puede leer sobre estos próximos cambios y cómo facilitar el proceso de migración.
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í.
La fuente de propiedades y la documentación están sujetas a cambios.
Para proporcionar a Microsoft los listados de hoteles, cree un documento XML que contenga una lista de cada hotel que quiera anunciar. En una lista se describe el nombre, la dirección, el número de teléfono, las coordenadas geográficas, las comodidades y mucho más del hotel.
El documento debe usar la codificación UTF-8 y debe cumplir con el XSD de Hotel.
Para obtener información sobre cómo crear un archivo de fuente con formato de archivo CSV o TSV, consulte Creación de un archivo de fuente de propiedades CSV.
Nota:
Microsoft no admite todos los elementos XSD. Microsoft omite cualquier elemento o atributo del documento que no admita. La referencia de fuente de propiedades solo incluye los elementos y atributos compatibles con Microsoft.
Nota:
El documento debe especificar los elementos en el orden definido en hotel XSD (y como se muestra en la referencia).
Obtener los datos correctos
Dado que Microsoft intenta hacer coincidir las propiedades de la fuente de propiedades con las empresas de Mapas de Bing, es importante que los datos que proporcione sobre el hotel sean precisos y completos.
Si a un hotel le falta información o no es correcta, Es posible que Microsoft no pueda coincidir con ella. Si Microsoft no puede coincidir con el hotel, Microsoft no lo anunciará. Podrá ver un informe coincidente en el centro de hoteles que indica qué hoteles ha coincidido Microsoft o no. Si Microsoft no coincidía con el hotel, el informe incluye el mensaje No se puede hacer coincidir este hotel con una propiedad de Bing. Para obtener ayuda para mejorar la tasa de coincidencias, asegúrese de que están disponibles en lugares de Bing para empresas.
Elemento de nivel superior de la fuente
La fuente de propiedades contiene un único elemento de listados de nivel superior. El listings elemento contiene dos elementos secundarios necesarios: language y listing.
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<language>en</language>
<listing>
. . .
</listing>
...
</listings>
Nota:
Actualmente solo se admiten datos de fuente en inglés.
El language elemento especifica el idioma en el que se escriben los datos de la fuente. Para especificar el idioma, use el código de lenguaje ISO 639 de dos letras. Por ejemplo, use en para inglés.
El elemento de lista contiene información sobre el hotel, como su nombre, dirección y número de teléfono. Para obtener información sobre cómo definir un listado, consulte Definición de un listado de hoteles.
Definición de una lista de hoteles
El listing elemento define un hotel. Debe especificar un listing elemento para cada hotel que anuncie. En el ejemplo siguiente se muestran los elementos mínimos que debe especificar para una lista. La excepción es que puede especificar las coordenadas geográficas o un número de teléfono. Aunque puede especificar las coordenadas o el número de teléfono, debe especificar ambos para garantizar una mejor posibilidad de coincidencia de propiedades en Mapas de Bing.
<listing>
<id>abc123</id>
<name>Great Ambers Getaway</name>
<address>
<component name="addr1">1234 Porter Road</component>
<component name="city">Goldendale</component>
<component name="province">WA</component>
<component name="postal_code">98234</component>
</address>
<country>US</country>
<latitude>47.694351</latitude>
<longitude>-122.451782</longitude>
<phone type="main">123-456-7890</phone>
</listing>
El identificador del elemento está definido por el id usuario y debe ser único dentro de la fuente.
La dirección del address elemento es la dirección de la calle del hotel. La dirección debe ser una dirección postal y no una caja de correos. Puede especificar la dirección del hotel mediante el component elemento que se ve en el ejemplo anterior o mediante una cadena de forma libre que se muestra en el ejemplo siguiente. La preferencia es usar component elementos.
<address>1234 Porter Road, Goldendale, WA, 98234</address>
El latitude elemento y longitude especifica las coordenadas geográficas del hotel. Use una API de geocodificación como Location API para generar las coordenadas a partir de una dirección de calle.
El listado debe especificar al menos el número de teléfono principal del hotel. El número principal debe ser el número de teléfono de la recepción y no un número de teléfono central de reservas. Cuantos más números de teléfono de contacto proporciones mejor. En el ejemplo siguiente se muestran las otras opciones de teléfono.
<phone type="main">123-456-7890</phone>
<phone type="tollfree">800-456-7890</phone>
<phone type="fax">123-456-7890</phone>
<phone type="tdd">123-456-7890</phone>
<phone type="mobile">123-456-7890</phone>
Para obtener más información sobre cómo especificar números de teléfono, vea el elemento phone .
Especificación de campos de lista de hoteles opcionales
En el ejemplo siguiente se muestran los elementos opcionales que puede incluir en la lista. Aunque es opcional, debe incluir toda la información posible para admitir escenarios de uso actuales y futuros.
<listing>
. . .
<category>hotel | inn</category>
<content>
<text type="description">
<body>This element contains the hotel's description.</body>
</text>
<review type="user">
<body>This element contains a review of the hotel.</body>
<date month="2" day="24" year="2018" />
<link>https://contoso.com/reviews/hotels?id=sd87s90</link>
<rating>8.5</rating>
</review>
<attributes>
<website>https://contoso.com</website>
<attr name="air_conditioned">Yes</attr>
<attr name="has_airport_shuttle">Yes</attr>
<attr name="parking_type">No payment required</attr>
</attributes>
<image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
<date month="3" day="3" year="2018" />
<link>https://contoso.com/...</link>
<title>Hotel entrance</title>
</image>
<neighborhoods>
<neighborhood>Sodo District</neighborhood>
</neighborhoods>
<brand>Contoso</brand>
</content>
</listing>
El category formato esperado del elemento es vacation_rental o hotel seguido del carácter de canalización y un valor personalizado. Por ejemplo, vacation_rental | 'valor personalizado' o hotel | 'valor personalizado'
Para obtener una lista de valores personalizados, consulte Categorías de propiedades de hospedaje.
El text elemento contiene una descripción del hotel. Debe especificar el body elemento , que contiene la descripción real. En función de la longitud de la descripción, se puede truncar cuando se muestra. Si incluye los link elementos y title , la dirección URL del vínculo apunta a la descripción en línea.
El review elemento contiene una revisión de usuario o una revisión editorial. Una revisión editorial es una revisión profesional realizada por una autoridad de revisión, como un bloguero de viajes. Puede incluir cualquier número de opiniones, pero en función del número de opiniones enviadas, es posible que no se muestren todas. Debe especificar el body elemento , que contiene la revisión. Dependiendo de la longitud de la revisión, se puede truncar cuando se muestra. Si incluye el link elemento, apunta a la lista completa de revisiones en línea.
El attributes elemento contiene una lista de servicios que ofrece el hotel, como aire acondicionado, piscina y desayuno gratuito. Para obtener una lista de las posibles comodidades, consulte Atributo. Si no especifica un servicio, se supone que el hotel no lo proporciona.
El image elemento contiene una imagen del hotel. Puede incluir cualquier número de imágenes, pero en función del número de imágenes enviadas, es posible que no se muestren todas. La ración de aspecto recomendada es 4:3 y el ancho mínimo es de 720 píxeles. Las imágenes deben ser fotografías originales y pueden no ser capturas de pantalla. Tenga en cuenta que el rastreador AdIdxBot debe tener acceso a la link dirección URL. Si el sitio incluye el archivo robots.txt, debe incluir:
- Agente de usuario: AdIdxBot
- Conceder:/
El neighborhood elemento identifica el barrio donde se encuentra el hotel. Puede especificar varios vecindarios si el hotel está ubicado en el centro de varios vecindarios.
El brand elemento identifica la marca del hotel. Por ejemplo, Fabrikam Residences by Contoso, donde Contoso es la marca.
¿Qué ocurre si cambia el contenido del hotel?
Si cambia cualquiera de los valores de propiedad del hotel entre las ejecuciones de fuentes (por ejemplo, su nombre, dirección, teléfono, etc.), Microsoft Advertising puede tratarla como una nueva propiedad de hotel y crear una nueva lista para ella. Si Microsoft crea una nueva lista, el historial de rendimiento anterior del hotel antiguo permanece disponible hasta 36 meses. Tenga en cuenta que las pujas y multiplicadores del antiguo hotel no se transferirán a la nueva entidad hotelera.
Si quita un hotel y lo agrega de nuevo en una fuente posterior con los mismos valores de propiedad que antes, Microsoft lo trata como una nueva lista. Además, el informe de rendimiento lo mostrará como dos listas independientes.
Reglas generales
Use el XSD de Hotel para validar el archivo de fuente de propiedades antes de enviarlo a Microsoft.
El documento de fuente de propiedades debe usar la codificación UTF-8.
La fuente debe incluir listados para todos los hoteles; el proceso de fuente no admite actualizaciones parciales.
Microsoft omite cualquier elemento o atributo que no admita.
Los elementos deben estar en el orden especificado en el XSD del hotel.
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 las coordenadas geográficas de un hotel, no incluya elementos de latitud> y <longitud> vacíos<.
No use HTML en los elementos XML.
Pasos siguientes
Después de crear el archivo de fuente, use el XSD de Hotel para validarlo.
Pida al administrador de cuentas que importe el archivo de fuente.
Asegúrese de importar también los datos de las páginas de aterrizaje. Para obtener información sobre cómo crear el archivo de fuente de páginas de aterrizaje, consulte Fuente de páginas de aterrizaje.
Después de que Microsoft importe correctamente los datos y pueda hacer coincidir sus hoteles con propiedades en Mapas de Bing, puede empezar a enviar los datos de precios y disponibilidad del hotel. Para obtener información, consulte Fuentes de precios.