INTEGRITY Документация

Google Consent Mode

Контекст

Google Consent Mode ↗ используется инструментами Google для управления согласием на использование личных данных и персональной информации (PII). Zaraz автоматически поддерживает Consent Mode v2, а также предоставляет ручную поддержку Consent Mode v1.

Вы также можете использовать Google Analytics и Google Ads без файлов cookie, выбрав Разрешения и отключение Доступ к клиентскому хранилищу ключ-значение.


Consent Mode v2 определяет статус согласия «default», который обычно устанавливается в начале сессии, и статус «updated», который устанавливается, когда посетитель настраивает свои предпочтения по согласию. Consent Mode v2 включается автоматически, как только становятся доступны нужные свойства события, поэтому менять настройки в самих инструментах или их действиях не требуется.

Часто сайтам нужно задать статус согласия по умолчанию, который отклоняет все категории. Это можно сделать вообще без кода, включив Настройка состояния Google Consent Mode v2 в Zaraz Настройки страницу.

Если это не то, что нужно вашему сайту, и вы хотите задать статус согласия по умолчанию более детально, используйте зарезервированную google_consent_default свойство:

zaraz.set("google_consent_default",  {
  'ad_storage': 'denied',
  'ad_user_data': 'denied',
  'ad_personalization': 'denied',
  'analytics_storage': 'denied'
})

После выполнения указанного кода статус согласия будет сохранён в localStorage и будет включаться в каждое последующее событие Zaraz.

Обратите внимание, что код нужно добавить в HTML-код сайта, обычно внутри <script> элемент внутри <body> элемент. Это не рекомендуется чтобы подключить его через инструмент Custom HTML в Zaraz, так как настройки согласия должны быть заданы до того, как Zaraz загрузит любой другой инструмент.

После того как пользователь укажет свои настройки согласия, вы можете задать новый статус с помощью зарезервированного google_consent_update свойство. Если вы используете Zaraz Consent Management Platform, вы можете использовать Событие Consent Choices Updated чтобы понимать, когда нужно обновлять статус Google Consent.

zaraz.set("google_consent_update",  {
  'ad_storage': 'granted',
  'ad_user_data': 'denied',
  'ad_personalization': 'granted',
  'analytics_storage': 'denied'
})

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

Убедиться, что Zaraz обрабатывает настройки Consent Mode, можно, включив Zaraz Debugger. Серверные запросы к Google Analytics и Google Ads должны включать gcd параметр.

В ноябре 2023 года Google объявил Consent Mode v1 устаревшей версией, однако поддержка сохраняется. Её интеграция с Zaraz сложнее, чем интеграция с Consent Mode v2. Если вы уже используете Consent Mode v2, переходить на Consent Mode v1 не требуется.

Consent Mode v1 настраивается вручную для каждого инструмента. Перейдите на страницу инструмента и выберите Настройки. Выберите Add field, и выберите Consent Mode из выпадающего меню. Затем выберите Подтверждение.

Значение Consent Mode должно соответствовать формату, определённому Google: строке из четырёх символов, начинающейся с G1, за которым следуют два символа, обозначающих статус согласия для Marketing и Analytics. 1 означает согласие, 0 означает отсутствие согласия, а - означает, что согласие не требовалось. Например, если установить значение G111 означает, что пользователь предоставил согласие как для Marketing, так и для Analytics, G101 означает согласие только для Analytics, а G10- означает отсутствие согласия для Marketing, но согласие для Analytics не требуется.

Поскольку значение Consent Mode может отличаться в зависимости от пользователя или сессии, рекомендуется задавать его динамически с помощью zaraz.set в коде вашего сайта. Например, используйте zaraz.set("google_consent_v1", "G100") при загрузке страницы, а zaraz.set("google_consent_v1", "G111") после того как пользователь предоставил согласие на Marketing и Analytics. В Consent Mode поле и выберите + символ, выберите Свойство события, и введите google_consent_v1 в качестве имени свойства. После этого Zaraz будет использовать последнее значение google_consent_v1 Event Property в качестве строки Consent Mode.

Поддерживаемые инструменты

Google Analytics 4 и Google Ads поддерживают Consent Mode v1 и v2.