Уведомление

Персонализированные советы по оптимизации, анализ аккаунта и выполнение настроек в обновленном разделе Моя страница Рекламы в приложении.

Как устранять неполадки с реализацией спецификации IAB EU TCF v2.2

16 мая 2023 г. организация IAB объявила о выходе спецификации IAB TCF версии 2.2. Поскольку компания Google является поставщиком, с 11 июля 2023 г. мы начнем принимать строки TC в соответствии со спецификацией TCF версии 2.2. При обработке запросов со строками TCF версии 2.2, отправленных ранее этой даты, возможны ошибки.
  • TCF версии 2.1. Google продолжит принимать строки, соответствующие этой версии спецификации. Однако мы считаем, что CMP-платформы должны следовать рекомендациям IAB в отношении ключевых этапов перехода на TCF версии 2.2.
  • Решения Google для управления запросами согласия. Мы планируем добавить к нашим решениям на вкладке "Конфиденциальность и сообщения" (в Менеджере рекламы, AdSense и AdMob) поддержку спецификации TCF версии 2.2 для запросов согласия по GDPR к началу ноября, в соответствии с новым крайним сроком, установленным IAB для CMP-платформ (20 ноября 2023 года).

Организация IAB Europe завершила подготовку версии 2.0 спецификации Transparency and Consent Framework, разработанной совместно с IAB Tech Lab и компаниями-участниками. В настоящее время Google полностью поддерживает эту версию.

Мы понимаем, что издателям понадобится время, чтобы исправить ошибки и отладить конфигурации, связанные с внедрением спецификации Transparency & Consent Framework версии 2.0, разработанной IAB Europe. Поэтому Google предоставит издателям льготный период продолжительностью 150 дней для решения возникших проблем, а также доступ к отчетам об обнаруженных ошибках.


Ниже описано, как устранять ошибки, которые могут возникнуть при реализации спецификации TCF версии 2.2. Статья включает следующие разделы:

 


Обновленные инструкции

Обновления

  • Напоминание о требовании TCF повторно получать согласие каждые 13 месяцев. 

    В соответствии с правилами в отношении спецификации TCF от организации IAB вам необходимо не реже одного раза в 13 месяцев (390 дней) напоминать пользователям о том, какое решение они приняли в отношении согласия. Если пользователь принял решение более 13 месяцев назад, строка TC становится недействительной и Google прекращает показывать рекламу такому лицу. Рекомендуем вам при помощи платформы для запросов согласия напоминать пользователям об их выборе до истечения этого 13-месячного срока.

  • Упразднена ошибка 3.2. Строки TC, обновленные в течение последних 13 месяцев, считаются действительными.

Устранение распространенных ошибок

Чтобы устранить наиболее распространенные ошибки, возникающие при реализации TCF версии 2.2 в Менеджере рекламы, 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 (из тестирования) или во время их внедрения компания Google не была указана как поставщик, получивший надлежащее согласие пользователя.

Ошибки 1.1, 1.2, 1.3. Важно проверить, возникают ли эти ошибки в значительном объеме трафика. Если да, возможно наличие проблемы на платформе для получения согласия (CMP). Убедитесь, что компания Google получает разрешение для необходимых целей и для нее выбраны основания "Получение согласия" и "Законный интерес" (идентификатор поставщика 755).

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

Согласно спецификациям IAB поставщики CMP могут кешировать строки согласия на 13 месяцев.

Некоторые поставщики CMP ранее хранили дату первого получения согласия и просто продлевали согласие. Так делать нельзя. Дата получения согласия должна обновляться для каждой новой строки согласия.
Проверьте, возвращает ли ваша платформа CMP вызовы из 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 должен происходить сразу после регистрации с текущими данными TC, даже если статус платформы CMP loading (ещё загружается) и в ней указаны неполные данные TC. Так у скрипта вызова будет доступ к своему зарегистрированному идентификатору прослушивателя (listenerId). Кроме того, при каждом изменении строки TC следует совершать обратный вызов, если он не удален с помощью RemoveEventListener.

Центр правил

В Центре правил издатели получают уведомления о том, соответствует ли их сайт или приложение требованиям Google по управлению согласием.

Отчет об ошибках

Если мы обнаружим в строке TC проблемы, связанные с сайтом или приложением издателя, он получит соответствующее уведомление в пользовательском интерфейсе продукта. Чтобы загрузить подробный отчет об ошибках, обнаруженных за последние семь дней, издатели могут нажать Скачать отчет об ошибках TCF на странице получения согласия пользователей из ЕС в своем аккаунте.

Этот отчет доступен, только если ошибки были обнаружены за последние семь дней.
Как перейти на страницу получения согласия пользователей и к отчету об ошибках TCF:
  • Для Менеджера рекламы: нажмите Администратор и затем Согласие пользователей из ЕС.
  • Для AdMob и AdSense: нажмите Управление блокировкой и затем Согласие пользователей из ЕС.

