Criar um feed de Páginas de destino
Para fornecer ao Bing os dados das suas páginas de Destino, crie um documento XML que contenha um ponto de venda (POS) para cada site de reservas que suporta. Uma nota de encomenda descreve o nome a apresentar, o URL e os critérios da POS para corresponder o utilizador a uma POS.
O documento tem de utilizar a codificação UTF-8 e tem de estar em conformidade com o PointsOfSale XSD.
Nota
O Bing não suporta todos os elementos XSD. O Bing ignora qualquer elemento ou atributo no documento que não suporte. A referência de Páginas de destino inclui apenas os elementos e atributos suportados pelo Bing.
Nota
O documento tem de especificar os elementos na ordem definida no XSD PointsOfSale (ou conforme mostrado na referência).
O feed Páginas de destino contém um único elemento PointsOfSale de nível superior. O PointsOfSale
elemento requer um elemento subordinado PointOfSale para cada site que os utilizadores podem utilizar para reservar uma sala.
<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<PointOfSale>
. . .
</PointOfSale>
...
</PointsOfSale>
O PointOfSale
elemento descreve o nome a apresentar, o URL e os critérios da POS para corresponder o utilizador a uma POS. Para obter informações sobre como definir uma POS, veja Defining a point of sale (Definir um ponto de venda).
O PointsOfSale
elemento contém uma lista de elementos PointOfSale , um para cada site pos que os utilizadores podem utilizar para reservar salas. A lista tem de conter Páginas de destino para um único parceiro.
O seguinte mostra PointOfSale
elementos que definem Páginas de destino para utilizadores de língua inglesa. O primeiro PointOfSale
elemento define uma POS para os utilizadores finais de língua inglesa em qualquer dispositivo e o segundo PointOfSale
elemento define uma POS para utilizadores finais de língua inglesa em dispositivos móveis. O URL da nota de encomenda inclui detalhes sobre a transação, como as datas de entrada e saída, o ID do hotel e o idioma do utilizador. O Bing utiliza o nome a apresentar e o URL de POS para criar uma hiperligação que é adicionada ao anúncio. Quando o utilizador clica na ligação, é levado para o site de reservas. Se estiver a utilizar Modelos de Controlo para controlo de desempenho, o elemento LPURL do URL da Página de Destino tem de ser configurado no ficheiro de feed pos para que o controlo funcione. O Bing utiliza o nome a apresentar e o URL da POS ou LPURL para criar uma hiperligação que é adicionada ao anúncio. Quando o utilizador clica na ligação, é levado para o site de reservas.
<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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
<LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
<LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</LPURL>
</PointOfSale>
Inclua o DisplayNames
elemento apenas para agências de viagens online. Não inclua DisplayNames
para fornecedores do sistema de reservas centrais (CRS) (também conhecidos como parceiros de integração) e fornecedores diretos (como proprietários ou cadeias de hotéis). Para fornecedores de CRS e fornecedores diretos, o Bing utiliza o nome do hotel a partir do feed de propriedades.
Se incluir DisplayNames
, tem de incluir um Match
elemento que tenha o critério de idioma definido para o mesmo idioma.
O Bing utiliza a POS que melhor corresponde ao utilizador com base nos critérios correspondentes da POS. Com base nos critérios correspondentes acima, os utilizadores em dispositivos móveis utilizarão o English-Mobile POS e todos os outros utilizarão a POS em inglês. Para obter informações sobre como o Bing corresponde os utilizadores a uma POS, veja Páginas de Destino Correspondentes. Para obter uma lista do critério em que pode corresponder, consulte o elemento Match .
O URL
elemento especifica a ligação para o site onde o utilizador pode reservar a sala. O exemplo mostra a utilização de parâmetros de consulta dinâmicos. O Bing substitui os valores pelas variáveis dinâmicas no runtime. Para obter informações sobre como utilizar parâmetros de consulta dinâmicos, veja Utilizar parâmetros de consulta dinâmicos.
Nota
Se especificar o critério de correspondência de idiomas e países, estes têm de ser definidos como apenas en e US .
Segue-se um documento XML das Páginas de destino 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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
</PointOfSale>
</PointsOfSale>
As páginas de destino incluem um Match
elemento que contém os critérios que o Bing utiliza para corresponder um utilizador a uma POS. Seguem-se o critério que o Bing utiliza para corresponder os utilizadores às Páginas de destino. A lista está por ordem de preferência.
- país/região
- moeda
- Idioma
- dispositivo
- sitetype
O Bing utiliza as seguintes regras para encontrar a melhor correspondência de POS.
O Bing dá a maior preferência às correspondências de país/região e a menor preferência às correspondências de dispositivos.
Se
Match
não especificar um dos critérios, o Bing corresponde implicitamente a todos os valores do critério. Por exemplo, seMatch
especificar o idioma e a moeda, o Bing corresponde implicitamente a qualquer país e dispositivo.Se
Match
especificar um ou mais critérios, o Bing utiliza a POS com as correspondências mais explícitas.Se não existir uma correspondência de regra explícita, a seleção de POS não é determinística. Recomendamos que adicione uma regra explícita para o critério de correspondência.
O Match
atributo de estado do elemento determina se deve incluir ou excluir a POS com base na correspondência. Se o estado nunca for e o Bing corresponder a todos os critérios, o Bing não utilizará a POS. Para excluir uma POS, todos os critérios têm de corresponder. No exemplo seguinte, o Bing exclui explicitamente a POS se o utilizador for da Estados Unidos ou França e inclui-a implicitamente se o utilizador for de qualquer outro país.
<PointOfSale id='exclude-example'>
. . .
<Match status='never' country='US' />
<Match status='never' country='FR' />
. . .
</PointOfSale>
Se o estado for sim, o Bing não eliminará quaisquer Páginas de destino da consideração que não correspondam explicitamente a todos os critérios, mas é dada preferência ao POS que corresponde ao critério mais adequado. No exemplo seguinte, o Bing corresponde explicitamente ao utilizador à POS se o país do utilizador for França. Se o país do utilizador não for a França, a POS continuará a ser considerada até ser encontrada uma melhor correspondência. Se não for encontrada uma correspondência melhor, o Bing utilizará a nota de encomenda.
<PointOfSale id='exclude-example'>
. . .
<Match status='yes' country='FR' />
. . .
</PointOfSale>
O Bing recomenda a utilização dos mesmos critérios correspondentes para cada POS. Isto minimiza a complexidade na determinação do motivo pelo qual uma POS correspondeu a outra.
Um ponto de venda (POS) contém um URL
elemento que identifica o site onde os utilizadores podem reservar salas. O URL pode conter parâmetros de consulta dinâmicos, que são parâmetros definidos pelo utilizador que contêm um token predefinido para o respetivo valor. Em seguida, o Bing substitui o token por um valor antes de adicionar o URL ao anúncio. Ao utilizar parâmetros de consulta dinâmicos, pode incluir o ID do hotel, a data de entrada, a duração da estadia e muito mais no URL.
Segue-se a sintaxe que utiliza para especificar parâmetros de consulta dinâmicos no URL da nota de encomenda. Uma vez que os parâmetros de consulta dinâmicos são parâmetros de consulta, têm de seguir o símbolo do ponto de interrogação (?) no URL.
http://domain.com/path?param-name=(dynamic-variable-name)
Seguem-se os possíveis nomes de variáveis dinâmicas sensíveis às maiúsculas e minúsculas que pode especificar no URL.
Name | Descrição |
---|---|
ADGROUP-ID | O ID do grupo de anúncios que acionou o anúncio. Por exemplo, suponha que o URL é www.northwindtraders.com/(ADGROUP-ID). Partindo do princípio de que o ID do grupo de anúncios está 2410012280, o URL da página de destino do seu anúncio será www.northwindtraders.com/2410012280. |
JANELA DE RESERVA ANTECIPADA | O número de dias antes da data de entrada em que a reserva ocorreu. Por exemplo, 36. |
SITE BING | A propriedade Bing que originou o pedido de anúncio. Seguem-se os valores possíveis.
|
ID DA CAMPANHA | O ID da campanha que acionou o anúncio. Por exemplo, suponha que o URL é www.northwindtraders.com/(CAMPAIGN-ID). Partindo do princípio de que o seu ID de campanha é 2410012280, o URL da página de destino do seu anúncio será www.northwindtraders.com/2410012280. |
CHECKINDAY | O dia de dois dígitos especificado no Checkin elemento do feed Price. Por exemplo, 20. |
CHECKINDAY-OF-WEEK | O dia da semana em que ocorre o check-in. O Bing utiliza os dígitos de 0 a 6 para representar de segunda a domingo. Por exemplo, 1 é terça-feira. |
CHECKINMONTH | O mês de dois dígitos especificado no Checkin elemento do feed Price. O Bing utiliza os dígitos de 00 a 11 para representar janeiro a dezembro. Por exemplo, 05 é junho. |
CHECKINYEAR | O ano de quatro dígitos especificado no Checkin elemento do feed Price. Por exemplo, 2021. |
DIA DE FINALIZAÇÃO DA COMPRA | O dia de dois dígitos que o utilizador dá saída. O Bing utiliza os Nights elementos e Checkin da TransactionMessage para calcular o dia. Por exemplo, 23. |
CHECKOUTMONTH | O mês de dois dígitos que o utilizador dá saída. O Bing utiliza os Nights elementos e Checkin do feed Price para calcular o mês. Por exemplo, 07. |
CHECKOUTYEAR | O ano de quatro dígitos que o utilizador dá saída. O Bing utiliza os Nights elementos e Checkin do feed Price para calcular o ano. Por exemplo, 2021. |
TIPO DE CLIQUE | Indica se o utilizador clicou num anúncio de hotel ou num anúncio de pacote de quarto. Seguem-se os valores possíveis.
|
PERSONALIZADO[1-5] | Os valores dos campos personalizados (por exemplo, Personalizado1) especificados no elemento Resultado do feed Preço. |
TIPO DE DATA | Indica se o utilizador especificou datas de entrada e saída. Seguem-se os valores possíveis.
|
HOTELGROUP_ID |
Nota: HOTELGROUP_ID é um parâmetro legado que se refere ao Centro hoteleiro. Em alternativa, utilize ADGROUP-ID. A ID do grupo hoteleiro a que pertence o anúncio do hotel. |
COMPRIMENTO | A duração da estadia especificada no Nights elemento do feed Price. Por exemplo, 3. |
REDE | O tipo de rede de anúncios no qual o anúncio foi servido.
|
NUM-ADULTS | O número de adultos que ocupam a sala. O valor predefinido é 2. |
MOEDA DE PARCEIRO | O código de moeda de três letras especificado no atributo de moeda do Baserate elemento no feed Price. Por exemplo, USD. |
PARTNER-HOTEL-ID | O ID do hotel especificado no id elemento do Feed de propriedades. |
PARTNER-ROOM-ID | O ID que identifica exclusivamente a sala. Este é o ID especificado no <elemento RoomID> do <bloco Resultado>, <RoomBundle> ou <RoomData> , consoante a utilização. |
IMPOSTO APRESENTADO PELO PREÇO | O montante do imposto na moeda local do utilizador. O montante do imposto baseia-se no Tax elemento especificado no Feed de preços. Por exemplo, 3,14. |
PREÇO-APRESENTADO-TOTAL | O custo total da sala na moeda local do utilizador. O montante baseia-se na soma dos Baserate elementos , Tax e OtherFees especificados no feed Preço. Por exemplo, 152,13. |
SLOT_TYPE | O posicionamento do anúncio na página de resultados. O parâmetro pode conter os seguintes valores possíveis:
|
SUBACCOUNT_ID |
Nota: SUBACCOUNT_ID é um paramater legado que se refere ao Centro hoteleiro. Em alternativa, utilize CAMPAIGN-ID. O ID da subconta à qual a campanha de anúncios de preços do hotel pertence. |
PAÍS-UTILIZADOR | Código de país de duas letras do país onde o utilizador está localizado. O valor é extraído das definições de cliente do utilizador final. Por exemplo, E.U.A. |
MOEDA DO UTILIZADOR | Código de moeda de três letras da moeda local utilizada pelo utilizador. O valor é inferido a partir das definições de cliente do utilizador final. Por exemplo, USD. |
UTILIZADOR-DISPOSITIVO | O tipo de dispositivo do utilizador final. Seguem-se os valores possíveis.
|
IDIOMA DO UTILIZADOR | O código de idioma de duas letras que especifica o idioma de apresentação do anúncio. O valor é inferido a partir das definições de cliente do utilizador final. Por exemplo, en. |
VERIFICAÇÃO | Um Booleano que indica se o Bing gerou a ligação. Se o Bing tiver gerado a ligação, o valor é verdadeiro. Caso contrário, falso. |
Todas as datas, como CHECKINDAY, estão no fuso horário do hotel.
Segue-se um URL de exemplo que contém parâmetros de consulta dinâmicos e entidades codificadas.
<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)</URL>
Antes de o Bing utilizar o URL no anúncio, substitui os valores pelos nomes das variáveis dinâmicas. Por exemplo, se o utilizador reserva um quarto para 6 noites a partir de 07/06/2021 para o hotel n.º 42, o Bing compõe o URL como:
http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6
O Bing obtém valores para os parâmetros dinâmicos do Feed de preços e do feed de Propriedades, bem como definições específicas do utilizador. Por exemplo, o valor da variável LENGTH provém do Nights
elemento no feed Price e o valor da variável PARTNER-HOTEL-ID provém do id
elemento no Feed de propriedades.
Algumas variáveis são subconjunto de elementos de Feed de preços. Por exemplo, as variáveis CHECKINDAY, CHECKINMONTH e CHECKINYEAR são extraídas do Checkin
elemento . Outras variáveis são calculadas com base na região do utilizador e noutras definições de cliente.
Seguem-se regras gerais a seguir ao utilizar variáveis dinâmicas.
Todos os parâmetros dinâmicos são opcionais. Não é necessário inserir parâmetros dinâmicos no URL da POS. No entanto, a utilização de variáveis para transmitir informações específicas de itinerários e utilizadores geralmente cria uma melhor experiência para o utilizador final.
Rodeie nomes de variáveis dinâmicas com parênteses abertos e fechados.
Utilize entidades codificadas para carateres especiais. Por exemplo, substitua os e comercials (&) por &, o espaço por %20 e a barra (/) por %2F.
Os valores de um único parâmetro podem ser construídos a partir de múltiplas variáveis. Por exemplo, pode construir o valor de um parâmetro de consulta checkinDate a partir das variáveis CHECKINDAY, CHECKINMONTH e CHECKINYEAR.
<URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
Para variáveis dinâmicas que o Bing reconheceu mas não suporta, o Bing substitui a cadeia de variável por uma cadeia vazia.
Uma vez que os parâmetros de consulta dinâmicos são parâmetros de consulta, têm de seguir o símbolo do ponto de interrogação (?) no URL.
Além das variáveis listadas acima, também pode utilizar as seguintes diretivas para criar lógica condicional.
SE-PREDEFINIÇÃO-DATA — Resolve como verdadeiro se o utilizador clicou num anúncio de hotel que utilizava datas predefinidas (o utilizador não escolheu as datas). Se for verdadeiro, o Bing insere os valores que seguem esta diretiva no URL. Caso contrário, o Bing insere os valores ao seguir a diretiva ELSE.
ELSE — Se a condição anterior não for cumprida, o Bing insere os valores que seguem esta diretiva.
ENDIF — Termina o bloco condicional.
Por exemplo, o URL seguinte define o parâmetro de consulta popup_datepicker como verdadeiro se o utilizador tiver utilizado datas predefinidas em vez de especificar datas.
<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)
&nights=(LENGTH)(IF-DEFAULT-DATE)&popup_datepicker=true(ELSE)
&popup_datepicker=false(ENDIF)</URL>
Se for verdadeiro, o Bing compõe o URL como:
http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true
Caso contrário, o Bing compõe o URL como:
http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false
Utilize o PointsOfSale XSD para validar o ficheiro de feed de Páginas de destino antes de o enviar para o Bing.
O documento Feed de páginas de destino tem de utilizar a codificação UTF-8.
O feed tem de incluir Páginas de destino para todos os sites que os utilizadores utilizam para reservar salas. O processo de feed não suporta atualizações parciais.
O Bing ignora qualquer elemento ou atributo que não suporte.
Os elementos têm de estar na ordem especificada em PointsOfSale 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 um nome a apresentar para um hotel, não inclua um elemento DisplayNames> vazio<.
Não utilize HTML nos elementos XML.
Depois de criar o ficheiro de feed, utilize o PointsOfSale 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 do hotel. Para obter informações sobre como criar o ficheiro de feed de propriedades, veja Feed de Propriedades.
Depois de importar com êxito o feed de páginas de destino e o feed de propriedades, pode começar a enviar os dados de preços e disponibilidade do hotel. Para obter informações, veja Feeds de preços.