Декодер строки GPP
Декодируйте строку согласия IAB GPP в браузере — заголовок, gpp_sid и каждую встроенную секцию, развёрнутые в читаемые поля. Строка остаётся на вашем устройстве.
Декодер строки GPP работает целиком в вашем браузере. Строка согласия, которую вы вставляете — и всё, во что она декодируется — остаётся на вашем устройстве и никогда не отправляется в CMP, на рекламный сервер или в ArrayKit.
Открыть декодер строки согласия TCF
Об инструменте Декодер GPP
Декодер строки GPP распаковывает строку согласия IAB Global Privacy Platform в нечто действительно читаемое. Вставьте закодированное значение из CMP, поля regs.gpp bid request OpenRTB или сохранённого cookie, и инструмент декодирует заголовок — версию GPP и список gpp_sid — плюс каждую встроенную секцию, от TCF Europe v2 до US Privacy (uspv1) и сигналов штатов США вроде usnat и usca. Каждая секция разворачивается в именованные поля вроде CmpId, purpose consents, opt-out продажи и флаги MSPA. Инструмент создан для ad-ops инженеров, privacy-команд и QA, которые отлаживают обвязку согласия по всему программатик-предложению. Всё декодирование работает на вашем устройстве — строка GPP, которую вы вставляете, никогда не отправляется в CMP, на рекламный сервер или на какой-либо эндпоинт.
Возможности
- Декодирует заголовок GPP — версию кодирования и список id секций gpp_sid
- Разворачивает каждую встроенную секцию: TCF Europe v2, TCF Canada, US Privacy (uspv1), usnat, usca и другие секции штатов США
- Показывает поля каждой секции по имени — CmpId, purpose consents, opt-out и флаги MSPA
- Читаемые и сырые JSON-виды, с копированием в один клик всего декода или отдельной секции
- Суммирует булевы битовые векторы как включённые индексы, чтобы длинные флаги согласия TCF оставались читаемыми
- Обрабатывает многосекционные строки и точно сообщает, где некорректная строка не декодируется
- Загружает пример строки GPP, чтобы вы сразу увидели форму декодированного вывода
- Работает целиком в вашем браузере — строка согласия никогда не покидает ваше устройство
Как использовать Декодер GPP
- Скопируйте строку GPP из вашего CMP, поля regs.gpp OpenRTB или сохранённого значения __gpp
- Вставьте её в поле ввода или нажмите «Пример», чтобы загрузить пример строки
- Прочитайте декодированный заголовок и поля каждой секции или переключитесь на JSON-вид
- Скопируйте полный декод или одну секцию, чтобы приложить к баг-репорту или тикету
Пример
Ввод
DBABTC~1YNN
Результат
header: { version: 1, gpp_sid: [6] }
uspv1: { Version: 1, Notice: "Y", OptOutSale: "N", LspaCovered: "N" }
Строка US Privacy (uspv1): уведомление дано, opt-out продажи нет, не покрыто LSPA.
Частые ошибки и устранение неполадок
- Декодер говорит, что значение «does not look like a GPP string». — Строки GPP начинаются с сегмента заголовка base64url (обычно 'DB…'). Голая строка TCF, начинающаяся с 'C', относится к декодеру строки согласия TCF.
- Ошибка «The number of sections does not match the header». — Вы, вероятно, вставили только заголовок или потеряли блок '~'. Скопируйте полную строку — заголовок плюс одна секция, разделённая '~', на каждый id в gpp_sid.
- Секция показывает меньше полей, чем вы ожидали. — Опциональные сегменты TCF, такие как ограничения издателя или vendors-disclosed, появляются только когда строка их несёт; их отсутствие ожидаемо, а не сбой декодирования.
- Вас интересует только сигнал штата США, а не TCF. — Список gpp_sid сообщает, какие секции присутствуют — читайте только карточку usnat или usca и игнорируйте остальную часть декода.
Часто задаваемые вопросы
- Что такое строка IAB GPP?
- Строка Global Privacy Platform (GPP) — это единое закодированное значение, которое упаковывает несколько сигналов приватности — TCF Europe, US Privacy и секции штатов США — за одним заголовком. Список gpp_sid в заголовке называет, какие секции внутри.
- Что такое gpp_sid в строке GPP?
- gpp_sid — это массив id секций в заголовке GPP. Каждый id соответствует секции — 2 это TCF EU v2, 6 это US Privacy, 7 это usnat, 8 это usca — сообщая декодеру, какие блоки следуют за заголовком.
- Какие секции GPP может читать этот декодер?
- Он декодирует заголовок плюс TCF Europe v2, TCF Canada v1, US Privacy (uspv1), национальную секцию США (usnat) и секции штатов США вроде usca, usva, usco и остальных, разворачивая каждую в именованные поля.
- Можно ли вставить сюда голую строку TCF или legacy US Privacy?
- Этот инструмент ожидает полную строку GPP с заголовком. Отдельная строка TCF, начинающаяся с 'C', или legacy-значение US Privacy должны идти в специальные декодеры TCF или US Privacy.
- Сообщает ли декодирование строки GPP, разрешён ли вендор?
- Нет. Декодер показывает, что кодирует строка — opt-out, purpose consents, флаги MSPA — но не судит, может ли конкретный вендор обрабатывать данные; это зависит от вашей политики и правил каждой секции.
- Где найти строку GPP для декодирования?
- Ищите в сохранённом значении CMP, поле regs.gpp bid request OpenRTB, cookie или записи localStorage __gpp или в gppString, возвращаемом вызовом getGPPData API CMP.
Связанные инструменты
- Декодер TCF — Декодируйте строку согласия IAB TCF v2.2 в CMP, цели и вендоров.
- Декодер US Privacy — Декодируйте строку CCPA us_privacy — уведомление, opt-out и LSPA.
- Кодировщик TCF — Соберите строку согласия IAB TCF v2.2 из настроек CMP и id вендоров.
- Генератор OpenRTB — Соберите корректный bid request OpenRTB 2.5 или 2.6 из простой формы.
- Макросы VAST — Раскройте макросы VAST 4.x в трекинг-URL и посмотрите итоговый запрос.
- Валидатор sellers.json — Проверьте sellers.json по спецификации IAB в браузере.
Все инструменты ArrayKit