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

Commit

Permalink
Atualização dos módulos e nas documentações
Browse files Browse the repository at this point in the history
  • Loading branch information
Paulo Brumatti committed Mar 24, 2018
1 parent 9828030 commit d390934
Show file tree
Hide file tree
Showing 18 changed files with 466 additions and 220 deletions.
36 changes: 20 additions & 16 deletions README-GTM-CONFIG.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,43 @@
# Configuração do GTM

Este documento descreve os passos para a utilização da biblioteca analytics-helper em conjunto com o Google Tag Manager,
e as configurações necessárias.
Este documento descreve os passos para a utilização da biblioteca analytics-helper em conjunto com o Google Tag Manager, e as configurações necessárias.

## Tag principal

O arquivo final, presente na pasta *build*, seja ele o arquivo de exemplo disponível neste repositório, ou uma versão personalizada
gerada via Gulp, deverá ser copiado integralmente para uma Tag Custom HTML.
O arquivo final, presente na pasta *build*, seja ele o arquivo de exemplo disponível neste repositório, ou uma versão personalizada gerada via Gulp, deverá ser copiado integralmente para uma Tag Custom HTML.

Em configurações avançadas, a opção de executar uma única vez por página deverá ser selecionada.

![Configuração uma por página](documentation-images/once_per_page.png)

As tags que utilizarem o objeto analyticsHelper devem configurar esta tag principal como requisito na seção *sequência de tags*,
para garantir que o objeto estará definido antes do uso.
As tags que utilizarem o objeto analyticsHelper devem configurar esta tag principal como requisito na seção *sequência de tags*, para garantir que o objeto estará definido antes do uso.


## Acionadores

Três acionadores do tipo *evento personalizado* devem ser criados.

Os nomes dos eventos serão os nomes definidos nos campos: *exceptionEvent*, *customNamePageview* e *customNameEvent*.

Por padrão, os valores destes campos são respectivamente: *gtm_dataQuality_event*, *ga_pageview* e *ga_event*.

![Triggers](documentation-images/event_name.png)

## Tags de template

3 tags genéricas de Universal Analytics devem ser criadas, uma para cada acionador criado acima.
Três tags de Universal Analytics devem ser criadas, uma para cada acionador criado acima.

Estas tags devem ser preenchidas com a variáveis de camada de dados listadas na próxima seção. Estes são os campos mínimos,
as tags podem ser estendidas para incluir dimensões personalizadas, dados de ecommerce e outras configurações.
Estas tags devem ser preenchidas com as variáveis de camada de dados listadas na próxima seção. Estes são os campos mínimos, as tags podem ser estendidas para incluir dimensões personalizadas, dados de ecommerce e outras configurações.

### Template de Pageview
![Tag de template de Pageview](documentation-images/tag_pageview.png)

### Template de Evento
![Tag de template de Evento](documentation-images/tag_event.png)

### Template de Timing
![Tag de template de Timing](documentation-images/tag_timing.png)

### Template de Data Quality
![Tag de template de DataQuality](documentation-images/tag_dataquality.png)

Expand All @@ -46,8 +46,7 @@ as tags podem ser estendidas para incluir dimensões personalizadas, dados de ec

As variáveis padrão *Container ID* e *Debug Mode* devem ser habilitadas, pois elas são utilizadas pelo código da *tag principal*.

A tabela a seguir descreve todas as variáveis do tipo *variável de camada de dados* que deverão ser criadas para o uso nas tags
de template do Google Analytics:
A tabela a seguir descreve todas as variáveis do tipo *variável de camada de dados* que deverão ser criadas para o uso nas tags de template do Google Analytics:

| Nome da variável de Camada de Dados | Tag que utiliza | Campo do template |
| - | - | - |
Expand All @@ -56,22 +55,27 @@ de template do Google Analytics:
| eventLabel | Tag de Evento | Rótulo |
| eventValue | Tag de Evento | Valor |
| eventNoInteraction | Tag de Evento | Hit de não-interação |
| timingCategory | Tag de Evento | Categoria |
| timingVariable | Tag de Evento | Variável |
| timingValue | Tag de Evento | Valor |
| timingLabel | Tag de Evento | Rótulo |
| path | Tag de Pageview | Fields to Set -> page |
| dataQuality.category | Tag de Data Quality | Categoria |
| dataQuality.action | Tag de Data Quality | Ação |
| dataQuality.label | Tag de Data Quality | Rótulo |
| dataQuality.selector | Tag de Data Quality | Dimensões Personalizadas -> 1 |
| dataQuality.event | Tag de Data Quality | Dimensões Personalizadas -> 2 |

Caso utilize a opção waitQueue (habilitada por padrão), a seguinte variável de *javascript personalizado* deverá ser criada
e adicionada ao campo *hitCallback* em *Fields to Set* nas tags de template de Google Analytics.
Caso utilize a opção waitQueue (habilitada por padrão), a seguinte variável de *javascript personalizado* deverá ser criada e adicionada ao campo *hitCallback* em *Fields to Set* nas tags de template de Google Analytics.

```javascript
function() {
return function(){
analyticsHelper.internal._sentPageview = true;
while(analyticsHelper.internal._eventQueue.length){
analyticsHelper.event.apply(analyticsHelper, analyticsHelper.internal._eventQueue.shift());
analyticsHelper.internal.sentPageview = true;
while(analyticsHelper.internal.eventQueue.length){
analyticsHelper.event.apply(analyticsHelper, analyticsHelper.internal.eventQueue.shift());
while(analyticsHelper.internal.timingQueue.length){
analyticsHelper.timing.apply(analyticsHelper, analyticsHelper.internal.timingQueue.shift());
}
};
}
Expand Down

0 comments on commit d390934

Please sign in to comment.