Как использовать API Google Analytics

Введение

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

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

Но сначала посмотрите, как эту информацию я отобразил на моём сайте:

Требования

Для получения данных нам нужны три значения:

1. GA_PROPERTY_ID

2. GA_CLIENT_EMAIL

3. GA_PRIVATE_KEY

GA_PROPERTY_ID

Во-первых, вам нужно получить GA_PROPERTY_ID проекта Google Analytics, из которого вы хотите извлечь данные.

Чтобы получить это, вам нужно выполнить следующие действия:

1. Зайти на Google Analytics.

2. Выберите Администратор (Admin).

3. Выберите Свойство (Property).

4. Выберите Настройки свойства (Property Settings).

Если в настройках отображается числовой идентификатор свойства (PROPERTY ID), например «123…», то это и есть нужное нам значение.

GA_CLIENT_EMAIL и GA_PRIVATE_KEY

Чтобы получить GA_CLIENT_EMAIL и GA_PRIVATE_KEY, вам необходимо посетить документацию Google Analytics Data API, а затем нажать на кнопку Включить Google Analytics Data API v1, как показано на рисунке ниже:

И затем вам будет предложено ввести название проекта. После ввода имени нажмите на кнопку Далее:

Затем вам будет предложено загрузить файл учетных данных в формате JSON.

После загрузки этого файла. Вы найдете свойства private_key и client_email в этом файле JSON. Сохраните эти два файла в вашем .env.local.

Теперь у вас есть вся необходимая информация / ключи.

Установка зависимостей

Чтобы получить данные, вам необходимо установить пакет @google-analytics/data. Вы можете сделать это, просто выполнив следующую команду в терминале.

yarn add @google-analytics/data # or  npm i @google-analytics/data # or pnpm i @google-analytics/data

Использование API данных Google Analytics в проекте

Поскольку я использую Next.js для моего сайта, поэтому я буду использовать Next.js API Routes. Вы можете сделать то же самое с разными фреймворками.

Я создам API путь pages/api/ga.ts:

import { NextApiRequest, NextApiResponse } from "next"; import { BetaAnalyticsDataClient } from "@google-analytics/data";  // ? Задаём PropertyId const propertyId = process.env.GA_PROPERTY_ID;  const analyticsDataClient = new BetaAnalyticsDataClient({   credentials: {     client_email: process.env.GA_CLIENT_EMAIL,     private_key: process.env.GA_PRIVATE_KEY?.replace(/\n/gm, "\n"), // очищаем от лишних символов   }, });  export default async function handler(   _req: NextApiRequest,   res: NextApiResponse ) {   // ? Используем метод properties.runReport   const [response] = await analyticsDataClient.runReport({     property: `properties/${propertyId}`,     dateRanges: [       {         startDate: `7daysAgo`, //?  например, "7daysAgo" или "30daysAgo"         endDate: "today",       },     ],     dimensions: [       {         name: "year", // данные будут рассчитаны по годам       },     ],     metrics: [       {         name: "activeUsers", // возвращает активных пользователей       },     ],   });    // Возвращаем ответ   return res.status(200).json({     response,   }); } 

Ознакомиться с методом подробнее вы можете тут. (с) @scoffs

Это все, что вам нужно для получения данных. Если возникли какие-то трудности, то код моего сайта можно найти на GitHub.

Вы можете поиграть с измерениями и метриками, чтобы получить желаемые данные.

Заключение

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

Если вы нашли какие-то ошибки в переводе или у вас есть предложения по улучшению, то можете написать об этом в комментариях.