> For the complete documentation index, see [llms.txt](https://top-100-writer.gitbook.io/dokumentaciya-top-100-po-novoi-modeli-progress/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://top-100-writer.gitbook.io/dokumentaciya-top-100-po-novoi-modeli-progress/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/opisanie-principov-raboty.md).

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

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

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

* передавать список отслеживаемых data-атрибутов в коде счётчика Топ-100 для каждой страницы сайта (параметр `'data-attributes'`)
* разметить data-атрибутами смысловые блоки на странице (подробнее – в [рекомендациях по настройке](/dokumentaciya-top-100-po-novoi-modeli-progress/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" %}
Перед тем как приступить к разметке блоков рекомендуем ознакомиться с [техническими ограничениями и особенностями работы счётчика](/dokumentaciya-top-100-po-novoi-modeli-progress/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/ogranicheniya-i-osobennosti-primeneniya.md)[.](/dokumentaciya-top-100-po-novoi-modeli-progress/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/podklyuchenie-i-nastroika-analitiki-blokov/ogranicheniya-i-osobennosti-primeneniya.md)
{% endhint %}

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