- Версия 2.1 на TCF: Ще продължим да приемаме низове за версия 2.1 на TCF, но препоръчваме на CMP да спазват указанията на IAB относно ключовите събития около внедряването при преминаването на отрасъла към версия 2.2 на TCF.
- Решения за управление на получаването на съгласие в Google: Решенията за управление на получаването на съгласие в Google, които са налице в раздела „Поверителност и съобщения“ в Ad Manager, AdSense и AdMob, поддържат версия 2.2 на TCF за съобщенията за европейските регламенти съгласно актуализираните изисквания на IAB за CMP.
За да помогнем на издателите да се справят с грешките и неправилните конфигурации във връзка с лансирането на версия 2.2 на Рамката за прозрачност и съгласие на Бюрото за интерактивна реклама (IAB) за Европа, предоставяме отчет с откритите от нас грешки.
В тази статия ще намерите още информация за това как да отстранявате грешки при внедряването на версия 2.2 на TCF, включително:
Актуализирани указания
Актуализации
- Напомняне за изискването на TCF за повторно получаване на съгласие на всеки 13 месеца:
You are required by IAB TCF policy to remind users about their consent choices at least once every 13 months. If the consent decision is more than 13 months old, the TC string will no longer be considered valid by Google and Google will not serve ads to that user. We suggest that you work with your CMP to remind users about their consent choices before the 13-month limit is reached.
- Типът грешка 3.2 е премахнат. Низовете за прозрачност и съгласие, които са актуализирани през последните 13 месеца, остават валидни.
Поправки на често срещани грешки
Отстранете някои от най-често срещаните грешки в Ad Manager, AdSense и AdMob, като предприемете следните действия:
Обмислете да поискате повторно съгласие от потребителите чрез низове за прозрачност и съгласие, които не осигуряват приходи(Грешки 1.1, 3.1, 4.1, 5.1, 5.2 и 6.1)
Сродни грешки
Актуализирани указания
Обмислете дали да не поискате повторно съгласие от потребителите.
Обосновка
Издателите ще имат полза от повторно искане на съгласие, ако преди това са използвали низове с извънреден или с глобален обхват, невалидни идентификатори на CMP (от тестване) или невалидни идентификатори на GVL (от тестване) или по време на внедряването не са добавили Google като доставчик с подходящо съгласие.
Грешки 1.1, 1.2, 1.3: Важно е да проверите дали тези грешки се получават при значителен обем на трафика. Ако е така, имайте предвид, че е възможно да има проблем в CMP. Уверете се, че на Google е предоставено съгласие за необходимите цели и също така Google е доставчик за съгласие И законен интерес (идентификатор на доставчика 755).
Спецификация на IAB
Съгласно спецификациите на IAB CMP може да кешира низове за получаване на съгласие в продължение на 13 месеца.
AddEventHandler в рамките на 500 мсек(Грешки 2.1a, 2.1b, 2.0a, 2.0b и 2.0c)
Сродни грешки
Грешка 2.1a. Тези указания може да бъдат приложени и към грешки 2.1b, 2.0a, 2.0b и 2.0c.
Актуализирани указания
Въпреки че вече няма изискване за времето за изчакване, препоръчваме внимателно да бъдат прегледани внедряванията на CMP, за да е сигурно, че извикванията на AddEventListener getTCData се връщат незабавно.
Ако CMP не отговаря, за заявката може да не бъдат получени приходи.
Обосновка
Google спазва спецификацията на IAB, според която CMP трябва да отговаря незабавно на функцията AddEventListener. Ако CMP не отговори веднага, за заявката може да не бъдат получени приходи.
Освен това отговорите на CMP са част от веригата от събития, които влияят върху това, колко скоро може да се извърши заявка за реклами. Намаляването на времето между зареждането на страница и заявките за реклами води до по-малко пропуснати импресии за издателя.
Спецификация на IAB
Приложима спецификация на IAB: Спецификация на IAB за AddEventListener (в GitHub)
AddEventListener трябва да се извърши веднага след регистрирането с текущите данни за прозрачности и съгласие дори ако състоянието на CMP още е loading и платформата съдържа непълни данни за прозрачност и съгласие. Това позволява на извикващия скрипт да осъществи достъп до регистрирания за него listenerId. Освен това при всяка промяна на низа за прозрачност и съгласие обратното извикване трябва да бъде задействано, освен ако не бъде премахнато чрез RemoveEventListener.Център за правила
Центърът за правила известява издателите, ако дадено приложение или сайт не спазва изискванията на Google за управление на получаването на съгласие.
Отчет за грешките
Ще уведомяваме издателите в потребителския интерфейс на продукта, ако установим проблем с низа за прозрачност и съгласие в един или повече от сайтовете или приложенията им. На страницата „Съгласие на потребителите в ЕС“ в профила си издателите с възникнали грешки могат да кликнат върху Изтегляне на отчет за грешките в TCF и да получат подробен отчет за откритите през последните 7 дни грешки.
- Ad Manager: Кликнете върху Администриране, след това върху Съгласие на потребителите в ЕС.
- AdMob и AdSense: Кликнете върху Контроли за блокиране, след това върху Съгласие на потребителите в ЕС.
Отчетът ще съдържа следната информация за всяка от откритите грешки:
- Домейн/MobileAppID: Сайтът или мобилното приложение с неправилно конфигуриране.
- Път на рекламния елемент: Рекламният елемент, свързан с грешката.
- Код на грешката: Кодът, който е присвоен на грешката.
- Брой грешки: Броят на откритите през предходната седмица заявки, които съдържат грешката.
- Дата на последно откриване: Последната дата, на която е открита грешката.
Издателите могат да използват посочените в отчета кодове на грешки, за да намерят препоръчителните действия в следните таблици за отстраняване на неизправности и да коригират грешките.
Отстраняване на неизправности
За да помогнем на издателите да коригират неправилно конфигурираните интегрирания на версия 2.2 на TCF на IAB, съставихме следните таблици с най-честите типове грешки за низа за прозрачност и съгласие и съответните препоръки за отстраняване на неизправностите.
Използвайте таблиците, за да разберете грешките, които възникват на ниво заявка за реклама, както и съответното поведение на системата.
Ситуации с ограничено съгласие
И трите ситуации винаги имат предимство пред грешките с неправилно конфигуриране дори ако в дадена заявка има няколко грешки.
| Ситуация | Описание | Предложено действие, което да предприемете |
|---|---|---|
| 1.1 | За Google като доставчик липсва разрешение чрез предоставяне на съгласие или законен интерес. | Проверете дали потребителят нарочно е отхвърлил Google като доставчик, дали са възникнали грешки при внедряването на CMP или има ограничения за издателите. |
| 1.2 | Няма съгласие за Цел 1 за държавите от ЕИП и Обединеното кралство. |
Проверете дали потребителят нарочно не е позволил Цел 1, или това се дължи на грешки при внедряването на CMP. Издателите в Швейцария трябва да са настроили правилно полетата
PublisherCC и PurposeOneTreatment, ако не искат съгласието на потребителите. От декември 2021 г. повече няма да проверяваме за съответствие с |
| 1.3 | Има съгласие за Цел 1, но липсват правните основания за основните реклами. |
Проверете дали потребителят нарочно е отхвърлил законните интереси за другите цели, или това се дължи на грешки при внедряването на CMP. |
Неправилно конфигуриране
Заявките за реклами няма да се изпълняват, докато съществуват грешки поради неправилно конфигуриране.
| Грешка | Описание | Предложено действие, което да предприемете |
|---|---|---|
| 2.1a | Маркерът или SDK не получава низ за прозрачност и съгласие, защото състоянието на CMP е stub, loading или error. |
Ако извиквате ръчно функцията, за да заявявате реклами, уверете се, че отговорът на Ако не извиквате ръчно функцията, за да заявявате реклами, работете със CMP, за да се уверите, че е внедрена поддръжка за |
| 2.1b |
И двете условия са изпълнени:
|
Обърнете се към доставчика на Вашата CMP, за да се уверите, че приложните програмни интерфейси (API) на платформата са реализирани съгласно техническите спецификации на IAB за TCF. |
| 2.2a |
Низът за прозрачност и съгласие не може да бъде анализиран синтактично, защото не е кодиран с base64. Пример: |
Платформите за управление на съгласието (CMP) (или издателите) трябва да изпращат само кодирани с base64 данни в параметрите gdpr_consent=. |
| 2.2b |
Низът за прозрачност и съгласие не може да бъде анализиран синтактично поради грешка при декодирането. Пример: включва неправилен брой битове |
Платформата за управление на съгласието (CMP) трябва да коригира грешките при внедряването на низа за прозрачност и съгласие. |
| 2.2c |
Низът за прозрачност и съгласие не може да бъде анализиран синтактично поради грешка в данните. Пример: неправилно клеймо за дата и час, идентификаторът на доставчика е твърде голям |
Платформата за управление на съгласието (CMP) трябва да коригира грешките при внедряването на низа за прозрачност и съгласие. |
Проблеми с низа за прозрачност и съгласие
Проблеми с низа за прозрачност и съгласие, свързан със заявка за реклама. Заявките за реклами се пропускат и не се изпълняват.
| Грешка | Описание | Предложено действие, което да предприемете |
|---|---|---|
| 3.1 | Невалиден идентификационен номер на CMP |
Уверете се, че се използва проверена от IAB платформа за управление на съгласието (CMP) и че идентификационният ѝ номер е зададен правилно в низовете за прозрачност и съгласие. Ако платформата за управление на съгласието (CMP) е била валидна при създаването на низ за прозрачност и съгласие, но по-късно е била изтрита от IAB, трябва да получите повторно съгласие, като използвате валидна CMP. |
| 3.2 | Вече не се използва. | Няма. Предишно значение: Датата на създаване на низа за прозрачност и съгласие е отпреди повече от 13 месеца. |
Съгласието трябва да бъде получено отново
От потребителя трябва да бъде получено съгласие. Ако сте получили съгласие от даден потребител преди повече от 13 месеца или използвате версия на глобалния списък на доставчиците (GVL), в която Google все още не присъства, трябва да получите повторно съгласието на потребителя, в противен случай заявките за реклами ще бъдат пропускани и няма да се изпълняват.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 3.3 | Датата на последната актуализация на низа за прозрачност и съгласие е отпреди повече от 13 месеца. |
CMP трябва да изтрие стария низ за прозрачност и съгласие и да получи повторно съгласие. Очаква се да възникнат малко на брой подобни грешки, ако заявките за реклами са изпратени с изтекъл низ за прозрачност и съгласие, преди CMP да стане невалидна и да получи повторно съгласие от потребителя. Ако в приложението си използвате решенията на Google за управление на получаването на съгласие и SDK на UMP, проверете дали въпросният SDK е внедрен правилно дали |
| 4.1 | Низът за прозрачност и съгласие е генериран с версия на GVL, която не съдържа Google. | Получете повторно съгласие, като използвате текуща версия на глобалния списък на доставчиците (GVL). |
Глобален обхват и извънреден обхват
Следват проблемите, свързани с глобалния обхват и с извънредния обхват (Ad Manager, AdMob, AdSense). Няма да се показват реклами, ако низът за прозрачност и съгласие указва „извънреден обхват“ или „глобален обхват“.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 5.1 | Низът за прозрачност и съгласие разрешава извънредно съгласие. | Инструктирайте своята платформа за управление на съгласието (CMP) да премахне извънредните сигнали от низовете за прозрачност и съгласие. |
| 5.2 | Низ за прозрачност и съгласие с глобален обхват. | Инструктирайте своята CMP да актуализира низовете за прозрачност и съгласие, за да са конкретни за услугите. |
Ограничение на броя показвани реклами
Ще се показват ограничени реклами.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 6.1 | Версията на низа за прозрачност и съгласие е 1 или 1.1 (низ версия 1.0). |
CMP трябва да изпраща низове за версия 2.2 на TCF. |
Google ще обработва проблемите
Когато възникнат тези проблеми, Google ще вземе мерки за облекчаването им, когато е необходимо, и ще продължи с обичайната обработка за TCF.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 7.1 | Не е определена стойност или е зададена невалидна или неразбираема стойност за gdprApplies, но е налице валиден низ за прозрачност и съгласие. |
Неприложимо |
| 7.2 | Низът за прозрачност и съгласие е създаден с по-нова версия на GVL от текущата версия, която е известна на технологията за показване на реклами на Google. | Неприложимо |
| 7.3 | Някои цели, функции и/или доставчици са извън диапазона (неизвестни). | Неприложимо |
| 7.4 | Низът за прозрачност и съгласие има по-стара версия на tcf_policy_version от най-новия глобален списък на доставчиците (GVL). |
CMP трябва да изтрие по-стария низ за прозрачност и съгласие и да получи повторно съгласие чрез най-новия глобален списък на доставчиците (GVL). |
| 7.5 |
Заявка има |
Неприложимо |
| 7.6 | Невалиден код на държавата на издателя, но има съгласие за Цел 1. | Платформата за управление на съгласието (CMP) трябва да коригира грешките при внедряването на низа за прозрачност и съгласие. |
| 7.7 | Невалиден код на езика. | Платформата за управление на съгласието (CMP) трябва да коригира грешките при внедряването на низа за прозрачност и съгласие. |
| 7.8 | Полето за версията на низа за прозрачност и съгласие не е нито 1, нито 2. |
CMP трябва да коригира грешките при внедряването на низа за прозрачност и съгласие, като изисква ново съгласие, ако бъде открит невалиден низ. Ако в приложението си използвате решенията на Google за управление на получаването на съгласие и SDK на UMP, проверете дали въпросният SDK е внедрен правилно дали |
| 7.9 | Версията на низа за допълнително съгласие не е нито 1, нито 2. |
CMP трябва да зададе версията на низа за допълнително съгласие на 1 или 2. |
Проблеми с низа за допълнително съгласие
Когато възникнат тези проблеми, Google ще третира низа за допълнително съгласие като невалиден и няма да се вземат предвид допълнителни доставчици извън тези от низа за прозрачност и съгласие.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 8.1 | Низът за допълнително съгласие не използва разделителя на версията (~). |
CMP трябва да използва ~ като втори знак от низа за допълнително съгласие за отделяне на номера на версията от списъка с доставчици, дали съгласието си. |
| 8.2 | Низът за допълнително съгласие съдържа списък с доставчици, който не спазва очакваното форматиране (списък с int64, разделен с "."). | CMP трябва да коригира грешките при внедряването на низа за допълнително съгласие. |
Сертифициране на CMP
Когато възникнат тези проблеми, Google ще опита да показва неперсонализирани реклами.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 9.1 | CMP с TCF, посочена в заявката, не е сертифицирана от Google. | CMP трябва да бъде сертифицирана от Google. |
Няма сигнали според TCF за заявките за реклами
Когато възникнат тези проблеми, Google ще опита да показва ограничени реклами.
| Грешка | Описание | Предложено действие |
|---|---|---|
| 10.1 |
Заявката е от ЕИП, Обединеното кралство или Швейцария, но не съдържа сигнали според TCF. |
Издателят трябва да се интегрира със CMP с TCF, която е сертифицирана от Google. |