Введение
Logs API позволяет получать неагрегированные данные, собираемые Яндекс Метрикой. Данный API предназначен для пользователей сервиса, которые хотят самостоятельно обрабатывать статистические данные и использовать их для решения уникальных аналитических задач.
Хранить и управлять полученными данными можно с помощью ClickHouse.
Примечание
Данные в визитах обновляются по мере поступления новой информации о них. В среднем 99 % визитов завершаются в течение 3 дней после их начала.
Для использования API нужен авторизационный токен. Его необходимо указывать в каждом запросе к API. При запросах расходуются квоты, в случае их превышения дальнейшие действия пользователя будут временно заблокированы.
Для одного счетчика Яндекс Метрики суммарный размер данных, передаваемых в запросах (включая не удаленные из хранилища логи), составляет 10 ГБ.
Примечание
Статистическая информация за текущий день недоступна, так как может быть неполной. Рекомендуем запрашивать данные за предыдущий день и более ранний период.
Ограничения
В одном запросе можно запрашивать данные за период не более 1 года.
Общая квота на объем данных, которые можно выгрузить или загрузить, составляет 10 ГБ. Это ограничение применяется ко всем подготовленным файлам логов.
Чтобы освободить квоту на хранение, регулярно удаляйте как подготовленные, так и скачанные лог-файлы. Так вы предотвратите превышение установленного лимита хранилища.
Примечание
Чтобы узнать, сколько места доступно для хранения лог-файлов Метрики в данный момент, получите список запросов логов и вручную просуммируйте значения из поля size.
Как увеличить квоту
Если вы хотите увеличить квоту, подключите Метрику Про.
Вопросы и ответы
Почему данные в Logs API и в веб-интерфейсе Метрики могут различаться
Это происходит, поскольку в интерфейсе используются дополнительные алгоритмы обработки данных. Чтобы корректно работать с этими данным, система сохраняет числа по стандарту IEEE 754.
Важно
Стандарт IEEE 754 допускает неточности при арифметических операциях. Чтобы повысить точность расчетов, числа умножаются на определенный коэффициент.
При работе с целыми числами точность не теряется. В числах с плавающей точкой исходное значение будет отличаться от полученного. При попытке вернуть полученное значение в исходный вид, результат будет отличаться на точность, заданную коэффициентом.
Поля, для которых используются коэффициенты
|
Поле |
Коэффициент |
|
ym:s:purchaseRevenue |
1 (используется также в API отчетов) |
|
ym:s:goalsPrice |
1000 |
|
ym:s:productsPrice |
1 000 000 |
|
ym:s:impressionsProductPrice |
|
|
ym:s:purchaseTax |
|
|
ym:s:eventsProductPrice |