Ereignis-Analytics
Sie können diese Funktion nutzen, wenn Sie Pay Station bereits integriert und mindestens eins der folgenden Konten eingerichtet haben:
Google Analytics und Facebook sammeln Daten, wenn ein Nutzer der Verwendung aller Cookies oder der Verwendung von Analyse- und Leistungs-Cookies auf dem DSGVO-Banner zugestimmt hat.
Integration in Analyseplattformen
Wenn Sie Ereignisse tracken möchten, die im Zahlungsportal eintreten, wenn Nutzer damit interagieren, müssen Sie eine der folgenden Analytics-Plattformen in Ihrem Kundenportal verknüpfen:
Google Analytics
So verknüpfen Sie die Analytics-Plattform:
- Öffnen Sie Ihr Projekt im Kundenportal.
- Navigieren Sie zu Bezahlstation > Einstellungen.
- Scrollen Sie zum Abschnitt Apps, und wählen Sie Google Analytics.
- Klicken Sie auf Verknüpfen.
Wenn Sie Google Analytics verknüpfen, werden die entsprechenden Ereignisse an Ihr Google Analytics-Konto gesendet. Dieses Ereignisse finden Sie in Google Analytics unter
Sie können die folgenden Ereignisse nachverfolgen:
Aktion | Beschreibung |
---|---|
open-{state_name} | Öffnen einer Seite im Zahlungsportal. |
click-btn-pay | Klick auf die Schaltfläche Jetzt bezahlen im Rechnungsformular. |
return | Klick auf die Schaltfläche Zurück zum Online-Shop/Erneut beginnen. |
create-invoice | Transaktionserstellung. |
purchase | Anlegen einer Rechnung (Zuweisung einer Transaktions-ID). Die Ereignisparameter enthalten detaillierte Informationen zu einem Kauf, einschließlich Artikelpreis und Steuern. Eine Beschreibung der Parameter finden Sie in der Google Analytics-Dokumentation. Das Ereignis wird nur gesendet, wenn Sie im Kundenportal den Katalog unter Store konfiguriert haben. |
open-payment-credit-card | Öffnen des Zahlungsportals zur Eingabe der Kartendaten. |
open-payment-saved-methods | Öffnen der Seite mit den gespeicherten Zahlungsmethoden. |
open-payment-payment-methods | Öffnen der Liste aller verfügbaren Zahlungsmethoden beim Klick auf weitere. |
open-payment-{id} | Öffnen der Seite einer bestimmten Zahlungsmethode, wobei id die ID der Zahlungsmethode ist. |
open-status | Öffnen einer Zahlungsstatusseite. |
open-status-processing | Öffnen der Zahlungsstatusseite “Wird verarbeitet” (processing ). Nachdem die Verarbeitung abgeschlossen ist, ändert sich der Status entweder in “Erfolgreich” (success ) oder “Fehler” (error ). |
open-status-error | Öffnen der Zahlungsstatusseite “Fehler” (error ). |
open-status-success | Öffnen der Zahlungsstatusseite “Erfolgreich” (success ). |
choose-method | Auswahl einer Zahlungsmethode beim Öffnen der Liste weitere. |
Dimension-ID | Bezeichnung | Beschreibung |
---|---|---|
1 | version | Version der Pay Station. |
2 | purchase_invoice_id | Rechnungsnummer im Xsolla-System. |
3 | external_id | Rechnungsnummer im System des Partners. |
5 | total_sum | Gesamtkaufpreis. Inklusive aller Gebühren. |
6 | total_sum_currency | Währung des Gesamtkaufpreises. |
7 | pid | ID des Zahlungssystems. |
8 | projectId | Projekt-ID. |
9 | country | Zahlungsland. |
10 | projectName | Name des Projekts. |
Facebook Analytics
So verknüpfen Sie die Analytics-Plattform:
- Öffnen Sie Ihr Projekt im Kundenportal.
- Navigieren Sie zu Bezahlstation > Einstellungen.
- Scrollen Sie zum Abschnitt Apps, und wählen Sie Facebook Pixel.
- Klicken Sie auf Verknüpfen.
Wenn Sie Facebook Pixel verknüpfen, werden die entsprechenden Ereignisse an Ihr Facebook Analytics-Konto gesendet. Dieses Ereignisse finden Sie in Facebook Analytics unter
Sie können die folgenden Ereignisse nachverfolgen:
Ereignis | Beschreibung |
---|---|
open-{state_name} | Öffnen einer Seite im Zahlungsportal. Der Statusname wird in parameters übermittelt. |
click-btn-pay | Klick auf die Schaltfläche Jetzt bezahlen im Rechnungsformular. Die Zahlungsmethode wird in parameters übermittelt. |
return | Klick auf die Schaltfläche Zurück zum Online-Shop/Erneut beginnen. Der Statusname wird in parameters übermittelt. |
change-status-{status_name} | Ändern des Zahlungsstatus. Wenn der Benutzer das Zahlungsportal schließt oder die Seite verlässt und sich anschließend der Status ändert, wird die Ereignismeldung nicht gesendet. |
create-invoice | Transaktionserstellung. |
open-payment-credit-card | Öffnen des Zahlungsportals zur Eingabe der Kartendaten. |
open-payment-saved-methods | Öffnen der Seite mit den gespeicherten Zahlungsmethoden. |
open-payment-payment-methods | Öffnen der Liste aller verfügbaren Zahlungsmethoden beim Klick auf weitere. |
open-payment-{id} | Öffnen der Seite einer bestimmten Zahlungsmethode, wobei id die ID der Zahlungsmethode ist. |
open-status | Öffnen einer Zahlungsstatusseite. |
open-status-processing | Öffnen der Zahlungsstatusseite “Wird verarbeitet” (processing ). Nachdem die Verarbeitung abgeschlossen ist, ändert sich der Status entweder in “Erfolgreich” (success ) oder “Fehler” (error ). |
open-status-error | Öffnen der Zahlungsstatusseite “Fehler” (error ). |
open-status-success | Öffnen der Zahlungsstatusseite “Erfolgreich” (success ). |
choose-method | Auswahl einer Zahlungsmethode beim Öffnen der Liste weitere. |
Um die Analyseplattform zu integrieren:
- Gehen Sie zu Ihrem Kundenportal > Pay Station > Einstellungen.
- Wählen Sie Google Analytics/Facebook Pixel Im Bereich Apps.
- Geben Sie Ihre Tracking-ID ein und klicken Sie auf Verbinden.
Wenn Sie Google Analytics und Facebook Pixel integrieren, werden die entsprechenden Ereignisse an Ihre Google Analytics- und Facebook Analytics-Konten übermittelt.
GameAnalytics
So verknüpfen Sie die Analytics-Plattform:- Öffnen Sie Ihr Projekt im Kundenportal.
- Navigieren Sie zu Pay Station > Einstellungen.
- Scrollen Sie zum Abschnitt Apps, und wählen Sie GameAnalytics.
- Klicken Sie auf Verknüpfen.
- Geben Sie im Feld GameAnalytics-Spielschlüssel den Spielschlüssel ein. Diesen finden Sie in Ihrem GameAnalytics-Konto:
- Wählen Sie in der oberen Leiste im Drop-down-Menü das Spiel aus.
- Klicken Sie im Abschnitt
Keys auf das Kopieren-Symbol nebenGame key .
- Klicken Sie auf Verknüpfen.
Derzeit ist es dank der Integration der GameAnalytics-Plattform möglich, Informationen über erfolgreiche Zahlungsereignisse zu erhalten. Sie finden diese Daten in Ihrem GameAnalytics-Konto auf dem Dashboard im Bereich
Zahlungsportal-Ereignisse
Zahlungsportal-Ereignisse werden über einen postMessage
-Vorgang beim Öffnen der Pay Station in einem iframe, einem neuem Fenster oder mittels Pay Station Embed verarbeitet.
Beispielszenario für die Verarbeitung von über postMessage
gesendeten Nachrichten:
- Abonnieren Sie den Empfang von über
postMessage
gesendeten Nachrichten. - Parsen Sie die Daten für das Ereignis in ein JSON-Format.
- Prüfen Sie, ob das zu verarbeitende Ereignis vorhanden ist.
Wurde das gewünschte Ereignis empfangen, implementieren Sie die Logik für dessen Verarbeitung. In dem folgenden Beispiel ist der Text in der Konsole ausgegeben. Sie können Ihre eigene Logik ergänzen.
window.addEventListener('message', (event) => {
const eventData = JSON.parse(event.data);
if (eventData.command === 'open-payment') {
console.log('hello!')
}
});
Ereignis | Beschreibung |
---|---|
add_saved_account | Erfolgreiches Speicherung eines Zahlungskontos. |
add_saved_account_error | Fehler beim Speichern eines Zahlungskontos. |
cancel_save_account | Widerruf der Speicherung eines Zahlungskontos durch einen Benutzer. |
cart_display | Darstellung des Zahlungsportals in Spaltenform. Mögliche Werte für den Parameter value :
{“command”:“cart_display”,“data”:{“value”:“1”,“version”:“Pay Station 4”}} . |
change-status | Ändern des Zahlungsstatus. Wenn der Benutzer das Zahlungsportal schließt oder die Seite verlässt und sich anschließend der Status ändert, wird die Ereignismeldung nicht gesendet. |
choose-method | Auswahl einer Zahlungsmethode beim Öffnen der Liste weitere. |
click-custom-package-continue | Klick auf die Schaltfläche Weiter zum Kauf einer beliebigen Menge virtueller Währung. |
click-comment | Klick auf die Schaltfläche zum Veröffentlichen eines Beitrags. |
click-buy-package | Klick auf die Schaltfläche Paket kaufen zum Kauf eines virtuellen Währungspakets. |
click-buy-gift-package | Klick auf die Schaltfläche zum Kauf eines virtuellen Währungspakets als Geschenk. |
click-buy-gift-custom-package | Klick auf die Schaltfläche zum Kauf einer beliebigen Menge virtueller Währung als Geschenk. |
click-btn-pay | Klick auf die Schaltfläche Jetzt bezahlen im Rechnungsformular. |
click-btn-continue | Klick auf die Schaltfläche zum Abschluss eines kostenpflichtigen Abonnements. |
click-btn-apply | Klick auf die Schaltfläche Anwenden zum Einlösen eines Gutscheins. |
click-btn-activate | Klick auf die Schaltfläche Aktivieren zum Aktivieren eines Spielschlüssels. |
click-btn-accept | Klick auf die Schaltfläche zum Kauf digitaler Inhalte. |
create-invoice | Transaktionserstellung. |
dimensions | Wird die Pay Station in einem iframe geöffnet, werden die Höhe und Breite des iframe in den Parametern width und height übermittelt. |
error | Ein Fehler, der während des Zahlungsvorgangs auftritt. Der Fehlercode wird im Parameter data.code und die im Zahlungsportal angezeigte Fehlerbeschreibung im Parameter data.message übermittelt. |
external-link-open | Weiterleitung zu einer externen Ressource. Die Adresse, an die die Weiterleitung erfolgt, wird im Parameter url übermittelt. |
external-payment-open | Umleitung vom Zahlungsportal zu einem externen Zahlungssystem oder 3-D Sicherheitsverifizierung. |
focus-change | Änderung des Fokus auf Elemente des Pay Station-Widgets. Der Fokuszustand wird im Parameter hasFocus übermittelt und kann die Werte true oder false annehmen. |
open-{state_name} | Öffnen einer Seite im Zahlungsportal. |
open-payment-credit-card | Öffnen des Zahlungsportals zur Eingabe der Kartendaten. |
open-payment-saved-methods | Öffnen der Seite mit den gespeicherten Zahlungsmethoden. |
open-payment-payment-methods | Öffnen der Liste aller verfügbaren Zahlungsmethoden beim Klick auf weitere. |
open-payment-{id} | Öffnen der Seite einer bestimmten Zahlungsmethode, wobei id die ID der Zahlungsmethode ist. |
open-status | Öffnen einer Zahlungsstatusseite. |
open-status-processing | Öffnen der Zahlungsstatusseite “Wird verarbeitet” (processing ). Nachdem die Verarbeitung abgeschlossen ist, ändert sich der Status entweder in “Erfolgreich” (success ) oder “Fehler” (error ). |
open-status-error | Öffnen der Zahlungsstatusseite “Fehler” (error ). |
open-status-success | Öffnen der Zahlungsstatusseite “Erfolgreich” (success ). |
order-status | Änderung des Bestellstatus in done . Das Ereignis wird von der Zahlungsstatusseite gesendet, wenn eine Bestellung über einen der folgenden API-Aufrufe angelegt wurde:
Daten über einen Nutzer, eine Transaktion und eine Bestellung werden im data -Objekt übermittelt.Beispiel: {“command”:“order-status”,“data”:{“user_id”:“123abc-456”,“invoice_id”:123456,“price”:{“amount”:“12.96”,“currency”:“USD”},“order_id”:123456,“items”:[{“id”:123456,“sku”:“booster_min”,“quantity”:2,“amount”:“3.99”,“price”:{“amount”:“3.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:123456,“sku”:“boots_1”,“quantity”:1,“amount”:“2.99”,“price”:{“amount”:“2.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:1234567,“sku”:“xsolla_gloves”,“quantity”:1,“amount”:“1.99”,“price”:{“amount”:“1.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:12345678,“sku”:“reward_vp_a”,“quantity”:5,“amount”:“0”,“price”:{“amount”:“0”,“currency”:“USD”},“tax_category”:“DG00001”}],“version”:“Pay Station 4”}} . |
resize | Änderung der Zahlungsportalgröße. Die Breite und Höhe des geöffneten Zahlungsportals werden im data -Objekt übermittelt.Beispiel: {“command”:“resize”,“data”:{“dimensions”:{“width”:924,“height”:754},“version”:“Pay Station 4”}} . |
show-error-page | Öffnen einer Seite mit Fehleranzeige. Ein Fehlercode wird im Parameter value übermittelt. |
status | Wechsel zur Zahlungsstatusseite: Folgende Parameter lassen sich übermitteln:
|
status-redeem | Die Gutscheineinlösung in einem Zahlungsformular. |
close | Schließen des Zahlungsportals. |
Parameter | Typ | Beschreibung |
---|---|---|
action | string | Ereignisname. |
value | string | Weitere Parameter. Enthält spezifische Ereignisparameter, die je nach Wahl des Benutzers variieren. |
state | string | Die Zahlungsportal-Seite, auf welcher die Aktion ausgeführt wurde. |
date | string | Datum und Uhrzeit im GMT-Format. |
milliseconds | number | Datum und Uhrzeit im Unixzeit-Format. |
timezone | string | Zeitzone des Benutzers. |
session_id | string | Sitzungs-ID. Die Sitzung umfasst alle Benutzeraktionen, die innerhalb von 30 Minuten oder bis zum Schließen des Zahlungsportals durchgeführt werden. Die Sitzung beginnt mit dem Aufrufen des Zahlungsportal und wird immer dann gespeichert, wenn die Zahlungsportal-Seite aktualisiert wurde. |
payment_country | string | Zahlungsland. |
purchase_invoice_id | number | Rechnungsnummer im Xsolla-System. |
purchase_external_id | string | Rechnungsnummer im System des Partners. |
purchase_type | string | Kauftyp. Möglich sind: virtual item , virtual currency , pay2play , subscription . |
purchase_sum | number | Nominaler Kaufbetrag. |
purchase_currency | string | Kaufwährung. |
purchase_sku | string | SKU des erworbenen Gegenstands. |
purchase_digital_content_sku | string | SKU des erworbenen Spielschlüsselpakets. |
purchase_description | string | Kaufbeschreibung. |
virtual_currency_amount | number | Betrag in virtueller Währung. |
coupon_code | string | Gutscheincode. |
subscription_package_external_id | number | Abonnement-ID. |
subscription_package_name | string | Abonnement-Name. |
subscription_package_description | string | Abonnement-Beschreibung. |
total_sum | number | Gesamtkaufpreis. Inklusive aller Gebühren. |
total_sum_currency | string | Währung des Gesamtkaufpreises. |
user_id | string | Benutzer-ID (v1). |
user_country | string | Land des Benutzers. |
payment_instance_name | string | Name der Zahlungsmethode. |
Zustand | Beschreibung |
---|---|
cart | Seite mit dem ausgewählten, gegen virtuelle Währung erworbenen Gegenstand und einer Kaufbestätigung. |
coupon | Gutschein-Eingabeformular. |
giftcard | Seite mit Geschenkkartenliste (Geschenkkarten-Widget). |
giftrecipient | Seite zum Kauf von Geschenken. |
history | Seite mit der Kaufhistorie. |
index | Service-Seite, auf die der Benutzer nach dem Öffnen der Anwendung weitergeleitet wird. Wird dem Benutzer nicht angezeigt. |
legal | Mobile Version der Seite mit Links zu rechtlichen Dokumenten. |
list | Liste der Zahlungsmethoden. |
paybycash | Seite mit der Liste der Zahlungsmethoden für den Kauf an Automaten (Bargeldzahlung-Widget). |
payment | Zahlungsformular. |
paymentaccount | Seite mit den gespeicherten Zahlungskonten. |
paymentreturn | Service-Seite, auf die der Benutzer nach erfolgter Zahlung umgeleitet wird und von der aus der Benutzer auf die Statusseite weitergeleitet wird. Wird dem Benutzer nicht angezeigt. |
pincart | Seite mit der Liste der Plattformen für digitale Inhalte. |
pricepoint | Online-Shop für virtuelle Währung. |
savedmethod | Liste der gespeichterten Zahlungsmethoden. |
shippingaddress | Lieferanschrift-Formular. |
status | Statusseite. |
subscription | Online-Shop für Abo-Modelle. |
subscriptionchange | Änderung von Abo-Modellen. |
useraccount | Seite mit Kontoinformationen (Benutzername, Guthaben) samt Option Bestätigungsfenster beim zukünftigen Kauf von Gegengenständen deaktivieren. |
userinventory | Benutzer-Inventar. |
usermenu | Mobile Version der Benutzermenü-Seite. |
usersubscription | Verwaltung von Benutzerabonnements. |
usersubscriptioninfo | Seite mit Abonnement-Angaben. |
virtualitem | Online-Shop für virtuelle Gegenstände. |
Um die Ereignisse an Ihre Google Analytics- und Facebook Analytics-Konten zu übermitteln, müssen Sie diese Analyseplattformen integrieren.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.