API Google Analytics: подключение и практическое использование

Если хочется видеть точные цифры посещаемости, конверсий и поведения пользователей прямо в своем приложении или серверном скрипте, API Google Analytics – ваш лучший помощник. С ним можно запросить любые отчёты, от количества просмотров до сложных сегментов, и автоматизировать их обработку.

Как настроить доступ к API

Первый шаг – создать проект в Google Cloud Console. Откройте Credentials, нажмите «Create credentials» и выберите «OAuth client ID» или «Service account», если запросы будут выполнять сервер без пользовательского взаимодействия. Скачайте JSON‑файл с ключами и сохраните его в безопасном месте.

Дальше включаем API Google Analytics в разделе «APIs & Services». После активации у вас будет возможность выполнять запросы к https://analyticsreporting.googleapis.com/v4/reports:batchGet. Не забудьте добавить нужные разрешения (scope) – обычно https://www.googleapis.com/auth/analytics.readonly.

Запросы и обработка данных

Сформировать запрос проще, чем кажется. Нужно указать viewId (идентификатор представления), диапазон дат, метрики и измерения. Пример JSON‑тела запроса:

{
  "reportRequests": [{
    "viewId": "12345678",
    "dateRanges": [{"startDate": "2024-01-01", "endDate": "2024-01-31"}],
    "metrics": [{"expression": "ga:sessions"}],
    "dimensions": [{"name": "ga:country"}]
  }]
}

Отправляем POST‑запрос с токеном доступа, получаем ответ в формате JSON. В нём легко вытащить нужные цифры, построить графики или загрузить в базу данных для дальнейшего анализа.

Если хотите автоматизировать отчёты, сделайте cron‑задачу, которая каждый день вызывает API, сохраняет данные и отправляет их вам на почту. В результате вы получаете свежую информацию без ручного входа в интерфейс Google Analytics.

Помните про лимиты: бесплатный уровень позволяет делать до 10 000 запросов в день. При больших объёмах лучше перейти на платный тариф или распределять запросы по времени.

Итог прост – с API Google Analytics вы берёте контроль над аналитикой в свои руки, экономите время и получаете возможность интегрировать данные в любые бизнес‑процессы.