Из этой статьи вы узнаете, как перейти к собственным идентификаторам издателей для сайтов и удалить связанные данные о таргетинге объявлений.
Как посмотреть собственные идентификаторы издателей
К собственным идентификаторам издателей для сайтов можно перейти непосредственно из раздела собственных файлов 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);
}Как удалить пользовательские данные, связанные с собственными идентификаторами издателей для сайтов
Издатели могут запросить, чтобы из внутренних систем хранения Google, которые задействованы в таргетинге объявлений, были удалены пользовательские данные, связанные с определенным файлом cookie __gpi.
Чтобы запросить удаление данных, связанных с компонентом UID того или иного файла cookie __gpi, издателю необходимо отправить HTTP-запрос следующего вида:
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
Ожидаемый ответ
Если есть приведенные ниже три параметра и для них заданы действительные значения, будет возвращен код статуса HTTP-ответа 200, указывающий на то, что запрос был выполнен успешно.
- id – шестнадцатеричное значение из 16 символов.
- iu – действительный код сети Менеджера рекламы.
- idtype – параметр со значением sco, указывает на то, что речь идет о собственном идентификаторе издателя для сайтов.
Если у запроса недопустимый формат, будет возвращен код статуса HTTP-ответа 400.
