[GA4] Схема BigQuery Export

Ниже описываются формат и схема данных, экспортируемых в BigQuery из ресурсов GA4, а также из Google Аналитики для Firebase.

Наборы данных

Для каждого ресурса GA4 и проекта Firebase, связанного с BigQuery, в проект BigQuery добавляется один набор данных под названием "analytics_<property_id>". В качестве значения property_id подставляется идентификатор ресурса Аналитики (посмотреть его можно в настройках ресурса GA4, а также в настройках связи с Аналитикой в Firebase). В этот набор данных будут экспортироваться данные из всех ресурсов GA4 и приложений, для которых включен экспорт BigQuery.

Таблицы

Если включен ежедневный экспорт, то ежедневно для каждого набора данных создается таблица с названием events_ГГГГММДД.

Если используется потоковый экспорт, создается таблица events_intraday_ГГГГММДД. Она заполняется непрерывно по мере регистрации событий. В конце каждого дня эта таблица удаляется (после заполнения events_ГГГГММДД).

Данные с некоторых устройств отправляются в Аналитику не в тот же день, когда активируются события. Чтобы учесть эту задержку, Аналитика обновляет данные о событиях в ежедневных таблицах (events_ГГГГММДД) в течение трех дней после даты фиксации событий. События получают правильные метки времени независимо от того, когда были отправлены данные. Если данные поступают позже чем через три дня, события не регистрируются.

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

Чтобы импортировать события в течение дня, перейдите из тестовой среды в обычный режим.

Столбцы

Каждый столбец в таблице events_ГГГГММДД содержит определенный параметр события. Обратите внимание, что некоторые параметры указываются в записях (RECORD) и некоторые записи, например items и event_params, могут повторяться. Ниже приводятся описания столбцов.

Развернуть все Свернуть все

event

Название поля	Тип данных	Описание
Поля event содержат информацию, которая определяет уникальное событие.
batch_event_index	Целое число	Целое число, указывающее номер события в серии в порядке регистрации событий на устройстве.
batch_ordering_id	Целое число	Число, которое монотонно увеличивается при каждом сетевом запросе с определенной страницы.
batch_page_id	Целое число	Порядковый номер страницы, который последовательно возрастает при открытии каждой следующей страницы в ходе одного взаимодействия.
event_date	STRING	Дата, когда было зарегистрировано событие (в формате ГГГГММДД, часовой пояс приложения).
event_timestamp	INTEGER	Время, когда событие было зарегистрировано в клиенте (в микросекундах, UTC).
event_previous_timestamp	INTEGER	Время, когда событие было зарегистрировано в клиенте в прошлый раз (в микросекундах, UTC).
event_name	STRING	Название события.
event_value_in_usd	FLOAT	Значение параметра "value", сконвертированное в доллары США.
event_bundle_sequence_id	INTEGER	Порядковый идентификатор пакета, в котором были загружены события.
event_server_timestamp_offset	INTEGER	Разница между временем сбора и загрузки (в микросекундах).

Запись event_params

Название поля	Тип данных	Описание
С помощью записи event_params можно сохранять параметры события на уровне кампании, контекстные параметры события, а также любые параметры события, определенные пользователем. Запись event_params повторяется для каждого ключа, связанного с событием. В каждой реализации набор параметров, хранящийся в записи event_params, уникален. Чтобы посмотреть полный список параметров событий для своей реализации, отправьте запрос.
event_params.key	STRING	Название параметра события.
event_params.value	RECORD	Запись со значением параметра события.
event_params.value.string_value	STRING	Параметр события указывается в этом поле, если он представлен в виде строки, такой как URL или название кампании.
event_params.value.int_value	INTEGER	Параметр события указывается в этом поле, если он представлен в виде целого числа.
event_params.value.double_value	FLOAT	Параметр события указывается в этом поле, если он представлен в виде числа двойной точности.
event_params.value.float_value	FLOAT	Параметр события указывается в этом поле, если он представлен в виде числа с плавающей запятой. В настоящее время это поле не используется.

Запись item_params

Название поля	Тип данных	Описание
С помощью записи item_params можно сохранять стандартные и заданные пользователями параметры товара. В каждой реализации набор параметров, хранящийся в записи item_params, уникален.
item_params.key	STRING	Название параметра товара.
item_params.value	RECORD	Запись, содержащая значение параметра товара.
item_params.value.string_value	STRING	Если параметр выражен строкой, он указывается в этом поле.
item_params.value.int_value	INTEGER	Если параметр товара выражен целым числом, он указывается в этом поле.
item_params.value.double_value	FLOAT	Если параметр товара выражен числом двойной точности, он указывается в этом поле.
item_params.value.float_value	FLOAT	Если параметр товара выражен числом с плавающей запятой, он указывается в этом поле.

user

