[GA4] Імпорт офлайн-подій

Про дані офлайн-подій

Ви можете імпортувати офлайн-події з джерел, які не мають інтернет-з’єднання або з інших причин не підтримують передавання даних у реальному часі через пакети SDK чи Measurement Protocol. Після завантаження ці події обробляються так, ніби були отримані за допомогою наших пакетів SDK. Якщо ви вкажете позначку часу, то використовуватиметься зазначений час, а якщо ні – час завантаження.

Можна імпортувати події, що відповідають тим, які автоматично збирає Analytics або які ми рекомендуємо для різних галузей, а також будь-які правильно вказані спеціальні події, параметри чи властивості користувача. Докладніше

Щоб вилучити ці дані, потрібно надіслати запит на видалення даних або видалити користувача.

Як імпортувати дані про офлайн-події

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

Як створити спеціальні параметри

Якщо в Analytics немає параметрів, дані яких ви збираєтесь імпортувати, їх потрібно попередньо створити, щоб дані були доступні у звітах. Докладніше

Коли ви створите спеціальні параметри, Analytics упродовж 4 годин розпізнає імпортовані дані. Щоб перевірити, чи обробляються спеціальні параметри, відкрийте огляд і подивіться, чи доступні вони в засобі вибору параметрів.

Як створити файл CSV

Створіть файл CSV з даними ваших подій, використовуючи цей шаблон як зразок.

Завантаження даних

Загальну процедуру імпортування даних описано в цій статті.

Створюючи джерело даних, виберіть Дані офлайн-події.

Імпортовані офлайн-події автоматично порівнюються з потрібними полями в Analytics.

Після завантаження даних може минути до 24 годин, перш ніж Analytics почне показувати їх у звітах, аудиторіях і дослідженнях.

Якщо ви видалите джерело даних зі служби завантаження даних, збережені значення не видаляться. Щоб вилучити завантажені через імпортування дані, можливо, доведеться надіслати запит на їх видалення (як і у випадку всіх інших методів збирання даних).

Відомості про джерело даних

Умовні позначення

Область Подія
Обов’язкові поля

[одне зі значень] 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 для даних про подію, за допомогою якого можна вручну створювати файли для завантаження.

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
G-12345ABCDE 1234567890.0987654321 1000001 1609488000000000 надано відхилено page_view /home referrer.com Головна сторінка 1600 x 900 синій 1–2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 відхилено відхилено page_view /video_detail   Засіб перегляду відео 1600 x 900 синій 1–4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 відхилено надано video_play /video_detail   Засіб перегляду відео 1600 x 900 синій                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 відхилено надано page_view /home referrer.com Головна сторінка 2560 x 1440 зелений 2–2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 відхилено надано page_view /product_detail   Додаткові відомості про товар 2560 x 1440 зелений 2–16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 надано надано page_view /product_detail   Додаткові відомості про товар 2560 x 1440 зелений                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 надано надано page_view /camp_lp_1 referrer.com Літній розпродаж 2560 x 1440 синій 3–1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 надано відхилено view_item_list /camp_lp_1   Літній розпродаж 2560 x 1440 синій   123абв red_shoe взуття list_123 colorful_shoes 1 1   234бвг blue_shoe 1 30,00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 надано надано select_item /camp_lp_1   Літній розпродаж 2560 x 1440 синій   234бвг blue_shoe взуття list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 надано надано page_view /product_detail   Додаткові відомості про товар 2560 x 1440 синій 3–5 234бвг blue_shoe взуття list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 відхилено надано view_item /product_detail   Додаткові відомості про товар 2560 x 1440 синій 3–17 234бвг blue_shoe взуття list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 відхилено відхилено add_to_cart /product_detail   Додаткові відомості про товар 2560 x 1440 синій   234бвг blue_shoe взуття list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 надано відхилено begin_checkout /product_detail   Додаткові відомості про товар 2560 x 1440 синій   234бвг blue_shoe взуття list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 надано відхилено page_view /purchase_confirmation   Вітаємо! 2560 x 1440 синій 3–21 234бвг blue_shoe взуття list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 надано відхилено purchase /purchase_confirmation   Вітаємо! 2560 x 1440 фіолетовий 3–21 234бвг blue_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 джерел для даних про офлайн-події.

Чи корисна ця інформація?

Як можна її покращити?
Пошук
Очистити пошук
Закрити пошук
Головне меню
1647488481305256495
true
Пошук у довідковому центрі
true
true
true
true
true
69256
false
false