Как узнать дату создания ресурса Google Analytics 4?

27 апреля, 2024

Очень простой вопрос - как узнать дату создания ресурса Google Analytics 4? Но не спешите отвечать на него, ибо самое очевидное, как правило, самое невероятное. А есть ли вообще такая информация в интерфейсе в GA4? Может быть в настройках ресурса? Где-то вынесено отдельной строкой? Или все же нет? Вопрос, который является очень простым и в то же время может любого пользователя Google Analytics, даже самого продвинутого, поставить в тупик.

С таким вопросом я сталкивался несколько раз в жизни - первый раз, когда использовал шаблон отчета Looker Studio, в котором на одном из листов после анализа моего ресурса Google Analytics 4 в отдельном поле отображалась дата создания счетчика (property created).

Дата создания ресурса GA4 в шаблоне Looker Studio

Как, чёрт возьми, создатели шаблона это сделали? Откуда у них эта информация? Я и сам не помню когда точно создавал ресурс GA4, а на дашборде эта информация присутствует. Причем дата создания ресурса берется откуда-то автоматически и я никак не предоставляю им доступ к своему ресурсу. Или предоставляю?

Второй раз - это вопрос, который мне задал один из слушателей онлайн-курса по веб-аналитике. И тогда мне захотелось разобраться. Но зачем эту информацию в принципе знать? Какое практическое применение в себе содержит дата создания ресурса? Его не так много, но все же иногда полезно знать дату, например:

вы начинаете работать с проектом, на котором до вас уже что-то делали. Никаких данных предыдущий интернет-маркетолог/владелец ресурса вам не предоставил, поэтому от даты создания ресурса вы можете восстановить хронологию событий и постараться понять когда и что было сделано, или не сделано в GA4;
используя Исследование "Статистика пользователей" и проводя отладку, вы можете заметить, как для определенных пользователей дата первого посещения не совпадает с датой создания файла cookie Google Analytics. Из этого можно сделать небольшой, но важный вывод - вероятно, на сайте стояло несколько счетчиков Google Analytics, поэтому файл cookie для пользователя был создан одним счетчиком GA4, а сбор и анализ данных проводился уже на другом счетчике Google Analytics 4. И с помощью даты создания ресурса мы можем проверить эту гипотезу;
чтобы удовлетворить свой собственный интерес или просто забавы ради. А я создал ресурс 10 января 2024 года! А я - 6 декабря 2023! А я еще раньше - в сентябре 2022. Ну вы поняли 😉

К тому же, процесс извлечения даты создания ресурса Google Analytics 4 крайне увлекателен, поскольку позволяет пройтись по ранее неизвестным темам и настройкам Google Analytics 4, которые практически не используются в повседневной работе. Так же все-таки узнать дату создания ресурса GA4? Давайте разберем три способа (от простого к сложному):

через интерфейс Google Analytics 4;
с помощью Admin API;
с помощью Google APIs Explorer.

Извлечение даты создания ресурса в Looker Studio является нетривиальной задачей, поэтому подробное описание того, как это можно сделать, я оставлю до следующей статьи.

Содержание

Дата создания ресурса в интерфейсе Google Analytics 4

Да, в интерфейсе Google Analytics 4 можно посмотреть дату создания счетчика. Для того, чтобы это сделать, перейдите в раздел Администратор - Ресурс - История изменений ресурса:

Администратор - Ресурс - История изменений ресурса

Примечание: чтобы просматривать историю изменений в аккаунте или ресурсе GA4, требуется роль редактора.

На открывшейся странице в правом верхнем углу нажмите на Другие фильтры:

Другие фильтры

В фильтре Любое действие выберите СОЗДАНО:

Фильтр на "Создано"

В фильтре Любой тип товара выберите РЕСУРС:

Фильтр на "Ресурс"

После этого нажмите кнопку Применить:

Применить фильтры

При необходимости измените диапазон дат:

Изменение диапазона дат

В результате в истории изменений ресурса вы должны увидеть одну строку с датой создания счетчика Google Analytics 4:

Дата создания ресурса Google Analytics 4

В примере выше, счетчик GA4 для ресурса streamanalytics.ru был создан 18 апреля 2024 года в 16:54:53 (часовой пояс используется тот, который установлен в вашей операционной системе).

Однако в функционале истории изменений есть существенной недостаток - записи о действиях хранятся в истории изменений два года. Это означает, что если ваш счетчик Google Analytics 4 был создан более двух лет назад (для моего блога osipenkov.ru - это 6 августа 2019 г.), то в интерфейсе GA4 вы не сможете узнать точную дату. Для этого придется использовать другой способ - Admin API.

