Cómo enviar datos a Google Analytics 4
Cómo funciona
Cuando recibe datos sobre la actividad de los usuarios y el comportamiento del lanzador desde Google Analytics 4 como eventos, los datos se envían en la carga útil que se indica en la siguiente tabla.
| Dimensión | Descripción |
|---|---|
| Distrubution platform | La plataforma que se utilizó para abrir el lanzador. Valores posibles: Xsolla o Steam. |
| Language | Idioma del lanzador. |
| Page title | Pantalla del lanzador. Valores posibles: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen o Custom tab screen. |
| Platform game ID | ID del juego en la plataforma. Si la plataforma es Xsolla, se transmite un ID de proyecto de Cuenta del editor. |
| Stream name | Nombre del lanzador. |
| Launcher project ID | ID del proyecto de Launcher desde Cuenta del editor. Ejemplo: 147 es un ID de proyecto para https://publisher.xsolla.com/72209/projects/173640/new-launcher/147 |
| Login project ID | Identificación del proyecto de Login. |
| App version | Versión del lanzador. |
| Build number | Número de compilación. Ejemplo: Si la versión del lanzador es 3.0.49-latest.1 entonces el número de compilación es 1. |
| Window size | Tamaño de la ventana del lanzador. Ejemplo: 800x600. |
| Screen resolution | Resolución de pantalla. |
| Operating system, Operating system with version, OS version. | Agente del usuario para la detección del sistema operativo del usuario. |
| Publisher Account game ID | ID de Cuenta del editor del juego con el que está relacionado el contenido. El campo estará vacío si el contenido no está relacionado con el juego. |
| City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent ID | Datos geográficos. |
Eventos generales
| Evento | Descripción |
|---|---|
| launcher_start | Se inicia el lanzador. No se envía cuando se inicia el lanzador después de una actualización. |
| close_app | Cierre del lanzador. No se envía cuando el lanzador se cierra antes de una actualización. |
Eventos de la interfaz de usuario
| Evento | Descripción |
|---|---|
| page_view | Un usuario abrió una pantalla del lanzador. |
| logout | Un usuario pulsó en Log out. |
Eventos de actualización de Launcher
| Evento | Descripción |
|---|---|
| launcher_update_check_start | Launcher empieza a comprobar si hay actualizaciones. |
| launcher_update_check_complete | Launcher finalizó la comprobación de actualizaciones. El campo adicional value tiene el valor update_found si se encontró una versión más reciente en CDN (Red de entrega de contenidos). En caso contrario, el valor es no_updates. |
| launcher_update_check_skip | Un usuario se saltó la actualización de Launcher. |
| launcher_update_download_start | Launcher comenzó a descargar la actualización. |
| launcher_update_download_complete | Launcher terminó de descargar la actualización. |
| launcher_update_start | Launcher terminó la actualización. |
| launcher_update_complete | Launcher se actualizó correctamente. |
Eventos de propiedad del juego
| Evento | Descripción |
|---|---|
| purchase | Cambio del estado de una compra. Campos adicionales:
|
Eventos de contenido
| Evento | Descripción |
|---|---|
| content_view | Se visualizó más del 75 % de un contenido. Para el contenido que tiene el estado grupo no se envía el evento. Campos adicionales:
|
| content_click | Un usuario pulsó en un elemento de contenido. |
Eventos de autorización
| Evento | Descripción |
|---|---|
| login | Un usuario se autenticó correctamente en el lanzador. Campos adicionales:
|
Cómo conseguirlo
- Regístrese en Google Analytics y acceda a su cuenta.
- Cree y edite las dimensiones personalizadas en Google Analytics como se muestra en la siguiente tabla.
| Campo | Dimensión | Scope (alcance) | Descripción |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | Un ID de Cuenta del editor o un ID de la aplicación Steam del juego, al cual el enlace lleva. |
| auth_type | Auth Type | Event | Opción de autenticación transmitida en un JWT. Valores posibles:
|
| content_id | Content ID | Event | ID del mosaico de contenido. |
| content_link | Content Link | Event | Dirección URL si el tipo de contenido es enlace o vídeo. |
| content_name | Content Name | Event | Nombre del mosaico de contenido en inglés. |
| content_type | Content Type | Event | Tipo de contenido. Valores posibles: news, link internal, link external o video. |
| distribution_platform | Distribution Platform | Event | La plataforma que se utilizó para abrir el lanzador. Valores posibles: Xsolla o Steam. |
| game_name | Game Name | Event | Nombre del juego en inglés. |
| game_platform | Game Platform | Event | Plataforma del juego. Valores posibles: Xsolla o Steam. |
| build_number | Launcher Build Number | Event | Número de compilación. Ejemplo: Si la versión del lanzador es 3.0.49-latest.1 entonces el número de compilación es 1. |
| launcher_project_id | Launcher Project ID | Event | ID del proyecto de Launcher desde Cuenta del editor. Ejemplo: 147 es un ID de proyecto para https://publisher.xsolla.com/72209/projects/173640/new-launcher/147 |
| app_version | Launcher Version | Event | Versión del código del lanzador. Ejemplo: Si la versión del lanzador es 3.0.49-latest.1 entonces la versión del código del lanzador es 3.0.49-latest. |
| login_project_id | Login Project ID | Event | Identificación del proyecto de Login. |
| platform_game_id | Platform Game ID | Event | ID del juego en la plataforma. Si la plataforma es Xsolla, se transmite un ID de proyecto de Cuenta del editor. |
| publisher_account_game_id | Publisher Account Game ID | Event | ID de Cuenta del editor del juego con el que está relacionado el contenido. El campo estará vacío si el contenido no está relacionado con el juego. |
| target_game_id | Target Game ID | Event | Un ID de Cuenta del editor o un ID de la aplicación Steam del juego, al cual el enlace lleva. |
| window_size | Window Size | Event | Tamaño de la ventana del lanzador. Ejemplo: 800x600. |
- Haga clic en Administrador en el menú lateral.
- Cree una propiedad de Google Analytics 4.
- Añada un flujo de datos:
- Seleccione el tipo Web.
- En el campo URL introduzca cualquier dirección URL.
- Copie el valor del campo ID de medición en la configuración del flujo de datos.
- Abra su proyecto en Cuenta del editor y vaya a Distribution > Launcher.
- Busque el lanzador en el panel de control y haga clic en Edit launcher.
- Vaya a Settings > General information > Analytics.
- Pegue el ID de medición en el campo Google Analytics 4 Measurement ID.
- Haga clic en Save changes.
¿Te ha resultado útil este artículo?
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.