Documentazione sui dati di Oracle OPERA
Panoramica
Scopri quali dati vengono sincronizzati da Oracle OPERA Cloud a Klaviyo e dove visualizzarli. Sono inclusi prenotazioni, notti in camera, profili ospite, iscrizioni al programma fedeltà, acquisti in struttura e consensi per e-mail e messaggi di testo. Se non l'hai ancora fatto, leggi la nostra guida su Primi passi con Oracle OPERA per le istruzioni sull'integrazione passo passo, prima di continuare con questo articolo.
I dati delle e-mail di prenotazione di Oracle OPERA ora includono informazioni su tasse e resort fee per supportare una personalizzazione delle prenotazioni più ricca. Questo aggiornamento risolve anche un problema relativo alla raccolta del consenso SMS da OPERA.
Frequenza di sincronizzazione
Quando integri Oracle OPERA, Klaviyo sincronizzerà fino agli ultimi 3 anni di dati sulle prenotazioni e sugli acquisti in struttura per ogni hotel selezionato, insieme a tutti i profili degli ospiti attivi e alle iscrizioni al programma fedeltà della tua catena. Da quel momento in poi, tutti i dati si sincronizzano ogni ora.
Nota: I profili degli ospiti e le iscrizioni al programma fedeltà si sincronizzano per l’intera catena OPERA, mentre le prenotazioni si sincronizzano solo per gli hotel che hai aggiunto durante la configurazione. Si sincronizzano solo i profili dei singoli ospiti. I profili di aziende, agenti di viaggio e gruppi no.
Come visualizzare i dati di Oracle OPERA
Per visualizzare la tua metrica di Oracle OPERA:
- Vai a Analytics > Metriche. Le metriche con un’icona Oracle OPERA vengono sincronizzate dall’integrazione OPERA.
- Usa il menu a discesa Tutte le integrazioni e seleziona Oracle OPERA per visualizzare solo le metriche di OPERA.

