Из этой статьи вы узнаете, как найти собственные идентификаторы издателей сайтов и удалить связанные данные о таргетинге объявлений.
Как посмотреть собственные идентификаторы издателей
Посмотреть собственные идентификаторы издателей сайтов можно непосредственно в собственных файлах cookie, заданных с помощью JavaScript в домене издателя. Идентификатор, предназначенный для внешнего использования нашими издателями и партнерами, содержится в файле cookie __gpi. Второй файл cookie (__gads) не предназначен для этого и не может использоваться для целей персонализации.
Значение файла cookie __gpi представлено в следующем виде:
UID=<уникальный идентификатор пользователя>:T=<временная метка создания (Unix) в секундах>:RT=<временная метка обновления (Unix) в секундах>:S=<подпись для аутентификации, созданная Google>
Пример значения __gpi:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
Для внешнего использования издателями и партнерами предназначены только значения идентификатора (UID) и временной метки (T):
- UID – в данный момент это строка из 16 шестнадцатеричных символов, но эту длину не следует считать постоянной, со временем она может измениться.
- T – это целое число в десятичной системе счисления, означающее временную метку создания идентификатора (эпоха Unix).
Остальные два компонента содержат внутреннюю информацию о реализации, которая может меняться, поэтому полагаться на них не следует.
Максимальный срок хранения файлов cookie __gpi и __gads в настоящее время составляет 13 месяцев, но в некоторых случаях из-за заданных в браузере ограничений они удаляются раньше. Так происходит, например, при использовании интеллектуальной защиты от слежения (ITP) в браузере Safari для файлов cookie, настроенных с помощью JavaScript. Если файл cookie будет удален, Google попытается заново заполнить его новыми значениями (однако это может быть запрещено).
Помимо __gpi и __gads, в наборе может быть файл cookie __gpi_opt_out с информацией об отказе пользователя от персонализации рекламы. Если в этом файле указано "1", значит пользователь при помощи настроек рекламы в Google отключил персонализацию объявлений Google в текущем домене.
Перед обращением к этим файлам cookie убедитесь, что их использование соответствует всем законам, директивам, регламентам и правилам, которые действуют в отношении конфиденциальности и защиты данных во всех ваших юрисдикциях.
Пример получения идентификатора с помощью JavaScript
/**
* Возвращает собственный идентификатор издателя и временную метку.
* @returns {{UID: string|undefined, T: string|undefined}} Объект,
* содержащий строки идентификатора UID и временной метки, если они есть.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Получает пару "ключ-значение" из файла cookie
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Проводит парсинг с помощью регулярного выражения
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Возвращает извлеченные значения
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Пример использования
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // Значение идентификатора
console.log(parsedValues['T']); // Временная метка создания
} catch (error) {
console.error(error.message);
}Как удалить пользовательские данные, связанные с собственными идентификаторами издателей для сайтов
Издатели могут запросить удаление пользовательских данных, связанных с определенным собственным идентификатором. Такой запрос в отношении одного идентификатора можно передать через API для удаления данных. Доступно два варианта, первый из них – через фреймворк IAB для запросов на удаление данных.
Вариант 1 (через фреймворк IAB для запросов на удаление данных)
dsrdelete.json.dsrdelete.json и разместите его в корневом каталоге домена. Подробнее о файле dsrdelete.json и его обязательных и необязательных полях можно узнать из документации IAB.Как отправить запрос
Обязательные атрибуты
В таблице ниже перечислены обязательные атрибуты запроса на удаление данных. Подробную информацию о параметрах, примеры кода и другие требования можно найти на странице IAB Data Deletion Request Framework.
| Атрибут | Описание | Пример значения |
|---|---|---|
| sub.identifierType | Тип идентификатора | sco_domain |
| sub.identifierValue | Идентификатор, для которого вы запрашиваете удаление | 0000128ff97be809 |
| sub.identifierFormat | Формат идентификатора пользователя | plaintext |
Вариант 2 (поддержка прекращена)
Для запроса на удаление данных, связанных с компонентом UID того или иного файла cookie __gpi, используйте следующий URL:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
В запросе используются следующие значения:
- id – значение идентификатора, которое представляет собой строку из 16 шестнадцатеричных символов. Это компонент UID, который извлекается описанным выше способом.
- iu – это код сети издателя в Менеджере рекламы.
- idtype – тип идентификатора. В случае с собственными идентификаторами издателей для сайтов это должно быть значение sco, которое указывает на то, что область действия файла cookie – сайты.
Пример:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Ожидаемый ответ
Если все три параметра ниже получены и имеют действительные значения, сервер отправит HTTPS-ответ с кодом статуса 200, указывающий на то, что запрос был выполнен успешно.
- id – строка из 16 шестнадцатеричных символов.
- iu – действительный код сети Менеджера рекламы.
- idtype – параметр со значением sco, указывает на то, что речь идет о собственном идентификаторе издателя для сайтов.
Если у запроса недопустимый формат, сервер отправит HTTPS-ответ с кодом статуса 400.
Удаление пользовательских данных, связанных с IDFV (iOS 14 и выше)
Издатели Менеджера рекламы могут запросить удаление пользовательских данных, связанных с определенным идентификатором для поставщика (IDFV). Такой запрос в отношении одного идентификатора можно передать через API для удаления данных. API для удаления данных соответствует требованиям фреймворка IAB для запросов на удаление данных.
Прежде чем отправлять запрос на удаление данных, свяжитесь с менеджером аккаунта и попросите добавить вас в наш реестр пользователей фреймворка IAB. Вам потребуется указать домен, на котором будет размещен файл dsrdelete.json.
После регистрации домена в Google создайте файл dsrdelete.json и разместите его в корневом каталоге домена. Подробнее о файле dsrdelete.json и его обязательных и необязательных полях можно узнать из документации IAB.
Как отправить запрос на удаление данных IDFV
Для запроса на удаление данных IDFV используйте следующий URL:
Обязательные атрибуты
В таблице ниже перечислены обязательные атрибуты запроса на удаление данных IDFV. Подробную информацию о параметрах, примеры кода и другие требования можно найти на сайте IAB Data Deletion Request Framework.
| Атрибут | Описание |
Пример значения |
|---|---|---|
| sub.identifierType | Тип идентификатора | ifv |
| sub.identifierValue | Идентификатор, для которого вы запрашиваете удаление | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Формат идентификатора пользователя | plaintext |