Правила програми AdSense і AdMob

Вирішення проблем із TCF 2.0

Пільгові періоди й рекомендації з вирішення проблем

Організація IAB Europe разом з IAB Tech Lab і компаніями-учасницями завершила роботу над версією 2.0 сертифікації Transparency and Consent Framework (TCF). Відтепер Google повністю підтримує цю версію.

Щоб дати видавцям час виправити помилки та проблеми з конфігурацією, пов'язані із запуском системи сертифікації Transparency & Consent Framework 2.0 від IAB Europe, Google підготує звіт про виявлені помилки й надасть пільговий період на 150 днів.


У цій статті детально розглядаються способи вирішення проблем з упровадженням сертифікації Transparency & Consent Framework (TCF) 2.0.


Оновлені рекомендації

Зміни

  • Час відповіді CMP 500 мс. З 9 листопада 2020 року ми більше не обмежуємо час відповіді CMP, які працюють із TCF 2.0. Раніше діяла вимога, щоб платформа CMP відповідала на запити Ad Manager, AdSense і AdMob протягом 500 мс. Тепер ці сервіси очікують на відповідь необмежений час.

Усунення поширених помилок

Деякі поширені помилки в Ad Manager, AdSense і AdMob можна усунути за допомогою наведених нижче вказівок.

Рекомендуємо повторно отримати згоду користувачів за допомогою рядків TC без монетизації
(Помилки 1.1, 3.1, 4.1, 5.1, 5.2 та 6.1)

Пов'язані помилки

Помилка 1.1. Ці рекомендації також допоможуть усунути помилки 3.1, 4.1, 5.1, 5.2 та 6.1.

Оновлені рекомендації

Рекомендуємо повторно отримати згоду користувачів.

Обґрунтування

Видавцям варто повторно отримати згоду, якщо раніше вони використовували рядки із зовнішньою або глобальною областю дії, недійсні ідентифікатори CMP чи GVL (з тестування) або під час упровадження TCF не простежили, щоб Google було вказано як постачальника, що надав належну згоду.

Помилки 1.1, 1.2 й 1.3: перевірте, якої частки трафіку вони стосуються. Якщо значної, проблема може бути з боку CMP. Також переконайтеся, що компанія Google надає дозвіл для необхідних цілей і є постачальником функцій отримання згоди ТА законного права (ідентифікатор постачальника: 755).

Специфікації IAB

Згідно зі специфікаціями IAB, платформи CMP мають право зберігати кешовані рядки згоди протягом 13 місяців.

Деякі CMP раніше зберігали дату першого отримання згоди та використовували її для інших рядків. Так робити не можна. Для кожного нового рядка згоди необхідно вказувати актуальну дату.
Рекомендуємо налаштувати платформу CMP так, щоб вона повертала виклики від AddEventHandler протягом 500 мс
(Помилки 2.1 (а), 2.1 (б), 2.2 (а), 2.2 (б) та 2.2 (в))

Пов'язані помилки

Помилка 2.1 (a). Ці рекомендації також допоможуть усунути помилки 2.1 (б), 2.2 (а), 2.2 (б) та 2.2 (в).

Оновлені рекомендації

Ми скасували вимогу щодо часу очікування відповіді, але все ж радимо CMP стежити за тим, щоб їхні платформи негайно повертали виклики до AddEventListener getTCData.

Інакше запити можуть залишатися немонетизованими.

Обґрунтування

Google дотримується специфікацій IAB, які вимагають від CMP негайно відповідати функції AddEventListener. Якщо платформа реагує задовго, запити можуть залишатися немонетизованими.

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

Специфікації IAB

Ми використовуємо специфікацію IAB AddEventListener (на GitHub).

Зворотний виклик AddEventListener має відбуватися відразу після реєстрації за допомогою поточних даних TC, навіть якщо статус CMP ще не завантажився, а сама платформа не отримала повні дані TC. Це потрібно, щоб скрипт виклику міг отримати доступ до зареєстрованого listenerId. Крім того, зворотний виклик необхідно виконувати після кожного змінення рядка TC, якщо цей виклик не вилучено за допомогою RemoveEventListener.

Звіт про помилки

Якщо ми виявимо проблему з рядком TC, пов'язаним із сайтами чи додатками видавця, то повідомимо про це в інтерфейсі сервісу. Щоб отримати детальний перелік помилок, виявлених за останні 7 днів, перейдіть на сторінку "Згода користувачів із ЄС" в обліковому записі та натисніть Завантажити звіт про помилки TCF.

