Anúncios de hotel – Preços específicos para datas

Em um feed estático de hotel, você fornece um único preço para cada hotel. Não é possível oferecer diferentes preços com base na data de check-in, na duração da estadia ou no tipo de quarto. Para mostrar preços mais precisos nos anúncios com base nessas variáveis, use o preço dinâmico (específico para uma data) para diferentes datas, tipos de quarto e durações de estadia. Dessa forma, é possível usar os modelos de tags de hotel para mostrar esses preços nos anúncios.

Use o carregamento em lote de dados de preço e tipos de quarto para compartilhar informações de preço com o Facebook.

Consulte os parâmetros de quartos e preços para ver uma explicação de todos os parâmetros.

Carregar dados de preço e tipos de quarto em lote

O carregamento em lote é composto de duas partes:

  1. Carregar tipos de quarto
  2. Carregar preços

Se você usar o carregamento em lote, limite os envios a 50 MB por arquivo, aproximadamente 50 mil itens em cada arquivo. Recomendamos atualizações de variáveis de preço menores e mais frequentes.


Carregar tipos de quarto

Carregue um ou mais arquivos com os tipos de quarto usando a API em lote de Quartos de Hotel.

Observação: se você não tem tipos de quarto diferentes, pule essa etapa.

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

Formato do arquivo de tipos de quarto

Forneça os tipos de quarto no formato XML, veja o exemplo.

Identifique cada hotel por <property> no nó XML <PropertyDataSet> e forneça o tipo de quarto por <RoomData>. O arquivo precisa começar com uma tag de declaração <?xml.

Para saber mais sobre como atualizar e excluir tipos de quarto pela API em lote, consulte quartos de hotel, referência de lote.


Carregar preços

Carregue um ou mais arquivos com as informações de preço usando a API em lote de Variáveis de Preço. É possível carregar as informações com ou sem tipos de quarto.

Observação: se você tem apenas um pequeno número de quartos, use a API de Quarto de Hotel para criar tipos de quarto e configurar preços.

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

Formato do arquivo de preço

Antes de carregar os tipos de quarto, verifique se esses quartos já existem no catálogo. As variáveis podem ser fornecidas nos seguintes formatos:

Formato do arquivo e exemploDescrição

XML com tipos de quarto | Exemplo de XML

Verifique se os tipos de quarto para os quais você quer fornecer preços já existem.


Especifique o preço (<Baserate>) dentro de cada tipo de quarto (<RoomBundle>) com base na combinação entre data do check-in (<Checkin>) e duração da estadia (<Nights>).


O arquivo precisa começar com a tag de declaração <?xml.

XML sem tipos de quarto | Exemplo de XML

Especifique o preço (<Baserate>) para cada combinação de ID do hotel (<Property>), data de check-in (<Checkin>) e duração de estadia (<Nights>).


O arquivo precisa começar com a tag de declaração <?xml.

Para mais informações sobre como atualizar ou excluir variáveis de preço em lote, confira a referência de lote de variáveis de preço.

Parâmetros de quarto e preço

Nome e tipo de campoDescrição

Property

tipo: string

Obrigatório. Um identificador único do hotel fornecido pelo anunciante como hotel_id no feed do hotel.

RoomID

tipo: string

Obrigatório. Um identificador único do tipo de quarto fornecido pelo anunciante.

Name

tipo: string

Obrigatório. Nome do tipo de quarto do hotel.

Description

tipo: string

Obrigatório. Descrição do tipo de quarto do hotel.

BasePrice

tipo: float

Obrigatório. O menor preço do quarto de hotel. É necessário incluir a moeda.

Exemplo: 159 USD

URL

tipo: string

Link da página do quarto do hotel.

CheckinDate

tipo: data

Obrigatório. Data de check-in do price. Aceitamos até 180 dias a partir da data de carregamento do feed. Use o formato ISO-8601 (AAAA-MM-DD).

Nights

tipo: número inteiro

Obrigatório. Número de noites da estadia no hotel pelo price. Valor máximo: 14

Baserate

tipo: float

Obrigatório. Preço com base em checkin_date e length_of_stay.

Exemplo: 180

Tax

tipo: float

Obrigatório. Valor do imposto para a estadia.

OtherFees

tipo: float

Obrigatório. Tarifa aplicável pela estadia.

SalePrice

tipo: float

O preço com desconto, se aplicável.

Exemplo: 159

SalePriceTax

tipo: float

Valor do imposto para o preço com desconto.