Из этой статьи вы узнаете, как перейти к собственным идентификаторам издателей для сайтов и удалить связанные данные о таргетинге объявлений.
Как посмотреть собственные идентификаторы издателей
К собственным идентификаторам издателей для сайтов можно перейти непосредственно из раздела собственных файлов 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 стерт, будет предпринята попытка подставить в него новые значения.
Помимо вариантов __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 для удаления данных. Доступно два варианта. Вариант 1 поддерживает фреймворк IAB для запросов на удаление данных.
Вариант 1 (поддерживает фреймворк IAB для запросов на удаление данных)
dsrdelete.json.dsrdelete.json и разместите его в корневом каталоге домена. Подробнее о файле dsrdelete.json и его обязательных и необязательных полях можно узнать из документации IAB.Как отправить запрос
Обязательные атрибуты
В таблице ниже перечислены обязательные атрибуты запроса на удаление данных. Подробную информацию о параметрах, примеры кода и другие требования можно найти на странице IAB Data Deletion Request Framework.
| Атрибут | Описание | Пример значения |
|---|---|---|
| sub.identifierType | Тип идентификатора | pfpid_domain |
| sub.identifierValue | Идентификатор, для которого вы запрашиваете удаление | 0000128ff97be809 |
| sub.identifierFormat | Формат идентификатора пользователя | Открытый текст |
Вариант 2 (поддержка прекращена)
Чтобы запросить удаление данных, связанных с компонентом UID того или иного файла cookie __gpi, издателю необходимо отправить HTTPS-запрос следующего вида:
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, перейдите по следующей ссылке:
Обязательные атрибуты
В таблице ниже перечислены обязательные атрибуты запроса на удаление данных IDFV. Подробную информацию о параметрах, примеры кода и другие требования можно найти на сайте IAB Data Deletion Request Framework.
| Атрибут | Описание |
Пример значения |
|---|---|---|
| sub.identifierType | Тип идентификатора | idfv |
| sub.identifierValue | Идентификатор, для которого вы запрашиваете удаление | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Формат идентификатора пользователя | Открытый текст |