Skip to content
This repository has been archived by the owner on May 4, 2021. It is now read-only.
/ analytics-helper Public archive

A library meant to assist during an Google Analytics implementation

License

Notifications You must be signed in to change notification settings

DP6/analytics-helper

Repository files navigation

Analytics Helper

Build Status Coverage Status semantic-release

O Analytics Helper tem como objetivo facilitar a implementação, a manutenção e a padronização de tags no contexto de digital analytics.

Um exemplo dos esforços envolvidos no suporte à padronização está na implementação de funções similares às da biblioteca jQuery, comumente utilizada em projetos de tagueamento. Deste modo, mesmo na ausência desta, será possível garantir o padrão e qualidade da coleta dos dados (Consultar a tabela de compatibilidade). Caso da jQuery exista, o Analytics Helper simplesmente delega a execução para ela, ou seja, o código nos dois casos será o mesmo.

Resumindo, o utilize o Analytics Helper para:

  • Ter acesso à funções de manipulação do DOM sem depender da jQuery;
  • Enviar automaticamente alertas e eventos para o Google Analytics indicando possíveis erros de JavaScript no tagueamento;
  • Funções simplificadas para coleta de dados;
  • Padronização do código das tags.

Estendendo o Analytics Helper

Um dos principais conceitos do Helper é a manutenção de sua API com o versionamento básico SemVer. Para isso, recomendamos que a expansão de sua API para situações específicas, ou seja, utilizadas em projetos com particularidades que não irão se repetir, seja feita através do objeto fn.

Objeto fn

Se trata de uma variável global dentro do escopo do objeto Helper, visando agrupar as funções que não pertencem ao escopo atual do projeto.

analyticsHelper.fn.minhaFuncao = function(name) {
  console.log(name);
};
analyticsHelper.fn.minhaFuncao('DP6'); // DP6

Compatibilidade

O Analytics Helper depende da função nativa querySelectorAll. Os navegadores com suporte a essa funcionalidade são:

Chrome Firefox IE Opera Safari
1 3.5 8 10 3.2

Tag Managers

Inicialmente, na versão 1.0, a biblioteca dá suporte para o Google Tag Manager com envio de dados para o Google Analytics, mas está planejado o suporte para demais ferramentas do mercado também.

Google Tag Manager