Аналитика

Аналитика — это счётчики и панели поисковиков, подключённые к сайту: Яндекс Метрика, Google Analytics 4, Google Search Console и Яндекс Вебмастер. Это системные данные: каждый сервис — поле эндпоинта /data/settings/{поле}: metrika, ga, gsc и webmaster.

В консоли сервисы подключаются на странице «SEO» → «Счётчики», через API в поле сервиса записывают одно значение: номер своего счётчика, "auto" или null, чтобы отключить. Поэтому AI-агенту не нужна консоль: Метрика и GA4 на новом сайте — два коротких запроса, и после них код счётчиков стоит на всех страницах.

Во всех примерах API — https://onpress.pro/api/v2, SITE — id сайта (SITE_ID), OP_TOKEN — токен op_XXXX. Полный перечень эндпоинтов — в справочнике API.

Прочитать

В консоли. Раздел «Аналитика» (/dashboard/analytics) показывает клики, показы и визиты по всем подключённым сервисам одним дашбордом. Какие сервисы подключены, видно в разделе «SEO» → «Счётчики» (/dashboard/seo/counters): у каждого сервиса статус, а в меню «…» — ссылка на его отчёт.

Через API. GET /data/settings/{поле} показывает, подключён ли сервис. В value — номер счётчика, measurement ID или код подтверждения, null значит, что сервис не подключён. Все четыре сервиса вместе с остальными настройками отдаёт GET /data/settings. Например, Метрика:

curl -s "$API/site/$SITE/data/settings/metrika" -H "Authorization: Bearer $OP_TOKEN"

Поле	Что это
`value`	номер счётчика Метрики, measurement ID GA4, код подтверждения Search Console или id сайта в Вебмастере
`enabled`	код счётчика выводится на страницах (Метрика и GA4)
`mode`	`auto` — подключено через OnPress, `own` — своим кодом или своим аккаунтом (Search Console и Вебмастер)
`verified`	права на сайт подтверждены (Search Console и Вебмастер)
`open_url`	ссылка на отчёт сервиса
`auto_available`	доступно ли подключение через OnPress
`data`	статистика, которую загрузил OnPress: `last_date` — последний день, `collected_at` — когда загружена (UTC), `days` — сколько дней хранится

Подключить через OnPress

Если своего счётчика нет, его подключает OnPress: находит счётчик по домену сайта в своём аккаунте или заводит новый и ставит код на все страницы. Подключение обращается к Яндексу или Google и идёт до минуты. Доступ к такому счётчику в самой Метрике или GA4 выдаётся по email на странице «Счётчики» консоли.

В консоли. Откройте «SEO» → «Счётчики» и нажмите «Подключить» у нужного сервиса. В пустом разделе «Аналитика» та же кнопка ведёт на эту страницу.

Через API. Запишите в поле "auto". Например, GA4:

curl -s -X PUT "$API/site/$SITE/data/settings/ga" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"value": "auto"}'

Подключить свой счётчик

Свой счётчик подключают номером: Метрика принимает номер счётчика, GA4 — measurement ID вида G-XXXXXXXXXX из настроек потока данных. Номер записывается в настройки сайта, и код счётчика появляется на всех страницах.

В консоли. Поля для своего номера в консоли нет: кнопка «Подключить» всегда подключает счётчик через OnPress.

Через API. PUT /data/settings/{поле} с номером. Например, Метрика:

curl -s -X PUT "$API/site/$SITE/data/settings/metrika" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"value": "12345678"}'

Подтвердить сайт в Search Console

Search Console подтверждает права на сайт HTML-тегом google-site-verification на главной странице. Через OnPress код получают у Google, ставят тег, подтверждают сайт и добавляют его в Search Console. В своём аккаунте выберите в Search Console способ «HTML-тег», поставьте код на сайт и нажмите «Подтвердить» в Search Console.

В консоли. «SEO» → «Счётчики» → «Подключить» у Search Console. Если Google не успел увидеть тег, в меню «…» есть «Подтвердить ещё раз». Свой код консоль не принимает.

Через API. "auto" подтверждает сайт через OnPress, свой код записывается значением атрибута content или тегом целиком. Например, свой код:

curl -s -X PUT "$API/site/$SITE/data/settings/gsc" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"value": "Xk2tA9qL_7mVbR3cN8pWz1fJ4hD6sYuE0gTiOoKaQlM"}'

Яндекс Вебмастер

Вебмастер подключается аккаунтом OnPress или вашим аккаунтом Яндекса: OnPress добавляет сайт в Вебмастер и подтверждает права.

В консоли. «SEO» → «Счётчики» → «Подключить» у Вебмастера — аккаунтом OnPress. Свой аккаунт — строка «Свой аккаунт Яндекса», кнопка «Войти»: откроется вход в Яндекс.

Через API. Поле webmaster подключается только значением "auto". Свой аккаунт Яндекса подключается только в консоли: адрес нужной страницы — в поле connect_url ответа. Например:

curl -s -X PUT "$API/site/$SITE/data/settings/webmaster" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"value": "auto"}'

Отключить

Отключение убирает номер и код подтверждения из настроек сайта, и код сервиса пропадает со страниц. Сам счётчик в Метрике и ресурс в Google остаются вместе со статистикой: чтобы вернуть их, подключите сервис снова тем же номером или через OnPress.

В консоли. «SEO» → «Счётчики», меню «…» у сервиса → «Отключить».

Через API. Запишите в поле null. Например, отключить GA4:

curl -s -X PUT "$API/site/$SITE/data/settings/ga" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"value": null}'

Вопросы и ответы

Почему `data` пустое?

OnPress загружает статистику раз в сутки, ночью, поэтому у только что подключённого сервиса data равно null до следующего утра, а раздел «Аналитика» консоли пуст. Для своего счётчика OnPress загружает статистику, только если у его аккаунта есть доступ к этому счётчику, поэтому data обычно остаётся null. Статистику своего счётчика смотрите в самом сервисе по ссылке open_url.

Почему Search Console не подтвердила сайт?

Google проверяет тег на живой странице. Если "auto" ответил result.pending: true, Google ещё не увидел тег: повторите тот же запрос через минуту или нажмите в консоли «Подтвердить ещё раз».

Почему счётчик не видит часть посетителей?

Если на сайте стоит баннер согласия на cookie, счётчики загружаются только после согласия. Посетителей, которые отказались или не ответили, Метрика и GA4 не считают.

Почему `"auto"` вернул ошибку?

409 auto_not_available — подключение через OnPress для этого сервиса сейчас недоступно, в ответе GET у него auto_available: false. 502 service_failed — отказал Яндекс или Google, их ответ — в message. В обоих случаях подключите свой счётчик номером.

Где коды ошибок?

В справочнике API. Ответ с ошибкой сам называет причину.