[GA4] Как импортировать данные об офлайн-событиях

Какие данные можно импортировать

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

Вы можете импортировать события, соответствующие тем, которые Google Аналитика собирает автоматически или которые мы рекомендуем использовать для тех или иных тематик сайтов, а также корректно сформированные специальные события, параметры и свойства пользователя. Подробнее…

Если эти события вам не нужны, вы можете запросить удаление данных или свойств пользователя.

Как импортировать данные об офлайн-событиях

Создайте CSV-файл, соответствующий схеме событий в Аналитике. Ниже приведены шаблоны такого файла.

Создание специальных параметров

Если вы импортируете данные для параметров, которых нет в Аналитике, и хотите просматривать отчеты по ним, то такие параметры сначала необходимо создать. Подробнее…

Загруженные данные начнут распознаваться через 4 часа после создания специальных параметров. Чтобы убедиться, что специальные параметры обрабатываются, откройте исследование и проверьте, доступны ли параметры в окне их выбора.

Создание CSV-файла

Создайте CSV-файл с данными событий, используя этот шаблон как образец.

Загрузка данных

Стандартная процедура загрузки описана в статье Импорт данных.

При создании источника данных выберите Данные об офлайн-событиях.

Импортируемые офлайн-события автоматически сопоставляются с нужными полями в Аналитике.

Данные появятся в отчетах, аудиториях и исследованиях в течение 24 часов с момента загрузки.

При удалении источника данных из службы загрузки вся поступившая из него информация сохраняется. Чтобы удалить импортированные данные, вам, возможно, потребуется отправить запрос на их удаление, как и при других способах сбора данных.

Сведения об источнике данных

Обозначения

Область действия Событие
Обязательные поля

client_id или app_instance_id (любое из этих полей)

tag_id или firebase_app_id (любое из этих полей)

tag_id и client_id или firebase_app_id и app_instance_id (первые два или последние два)

event_name

Импортируемые данные

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

  • timestamp_micros (необязательно; временная метка должна находиться в пределах 72 часов с момента регистрации события; при отсутствии этого значения используется время загрузки)
  • user_id (необязательно, но рекомендуется использовать, если доступно);
  • сигналы о согласии (необязательно, но настоятельно рекомендуется использовать, если доступно);
  • event_param.<xxxxx> (импорт параметров с любым названием);
  • user_property.<yyyyy> (импорт свойства пользователя с любым названием)
  • item<x>.<item_param> (например, item2.item_name)
Примечание При импорте данных об офлайн-событиях запрещается загружать информацию, позволяющую идентифицировать личность. Подробнее…

 

Шаблон CSV-файла

Ниже приведен пример CSV-шаблона для данных о событии, который вы можете использовать при создании файлов для загрузки вручную.

measurement_id client_id user_id timestamp_micros ad_personalization ad_user_data event_name event_param.page_location event_param.page_referrer event_param.page_title event_param.screen_resolution user_property.color_score event_param.foo item1.item_id item1.item_name item1.category item1.item_list_id item1.item_list_name item1.index item1.quantity item1.price item2.item_id item2.item_name item2.quantity item2.price event_param.transaction_id event_param.value event_param.tax event_param.shipping event_param.currency
ignored12345ABCDE 1234567890.0987654321 1000001 1609488000000000 GRANTED DENIED page_view /home referrer.com Главная страница 1600 x 900 синий 1-2                                  
ignored12345ABCDE 1234567890.0987654321 1000001 1609488060000000 DENIED DENIED page_view /video_detail   Просмотр видео 1600 x 900 синий 1-4                                  
ignored12345ABCDE 1234567890.0987654321 1000001 1609488120000000 DENIED GRANTED video_play /video_detail   Просмотр видео 1600 x 900 синий                                    
ignored67890ABCDE 2345678901.9876543210 1000002 1609574400000000 DENIED GRANTED page_view /home referrer.com Главная страница 2560 x 1440 зеленый 2-2                                  
ignored67890ABCDE 2345678901.9876543210 1000002 1609574460000000 DENIED GRANTED page_view /product_detail   Страница товара 2560 x 1440 зеленый 2-16                                  
ignored67890ABCDE 2345678901.9876543210 1000002 1609574520000000 GRANTED GRANTED page_view /product_detail   Страница товара 2560 x 1440 зеленый                                    
ignored67890ABCDE 121212.3434 1000003 1609574520000000 GRANTED GRANTED page_view /camp_lp_1 referrer.com Летняя распродажа! 2560 x 1440 синий 3-1                                  
ignored67890ABCDE 121212.3434 1000003 1609660801000000 GRANTED DENIED view_item_list /camp_lp_1   Летняя распродажа! 2560 x 1440 синий   123abc red_shoe shoe list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30.00          
ignored67890ABCDE 121212.3434 1000003 1609660860000000 GRANTED GRANTED select_item /camp_lp_1   Летняя распродажа! 2560 x 1440 синий   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
ignored67890ABCDE 121212.3434 1000003 1609660870000000 GRANTED GRANTED page_view /product_detail   Страница товара 2560 x 1440 синий 3-5 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
ignored67890ABCDE 121212.3434 1000003 1609660930000000 DENIED GRANTED view_item /product_detail   Страница товара 2560 x 1440 синий 3-17 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
ignored67890ABCDE 121212.3434 1000003 1609660950000000 DENIED DENIED add_to_cart /product_detail   Страница товара 2560 x 1440 синий   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
ignored67890ABCDE 121212.3434 1000003 1609660970000000 GRANTED DENIED begin_checkout /product_detail   Страница товара 2560 x 1440 синий   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
ignored67890ABCDE 121212.3434 1000003 1609660975000000 GRANTED DENIED page_view /purchase_confirmation   Поздравляем! 2560 x 1440 синий 3-21 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
ignored67890ABCDE 121212.3434 1000003 1609660980000000 GRANTED DENIED purchase /purchase_confirmation   Поздравляем! 2560 x 1440 фиолетовый 3-21 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00         t12345 37.49 2.50 4.99 USD

 

 

Ограничения

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

Параметры объекта-события (например, item_list_name), для которых не указаны значения, будут отклонены. Эти параметры поддерживаются для рекомендуемых событий (например, для таких категорий, как "Электронная торговля", "Вакансии" и "Путешествия").

События и параметры должны соответствовать следующим правилам:

  • Одно событие может содержать не больше 25 параметров.
  • Одно событие может содержать не больше 25 свойств пользователей.
  • Название свойства пользователя может содержать не больше 24 символов.
  • Значение свойства пользователя может содержать не больше 36 символов.
  • Название события может содержать не больше 40 символов (буквы, цифры, знаки подчеркивания) и должно начинаться с буквы.
  • Название параметра может содержать не больше 40 символов (буквы, цифры, знаки подчеркивания) и должно начинаться с буквы. Это касается и параметров объектов.
  • Значение параметра может содержать не больше 100 символов. Это касается и параметров объектов.

Лимит на импорт данных об офлайн-событиях

Всего можно создать не более 10 источников для данных об офлайн-событиях.

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

Как можно улучшить эту статью?
Поиск
Очистить поле поиска
Закрыть поиск
Приложения Google
Главное меню
12063900263172125509
true
Поиск по Справочному центру
true
true
true
true
true
69256
false
false