Vai al contenuto principale

Come implementare e usare il portale Manage My Booking (MMB)

Il portale Manage My Booking (MMB) offre ai clienti una interfaccia self-service per gestire le proprie prenotazioni

Manage My Booking (MMB) consente ai clienti di

  • modificare le date di viaggio / gli orari dei tour,

  • scegliere una data per le prenotazioni a data aperta o per i pacchetti multi-data,

  • annullare le prenotazioni.

📒 NOTA

Aggiungiamo costantemente nuove funzionalità al portale Manage My Booking. Le funzionalità qui elencate erano incluse nella versione iniziale del nuovo MMB. Resta aggiornato per le prossime novità.


Visualizzare l'anteprima di Manage My Booking

Puoi esplorare il portale Manage My Booking utilizzando la tua apiKey.

Utilizza la seguente struttura URL per accedere al portale MMB del tuo web checkout:

https://checkin.ventrata.com/{apikey}

📒 NOTA

Sostituisci {apikey} con la tua chiave API effettiva. Se non sai dove trovarla, consulta Locate API Key for Web Checkout and MMB.


Implementare Manage My Booking (MMB)

Come il checkout widget, il portale può essere incorporato direttamente nella tua pagina oppure essere visualizzato in un popup.

Prerequisiti:

Per impostazione predefinita, il widget cerca qualsiasi elemento con:

ventrata-manage-my-booking

e visualizza il portale all'interno di quell'elemento (modalità incorporata).


Modalità incorporata

Usa la modalità incorporata quando vuoi che l'intero portale MMB venga visualizzato direttamente nella tua pagina web.

Esempio:

 <div ventrata-manage-my-booking data-config='{}'></div>

Risultato:

Il portale viene caricato all'interno del <div> e diventa parte del layout della pagina.


Modalità pop-up

Se vuoi che il portale MMB si apra in un pop-up quando un utente fa clic su un pulsante o su un link, imposta:

  • popup: true

    oppure

  • embedded: false

In questo caso, l'elemento diventa un elemento cliccabile anziché un contenitore e il portale viene visualizzato in una finestra pop-up sovrapposta.

Esempio:

<button ventrata-manage-my-booking data-config='{ "popup": true }'>
Manage my booking
</button>

Risultato:

Facendo clic sul pulsante si apre il pop-up MMB.

È utile nelle pagine in cui non vuoi riservare spazio all'intero portale incorporato, ad esempio intestazioni, piè di pagina o semplici pulsanti Manage my booking (Gestisci la mia prenotazione).


Aprire MMB con JavaScript

Oltre che tramite l'attributo HTML ventrata-manage-my-booking, il portale Manage My Booking (MMB) può essere aperto anche tramite JavaScript.

Funziona nella stessa maniera del metodo window.Ventrata() del checkout, ma invece apre Manage My Booking.

  • Aprire MMB in un pop-up

    window.VentrataManageMyBooking({   
    apiKey: "YOUR_API_KEY",
    popup: true
    })

    In questo modo il portale MMB si apre immediatamente in un popup.

  • Incorporare MMB in una posizione specifica della pagina

    window.VentrataManageMyBooking(   
    { apiKey: "YOUR_API_KEY" },
    { targetElement: document.getElementById("my-mmb-element") }
    )

    In questo modo il portale MMB viene visualizzato direttamente all'interno di un elemento scelto della pagina.

Indirizzare un cliente alla sua prenotazione

Puoi indirizzare un cliente a una prenotazione specifica nel portale MMB includendo il riferimento della prenotazione e il cognome del cliente in un URL o in una chiamata JavaScript. In questo modo si salta la fase di accesso e il portale si apre con la prenotazione già caricata.

  • Tramite URL

    Utilizza la seguente struttura URL per aprire il portale MMB su una prenotazione specifica:

    https://checkin.ventrata.com/{CHECKOUT_API_KEY}/en/checkin
    ?checkin[reference]={BOOKING_REFERENCE}
    &checkin[verification]={LASTNAME}

    Sostituisci i segnaposto con i valori effettivi:

    • CHECKOUT_API_KEY - la chiave API del checkout

    • BOOKING_REFERENCE - il riferimento della prenotazione del cliente

    • LASTNAME - il cognome del cliente

    Se la prenotazione ha un saldo da pagare, il cliente vedrà un pulsante per pagare l'importo residuo.

  • Tramite JavaScript

    Puoi anche passare i dettagli della prenotazione in modo programmatico utilizzando il metodo window.VentrataManageMyBooking(). In questo modo si apre il portale MMB e il cliente accede automaticamente:

    window.VentrataManageMyBooking({
    apiKey: "CHECKOUT_API_KEY",
    popup: true,
    checkin: {
    reference: "BOOKING_REFERENCE",
    verification: "LASTNAME"
    }
    })

    Sostituisci i segnaposto con i valori effettivi:

    • CHECKOUT_API_KEY - la chiave API del checkout

    • BOOKING_REFERENCE - il riferimento della prenotazione del cliente

    • LASTNAME - il cognome del cliente


Modalità chiara / scura

Il portale MMB supporta la modalità chiara e la modalità scura.

  • La modalità chiara è quella predefinita.

  • Per attivare la modalità scura, inserisci "defaultTheme": "dark" nell'attributo data-config dello script del checkout.

Chiara

Scura

