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.
O carregamento em lote é composto de duas partes:
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.
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
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.
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
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 exemplo | Descriçã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 ( O arquivo precisa começar com a tag de declaração |
XML sem tipos de quarto | Exemplo de XML | Especifique o preço ( O arquivo precisa começar com a tag de declaração |
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.
Nome e tipo de campo | Descrição |
---|---|
tipo: string | Obrigatório. Um identificador único do hotel fornecido pelo anunciante como |
tipo: string | Obrigatório. Um identificador único do tipo de quarto fornecido pelo anunciante. |
tipo: string | Obrigatório. Nome do tipo de quarto do hotel. |
tipo: string | Obrigatório. Descrição do tipo de quarto do hotel. |
tipo: float | Obrigatório. O menor preço do quarto de hotel. É necessário incluir a moeda. Exemplo: |
tipo: string | Link da página do quarto do hotel. |
tipo: data | Obrigatório. Data de check-in do |
tipo: número inteiro | Obrigatório. Número de noites da estadia no hotel pelo |
tipo: float | Obrigatório. Preço com base em Exemplo: |
tipo: float | Obrigatório. Valor do imposto para a estadia. |
tipo: float | Obrigatório. Tarifa aplicável pela estadia. |
tipo: float | O preço com desconto, se aplicável. Exemplo: |
tipo: float | Valor do imposto para o preço com desconto. |