Ereignis-Analytics

Sie können diese Funktion nutzen, wenn Sie Pay Station bereits integriert und mindestens eines der folgenden Konten eingerichtet haben:

Achtung

Google Analytics und Meta erfassen Daten, wenn ein Nutzer der Verwendung aller Cookies oder der Verwendung von Analyse- und Leistungs-Cookies auf dem DSGVO-Banner zugestimmt hat.

Die über das Zahlungsportal erfassten Analytics-Daten basieren auf getrackten Ereignissen. Diese Daten sind möglicherweise unvollständig, da bei einigen Nutzern keine Ereignisse erfasst werden. Der Fall tritt in folgenden Situationen auf:

  • Der Nutzer ignoriert das Banner, in dem um die Einwilligung zur Erhebung von Analytics-Daten gefragt wurde, wählt stattdessen keine Option aus, nutzt das Zahlungsportal jedoch weiterhin.
  • Der Nutzer schließt das Banner, was automatisch als Verweigerung der Einwilligung zur Datenerfassung gewertet wird.
  • Der Nutzer lehnt die Datenerfassung ausdrücklich ab und markiert das entsprechende Kästchen auf dem Banner.

Dieses Systemverhalten ist beabsichtigt und steht in vollem Einklang mit der DSGVO sowie anderen geltenden Vorschriften zur Erfassung, Verarbeitung und Speicherung personenbezogener Daten.

Integration in Analytics-Plattformen

Wenn Sie Ereignisse tracken möchten, die eintreten, wenn Nutzer mit dem Zahlungsportal interagieren, verknüpfen Sie im Kundenportal eine der folgenden Analytics-Plattformen:

Google Analytics

So verknüpfen Sie die Analytics-Plattform:

  1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Zahlungen > Zahlungsportal > Allgemeine Einstellungen.
  2. Wählen Sie im Abschnitt Apps die Option Google Analytics.
  3. 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 Engagement > Ereignisse > Top-Ereignisse.

Folgende Ereignisse lassen sich tracken:

EreignisBeschreibung
open-paystationÖffnen des Zahlungsportals. Wird während der Initialisierung gesendet.
open-{state_name}Öffnen der Zahlungsportal-Seite.
open-payment-credit-cardÖffnen des Zahlungsportals zum Eingeben der Kartendaten.
open-payment-saved-methodsÖffnen der Seite mit gespeicherten Zahlungsmethoden.
open-payment-payment-methodsÖffnen der Liste aller verfügbaren Zahlungsmethoden beim Klick auf Mehr.
open-payment-{id}Öffnen der Seite für eine spezifische Zahlungsmethode, wobei id die Zahlungsmethoden-ID ist.
open-external-pagesÖffnen externer Seiten vom Zahlungsportal aus.
open-statusÖffnen der Zahlungsstatus-Seite.
open-status-processingÖffnen der Zahlungsstatus-Seite während der Zahlungsabwicklung (Status: processing). Nach Abschluss wechselt der Status zu success oder error.
open-status-errorÖffnen der Statusseite bei einem Zahlungsfehler (Status: error).
open-status-successÖffnen der Statusseite bei erfolgreicher Zahlung (Status: success).
choose-payment-widgetAuswahl eines Zahlungsmethoden-Widgets.
choose-methodAuswahl einer Zahlungsmethode.
click-btn-payKlick auf die Schaltfläche Jetzt zahlen in der Zahlungsdaten-Eingabemaske.
click-btn-return-urlKlick auf die Schaltfläche zur Rückkehr zum Shop (Zurück zum Spiel).
click-additional-btn-return-urlKlick auf eine zusätzliche Schaltfläche zur Rückkehr zum Shop.
create-invoiceErstellen einer Transaktion. Ändert sich in ein purchase-Ereignis mit zusätzlichen Kaufparametern (Artikel, Betrag, Währung).
purchaseAbschluss eines Kaufs. Das Ereignis wird gesendet, wenn eine Rechnung angelegt wird, und enthält detaillierte Kaufinformationen, einschließlich Artikelkosten und Steuern. Das Ereignis wird nur gesendet, wenn im Kundenportal ein Artikelkatlog konfiguriert ist.
change-statusÄndern des Zahlungsstatus. Wird mit einem zusätzlichen status-Parameter gesendet.