Дата создания ресурса с помощью Admin API

Чтобы обойти ограничение в два года и узнать дополнительные сведения по ресурсу Google Analytics 4, вы можете обратиться к API Google Analytics 4. В отличие от классических задач по выгрузке данных из GA4 с помощью Data API, для этой задачи необходимо использовать Admin API (API администратора). Admin API - это программный интерфейс приложения, который предоставляет доступ к данным конфигурации Google Analytics 4 (GA4) и позволяет управлять аккаунтами, ресурсами, потоками данными и другими объектам через код (например, Python).

Примечание: Admin API совместим только с ресурсами GA4.

Вы можете использовать API администратора Google Analytics, чтобы:

предоставлять доступы для новых учетных записей;
управлять аккаунтами;
управлять настройками обмена данными;
извлекать список сводных данных по счетам;
выполнять поиск событий истории изменений;
управлять ресурсами;
управлять настройками хранения данных для ресурса;
управлять настройками сигналов Google (Google Signals);
управлять потоками данных;
управлять секретными ключами для Measurement Protocol;
создавать фрагмент тега Google для веб-потоков;
управлять событиями-конверсиями (ключевыми событиями);
управлять специальными параметрами и показателями;
управлять связями между ресурсами GA4 и проектами Firebase;
управлять связями между ресурсами GA4 и аккаунтами Google Рекламы;
управлять связями между ресурсом GA4 и проектом BigQuery;
управлять разрешениями пользователей для иерархии аккаунтов и ресурсов GA4;
управлять аудиториями;
и другими настройками.

О том, как начать работу с Admin API, подробно написано в официальной документации Google. Давайте повторим эти настройки вместе, чтобы у вас было практическое руководство по управлению ресурсами GA4, благодаря которому вы сможете извлекать дату создания счетчика Google Analytics.

Итак, последовательность действий по извлечению даты создания счетчика Google Analytics 4 с помощью Admin API сводится к нескольким простым шагам:

создание проекта в Colab;
быстрый запуск API через официальную документацию Google;
добавление сервисного аккаунта в ресурс Google Analytics 4;
написание запроса на Python.

Рассмотрим каждый шаг подробнее.

1. Создание проекта в Colab

Чтобы работать с API аналитических систем и выполнять запросы на Python, необходимо использовать специальное программное обеспечение (ПО). Такое ПО называют интегрированной средой разработки (IDE). Наиболее популярным Python IDE является PyCharm. Еще очень распространена IDE Spyder и JupyterLab.

Многие интернет-маркетологи и аналитики данных в своей работе так же используют блокнот Jupyter Notebook, который можно установить с помощью дистрибутива Anaconda, включающий набор популярных библиотек для работы с данными, таких как: NumPy, SciPy, Astropy и др. Еще есть Visual Studio Code и много других продуктов.

Как вы понимаете, выбор тех или иных программ зависит исключительно от ваших предпочтений в изучении или от тех инструментов, которые используются в вашей компании. Однако для работы с API Google Analytics 4 я предлагаю использовать другой сервис - Google Colab.

Colaboratory (или просто Colab) - это бесплатный продукт Google Research. Он позволяет любому человеку писать и выполнять код Python прямо в браузере, без установки каких-либо программ и без дополнительной настройки. По сути, Colab - это размещенная на хостинге служба Jupyter Notebook, которая предоставляет доступ к своим вычислительным ресурсам, включая графические процессоры, благодаря которым можно заниматься не только базовой аналитикой данных, но и более сложными исследованиями в области машинного обучения. Google в Colab поддерживает актуальное состояние библиотек и их взаимную работу. Ваши проекты сохраняются не локально на компьютере, а на Google Диске. Они также могут быть загружены с GitHub. Таким образом, вы можете легко работать над одним проектом с другими людьми и делиться файлами со своей командой. Colab - отличное решение для начинающих пользователей, студентов, специалистов по обработке данных и исследователей в области искусственного интеллекта.

Пример программы в Colab

Чтобы создать свой первый проект в Colab, авторизуйтесь в своей учетной записи Gmail и перейдите по ссылке. Вам откроется приветственное окно и ваши проекты:

Первый экран в Colaboratory

Если вы никогда раньше не работали с Colaboratory, то никаких проектов, кроме демонстрационного, в списке вы не увидите. Для создания первого проекта нажмите на Создать блокнот:

Создание блокнота

