Skip to content
RiverCore
Google Analytics API Нарешті Відкриває Дані про Конверсії для Розробників
Google Analytics APIConversionSpecGA Data APIGoogle Analytics API conversion data 2026programmatic conversion reporting GA4

Google Analytics API Нарешті Відкриває Дані про Конверсії для Розробників

5 тра 20267 хв. читанняSarah Chen

Google випустив те, що, мабуть, є найважливішою зміною Analytics API у 2026 році, — і це сталося без жодного прес-релізу. 4 травня 2026 року Google відкрив дані крос-канальних конверсій через Google Analytics Data API, вперше зробивши звіт про ефективність конверсій доступним програмно. Сама «начинка» — нове поле ConversionSpec у RunReportRequest — була тихо додана до v1 alpha одинадцятьма днями раніше, 23 квітня.

Це четверта аналітична поверхня, яку Google випустив або розширив лише у 2026 році: після трьох одночасних бет у січні, згенерованих інсайтів у лютому та Task Assistant у квітні. Чотири релізи приблизно за чотири місяці — всі без офіційних оголошень — це темп, який важливий для всіх, хто обслуговує атрибуційні пайплайни.

Що відбулося

Головний факт: розробники тепер можуть викликати runReport із ConversionSpec і отримувати ті самі дані, які раніше існували виключно в інтерфейсі Google Analytics у розділі Реклама > Ефективність конверсій. До цього оновлення той звіт не мав програмного еквівалента. Команди, що будують кастомні дашборди, пайплайни до сховища даних або BI-інтеграції, не мали підтримуваного способу витягувати дані про ефективність конверсій — як задокументував PPC Land у своєму огляді журналу змін. Обхідним шляхом був ручний експорт з інтерфейсу — саме такий крок, який ламається при масштабуванні.

Реліз стосується як клієнтів Google Analytics, так і Google Ads, але функція залишається в alpha і не є широкодоступною. Останній момент важливий, адже alpha у Google історично означав нестабільні контракти та мовчазні збої, тому будь-яка виробнича залежність від цієї поверхні є передчасною.

Контекст щодо термінів: у січні 2026 року Google одночасно запустив три бета-функції — крос-канальне бюджетування, покращене управління веб-конверсіями для клієнтів Ads та звіт аналізу атрибуції конверсій. Реліз 16 січня також запровадив налаштування атрибуції для окремих конверсій, замінивши попередню модель на рівні ресурсу, де один вибір атрибуції застосовувався до кожної події конверсії у ресурсі. 10 лютого на головну сторінку Analytics були додані згенеровані інсайти, що підсумовують три найбільші зміни в даних після останнього відвідування користувача — оновлення конфігурації, аномалії та сезонність. 29 квітня було представлено Task Assistant — інструмент покрокового налаштування в лівій навігації, який організує завдання ресурсу: підключення акаунтів і виправлення проблем із даними. Реліз API завершує цикл: інтерфейс став розумнішим, і тепер дані нарешті доступні для запитів.

Технічна анатомія

Журнал змін документує три конкретні доповнення. По-перше, нове поле ConversionSpec у RunReportRequest приймає два параметри. conversionActions приймає ID конверсійних дій як фільтр, а AttributionModel — одне з двох значень enum: DATA_DRIVEN або LAST_CLICK. Дві моделі, і не більше. Це навмисне звуження.

По-друге, поле Section додано до ResponseMetaData — воно визначає, чи повернутий payload надходить із SECTION_REPORT (стандартна звітність) або SECTION_ADVERTISING (поверхня звітності конверсій). По-третє, метод getMetadata у v1 alpha тепер повертає метадані, специфічні для конверсій, включаючи поле conversions, яке зіставляє ID конверсійних дій із відображуваними назвами через список об'єктів ConversionMetadata. Поле sections також було додано до DimensionMetadata та MetricMetadata, що явно повідомляє викликаючим, чи є конкретний вимір або метрика допустимими у стандартній звітності, звітності конверсій або в обох.

Саме на цей останній деталь інженери мають звернути увагу. Не кожен вимір і метрика, що працюють у стандартному звіті, будуть працювати у звітах конверсій, і ендпоінт метаданих тепер документує ці межі. Без цього поля ви б виявляли межі, написавши запити, що повертають помилки.

Сам вибір моделі атрибуції є цікавим. Google почав виводити з ужитку кілька моделей атрибуції на основі правил починаючи з 2024 року, підштовхуючи екосистему до атрибуції на основі даних. Збереження LAST_CLICK як допустимого значення тут, попри ширшу дугу виведення з ужитку, сигналізує: Google розглядає last-click як базову лінію для крос-платформного узгодження, а не як рекомендовану основну модель. Джерело не розкриває, чи будуть додані додаткові моделі пізніше — це важливо, адже якщо enum залишиться з двома значеннями протягом усього alpha, вендори, що будують інструменти узгодження проти, наприклад, Meta's Conversions API, матимуть вужчу порівняльну поверхню, ніж хотілося б. Обмеження сьогодні — дві моделі, без публічних зобов'язань щодо дорожньої карти поза цим.

Сам звіт про ефективність конверсій підтримує два часові виміри — час конверсії та час взаємодії, а метрика «Всі конверсії» охоплює як основні, так і вторинні конверсійні дії. Звіт враховує як налаштування ресурсу Google Analytics, так і налаштування акаунту Google Ads. Чи відкриває API кожен із цих перемикачів на паритеті з інтерфейсом — це те, що розробники матимуть перевіряти вручну проти alpha. Якщо мені довелось би прогнозувати, я б очікував, що принаймні один паритетний розрив виявиться протягом 60 днів після ширшого розгортання.

