Експертні статті про SEOКонтактиRSShello@linksgauge.com

Google

Data Manager API версії 1.9 додає підтримку дзвінків і нову діагностику

Редакція LinksGauge2 хв читання

Інтерфейс та ілюстрація оновлення API Google Data Manager

Головне за 30 секунд

  • Версія 1.9 Data Manager API додає підтримку конверсій за телефонними дзвінками (call conversions) у Google Ads.
  • Номер телефону перед надсиланням обов'язково потрібно привести до стандарту E.164 та захешувати за допомогою алгоритму SHA-256.
  • Оновлення приносить покрокову діагностику помилок за індексами записів у кожному звіті.
  • Нова версія працює за швидкою моделлю відхилення (fast-fail) замість часткового приймання рядків.
Зміст

Підтримка телефонних конверсій у Data Manager API

Google офіційно презентував оновлення Data Manager API до версії 1.9. Головним нововведенням стала інтеграція конверсій за телефонними дзвінками Google Ads, які тепер можна передавати через той самий єдиний канал даних для офлайн-продажів.

Для передачі конверсії розробники повинні використовувати спеціальне поле call_info із часовою міткою початку дзвінка (start_timestamp) та передавати номер абонента в захешованому вигляді через параметр user_data. Заборона на шифрування та вимога хешування відрізняють цей процес від стандартного API Google Ads.

Діагностика помилок та нові коди станів

Оновлення суттєво розширює інструменти діагностики. Раніше система повертала лише загальну кількість помилок або попереджень, тоді як у версії 1.9 кожен блок помилок містить поле record_indices із точними індексами проблемних рядків у початковому пакеті.

Додатково розробники отримали 15 нових кодів помилок та попереджень, зокрема пов'язані з часовими проміжками дзвінків, наприклад CONVERSION_PRECEDES_CALL, коли час конверсії вказано раніше за початок самого виклику.

Відмінності від класичного Google Ads API

Перехід із класичного API Google Ads на новий Data Manager API вимагає врахування архітектурних відмінностей. Зокрема, старий API використовував модель часткового приймання (partial failure), де валідні рядки проходять, а помилкові відхиляються окремо. Новий інтерфейс використовує модель швидкого відхилення (fast-fail), яка відхиляє весь запит повністю у разі виявлення хоча б однієї помилки на етапі валідації.

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

Що це означає на практиці

Маркетологам та технічним фахівцям, які налаштовують передачу офлайн-конверсій чи дзвінків, варто підготувати технічну інфраструктуру до обов'язкового хешування телефонних номерів за стандартом E.164 через алгоритм SHA-256. Оскільки новий інтерфейс відхиляє весь пакет даних одразу за наявності хоча б однієї помилки у валідації, процеси моніторингу та логування на стороні відправника потребують ретельної перевірки перед відправкою запитів.