Criar um ficheiro CSV Hotel Feed
Nota
Esta versão beta do Hotel Price Ads está disponível apenas para participantes selecionados. Para obter informações sobre como participar no programa de versão beta, contacte o seu gestor de conta ou inscreva-se aqui.
O feed e a documentação do Hotel estão sujeitos a alterações.
Para fornecer à Microsoft as suas listagens de hotéis, crie um ficheiro CSV que contenha uma listagem de cada hotel que pretenda anunciar. Uma listagem descreve o nome, endereço, número de telefone e coordenadas geográficas do hotel.
Para obter informações sobre como criar um ficheiro de feed com um documento XML, consulte Criar um ficheiro de Feed de Hotel XML.
Nota
O feed do hotel suporta apenas o idioma inglês.
O formato CSV não suporta imagens. Em alternativa, utilize o formato XML.
Obter os dados corretos
Uma vez que a Microsoft tenta fazer corresponder as propriedades no feed do hotel a empresas no Mapas Bing, é importante que os dados que fornecer sobre o hotel sejam precisos e completos.
Se o seu hotel tiver informações em falta ou incorretas, a Microsoft poderá não conseguir compará-lo. Se a Microsoft não conseguir corresponder ao hotel, a Microsoft não o anunciará. Depois de o TAM importar o ficheiro de feed do hotel, enviar-lhe-ão um relatório que indica que hotéis a Microsoft correspondeu ou não correspondeu. Se a Microsoft não corresponder ao hotel, o relatório inclui a mensagem Não é possível fazer corresponder este hotel a uma propriedade no Bing. Para ajudar a melhorar a sua taxa de correspondência, trabalhe com a sua TAM.
Definir uma listagem de hotel
A primeira linha do ficheiro de feed é a linha de cabeçalho, que contém os nomes das colunas dos dados do hotel no feed. O cabeçalho tem de incluir os nomes de coluna de todos os elementos de dados necessários. Inclua apenas os nomes das colunas opcionais se fornecer dados para as mesmas.
Segue-se a lista de colunas que pode incluir no feed. O ficheiro de feed pode conter as colunas por qualquer ordem e os nomes das colunas não são sensíveis a maiúsculas e minúsculas.
| Nome da coluna | Descrição | Tipo de dados | Obrigatório |
|---|---|---|---|
| ID | Um ID opaco definido pelo utilizador que identifica exclusivamente o hotel dentro do feed. Quando criar a mensagem de transação, utilize este ID no Property elemento da mensagem de transação para identificar o hotel. |
Cadeia | Sim |
| nome | O nome do hotel. O nome pode conter um máximo de 200 carateres. | Cadeia | Sim |
| endereço | A rua do hotel usando texto de forma livre. Separe cada componente do endereço com uma vírgula e coloque o endereço entre aspas. Por exemplo, "1234 Billings Way, Redmond, WA, 98030". Utilize esta coluna apenas se fornecer o endereço utilizando texto de forma livre; caso contrário, utilize as colunas do componente de endereço, como addr1, cidade e província. É preferível que utilize as colunas do componente de endereço em vez de utilizar texto de forma livre. |
Cadeia | Sim |
| addr1 | A morada do hotel. Por exemplo, 1234 Modo de Faturação. O endereço tem de ser um endereço físico e não uma caixa de correio ou outro endereço só de correio. | Cadeia | Sim |
| addr2 | Segunda linha de endereços de rua. | Cadeia | Não |
| addr3 | Linha de endereço da terceira rua. | Cadeia | Não |
| cidade | O nome da cidade onde se encontra o hotel. | Cadeia | Sim |
| província | O nome do estado, região ou província onde se encontra o hotel. | Cadeia | Sim |
| postal_code | O código postal do endereço. | Cadeia | Sim |
| país/região | O país ou região onde se encontra o hotel. Especifique o país ou região com o código de país ISO 3116 de duas letras. Por exemplo, utilize E.U.A. para Estados Unidos. | Cadeia | Sim |
| latitude | A latitude das coordenadas geográficas do hotel. Notas:
|
Decimal | Não |
| longitude | A longitude das coordenadas geográficas do hotel. Notas:
|
Decimal | Não |
| telemóvel | O número de telefone de voz principal que os clientes utilizam para contactar o hotel. O número deve ser o número de telefone do front desk e não um número de telefone de reservas centrais. Notas:
|
Cadeia | Sim |
| categoria | Uma categoria que identifica o tipo de hotel. O formato esperado é vacation_rental ou hotel , seguido do caráter pipe e de um valor personalizado. Por exemplo, vacation_rental | "valor personalizado" ou hotel | "valor personalizado" Para obter uma lista de valores personalizados, veja Categorias de propriedades de alojamento. |
Cadeia | Não |
| hotel_brand | A marca da cadeia de hotéis. Por exemplo, Fabrikam Residences da Contoso, onde Contoso é a marca. | Cadeia | Não |
| star_rating | A classificação star do hotel. Os valores possíveis são de 1 a 5. | Cadeia | Não |
Nota
A address coluna e as addrcolunas , addr2, addr3, city, provincee postal_code são mutuamente exclusivas. Especifique a address coluna ou as colunas do componente de endereço. É preferível especificar as colunas dos componentes de endereço.
Embora possa especificar coordenadas geográficas ou um número de telefone, deve especificar ambas para garantir uma melhor probabilidade de corresponder propriedades no Mapas Bing.
Para incluir uma descrição, imagens e críticas para uma listagem, utilize um ficheiro de feed XML. Veja Criar um ficheiro de Feed de Hotel XML.
Segue-se um cabeçalho de exemplo no formato CSV. Separe todas as colunas com uma vírgula. Inclua apenas colunas que contenham valores para, pelo menos, um hotel.
id,name,addr1,city,province,postal_code,country,phone
Após a linha de cabeçalho, inclua uma linha para cada hotel que anunciar. O feed tem de incluir listagens para todos os hotéis. O processo de feed não suporta atualizações parciais. Não inclua linhas em branco no seu feed.
Se um valor contiver uma vírgula, tem de colocar o valor entre aspas. O seguinte mostra o conteúdo de um ficheiro CSV de exemplo.
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
O que acontece se o conteúdo do hotel mudar?
Se alterar qualquer um dos valores de propriedade do hotel entre as execuções de feeds (por exemplo, o nome, endereço, telefone, etc.), o Microsoft Advertising poderá tratá-lo como uma nova propriedade de hotel e criar uma nova listagem para o mesmo. Se a Microsoft criar uma nova listagem, o histórico de desempenho anterior do hotel antigo permanece disponível até 36 meses. Tenha em atenção que as ofertas e multiplicadores do antigo hotel não serão transferidos para a nova entidade hoteleira.
Se remover um hotel e adicioná-lo novamente num feed posterior com os mesmos valores de propriedade que antes, a Microsoft trata-o como uma nova listagem. Além disso, o relatório de desempenho irá mostrá-lo como duas listagens separadas.
Passos seguintes
Peça ao gestor de conta para importar o ficheiro de feed.
Certifique-se de que também importa os seus pontos de dados de venda. Para obter informações sobre como criar o ficheiro de feed de pontos de venda, consulte o artigo Feed de Pontos de Venda.
Depois de a Microsoft importar os seus dados com êxito e conseguir corresponder os seus hotéis com propriedades no Mapas Bing, poderá começar a enviar os seus dados de preços e disponibilidade do hotel. Para obter informações, veja Mensagens de Transação.