В новом окне вы увидите только что созданный блокнот, в котором вы будете писать код программы на Python. При желании вы можете переименовать свой проект, задав ему понятное название, например - Admin API. Дата создания ресурса Google Analytics 4:

Переименование блокнота Colab

На этом первый шаг завершен. Оставьте вкладку с вашим проектом Colab открытой и переходите к следующему этапу.

2. Быстрый запуск API

Начинающим пользователям Google предоставляет возможность быстро начать работу с Admin API, перейдя в официальную документацию разработчиков. Сделайте это, а затем на открывшейся вкладке нажмите на синюю кнопку Enable the Google Analytics Admin API:

Enable the Google Analytics Admin API

Это действие автоматически создаст вам новый проект в Google Cloud Platform (GCP), а также активирует Google Analytics Admin API и создаст учетную запись службы, необходимую для дальнейшего создания запросов. Для работы с Admin API платежный аккаунт в Google Cloud не требуется, поэтому вы можете использовать любую учетную запись Gmail.

В открывшемся окне введите имя проекта (Enter new project name). Например, Admin API GA4:

Название проекта

В завершение нажмите NEXT (Далее). Начнется автоматическое создание проекта. Через некоторое время Google выдаст вам уведомление об успешной настройке проекта и создании учетной записи службы:

Приватный ключ

Скачайте к себе на компьютер приватный ключ, нажав на кнопку DOWNLOAD PRIVATE KEY AS JSON. Его вы будете использовать для аутентификации своей учетной записи службы. Сохраните этот файл в надежном месте, так как любой, у кого есть этот ключ, может выступать в качестве сервисного аккаунта для доступа к вашим ресурсам Google Cloud Platform. В конце нажмите DONE.

Вы можете открыть сохраненный файл обычным блокнотом (формат .json), чтобы посмотреть, из чего он состоит:

Открытие файла в Notepad++

Этот файл вам в дальнейшем понадобится для проекта в Colab.

Чтобы удостовериться в том, что Google сам автоматически создал нам новый проект и учетную запись службы (сервисный аккаунт) в GCP для работы с Admin API, перейдите по ссылке console.cloud.google.com. Если в Google Cloud Platform у вас уже созданы и другие проекты, нажмите в верхней части панели на название:

Открытие списка проектов в Google Cloud

В открывшемся окне сверху выберите вкладку ALL. Вы должны увидеть новый созданный проект с вашим названием:

Созданный проект

Нажмите на него, чтобы открыть. Затем перейдите в APIs & Services:

APIs & Services

Удостоверьтесь, что в разделе Enabled APIs & services включен Google Analytics Admin API:

Google Analytics Admin API включен

Нажмите на название. Если Status – Enabled, то Google Analytics Admin API включен:

Google Analytics Admin API - Enabled

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

Теперь перейдите в раздел Credentials, чтобы увидеть данные сервисного аккаунта, созданного автоматически:

Credentials - Service Accounts

Данные по сервисному аккаунту уже присутствуют в выгруженном JSON файле с приватным ключом в строке client_email:

Данные о сервисном аккаунте есть в вашем приватном ключе

3. Добавление сервисного аккаунта в Google Analytics 4

Скопируйте адрес электронной почты сервисного аккаунта (или из сохраненного файла из поля client_email, или из интерфейса GCP) и откройте свой ресурс Google Analytics 4, с которым планируете работать. Перейдите в раздел Администратор – Ресурс - Управление доступом к ресурсу:

Управление доступом к ресурсу

Добавьте нового пользователя:

Добавление нового пользователя

Для работы с Google Analytics Admin API v1 необходимы только разрешения на чтение и анализ (он же Читатель). В поле адреса электронный почты добавьте скопированный на предыдущем шаге e-mail сервисного аккаунта:

Роль - Читатель

В правом верхнем углу нажмите кнопку Добавить. На этом добавление сервисного аккаунта в Google Analytics 4 завершено.

4. Написание запроса на Python

Все готово к написанию своего первого запроса к Data API (GA4) на Python с использованием клиентской библиотеки, браузера и Colab.

Для этого вернитесь на вкладку с вашим проектом, созданным на первом шаге, и в первой строке введите команду установки клиентской библиотеки Google Analytics:

pip install google-analytics-admin

1	pip install google-analytics-admin

Нажмите иконку запуска (значок play), чтобы код в ячейке сработал. В Colab это будет выглядеть так:

Установка клиентской библиотеки Google Analytics для работы с Admin API

