Бесплатные функции API Google Analytics: что включено?

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

Что входит в бесплатный пакет API?

Во-первых, бесплатный уровень покрывает почти все базовые отчёты, которые нужны большинству небольших сайтов. Вы получаете доступ к таким показателям, как количество сеансов, источники трафика, демографические данные и поведение пользователей. Запросы к этим метрикам не требуют дополнительных расходов, если вы не превышаете лимит 10 000 запросов в день – этот лимит достаточно щедр для большинства проектов.

Важный момент – бесплатный пакет поддерживает два основных продукта: Google Analytics Reporting API v4 и Data API. Оба позволяют формировать пользовательские запросы, комбинировать метрики и измерения, а также фильтровать данные по нужным параметрам. Вы можете создать отчёт о посещаемости за последние 30 дней, сравнить трафик из разных каналов или построить пользовательскую воронку без единой копейки.

Есть и ограничения, о которых стоит помнить. Бесплатные запросы не дают доступа к расширенным функциям, таким как BigQuery Export, пользовательские измерения выше определённого уровня и премиум‑отчёты. Кроме того, если ваш сайт генерирует более 10 000 запросов в сутки, система начнёт ограничивать доступ, и вы столкнётесь с ошибкой quota exceeded.

Как быстро начать использовать API?

Самый простой способ – воспользоваться готовыми библиотеками Google для вашего языка программирования. В примерах ниже мы покажем, как настроить запрос на Python, но аналогичный код есть и для JavaScript, PHP и Java.

Шаг 1: создайте проект в Google Cloud Console и включите Google Analytics API. Затем создайте OAuth‑клиент и скачайте файл credentials.json. Этот файл будет нужен для авторизации ваших запросов.

Шаг 2: установите библиотеку клиента. Для Python это делается командой pip install --upgrade google-analytics-data. После установки импортируйте нужные модули и укажите путь к credentials.json.

Шаг 3: сформируйте запрос. Например, чтобы получить показатель "sessions" за последний месяц, ваш код будет выглядеть так:

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import DateRange, Metric, RunReportRequest

client = BetaAnalyticsDataClient()
request = RunReportRequest(
    property="properties/YOUR_PROPERTY_ID",
    date_ranges=[DateRange(start_date="30daysAgo", end_date="today")],
    metrics=[Metric(name="sessions")]
)
response = client.run_report(request)
print(response)

Запустив скрипт, вы получите JSON‑ответ с числом сеансов за указанный период. Всё, что нужно – подставить ваш ID свойства и при необходимости добавить измерения, такие как "sourceMedium" или "deviceCategory".

Если вам нужен более сложный отчёт, просто добавьте нужные метрики и измерения в массивы. API умеет объединять несколько дат-диапазонов, сравнивать прошлый и текущий периоды и возвращать данные в удобном формате CSV, если вы добавите параметр "dimensions".

Помимо кода, не забывайте про практические лайфхаки: кешируйте ответы, если планируете показывать одни и те же данные пользователям часто, и следите за лимитами в реальном времени через панель Google Cloud. Это поможет избежать неожиданного отключения и сохранить быстрый отклик вашего сайта.

Итак, бесплатный уровень API Google Analytics покрывает всё, что нужно для базовой аналитики, а начать работать с ним проще, чем кажется. Попробуйте прямо сейчас, настройте запросы и получайте точные данные без лишних затрат.