Цей звіт доступний, лише якщо за останні 7 днів було зареєстровано якісь помилки.
Щоб відкрити сторінку "Згода користувачів із ЄС" і завантажити звіт про помилки TCF, виконайте наведені нижче дії.
  • В Ad Manager натисніть Адміністратор and then Згода користувачів із ЄС.
  • В AdMob або AdSense натисніть Керування блокуванням and then Згода користувачів із ЄС.

Звіт міститиме наведені нижче відомості про кожну з виявлених помилок. 

  • Ідентифікатор домену/MobileAppID – сайт або мобільний додаток із помилками.
  • Шлях до рекламного блоку – рекламний блок, з яким пов'язано помилку.
  • Код помилки – код, що відповідає помилці.
  • Кількість помилок – число запитів із помилкою, зареєстрованих за останній тиждень.
  • Дата останнього виявлення – день, коли ми востаннє зареєстрували помилку. 

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

Пільговий період

Тривалість пільгового періоду залежить від типу помилки. У таблиці нижче описано різні варіанти пільгових періодів і випадки, у яких вони застосовуються.

Пільговий період подовжено ще на 60 днів. Тепер він завершується в середині січня 2021 року.
Тип помилки та пільгового періоду Огляд
Пільговий період 0: проблеми з конфігурацією

Призначений для вирішення поширених проблем із налаштуванням CMP, через які не передається дійсний рядок TC. У таких випадках Google дає видавцю 60 днів на те, щоб без шкоди для монетизації вирішити проблеми з конфігураціями, установивши правильні налаштування GDPR для постачальників рекламних технологій. Через 60 днів Google починає показ неперсоналізованих оголошень, який триватиме решту пільгового періоду.

Такі помилки завжди мають найвищий пріоритет, навіть якщо запит містить ще й інші типи помилок.

Пільговий період 0 застосовується, якщо:

  • у перші 60 днів пільгового періоду видавець зможе виправити проблеми з налаштуваннями без шкоди для монетизації;
  • протягом решти пільгового періоду показуватимуться неперсоналізовані оголошення (незалежно від вибраних видавцем налаштувань персоналізації реклами).

Після завершення пільгового періоду запити оголошень не виконуватимуться.

Пільговий період 1: проблеми з рядком TC

Призначений для вирішення серйозних проблем із рядком TC. У таких випадках Google показує протягом усього пільгового періоду лише неперсоналізовані оголошення.

Пільговий період 1 застосовується, якщо рядок TC, пов'язаний із запитами оголошень, працює неправильно. У таких випадках за запитами оголошень протягом усього пільгового періоду показуються неперсоналізовані оголошення. Після завершення пільгового періоду запити оголошень не виконуватимуться.

Пільговий період 2: потрібна повторна згода

Призначений для видавців, які виконали інтеграцію з TCF 2.0 до того, як Google було включено в глобальний список постачальників IAB (так званий реєстр GVL). Такі видавці отримали згоду на рекламу Google від користувачів поза межами TCF 2.0. Компанія Google здійснила офіційний запуск інтеграції, тож слід повторно отримати згоду користувачів, які застосовують TCF 2.0. Видавець може сам вибрати, коли це робити: головне – встигнути до завершення пільгового періоду.

Пільговий період 2 застосовується, якщо від користувачів потрібно отримати згоду. Якщо хтось із них давав згоду понад 13 місяців тому, скористайтеся цією нагодою, щоб підтвердити її.

Протягом цього пільгового періоду старі персоналізовані й неперсоналізовані оголошення показуються із заданими налаштуваннями та без шкоди для монетизації. Для персоналізованої реклами можна використовувати Інструменти керування постачальниками рекламних технологій. Після завершення пільгового періоду запити оголошень не виконуватимуться.

Пільговий період 3: глобальна або зовнішня область дії

Призначений для вирішення проблем із рядками TC, які мають глобальну або зовнішню область дії (Ad Manager, AdMob, AdSense). Протягом пільгового періоду потрібно виправити проблему. Тим часом Google показуватиме рекламу за цими запитами оголошень відповідно до рядка TC та правил Google.

Протягом пільгового періоду ми показуватимемо рекламу за цими запитами оголошень відповідно до рядка TC та правил Google. Коли мине 150 днів, оголошення більше не показуватимуться, якщо в рядку TC буде вказано, що область дії глобальна або зовнішня.

 

Вирішення проблем

Нижче ви знайдете таблиці найпоширеніших помилок у рядках TC, які допоможуть видавцям вирішити проблеми з налаштуванням інтеграції IAB TCF 2.0. Також у цих таблицях указано, чи застосовується для помилки пільговий період, і якщо так, то які його умови.