Allgemeine Ereignisparameter (werden bei jedem Ereignis gesendet):

ParameterBeschreibung
categoryImmer paystation.
versionZahlungsportal-Version.
projectIdProjekt-ID.
projectNameProjektname.
user_idBenutzer-ID.
v1Benutzer-ID (dupliziert user_id).
countryLändercode der Zahlung.
external_idExterne ID (falls verfügbar).
purchase_invoice_idRechnungs-ID aufseiten von Xsolla.
pidZahlungsmethoden-ID.
total_sumGesamtkaufbetrag inklusive aller Gebühren.
total_sum_currencyWährung des Gesamtkaufbetrags.
purchase_skuArtikel-SKU.
purchase_sku_digitalContentSKU des digitalen Inhalts.

Zusätzliche Parameter für das Kaufereignis:

ParameterBeschreibung
transaction_idTransaktions-ID.
currencyWährung.
valueBetrag ohne Steuern.
itemsArtikel-Array mit Parametern:
  • item_id – Artikel-ID
  • item_name – Artikel-SKU
  • price – Artikelpreis
  • quantity – Artikelmenge

Meta Analytics

So verknüpfen Sie die Analytics-Plattform:

  1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Zahlungen > Zahlungsportal > Allgemeine Einstellungen.
  2. Wählen Sie im Abschnitt Apps die Option Meta Pixel.
  3. Klicken Sie auf Verknüpfen.

Wenn Sie Meta-Pixel verknüpfen, werden die entsprechenden Ereignisse an Ihr Werbeanzeigenmanager-Konto bei Meta gesendet. Dieses Ereignisse finden Sie im Werbeanzeigenmanager von Meta unter Werbeeinstellungen > Datensätze und Pixel.

Folgende Ereignisse lassen sich tracken:

EreignisBeschreibung
open-{state_name}Öffnen einer Seite im Zahlungsportal. Der Statusname wird in parameters übermittelt.
click-btn-payKlick auf die Schaltfläche Jetzt bezahlen im Rechnungsformular. Die Zahlungsmethode wird in parameters übermittelt.
returnKlick 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-invoiceTransaktionserstellung.
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-methodAuswahl einer Zahlungsmethode beim Öffnen der Liste weitere.

Wenn Sie Google Analytics und Meta-Pixel integrieren, werden die entsprechenden Ereignisse an Ihre Google-Analytics- und Meta-Werbeanzeigenmanager-Konten übermittelt.

GameAnalytics

So verknüpfen Sie die Analytics-Plattform:

  1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Zahlungen > Zahlungsportal > Allgemeine Einstellungen.
  2. Wählen Sie im Abschnitt Apps die Option GameAnalytics.
  3. Klicken Sie auf Verknüpfen.
  1. Geben Sie im Feld GameAnalytics-Spielschlüssel den Spielschlüssel ein. Den Schlüssel finden Sie in Ihrem GameAnalytics-Konto:
    1. Wählen Sie im Drop-down-Menü in der oberen Leiste das Spiel aus.
    2. Klicken Sie im Abschnitt Keys auf das Kopieren-Symbol neben dem Game key.
Hinweis
Wenn Ihr Spiel auf mehreren Plattformen veröffentlicht ist und für jede dieser Plattformen in GameAnalytics eigene Projekte angelegt sind, können Sie im Kundenportal einen Spielschlüssel für jede dieser Plattformen eingeben.
  1. 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 Monetization.

Zahlungsportal-Ereignisse

Zahlungsportal-Ereignisse werden über den postMessage-Mechanismus verarbeitet, wenn das Zahlungsportal in einem Iframe, einem neuen Fenster oder mittels Pay Station Embed geöffnet wird.

Beispielszenario für die Verarbeitung von über postMessage gesendeten Nachrichten:

  1. Abonnieren Sie den Empfang von über postMessage gesendeten Nachrichten.
  2. Parsen Sie die Daten für das Ereignis in ein JSON-Format.
  3. Prüfen Sie, ob das zu verarbeitende Ereignis vorhanden ist.
  4. 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.

