So senden Sie Daten an Google Analytics 4

So funktioniert's

Wenn Sie Daten über die Benutzeraktivitäten und das Verhalten des Startprogramms von Google Analytics 4 als Ereignismeldung erhalten, werden die Daten in der Payload gesendet, wie in der folgende Tabelle aufgeführt.

DimensionBeschreibung
Distrubution platformDie Plattform, die zum Öffnen des Startprogramms verwendet wurde.
Mögliche Werte: Xsolla, Steam.
LanguageLauncher Sprache.
Page titleLauncher Bildschirm. Mögliche Werte sind: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen, Custom tab screen.
Platform game IDSpiel-ID auf der Plattform. Handelt es sich bei der Plattform um Xsolla, dann wird die Projekt-ID aus dem Kundenportal übermittelt.
Stream nameLauncher Name.
Launcher project IDLauncher Projekt-ID aus dem Kundenportal.
Beispiel: 147 ist eine Projekt-ID für https://publisher.xsolla.com/72209/projects/173640/new-launcher/147
Login project IDLogin-Projekt-ID.
App versionLauncher Version.
Build numberBuild-Nummer
Beispiel: Ist 3.0.49-latest.1 die Startprogramm-Version, dann ist die Build-Nummer 1.
Window sizeLauncher Fenstergröße.
Beispiel: 800x600.
Screen resolutionBildschirmauflösung.
Operating system, Operating system with version, OS version.Agent für die Ermittlung des Betriebssystems des Benutzers.
Publisher Account game IDDie aus dem Kundenportal stammende ID des Spiels, auf das sich der Content bezieht. Bezieht sich der Content auf kein Spiel, ist das Feld leer.
City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent IDGeografische Daten.
Die folgende Tabellen enthalten Informationen über zusätzliche Felder für bestimmte Ereignisse. Alle ausgehenden Ereignisse sind nach ihrem Typ gruppiert.

Allgemeine Ereignisse

EreignisBeschreibung
launcher_startLauncher gestartet. Wird nicht gesendet, wenn das Startprogramm infolge eines Updates gestartet wird.
close_appLauncher geschlossen. Wird nicht gesendet, wenn das Startprogramm infolge eines Updates geschlossen wird.

UI-Ereignisse

EreignisBeschreibung
page_viewEin Nutzer öffnet einen Startprogramm-Bildschirm.
logoutEin Benutzer hat auf Abmelden geklickt.

Launcher Update-Ereignisse

EreignisBeschreibung
launcher_update_check_startLauncher sucht nach Updates.
launcher_update_check_completeDas Launcher hat die Suche nach Updates abgeschlossen. Das zusätzliche Feld value enthält den Wert update_found, sofern eine neuere Version im CDN gefunden wurde. Andernfalls lautet der Wert no_updates.
launcher_update_check_skipEin Benutzer hat das Startprogramm-Update übersprungen.
launcher_update_download_startLauncher hat den Download des Updates gestartet.
launcher_update_download_completeLauncher hat den Download des Updates abgeschlossen.
launcher_update_startDas Launcher hat das Update abgeschlossen.
launcher_update_completeLauncher wurde erfolgreich aktualisiert.

Spielbesitzereignisse

EreignisBeschreibung
purchaseÄnderung eines Kaufstatus. Zusätzliche Felder:
  • currency – Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217
  • value – nominaler Kaufbetrag
  • transaction_id – Zahlungs-ID in Xsollas System
  • coupon – Gutscheincode
  • items – Artikelparameter

Content-Ereignisse

EreignisBeschreibung
content_viewMehr als 75% eines Contens wurden angezeigt. Für Content mit dem Status Gruppe wird das Ereignis nicht gesendet. Zusätzliche Felder:
  • content_name – Content-ID
  • content_name – Content-Name
  • content_type – Content-Typ
  • banner_type – Bannertyp
  • target_game_id – ID aus dem Kundenportal oder die Steam App-ID des Spiels, zu dem der Link weiterleitet
  • content_link – URL-Adresse, wenn der Content ein Link oder Video ist
content_clickEin Benutzer hat auf ein Content-Element geklickt.

Autorisierungsereignisse

EreignisBeschreibung
loginEin Benutzer wurde erfolgreich im Startprogramm authentifiziert. Zusätzliche Felder:
  • auth_type – Authentifizierungsoption
  • method – das für die Authentifizierung verwendete soziale Netzwerk

