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ãoDescrição
Distrubution platformA plataforma que foi usada para abrir o inicializador.
Valores possíveis: Xsolla, Steam.
LanguageIdioma do inicializador.
Page titleTela 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 IDID de jogo na plataforma. Se a plataforma for a Xsolla, um ID de projeto de Conta de Distribuidor será passada.
Stream nameNome do inicializador.
Launcher project IDID 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 IDID de projeto Login.
App versionVersão do inicializador.
Build numberNú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 sizeTamanho da janela do inicializador.
Exemplo: 800x600.
Screen resolutionResoluçã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 IDID 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 IDDados geográficos.
As tabelas abaixo mostram informações sobre campos adicionais para determinados eventos. Todos os eventos de saída são agrupados com base em seu tipo.

Eventos gerais

EventoDescrição
launcher_startO inicializador é executado. Isso não é enviado quando o iniciador é iniciado após uma atualização.
close_appFechamento do lançador. Isso não é enviado quando o iniciador é fechado antes de uma atualização.

Eventos de interface

EventoDescrição
page_viewUm usuário abriu uma tela do inicializador.
logoutUm usuário clicou em Log out.

Eventos de atualização do inicializador

EventoDescrição
launcher_update_check_startO inicializador começa a verificar se há atualizações.
launcher_update_check_completeO 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_skipUm usuário ignorou a atualização do inicializador.
launcher_update_download_startO inicializador começou a baixar a atualização.
launcher_update_download_completeO inicializador terminou de baixar a atualização.
launcher_update_startO inicializador concluiu a atualização.
launcher_update_completeInicializador atualizado com sucesso.

Eventos de propriedade do jogo

EventoDescrição
purchaseUma alteração do status de uma compra. Campos adicionais:
  • currency — código de moeda de três letras de acordo com o padrão ISO 4217.
  • value — valor nominal da compra.
  • transaction_id — ID de pagamento no sistema da Xsolla.
  • coupon — código de cupom.
  • itemsparâmetros do item.

Eventos de conteúdo

EventoDescrição
content_viewMais 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_name — um ID de conteúdo.
  • content_name — um nome de conteúdo.
  • content_type — um tipo de conteúdo.
  • banner_type — um tipo de banner.
  • target_game_id — um ID da Conta de Distribuidor ou um Steam App ID do jogo para o qual o link direciona.
  • content_link — endereço URL se o tipo de conteúdo for link ou vídeo.
content_clickUm usuário clicou em um elemento de conteúdo.

Eventos de autorização

EventoDescrição
loginUm usuário foi autenticado com êxito no inicializador. Campos adicionais:
  • auth_type — opção de autenticação.
  • method — rede social usada para autenticação.

Como obtê-lo

  1. Cadastre-se no Google Analytics e faça login na sua conta.
  2. Crie e edite dimensões personalizadas no Google Analytics, conforme demonstrado na tabela abaixo.
CampoDimensãoScopeDescrição
analytics_target_game_idAnalytics Target Game IDEventUm ID da Conta de Distribuidor ou um Steam App ID do jogo para o qual o link redireciona.
auth_typeAuth TypeEventOpção de autenticação passada no JWT. Valores possíveis:
  • social — login social.
  • phone — login sem senha através de um código único enviado para um número de telefone.
  • email — login sem senha através de um código único enviado para um e-mail.
  • xsolla_login — login através de um nome de usuário/e-mail e senha usando o armazenamento de dados de login Xsolla.
  • firebase — login por meio de um nome de usuário/e-mail e senha usando o armazenamento de dados do Firebase.
  • playfab — login através de um nome de usuário/e-mail e senha usando o armazenamento de dados do Playfab.
  • proxy — Login através de um nome de usuário/e-mail e senha usando armazenamento de dados personalizado.
  • device — login com ID do dispositivo.
  • server_custom_id — login por ID personalizado (ID de usuário gerado em seu servidor).
content_idContent IDEventID do bloco de conteúdo.
content_linkContent LinkEventEndereço URL se o tipo de conteúdo for link ou vídeo.
content_nameContent NameEventNome do bloco de conteúdo em inglês.
content_typeContent TypeEventTipo de conteúdo. Valores possíveis: news, link internal, link external, video.
distribution_platformDistribution PlatformEventA plataforma que foi usada para abrir o inicializador.
Valores possíveis: Xsolla, Steam.
game_nameGame NameEventNome do jogo em inglês.
game_platformGame PlatformEventPlataforma de jogos. Valores possíveis: Xsolla, Steam.
build_numberLauncher Build NumberEventNú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_idLauncher Project IDEventID 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_versionLauncher VersionEventVersã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_idLogin Project IDEventID de projeto Login.
platform_game_idPlatform Game IDEventID de jogo na plataforma. Se a plataforma for a Xsolla, um ID de projeto de Conta de Distribuidor será passada.
publisher_account_game_idPublisher Account Game IDEventID 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_idTarget Game IDEventUm ID da Conta de Distribuidor ou um Steam App ID do jogo para o qual o link redireciona.
window_sizeWindow SizeEventTamanho da janela do inicializador.
Exemplo: 800x600.
  1. Clique em Admin no menu lateral.
  2. Crie uma propriedade do Google Analytics 4.
  3. Adicione um fluxo de dados:
    1. selecione o tipo de Web.
    2. No campo URL, insira qualquer endereço URL.
  4. Copie o valor do campo Measurement ID nas configurações do fluxo de dados.
  5. Abra seu projeto na Conta de Distribuidor.
  6. Clique em Launcher no menu lateral.
  7. Encontre o inicializador no painel e clique em Edit launcher.
  8. Vá para Settings > General information > Analytics.
  9. Cole o Measurement ID no campo Google Analytics 4 Measurement ID.
  10. Clique em Save changes.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Avalie esta página
Avalie esta página
Podemos melhorar alguma coisa?

Não quero responder

Obrigado pelo seu feedback!
Última atualização: 22 de Janeiro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!