Fortgeschrittene Funktion: Diese Funktion wird für fortgeschrittene Benutzer empfohlen und erfordert Programmierkenntnisse.
Widget-Callbacks sind nützlich, wenn Sie auf Ihrer Website mit dem Universe-Widget Tickets verkaufen und benutzerdefinierte Aktionen festlegen möchten (z.B. die Weiterleitung zu einer bestimmten Seite), sobald jemand ein Ticket kauft. Widget-Callbacks sind nützlich, um Ihre Konversionen aus der Werbung zu verfolgen. Bitte beachten Sie, dass aufgrund verschiedener Faktoren (Skriptblocker, Werbeblocker usw.) nicht alle Events nachverfolgt werden können und diese Daten ohne Gewähr zur Verfügung gestellt werden.
Eine einfache Widget-Callback-Funktion, die am häufigsten verwendet wird, ist die automatische Umleitung zu einer beliebigen Website-URL.
Widget-Callbacks können beispielsweise verwendet werden, um Ihre Käufer auf eine „Dankeschön-Seite“ oder eine beliebige Website-URL zu leiten, nachdem der Käufer ein Ticket auf Ihrer Website gekauft hat. Um das zu tun, müssen Sie jQuery auf Ihrer Website geladen haben. Um jQuery von Google zu verwenden, fügen Sie das folgende Skript in den Header Ihrer Seite ein:
Um automatische Weiterleitungen einzurichten, müssen Sie den folgenden Code in den Quellcode der Registrierungsseite oder unter dem jQuery-Skript im Header einfügen:
<script type="text/javascript">
document.addEventListener('unii:ticket:purchased', function (event) {
setTimeout(function() {
window.location.assign('THANK_YOU_PAGE_URL');
}, 10000);
}, false);
</script>
document.addEventListener('unii:ticket:purchased', function (event) {
setTimeout(function() {
window.location.assign('THANK_YOU_PAGE_URL');
}, 10000);
}, false);
</script>
Hinweis: Ersetzen Sie „THANK_YOU_PAGE_URL“ durch eine beliebige Website-URL, auf die Sie umleiten möchten.
Hinweis: Die „10000“ im obigen Code ist die Zeit, die benötigt wird, um die Besucher von der Seite mit der Universe-Buchungsbestätigung auf Ihre „Dankeschön-Seite“ umzuleiten. Sie können dies kürzer oder länger einstellen. Diese Zahl wird in Millisekunden angegeben. 10000 steht also für 10 Sekunden, 5000 für 5 Sekunden usw.
Für weiter fortgeschrittene Benutzer besteht die Möglichkeit, die Funktion des Widget-Callbacks anzupassen, um spezifischere Aktionen durchzuführen.
Events
Die folgenden JS-Events werden auf einer Seite ausgelöst, auf der embed.js mit unserem Widget eingebunden ist:
unii:closed
Wird zur Dokumentation versendet, wenn das Pop-over-Widget geschlossen wird. Nimmt keine Rückschlüsse auf den Status des Pop-over oder die Transaktion des Benutzers an.
unii:ticket:purchased
Wird sofort nach erfolgreicher Transaktion zur Dokumentation versendet. Geht nicht davon aus, dass das Fenster geschlossen wurde.
unii:opened
Wird zur Dokumentation versendet, wenn das Pop-over-Widget geöffnet wird. Dieses Event wird erneut ausgelöst, wenn das Pop-over geschlossen und wieder geöffnet wird.
Wird zur Dokumentation versendet, wenn das Pop-over-Widget geschlossen wird. Nimmt keine Rückschlüsse auf den Status des Pop-over oder die Transaktion des Benutzers an.
unii:ticket:purchased
Wird sofort nach erfolgreicher Transaktion zur Dokumentation versendet. Geht nicht davon aus, dass das Fenster geschlossen wurde.
unii:opened
Wird zur Dokumentation versendet, wenn das Pop-over-Widget geöffnet wird. Dieses Event wird erneut ausgelöst, wenn das Pop-over geschlossen und wieder geöffnet wird.
Tipp: Diese Events können abgehört werden. Zum Beispiel:
document.addEventListener('unii:closed', function (event) { console.log('Window was closed'); }, false);
document.addEventListener('unii:ticket:purchased', function (event) {
console.log('Ticket was purchased');
}, false);
Wenn Sie jQuery verwenden, würde das Folgende in den Versionen >= 1.7 funktionieren:
$(document).on('unii:closed', function(event) {
console.log('Window was closed');
});
Fortgeschrittene Benutzer können ihre Widget-Callbacks sogar noch weiter anpassen, indem sie zusätzliche Informationen einfügen, nachdem das Ticket gekauft und das Pop-over-Fenster geschlossen wurde, um weitere Daten zu sammeln.
Eventdetails
„unii:ticket:purchased“ ist ein Spezialfall, bei dem wir zusätzliche Informationen bereitstellen. Das Argument des Events hat eine Detail-Eigenschaft, welche die folgenden Daten enthält:
$(document).on('unii:ticket:purchased', function(event) {
console.log(event.detail);
});
Das event.detail Objekt hat die folgende Struktur:
$(document).on('unii:ticket:purchased', function(event) {
console.log(event.detail);
});
Das event.detail Objekt hat die folgende Struktur:
{
"commission": Number,
"credits_applied": Number,
"discount": Number,
"fee": Number,
"fulfillment": Number,
"subtotal": Number,
"payment": Number,
"price": Number,
"ticket_id": String,
"cost_items": [
{
"id": String,
"commission": Number,
"currency": Number,
"discount": Number,
"description": String,
"fee": Number,
"price": Number,
"rate_id": String
}
]
}
Hinweis: Damit können Sie benutzerdefinierte Analyseberichte über Konversionen pro Ticketart oder eine benutzerdefinierte Quittungsseite usw. einrichten.
Beispiele
Wenn Sie eine Funktion aufrufen möchten, sobald sowohl ein Ticket gekauft als auch das Pop-over geschlossen wurde, können Sie zunächst das Ticketkauf-Event abhören und dann einen Event-Listener für das Schließ-Event hinzufügen. Auf diese Weise können Sie eine Funktion nur dann ausführen, wenn beide Events eingetreten sind:
document.addEventListener('unii:ticket:purchased', function (event) {
document.addEventListener('unii:closed', function (event) {
console.log("Ticket was purchased and window was closed")
}, false);
}, false);
}, false);
Ein weiteres Beispiel ist die Nachverfolgung von Ticketkäufen über Google Analytics. Nachdem Sie eine benutzerdefinierte Metrik mit einem Format für die Währung eingerichtet haben, könnten Sie den folgenden Code verwenden, um Ticketkäufe zu verfolgen:
document.addEventListener('unii:ticket:purchased', function(event) {
if (ga) {
ga('send', 'event', 'category', 'action', {
// Ersetzen Sie „metric1“ durch die ID der Metrik, die Sie zur Verfolgung der Ticketkäufe erstellt haben.
'metric1': event.detail.fulfillment
});
}
}, false);
if (ga) {
ga('send', 'event', 'category', 'action', {
// Ersetzen Sie „metric1“ durch die ID der Metrik, die Sie zur Verfolgung der Ticketkäufe erstellt haben.
'metric1': event.detail.fulfillment
});
}
}, false);