> 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/ru/adblock/track-adblock-users-ga.md).

# Как отслеживать пользователей AdBlock через Google Analytics 4

Хотя ExoClick отслеживает показы, клики и доход, полученные вашими рекламными зонами, у вас есть и другие инструменты для оценки общей эффективности и активности на вашем сайте. Одним из таких инструментов является [**Google Analytics**](https://support.google.com/sites/answer/97459?hl=en), который дает вам подробную информацию о том, что происходит на вашем сайте.

Вы можете настроить **пользовательское событие отслеживания** в Google Analytics, которое даст вам представление о том, сколько пользователей посещают ваш сайт с включенным Adblock. Это поможет вам понять, какой объем трафика вы могли бы монетизировать через [**решение ExoClick для Adblock**](/publishers/ru/adblock/neverblock.md).

Обратите внимание, что мы будем ссылаться на **Google Analytics 4** версию, поскольку [Universal Analytics будет отключен в июле 2023 года](https://support.google.com/analytics/answer/11583528?hl=en\&ref_topic=10094551).

{% stepper %}
{% step %}

## Создайте скрипт ad-units.js и загрузите его на свой сервер

Чтобы определить, обращается ли пользователь к нашему сайту с включенным Adblock, мы создадим JavaScript-файл под названием `ad-units.js`. Этот файл заявляет, что все пользователи, посещающие ваш сайт, не используют Adblock. Поскольку термин "ad-units" блокируется Adblock, **мы будем помечать пользователя как использующего расширение-блокировщик рекламы, если этот файл не загружен**.

Файл .js должен содержать только следующее:

```html
isAdBlockActive=false;
```

После того как вы создали этот файл, загрузите его на сервер вашего сайта.
{% endstep %}

{% step %}

## Добавьте код отслеживания на каждую из ваших страниц

Тег по умолчанию из GA отслеживает основные события, такие как [просмотры страниц, сеансы и пользователи, среди прочего](https://support.google.com/analytics/answer/9234069?hl=en\&ref_topic=13367566). Что мы собираемся сделать, так это создать [**пользовательское событие**](https://support.google.com/analytics/answer/12229021) с использованием API GA.

Для этого пользовательского кода мы собираемся создать `adblock_user` рекомендуемое событие. Код, который нужно добавить на каждую страницу, которую вы хотите отслеживать, выглядит следующим образом:

```html
<script type="text/javascript">var isAdBlockActive=true;</script>
<script src="ad-units.js" type="text/javascript"></script>
<script>
  window.onload = function(e) {
    if(isAdBlockActive){
      gtag("event", "adblock_user", {
        "user":"adblock"
      })
      console.log('Пользователь с Adblock')
        } else {
      gtag("event", "adblock_user", {
        "user":"standard"
          })
      console.log('Обычный пользователь')
    }
  };
</script>
```

Разместите этот код после `тега body` на каждом сайте, который вы хотите отслеживать. Давайте подробно рассмотрим каждую часть этого кода:

* Сначала мы объявляем переменную `isAdblockActive` как `true`, то есть каждый пользователь, посещающий ваш сайт, имеет включенный adblock. Сразу после этого мы вызовем `ad-units.js` скрипт, который мы создали ранее, и он изменит эту переменную на `false`. Это означает, что пользователи будут считаться "обычными", если только у них нет блокировщика рекламы, который блокирует `ad-units.js` файл; в противном случае они будут считаться "adblock".
* Затем мы создаем пользовательское событие под названием `adblock_user` событие на основе того, является ли переменная `isAdBlockActive` истинной или нет. Мы добавили параметр события `user` так, чтобы мы могли быстро идентифицировать его в GA. Подробно мы объясним это в следующем разделе.

Убедитесь, что вы разместили [**основной код отслеживания GA**](https://support.google.com/analytics/answer/9304153#add-tag\&zippy=%2Cadd-the-google-tag-directly-to-your-web-pages) в `теге head` иначе код не будет работать.
{% endstep %}

{% step %}

## Создайте измерение и пользовательское событие в GA

Этот шаг поможет вам **лучше визуализировать пользователей Adblock на панели управления GA**. **Измерение** можно использовать как фильтр в различных отчетах, тогда как **пользовательское событие** даст вам отдельную страницу, где можно проверить количество пользователей adblock на вашем сайте.

### Пользовательское измерение

{% stepper %}
{% step %}
Нажмите на **Администрирование** > **Пользовательские определения**, затем нажмите на **Создать пользовательские измерения**.

![Настройка пользовательского измерения 1](/files/a72e9d176fafc91a72902787f4d0ef6ddb670f56)
{% endstep %}

{% step %}
Добавьте **Adblock** как "название измерения" и выберите **Событие** как "область действия", затем добавьте описание по вашему выбору и укажите **user** в качестве "параметра события".

![Настройка пользовательского измерения 2](/files/5d3d46fa85b667e5f7145a55f04d5e26d8b2f02e)
{% endstep %}

{% step %}
Hit **Сохранить**.

Измерение не заработает сразу: оно начнет появляться в ваших отчетах только после того, как через несколько дней будет зафиксировано достаточное количество событий/пользователей. Когда оно станет доступным, вы сможете использовать его, чтобы **добавить сравнение** к просматриваемому отчету:

![Сравнение пользовательского измерения 1](/files/125ee665e76e1de0dc77c26eff19aedbee602ca4)

![Сравнение пользовательского измерения 2](/files/6c5a283560e665732d11e5855523a9aaf255f100)
{% endstep %}
{% endstepper %}

### Пользовательские события

{% stepper %}
{% step %}
Нажмите на **Администрирование** > **События**, затем нажмите на **Создать пользовательское событие**.

![Настройка пользовательского события 1](/files/87a5492c29c4b2b00f9b462a28a1a68a1a4a346a)
{% endstep %}

{% step %}
Нажмите на **Создать**. В названии пользовательского события укажите **adblock\_user**. Затем в качестве условий совпадения укажите следующее:

![Настройка пользовательского события 1](/files/da246ca2af1dae064da26c9eebcd40b7a25b540e)
{% endstep %}

{% step %}
Наконец, включите "копировать параметры из исходного события" и нажмите "Сохранить".

Пользовательское событие не заработает сразу: оно начнет появляться в ваших отчетах только после того, как будет сработано несколько раз через несколько дней. Вы можете выбрать это событие для более детального просмотра ваших пользователей adblock.

![Результаты пользовательского события](/files/9d3633461b68f208f9a5a9fa479341f5babc56da)
{% 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/ru/adblock/track-adblock-users-ga.md?ask=<question>&goal=<endgoal>
```

`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.