Wie komme ich dazu

  1. Registrieren Sie sich bei Google Analytics, und melden Sie sich bei Ihrem Konto an.
  2. Erstellen und bearbeiten Sie benutzerdefinierte Dimensionen in Google Analytics wie in der folgenden Tabelle dargestellt.
FeldDimensionScopeBeschreibung
analytics_target_game_idAnalytics Target Game IDEventEine ID aus dem Kundenportal oder die Steam App-ID des Spiels, zu dem der Link weiterleitet.
auth_typeAuth TypeEventIm JWT übermittelte Authentifizierungsoption. Mögliche Werte:
  • social – Anmeldung über soziale Netzwerke
  • phone – passwortlose Anmeldung über einen per SMS versendeten Einmalcode
  • email – passwortlose Anmeldung über einen per E-Mail versendeten Einmalcode
  • xsolla_login – klassische Anmeldung über Benutzername/E-Mail-Adresse und Passwort mithilfe des Xsolla-Datenspeichers
  • firebase – klassische Anmeldung über Benutzername/E-Mail-Adresse und Passwort mithilfe des Firebase-Datenspeichers
  • playfab – klassische Anmeldung über Benutzername/E-Mail-Adresse und Passwort mithilfe des PlayFab-Datenspeichers
  • proxy – klassische Anmeldung über Benutzername/E-Mail-Adresse und Passwort mithilfe eines eigenen Datenspeichers
  • device – Anmeldung per Geräte-ID
  • server_custom_id – Anmeldung per selbst definierter ID (eine auf Ihrem Server generierte Benutzer-ID)
content_idContent IDEventID der Content-Kachel.
content_linkContent LinkEventURL-Adresse, sofern der Content ein Link oder Video ist.
content_nameContent NameEventName der Content-Kachel in Englisch.
content_typeContent TypeEventConten-Typ. Mögliche Werte: news, link internal, link external, video.
distribution_platformDistribution PlatformEventDie Plattform, die zum Öffnen des Startprogramms verwendet wurde.
Mögliche Werte: Xsolla, Steam.
game_nameGame NameEventSpielname in Englisch.
game_platformGame PlatformEventSpielplattform. Mögliche Werte: Xsolla, Steam.
build_numberLauncher Build NumberEventBuild-Nummer
Beispiel: Ist 3.0.49-latest.1 die Startprogramm-Version, dann ist die Build-Nummer 1.
launcher_project_idLauncher Project IDEventLauncher Projekt-ID aus dem Kundenportal.
Beispiel: 147 ist eine Projekt-ID für https://publisher.xsolla.com/72209/projects/173640/new-launcher/147
app_versionLauncher VersionEventLauncher Codeversion.
Beispiel: Ist 3.0.49-latest.1 die Startprogramm-Version, dann ist die Codeversion 3.0.49-latest.
login_project_idLogin Project IDEventLogin-Projekt-ID.
platform_game_idPlatform Game IDEventSpiel-ID auf der Plattform. Handelt es sich bei der Plattform um Xsolla, dann wird die Projekt-ID aus dem Kundenportal übermittelt.
publisher_account_game_idPublisher Account Game IDEventDie aus dem Kundenportal stammende ID des Spiels, auf das sich der Content bezieht. Bezieht sich der Content auf kein Spiel, ist das Feld leer.
target_game_idTarget Game IDEventEine ID aus dem Kundenportal oder die Steam App-ID des Spiels, zu dem der Link weiterleitet.
window_sizeWindow SizeEventLauncher Fenstergröße.
Beispiel: 800x600.
  1. Klicken Sie in der Seitenleiste auf Verwaltung.
  2. Erstellen Sie eine Property in Google Analytics 4.
  3. Fügen Sie einen Datenstream hinzu:
    1. Wählen Sie als Typ die Option Web aus.
    2. Geben Sie im Feld URL eine URL-Adresse ein.
  4. Kopieren Sie den Wert aus dem Feld Mess-ID in den Einstellungen des Datenstreams.
  5. Öffnen Sie Ihr Projekt im Kundenportal.
  6. Klicken Sie in der Seitenleiste auf Launcher.
  7. Wählen Sie das gewünschte Startprogramm auf dem Dashboard durch Klick auf Startprogramm bearbeiten aus.
  8. Navigieren Sie zu Einstellungen > Allgemeine Informationen > Analytics.
  9. Fügen Sie die Mess-ID in das Feld Mess-ID in Google Analytics 4 ein.
  10. Klicken Sie auf Speichern.
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. Januar 2024

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!