Beispiel:
Copy
Full screen
Small screen
1window.addEventListener('message', (event) => {
2  const eventData = JSON.parse(event.data);
3
4  if (eventData.command === 'open-payment') {
5    console.log('hello!')
6  }
7});
EreignisBeschreibung
add_saved_accountErfolgreiches Speicherung eines Zahlungskontos.
add_saved_account_errorFehler beim Speichern eines Zahlungskontos.
cancel_save_accountWiderruf der Speicherung eines Zahlungskontos durch einen Benutzer.
cart_displayDarstellung des Zahlungsportals in Spaltenform. Mögliche Werte für den Parameter value:
  • bei 1 wird das Zahlungsportal zweispaltig geöffnet
  • bei 0 wird das Zahlungsportal einspaltig geöffnet, z. B., auf der Seite zum Verwalten von Zahlungsmethoden
Beispiel: {“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-methodAuswahl einer Zahlungsmethode beim Öffnen der Liste weitere.
click-custom-package-continueKlick auf die Schaltfläche Weiter zum Kauf einer beliebigen Menge virtueller Währung.
click-commentKlick auf die Schaltfläche zum Veröffentlichen eines Beitrags.
click-buy-packageKlick auf die Schaltfläche Paket kaufen zum Kauf eines virtuellen Währungspakets.
click-buy-gift-packageKlick auf die Schaltfläche zum Kauf eines virtuellen Währungspakets als Geschenk.
click-buy-gift-custom-packageKlick auf die Schaltfläche zum Kauf einer beliebigen Menge virtueller Währung als Geschenk.
click-btn-payKlick auf die Schaltfläche Jetzt bezahlen im Rechnungsformular.
click-btn-pay-gpKlick auf die Schaltfläche zum Bezahlen über Google Pay.
click-btn-continueKlick auf die Schaltfläche zum Abschluss eines kostenpflichtigen Abonnements.
click-btn-applyKlick auf die Schaltfläche Anwenden zum Einlösen eines Gutscheins.
click-btn-activateKlick auf die Schaltfläche Aktivieren zum Aktivieren eines Spielschlüssels.
click-btn-acceptKlick auf die Schaltfläche zum Kauf digitaler Inhalte.
create-invoiceTransaktionserstellung.
dimensionsWird die Pay Station in einem iframe geöffnet, werden die Höhe und Breite des iframe in den Parametern width und height übermittelt.
errorEin Fehler, der während des Bezahlvorgangs auftritt:
  • Der Fehlercode wird im Parameter data.code übermittelt.
  • Die im Zahlungsportal angezeigte Fehlerbeschreibung wird im Parameter data.message übermittelt.
  • Der Parameter canRetryPayment wird auf true gesetzt, wenn dem Nutzer die Schaltfläche Erneut versuchen angezeigt wird.
external-link-openWeiterleitung zu einer externen Ressource. Die Adresse, an die die Weiterleitung erfolgt, wird im Parameter url übermittelt.
external-payment-openUmleitung 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”}}.
openlinkÖffnung der rechtlichen Informations-Links im Footer des Zahlungsportals.
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.
statusWechsel zur Zahlungsstatusseite: Folgende Parameter lassen sich übermitteln:
  • status — Zahlungsstatus
  • email — E-Mail-Adresse des Benutzers
  • invoice — Transaktions-ID
  • virtualCurrencyAmount — Betrag der erworbenen virtuellen Währung
  • userId — Benutzer-ID
  • discount — der auf die Zahlung angewandte Rabatt
status-redeemDie Gutscheineinlösung in einem Zahlungsformular.
closeSchließen des Zahlungsportals.
returnKlick auf die Schaltfläche zur Rückkehr von der Zahlungsstatusseite zur Anwendung.

Die Ereignisparameter werden in jeder Meldung von postMessage übergeben. Wenn die Parameterinformationen noch nicht erfasst wurden, wird ein leerer String angezeigt.

