Saudações aos Habravitas. Quero falar sobre como parafusamos o Google Analytics no bot de telegrama, quais problemas encontramos e o que acabou não sendo configurado.
À moda antiga, o Google Analytics é instalado em um site com um domínio ou em um aplicativo com um SDK. Pesquisando no tópico, ficou claro que não havia exemplos, então decidimos fazer isso sozinhos. No nosso caso, não havia site ou aplicativo móvel, mas havia o desejo de rastrear eventos no bot do Telegram. E, em parte, acabou por ser feito.
Problema número 1
Os bots estão localizados fisicamente em
t.me/benice_tools_bot . É semelhante a um site comum, mas sem acesso direto aos arquivos raiz, para definir o código do contador e configurar eventos.
A interface nesse caso é o próprio Telegram, ao qual não temos acesso.
Nosso bot trabalha com a API da Binance e a API do Telegram, e, portanto, há um back-end através do qual se tornou possível manobrar com as configurações de análise.
No Google Analytics, eles criaram um contador "para o site" e registraram eventos com os parâmetros "Ação, Rótulo, Categoria". Configurações detalhadas são descritas em dezenas de sites. E depois disso, o primeiro problema apareceu.
Pelos métodos padrão do Google, não era possível colocar alvos no bot, não havia acesso à frente.
Uma
biblioteca veio ao resgate, o que permitia transmitir e processar parâmetros de eventos a partir do back-end.
Após a instalação, começamos a testar a capacidade de trabalho do método e obtivemos o primeiro sucesso. Os eventos concluídos começaram a ser exibidos no Google Analytics, no modo "tempo real" era visível quantas pessoas estão online no bot e outros dados.
Após testes independentes e usuários do tráfego de publicidade, ficou claro que as informações de que precisamos são 100% confiáveis. Ficou claro quantas pessoas estão online e quais eventos específicos estão sendo realizados.
Mas ainda havia alguns erros. Por exemplo, o tipo de dispositivo não foi detectado corretamente, “Computador de mesa” foi exibido, mesmo se você usar o Telegram de um dispositivo móvel. A localização indicava apenas a Grécia, porque o servidor com o bot estava neste país. Dados demográficos, interesses, navegadores e sistemas operacionais foram exibidos como "(não definido)".
Problema número 2
Criamos links promocionais que, quando ativados, dão acesso a recursos pagos por 7 dias. E os cliques nesses links precisavam ser vinculados ao Google Analytics para analisar as campanhas publicitárias.
Por padrão, o próprio Google Analytics gera um ID de usuário ou o deixa sem esse parâmetro. No entanto, você pode criar seu próprio ID personalizado e enviá-lo ao Google.
Nós usamos esse método. Criamos a contabilidade do usuário por meio do userId criptografado do nosso sistema.
O telegrama transmite metadados quando o bot é iniciado. Isso funciona da mesma maneira que as tags utm familiares.
No link, para uma campanha publicitária, um rótulo é inserido após o início.
Por exemplo:
http://t.me/benice_tools_bot?start=habrahabr
Quando o bot é iniciado, analisamos os parâmetros para o início e os levamos para uma campanha específica.
No back-end, no perfil do usuário, haverá informações de que ele veio para uma campanha campaign_habrahabr específica.
Restava especificar nosso visitante no código:
if (!code) code = "organic"; const visitor = ua(googleAnalyticsProjectId, `token:${code};CLIENTID:${saltUserId}`, { strictCidFormat: false }); visitor.event(category, action, label).send();
Se o usuário veio sozinho, sem uma campanha publicitária, essa fonte é reconhecida como "orgânica".
Assim, acabou por analisar o acionamento de objetivos de um usuário específico que veio de uma campanha publicitária.
PS
Todas as chamadas para o Google Analytics terminaram em confusão do lado do suporte. Nas primeiras ligações, quando nada mais funcionou, nenhuma dica foi obtida. E quando os eventos já foram transferidos para a análise, o suporte fez uma pausa de 15 minutos para "esclarecer os detalhes" da pergunta e, quando eles retornaram, eles mesmos começaram a fazer perguntas: "Como você fez isso?"