📗 SUGGERIMENTO


Accedere a MMB

I clienti possono accedere con uno dei seguenti metodi per visualizzare tutte le prenotazioni attive e passate:

  • E-mail (Email) - inserisci l'indirizzo email fornito al momento della prenotazione. Premi il pulsante Send verification code (Invia codice di verifica), quindi inserisci il codice di verifica a 6 cifre inviato a quell'indirizzo email.

  • Booking reference (Riferimento della prenotazione) - inserisci il riferimento della prenotazione e il cognome indicato nella prenotazione, quindi premi il pulsante Verify (Verifica) per accedere.

Manage My Booking - Accesso


Panoramica di MMB

I clienti possono visualizzare e gestire contemporaneamente tutte le prenotazioni associate allo stesso indirizzo:

Elementi di MMB

#

Elementi di MMB

Descrizione

1.

Icona utente

Premi per accedere all'impostazione della lingua o per uscire dal tuo account.

2.

Upcoming Bookings (Prenotazioni future) / Past Bookings (Prenotazioni passate)

Mostra tutte le prenotazioni future. / Mostra tutte le prenotazioni passate.

3.

Singole prenotazioni

Mostra le singole prenotazioni acquistate dal cliente: nome del prodotto, numero di riferimento della prenotazione, numero e tipo di biglietti e data di viaggio.

4.

Etichette

Mostrano lo stato della prenotazione se è previsto un pagamento o se la prenotazione è stata annullata.

È possibile accedere a MMB anche da telefono cellulare:

Visualizzazione di MMB su dispositivo mobile

Dettaglio della prenotazione

Seleziona una singola prenotazione per visualizzare maggiori informazioni e accedere ad altre opzioni di gestione della prenotazione:

Dettaglio della prenotazione

#

Elementi della prenotazione

Descrizione

1.

Icona utente

Premi per accedere all'impostazione della lingua o per uscire dal tuo account.

2.

Requirements (Requisiti)

Completa le azioni obbligatorie prima di entrare nell'attrazione.

3.

Booking Management (Gestione della prenotazione)

Modifica la prenotazione, se consentito.

4.

Add-ons (Componenti aggiuntivi)

Seleziona gli upgrade, se disponibili per la prenotazione.

  • Available Upgrades (Upgrade disponibili)

5.

Your ticket (Il tuo biglietto)

Accedi ai biglietti del cliente una volta che la prenotazione è stata pagata.

  • Download Tickets (Scarica i biglietti)

  • Resend Confirmation (Invia di nuovo la conferma)

  • Add to Apple Wallet (Aggiungi ad Apple Wallet)

  • Add to Google Wallet (Aggiungi a Google Wallet)

6.

Nome della prenotazione e del biglietto

Il nome e l'opzione acquistata.

7.

Riferimento della prenotazione

Identificativo univoco della prenotazione.

8.

Tickets (Biglietti)

Numero e tipo di biglietti.

9.

Data e ora

Data e ora della prenotazione.

10.

Instructions (Istruzioni)

Informazioni sul punto d'incontro o altre istruzioni necessarie.

11.

Redemption (Riscatto)

Istruzioni per il riscatto della prenotazione.

12.

Your invoice (La tua fattura)

Informazioni sul pagamento.

13.

Download invoice (Scarica la fattura)

Premi per accedere alla fattura stampabile.

Se una prenotazione viene annullata, il dettaglio della prenotazione mostra la data e l'ora dell'annullamento e, se applicabile, la fattura di rimborso.

Data e ora dell'annullamento

Fattura / Pagamento / Rimborso


Riprogrammare una prenotazione

Il Reschedule Flow (Flusso di riprogrammazione) consente ai clienti di modificare la data e l'orario del tour di una prenotazione attiva.


Scegliere una data per una prenotazione a data aperta

Per le prenotazioni a data aperta, i clienti possono selezionare la data e l'orario del tour dopo l'acquisto.


Gestire una prenotazione multi-data

I pacchetti multi-data consentono ai clienti di selezionare la data e l'orario del tour per ciascun incluso del pacchetto. L'intervallo di tempo è definito dall'impostazione 'Validity Days (Giorni di validità)'.


Riprogrammare un pacchetto multi-data (tipo pass)

Modifica la data e l'orario di ciascun incluso di un pass multi-data.


Riprogrammare un pacchetto multi-data (tipo non pass)

Modifica la data e l'orario degli inclusi interdipendenti di un pacchetto multi-data.


Selezionare i punti di raccolta o di discesa

Consenti ai clienti di selezionare o modificare i punti di raccolta e di discesa dopo aver prenotato un tour.


Annullare

I clienti possono annullare le prenotazioni che non sono ancora state riscattate, la cui data o il cui orario del tour non sono ancora passati e che rientrano nel periodo di preavviso di annullamento o di cutoff.


Pagare il saldo residuo

Il flusso Pay Unpaid Balance (Paga il saldo residuo) consente ai clienti di saldare qualsiasi pagamento in sospeso.


Riscattare un voucher del rivenditore

I clienti possono selezionare la data e l'orario preferiti per riscattare un voucher del rivenditore acquistato in precedenza.


Firmare le liberatorie

Consenti ai clienti di leggere e firmare le liberatorie obbligatorie prima del tour tramite il portale self-service Manage My Booking (MMB).

Hai ricevuto la risposta alla tua domanda?