Примечание: если Google попросит перезапустить вас перезапустить сеанс с помощью всплывающего окна, сделайте это.

Напротив строки с кодом должна появится зеленая галочка, свидетельствующая об успешном выполнении кода:

Успешное выполнение ячейки с кодом

Чтобы продолжить писать программу, сверху вашего блокнота нажмите на + Код:

Добавление новой ячейки для кода

Под первой ячейкой у вас будет создана новая, пустая:

Новая ячейка

На следующем шаге загрузите ваш приватный ключ, сохраненный на компьютере, в проект Colab. Для этого в левом меню нажмите на иконку с папкой:

Файлы в Colab

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

Google может выдать предупреждение о том, что он рекомендует сохранять файлы не только в среде выполнения, но еще и в Google Drive, чтобы иметь постоянный доступ к приватному ключу. Для этой задачи это не важно. Поэтому просто проигнорируйте данное сообщение (ОК).

Предупреждение

После этого вы должны увидеть ваш приватный ключ в списке файлов вашего проекта Colab:

Ваш приватный ключ в Colab

Чтобы у вас в дальнейшем не было проблем к подключению к этому файлу, переименуйте приватный ключ, заменив пробелы на какой-либо другой знак, например, на нижнее подчеркивание _ или тире -

Переименование файла

Затем нажмите на него правой кнопкой мыши и выберите Скопировать путь:

Скопировать путь

В новой ячейке программы вставьте нижеприведенный код:

import os
os.environ["GOOGLE_APPLICATION_CREDENTIALS"]="путь_к_приватному_файлу.json"

1 2	import os os.environ["GOOGLE_APPLICATION_CREDENTIALS"]="путь_к_приватному_файлу.json"

, где вместо путь_к_приватному_файлу.json вы укажете тот путь, который скопировали с предыдущего шага. Затем запустите ячейку с кодом.

В Colab это будет выглядеть так:

Путь к приватному ключу

Мы подошли к самому главному - написании запроса на Python для извлечения даты ресурса Google Analytics 4. Для этого можно воспользоваться готовым кодом от Google, который опубликован у них на GitHub. В нем используется метод properties.list, который возвращает ресурсы Google Analytics 4 от указанной учетной записи (аккаунта).

Скопируйте нижеприведенный код:

# [START analyticsadmin_properties_list]
from google.analytics.admin import AnalyticsAdminServiceClient
from google.analytics.admin_v1alpha.types import ListPropertiesRequest


def run_sample():
    """Runs the sample."""
    # TODO(developer): Replace this variable with your Google Analytics
    #  account ID (e.g. "123456") before running the sample.
    account_id = "YOUR-GA-ACCOUNT-ID"
    list_properties(account_id)


def list_properties(account_id: str, transport: str = None):
    """
    Lists Google Analytics 4 properties under the specified parent account
    that are available to the current user.

    Args:
        account_id(str): The Google Analytics account ID.
        transport(str): The transport to use. For example, "grpc"
            or "rest". If set to None, a transport is chosen automatically.
    """
    client = AnalyticsAdminServiceClient(transport=transport)
    results = client.list_properties(
        ListPropertiesRequest(filter=f"parent:accounts/{account_id}", show_deleted=True)
    )

    print("Result:")
    for property_ in results:
        print(property_)
        print()


# [END analyticsadmin_properties_list]


if __name__ == "__main__":
    run_sample()

# [START analyticsadmin_properties_list]

from google.analytics.admin import AnalyticsAdminServiceClient

from google.analytics.admin_v1alpha.types import ListPropertiesRequest

def run_sample():

"""Runs the sample."""

# TODO(developer): Replace this variable with your Google Analytics

# account ID (e.g. "123456") before running the sample.

account_id = "YOUR-GA-ACCOUNT-ID"

list_properties(account_id)

def list_properties(account_id: str, transport: str = None):

"""

Lists Google Analytics 4 properties under the specified parent account

that are available to the current user.

Args:

account_id(str): The Google Analytics account ID.

transport(str): The transport to use. For example, "grpc"

or "rest". If set to None, a transport is chosen automatically.

"""

client = AnalyticsAdminServiceClient(transport=transport)

results = client.list_properties(

ListPropertiesRequest(filter=f"parent:accounts/{account_id}", show_deleted=True)

)

print("Result:")

for property_ in results:

print(property_)

print()

# [END analyticsadmin_properties_list]

if __name__ == "__main__":

run_sample()