Название поля	Тип данных	Описание
Поля user содержат информацию, которая определяет уникального пользователя, связанного с событием.
is_active_user	BOOLEAN	Был ли пользователь активен (True) или неактивен (False) в любой момент календарного дня. Включается только в ежедневные таблицы (`events_ГГГГММДД)`.
user_id	STRING	Уникальный идентификатор, назначенный пользователю.
user_pseudo_id	STRING	Идентификатор-псевдоним (например идентификатор экземпляра приложения) пользователя. Уникальный идентификатор, который назначается пользователю, когда впервые открывает приложение или посещает сайт.
user_first_touch_timestamp	INTEGER	Время (в микросекундах), когда пользователь впервые запустил приложение или посетил сайт.

Поля privacy_info

Название поля	Тип данных	Описание
Поля privacy_info содержат информацию о статусе согласия пользователя, когда включен режим согласия.
privacy_info.ads_storage	STRING	Включен ли для пользователя таргетинг объявлений. Возможные значения: "Да", "Нет", "Не настроено"
privacy_info.analytics_storage	STRING	Включен ли для пользователя сбор данных для Google Аналитики. Возможные значения: "Да", "Нет", "Не настроено"
privacy_info.uses_transient_token	STRING	Отказался ли пользователь от сбора данных для Google Аналитики, и обеспечил ли разработчик сбор данных без файлов cookie на основе временных токенов в данных сервера. Возможные значения: "Да", "Нет", "Не настроено"

Запись user_properties

Название поля	Тип данных	Описание
Запись user_properties содержит любые заданные вами свойства пользователя. Она повторяется для каждого ключа, связанного с пользователем.
user_properties.key	STRING	Название свойства пользователя.
user_properties.value	RECORD	Запись со значением свойства пользователя.
user_properties.value.string_value	STRING	Значение свойства пользователя в виде строки.
user_properties.value.int_value	INTEGER	Значение свойства пользователя в виде целого числа.
user_properties.value.double_value	FLOAT	Значение свойства пользователя в виде числа двойной точности.
user_properties.value.float_value	FLOAT	Это поле в настоящее время не используется.
user_properties.value.set_timestamp_micros	INTEGER	Время последнего изменения свойства пользователя (в микросекундах).

Запись user_ltv

Название поля	Тип данных	Описание
Запись user_ltv содержит информацию об общей ценности пользователя. Эта запись не заполняется в таблицах в течение дня.
user_ltv.revenue	FLOAT	Общая ценность пользователя (доход от него). Это поле не заполняется в таблицах за день.
user_ltv.currency	STRING	Валюта, в которой выражена общая ценность пользователя. Это поле не заполняется в таблицах за день.

device

Название поля	Тип данных	Описание
Запись device содержит информацию об устройстве, на котором было инициировано событие.
device.category	STRING	Тип устройства (смартфон, планшет или компьютер).
device.mobile_brand_name	STRING	Бренд устройства.
device.mobile_model_name	STRING	Название модели устройства.
device.mobile_marketing_name	STRING	Торговое название устройства.
device.mobile_os_hardware_model	STRING	Сведения о модели устройства, полученные непосредственно из операционной системы.
device.operating_system	STRING	Операционная система устройства.
device.operating_system_version	STRING	Версия операционной системы.
device.vendor_id	STRING	Идентификатор IDFV (только если идентификатор IDFA не извлекается).
device.advertising_id	STRING	Рекламный идентификатор или IDFA.
device.language	STRING	Язык операционной системы.
device.time_zone_offset_seconds	INTEGER	Смещение времени относительно GMT (в секундах).
device.is_limited_ad_tracking	BOOLEAN	Включено ли ограничение отслеживания объявлений. В iOS 14 и более поздних версиях возвращается значение "Ложь", если идентификатор IDFA не равен нулю.
device.web_info.browser	STRING	Браузер, в котором пользователь просматривал контент.
device.web_info.browser_version	STRING	Версия браузера, в котором пользователь просматривал контент.
device.web_info.hostname	STRING	Имя хоста, связанного с зарегистрированным событием.

geo

Название поля	Тип данных	Описание
Запись geo содержит информацию о географическом местоположении, в котором было инициировано событие.
geo.continent	STRING	Континент, где были зарегистрированы события. Определяется по IP-адресу.
geo.sub_continent	STRING	Макрорегион, где были зарегистрированы события. Определяется по IP-адресу.
geo.country	STRING	Страна, где были зарегистрированы события. Определяется по IP-адресу.
geo.region	STRING	Регион, где были зарегистрированы события. Определяется по IP-адресу.
geo.metro	STRING	Городская агломерация, где были зарегистрированы события. Определяется по IP-адресу.
geo.city	STRING	Город, где были зарегистрированы события. Определяется по IP-адресу.

app_info

Название поля	Тип данных	Описание
Запись app_info содержит информацию о приложении, в котором было инициировано событие.
app_info.id	STRING	Название или идентификатор пакета приложения.
app_info.firebase_app_id	STRING	Идентификатор приложения в Firebase.
app_info.install_source	STRING	Магазин, из которого установлено приложение.
app_info.version	STRING	Параметр versionName (для устройств Android) или краткая версия пакета.

collected_traffic_source

Название поля	Тип данных	Описание
Запись collected_traffic_source содержит данные об источнике трафика, полученные из первого события на странице.
manual_campaign_id	STRING	Идентификатор кампании, заданный вручную (utm_id), который был получен вместе с событием.
manual_campaign_name	STRING	Название кампании, заданное вручную (utm_campaign), которое было получено вместе с событием.
manual_source	STRING	Источник кампании, настроенной вручную (utm_source), который был получен вместе с событием. Содержит не только значения UTM, но и обработанные параметры перехода.
manual_medium	STRING	Канал кампании, настроенной вручную (utm_medium), который был получен вместе с событием. Содержит не только значения UTM, но и обработанные параметры перехода.
manual_term	STRING	Ключевое слово или термин, заданный вручную (utm_term), который был получен вместе с событием.
manual_content	STRING	Дополнительные метаданные для кампании, заданные вручную (utm_content), которые были получены вместе с событием.
manual_creative_format	STRING	Данные о формате креатива из кампании, настроенной вручную (utm_creative_format), полученные вместе с событием.
manual_marketing_tactic	STRING	Данные о маркетинговой тактике кампании, настроенной вручную (utm_marketing_tactic), полученные вместе с событием.
manual_source_platform	STRING	Данные об исходной платформе кампании, настроенной вручную, (utm_source_platform), полученные вместе с событием.
gclid	STRING	Идентификатор клика Google, полученный вместе с событием.
dclid	STRING	Идентификатор клика DoubleClick для Дисплея и Видео 360 и Менеджера кампаний 360, полученный вместе с событием.
srsltid	STRING	Идентификатор Google Merchant Center, полученный вместе с событием.

session_traffic_source_last_click

Название поля	Тип данных	Описание
Запись session_traffic_source_last_click содержит данные об источнике трафика сеанса с атрибуцией по последнему клику для объявлений Google и заданного вручную контекста, если применимо.
session_traffic_source_last_click. manual_campaign.campaign_id	STRING	Идентификатор последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. manual_campaign.campaign_name	STRING	Название последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. manual_campaign.medium	STRING	Канал последней настроенной вручную кампании, в которой зарегистрирован клик, например поисковая реклама, обычный поиск, электронная почта.
session_traffic_source_last_click. manual_campaign.term	STRING	Ключевое слово/поисковый запрос в последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. manual_campaign.content	STRING	Дополнительные метаданные о последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. manual_campaign.source_platform	STRING	Платформа последней настроенной вручную кампании, в которой зарегистрирован клик, например поисковая система, социальная сеть.
session_traffic_source_last_click. manual_campaign.source	STRING	Определенный источник на платформе последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. manual_campaign.creative_format	STRING	Формат креатива из последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. manual_campaign.marketing_tactic	STRING	Маркетинговая тактика последней настроенной вручную кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. google_ads_campaign.customer_id	STRING	Идентификатор клиента, связанный с аккаунтом Google Рекламы.
session_traffic_source_last_click. google_ads_campaign.account_name	STRING	Название аккаунта Google Рекламы.
session_traffic_source_last_click. google_ads_campaign.campaign_id	STRING	Идентификатор кампании Google Рекламы.
session_traffic_source_last_click. google_ads_campaign.campaign_name	STRING	Название кампании Google Рекламы.
session_traffic_source_last_click. google_ads_campaign.ad_group_id	STRING	Идентификатор группы объявлений в кампании Google Рекламы.
session_traffic_source_last_click. google_ads_campaign.ad_group_name	STRING	Название группы объявлений в кампании Google Рекламы.
session_traffic_source_last_click. cross_channel_campaign.campaign_name	STRING	Название последней многоканальной кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. cross_channel_campaign.campaign_id	STRING	Идентификатор последней многоканальной кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. cross_channel_campaign.source_platform	STRING	Платформа последней многоканальной кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. cross_channel_campaign.source	STRING	Определенный источник на платформе последней многоканальной кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. cross_channel_campaign.medium	STRING	Канал из последней многоканальной кампании, в которой зарегистрирован клик.
session_traffic_source_last_click. sa360_campaign.campaign_name	STRING	Название последней кампании Поиска 360, в которой зарегистрирован клик.
session_traffic_source_last_click. sa360_campaign.source	STRING	Определенный источник на платформе последней кампании Поиска 360, в которой зарегистрирован клик.
session_traffic_source_last_click. sa360_campaign.medium	STRING	Канал последней кампании Поиска 360, в которой зарегистрирован клик.
session_traffic_source_last_click. sa360_campaign.ad_group_id	STRING	Идентификатор группы объявлений в кампании Поиска 360.
session_traffic_source_last_click. sa360_campaign.ad_group_name	STRING	Название группы объявлений из кампании Поиска 360.
session_traffic_source_last_click. sa360_campaign.campaign_id	STRING	Идентификатор последней кампании Поиска 360, в которой зарегистрирован клик.
session_traffic_source_last_click. sa360_campaign.creative_format	STRING	Формат креатива из последней кампании Поиска 360, в которой зарегистрирован клик.
session_traffic_source_last_click. sa360_campaign.engine_account_name	STRING	Название системного аккаунта Поиска 360.
session_traffic_source_last_click. sa360_campaign.engine_account_type	STRING	Тип системного аккаунта, к которому относится кампания Поиска 360.
session_traffic_source_last_click. sa360_campaign.manager_account_name	STRING	Название управляющего аккаунта Поиска 360.
session_traffic_source_last_click. dv360_campaign.advertiser_id	STRING	Идентификатор рекламодателя DV360.
session_traffic_source_last_click. dv360_campaign.advertiser_name	STRING	Имя или название рекламодателя DV360.
session_traffic_source_last_click. dv360_campaign.campaign_id	STRING	Идентификатор последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.campaign_name	STRING	Название последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.creative_id	STRING	Идентификатор креатива из последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.creative_format	STRING	Формат креатива из последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.creative_name	STRING	Название креатива из последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.marketing_tactic	STRING	Маркетинговая тактика последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.exchange_id	STRING	Идентификатор биржи для последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.exchange_name	STRING	Название биржи для последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.insertion_order_id	STRING	Идентификатор заказа на размещение для последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.insertion_order_name	STRING	Название заказа на размещение для последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.line_item_id	STRING	Идентификатор позиции для последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.line_item_name	STRING	Название позиции для последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.partner_id	STRING	Идентификатор партнера DV360.
session_traffic_source_last_click. dv360_campaign.partner_name	STRING	Имя или название партнера DV360.
session_traffic_source_last_click. dv360_campaign.source	STRING	Определенный источник на платформе последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. dv360_campaign.medium	STRING	Канал последней кампании DV360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.account_id	STRING	Идентификатор аккаунта CM360.
session_traffic_source_last_click. cm360_campaign.account_name	STRING	Название аккаунта CM360.
session_traffic_source_last_click. cm360_campaign.advertiser_id	STRING	Идентификатор рекламодателя CM360.
session_traffic_source_last_click. cm360_campaign.advertiser_name	STRING	Имя или название рекламодателя CM360.
session_traffic_source_last_click. cm360_campaign.campaign_id	STRING	Идентификатор последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.campaign_name	STRING	Название последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.creative_id	STRING	Идентификатор креатива из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.creative_format	STRING	Формат креатива из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.creative_name	STRING	Название креатива из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.creative_type	STRING	Тип креатива из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.creative_type_id	STRING	Название типа креатива из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.creative_version	STRING	Версия креатива из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.placement_id	STRING	Идентификатор места размещения из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click.cm360 _campaign.placement_cost_structure	STRING	Структура оплаты места размещения из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.placement_name	STRING	Название места размещения из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.rendering_id	STRING	Идентификатор отображения из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.site_id	STRING	Идентификатор сайта из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.site_name	STRING	Название сайта из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.source	STRING	Определенный источник из последней кампании CM360, в которой зарегистрирован клик.
session_traffic_source_last_click. cm360_campaign.medium	STRING	Канал последней кампании CM360, в которой зарегистрирован клик.

traffic_source

Название поля	Тип данных	Описание
Запись traffic_source содержит информацию об источнике трафика, через который был впервые привлечен пользователь. Эта запись не заполняется в таблицах в течение дня. Примечание. Значения traffic_source не меняются, если пользователь после установки взаимодействует с последующими кампаниями.
traffic_source.name	STRING	Название кампании, благодаря которой был впервые привлечен пользователь. Это поле не заполняется в таблицах за день.
traffic_source.medium	STRING	Название канала, через который был впервые привлечен пользователь (например, поисковая реклама, обычный поиск или электронная почта). Это поле не заполняется в таблицах за день.
traffic_source.source	STRING	Название сети, через которую был впервые привлечен пользователь. Это поле не заполняется в таблицах за день.

stream и platform

Название поля	Тип данных	Описание
Поля stream и platform содержат информацию о потоке и платформе приложения.
stream_id	STRING	Числовой идентификатор потока данных, связанного с событием.
platform	STRING	Платформа потока данных (веб, iOS или Android), связанного с событием.

ecommerce

Название поля	Тип данных	Описание
Запись ecommerce содержит информацию о любых событиях электронной торговли, настроенных на сайте или в приложении.
ecommerce.total_item_quantity	INTEGER	Общее количество товаров в этом событии, представляющее собой сумму всех значений items.quantity.
ecommerce.purchase_revenue_in_usd	FLOAT	Доход от покупок в этом событии (в долларах США/условных единицах). Заполняется только для события purchase.
ecommerce.purchase_revenue	FLOAT	Доход от покупок в этом событии (в местной валюте/условных единицах). Заполняется только для события purchase.
ecommerce.refund_value_in_usd	FLOAT	Сумма возврата средств в этом событии (в долларах США/условных единицах). Заполняется только для события refund.
ecommerce.refund_value	FLOAT	Сумма возврата средств в этом событии (в местной валюте/условных единицах). Заполняется только для события refund.
ecommerce.shipping_value_in_usd	FLOAT	Стоимость доставки в этом событии (в долларах США/условных единицах).
ecommerce.shipping_value	FLOAT	Стоимость доставки в этом событии (в местной валюте).
ecommerce.tax_value_in_usd	FLOAT	Сумма налога в этом событии (в долларах США/условных единицах).
ecommerce.tax_value	FLOAT	Сумма налога в этом событии (в местной валюте/условных единицах).
ecommerce.transaction_id	STRING	Идентификатор транзакции электронной торговли.
ecommerce.unique_items	INTEGER	Количество уникальных товаров в этом событии на основе item_id (идентификатора товара), item_name (названия товара) и item_brand (бренда товара).

items

Название поля	Тип данных	Описание
Запись items содержит информацию о товарах, включенных в это событие. Повторяется для каждого товара.
items.item_id	STRING	Идентификатор товара.
items.item_name	STRING	Название товара.
items.item_brand	STRING	Бренд товара.
items.item_variant	STRING	Разновидность товара.
items.item_category	STRING	Категория товара.
items.item_category2	STRING	Подкатегория товара.
items.item_category3	STRING	Подкатегория товара.
items.item_category4	STRING	Подкатегория товара.
items.item_category5	STRING	Подкатегория товара.
items.price_in_usd	FLOAT	Цена товара (в долларах США/условных единицах).
items.price	FLOAT	Цена товара (в местной валюте).
items.quantity	INTEGER	Количество единиц товара. По умолчанию выбрано значение 1.
items.item_revenue_in_usd	FLOAT	Доход от этого товара, рассчитанный как price_in_usd * quantity (цена в долларах США, умноженная на количество). Заполняется только для событий purchase (в долларах США/условных единицах).
items.item_revenue	FLOAT	Доход от этого товара, рассчитанный как price * quantity (цена, умноженная на количество). Заполняется только для событий purchase (в местной валюте/условных единицах).
items.item_refund_in_usd	FLOAT	Сумма возврата средств для этого товара, рассчитанная как price_in_usd * quantity (цена в долларах США, умноженная на количество). Заполняется только для событий refund (в долларах США/условных единицах).
items.item_refund	FLOAT	Сумма возврата средств для этого товара, рассчитанная как price * quantity (цена, умноженная на количество). Заполняется только для событий refund (в местной валюте/условных единицах).
items.coupon	STRING	Код купона, примененный для этого товара.
items.affiliation	STRING	Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
items.location_id	STRING	Местоположение, связанное с товаром.
items.item_list_id	STRING	Идентификатор списка, в котором пользователь увидел товар.
items.item_list_name	STRING	Название списка, в котором пользователь увидел товар.
Items.item_list_index	STRING	Номер товара в списке.
items.promotion_id	STRING	Идентификатор промоакции товара.
items.promotion_name	STRING	Название промоакции товара.
items.creative_name	STRING	Название используемого объявления.
items.creative_slot	STRING	Название рекламного места.

Запись item_params

Название поля	Тип данных	Описание
С помощью записи item_params можно заданные вами параметры товара. Стандартные параметры товара, например item_id, item_name и т. д., сюда не входят, они экспортируются как явно заданные поля. В каждой реализации набор параметров, хранящийся в записи item_params, уникален. Подробную информацию о реализации электронной торговли и массиве товаров в Google Аналитике 4 вы найдете в статье о том, как отслеживать события электронной торговли.
items.item_params.key	STRING	Название параметра товара.
items.item_params.value	RECORD	Запись, содержащая значение параметра товара.
items.item_params.value.string_value	STRING	Если параметр выражен строкой, он указывается в этом поле.
items.item_params.value.int_value	INTEGER	Если параметр товара выражен целым числом, он указывается в этом поле.
items.item_params.value.double_value	FLOAT	Если параметр товара выражен числом двойной точности, он указывается в этом поле.
items.item_params.value.float_value	FLOAT	Если параметр товара выражен числом с плавающей запятой, он указывается в этом поле.

publisher (только ранний доступ)

Название поля	Тип данных	Описание
Запись publisher содержит информацию о событиях, полученную из интеграций для издателей, связанных с показом рекламы, например AdMob.
publisher	RECORD	Запись данных издателя, полученных из AdMob.
publisher.ad_revenue_in_usd	FLOAT	Расчетный доход от рекламы, полученный в событии (в долларах США). Заполняется только для событий показа объявлений.
publisher.ad_format	STRING	Описывает способ появления объявлений и то, где они показываются. Наиболее частые форматы: межстраничное объявление, баннер, объявление с вознаграждением, расширенное нативное объявление.
publisher.ad_source_name	STRING	Исходная сеть, в которой было показано объявление. Распространенные источники: сеть AdMob, Meta Audience Network, собственные объявления с медиацией.
publisher.ad_unit_id	STRING	Заданное вами название рекламного блока. Рекламные блоки – это контейнеры, которые размещаются в приложениях для показа рекламы.

Строки

Данные об отдельном событии могут быть представлены в одной или нескольких строках. Это зависит от того, есть ли повторяющиеся записи. Например, для события page_view с несколькими записями event_params может быть создана таблица, подобная приведенной ниже. Начальная строка содержит название события, дату, временную метку и другие неповторяющиеся данные. Запись event_params повторяется для каждого параметра, связанного с событием. Повторяющиеся записи указываются под начальной строкой события.

event_date	event_timestamp	event_name	event_params.key	event_params_value.string_value
20220222	1643673600483790	page_view	page_location	https://example.com
			page_title	Главная
			medium	переход
			source	google
			page_referrer	https://www.google.com
			<parameters...>	<values...>

В интерфейсе GA4 данные о событии отображаются, как показано ниже.

Важная информация об обновлении SDK до версии 17.2.5 или выше (Android) и/или 16.20.0 или выше (iOS)

Если вы используете старые версии SDK и собираетесь обновить их до версии 17.2.5 или выше для Android и/или 16.20.0 или выше для iOS, учтите следующее:

Чтобы использовать текущую схему BigQuery Export, необходимо обновить SDK до Android 17.2.5 (или более поздней версии) и/или iOS 16.20.0 (или более поздней версии). В более ранних версиях SDK для экспорта данных будет использоваться старая схема.
С момента обновления данные о товарах будут доступны только в рамках массива items, который может повторяться несколько раз. Данные об отдельных товарах больше не будут включаться в стандартные параметры событий, как в более ранних версиях SDK.
Благодаря этому изменению теперь можно проводить анализ по нескольким товарам одновременно.
В результате вам может быть необходимо исправить указатели данных о товарах.

Скрипт для переноса существующих наборов данных BigQuery на новую схему экспорта

Войдите в консоль Cloud Platform Console и откройте страницу "Управление ресурсами".
Перейдите к нужному проекту и нажмите Открыть Google Cloud Shell вверху страницы.

Когда откроется оболочка, скопируйте приведенный ниже скрипт в файл migration_script.sql.

Выполните команду cat > migration_script.sql.
Скопируйте в оболочку приведенный ниже скрипт.
Нажмите Ctrl + D, чтобы сохранить изменения и выйти.

Скрипт (migration_script.sql):

  SELECT
  @date AS event_date,
  event.timestamp_micros AS event_timestamp,
  event.previous_timestamp_micros AS event_previous_timestamp,
  event.name AS event_name,
  event.value_in_usd  AS event_value_in_usd,
   user_dim.bundle_info.bundle_sequence_id AS event_bundle_sequence_id,
  user_dim.bundle_info.server_timestamp_offset_micros as event_server_timestamp_offset,
  (
  SELECT
    ARRAY_AGG(STRUCT(event_param.key AS key,
        STRUCT(event_param.value.string_value AS string_value,
          event_param.value.int_value AS int_value,
          event_param.value.double_value AS double_value, 
          event_param.value.float_value AS float_value) AS value))
  FROM
    UNNEST(event.params) AS event_param) AS event_params,
  user_dim.first_open_timestamp_micros AS user_first_touch_timestamp,
  user_dim.user_id AS user_id,
  user_dim.app_info.app_instance_id AS user_pseudo_id,
  "" AS stream_id,
  user_dim.app_info.app_platform AS platform,
  STRUCT( user_dim.ltv_info.revenue AS revenue,
    user_dim.ltv_info.currency AS currency ) AS user_ltv,
  STRUCT( user_dim.traffic_source.user_acquired_campaign AS name,
      user_dim.traffic_source.user_acquired_medium AS medium,
      user_dim.traffic_source.user_acquired_source AS source ) AS traffic_source,
  STRUCT( user_dim.geo_info.continent AS continent,
    user_dim.geo_info.country AS country,
    user_dim.geo_info.region AS region,
    user_dim.geo_info.city AS city ) AS geo,
  STRUCT( user_dim.device_info.device_category AS category,
    user_dim.device_info.mobile_brand_name,
    user_dim.device_info.mobile_model_name,
    user_dim.device_info.mobile_marketing_name,
    user_dim.device_info.device_model AS mobile_os_hardware_model,
    @platform AS operating_system,
    user_dim.device_info.platform_version AS operating_system_version,
    user_dim.device_info.device_id AS vendor_id,
    user_dim.device_info.resettable_device_id AS advertising_id,
    user_dim.device_info.user_default_language AS language,
    user_dim.device_info.device_time_zone_offset_seconds AS time_zone_offset_seconds,
    IF(user_dim.device_info.limited_ad_tracking, "Yes", "No") AS is_limited_ad_tracking ) AS device,
  STRUCT( user_dim.app_info.app_id AS id,
    @firebase_app_id  AS firebase_app_id,
    user_dim.app_info.app_version AS version,
    user_dim.app_info.app_store AS install_source ) AS app_info,
  (
  SELECT
    ARRAY_AGG(STRUCT(user_property.key AS key,
        STRUCT(user_property.value.value.string_value AS string_value,
          user_property.value.value.int_value AS int_value,
          user_property.value.value.double_value AS double_value,
          user_property.value.value.float_value AS float_value,
          user_property.value.set_timestamp_usec AS set_timestamp_micros ) AS value))
  FROM
    UNNEST(user_dim.user_properties) AS user_property) AS user_properties
FROM
  `SCRIPT_GENERATED_TABLE_NAME`,
  UNNEST(event_dim) AS event

Откройте новую оболочку и скопируйте приведенный ниже скрипт в файл migration.sh.

Выполните команду cat > migration.sh.
Скопируйте в оболочку приведенный ниже скрипт.
Нажмите Ctrl + D, чтобы сохранить изменения и выйти.

Добавьте в приведенный ниже скрипт свой идентификатор ресурса Аналитики, идентификатор проекта BigQuery, идентификатор приложения в Firebase и название набора данных BigQuery, а также укажите даты начала и окончания для нужных данных.

Скрипт (migration.sh)

# Идентификатор ресурса Аналитики для проекта. Найдите его в настройках Google Аналитики на платформе Firebase.
PROPERTY_ID=ваш идентификатор ресурса Аналитики

# Проект BigQuery Export.
BQ_PROJECT_ID="ваш идентификатор проекта BigQuery" (например, "firebase-public-project")

# Идентификатор вашего приложения в Firebase.
FIREBASE_APP_ID="идентификатор вашего приложения в Firebase" (например, "1:300830567303:ios:09b1ab1d3ca29bda")

# Набор данных, из которого выполняется импорт.
BQ_DATASET="название набора данных BigQuery, из которого выполняется импорт" (например, "com_firebase_demo_IOS")

# Платформа
PLATFORM="платформа приложения – ANDROID или IOS"

# Диапазон дат, данные за которые необходимо перенести, включая [START_DATE,END_DATE].
START_DATE=20180324
END_DATE=20180327

# Изменять приведенный ниже скрипт не рекомендуется.
startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1

# Выполните итерации для заданных дат.
DATE="$startdate"
while [ "$DATE" -le "$enddate" ]; do

        # Таблица BigQuery на основе приведенных выше параметров.
        BQ_TABLE="$BQ_PROJECT_ID.$BQ_DATASET.app_events_$DATE"

        echo "Migrating $BQ_TABLE"

        cat migration_script.sql | sed -e "s/SCRIPT_GENERATED_TABLE_NAME/$BQ_TABLE/g" | bq query \
        --debug_mode \
        --allow_large_results \
        --noflatten_results \
        --use_legacy_sql=False \
        --destination_table analytics_$PROPERTY_ID.events_$DATE \
        --batch \
        --append_table \
        --parameter=firebase_app_id::$FIREBASE_APP_ID \
        --parameter=date::$DATE \
        --parameter=platform::$PLATFORM \
        --project_id=$BQ_PROJECT_ID


        temp=$(date -I -d "$DATE + 1 day")
        DATE=$(date -d "$temp" +%Y%m%d)

done
exit

# ОКОНЧАНИЕ СКРИПТА

Откройте новую оболочку и выполните команду bash migration.sh.

Старая схема экспорта

user_dim

Название поля	Тип данных	Описание
user_dim	RECORD	Запись с пользовательскими параметрами.
user_dim.user_id	STRING	Идентификатор пользователя, заданный с помощью метода API setUserId().
user_dim.first_open_timestamp_micros	INTEGER	Время в микросекундах, когда пользователь впервые запустил приложение.
user_dim.user_properties	RECORD	Пользовательские параметры, заданные с помощью метода API setUserProperties() (запись может повторяться несколько раз).
user_dim.user_properties.key	STRING	Название свойства пользователя.
user_dim.user_properties.value	RECORD	Запись с информацией о свойстве пользователя.
user_dim.user_properties.value.value	RECORD	Запись со значением свойства пользователя.
user_dim.user_properties.value.value.string_value	STRING	Значение свойства пользователя в виде строки.
user_dim.user_properties.value.value.int_value	INTEGER	Значение свойства пользователя в виде целого числа.
user_dim.user_properties.value.value.double_value	FLOAT	Значение свойства пользователя в виде числа двойной точности.
user_dim.user_properties.value.set_timestamp_usec	INTEGER	Время последнего изменения свойства пользователя (в микросекундах).
user_dim.user_properties.value.index	INTEGER	Индекс свойства пользователя (от 0 до 24).
user_dim.device_info	RECORD	Запись с информацией об устройстве.
user_dim.device_info.device_category	STRING	Тип устройства (смартфон, планшет или компьютер).
user_dim.device_info.mobile_brand_name	STRING	Бренд устройства.
user_dim.device_info.mobile_model_name	STRING	Название модели устройства.
user_dim.device_info.mobile_marketing_name	STRING	Торговое название устройства.
user_dim.device_info.device_model	STRING	Модель устройства.
user_dim.device_info.platform_version	STRING	Версия операционной системы.
user_dim.device_info.device_id	STRING	Идентификатор IDFV (только если нет идентификатора IDFA).
user_dim.device_info.resettable_device_id	STRING	Рекламный идентификатор или IDFA.
user_dim.device_info.user_default_language	STRING	Язык операционной системы.
user_dim.device_info.device_time_zone_offset_seconds	INTEGER	Смещение времени относительно GMT (в секундах).
user_dim.device_info.limited_ad_tracking	BOOLEAN	Включено ли ограничение отслеживания объявлений.
user_dim.geo_info	RECORD	Запись с геоданными пользователя.
user_dim.geo_info.continent	STRING	Континент, где были зарегистрированы события. Определяется по IP-адресу.
user_dim.geo_info.country	STRING	Страна, где были зарегистрированы события. Определяется по IP-адресу.
user_dim.geo_info.region	STRING	Регион, где были зарегистрированы события. Определяется по IP-адресу.
user_dim.geo_info.city	STRING	Город, где были зарегистрированы события. Определяется по IP-адресу.
user_dim.app_info	RECORD	Запись с информацией о приложении.
user_dim.app_info.app_version	STRING	Параметр versionName (для устройств Android) или краткая версия пакета.
user_dim.app_info.app_instance_id	STRING	Уникальный идентификатор этого экземпляра приложения.
user_dim.app_info.app_store	STRING	Интернет-магазин, из которого было установлено приложение.
user_dim.app_info.app_platform	STRING	Платформа, на которой запущено приложение.
user_dim.traffic_source	RECORD	Название источника трафика. Это поле не заполняется в таблицах за день.
user_dim.traffic_source.user_acquired_campaign	STRING	Название маркетинговой кампании, которая привлекла пользователя. Это поле не заполняется в таблицах за день.
user_dim.traffic_source.user_acquired_medium	STRING	Название канала, который привлек пользователя (например, поисковая реклама, обычный поиск или сообщение по электронной почте). Это поле не заполняется в таблицах за день.
user_dim.traffic_source.user_acquired_source	STRING	Название сети, которая привлекла пользователя. Это поле не заполняется в таблицах за день.
user_dim.bundle_info	RECORD	Запись с информацией о пакете, в котором были загружены события.
user_dim.bundle_info.bundle_sequence_id	INTEGER	Порядковый идентификатор пакета, в котором были загружены события.
user_dim.ltv_info	RECORD	Запись с информацией об общей ценности этого пользователя. Это поле не заполняется в таблицах за день.
user_dim.ltv_info.revenue	FLOAT	Показатель "Общая ценность" (доход). Это поле не заполняется в таблицах за день.
user_dim.ltv_info.currency	STRING	Показатель "Общая ценность" (валюта). Это поле не заполняется в таблицах за день.

event_dim

Название поля	Тип данных	Описание
event_dim	RECORD	Информация о событиях в этом пакете (запись может повторяться несколько раз).
event_dim.date	STRING	Дата, когда было зарегистрировано событие (в формате ГГГГММДД, часовой пояс приложения).
event_dim.name	STRING	Название события.
event_dim.params	RECORD	Параметры события (запись может повторяться несколько раз).
event_dim.params.key	STRING	Ключ параметра события.
event_dim.params.value	RECORD	Запись со значением параметра события.
event_dim.params.value.string_value	STRING	Значение параметра события в виде строки.
event_dim.params.value.int_value	INTEGER	Значение параметра события в виде целого числа.
event_dim.params.value.double_value	FLOAT	Значение параметра события в виде числа двойной точности.
event_dim.timestamp_micros	INTEGER	Момент времени, в который событие было зарегистрировано в клиенте (в микросекундах, UTC).
event_dim.previous_timestamp_micros	INTEGER	Момент времени, в который событие было зарегистрировано в клиенте (в микросекундах, UTC).

Эта информация оказалась полезной?

Как можно улучшить эту статью?

[GA4] Схема BigQuery Export

Наборы данных

Таблицы

Столбцы

Запись event_params

Запись item_params

Поля privacy_info

Запись user_properties

Запись user_ltv

geo

Запись item_params

Строки

user_dim

event_dim

Эта информация оказалась полезной?

Требуется помощь?

Попробуйте следующее: