> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/publishers/pt/adblock/track-adblock-users-ga.md).
# Como rastrear utilizadores do AdBlock através do Google Analytics 4
Embora a ExoClick acompanhe as impressões, os cliques e a receita gerada pelas suas zonas de anúncios, tem outras ferramentas à sua disposição para medir o desempenho global e a atividade do seu website. Uma destas ferramentas é [**Google Analytics**](https://support.google.com/sites/answer/97459?hl=en), que lhe fornece informações detalhadas sobre o que está a acontecer no seu site.
Pode configurar um **evento de rastreamento personalizado** no Google Analytics que lhe dá uma indicação de quantos utilizadores estão a visitar o seu website com o Adblock ativado. Isto ajudá-lo-á a ter uma ideia de quanto tráfego poderia estar a monetizar através de [**a solução Adblock da ExoClick**](/publishers/pt/adblock/neverblock.md).
Note que nos vamos referir à **Google Analytics 4** versão, uma vez que [o Universal Analytics será descontinuado em julho de 2023](https://support.google.com/analytics/answer/11583528?hl=en\&ref_topic=10094551).
{% stepper %}
{% step %}
## Crie o script ad-units.js e carregue-o para o seu servidor
Para detetar se o utilizador está a aceder ao nosso site com o Adblock ativado, vamos criar um ficheiro Javascript chamado `ad-units.js`. Este ficheiro declara que todos os utilizadores que visitam o seu website não estão a utilizar Adblock. Como o termo "ad-units" é bloqueado pelo Adblock, **vamos marcar o utilizador como estando a aceder com uma extensão de bloqueio de anúncios sempre que este ficheiro não for carregado**.
O ficheiro .js só precisa de conter o seguinte:
```html
isAdBlockActive=false;
```
Depois de criar este ficheiro, carregue-o para o servidor do seu website.
{% endstep %}
{% step %}
## Adicione o código de rastreamento em cada uma das suas páginas
A tag predefinida do GA rastreia eventos básicos como [visualizações de página, sessões e utilizadores, entre outros](https://support.google.com/analytics/answer/9234069?hl=en\&ref_topic=13367566). O que vamos fazer é criar um [**evento personalizado**](https://support.google.com/analytics/answer/12229021) usando a API do GA.
Para este código personalizado, vamos criar o `adblock_user` evento recomendado. O código que precisa de adicionar em cada página que pretende rastrear é o seguinte:
```html
```
Coloque este código depois da `body` tag de cada website que pretende rastrear. Vamos analisar em detalhe cada parte deste código:
* Primeiro, estamos a declarar a variável `isAdblockActive` como `verdadeiro`, o que significa que todos os utilizadores que visitam o seu website têm o Adblock ativado. De seguida, vamos chamar o `ad-units.js` script que criámos anteriormente, que irá alterar esta variável para `falso`. Isto significa que os utilizadores serão tratados como "standard", a menos que tenham um bloqueador de anúncios que bloqueie o `ad-units.js` ficheiro, caso em que serão tratados como "adblock".
* Depois, estamos a criar um evento personalizado chamado `adblock_user` evento com base em se a variável `isAdBlockActive` é verdadeira ou não. Adicionámos o `user` parâmetro do evento para o podermos identificar rapidamente no GA. Explicaremos isto em detalhe na secção seguinte.
Certifique-se de que colocou o [**código de rastreamento básico do GA**](https://support.google.com/analytics/answer/9304153#add-tag\&zippy=%2Cadd-the-google-tag-directly-to-your-web-pages) na `head` tag, caso contrário o código não funcionará.
{% endstep %}
{% step %}
## Crie a dimensão e o evento personalizado no GA
Este passo ajudá-lo-á a **ter uma melhor visualização dos utilizadores Adblock no seu painel do GA**. A **dimensão** pode ser usada como filtro nos seus vários relatórios, enquanto o **evento personalizado** lhe dará uma página específica onde pode verificar a quantidade de utilizadores com adblock no seu site.
### Dimensão personalizada
{% stepper %}
{% step %}
Clique em **Administração** > **Definições personalizadas**, depois clique em **Criar dimensões personalizadas**.
{% endstep %}
{% step %}
Adicione **Adblock** como "Nome da dimensão" e selecione **Evento** como "Âmbito", depois adicione uma descrição à sua escolha e introduza **user** como "parâmetro do evento".
{% endstep %}
{% step %}
Interação **Guardar**.
A dimensão não funcionará de imediato: começará a aparecer nos seus relatórios assim que tiver identificado eventos/utilizadores suficientes, ao fim de alguns dias. Quando estiver disponível, poderá usá-la para **adicionar uma comparação** ao relatório que está a consultar:
{% endstep %}
{% endstepper %}
### Eventos personalizados
{% stepper %}
{% step %}
Clique em **Administração** > **Eventos**, depois clique em **Criar evento personalizado**.
{% endstep %}
{% step %}
Clique em **Criar**. No nome do evento personalizado, escreva **adblock\_user**. Depois, como condições correspondentes, escreva o seguinte:
{% endstep %}
{% step %}
Por último, ative "copiar parâmetros do evento de origem" e clique em "Guardar".
O evento personalizado não funcionará de imediato: começará a aparecer nos seus relatórios assim que tiver sido acionado várias vezes, ao fim de alguns dias. Pode selecionar este evento para obter uma visualização mais detalhada dos seus utilizadores com adblock.
{% endstep %}
{% endstepper %}
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.exoclick.com/publishers/pt/adblock/track-adblock-users-ga.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.