Cloudflare SQL API: перевірте читання атрибутів у звітах
Зміна introspection від 27 жовтня: завдання розробнику, два приклади діагностики та перевірка власного звіту зі збереженням попередньої версії.
27 жовтня Cloudflare оголосив параметр introspection include_attributes та поле відповіді attributes. Попередні назви поки працюють, але позначені застарілими.
Кому це потрібно
Вебмайстрам із власним технічним звітом, який отримує схему через Cloudflare SQL API, та розробникам цього звіту. Якщо ви лише відкриваєте готову панель, спочатку з’ясуйте, чи використовує вона цей API. Повідомлення не означає несправність усіх звітів і не вимагає змінювати рекламні кампанії.
Що перевірити
У документації SQL API позначено як Beta. Виявлення атрибутів враховує попередні сім днів даних облікового запису. Отже, порожній список не доводить, що відповідних подій ніколи не було.
Наша послідовність перевірки
Знайдіть у клієнті include_custom_attributes та custom_attributes. Збережіть робочу версію. У тестовій копії узгоджено змініть параметр запиту й читання відповіді. Порівняйте обидва способи розбору на збереженій знеособленій відповіді та перевірте доступний набір даних. Не додавайте ключ доступу до робочого аркуша чи статті.
Два навчальні приклади
Перший: після зміни запиту фільтр звіту став порожнім. Збережіть знеособлену відповідь і перевірте, звідки клієнт читає список. Якщо він досі шукає старе поле, виправте тестову копію, перш ніж оголошувати втрату трафіку через порожній інтерфейс. Другий: атрибут траплявся лише в давній кампанії. Окремо перевірте період спостереження та вихідні дані. Не замінюйте невідоме значення нулем. Це сценарії діагностики, а не результати клієнтів.
Картка завдання розробнику
Власник звіту; обліковий запис і набір даних без секретів; час перевірки; старе поле; нове поле; знеособлена відповідь; очікуваний фільтр; фактичний результат; спосіб повернення; рішення та відповідальний.
Коли завершувати
Приймайте зміну, коли перевірена відповідь відображається правильно, відсутні дані явно позначені, а попередня версія збережена. За розбіжностей зупиніть заміну клієнта та з’ясуйте причину. Окремий технічний збій не має змінювати оцінку джерела трафіку.
Партнерська робота
Для роботи в нашій платформі можна увійти до кабінету AffiliateCore. Технічні дані Cloudflare та підтвердження партнерського результату — різні перевірки. Ця стаття не є анонсом інтеграції.
Першоджерела й дата перевірки
Cloudflare changelog — 2026-10-27; Cloudflare SQL API: Datasets. 2026-10-28.