Ці таблиці допоможуть розібратись у помилках на рівні запитів оголошень і у відповідних особливостях роботи системи.

Пільгового періоду немає, оголошення не показуються

Такі помилки завжди призводять до невиконаних запитів оголошень. Пільгового періоду для них не передбачено. Ці помилки завжди мають найвищий пріоритет, навіть якщо запит містить ще й інші типи помилок.

Сценарій Опис Рекомендовані дії
1.1 Не дозволено використовувати Google як постачальника через відсутність згоди або законних прав. Перевірте, що сталося. Можливі варіанти: користувач свідомо відмовився від послуг Google; CMP упроваджено з помилками; діють обмеження для видавців.
1.2 Не отримано згоду щодо цілі 1 для Великої Британії та країн ЄЕЗ.

Перевірте, що сталося. Можливі варіанти: користувач свідомо не дав згоду щодо цілі 1; CMP впроваджено з помилками.

Якщо ви працюєте в Німеччині та не запитуєте згоду в користувачів, перевірте, чи правильно задано поля PublisherCC й PurposeOneTreatment.
1.3 Згоду щодо цілі 1 отримано, але немає законних підстав для показу основних оголошень.

Перевірте, що сталося. Можливі варіанти: користувач свідомо відмовив у законних правах щодо інших цілей; CMP впроваджено з помилками.

Пільговий період 0: проблеми з конфігурацією

Пільговий період 0 застосовується, якщо:

  • у перші 60 днів пільгового періоду видавець зможе виправити проблеми з налаштуваннями без шкоди для монетизації;
  • протягом решти пільгового періоду показуватимуться неперсоналізовані оголошення (незалежно від вибраних видавцем налаштувань персоналізації реклами).

Після завершення пільгового періоду запити оголошень не виконуватимуться.

Помилка Опис Рекомендовані дії
2.1 (а) Тег або SDK не отримують рядок TC, тому що CMP має статус stub (заглушка), loading (завантаження) чи error (помилка).

Якщо ви вручну викликаєте функцію для запиту оголошення, переконайтеся, що отримано відповідь getTCData TCData.eventStatus = 'tcloaded' АБО 'cmpuishown' + 'useractioncomplete'. Такі відповіді вказують, що платформа CMP готова надати користувачу вибір щодо згоди.

Якщо ви не викликаєте функцію для запитування оголошень вручну, переконайтеся, що CMP підтримує getTCData й повертає TCData.eventStatus = 'tcloaded' АБО 'cmpuishown' + 'useractioncomplete'. Така відповідь означає, що згоду користувача можна використовувати в API.

2.1 (б)

Виконуються дві умови:

  • для CMP вказано &gdpr=1;
  • у запиті є параметр &gdpr_consent=, але рядок TC порожній.
Зверніться до постачальника CMP, щоб він перевірив, чи відповідає впровадження його API технічній специфікації IAB для TCF.
2.2 (а)

Рядок TC не можна проаналізувати, оскільки його закодовано не в Base64.

Приклад: “2”.

CMP та видавці повинні передавати дані лише в кодуванні Base64 й параметрах gdpr_consent=.
2.2 (б)

Рядок TC не можна проаналізувати через помилку розкодування.

Приклад: рядок із неправильною кількістю бітів.

Зверніться до CMP, щоб вони виправили помилки в упровадженні рядка TC.
2.2 (в)

Рядок TC не можна проаналізувати через помилку в даних.

Приклад: неправильна позначка часу, задовгий ідентифікатор постачальника.
 

Зверніться до CMP, щоб вони виправили помилки в упровадженні рядка TC.

Пільговий період 1: проблеми з рядком TC

Пільговий період 1 застосовується, якщо рядок TC, пов'язаний із запитами оголошень, працює неправильно. У таких випадках за запитами оголошень протягом усього пільгового періоду показуються неперсоналізовані оголошення зі старими налаштуваннями. Коли мине 150-денний пільговий період, запити оголошень більше не виконуватимуться.

Помилка Опис Рекомендовані дії
3.1 Недійсний ідентифікатор CMP.

Переконайтеся, що CMP перевірено організацією IAB, а в рядках TC правильно вказано його ідентифікатор.

Якщо на час генерації рядка TC платформа CMP була дійсна, але потім IAB її видалила, виберіть дійсну CMP та повторно отримайте згоду.

