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.

Las siguientes tablas muestran información sobre campos adicionales para determinados eventos. Todos los eventos salientes se agrupan en función de su tipo.

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: `currency` - código de moneda de tres letras conforme a la norma ISO 4217. `value` - importe nominal de la compra. `transaction_id` - ID de pago en el sistema de Xsolla. `coupon` - código de cupón. `items` - parámetros del artículo.

Eventos de contenido

Evento Descripción

content_view

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_name` - un ID de contenido. `content_name` - un nombre de contenido. `content_type` - un tipo de contenido. `banner_type` - un tipo de banner. `target_game_id` - un ID de Cuenta del editor o un ID de la aplicación Steam del juego al que lleva el enlace. `content_link` - dirección URL si el tipo de contenido es enlace o vídeo.
content_click	Un usuario pulsó en un elemento de contenido.

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_name - un ID de contenido.
content_name - un nombre de contenido.
content_type - un tipo de contenido.
banner_type - un tipo de banner.
target_game_id - un ID de Cuenta del editor o un ID de la aplicación Steam del juego al que lleva el enlace.
content_link - dirección URL si el tipo de contenido es enlace o vídeo.

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: `auth_type`: opción de autenticación. `method`: red social utilizada para la autenticación.

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: `social` - Inicio de sesión mediante red social. `phone` - Inicio de sesión sin contraseña mediante un código de un solo uso enviado a un número de teléfono. `email` - inicio de sesión sin contraseña mediante un código de un solo uso enviado a un correo electrónico. `xsolla_login` - Inicio de sesión clásico mediante un nombre de usuario/correo electrónico y una contraseña utilizando el almacenamiento de datos de inicio de sesión de Xsolla. `firebase` - Inicio de sesión clásico mediante un nombre de usuario/correo electrónico y contraseña utilizando el almacenamiento de datos Firebase. `playfab` - Inicio de sesión clásico mediante un nombre de usuario/correo electrónico y contraseña usando el almacenamiento de datos de Playfab. `proxy` - Inicio de sesión clásico mediante nombre de usuario/correo electrónico y contraseña utsando almacenamiento de datos personalizado. `device` - Inicio de sesión con ID de dispositivo. `server_custom_id` - Inicio de sesión mediante ID personalizado (ID de usuario generado en su servidor).
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:
1. Seleccione el tipo Web.
2. 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.
Haga clic en Launcher en el menú lateral.
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.

¡Gracias por tu mensaje!

Nos ayudará a mejorar tu experiencia.

Última actualización: 22 de Enero de 2024

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Your browser is not supported. Please try a different browser

Artículos populares

O elige una pregunta frecuente:

La respuesta se basa en las siguientes fuentes:

Déjanos un comentario (opcional)