Вставьте этот код в новую ячейку своего проекта Colab, но не запускайте его. Поскольку вы скопировали пример кода, то в нем нужно изменить Идентификатор аккаунта (account_id).

Чтобы найти свой идентификатор аккаунта, в интерфейсе GA4 перейдите в раздел Администратор – Настройки аккаунта - Сведения об аккаунтах. Скопируйте значение идентификатора аккаунта:

Идентификатор аккаунта Google Analytics 4

Вставьте его в скопированном коде в поле account_id:

Ваш идентификатор аккаунта GA4 в переменной account_id

После этого запустите код в Colab. Если вы все сделали правильно, то вы должны получить список ресурсов с такими данными:

Результат выполнения запроса

В строке name вы увидите свой счетчик Google Analytics 4 с идентификатором ресурса (у меня - 206854065), а чуть ниже объект create_time, в котором отображается два параметра - seconds и nanos. Именно значение seconds в формате TIMESTAMP и хранит в себе дату создания вашего счетчика Google Analytics 4.

TIMESTAMP - тип данных для хранения даты и времени. Данные хранятся в виде количества секунд, прошедших с начала "эпохи Юникса" (Unix-время), то есть с 1 января 1970 года.

Чтобы преобразовать это значение в удобочитаемый (понятный формат), воспользуйтесь специальным сервисом, например, unixtimestamp.com. Скопируйте значение из seconds и вставьте его в поле конвертера, а затем нажмите Convert.

Результат преобразования значения в дату и время

Поскольку Google, как вы уже знаете, при создании, изменении и удалении аккаунтов/ресурсов и других объектов в Google Analytics 4 использует часовой пояс, который установлен в вашей операционной системе, то и в Unix Timestamp конвертере вы можете ориентироваться на строку Your Time Zone. Таким образом, мой ресурс Google Analytics 4 для osipenkov.ru был создан 6 августа 2019 года в 21:59:48 по Московскому времени. Идеально точное время, которое вы не найдете в интерфейсе GA4 спустя два года.

Точно таким же способом вы можете поступить с другими ресурсами Google Analytics 4, используя вышеприведенный код и идентификатор аккаунта GA4, запросив данные по дате создания.

Ссылка на мой проект Colab, который получился для этой задачи. Используйте его как подсказку или ориентир при извлечении даты создания вашего ресурса Google Analytics 4.

Дата создания ресурса в Google APIs Explorer

Чтобы не использовать Admin API, не создавать проект в Colab и Google Cloud, не писать код на Python, не предоставлять доступ сервисному аккаунту в Google Analytics 4, не загружать приватный ключ и т.д., можно воспользоваться Google APIs Explorer - это инструмент, доступный на большинстве страниц справочной документации по REST API, который позволяет вам опробовать методы Google API без написания кода.

Поскольку мы использовали только метод метод properties.list, то перейдя на эту страницу, вы увидите справа как раз окно от APIs Explorer.

Попробовать метод в браузере

Все, что вам нужно сделать, это в поле filter вставить конструкцию parent:accounts/77456218, где вместо 77456218 вам необходимо указать идентификатор аккаунта Google Analytics 4 (см. выше):

Фильтр по идентификатору аккаунта

Затем прокрутите страницу в самый низ и нажмите кнопку Execute:

Execute

Вам откроется окно авторизации от Google, в котором вам надо разрешить приложению APIs Explorer выполнение определенных команд. Зайдите в учетную записью Google (Gmail) под тем логином, на котором у вас есть доступ к вашему ресурсу Google Analytics 4.

Авторизация в Google и переход в приложение Google APIs Explorer

Если вы все сделали верно, то в самом низу Google APIs Explorer должен отобразиться результат выполнения запроса с кодом 200:

createTime - дата создания ресурса GA4

А в строке createTime - желаемый результат с датой создания ресурса Google Analytics 4.

Итого

Казалось бы, такая простая задача "как узнать дату создания ресурса Google Analytics 4" должна решаться в одно-два действия. Однако, как вы узнали из этого руководства, везде есть подводные камни и окончательный ответ не так очевиден, как может показаться на первый взгляд.

Если ваш счетчик Google Analytics 4 был создан более двух лет назад, то в интерфейсе GA4 вы не сможете узнать точную дату, используя историю изменений, поскольку там хранятся записи обо всех действиях только за этот период. Тогда вы можете пойти другими путями - написать свой собственный код на Python с помощью Admin API, а также воспользоваться Google APIs Explorer, который позволяет выполнять различные методы Google API без написания кода.

Метки: Admin API, APIs Explorer, Google Analytics 4