Хто постраждає

Найбільш постраждалі команди — ті, що побудували пайплайни «експорт-і-склейка», бо інтерфейс був єдиним джерелом правди. Групи аналітики performance-маркетингу всередині iGaming-операторів, команди залучення клієнтів у фінтех та криптовалютні біржі, що масштабно запускають платний трафік, — всі вони так чи інакше робили щось на кшталт «зайти в інтерфейс, експортувати CSV, завантажити у сховище, об'єднати в dbt». Цей робочий процес тепер має підтримувану заміну, а отже, внутрішній інструментарій, побудований навколо нього, швидко знецінюється.

Вендори — цікавіша категорія. Атрибуційні платформи та компанії з моделювання маркетинг-міксу, що стягують плату за «витягування даних конверсій GA» як функцію, тепер мають менший захисний рів. Якщо інженерна команда клієнта може безпосередньо викликати runReport із ConversionSpec і отримати еквівалентні дані, цінність вендора-посередника звужується до будь-якого трансформаційного, змішувального або візуалізаційного шару зверху. Одні вендори залишаться в порядку, бо їхня цінність — у моделюванні. Інші встановили ціни виходячи з проблеми доступу, а цю проблему тепер вирішує сама платформа.

Команди Ads, що скаржилися на розбіжності у звітах між Google Ads і Google Analytics, також отримали новий інструмент. З налаштуваннями атрибуції для окремих конверсій (активними з 16 січня) і тепер програмним доступом до даних конверсій як для DATA_DRIVEN, так і для LAST_CLICK в єдиному пайплайні, діагностичний цикл для «чому Ads показує X, а Analytics — Y» стає значно коротшим. Ми ще не знаємо, як часто дві моделі розходитимуться на практиці для конкретного ресурсу, але межу тепер можна перевірити: витягнути обидві, порівняти, автоматизувати сповіщення.

Якщо все розгорнеться так, як я очікую, тиск на ціноутворення вендорів у функціях витягування GA-конверсій має стати помітним до Q3 2026, і принаймні один великий атрибуційний вендор перепозиціонує месседжинг — від «ми підключаємось до GA» до глибини моделювання — до кінця року.

План дій для Performance-маркетингу

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

По-друге, використовуйте поле метаданих sections для вимірів і метрик як жорсткий валідатор. Не припускайте паритет зі стандартною звітністю. Напишіть скрипт виявлення, що викликає getMetadata і генерує матрицю сумісності для вашого конкретного use case. Це заощадить тижні налагодження, коли запит повертає порожні результати через те, що вимір позначений тільки для SECTION_REPORT.

По-третє, витягуйте як DATA_DRIVEN, так і LAST_CLICK в одному завданні. Вартість — один додатковий API-виклик. Цінність — постійна лінза узгодження між Analytics і ширшою екосистемою Ads API, де last-click досі є поширеною крос-платформною базовою лінією. Зберігайте знімок обох варіантів, зберігайте обидва, дайте BI-шару вирішувати, який показувати якому стейкхолдеру.

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

Ключові висновки

  • Alpha, не GA: ConversionSpec перебуває у v1 alpha станом на 23 квітня 2026 року. Будуйте паралельні пайплайни, не переводьте виробниче середовище поки що.
  • Дві моделі атрибуції — і крапка: відкриті лише DATA_DRIVEN та LAST_CLICK. Межа крос-модельного порівняння наразі — два варіанти.
  • Розробка з пріоритетом метаданих: використовуйте нове поле sections у DimensionMetadata та MetricMetadata для перевірки сумісності перед написанням звітних запитів.
  • Стиснення захисного рову вендорів: вендори, для яких витягування даних є ключовою функцією, втрачають цінову силу. Вендори з моделюванням і змішуванням захищені.
  • Стежте за паритетними розривами: джерело не підтверджує повний паритет функцій інтерфейс-API. Очікуйте принаймні одного розриву протягом 60 днів після ширшого розгортання.

Часті запитання

П: Що насправді робить нове поле ConversionSpec у Google Analytics Data API?

ConversionSpec — це поле, додане до об'єкта RunReportRequest, яке дозволяє розробникам фільтрувати звітні запити за конкретними конверсійними діями та моделлю атрибуції. Воно приймає ID конверсійних дій для параметра conversionActions та DATA_DRIVEN або LAST_CLICK для параметра AttributionModel, повертаючи дані, еквівалентні звіту про ефективність конверсій в інтерфейсі Analytics.

П: Чи готовий API звітності конверсій Google Analytics до використання у виробництві?

Ні. Функція була додана до каналу v1 alpha 23 квітня 2026 року та оголошена 4 травня 2026 року, і станом на ту дату залишається в alpha. Alpha-ендпоінти у Google можуть змінюватися без попередження, тому виробничим командам слід запускати їх паралельно з наявними потоками звітності, а не переходити повністю.

П: Чому Google відкрив лише дві моделі атрибуції в API?

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

SC
Sarah Chen
RiverCore Analyst · Dublin, Ireland
ПОДІЛИТИСЯ
// RELATED ARTICLES
ГоловнаРішенняПроєктиПро насКонтакт
Новини06
Дублін, Ірландія · ЄСGMT+1
LinkedIn
🇺🇦UK