Огляд оновлення Google Ads API v24

Компанія Google оголосила про офіційний випуск Google Ads API v24. Дане оновлення впроваджує розширений функціонал для аналітики продажів, оптимізує роботу з відеоконтентом та вносить корективи в архітектуру окремих сервісів. Для отримання доступу до нових можливостей розробникам необхідно оновити клієнтські бібліотеки та адаптувати існуючий програмний код.

Конверсії з даними про кошик

Найвагомішим доповненням версії v24 є розширена підтримка Conversions with Cart Data. Цей інструмент дозволяє деталізувати звіти про конверсії, додаючи інформацію про конкретні товари у кожній транзакції.

• Ресурс CartDataSalesView: Надає можливість сегментувати метрики конверсій за характеристиками проданих товарів (наприклад, за брендом — product_sold_brand).
• Нові метрики: Впроваджено групу показників «all» (non-biddable), таких як all_cost_of_goods_sold_micros. Вони відображають дані навіть по тих конверсіях, які не використовуються для активної оптимізації стратегій призначення ставок.
• Сегментація ShoppingPerformanceView: Додано поле conversion_attribution_event_type, що дозволяє розрізняти конверсії, отримані внаслідок кліків або переглядів.

Оновлення та структурні зміни сервісів

У версії v24 було проведено рефакторинг декількох ключових служб для підвищення ефективності їхньої роботи:

Налаштування відеоконтенту

• Виключення контенту: Налаштування виключення певних типів відеоконтенту тепер застосовуються на рівні клієнта (customer level), а не окремих кампаній. Це спрощує глобальне керування безпекою бренду.
• Video Responsive Ad: Об’єкт VideoResponsiveAdInfo став доступним для редагування (mutable). Поля «відео», «назва компанії» та «логотипи» тепер є обов’язковими.

Робота з аудиторіями та охопленням

• AudienceInsightsService: Поле InsightsAudience.topic_audience_combinations перенесено до загального простору імен (common namespace), що потребує оновлення імпортів у коді.
• ReachPlanService: Поле youtube_select_lineups замінено на youtube_select_lineup_targeting для роботи з преміальним інвентарем YouTube Select.
• ContentCreatorInsightsService: Вилучено поле is_brand_connect_creator. Для ідентифікації партнерств із креаторами слід використовувати параметр CREATOR_PARTNERSHIPS у полі partnership_opportunities.

Планування та прогнозування

• KeywordPlanIdeaService: Впроваджено метод GenerateKeywordForecastMetrics, який оптимізує процес прогнозування, фокусуючись на ключових показниках ефективності.

Зміни у звітності та обмеження

З метою приведення API у відповідність до актуальних продуктових змін, було внесено такі корективи:

• Бюджет кампаній: Вилучено сегмент ad_sub_network_type через технічну несумісність.
• Об’єкти (Assets): Сегмент click_type видалено з представлень ad_group_asset, campaign_asset та customer_asset. Для аналізу типів кліків рекомендовано використовувати ad_group_ad.
• ShareablePreviewService: Метод GenerateShareablePreviews більше не підтримує часткові помилки (partial failures). Якщо хоча б один ідентифікатор у запиті є некоректним, система поверне помилку для всього запиту.

Рекомендації для розробників

Для забезпечення безперебійної роботи рекламних інструментів та використання нових аналітичних можливостей, рекомендується:

1. Ознайомитися з повною документацією (Release Notes та Upgrade Guide).
2. Завантажити актуальні версії клієнтських бібліотек.
3. Перевірити код на наявність застарілих полів, згаданих у звіті про відмінності (v23 vs v24 diff).
4. Переглянути запис live-трансляції від 23 квітня для отримання практичних порад щодо міграції.

Технічна підтримка доступна на офіційній сторінці розробників Google Ads API.

Рекомендації щодо впровадження та дедлайни

Для забезпечення стабільності бізнес-процесів рекомендується дотримуватися наступного плану міграції:

1. Аудит існуючої звітності: У зв’язку з вилученням сегмента click_type із рівнів Assets, необхідно терміново переналаштувати внутрішні CRM-системи та дашборди у Looker Studio, які використовували ці дані, переорієнтувавши їх на рівень ad_group_ad.
2. Перевірка технічної розмітки: Використання переваг CartDataSalesView вимагає коректної передачі даних про кошик із боку вебсайту. Рекомендується провести технічний аудит налаштувань Google Tag Manager для забезпечення синхронізації з новими методами API.
3. Терміни оновлення: З огляду на стандартний життєвий цикл версій Google Ads API, розробникам та технічним спеціалістам варто завершити перехід на версію v24 протягом поточного кварталу, щоб уникнути ризиків, пов’язаних із припиненням підтримки попередніх ітерацій.

Професійна підтримка та консалтинг

Впровадження оновлень Google Ads API v24 потребує не лише технічної корекції коду, а й глибокої експертизи в налаштуванні наскрізної аналітики. Наша команда спеціалістів UAMASTER готова забезпечити повний супровід вашого бізнесу під час переходу на нові стандарти звітності:

• Комплексний аудит аналітики: Ми допоможемо перевірити коректність передачі даних про кошик через Google Tag Manager, що є критично важливим для активації нових функцій звітності за продажами та брендом.
• Оптимізація стратегій за прибутковістю (CRO): Наші фахівці допоможуть інтегрувати нові метрики собівартості у ваші дашборди, трансформуючи звіти з показників «кліків та лідів» у конкретні дані про чистий прибуток і маржинальність.
• Адаптація рекламних кампаній: Ми забезпечимо перевірку та оновлення ваших Demand Gen та відеокампаній відповідно до нових вимог Google, гарантуючи безперебійну роботу всіх активів.
• Налаштування кастомних звітів: Якщо ваші внутрішні системи звітності або дашборди у Looker Studio постраждали через зміну структур сегментації (наприклад, видалення click_type), ми оперативно проведемо їх реконфігурацію для збереження безперервності даних.

Зв’яжіться з нами для отримання консультації, щоб перетворити технічні оновлення API на стратегічну перевагу для вашого маркетингу.

Читайте статтю англійською мовою.

Google Ads API v24 release