Per visualizzare i tuoi oggetti Oracle OPERA:
- Vai a Content > Objects. Gli oggetti Reservation e Loyalty Account con un’icona di Oracle OPERA sono sincronizzati dalla tua integrazione OPERA.
Metriche delle notti in camera
Quando un ospite conferma una prenotazione in Oracle OPERA, creiamo 1 evento Confirmed Room Night per ogni notte in camera (ad esempio, una prenotazione con 2 camere per 2 notti avrà 4 eventi).
Quando un ospite effettua il check-out in Oracle OPERA, creiamo 1 evento Completed Room Night per notte in camera (ad es., una prenotazione con 2 camere per 2 notti avrà 4 eventi).
Proprietà di primo livello sincronizzate:
- ValueLa tariffa della camera per una determinata notte
- StartDateLa data e l’ora di inizio della notte (15:00 nel fuso orario dell’hotel)
- EndDateLa data e l’ora di fine della notte (11:00 del giorno successivo nel fuso orario dell’hotel)
- DayOfWeekIl giorno della settimana (ad esempio, Monday) in cui inizia la notte
- AdultCountNumero di adulti nella prenotazione
- ChildCountNumero di bambini nella prenotazione
- RoomTypeNameIl codice della tipologia di camera come memorizzato in Oracle OPERA
- PropertyIDL’ID hotel Oracle OPERA della struttura
- PropertyNameNome corrispondente alla struttura alberghiera
- OrigineIl codice sorgente tramite cui è stata effettuata la prenotazione
- MarketCodeCodice di mercato per la prenotazione
Metriche delle prenotazioni
Metriche sincronizzate:
- Created Reservation: quando viene creata la prenotazione di un ospite in Oracle OPERA
- Prenotazione confermata: quando la prenotazione di un ospite viene confermata in Oracle OPERA
- Checked In to Reservation: quando un ospite effettua il check-in per la propria prenotazione
- Checked Out of Reservation: quando un ospite effettua il check-out per la propria prenotazione
- Prenotazione annullata: quando un ospite o un amministratore annulla la prenotazione di un ospite
- No Show Reservation: quando un ospite non si presenta a una prenotazione
Proprietà di primo livello sincronizzate:
- Value: il valore monetario totale della prenotazione
- ReservationID: l’ID prenotazione da Oracle OPERA
- ConfirmationNumber: il numero di conferma condiviso con l’ospite
- ReservationStatus: Lo stato della prenotazione (ad es., "RESERVED")
- ArrivalDate: la data di arrivo della prenotazione
- DepartureDate: la data di partenza della prenotazione
- Nights: Il numero di notti di una prenotazione
- NumberOfRooms: il numero di camere prenotate in una prenotazione
- RoomTypeName: Il codice della tipologia di camera come memorizzato in Oracle OPERA
- RoomTypeDescription: la descrizione del tipo di camera
- RoomClass: la classe della camera della camera prenotata
- RoomNumber: Il numero di camera assegnato alla prenotazione
- RoomInfoURL: l’URL dell’immagine per il tipo di camera prenotato
- RatePlanCode: Il codice tariffa utilizzato per prenotare la prenotazione
- RatePlanDescription: la descrizione del codice tariffa
- RateAmount: la tariffa base della prenotazione
- Currency: la valuta della prenotazione (ad es., "USD")
- TotalAmount: il costo totale del soggiorno
- Balance: il saldo residuo della prenotazione
- AdultCount: il numero totale di adulti inclusi in una prenotazione
- ChildCount: Il numero totale di bambini inclusi in una prenotazione
- PropertyID: L’ID hotel Oracle OPERA della struttura presso cui è stata prenotata la prenotazione
- PropertyName: il nome della struttura presso cui è stata prenotata la prenotazione (ad es., "Boutique Hotel in Maine")
- Source: il codice sorgente tramite cui è stata effettuata la prenotazione
- MarketCode: il codice di mercato assegnato alla prenotazione
- BookingChannel: il canale tramite cui è stata effettuata la prenotazione
- Promotion: il codice promozionale utilizzato per la prenotazione
- BlockCode: il codice del blocco di gruppo utilizzato nella prenotazione
- CancellationPolicy: la politica di annullamento della prenotazione
- CancellationDateTime: la data e l’ora in cui la prenotazione è stata annullata
- TotalFolioAmount: i ricavi totali della prenotazione
- RoomRevenue: Il ricavo della camera sulla prenotazione
- FoodAndBevRevenue: Il ricavo di cibo e bevande sulla prenotazione
- OtherRevenue: Il ricavo sulla prenotazione al di fuori di camera e cibo e bevande (ad es., spa)
- ActualArrivalTime: l’orario in cui l’ospite ha effettuato il check-in (solo per Checked In to Reservation)
- ActualDepartureTime: l’ora in cui l’ospite ha effettuato il check-out (solo Checked Out of Reservation)
- CancellationReason: il codice motivo di annullamento (solo Canceled Reservation)
- CancellationNumber: il numero di annullamento (solo Canceled Reservation)
- DaysBeforeArrival: il numero di giorni prima dell’arrivo in cui la prenotazione è stata annullata (solo Prenotazione annullata)
Metriche di acquisto
Klaviyo sincronizza gli acquisti in struttura che vengono registrati sul folio di un ospite in Oracle OPERA, come cibo e bevande, minibar, banchetti e altri addebiti. Gli addebiti della camera, le tasse, i pagamenti e i rimborsi non vengono sincronizzati.
Metriche sincronizzate:
- Placed Order: quando un acquisto viene registrato nel folio di un ospite. Creiamo 1 evento Placed Order per ogni registrazione.
- Ordered Product: creiamo 1 evento Ordered Product per unità acquistata (ad es., una registrazione di 3 bicchieri di vino avrà 1 evento Placed Order e 3 eventi Ordered Product).
Entrambi gli eventi riportano un timestamp corrispondente al momento in cui l’acquisto è stato registrato in Oracle OPERA.
Proprietà di primo livello sincronizzate:
- Value: il valore totale dell’acquisto (Placed Order) o il prezzo di una singola unità (Ordered Product)
- Description: il nome dell’articolo o dell’addebito configurato in Oracle OPERA (ad esempio, "Room Service Dinner")
- ItemType: il tipo di acquisto, ad esempio Food and Beverage, Minibar, Banquet o Other
- Category: il gruppo di ricavi assegnato all’articolo dall’hotel
- CategoryCode: il codice per il gruppo di ricavi
- Subcategory: il sottogruppo di ricavi che la struttura ha assegnato all’articolo
- SubcategoryCode: il codice del sottogruppo di ricavi
- TransactionCode: il codice transazione Oracle OPERA per l’articolo
- ArticleDescription: il nome dell’articolo specifico acquistato, se l’hotel utilizza gli articoli
- Quantity: il numero di unità acquistate (Placed Order) o 1 (Ordered Product)
- OrderID: il numero di transazione della registrazione in Oracle OPERA
- ReservationID: l’ID della prenotazione su cui è stato registrato l’acquisto
- ConfirmationNumber: il numero di conferma di quella prenotazione
- PropertyID: l’ID hotel Oracle OPERA della struttura
- PropertyName: il nome della struttura
- RoomNumber: il numero della camera dell’ospite
- FolioNumber: il folio su cui è stato registrato l’acquisto
- CheckNumber: il numero dello scontrino POS, se l’acquisto proviene da un sistema di punto vendita (POS)
- Covers: Il numero di ospiti sul conto
- PackageName: il pacchetto in cui era incluso l’acquisto, se presente
- IsPackageInclusive: Se l’acquisto era incluso in un pacchetto
- MarketCode: il codice di mercato della prenotazione
- MarketDescription: la descrizione del codice di mercato
- MarketGroupCode: il codice del gruppo di mercato
- MarketGroupDescription: la descrizione del gruppo di mercato
- SourceCode: il codice sorgente della prenotazione
- SourceGroupCode: Il codice del gruppo di origine
- RateCode: il codice tariffa della prenotazione
- Supplement: eventuali dettagli aggiuntivi inseriti nella registrazione
- TransactionPostingDate: La data aziendale dell’hotel in cui è stato registrato l’acquisto
Oggetti prenotazione
L’integrazione Oracle OPERA sincronizza gli oggetti Reservation da Oracle OPERA.
- ReservationID: L’ID prenotazione da Oracle OPERA. Utilizzato come ID dell’oggetto
- ConfirmationNumber: il numero di conferma condiviso con l’ospite
- ReservationStatus: Lo stato attuale della prenotazione
- ArrivalDate: la data di arrivo per la prenotazione
- DepartureDate: la data di partenza della prenotazione
- Nights: il numero di notti di una prenotazione
- NumberOfRooms: il numero di camere prenotate per una prenotazione
- RoomTypeName: il codice della tipologia di camera come memorizzato in Oracle OPERA
- RoomTypeDescription: la descrizione della tipologia di camera
- RoomClass: la classe della camera della camera prenotata
- RoomNumber: il numero della camera assegnata alla prenotazione
- RoomInfoURL: l’URL dell’immagine per il tipo di camera prenotato
- RatePlanCode: il codice tariffa usato per prenotare la prenotazione
- RatePlanDescription: la descrizione del codice tariffa
- RateAmount: La tariffa base della prenotazione
- Currency: la valuta della prenotazione
- TotalAmount: il costo totale del soggiorno
- Balance: il saldo residuo della prenotazione
- AdultCount: il numero totale di adulti inclusi in una prenotazione
- ChildCount: il numero totale di bambini inclusi in una prenotazione
- PropertyName: il nome della struttura presso cui è stata prenotata la prenotazione
- Source: il codice sorgente tramite cui è stata effettuata la prenotazione
- MarketCode: il codice di mercato assegnato alla prenotazione
- BookingChannel: il canale tramite cui è stata effettuata la prenotazione
- CancellationPolicy: la politica di annullamento della prenotazione
- CancellationDateTime: la data e l’ora in cui la prenotazione è stata annullata
- TotalFolioAmount: i ricavi totali della prenotazione
- RoomRevenue: Il ricavo della camera sulla prenotazione
- FoodAndBevRevenue: Il ricavo di cibo e bevande sulla prenotazione
- OtherRevenue: Il ricavo sulla prenotazione al di fuori di camera e cibo e bevande
Oggetti account fedeltà
L’integrazione Oracle OPERA sincronizza gli oggetti Loyalty Account per gli ospiti con un’iscrizione a un programma fedeltà in Oracle OPERA.
- MembershipCardNumber: il numero di iscrizione che l’ospite vede sulla propria tessera o nel proprio account. Utilizzato come ID oggetto
- MembershipID: l’ID interno di Oracle OPERA per l’iscrizione
- MembershipType: il codice del programma fedeltà
- MembershipTypeDesc: il nome del programma fedeltà
- MembershipLevel: il codice livello dell’ospite
- MembershipLevelDesc: Il nome del livello dell’ospite (ad es., "Gold")
- MembershipLevelRank: la posizione del livello dell’ospite all’interno del programma
- CurrentPoints: il saldo punti attuale dell’ospite
- PointsLabel: come il programma fedeltà chiama i suoi punti (ad esempio, "Points")
- EffectiveDate: La data in cui l’ospite ha aderito al programma
- ExpireDate: la data di scadenza dell’iscrizione
- EnrollmentSource: dove l’ospite si è iscritto
- EnrollmentCode: il codice di iscrizione
- IsPrimary: se questa è l’iscrizione principale dell’ospite
Dati dell’ospite
Klaviyo sincronizza i dati degli ospiti da Oracle OPERA. Tieni presente che non sincronizziamo gli indirizzi e-mail generati dalle agenzie di viaggio online (OTA), come Booking.com o Expedia. Se un ospite che ha prenotato tramite un’OTA ha un numero di telefono valido, Klaviyo crea il suo profilo solo con il numero di telefono.
Se in un secondo momento un ospite fornisce il suo vero indirizzo e-mail in Oracle OPERA (ad esempio al check-in), Klaviyo crea il suo profilo e compila retroattivamente le prenotazioni precedenti come oggetti prenotazione e gli acquisti precedenti in struttura come eventi Placed Order e Ordered Product, in modo che possano essere utilizzati in segmenti e flussi basati su date. Le prenotazioni future continuano a sincronizzarsi come di consueto.
Dati degli ospiti sincronizzati con i profili:
- Numero di telefono
- Nome
- Cognome
- Indirizzo 1
- Indirizzo 2
- Città
- Stato
- CAP
- Paese
- ID profilo OPERA
- Compleanno OPERA
- Nazionalità OPERA
- Stato VIP OPERA
- Stato del profilo OPERA
- Origine del profilo OPERA
- Data ultimo soggiorno OPERA
- Struttura dell’ultimo soggiorno OPERA
- Consenso all'invio di e-mail
- Consenso SMS
Tieni presente che gli ospiti sono iscritti alle e-mail quando le impostazioni di marketing via e-mail, consenso esplicito per e-mail e consenso esplicito alla mailing list sono tutte abilitate sul loro profilo Oracle OPERA e agli SMS quando le impostazioni di marketing via SMS e consenso esplicito per SMS sono entrambe abilitate.