Como enviar dados para o Google Analytics 4
Como funciona
Quando você recebe dados sobre a atividade dos usuários e o comportamento do inicializador do Google Analytics 4 como eventos, os dados são enviados na carga útil conforme listado na tabela abaixo.
| Dimensão | Descrição |
|---|---|
| Distrubution platform | A plataforma que foi usada para abrir o inicializador. Valores possíveis: Xsolla, Steam. |
| Language | Idioma do inicializador. |
| Page title | Tela do inicializador. Valores possíveis: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen, Custom tab screen. |
| Platform game ID | ID de jogo na plataforma. Se a plataforma for a Xsolla, um ID de projeto de Conta de Distribuidor será passada. |
| Stream name | Nome do inicializador. |
| Launcher project ID | ID do projeto do inicializador na Conta de Distribuidor. Exemplo: 147 é um ID de projeto para https://publisher.xsolla.com/72209/projects/173640/new-launcher/147 |
| Login project ID | ID de projeto Login. |
| App version | Versão do inicializador. |
| Build number | Número da compilação. Exemplo: se a versão do inicializador for 3.0.49-latest.1, o número da compilação será 1. |
| Window size | Tamanho da janela do inicializador. Exemplo: 800x600. |
| Screen resolution | Resolução da tela. |
| Operating system, Operating system with version, OS version. | Agente do usuário para detecção do sistema operacional do usuário. |
| Publisher Account game ID | ID da Conta de Distribuidor do jogo ao qual o conteúdo está relacionado. O campo estará vazio se o conteúdo não estiver relacionado ao jogo. |
| City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent ID | Dados geográficos. |
Eventos gerais
| Evento | Descrição |
|---|---|
| launcher_start | O inicializador é executado. Isso não é enviado quando o iniciador é iniciado após uma atualização. |
| close_app | Fechamento do lançador. Isso não é enviado quando o iniciador é fechado antes de uma atualização. |
Eventos de interface
| Evento | Descrição |
|---|---|
| page_view | Um usuário abriu uma tela do inicializador. |
| logout | Um usuário clicou em Log out. |
Eventos de atualização do inicializador
| Evento | Descrição |
|---|---|
| launcher_update_check_start | O inicializador começa a verificar se há atualizações. |
| launcher_update_check_complete | O inicializador concluiu a verificação de atualizações. O campo adicional value terá o valor update_found se houver uma versão mais recente encontrada na CDN. Caso contrário, o valor será no_updates. |
| launcher_update_check_skip | Um usuário ignorou a atualização do inicializador. |
| launcher_update_download_start | O inicializador começou a baixar a atualização. |
| launcher_update_download_complete | O inicializador terminou de baixar a atualização. |
| launcher_update_start | O inicializador concluiu a atualização. |
| launcher_update_complete | Inicializador atualizado com sucesso. |
Eventos de propriedade do jogo
| Evento | Descrição |
|---|---|
| purchase | Uma alteração do status de uma compra. Campos adicionais:
|
Eventos de conteúdo
| Evento | Descrição |
|---|---|
| content_view | Mais de 75% de um conteúdo foi exibido. Para o conteúdo que tem o status de group, o evento não é enviado. Campos adicionais:
|
| content_click | Um usuário clicou em um elemento de conteúdo. |
Eventos de autorização
| Evento | Descrição |
|---|---|
| login | Um usuário foi autenticado com êxito no inicializador. Campos adicionais:
|
Como obtê-lo
- Cadastre-se no Google Analytics e faça login na sua conta.
- Crie e edite dimensões personalizadas no Google Analytics, conforme demonstrado na tabela abaixo.
| Campo | Dimensão | Scope | Descrição |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | Um ID da Conta de Distribuidor ou um Steam App ID do jogo para o qual o link redireciona. |
| auth_type | Auth Type | Event | Opção de autenticação passada no JWT. Valores possíveis:
|
| content_id | Content ID | Event | ID do bloco de conteúdo. |
| content_link | Content Link | Event | Endereço URL se o tipo de conteúdo for link ou vídeo. |
| content_name | Content Name | Event | Nome do bloco de conteúdo em inglês. |
| content_type | Content Type | Event | Tipo de conteúdo. Valores possíveis: news, link internal, link external, video. |
| distribution_platform | Distribution Platform | Event | A plataforma que foi usada para abrir o inicializador. Valores possíveis: Xsolla, Steam. |
| game_name | Game Name | Event | Nome do jogo em inglês. |
| game_platform | Game Platform | Event | Plataforma de jogos. Valores possíveis: Xsolla, Steam. |
| build_number | Launcher Build Number | Event | Número da compilação. Exemplo: se a versão do inicializador for 3.0.49-latest.1, o número da compilação será 1. |
| launcher_project_id | Launcher Project ID | Event | ID do projeto do inicializador na Conta de Distribuidor. Exemplo: 147 é um ID de projeto para https://publisher.xsolla.com/72209/projects/173640/new-launcher/147 |
| app_version | Launcher Version | Event | Versão do código do inicializador. Exemplo: se a versão do inicializador for 3.0.49-latest.1 , a versão do código do inicializador será 3.0.49-latest. |
| login_project_id | Login Project ID | Event | ID de projeto Login. |
| platform_game_id | Platform Game ID | Event | ID de jogo na plataforma. Se a plataforma for a Xsolla, um ID de projeto de Conta de Distribuidor será passada. |
| publisher_account_game_id | Publisher Account Game ID | Event | ID da Conta de Distribuidor do jogo ao qual o conteúdo está relacionado. O campo estará vazio se o conteúdo não estiver relacionado ao jogo. |
| target_game_id | Target Game ID | Event | Um ID da Conta de Distribuidor ou um Steam App ID do jogo para o qual o link redireciona. |
| window_size | Window Size | Event | Tamanho da janela do inicializador. Exemplo: 800x600. |
- Selecione Admin no menu lateral.
- Crie uma propriedade do Google Analytics 4.
- Adicione um fluxo de dados:
- selecione o tipo de Web.
- No campo URL, insira qualquer endereço URL.
- Copie o valor do campo Measurement ID nas configurações do fluxo de dados.
- Abra seu projeto na Conta de Distribuidor e acesse a seção Distribution > Launcher.
- Encontre o inicializador no painel e selecione Edit launcher.
- Vá para Settings > General information > Analytics.
- Cole o Measurement ID no campo Google Analytics 4 Measurement ID.
- Selecione Save changes.
Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.