В отчете будет содержаться следующая информация о каждой обнаруженной ошибке:

  • Домен/MobileAppID: название неверно сконфигурированного сайта или мобильного приложения.
  • Путь к рекламному блоку: рекламный блок, связанный с ошибкой.
  • Код ошибки: код, назначенный ошибке.
  • Количество ошибок: число запросов с этой ошибкой за предыдущую неделю.
  • Дата последнего обнаружения: последняя дата, когда была обнаружена ошибка.

Чтобы узнать, как устранить найденные ошибки, воспользуйтесь этими таблицами. Найти информацию о необходимых действиях можно по коду ошибки.

Устранение ошибок

Чтобы помочь издателям исправить неверные конфигурации при внедрении IAB TCF версии 2.2, мы составили таблицы, в которых приводятся самые распространенные типы ошибок строк TC и рекомендации по их устранению.

В таблицах приведена информация об ошибках, возникающих на уровне запроса объявления, а также сведения о поведении системы.

Сценарии неполного согласия

Все три сценария имеют приоритет над ошибками конфигурации, даже если запрос вызывает несколько ошибок.

Сценарий Описание Рекомендуемое действие
1.1 У компании Google нет разрешения выступать в качестве поставщика, так как ей не предоставлено согласие или у нее нет законного интереса. Проверьте, что является причиной этого: намеренное отклонение пользователем компании Google как поставщика, ошибки реализации CMP или ограничения для издателей.
1.2 Нет согласия для цели 1 для стран ЕЭЗ и Великобритании.

Проверьте, намеренно ли пользователь отклонил согласие для цели 1 или это произошло из-за ошибок реализации CMP.

Издателям из Швейцарии, которые не запрашивают у пользователей согласие, следует убедиться, что поля PublisherCC и PurposeOneTreatment настроены правильно.
 

С декабря 2021 г. мы больше не будем проверять значение параметра PurposeOneTreatment для запросов объявлений из Германии в соответствии с принятым в этой стране Законом о защите данных в сфере телекоммуникаций и телемедиа.

1.3 Есть согласие для цели 1, но нет правовых оснований для обычных объявлений.

Проверьте, намеренно ли пользователь отклонил законные интересы для других целей или это произошло из-за ошибок реализации CMP.

Неправильная конфигурация

Запросы объявлений не выполняются, пока не устранена ошибка конфигурации.

Ошибка Описание Рекомендуемое действие
2.1a Тег или SDK не получает строку TC, так как установлен один из следующих статусов CMP: stub, loading или error.

Если вы вручную вызываете функцию для запроса объявлений, убедитесь, что в ответ на getTCData возвращается TCData.eventStatus = 'tcloaded' или 'cmpuishown' + 'useractioncomplete'. Такие ответы означают, что платформа CMP готова предоставить пользователю выбор относительно того, давать ли согласие.

Если вы не вызываете функцию для запроса объявлений вручную, то необходимо убедиться, что CMP реализует поддержку getTCData и возвращает TCData.eventStatus = 'tcloaded' или 'cmpuishown' + 'useractioncomplete'. Такие ответы означают, что согласие пользователя можно использовать в API.

2.1b

Выполняются оба условия:

  • Для CMP установлено значение &gdpr=1.
  • В запросе присутствует &gdpr_consent=, но строка TC пуста.
Попросите своего поставщика CMP проверить, что его API реализованы в соответствии с технической спецификацией IAB TCF.
2.0a

Невозможно обработать строку TC, так как она не закодирована по стандарту base64.

Пример: "2".

Поставщики CMP или издатели должны отправлять в параметрах gdpr_consent= только данные в формате base64.
2.0b

Невозможно обработать строку из-за ошибки декодирования.

Пример: строка включает неверное число бит.

Поставщик CMP должен исправить ошибки в реализации строки TC.
2.0c

Невозможно обработать строку из-за ошибки данных.

Пример: неверная временная метка, слишком длинный идентификатор поставщика.
 

Поставщик CMP должен исправить ошибки в реализации строки TC.

Ошибки в строке TC

Обнаружены проблемы в строке TC, связанной с запросом объявления. Запросы объявлений отклоняются и не выполняются.

Ошибка Описание Рекомендуемое действие
3.1 Недопустимый идентификатор CMP.

Проверьте, что платформа CMP утверждена организацией IAB и ее идентификатор в строках TC указан правильно.

Если платформа CMP поддерживалась во время формирования строки TC, но позднее была удалена организацией IAB, необходимо получить согласие с использованием новой поддерживаемой платформы.

3.2 Ошибка упразднена. Нет. Ранее она означала, что строка TC создана более 13 месяцев назад.

Требуется повторно получить согласие

