# Описание принципов работы

Счётчик Топ-100 поддерживает до восьми уровней вложенности блоков. Накопленная статистика становится доступна для просмотра в отчёте «Аналитика блоков».

Для формирования корректного отчёта необходимо:

* передавать список отслеживаемых data-атрибутов в коде счётчика Топ-100 для каждой страницы сайта (параметр `'data-attributes'`)
* разметить data-атрибутами смысловые блоки на странице (подробнее - в [рекомендациях по настройке](/top100-documentation/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/rekomendacii-po-nastroike-i-ispolzovaniyu.md))

При указании нескольких data-атрибутов в отчёте «Аналитика блоков» статистика будет представлена в разрезе нескольких деревьев: название каждого data-атрибута станет первым уровнем дерева в отчёте.

{% hint style="info" %}
Например, если необходимо собирать три типа событий: клики по партнерским блокам, клики по блокам с новостями, клики по панели навигации, то для удобства работы с данными в отчёте можно создать три data-атрибута: `partner`, `news`, `navigation`.
{% endhint %}

Важно учитывать:

* Для отчёта «Аналитика блоков» собираются только показы блоков и клики по ним. Показы и клики суммируются для каждого уровня дерева размеченных элементов сайта.
* Количество показов для блока, имеющего дочерние элементы, рассчитывается как максимум из числа показов его дочерних элементов + собственные показы блока.
* В отчёте представлены CTR блоков. Значение CTR рассчитывается для каждого уровня отдельно и выражается как отношение кликов к показам.

{% hint style="info" %}
Перед тем как приступить к разметке блоков рекомендуем ознакомиться с [техническими ограничениями и особенностями работы счётчика](/top100-documentation/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/ogranicheniya-i-osobennosti-primeneniya.md)[.](/top100-documentation/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/ogranicheniya-i-osobennosti-primeneniya.md)
{% endhint %}

С практическими примерами использования аналитики блоков Топ-100 можно ознакомиться в разделе «[Практическое руководство по Аналитике блоков](/top100-documentation/prakticheskie-primery-i-ispolzovanie-cook-book/prakticheskoe-rukovodstvo-po-analitike-blokov.md)».


---

# Agent Instructions: 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:

```
GET https://top-100-writer.gitbook.io/top100-documentation/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/opisanie-principov-raboty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.