https://github.com/dp6/easy-collect
A library meant to assist during an Google Analytics implementation
https://github.com/dp6/easy-collect
ga google-analytics google-tag-manager gtm hacktoberfest webanalytics
Last synced: 6 months ago
JSON representation
A library meant to assist during an Google Analytics implementation
- Host: GitHub
- URL: https://github.com/dp6/easy-collect
- Owner: DP6
- License: mit
- Created: 2021-03-18T15:41:52.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-06-27T19:27:10.000Z (almost 2 years ago)
- Last Synced: 2024-11-28T23:32:26.719Z (6 months ago)
- Topics: ga, google-analytics, google-tag-manager, gtm, hacktoberfest, webanalytics
- Language: JavaScript
- Homepage: https://dp6.github.io/easy-collect
- Size: 12.9 MB
- Stars: 37
- Watchers: 22
- Forks: 5
- Open Issues: 10
-
Metadata Files:
- Readme: README-pt.md
- License: LICENSE
Awesome Lists containing this project
README
# Easy Collect
### Idiomas disponíveis
- [Read this page in English](https://github.com/DP6/easy-collect/blob/master/README.md)
- [Leia esta página em Português](https://github.com/DP6/easy-collect/blob/master/README-pt.md)
---
## 1. Para que serve?
O _Easy Collect_ 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 a _jQuery_ exista, o _Easy Collect_ simplesmente delega a execução para ela, ou seja, o código nos dois casos será o mesmo.
**Recursos do _Easy Collect_:**
- Funções de manipulação do DOM sem depender da biblioteca _jQuery_;
- Funções simplificadas para coleta de dados;
- Padronização de código das tags;
- Envia automaticamente alertas de erros de JavaScript para o _Google Universal Analytics_;
- Envia eventos para o _Google Analytics Universal_ e _Google Analytics 4_;
**[Acesse aqui o "Documento de Referência Técnica"](https://github.com/DP6/easy-collect/blob/master/documentations/docs/pt/gtm-reference.md)**
### 1.1. Estendendo o Easy Collect
Um dos principais conceitos do _Easy Collect_ é a manutenção de sua API com o versionamento básico [SemVer](https://semver.org/). 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 _Easy Collect_, visando agrupar as funções que não pertencem ao escopo atual do projeto.
```javascript
easyCollect.fn.minhaFuncao = function(name) {
console.log(name);
};
easyCollect.fn.minhaFuncao('DP6'); // DP6
```
### 1.2. Compatibilidade
O _Easy Collect_ 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 |
## 2. Tag Managers
A biblioteca dá suporte para o _Google Tag Manager_ com envio de dados para o _Google Analytics Universal (GAU)_ e _Google Analytics 4 (GA4)_.
### 2.1. Google Tag Manager
- [Guia de Implementação - Easy Collect + GTM + GAU](https://github.com/DP6/easy-collect/blob/master/documentations/docs/pt/gtm-config-gau.md)
- [Guia de Implementação - Easy Collect + GTM + GA4](https://github.com/DP6/easy-collect/blob/master/documentations/docs/pt/gtm-config-ga4.md)
- [Guia de Implementação - Easy Collect + GTM + GAU -> GA4 (Migração de Enhanced Ecommerce)](https://github.com/DP6/easy-collect/blob/master/documentations/docs/pt/gtm-config-gau-ga4.md)
## 3. Como contribuir
Pull requests são bem-vindos! Nós vamos adorar ajuda para evoluir esse modulo. Sinta-se livre para navegar por _open issues_ 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.
### 3.1 Requisitos obrigatórios
Só serão aceito as contribuições que estiverem seguindo os seguintes requisitos:
- [Padrão de commit](https://www.conventionalcommits.org/en/v1.0.0/)
## Suporte:
**DP6 Koopa-troopa Team**
_e-mail: _
