A partire dal 30 aprile 2024, le strategie di offerta basate sulle commissioni (per soggiorno) e sulle commissioni (per conversione) non saranno più disponibili per le nuove campagne di annunci per hotel.
Le campagne di annunci per hotel attive con strategie di offerta basate sulle commissioni continueranno a essere pubblicate fino al 20 febbraio 2025. Consulta l'articolo sulle Ritiro delle strategie di offerta basate sulle commissioni negli annunci per hotel per scoprire di più sui passaggi successivi.
- Pagare la fattura. Per sapere come procedere, coordinati con il TAM.
- Inviare a Google un file CSV del rapporto sulle riconciliazioni, che indichi la quantità di ogni fattura. Carica il rapporto ogni mese, ogni settimana oppure ogni due settimane.
Il rapporto sulle riconciliazioni elenca le prenotazioni da cui raccogliere le commissioni. Viene generato automaticamente dall'hotel o dai suoi partner tecnici.
Assicurati di inviare tassi di conversione "da" e "in" accurati, perché invertendo i tassi il rapporto risulterà errato. La tua commissione moltiplicata per {tasso di conversione della valuta della commissione nella valuta di fatturazione} dovrebbe essere pari a {importo della commissione nella valuta di fatturazione}.
Caricare un rapporto sulle riconciliazioni
Puoi utilizzare Hotel Center per caricare un rapporto sulle riconciliazioni. I rapporti sulle riconciliazioni devono essere conformi alla sintassi descritta nella sezione Creare un rapporto sulle riconciliazioni.
Per caricare il rapporto sulle riconciliazioni utilizzando Hotel Center:
- Nel browser, apri Hotel Ads Center.
- Seleziona Account > Commissioni. Viene visualizzato lo strumento di riconciliazione delle commissioni:
- Trascina il rapporto sulle riconciliazioni nella casella o fai clic sulla casella per sfogliare i file sul computer. Hotel Center convalida il formato del rapporto sulle riconciliazioni.
- Esamina il rapporto di riepilogo e correggi eventuali errori.
- Se nel file mancano delle informazioni, viene visualizzato un messaggio di errore che include le correzioni da apportare.
- Continua la convalida del file fino a correggere tutti gli errori.
- Fai clic su Conferma per inviare il file per la riconciliazione finale.
In questa sezione viene descritto come creare un rapporto sulle riconciliazioni da caricare tramite Hotel Center.
Requisiti di base
Ogni file CSV per la riconciliazione deve contenere:
- Una riga di intestazione con i nomi delle colonne.
- Zero o più righe dei dettagli delle prenotazioni, una per ogni prenotazione.
- (Facoltativo) Una riga che specifica la commissione di servizio.
Il formato file CSV che utilizziamo per il rapporto sulla riconciliazione è conforme alla specifica RFC 4180. Si applicano le seguenti regole generali:
- Viene usata la codifica UTF-8.
- Gli indicatori BOM (byte order mark) sono consentiti, ma non necessari.
- I numeri devono utilizzare il punto "." come separatore decimale anziché la virgola ",". Ad esempio, dieci euro dovrebbero avere il formato "10.00" e non "10,00".
- Le stringhe che contengono virgole, virgolette o ritorni a capo/avanzamenti riga (CRLF) devono essere racchiuse tra "virgolette doppie".
- Ogni riga deve terminare con un CRLF.
Riga di intestazione
La riga di intestazione definisce i nomi di colonna e deve contenere 23 o 28 campi in totale:
- Se non includi la tariffa applicata al servizio, 23 campi.
- Se includi la tariffa applicata al servizio, 28 campi.
Puoi includere la riga facoltativa della tariffa applicata al servizio se è previsto un costo correlato alla raccolta delle commissioni dai tuoi hotel. Si tratta in genere di una piccola quota da versare per ogni prenotazione ai fini dell'amministrazione del programma GHACP, solitamente calcolata come piccolo addebito o percentuale aggiuntiva. I campi relativi alla tariffa applicata al servizio sono facoltativi e non vengono elaborati da Google.
Nell'esempio di riga di intestazione riportato di seguito sono inclusi tutti i 28 campi e i relativi nomi, così come devono essere visualizzati.
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
Campi facoltativi:
Service Fee, Service Fee Currency, Service Fee Currency to Billing Currency Conversion Rate, Total Payment, Billing Currency
I nomi delle colonne nel file CSV devono essere specificati nell'esatto ordine dell'esempio precedente.
Righe dei dettagli della prenotazione
Le righe della prenotazione contengono informazioni su ogni prenotazione confermata. Queste informazioni indicano in genere quando è stata fruita la prenotazione, ma possono anche indicare che la prenotazione è stata annullata o non è commissionabile per altri motivi. Per le prenotazioni annullate o non fruite non ti viene addebitata alcuna commissione.
Ogni riga dei dettagli della prenotazione nel file CSV deve contenere esattamente lo stesso numero di colonne della riga di intestazione.
Nella tabella seguente vengono descritte le colonne di ogni riga dei dettagli della prenotazione:
| Colonna | Descrizione |
|---|---|
| Hotel ID (ID hotel) | ID univoco che utilizzi per l'hotel prenotato. Questo ID deve corrispondere all'ID nel feed elenco hotel. Ad esempio "661378545442". |
| Hotel Name (Nome dell'hotel) | Nome dell'hotel prenotato. Ad esempio, "Capybara Motel". |
| Hotel Address (Indirizzo dell'hotel) | Indirizzo dell'hotel prenotato. Ad esempio, "123 Electric Avenue". |
| Hotel City (Città dell'hotel) | Città in cui si trova l'hotel prenotato. Ad esempio, "Cambridge". |
| Hotel State/Region (Paese/regione dell'hotel) |
Paese o regione in cui si trova l'hotel prenotato. Ad esempio, "MA". Questo campo è facoltativo. |
| Hotel Postal Code (CAP dell'hotel) | Codice di avviamento postale flessibile della località in cui si trova l'hotel prenotato. Ad esempio, "02472-1234". |
| Hotel Country Code (Codice paese dell'hotel) | Codice di due lettere che rappresenta il paese in cui si trova l'hotel prenotato. Ad esempio, "US". |
| Hotel Phone Number (Numero di telefono dell'hotel) | Numero di telefono dell'hotel prenotato. Il formato di questo campo è flessibile. Ad esempio, "+1-617-867-5309". |
| Booking Reference (Riferimento della prenotazione) | Identificatore stringa univoco per la prenotazione. Ad esempio, "108BDYKNI". |
| Booking Date and Time (Data e ora della prenotazione) | Data e ora in formato ISO 8601 in cui è stata effettuata la prenotazione nell'ora locale dell'hotel, incluso il fuso orario. Ad esempio, "2016-07-07T19:43:21+08:00:". |
| Check-in Date (Data di check-in) | Data di check-in, nell'ora locale dell'hotel. Utilizza il formato AAAA-MM-GG , dove AAAA indica l'anno di quattro cifre, MM il mese e GG il giorno. Ad esempio, "2016-09-01". |
| Check-out Date (Data di check-out) | Data di check-out, nell'ora locale dell'hotel. Utilizza il formato AAAA-MM-GG , dove AAAA indica l'anno di quattro cifre, MM il mese e GG il giorno. Ad esempio, "2016-09-01". |
| Number of Rooms (Numero di camere) | Numero di camere nella prenotazione. Ad esempio, "1". |
| Number of Guests (Numero di ospiti) | Numero di ospiti nella prenotazione. Ad esempio, "2". |
| Booking Revenue (Entrate da prenotazione) | Le entrate derivanti da questa prenotazione. Questo valore può corrispondere alle entrate lorde o nette e deve riflettere il valore di conversione. Ad esempio, "1066,42". |
| Booking Revenue Currency (Valuta delle entrate da prenotazione) | Codice di tre lettere della valuta utilizzata per il campo "Booking Revenue" (Entrate da prenotazione). Ad esempio, "EUR". |
| Booking Revenue Currency to Billing Currency Conversion Rate (Tasso di conversione della valuta delle entrate da prenotazione nella valuta di fatturazione) |
Tasso di conversione della valuta utilizzata nel campo "Booking Revenue Currency" (Valuta delle entrate da prenotazione) nella valuta utilizzata nel campo "Billing Currency" (Valuta di fatturazione). Questo valore deve rispecchiare il tasso di conversione utilizzato per la prenotazione. Ad esempio, "1.113". Se la valuta delle entrate da prenotazione e la valuta di fatturazione sono uguali, imposta questo campo su |
| Booking Status (Stato della prenotazione) |
Stato della prenotazione. Può avere uno dei seguenti valori:
|
| Commission (Commissione) | Importo pagato a Google per questa prenotazione. Per le prenotazioni annullate, non fruite o non idonee per la commissione, imposta il valore di questo campo su "0". Ad esempio, "3.42". |
| Commission Currency (Valuta della commissione) |
Codice di tre lettere della valuta utilizzata nel campo "Commission" (Commissione). Ad esempio, "USD". |
| Commission Currency to Billing Currency Conversion Rate (Tasso di conversione della valuta della commissione nella valuta di fatturazione) |
Tasso di conversione della valuta utilizzata nel campo Commission Currency (Valuta della commissione) nella valuta utilizzata nel campo facoltativo Billing Currency (Valuta di fatturazione). Il valore di questo campo rappresenta il tasso di conversione utilizzato per la commissione. Ad esempio, "0.88942". Se la valuta della commissione e la valuta di fatturazione sono uguali, imposta questo campo su 1. |
| Payment Date (Data pagamento) | Lascia vuoto questo campo. |
| Payment Status (Stato del pagamento) | Imposta questo campo su "Invoice Required" (Fattura obbligatoria). |
(Facoltativo) Campi della tariffa applicata al servizioI campi descritti in questa sezione sono facoltativi. |
|
| Service Fee (Tariffa del servizio) | Importo della tariffa speciale applicata al servizio. Ad esempio, "1.23". |
| Service Fee Currency (Valuta della tariffa del servizio) | Codice di tre lettere della valuta in cui viene pagata la tariffa opzionale applicata al servizio. Ad esempio, "EUR". |
| Service Fee Currency to Billing Currency Conversion Rate (Tasso di conversione della valuta della tariffa del servizio nella valuta di fatturazione) |
Tasso di conversione della valuta della tariffa applicata al servizio nella valuta utilizzata per la fatturazione. Ad esempio, "0.88998". Se la valuta della tariffa applicata al servizio e la valuta di fatturazione sono uguali, imposta questo campo su 1. |
| Total Payment (Pagamento totale) | Importo totale del pagamento, inclusa la tariffa opzionale applicata al servizio. Ad esempio, "1420.39". |
| Billing Currency (Valuta di fatturazione) | Codice di tre lettere che rappresenta la valuta in cui è avvenuto il pagamento, inclusa la tariffa applicata al servizio. Ad esempio, "USD". |
File CSV di esempio
Nel file CSV di esempio riportato di seguito sono incluse la riga di intestazione e 3 righe della prenotazione:
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
I campi devono essere delimitati da una virgola anche se, come nel caso dei campi facoltativi, non contengono alcun valore.
In questo esempio, dal momento che sono state incluse informazioni sulla tariffa applicata al servizio come ultima riga, tutte le altre righe utilizzano virgole per indicare valori vuoti per quelle colonne. Se non ci fosse una riga relativa alla tariffa applicata al servizio, nell'esempio sarebbe possibile omettere le virgole finali.
Convalida un rapporto sulle riconciliazioni con l'API
Convalida un rapporto sulle riconciliazioni con l'API
Per convalidare, caricare e ricevere rapporti sulle riconciliazioni, consulta l'API Travel Partner.
Esempio di richiesta di caricamento/convalida
{
"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"
}
Suggerimento
gtag.js (ad es. in-app), ma riesci ad attribuirli a Google Ads, puoi comunque includerli nel rapporto sulle riconciliazioni. In questo modo, l'offerente potrà ammettere un tasso di cancellazione inferiore rispetto a quello previsto, assicurandoti di fare offerte competitive, contabilizzando le conversioni non conteggiate da gTag. Tieni presente che ti verranno fatturati tutti i soggiorni inclusi nel rapporto sulle riconciliazioni.Norme sui rapporti
Se Google non è soddisfatto dell'accuratezza dei rapporti, potrebbe, con un preavviso di almeno sette giorni e per motivi ragionevoli, richiederti di fornire i documenti o i dati necessari in modo da verificare se i rapporti o i pagamenti effettuati erano esatti per il periodo in esame. Se non provvederai a fornire documenti o dati, oppure se Google ritiene che non siano tali da comprovare l'accuratezza dei rapporti forniti, Google potrebbe interrompere la pubblicazione degli annunci per il tuo hotel.
Se il rapporto sulle riconciliazioni è scaduto da più di 15 giorni, Google interromperà automaticamente la pubblicazione degli annunci delle campagne Commissioni (per soggiorno) finché il file non verrà caricato. Una volta caricato il file più recente, gli annunci inizieranno a essere pubblicati entro tre giorni.
Domande frequenti
Questa sezione contiene le domande frequenti riguardanti i rapporti sulle riconciliazioni.
Come vengono fatturate le campagne che utilizzano le commissioni (per soggiorno)?
Le campagne che utilizzano le commissioni (per soggiorno) vengono fatturate il 18 di ogni mese in base ai soggiorni degli ospiti indicati nel rapporto sulle riconciliazioni caricato dell'inserzionista.
Che cosa posso fare se per sbaglio ho dimenticato di inserire un soggiorno in un rapporto sulle riconciliazioni mensile?
Puoi includere il soggiorno nel tuo prossimo rapporto sulle riconciliazioni mensile.
Ad esempio, il 15 aprile hai caricato un rapporto sulle riconciliazioni per il mese di marzo e hai accidentalmente tralasciato un soggiorno terminato il 31 marzo. In questo caso, puoi includere il soggiorno del 31 marzo nel rapporto del mese di aprile (da caricare tra l'1 e il 17 maggio).
Se qualcosa è stato caricato in modo errato, puoi contattarci per risolvere il problema.