Criar um ficheiro de feed de Propriedade XML

Nota

A partir de 9 de abril, deixará de ter acesso total ao Centro Hoteleiro. Estamos ansiosos para apresentá-lo ao Centro de Propriedades, que irá fornecer funcionalidades emocionantes de gestão personalizada. Obrigado por aguardar pacientemente enquanto atualizamos os nossos conteúdos de ajuda com as novas funcionalidades. Entretanto, pode ler sobre estas alterações futuras e como tornar o seu processo de migração mais suave.

Para fornecer à Microsoft as suas listagens de hotéis, crie um documento XML que contenha uma listagem de cada hotel que pretenda anunciar. Uma listagem descreve o nome, endereço, número de telefone, coordenadas geográficas, comodidades e muito mais do hotel.

O documento tem de utilizar a codificação UTF-8 e tem de estar em conformidade com o Hotel XSD.

Para obter informações sobre como criar um ficheiro de feed com o formato de ficheiro CSV ou TSV, veja Creating a CSV Property feed file (Criar um ficheiro de feed de propriedades CSV).

Nota

A Microsoft não suporta todos os elementos XSD. A Microsoft ignora qualquer elemento ou atributo no documento que não suporte. A referência do Feed de propriedades inclui apenas os elementos e atributos que a Microsoft suporta.

Nota

O documento tem de especificar os elementos na ordem definida no Hotel XSD (e conforme mostrado na referência).

Obter os dados corretos

Uma vez que a Microsoft tenta corresponder as propriedades no feed de propriedades às empresas no Mapas Bing, é importante que os dados que fornecer sobre o hotel sejam precisos e completos.

Se um 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á. Poderá ver um relatório correspondente no centro hoteleiro 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 taxa de correspondência, certifique-se de que estão disponíveis em locais do Bing para empresas.

O elemento de nível superior no feed

O feed de propriedades contém um único elemento de listagem de nível superior. O listings elemento contém dois elementos subordinados necessários: language e 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

Atualmente, suportamos dados de feed apenas em inglês.

O language elemento especifica o idioma em que os dados no feed estão escritos. Para especificar o idioma, utilize o código de idioma ISO 639 de duas letras. Por exemplo, utilize en para inglês.

O elemento de listagem contém informações sobre o hotel, como o nome, endereço e número de telefone. Para obter informações sobre como definir uma listagem, consulte Definir uma listagem de hotel.

Definir uma listagem de hotel

O listing elemento define um hotel. Tem de especificar um listing elemento para cada hotel que anunciar. O exemplo seguinte mostra os elementos mínimos que tem de especificar para uma listagem. A exceção é que pode especificar as coordenadas geográficas ou um número de telefone. Embora possa especificar as coordenadas ou o número de telefone, deve especificar ambas para garantir uma melhor probabilidade de corresponder propriedades no Mapas 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>

O ID no id elemento é definido pelo utilizador e tem de ser exclusivo no feed.

O endereço no address elemento é a morada do hotel. O endereço tem de ser uma rua e não uma caixa de correio. Pode especificar o endereço do hotel com o component elemento visto no exemplo acima ou utilizando uma cadeia de forma livre vista no exemplo abaixo. A preferência é utilizar component elementos.

    <address>1234 Porter Road, Goldendale, WA, 98234</address>

O latitude elemento e longitude especifica as coordenadas geográficas do hotel. Utilize uma API de geocodificação, como a API de Localização , para gerar as coordenadas a partir de um endereço de rua.

A listagem tem de especificar, pelo menos, o número de telefone principal do hotel. O número principal deve ser o número de telefone do front desk e não um número de telefone de reserva central. Quanto mais números de telefone de contacto fornecer, melhor. O exemplo seguinte mostra as outras opções de telemóvel.

    <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 obter mais informações sobre como especificar números de telefone, consulte o elemento de telefone .

Especificar campos opcionais de listagem de hotéis

O exemplo seguinte mostra os elementos opcionais que pode incluir na listagem. Embora seja opcional, deve incluir o máximo de informações possível para suportar cenários de utilização atuais e 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>

O category formato esperado do elemento é 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.

O text elemento contém uma descrição do hotel. Tem de especificar o body elemento, que contém a descrição real. Consoante o comprimento da descrição, pode ser truncado quando apresentado. Se incluir os link elementos e title , o URL da ligação aponta para a descrição online.

O review elemento contém uma revisão de utilizador ou uma revisão editorial. Uma revisão editorial é uma revisão profissional feita por uma autoridade de revisão, como um blogger de viagens. Pode incluir qualquer número de revisões, mas, dependendo do número de críticas enviadas, estas podem não ser todas apresentadas. Tem de especificar o body elemento , que contém a revisão. Consoante o comprimento da revisão, pode ser truncado quando apresentado. Se incluir o link elemento, este aponta para a lista completa de críticas online.

O attributes elemento contém uma lista de comodidades que o hotel fornece, como ar condicionado, piscina e café da manhã gratuito. Para obter uma lista de possíveis comodidades, consulte Atributo. Se não especificar uma amenidade, presume-se que o hotel não o fornece.

O image elemento contém uma imagem do hotel. Pode incluir qualquer número de imagens, mas, consoante o número de imagens enviadas, nem todas podem ser mostradas. A ração de aspeto recomendada é 4:3 e a largura mínima é de 720 píxeis. As imagens têm de ser fotografias originais e podem não ser capturas de ecrã. Tenha em atenção que o link URL tem de estar acessível pelo crawler do AdIdxBot. Se o seu site incluir o ficheiro robots.txt, tem de incluir:

• User-Agent: AdIdxBot
• Permitir: /

O neighborhood elemento identifica o bairro onde o hotel está localizado. Pode especificar vários bairros se o hotel estiver localizado centralmente entre vários bairros.

O brand elemento identifica a marca do hotel. Por exemplo, Fabrikam Residences da Contoso, onde Contoso é a marca.

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.

Regras gerais

• Utilize o Hotel XSD para validar o ficheiro de feed de propriedades antes de o enviar para a Microsoft.

• O documento do feed de propriedades tem de utilizar a codificação UTF-8.

• O feed tem de incluir listagens para todos os hotéis. O processo de feed não suporta atualizações parciais.

• A Microsoft ignora qualquer elemento ou atributo que não suporte.

• Os elementos têm de estar na ordem especificada no Hotel XSD.

• Se os seus dados incluem carateres especiais, como apóstrofos ou aspas, escape-os ou utilize secções CDATA. Se os escapar, poderá utilizar códigos de entidade ou códigos de carateres. Por exemplo, pode escapar de Paulo como Paulo' s ou Paul's.

• Não inclua elementos que não contenham dados. Por exemplo, se não fornecer as coordenadas geográficas de um hotel, não inclua elementos vazios <de latitude> e <longitude> .

• Não utilize HTML nos elementos XML.

Passos seguintes

Depois de criar o ficheiro de feed, utilize o Hotel XSD para validá-lo.

Peça ao gestor de conta para importar o ficheiro de feed.

Certifique-se de que também importa os dados das suas Páginas de destino. Para obter informações sobre como criar o ficheiro de feed Páginas de destino, consulte Feed de páginas de destino.

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 Feeds de preços.