Эта инструкция написана для файла raw_metrika_methods
Функция напрямую работает с Logs API Яндекс Метрики. Для одного счетчика Яндекс.Метрики суммарный размер данных, передаваемых в запросах (включая не удаленные из хранилища логи), составляет 10 ГБ.
Видео о том, как работать с коннектором:
| Параметр | Описание |
|---|---|
| Метод | Указывает тип запроса к Метрике. См. далеее |
| Идентификатор запроса ( ID запроса) | Идентификатор запроса к Logs API. Обязателен для методов вам известен идентификатор запроса |
| Дата начала интервала | Начальная дата периода отчета |
| Дата окончания интервала | Последняя дата периода отчета. Не может быть сегодняшним числом |
| Номер счетчика Яндекс.Метрики | Номер счетчика, по которому хотите получить статистику |
| Ключ авторизации Яндекс.Метрики | API-ключ авторизации. Залогиньтесь в нужном аккаунте Метрики и получите ключ по ссылке |
| Тип отчета | visits - по визитам (список полей таблицы визитов) , hits - по просмотрам (список полей таблицы просмотров) |
| Список полей | Список полей согласно выбранному типу отчета в виде списка list или в виде строки через запятую |
| Метод | ID запроса | Описание |
|---|---|---|
| evaluate | - | Проверить возможность создания запроса логов для указанного аккаунта с выбранными типом, периодом и списком полей отчета. Реализует метод Оценки возможности создания запроса |
| create | - | Создать запрос логов для указанного аккаунта с выбранными типом, периодом и списком полей отчета. Расширенная реализация метода Создания запроса логов : прежде чем создать запрос, проверяет, что в аккаунте нет аналогичных отчетов по периоду дат, типу отчета и полям. Если находит, то возвращает его идентификатор |
| list | - | Отобразить список запросов и отчетов в аккаунте. Реализует метод Список запросов логов |
| info | обязателен | Запросить статус отчета с указанным идентификатором (список статусов представлен ниже). Реализует метод Информация о запросе логов |
| download | обязателен | Загрузить готовый отчет (со статусом processed). Расширенная реализация метода Загрузки подготовленных логов. Особенность в том, что загружаются и объединяются сразу все части, а не по отдельности, как это реализовано в оригинальном методе. Если отчет не готов, то ответ будет аналогичен методу info |
| clean | обязателен | Удалить готовый отчет с указанным идентификатором. Реализует метод Очистка обработанных запросов логов |
| cancel | обязателен | Отменить не подготовленный отчет с указанным идентификатором. Реализует метод Отмена не обработанного запроса логов |
| cleanall | - | Полностью очищает все обработанные и не обработанны запросы логов комбинируя методы clean и cancel |
| auto | - | В автоматическом режиме проверяет возможность создания запроса, создает запрос, дожидается подготовки отчета и загружает готовый отчет. Если аналогичный отчет уже есть, то загружается он |
Отчеты подготавливаются в течение некоторого времени от нескольких минут и более. Возможные статусы отчета:
- processed — обработан (подготовлен).
- canceled — отменён.
- processing_failed — ошибка при обработке.
- created — создан.
- cleaned_by_user — очищен пользователем.
- cleaned_automatically_as_too_old — очищен автоматически.