Ereignis-Analytics

Sie können diese Funktion nutzen, wenn Sie bereits die Pay Station integriert und mindestens eins der folgenden Konten eingerichtet haben: Google Analytics oder Facebook Ads/Facebook Analytics.

Integration in Analyseplattformen

Durch das Verknüpfen von Google Analytics und Facebook Pixel mit dem Kundenportal können Sie Ereignisse tracken, die in der Pay Station eintreten, wenn Kunden damit interagieren.

Sie können die folgenden Ereignisse nachverfolgen:

Google Analytics

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.
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.

Benutzerdefinierte Dimensionen für Google Analytics

Dimension	Bezeichnung	Beschreibung
1	version	Version der Pay Station.
2	purchase_invoice_id	Rechnungsnummer im Xsolla-System.
3	external_id	Rechnungsnummer im System des Partners.
4	purchase_sku	SKU des erworbenen Gegenstands.
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.
12	purchase_sku_digitalContent	SKU des erworbenen Spielschlüsselpakets.

Facebook Analytics

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.

Sie finden Diese Ereignisse in:

Google Analytics: Behaviour > Events > Top Events
Facebook Analytics: Business Settings > Measure & Report > Analytics > Pixels > Overview

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.

Beispiel:

Copy

Full screen

Small screen

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`: 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-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: Create order with all items from particular cart Create order with all items from current cart Create order with specified item
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` — 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-redeem	Die Gutscheineinlösung in einem Zahlungsformular.
widget-close	Schließen des Zahlungsportals.

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

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.

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

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.

Vielen Dank für Ihr Feedback!

Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.

Diese Seite bewerten

Jetzt nicht

Vielen Dank für Ihr Feedback!

Letztmalig aktualisiert: 10. Oktober 2023

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

Your browser is not supported. Please try a different browser

Payments

Ereignis-Analytics

Integration in Analyseplattformen

Google Analytics

Facebook Analytics

Zahlungsportal-Ereignisse

War dieser Artikel hilfreich?

Diese Seite bewerten

Vielen Dank für Ihr Feedback!