Skip to content

DP6/media-quality

Repository files navigation

Media Quality

semantic-release Code coverage Test Code quality

Para que serve?

A solução Media Quality tem como objetivo acompanhar a saúde e volumetria de disparos das tags de mídia dentro do GTM, garantindo que modificações e atualizações no container não gere um impacto negativo no funcionamento das tags, tornando ágil o processo de identificação e correção de comportamentos inesperados na coleta de mídia. Os dados dos eventos podem ser enviados para o Google Analytics 4 ou para o BigQuery, através do uso do Google Cloud Functions.

Arquitetura de dados

Quando uma tag de mídia é disparada, a tag de Media Quality é acionada e envia os dados do evento para o GA4 e/ou cloud function. Enquanto os dados dos eventos no GA4 somente ficam disponíveis no dia seguinte, com a utilização de cloud functions o monitoramento ocorre em tempo real.

O uso do Cloud Function é mais indicado para verificação de dados em tempo real. Os dados no GA4 ficam disponibilizados em um dia após a implementação, podendo ser integrados a outros relatórios. Caso queira, as duas opções podem ser configuradas e utilizadas ao mesmo tempo.

O fluxo de implementação da solução funciona da seguinte forma:

  1. inicialmente são criadas as contas do GA4 e no GTM;
  2. Importação do template de tag customizado para o GTM;
  3. Criação de fluxo de dados no GA4 e obtenção do MEASUREMENT ID (apenas se for utilizar o GA4);
  4. Criação de cloud function no ambiente em nuvem da Google;
  5. Criação de tabela de Media Quality no Big Query;
  6. Criação das tags de configuração do Media Quality utilizando o template customizado;
  7. Criação de disparador das tags;
  8. Adição de parâmetros nas tags de mídia existentes, para que estas sejam rastreadas;
  9. Construção de relatórios a partir das tabelas do Big Query.

Dados de mídia que serão enviados na ferramenta escolhida.

Dado coletado Parâmetro
media_name Nome da mídia que foi disparada
tracking_id Id de acompanhamento da mídia disparada
media_event Nome do evento disparado
tag_id Id da tag da tag disparada no GTM
tag_name Nome completo da tag disparada no GTM
status Status de disparo da tag
datalayer_event Nome do evento do DataLayer que acionou a tag
client_id Id do cliente
timestamp Data e hora do disparo

Parâmetros adicionais:

Os parâmetros adicionais serão enviados com o nome específico adicionado na tag do Media Quality do GTM.

Implementação no Google Analytics 4

Requisitos para utilização

  • Google Tag Manager (GTM);
  • Google Analytics 4.

Configurações

A seguir são listadas algumas etapas de configuração:

  1. Configuração do GTM;
  2. Configuração com o uso do GA4;

Implementação com Google Cloud Function

Requisitos para utilização

  • Cloud Function;
  • Bigquery;
  • Google Tag Manager (GTM);

Configurações

A seguir são listadas algumas etapas de configuração:

  1. Configuração do GTM;
  2. Configuração com o uso da Cloud Function;

Opcional:

  1. Configuração de coleta de informações sobre tags existentes no GTM.

Dashboard de acompanhamento

Os dados armazenados na tabela do Big Query foram utilizados para a criação de dashbords no Data Studio. Os dados são exibidos quase em tempo real (atualizados a cada 15 minutos) e permitem agilidade na análise e tomada de decisão em relação ao comportamento das tags de mídia.

Página de acompanhamento real-time

Página de análise de consolidado

Como contribuir

Pull requests são bem-vindos! Nós vamos adorar ajuda para evoluir esse modulo. Sinta-se livre para navegar por issues abertas buscando por algo que possa fazer. Caso tenha uma nova feature ou bug, por favor abra uma nova issue para ser acompanhada pelo nosso time.

Requisitos obrigatórios

Só serão aceitas contribuições que estiverem seguindo os seguintes requisitos:

Api Docs

Suporte

DP6 Koopa-troopa Team

e-mail: koopas@dp6.com.br