Необходимо получить согласие пользователя. Если вы сделали это более 13 месяцев назад или с помощью версии глобального списка поставщиков (GVL), в которой ещё нет Google, то потребуется получить согласие повторно. Без этого запросы объявлений выполняться не будут.

Ошибка Описание Рекомендуемое действие
3.3 Строка TC последний раз обновлена более 13 месяцев назад.

Поставщик CMP должен удалить устаревшую строку TC и заново получить согласие.

Небольшое количество таких ошибок возникнет, если запросы объявлений, содержащие строку ТС с истекшим сроком действия, будут передаваться до того, как CMP аннулирует и заново получит согласие пользователя.

Если в вашем приложении используются UMP SDK и решение Google для управления запросами согласия, проверьте, что UMP SDK реализован корректно, а при каждом запуске приложения выполняется вызов requestConsentInfoUpdate.

4.1 Строка TC сформирована с использованием версии глобального списка поставщиков, в которой ещё нет Google. Заново получите согласие пользователя с помощью текущей версии GVL.

Глобальная и внешняя области действия

Проблемы, связанные с глобальной или внешней областью действия юридического основания (Менеджер рекламы, AdMob, AdSense). Показ рекламы прекратится, если в строке TC будет указано "Out-of-band" (внешняя область действия) или "Global scope" (глобальная область действия).

Ошибка Описание Рекомендуемое действие
5.1 Строка TC допускает внешнее согласие. Попросите своего поставщика CMP удалить сигналы внешнего согласия из строк TC.
5.2 Строка TC с глобальной областью действия. Попросите своего поставщика CMP изменить строки TC таким образом, чтобы они относились к определенному сервису.

Ограниченный показ рекламы

Ограниченный показ рекламы доступен.

Ошибка Описание Рекомендуемое действие
6.1 Версия строки TC: 1 или 1.1 (строка версии 1.0). Платформа CMP должна отправлять строки TCF версии 2.2.

Ошибки, устраняемые Google

Если обнаружены ошибки этого типа, компания Google сама при необходимости займется устранением проблемы и перейдет к обычной обработке TCF.

Ошибка Описание Рекомендуемое действие
7.1 Значение gdprApplies не определено, либо задано недопустимое или недешифруемое значение, но при этом указана допустимая строка TC.
7.2 При формировании строки TC использовался глобальный список поставщиков более новой версии, чем текущая версия, известная рекламной технологии Google.
7.3 Некоторые задачи, функции и/или поставщики неизвестны.
7.4 В строке TC параметр tcf_policy_version указывает на более раннюю версию, чем последняя версия глобального списка поставщиков. Поставщик CMP должен удалить более раннюю версию строки TC и повторно получить согласие, используя новейший список.
7.5

В запросе есть параметр &gdpr=1, но параметр &gdpr_consent в URL запроса отсутствует.

7.6 Недопустимый код страны для издателя, но при этом есть согласие для цели 1. Поставщик CMP должен исправить ошибки в реализации строки TC.
7.7 Недопустимый код языка. Поставщик CMP должен исправить ошибки в реализации строки TC.
7.8 В поле версии строки TC не установлено ни значение 1, ни значение 2.

Если обнаружена недействительная строка TC, то поставщик CMP должен исправить ошибки в реализации строки TC, запросив согласие заново.

Если в вашем приложении используются UMP SDK и решение Google для управления запросами согласия, проверьте, что UMP SDK реализован корректно, а при каждом запуске приложения выполняется вызов requestConsentInfoUpdate.

7.9 Для версии строки дополнительного согласия не задано значение 1 или 2. Платформа CMP должна установить для версии строки дополнительного согласия значение 1 или 2.

Ошибки в строке дополнительного согласия

Если обнаружены ошибки этого типа, Google будет считать строку дополнительного согласия (AC) недопустимой и рассматриваться будут только поставщики, поддерживающие строку TC.

Ошибка Описание Рекомендуемое действие
8.1 В строке AC не используется разделитель версии (~). В качестве второго элемента строки AC должен использоваться символ "~"; он разделяет номер версии и список разрешенных поставщиков.
8.2 Список поставщиков в строке AC отформатирован неправильно (в списке должны содержаться 64-разрядные целые числа, разделенные точкой "."). Поставщик CMP должен исправить ошибки в реализации строки AC.

 

Эта информация оказалась полезной?

Как можно улучшить эту статью?
true
Show your support to promote DEI in Gaming by turning intentions into action!

Check out the newly launched Diversity in Gaming website, where you can find video stories and written pledges from global gaming developers. This campaign centers on 3 pillars: diverse teams, diverse games and diverse audiences showing how diversity is not just good for gamers, but for business as well. Show your support by taking the pledge to promote DEI in Gaming and share it on social!

Learn More

Поиск
Очистить поле поиска
Закрыть поиск
Приложения Google
Главное меню