A partir de 30 de abril de 2024, as estratégias de lances com base em comissões por estadia e por conversão não estarão mais disponíveis para novas campanhas de anúncios de hotel.
As campanhas ativas desse tipo com estratégias de lances baseadas em comissões vão continuar sendo veiculadas até 20 de fevereiro de 2025. Leia o artigo Desativação das estratégias de lances com base em comissões nos anúncios de hotel e saiba mais sobre as próximas etapas.
- Pagar sua fatura (você e seu gerente técnico de contas coordenam como fazer isso)
- Fazer o upload de um arquivo CSV (seu "relatório de conciliação") para o Google, que informa o valor de cada fatura. É possível fazer upload desse relatório mensal, semanal ou quinzenalmente.
O relatório de conciliação lista as reservas de que as comissões precisam ser coletadas. Normalmente, ele é gerado automaticamente pelo hotel ou pelos parceiros técnicos dele.
Garanta o envio de taxas de conversão precisas "de" e "para", uma vez que taxas invertidas deixarão seu relatório incorreto. Sua comissão multiplicada por {moeda de comissão para taxa de conversão de moeda de faturamento} precisa ser igual ao {valor de comissão em moeda de faturamento}.
Fazer upload de um relatório de conciliação
Use a Central para Hotéis para fazer upload de um relatório de conciliação. Seus relatórios de conciliação precisam estar em conformidade com a sintaxe descrita em Criar um relatório de conciliação.
Para fazer upload do relatório de conciliação usando a Central para Hotéis:
- No navegador, abra o Central de anúncios de hotéis.
- Selecione Conta > Comissões. A ferramenta de conciliação de comissões exibe:
- Arraste o relatório de conciliação para a caixa ou clique nela para procurar arquivos no computador. A Central para Hotéis valida o formato do seu relatório de conciliação.
- Revise o resumo do relatório e corrija eventuais erros.
- Se o arquivo estiver incompleto, você vai receber uma mensagem de erro com as correções necessárias.
- Continue validando seu arquivo até que todos os erros sejam corrigidos.
- Clique em Confirmar para enviar o arquivo para a conciliação final.
Esta seção descreve como criar um relatório de conciliação para fazer upload dele usando a Central para Hotéis.
Requisitos básicos
Cada arquivo CSV de reconciliação precisa conter:
- uma linha de cabeçalho com os nomes das colunas;
- zero ou mais linhas de detalhes de reservas (uma para cada reserva);
- (opcional) uma linha que especifica as taxas de serviço.
O formato do arquivo CSV que usamos para o relatório de conciliação está em conformidade com RFC 4180. Aplicam-se as seguintes regras gerais:
- Codificação UTF-8
- Marcas de ordem de bytes são permitidas, mas não necessárias.
- Os números precisam usar um ponto "." como separador decimal, em vez de uma vírgula ",". Por exemplo, o valor de 10 euros precisa ser formatado como "10.00", e não "10,00".
- Strings com vírgulas, aspas ou retornos de carro/feeds de linha precisam ser colocadas entre "aspas duplas".
- Cada linha precisa terminar com um CRLF.
Linha de cabeçalho
A linha de cabeçalho define os nomes das colunas e precisa conter 23 ou 28 campos no total:
- 23 campos: se você não inclui taxas de serviço.
- 28 campos: se você inclui taxas de serviço.
Inclua linhas de taxas de serviço opcionais se você cobrar taxas relacionadas à coleta de comissões dos seus hotéis. Trata-se de uma taxa menor para cada reserva que se destina à administração do Programa de comissões, normalmente calculado como uma cobrança menor ou um percentual adicional. Os campos relacionados às taxas de serviço são opcionais e não são processados pelo Google.
A linha de cabeçalho do exemplo a seguir mostra todos os 28 campos com os nomes exatamente como aparecem:
Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel Postal
Code,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and
Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking
Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency
Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency
to Billing Currency Conversion Rate,Payment Date,Payment Status
Campos opcionais:
Service Fee, Service Fee Currency, Service Fee Currency to Billing Currency Conversion Rate, Total Payment, Billing Currency
Em seu arquivo CSV, os nomes das colunas precisam estar na ordem em que aparecem no exemplo anterior.
Linhas de detalhes da reserva
Linhas de reserva contêm informações sobre cada reserva confirmada. Essas informações geralmente indicam quando uma reserva foi utilizada, e também se foi cancelada ou se não foi cobrada comissão por outros motivos. Você não paga comissões sobre reservas canceladas nem reservas em que os hóspedes não aparecem.
Cada linha de detalhes da reserva no arquivo CSV precisa conter exatamente o mesmo número de colunas que a linha de cabeçalho.
A tabela a seguir descreve as colunas em cada linha de detalhes da reserva:
| Coluna | Descrição |
|---|---|
| ID do hotel | Um ID exclusivo usado pelo hotel reservado. Esse código precisa ser o mesmo usado no seu Feed de lista de hotéis. Por exemplo, "661378545442". |
| Hotel Name | O nome do hotel reservado. Por exemplo, "Capybara Motel". |
| Hotel Address | O endereço do hotel reservado. Por exemplo, "123 Electric Avenue". |
| Hotel City | A cidade na qual o hotel reservado está localizado. Por exemplo, "Cambridge". |
| Hotel State/Region |
O estado/região em que o hotel reservado está localizado. Por exemplo, "MA". Este campo é opcional. |
| Hotel Postal Code | Um código postal flexível no qual o hotel reservado está localizado. Por exemplo, "02472-1234". |
| Hotel Country Code | O código do país de duas letras em que o hotel reservado está localizado. Por exemplo, "US". |
| Hotel Phone Number | Número de telefone do hotel reservado. O formato desse campo é flexível. Por exemplo, "+1-617-867-5309". |
| Booking Reference | Uma string exclusiva que identifica a reserva. Por exemplo, "108BDYKNI". |
| Booking Date and Time | A data e a hora no formato ISO 8601 em que foi feita a reserva, no horário local do hotel, incluindo o fuso horário. Por exemplo, "2016-07-07T19:43:21+08:00:". |
| Check-in Date | A data de check-in, na hora local do hotel. Use o formato AAAA-MM-DD, em que AAAA é o ano de 4 dígitos, MM é o mês e DD é o dia. Por exemplo, "2016-09-01". |
| Check-out Date | A data de check-out, na hora local do hotel. Use o formato AAAA-MM-DD, em que AAAA é o ano de 4 dígitos, MM é o mês e DD é o dia. Por exemplo, "2016-09-01". |
| Number of Rooms | O número de quartos nesta reserva. Por exemplo, "1". |
| Number of Guests | O número de hóspedes nesta reserva. Por exemplo, "2". |
| Booking Revenue | A receita gerada com essa reserva. Esse valor pode ser a receita bruta ou líquida e deve refletir o valor da conversão. Por exemplo, "1.066,42". |
| Booking Revenue Currency | O código de três letras da moeda utilizada para o campo "Booking Revenue". Por exemplo, "EUR". |
| Booking Revenue Currency to Billing Currency Conversion Rate |
A taxa de conversão da moeda usada no campo "Booking Revenue Currency" para a moeda utilizada no campo "Billing Currency". Esse valor precisa refletir as taxas de conversões usadas para a reserva. Por exemplo, "1,113". Quando a moeda da receita de reserva e a moeda de faturamento são as mesmas, defina o campo como |
| Booking Status |
O status da reserva pode ser um dos seguintes valores:
|
| Commission | O total a ser pago para o Google por esta reserva. Para reservas canceladas, ausências ou reservas não comissionáveis, defina o valor desse campo como "0". Por exemplo, "3,42". |
| Commission Currency |
O código de três letras da moeda utilizada no campo "Commission". Por exemplo "USD". |
| Commission Currency to Billing Currency Conversion Rate |
A taxa de conversão da moeda usada no campo Commission Currency para a moeda utilizada no campo opcional Billing Curency. O valor desse campo precisa ser a taxa de conversão utilizada para a comissão. Por exemplo, "0,88942". Quando a Commission Currency e a Billing Currency são as mesmas, defina esse campo como 1. |
| Payment Date | Deixe esse campo em branco. |
| Payment Status | Use a opção "Invoice Required". |
(Opcional) Campos de taxas de serviçoOs campos descritos nesta seção são opcionais. |
|
| Service Fee | O total de taxas de serviço especial. Por exemplo, "1,23". |
| Service Fee Currency | O código de três letras para a moeda em que a taxa de serviço opcional é paga. Por exemplo, "EUR". |
| Service Fee Currency to Billing Currency Conversion Rate |
A taxa de conversão da moeda de taxa de serviço para a moeda de faturamento. Por exemplo, "0,88998". Quando a moeda da taxa de serviço e a moeda de faturamento são as mesmas, defina esse campo como 1. |
| Total Payment | O valor total do pagamento, incluindo a taxa de serviço opcional. Por exemplo, "1.420,39". |
| Billing Currency | O código de três letras representando a moeda na qual o pagamento é feito, incluindo a taxa de serviço. Por exemplo, "USD". |
Exemplo de arquivo CSV
O seguinte arquivo CSV de exemplo mostra a linha do cabeçalho e três linhas de reserva:
Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel Postal Code,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status
111,"Capybara Hotel & Spa",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04T12:12:12-07:00,2016-01-01,2016-01-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required
211,"Mabel's Gabels",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-01-04T12:12:12-07:00,2016-02-01,2016-02-03,1,3,414.21,GBP,1.57,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required
311,"No-Tell Motels",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-01-04T12:12:12-07:00,2016-03-01,2016-03-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,,Invoice Required
Uma vírgula é necessária para delimitar todos os campos, mesmo que não haja nenhum valor nesse campo (se ele for opcional).
Observe neste exemplo que devido ao fato de a informação da taxa de serviço estar incluída (como a última linha), todas as outras linhas usam vírgulas para indicar valores vazios para essas colunas. Se não houvesse nenhuma linha para a taxa de serviço, o exemplo excluiria as vírgulas à direita.
Validar um relatório de conciliação com a API
Validar um relatório de conciliação com a API
Para validar, fazer upload e receber relatórios de conciliação, consulte a API Travel Partner.
Exemplo de uma solicitação de upload/validação
{
"fileName": "booking_report.csv",
"contents":"Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status
111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
Dica
gtag.js (por exemplo, se elas ocorreram no app), mas puder atribuí-las ao Google Ads, ainda será possível incluir essas estadias no seu relatório de conciliação. Isso permite que o bidder assuma uma taxa de cancelamento menor do que seria possível, garantindo que você está fazendo lances competitivos ao considerar as conversões não contabilizadas pela gTag. O faturamento será feito para todas as estadias de hóspedes incluídas no relatório de conciliação.Política de relatórios
Se o Google considerar que falta precisão nos seus relatórios, poderemos, com pelo menos sete dias de antecedência e por motivos razoáveis, pedir que você envie os documentos ou registros necessários para determinar a exatidão dos relatórios ou dos pagamentos feitos na época. Se você não enviar esses documentos ou registros, ou se o Google entender que eles não comprovam a precisão dos relatórios, os anúncios do seu hotel deixarão de ser exibidos.
Se o relatório de conciliação estiver atrasado há mais de 15 dias, o Google vai suspender automaticamente a veiculação de anúncios nas campanhas com comissões por estadia até que o arquivo seja enviado. Depois que o arquivo mais recente for enviado, os anúncios vão começar a ser veiculados em até três dias.
Perguntas frequentes
Esta seção contém perguntas frequentes sobre relatórios de conciliação.
Como as comissões (por estadia) são cobradas?
As campanhas de comissões (por estadia) são cobradas no dia 18 de cada mês com base nas estadias de hóspedes informadas no relatório de conciliação enviado pelo anunciante.
O que fazer se eu me esquecer de incluir a estadia de um hóspede no relatório de conciliação mensal?
É possível incluir a estadia do hóspede no seu próximo relatório de conciliação mensal.
Por exemplo, digamos que você tenha feito o upload de um relatório de conciliação do mês de março em 15 de abril e tenha esquecido uma estadia que foi concluída em 31 de março. Nesse caso, é possível incluir a estadia do dia 31 de março no relatório do mês de abril (para ser enviado entre 1º e 17 de maio).
Se algo foi enviado incorretamente, entre em contato com nossa equipe para resolver o problema.