Leer en inglés

Compartir a través de


Creación de un archivo de fuente de propiedades CSV

Para proporcionar a Microsoft los listados de hoteles, cree un archivo CSV 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 y las coordenadas geográficas del hotel.

Para obtener información sobre cómo crear un archivo de fuente mediante un documento XML, consulte Creación de un archivo de fuente de propiedades XML.

Nota

La fuente de propiedades solo admite el idioma inglés.

El formato CSV no admite imágenes. En su lugar, use el formato XML.

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 su hotel no tiene 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á. Después de que el TAM importe el archivo de fuente de propiedades, le enviarán un informe que indica qué hoteles microsoft coincidió 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, trabaje con su TAM.

Definición de una lista de hoteles

La primera línea del archivo de fuente es la fila de encabezado, que contiene los nombres de columna de los datos del hotel en la fuente. El encabezado debe incluir los nombres de columna de todos los elementos de datos necesarios. Incluya solo los nombres de las columnas opcionales si proporciona datos para ellas.

A continuación se muestra la lista de columnas que puede incluir en la fuente. El archivo de fuente puede contener las columnas en cualquier orden y los nombres de columna no distinguen mayúsculas de minúsculas.

Nombre de columna Descripción Tipo de datos Obligatorio
id Un identificador opaco definido por el usuario que identifica de forma única el hotel dentro de la fuente.

Cuando cree su fuente de precios, use este identificador en el elemento de su Property fuente de precios para identificar el hotel.
Cadena
name El nombre del hotel. El nombre puede contener un máximo de 200 caracteres. Cadena
address La dirección callejera del hotel con texto de forma libre. Separe cada componente de la dirección con una coma y incluya la dirección entre comillas. Por ejemplo, "1234 Billings Way, Redmond, WA, 98030".

Use esta columna solo si proporciona la dirección mediante texto de forma libre; De lo contrario, use las columnas del componente de dirección, como addr1, ciudad y provincia. Es preferible usar las columnas de componente de dirección en lugar de usar texto de forma libre.
Cadena
addr1 La dirección del hotel. Por ejemplo, 1234 Billings Way. La dirección debe ser una dirección postal física y no una postal u otra dirección de solo correo. Cadena
addr2 Segunda línea de dirección de la calle. Cadena No
addr3 Tercera línea de dirección. Cadena No
city El nombre de la ciudad donde se encuentra el hotel. Cadena
provincia Nombre del estado, región o provincia donde se encuentra el hotel. Cadena
postal_code Código postal de la dirección. Cadena
country País o región donde se encuentra el hotel. Especifique el país o región mediante el código de país ISO 3116 de dos letras. Por ejemplo, use EE. UU. para Estados Unidos. Cadena
latitude Latitud de las coordenadas geográficas del hotel.

Notas:
  • La latitud y la longitud solo son necesarias si no se especifica phone. Es preferible especificar tanto las coordenadas telefónicas como geográficas.
  • La latitud debe estar entre -90,0 y 90,0.
  • Use Location API u otra herramienta geocodificación para generar las coordenadas a partir de una dirección de calle.
Decimal No
longitude Longitud de las coordenadas geográficas del hotel.

Notas:
  • La latitud y la longitud solo son necesarias si no se especifica phone. Es preferible especificar tanto las coordenadas telefónicas como geográficas.
  • La longitud debe estar en el intervalo de -180,0 a 180,0.
  • Use Location API u otra herramienta geocodificación para generar las coordenadas a partir de una dirección de calle.
Decimal No
phone El número de teléfono de voz principal que los clientes usan para ponerse en contacto con el hotel. El número debe ser el número de teléfono de la recepción y no un número de teléfono de reserva central.

Notas:
  • Use guiones, espacios o paréntesis en el número de teléfono para facilitar la lectura. Por ejemplo, use "610-222-3333" o "(610) 222-3333" en lugar de "6102223333".
  • Especifique solo un número de teléfono; no especifique varios números, como 650-123-2222/33.
  • El número de teléfono puede contener una extensión de hasta 7 dígitos. Preceda las extensiones con una de las abreviaturas siguientes: "ext", "extn" y "x". Por ejemplo, "408-555-1111x12345" o "408-555-1111 x12345".
  • Es posible que el número de teléfono no incluya caracteres alfabéticos.
  • Si el número de teléfono incluye el código de país, preceda a "+". Por ejemplo, "+65 6722-2323" para un número en Singapur donde el código de país es 65, o "+001 (408) 555-1111" para un número en el Estados Unidos donde el código de país es 001.
Cadena
categoría Categoría que identifica el tipo de hotel. El formato esperado 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.
Cadena No
hotel_brand La marca de la cadena hotelera. Por ejemplo, Fabrikam Residences by Contoso, donde Contoso es la marca. Cadena No
star_rating La clasificación star del hotel. Los valores posibles son de 1 a 5. Cadena No

Nota

Las address columnas , addr, addr2, addr3city, province, y postal_code son mutuamente excluyentes. Especifique la address columna o las columnas del componente de dirección. Se prefiere especificar las columnas del componente de dirección.

Aunque puede especificar coordenadas geográficas o un número de teléfono, debe especificar ambos para garantizar una mejor posibilidad de coincidencia de propiedades en Mapas de Bing.

Para incluir una descripción, imágenes y revisiones para una lista, use un archivo de fuente XML. Consulte Creación de un archivo de fuente de propiedades XML.

A continuación se muestra un encabezado de ejemplo en formato CSV. Separe todas las columnas con una coma. Incluya solo columnas que contengan valores para al menos un hotel.

id,name,addr1,city,province,postal_code,country,phone

Después de la fila de encabezado, incluya una fila para cada hotel que anuncie. La fuente debe incluir listados para todos los hoteles; el proceso de fuente no admite actualizaciones parciales. No incluya filas en blanco en la fuente.

Si un valor contiene una coma, debe rodear el valor entre comillas. A continuación se muestra el contenido de un archivo CSV de ejemplo.

id,name,addr1,city,province,postal_code,country,latitude,longitude,phone
abc123,Great Ambers Getaway,1234 Porter Rd,Goldendale,WA,98234,US,47.694351,-122.451782,123-456-7890

¿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.

Pasos siguientes

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 sus 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.