3.2 Рядок TC створено понад 13 місяців тому. Зверніться до CMP, щоб вони видалили старий рядок TC та повторно отримали згоду.
3.3 Рядок TC востаннє оновлювався понад 13 місяців тому. Зверніться до CMP, щоб вони видалили старий рядок TC та повторно отримали згоду.

Пільговий період 2: потрібна повторна згода

Пільговий період 2 застосовується, якщо від користувачів потрібно отримати згоду. Якщо хтось із них давав згоду понад 13 місяців тому або до реєстрації Google у GVL, скористайтеся цією нагодою, щоб підтвердити згоду.

Протягом цього пільгового періоду старі персоналізовані й неперсоналізовані оголошення показуються із заданими налаштуваннями та без шкоди для монетизації. Для персоналізованої реклами можна використовувати Інструменти керування постачальниками рекламних технологій. Коли мине 150-денний пільговий період, запити оголошень більше не виконуватимуться.

Помилка Опис Рекомендовані дії
4.1 Рядок TC згенеровано за допомогою старої версії GVL, де ще немає Google. Повторно отримайте згоду з використанням нової версії GVL, де вже зареєстровано Google.

Пільговий період 3: глобальна або зовнішня область дії

Пільговий період 3 застосовується у випадках проблем із глобальною або зовнішньою областю дії (Ad Manager, AdMob, AdSense).

Протягом пільгового періоду ми показуватимемо рекламу за цими запитами оголошень відповідно до рядка TC та правил Google. Коли мине 150 днів, оголошення більше не показуватимуться, якщо в рядку TC буде вказано, що область дії глобальна або зовнішня.

Помилка Опис Рекомендовані дії
5.1 Рядок TC допускає зовнішню згоду. Зверніться до CMP, щоб вони вилучили з рядків TC зовнішні сигнали.
5.2 Рядок TC з глобальною областю дії. Зверніться до CMP, щоб вони прив'язали рядки TC до конкретних сервісів.

Пільгового періоду немає, оголошення показуються

Пільговий період не надано. Персоналізовані й неперсоналізовані оголошення показуються із заданими налаштуваннями та без шкоди для монетизації.

Помилка Опис Рекомендовані дії
6.1 Версія рядка TC – 1 або 1.1 (для TCF 1.0). Повідомте постачальника CMP, що йому потрібно використовувати рядки для TCF 2.0.

Пільгового періоду немає, Google автоматично вирішує проблему

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

Помилка Опис Рекомендовані дії
7.1 Присутній дійсний рядок TC, але параметр gdprApplies не заданий або його значення недійсне чи не розшифровується. Н/Д
7.2 Рядок TC згенеровано за допомогою новішої версії GVL, ніж та, яку підтримують технології розміщення оголошень Google. Н/Д
7.3 Деякі цілі, функції та/або постачальники – поза дозволеним діапазоном (невідомі). Н/Д
7.4 У рядку TC вказано старішу версію tcf_policy_version, ніж остання редакція GVL. Зверніться до CMP, щоб вони видалили старий рядок TC та повторно отримали згоду за допомогою останньої версії GVL.
7.5

Запит містить код &gdpr=1, але в URL-адресі запиту немає параметра &gdpr_consent.

Н/Д
7.6 Згода щодо цілі 1 присутня, але код країни видавця недійсний.  Зверніться до CMP, щоб вони виправили помилки в упровадженні рядка TC.
7.7 Недійсний код мови. Зверніться до CMP, щоб вони виправили помилки в упровадженні рядка TC.
7.8 У полі версії рядка TC вказано не 1 або 2, а інше значення. Повідомте постачальника CMP, що йому потрібно використовувати рядки для TCF 2.0.
7.9 Версія рядка AC – не 1. На CMP потрібно вказати для рядка AC версію 1.

Пільгового періоду немає, проблеми з рядком AC

Коли виникають такі проблеми, система Google розцінює рядок додаткової згоди (AC) як недійсний. Розглядаються лише постачальники, указані в рядку TC.

Помилка Опис Рекомендовані дії
8.1 У рядку AC не використовується символ для відділення версії (~). На CMP потрібно використовувати символ "~" як другий елемент рядка, щоб розділити номер версії та список погоджених постачальників.
8.2 У рядку AC неправильно відформатовано список постачальників (він має містити значення int64, розділені крапкою " . ") Зверніться до постачальника CMP, щоб він виправив помилки в упровадженні рядка AC.

 

Чи корисна ця інформація?
Як можна її покращити?

Потрібна додаткова допомога?

Увійдіть в обліковий запис, щоб отримати додаткову допомогу та швидко вирішити проблему