Der Entase-JavaScript-Client ist eine kleine Bibliothek, die Sie über unser CDN laden. Sie ermöglicht Ihrer Website etwas, das sie allein nicht kann: den Entase-Checkout direkt auf der Seite zu öffnen, sodass Besucher ein Ticket kaufen können, ohne die aktuelle Seite zu verlassen.
Er übernimmt das Panel oder Pop-up-Fenster, den Hintergrund, das Sperren des Seiten-Scrollens, den Einwilligungsschritt, die Sprache und Tracking-Parameter. Ihr Code entscheidet, wann der Checkout geöffnet wird und für welche Veranstaltung.
Was er nicht ist
Der Client rendert keine Veranstaltungslisten, Termine, Preise oder Verfügbarkeiten. Wenn Sie ein sofort einsatzbereites Widget wünschen, das Ihr Programm anzeigt, verwenden Sie stattdessen die Einbettungscodes – diese können Sie einfach kopieren und einfügen und benötigen keine Entwicklungsarbeit. Siehe Veranstaltungen auf Ihrer Website einbetten.
Die beiden sind jedoch keine Alternativen. Das Einbettungs-Widget lädt im Hintergrund denselben Client, um seinen Checkout zu öffnen. Deshalb können Sie Client-Optionen über die Einbettungskonfiguration übergeben. Siehe Erweiterte Einbettungsoptionen.
Wann Sie ihn verwenden sollten
Verwenden Sie den Client direkt, wenn Sie eigene Veranstaltungsseiten haben und Ihre eigene Schaltfläche „Tickets kaufen“ den Entase-Checkout öffnen soll:
<button id="buy">Buy tickets</button>
<script src="https://js.entase.com/client.js"></script>
<script>
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
document.getElementById('buy').addEventListener('click', () => {
entase.book('EVENT_ID');
});
</script>Das ist die gesamte Integration. Alles Weitere in diesem Abschnitt dient der Feinabstimmung: welche Optionen verfügbar sind, wie der Checkout zwischen einem Panel und einem Pop-up entscheidet und auf welche Ereignisse Sie reagieren können.
Zwei Checkout-Modi
Der Checkout wird auf eine von zwei Arten geöffnet:
- Panel – ein eingebettetes Panel auf Ihrer Seite, das sich auf Desktop-Geräten von rechts und auf Mobilgeräten von unten einschiebt. Besucher verlassen Ihre Website nie.
- Pop-up – ein separates Browserfenster.
Der Panel-Modus bietet die bessere Nutzererfahrung, ist jedoch nur für Domains verfügbar, die Sie in Ihren Entase-Einstellungen als vertrauenswürdige Origins hinzugefügt haben. Der Client erkennt, welchen Modus er verwenden darf, und wechselt zu einem Pop-up, wenn der eingebettete Checkout nicht zulässig ist. Dies ist das wichtigste Verhalten, das Sie vor der Integration verstehen sollten – siehe Checkout-Modi.
Voraussetzungen
- Eine über HTTPS bereitgestellte Seite. Bei einfachem HTTP verwendet der Client immer ein Pop-up.
- Ihre Domain ist unter vertrauenswürdige Origins in Einstellungen → Integrationen hinzugefügt, wenn Sie den eingebetteten Checkout verwenden möchten. Siehe Integrationen und Checkout-Anpassung.
- Kein Build-Schritt, Bundler oder Paketmanager. Die Bibliothek besteht aus einem einzigen Script-Tag.
Wie es weitergeht
- Den Client installieren – das Script laden und eine Instanz erstellen.
- Konstruktoroptionen – jede Option und ihr Standardwert.
- Den Checkout öffnen – die Methode
book()und Überschreibungen pro Aufruf. - Ereignisse – auf das Öffnen, Schließen und Abschließen des Checkouts reagieren.