- TCF 2.1. Ми й далі прийматимемо рядки фреймворку TCF 2.1, але радимо платформам керування згодою дотримуватись вказівок IAB щодо етапів упровадження, оскільки галузь переходить на TCF 2.2.
- Рішення Google для керування згодою користувачів, доступні на вкладці "Конфіденційність і повідомлення" в Ad Manager, AdSense і AdMob, підтримують фреймворк TCF 2.2 для повідомлень щодо європейських регламентів, що відповідає оновленим вимогам IAB щодо платформ керування згодою.
Щоб допомогти видавцям виправити помилки й проблеми з конфігурацією, пов’язані із запуском фреймворку Transparency & Consent Framework 2.2 від IAB Europe, ми надаємо звіт про виявлені помилки.
У цій статті детально розглядаються способи вирішення проблем з упровадженням фреймворку TCF 2.2.
Оновлені рекомендації
Усунення поширених помилок
Деякі поширені помилки в Ad Manager, AdSense і AdMob можна усунути за допомогою наведених нижче вказівок.
Рекомендуємо повторно отримати згоду користувачів за допомогою рядків TC без монетизації(Помилки 1.1, 3.1, 4.1, 5.1, 5.2 й 6.1)
Пов’язані помилки
Оновлені рекомендації
Рекомендуємо повторно отримати згоду користувачів.
Обґрунтування
Видавцям варто повторно отримати згоду, якщо раніше вони використовували рядки із зовнішньою чи глобальною областю дії, недійсні ідентифікатори платформи для керування згодою (з тестування), недійсні ідентифікатори GVL (з тестування) або під час упровадження фреймворку TCF не вказали Google як постачальника, що отримав належну згоду.
Помилки 1.1, 1.2 й 1.3: перевірте, якої частки трафіку вони стосуються. Якщо значної, проблема може бути з боку платформи для керування згодою. Також переконайтеся, що компанія Google отримала дозвіл щодо потрібних цілей і є постачальником на підставі згоди Й законного інтересу (ідентифікатор постачальника: 755).
Специфікації IAB
Згідно зі специфікаціями IAB, платформи для керування згодою мають право зберігати кешовані рядки згоди протягом 13 місяців.
AddEventHandler протягом 500 мс(Помилки 2.1a, 2.1b, 2.0a, 2.0b і 2.0c)
Пов’язані помилки
Помилка 2.1a. Ці рекомендації також допоможуть усунути помилки 2.1b, 2.0a, 2.0b й 2.0c.
Оновлені рекомендації
Ми скасували вимогу щодо часу очікування відповіді, але все ж радимо платформам для керування згодою стежити за тим, щоб відповідь на виклик AddEventListener getTCData надсилалася негайно.
Інакше запити можуть залишатися немонетизованими.
Обґрунтування
Google дотримується специфікації IAB, яка вимагає від платформ для керування згодою негайно відповідати на функцію AddEventListener. Якщо платформа реагує задовго, запити можуть залишатися немонетизованими.
Крім того, відповіді платформи для керування згодою входять у ланцюг подій, від яких залежить, скільки часу минає від завантаження сторінки до надсилання запитів оголошень. Що більший цей проміжок, то більше показів утрачає видавець.
Специфікації IAB
Ми використовуємо специфікацію IAB AddEventListener (на GitHub).
AddEventListener має відбуватися відразу після реєстрації за допомогою поточних даних TC, навіть якщо платформа для керування згодою має статус loading (завантаження) і не отримала повні дані TC. Це потрібно, щоб скрипт виклику міг отримати доступ до зареєстрованого ідентифікатора listenerId. Крім того, зворотний виклик слід виконувати після кожного змінення рядка TC, якщо цей виклик не вилучено за допомогою RemoveEventListener.Центр правил
Центр правил сповіщає видавців, якщо додаток чи сайт не відповідають вимогам Google щодо керування згодою.
Звіт про помилки
Якщо ми виявимо проблему з рядком TC, пов’язаним із сайтами чи додатками видавця, то повідомимо про це в інтерфейсі сервісу. Щоб отримати детальний перелік помилок, виявлених за останні 7 днів, перейдіть на сторінку "Згода користувачів із ЄС" в обліковому записі й натисніть Завантажити звіт про помилки TCF.
- В Ad Manager натисніть Адміністратор і виберіть Згода користувачів із ЄС.
- В AdMob або AdSense натисніть Параметри блокування й виберіть Згода користувачів із ЄС.
Звіт міститиме наведені нижче відомості про кожну з виявлених помилок.
- Домен/MobileAppID – сайт або мобільний додаток із помилками.
- Шлях до рекламного блоку – рекламний блок, з яким пов’язана помилка.
- Код помилки – код, що відповідає помилці.
- Кількість помилок – число запитів із помилкою, зареєстрованих за останній тиждень.
- Дата останнього виявлення – день, коли ми востаннє зареєстрували помилку.
Нижче наведено таблиці з порадами щодо вирішення проблем. Якщо у вас стається помилка, знайдіть її в таблицях за кодом зі звіту й дізнайтеся, як її усунути.
Вирішення проблем
Нижче ви знайдете таблиці найпоширеніших помилок у рядках TC, які допоможуть видавцям вирішити проблеми з налаштуванням інтеграції TCF 2.2 від IAB.
Таблиці містять інформацію про помилки на рівні запитів оголошень і відповідні особливості роботи системи.
Сценарії отримання згоди з обмеженням
Усі ці сценарії завжди мають вищий пріоритет, ніж помилки конфігурації, навіть якщо запит містить іще й інші типи помилок.
| Сценарій | Опис | Рекомендовані дії |
|---|---|---|
| 1.1 | Не дозволено використовувати Google як постачальника на підставі згоди або законного інтересу. | Перевірте, що сталося. Можливі варіанти: користувач свідомо відхилив Google як постачальника; платформу для керування згодою впроваджено з помилками; діють обмеження від видавців. |
| 1.2 | Не отримано згоду щодо цілі 1 для Великої Британії і країн ЄЕЗ. |
Перевірте, що сталося. Можливі варіанти: користувач свідомо не дав згоду щодо цілі 1; платформу для керування згодою впроваджено з помилками. Видавці, які працюють у Швейцарії та не запитують згоду в користувачів, повинні перевіряти, чи правильно задано поля
PublisherCC й PurposeOneTreatment. Починаючи з грудня 2021 року, ми більше не перевірятимемо поле |
| 1.3 | Згоду щодо цілі 1 отримано, але немає законних підстав для показу загальних оголошень. |
Перевірте, що сталося. Можливі варіанти: користувач свідомо відмовився надавати згоду стосовно законних інтересів щодо інших цілей; платформу для керування згодою впроваджено з помилками. |
Неправильна конфігурація
Запити оголошень не виконуватимуться, поки ставатимуться помилки конфігурації.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 2.1a | Тег або SDK не отримують рядок TC, тому що платформа для керування згодою має статус stub (заглушка), loading (завантаження) чи error (помилка). |
Якщо ви вручну викликаєте функцію для запиту оголошення, переконайтеся, що отримано відповідь Якщо ви не викликаєте функцію для запиту оголошення вручну, переконайтеся, що платформа для керування згодою підтримує |
| 2.1b |
Виконуються дві умови:
|
Зверніться до постачальника платформи для керування згодою, щоб він перевірив, чи відповідає впровадження його API технічній специфікації IAB для TCF. |
| 2.2a |
Рядок TC не можна проаналізувати, оскільки його закодовано не в Base64. Приклад: |
Платформа для керування згодою і видавці повинні передавати дані лише в кодуванні Base64 й параметрах gdpr_consent=. |
| 2.2b |
Рядок TC не можна проаналізувати через помилку розкодування. Приклад: рядок із неправильною кількістю бітів. |
Платформа для керування згодою має виправити помилки з упровадженням рядка TC. |
| 2.2c |
Рядок TC не можна проаналізувати через помилку в даних. Приклад: неправильна позначка часу, задовгий ідентифікатор постачальника. |
Платформа для керування згодою має виправити помилки з упровадженням рядка TC. |
Проблеми з рядком TC
Проблеми з рядком TC, пов’язані із запитом оголошення. Запити оголошень не виконуватимуться.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 3.1 | Недійсний ідентифікатор платформи для керування згодою. |
Переконайтеся, що організація IAB перевірила платформу для керування згодою, а в рядках TC правильно вказано її ідентифікатор. Якщо на час генерації рядка TC платформа для керування згодою була дійсною, але потім організація IAB її видалила, виберіть дійсну платформу й повторно отримайте згоду. |
| 3.2 | Більше не використовується. | Немає. Попереднє значення: рядок TC створено понад 13 місяців тому. |
Потрібно повторно отримати згоду
Потрібно отримати згоду користувача. Якщо ви використовуєте версію GVL, у якій іще не було Google, потрібно отримати згоду повторно, інакше запити оголошень не виконуватимуться.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 3.3 | Більше не використовується. |
Немає. Попереднє значення: рядок TC востаннє оновлювався понад 13 місяців тому. |
| 4.1 | Рядок TC згенеровано за допомогою старої версії GVL, у якій іще не було Google. | Отримайте згоду повторно за допомогою поточної версії GVL. |
Глобальна або зовнішня область дії
Нижче наведено проблеми, пов’язані з глобальною або зовнішньою областю дії (Ad Manager, AdMob, AdSense). Оголошення не показуватимуться, якщо в рядку TC буде вказано "Зовнішня область дії" або "Глобальна область дії".
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 5.1 | Рядок TC допускає зовнішню згоду. | Зверніться до постачальника платформи для керування згодою, щоб він вилучив із рядків TC зовнішні сигнали. |
| 5.2 | Рядок TC з глобальною областю дії. | Надішліть запит постачальнику платформи для керування згодою, щоб він прив’язав рядки TC до конкретних сервісів. |
Ліміт на кількість оголошень
Застосовуватиметься ліміт на кількість оголошень.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 6.1 | Версія рядка TC – 1 або 1.1 (для TCF 1.0). |
Платформа для керування згодою повинна надсилати рядки TCF 2.2. |
Google вирішує проблеми
Коли виникають такі проблеми, Google за потреби автоматично вирішує їх і продовжує працювати з TCF у звичному режимі.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 7.1 | Присутній дійсний рядок TC, але параметр gdprApplies не заданий або його значення недійсне чи не розшифровується. |
Н/Д |
| 7.2 | Рядок TC згенеровано за допомогою новішої версії GVL, ніж та, яку підтримують технології розміщення оголошень Google. | Н/Д |
| 7.3 | Деякі цілі, функції і/або постачальники – поза дозволеним діапазоном (невідомі). | Н/Д |
| 7.4 | У рядку TC вказано старішу версію tcf_policy_version, ніж остання редакція GVL. |
Платформа для керування згодою має видалити старий рядок TC й повторно отримати згоду за допомогою останньої версії GVL. |
| 7.5 |
Запит містить код |
Н/Д |
| 7.6 | Згода щодо цілі 1 присутня, але код країни видавця недійсний. | Платформа для керування згодою має виправити помилки з упровадженням рядка TC. |
| 7.7 | Недійсний код мови. | Платформа для керування згодою має виправити помилки з упровадженням рядка TC. |
| 7.8 | У полі версії рядка TC вказано не 1 або 2, а інше значення. |
Платформа для керування згодою має виправити помилки з упровадженням рядка TC, надіславши запит на нову згоду, якщо виявлено недійсний рядок. Якщо ви використовуєте рішення Google для керування згодою, перегляньте вказівки з вирішення проблем для додатків, щоб усунути помилки цього типу. Видавцям AdSense, які використовують рішення Google для керування згодою, не потрібно нічого робити, щоб усунути помилки цього типу. |
| 7.9 | У полі версії рядка AC вказано не 1 або 2, а інше значення. |
Платформа для керування згодою має вказати для рядка AC версію 1 або 2. |
Проблеми з рядком AC
Коли виникають такі проблеми, система Google розцінює рядок додаткової згоди (AC) як недійсний. Розглядаються лише постачальники, указані в рядку TC.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 8.1 | У рядку AC не використовується символ для відділення версії (~). |
Платформа для керування згодою має використовувати символ "~" як другий елемент рядка, щоб розділити номер версії і список погоджених постачальників. |
| 8.2 | У рядку AC неправильно відформатовано список постачальників (він має містити значення int64, розділені крапкою "."). | Зверніться до постачальника платформи для керування згодою, щоб він виправив помилки з упровадженням рядка AC. |
Сертифікація платформи для керування згодою
Коли виникають такі проблеми, Google намагається показувати неперсоналізовану рекламу.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 9.1 | Наявну в запиті платформу для керування згодою, яка відповідає вимогам фреймворку TCF, не сертифіковано Google. | Платформу для керування згодою має бути сертифіковано Google. |
Немає сигналів TCF у запитах оголошень
Коли виникають такі проблеми, Google намагатиметься здійснювати обмежений показ реклами.
| Помилка | Опис | Рекомендовані дії |
|---|---|---|
| 10.1 |
Запит надійшов із ЄЕЗ, Великої Британії або Швейцарії, але не містить сигналів TCF. |
Видавцю потрібно інтегрувати платформу для керування згодою, яка відповідає вимогам фреймворку TCF і має сертифікат Google. |