ParameterTypBeschreibung
action
stringEreignisname.
value
stringWeitere Parameter. Enthält spezifische Ereignisparameter, die je nach Wahl des Benutzers variieren.
state
stringDie Zahlungsportal-Seite, auf welcher die Aktion ausgeführt wurde.
date
stringDatum und Uhrzeit im GMT-Format.
is_webview
numberOb das Zahlungsportal im Ingame-Browser (WebView) geöffnet wird. Mögliche Werte: 0, 1.
milliseconds
numberDatum und Uhrzeit im Unixzeit-Format.
timezone
stringZeitzone des Benutzers.
session_id
stringSitzungs-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
stringZahlungsland.
purchase_external_id
stringRechnungsnummer im System des Partners.
purchase_type
stringKauftyp. Möglich sind: virtual item, virtual currency, pay2play, subscription.
purchase_sum
numberNominaler Kaufbetrag.
purchase_currency
stringKaufwährung.
purchase_sku
stringSKU des erworbenen Gegenstands.
purchase_digital_content_sku
stringSKU des erworbenen Spielschlüsselpakets.
purchase_description
stringKaufbeschreibung.
virtual_currency_amount
numberBetrag in virtueller Währung.
coupon_code
stringGutscheincode.
subscription_package_external_id
numberAbonnement-ID.
subscription_package_name
stringAbonnement-Name.
subscription_package_description
stringAbonnement-Beschreibung.
total_sum
numberGesamtkaufpreis. Inklusive aller Gebühren.
total_sum_currency
stringWährung des Gesamtkaufpreises.
user_id
stringBenutzer-ID (v1).
user_country
stringLand des Benutzers.
payment_instance_name
stringName der Zahlungsmethode.
payment_instance_id
stringZahlungsmethoden-ID. Die Liste der verfügbaren Methoden finden Sie in Ihrem Projekt im Kundenportal unter Zahlungen > Zahlungsmethoden.
payment_with_saved_method
numberOb ein Nutzer eine Zahlung mit einer gespeicherten Zahlungsmethode abgeschlossen hat. Mögliche Werte: 0, 1.
payment_with_saving_method
numberOb ein Nutzer die Zahlungsmethode beim Kauf gespeichert hat. Mögliche Werte: 0, 1.
purchase_invoice_id
numberRechnungsnummer im Xsolla-System.
Hinweis
Ab dem 1. Juni 2026 wird die Transaktions-ID im int64-Format übermittelt. Der Höchstwert ist also (2^63)−1. Wenn Sie einen numerischen Datentyp verwenden, müssen Sie sicherstellen, dass dieser 64-Bit-Integer unterstützt. Alternativ können Sie als Datentyp einen String verwenden.

Ereignisse sind mit den Seiten verknüpft, auf denen der Benutzer alle Aktionen beim Kauf eines Gegenstands ausführt.

ZustandBeschreibung
cartSeite mit dem ausgewählten, gegen virtuelle Währung erworbenen Gegenstand und einer Kaufbestätigung.
couponGutschein-Eingabeformular.
giftcardSeite mit Geschenkkartenliste (Geschenkkarten-Widget).
giftrecipientSeite zum Kauf von Geschenken.
historySeite mit der Kaufhistorie.
indexService-Seite, auf die der Benutzer nach dem Öffnen der Anwendung weitergeleitet wird. Wird dem Benutzer nicht angezeigt.
legalMobile Version der Seite mit Links zu rechtlichen Dokumenten.
listListe der Zahlungsmethoden.
paybycashSeite mit der Liste der Zahlungsmethoden für den Kauf an Automaten (Bargeldzahlung-Widget).
paymentZahlungsformular.
paymentaccountSeite mit den gespeicherten Zahlungskonten.
paymentreturnService-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.
pincartSeite mit der Liste der Plattformen für digitale Inhalte.
pricepointOnline-Shop für virtuelle Währung.
savedmethodListe der gespeichterten Zahlungsmethoden.
shippingaddressLieferanschrift-Formular.
statusStatusseite.
subscriptionOnline-Shop für Abo-Modelle.
subscriptionchangeÄnderung von Abo-Modellen.
useraccountSeite mit Kontoinformationen (Benutzername, Guthaben) samt Option Bestätigungsfenster beim zukünftigen Kauf von Gegengenständen deaktivieren.
userinventoryBenutzer-Inventar.
usermenuMobile Version der Benutzermenü-Seite.
usersubscriptionVerwaltung von Benutzerabonnements.
usersubscriptioninfoSeite mit Abonnement-Angaben.
virtualitemOnline-Shop für virtuelle Gegenstände.

Damit Ereignisse an Ihre Google Analytics- und Meta-Werbeanzeigenmanager-Konten übermittelt werden, müssen Sie die jeweilige Analytics-Plattform integrieren.

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 22. Juli 2026

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!
Ihr Feedback konnte nicht gesendet werden
Versuchen Sie es später erneut oder kontaktieren Sie uns unter [email protected].