Сопоставление файлов cookie – это функция, которая позволяет сопоставлять файлы cookie (например, идентификатор пользователя, просматривавшего ваш веб-сайт) с соответствующим идентификатором пользователя Google, специфичным для участника торгов, и создавать списки пользователей, которые помогут вам сделать более эффективный выбор ставок. В этом руководстве описаны концепции, используемые в сопоставлении файлов cookie, а также различные рабочие процессы сопоставления файлов cookie и любые их варианты для определенных случаев использования.
Концепции
Что такое сопоставление файлов cookie?
Владельцы доменов обычно устанавливают для пользователей, просматривающих их сайт, содержимое файлов cookie, которые используются для идентификации пользователей в этом домене. Даже если два владельца домена в противном случае согласились бы обмениваться этими данными, модель безопасности интернет-браузеров не позволяет одному из них читать файлы cookie, установленные другим доменом.
В контексте цифровой рекламы Google идентифицирует пользователей с помощью файлов cookie, принадлежащих домену doubleclick.net
, а участники торгов, участвующие в торгах в реальном времени, могут иметь собственный домен, где они идентифицируют некоторый набор пользователей, которым они хотели бы показывать рекламу. Сопоставление файлов cookie позволяет системе назначения ставок сопоставлять свои файлы cookie с файлами Google, чтобы они могли определить, связан ли показ, отправленный в запросе ставки, с одним из целевых пользователей. Они получат либо свои собственные данные файлов cookie, либо идентификатор пользователя Google для конкретного участника торгов. это зашифрованная форма файла cookie doubleclick.net
в запросе ставки.
Служба сопоставления файлов cookie, описанная в этом руководстве, облегчает создание и поддержание связи между файлами cookie участника торгов и идентификатором пользователя Google, а также позволяет заполнять списки пользователей.
Таблицы совпадений
Таблицу соответствия можно использовать для сопоставления идентификатора или других данных из одного домена в другой. Участники торгов могут использовать Службу сопоставления файлов cookie для заполнения своих собственных таблиц соответствия, сопоставляя файлы cookie для данного пользователя с идентификатором пользователя Google, или для заполнения таблицы соответствия, размещенной в Google. Таблицы соответствия необходимы для того, чтобы приложение участника торгов могло получить доступ к данным cookie пользователя, которому показан показ.
Таблицы соответствия, размещенные в Google
Для упрощения обслуживания, снижения задержки и доступа к данным соответствия для пользователей в определенных регионах рекомендуется разрешить Google разместить вашу таблицу соответствия. Это позволяет вам указать веб-безопасную строку в кодировке Base64 (далее называемую размещенными данными соответствия), которая будет сопоставлена с идентификатором пользователя Google для данного пользователя. После установления соответствия его можно использовать следующими способами:
Назначение ставок в реальном времени . В последующих запросах ставок для показов, связанных с пользователем, Google отправит вам размещенные данные о соответствии, которые вы сопоставили с его идентификатором пользователя Google. Если ваша конечная точка назначения ставок настроена на использование протокола RTB Google, вы получите его в виде декодированных байтов через поле
BidRequest.hosted_match_data
. В реализации OpenRTB от GoogleBidRequest.user.buyeruid
вернет эти данные в виде безопасной для Интернета строки в кодировке Base64.Списки пользователей : списки пользователей могут быть заполнены либо идентификаторами пользователей Google, либо размещенными данными о совпадениях.
- Предварительный таргетинг . Вы можете настроить предварительный таргетинг таким образом, чтобы получать только запросы ставок, содержащие размещенные данные о совпадениях. Это можно использовать для исключения менее релевантных показов пользователям за пределами вашего пространства файлов cookie.
Списки пользователей
Списки пользователей можно создавать и управлять ими с помощью API назначения ставок в реальном времени . После создания эти списки можно заполнить с помощью рабочих процессов сопоставления файлов cookie, описанных ниже, или с помощью службы массовой загрузки .
Начиная
Чтобы начать работу с сопоставлением файлов cookie, вам необходимо обратиться к своему техническому менеджеру по работе с клиентами, который сможет включить определенные рабочие процессы и помочь вам настроить следующее:
- Идентификатор сети сопоставления файлов cookie (NID) : строковый идентификатор, однозначно идентифицирующий учетную запись участника торгов для сопоставления файлов cookie и других связанных операций.
- URL-адрес сопоставления файлов cookie : базовый URL-адрес конечной точки, которая будет принимать и обрабатывать входящие запросы в рамках рабочих процессов сопоставления файлов cookie. Участники торгов могут встраивать макросы в этот URL-адрес, чтобы контролировать порядок передаваемых ему параметров в рабочих процессах сопоставления файлов cookie.
- Тег сопоставления : тег, который необходимо разместить в браузере пользователя для рабочего процесса сопоставления файлов cookie, инициируемого системой назначения ставок. Его можно показывать вместе с рекламой или размещать на веб-ресурсах вне рекламы.
- URL-адрес отчета о сопоставлении файлов cookie (необязательно): в рабочем процессе однонаправленного сопоставления файлов cookie это необязательный URL-адрес, который можно указать для указания конечной точки, которая будет получать сведения об ошибке в случае сбоя сопоставления файлов cookie посредством перенаправления HTTP 302. По умолчанию ответы будут отправляться на этот URL-адрес только в том случае, если при операции сопоставления файлов cookie произошла ошибка, но участники торгов могут потребовать, чтобы перенаправление всегда отправлялось.
- URL-адрес функции Cookie Match Assist : для бирж, реализующих рабочий процесс Cookie Match Assist , это базовый URL-адрес конечной точки, предназначенной для ответа на входящие запросы.
- Квота для функции сопоставления файлов cookie . Для бирж, реализующих рабочий процесс поддержки сопоставления файлов cookie , это максимальное количество запросов, которые их URL-адрес сопоставления файлов cookie может получать каждую секунду. Это сделано для того, чтобы запросы CMA не перегружали серверы биржи запросами.
Макросы сопоставления файлов cookie
В любом из поддерживаемых рабочих процессов сопоставления файлов cookie к URL-адресу сопоставления файлов cookie участника торгов обычно добавляются параметры в негарантированном порядке. Участники торгов, которым требуется интеграция, требующая единообразного порядка параметров, могут размещать макросы в своем URL-адресе сопоставления файлов cookie, чтобы гарантировать их размещение.
Поддерживаемые макросы
Участники торгов могут при желании настроить свой URL-адрес сопоставления файлов cookie, включив в него один или несколько макросов в форме %%GOOGLE_<PARAM_NAME>%%
или %%GOOGLE_<PARAM_NAME>_PAIR%%
. Поддерживаемые макросы и их расширенные значения:
Макрос | Расширенное значение |
---|---|
GOOGLE_GID | GOOGLE_USER_ID |
GOOGLE_GID_PAIR | &google_gid= GOOGLE_USER_ID |
GOOGLE_CVER | COOKIE_VERSION_NUMBER |
GOOGLE_CVER_PAIR | &cver= COOKIE_VERSION_NUMBER |
GOOGLE_ERROR | ERROR_ID |
GOOGLE_ERROR_PAIR | &google_error= ERROR_ID |
GOOGLE_PUSH | PIXEL_MATCH_DATA |
GOOGLE_PUSH_PAIR | &google_push= PIXEL_MATCH_DATA |
GOOGLE_ALL_PARAMS | google_gid= GOOGLE_USER_ID &cver= COOKIE_VERSION_NUMBER &google_error= ERROR_ID |
Пример макроса
В системе назначения ставок предусмотрена интеграция сопоставления файлов cookie с конечной точкой, размещенной по https://user.bidder.com.cookies
, и для их реализации требуются предварительно определенные параметры, определенные участником торгов, в дополнение к параметрам сопоставления пикселей в следующем порядке: google_push
, google_gid
, google_cver
, и google_error
. Участник торгов может добиться этого, установив для своего URL-адреса сопоставления файлов cookie значение:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Когда позже Google отправит этому участнику аукциона запрос на сопоставление, он будет расширен примерно до следующего:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Рабочие процессы службы сопоставления файлов cookie
Служба сопоставления файлов cookie Google в настоящее время поддерживает три рабочих процесса для различных вариантов использования, которые описаны ниже.
По инициативе участника торгов: двунаправленное сопоставление файлов cookie
Двунаправленное сопоставление файлов cookie представляет собой рабочий процесс, инициируемый участниками торгов, при котором они помещают тег соответствия в браузер пользователя, который направляет его в Google. Этот рабочий процесс позволяет Google и системе назначения ставок заполнять таблицы соответствия. Ниже приведен простой пример этого рабочего процесса.
Шаг 1. Разместите тег соответствия.
Чтобы инициировать этот процесс, участник торгов должен разместить свой тег соответствия так, чтобы он отображался в браузере пользователя. Простой тег соответствия, который возвращает системе назначения ставок только идентификатор пользователя Google, может быть структурирован следующим образом:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Существуют дополнительные параметры, которые вы можете включить в тег соответствия для различных вариантов использования. Дополнительные сведения об этих параметрах см. в разделе Параметры URL-адреса тега сопоставления .
Шаг 2. Google отвечает перенаправлением, включая данные о совпадениях.
Тег соответствия приведет к тому, что служба сопоставления файлов cookie Google получит запрос от браузера пользователя, который выполнит перенаправление HTTP 302
на URL-адрес сопоставления файлов cookie участника торгов. Перенаправление будет включать параметры запроса, указывающие идентификатор пользователя Google и номер его версии в URL-адресе, а участник торгов также получит файлы cookie, включенные в заголовки запроса. На практике для URL-адреса сопоставления файлов cookie, указанного как https://ad.network.com/pixel
, URL-адрес перенаправления для простого тега соответствия, как показано выше, может выглядеть следующим образом:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Идентификатор пользователя Google, передаваемый через параметр google_gid
, представляет собой недополненную веб-безопасную строку в кодировке Base64 . Участникам торгов, решившим разместить таблицу соответствия, рекомендуется хранить точную строку, возвращаемую службой сопоставления файлов cookie. В последующих запросах ставок это будет соответствовать значениям, указанным через BidRequest.google_user_id
в протоколе RTB Google или BidRequest.user.id
в реализации OpenRTB Google.
Версия, указанная в google_cver
, указывает числовой номер версии идентификатора пользователя Google. Идентификатор пользователя Google для данного пользователя будет меняться нечасто, после чего он будет увеличиваться.
Если Google обнаружит ошибку при обработке вашего запроса на совпадение, вместо этого будет указан параметр google_error
.
Шаг 3. Система назначения ставок обрабатывает перенаправление и отправляет в ответ пиксель.
Участник торгов получает перенаправление на URL-адрес сопоставления файлов cookie, включая параметры, указанные им на первом этапе, и параметры, предоставленные Google на втором этапе. Кроме того, они также получат файлы cookie в заголовках HTTP. Если операция прошла успешно, участник торгов, у которого есть собственная таблица соответствия, сможет сопоставить свой файл cookie с идентификатором пользователя Google, включенным в ответ. Участникам торгов рекомендуется сохранять точную строку, возвращаемую службой сопоставления файлов cookie.
Если операция не удалась, участник торгов получит в перенаправлении параметр google_error
. Это числовое значение, соответствующее различным состояниям ошибки, которые идентифицируют конкретную возникшую ошибку. Подробнее о возможных значениях ошибок можно узнать здесь . Если вы получили сообщение об ошибке, вы можете попытаться сопоставить этого пользователя еще раз, разместив новый тег соответствия.
Участник торгов должен всегда отвечать, предоставляя изображение невидимого пикселя размером 1 x 1, или, в качестве альтернативы, возвращать ответ HTTP 204
No Content .
Схема рабочего процесса сопоставления файлов cookie
Этот рабочий процесс проиллюстрирован диаграммой ниже, где запросы и ответы представлены стрелками, а сопровождающие их элементы данных перечислены в круглых скобках.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=7&hl=ru)
Сопоставить параметры URL-адреса тега
Параметр | Описание |
---|---|
google_nid | Идентификатор сети (NID) для учетной записи участника торгов. Этот идентификатор можно получить через ресурс участников торгов . |
google_cm | Указывает службе сопоставления файлов cookie Google, что ей следует выполнить сопоставление файлов cookie. Значение параметра игнорируется и может быть опущено. |
google_sc | Этот параметр устарел. Устанавливает для пользователя файл cookie Google, если он отсутствует. Значение параметра игнорируется и может быть опущено. Пропуск параметра приведет к ошибке, если файл cookie не существует. |
google_no_sc | Этот параметр устарел. Это указывает службе сопоставления файлов cookie Google, что ей не следует устанавливать для пользователя файл cookie, если он отсутствует. Значение параметра игнорируется и может быть опущено. |
google_hm | Данные, которые система назначения ставок хочет сохранить в таблице соответствия, размещенной в Google. Значение представляет собой веб-безопасную строку в кодировке Base64 (заполнение необязательно). Необработанные данные должны иметь размер 40 байт или меньше. Например, |
google_redir | Строка в кодировке URL, которую может указать участник торгов, если он хочет поручить Google отправить перенаправление HTTP 302 на закодированный URL для этого тега соответствия. Это позволяет Google оказаться впереди всех в цепочке обращений к партнерам. Это приведет к ошибке, если указано без google_hm или с google_cm . |
google_ula | Строка, используемая для добавления пользователя в существующий список пользователей. Ожидаемый формат значения — userlistid[,timestamp] :
Этот параметр URL-адреса можно повторять, чтобы добавить пользователя в несколько списков. |
gdpr | Указывает, что на запрос распространяются ограничения GDPR на использование данных. Более подробную информацию см. ниже в разделе «Требования к согласию пользователей из ЕС» или «Влияние на соответствие файлов cookie» документации IAB TCF v2.0 для Авторизованных покупателей . Пример: |
gdpr_consent | Строка TC, представляющая согласие конечного пользователя. Более подробную информацию см. в разделе «Требования к согласию пользователей из ЕС» ниже или «Как будет передаваться строка TC?» в документации Авторизованных покупателей IAB TCF v2.0 . |
process_consent | Указывает, что участник торгов получил согласие конечного пользователя на использование данных, указанное в Политике согласия пользователей Google в ЕС . Если запрос не подпадает под действие Политики согласия пользователей ЕС или если в запросе доступны другие параметры согласия ( Пример: |
Помимо вышеуказанных параметров участники торгов могут указать свои собственные, которые будут добавлены в качестве параметров к URL-адресу перенаправления. Обратите внимание, что параметры, определенные системой назначения ставок с префиксом google_
, будут игнорироваться, поскольку они зарезервированы Google для будущей разработки, и сохранение порядка параметров не гарантируется. Тег соответствия, включающий параметры, определенные системой назначения ставок, может выглядеть так:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Параметры URL-адреса перенаправления
URL-адрес перенаправления создается на основе базового URL-адреса сопоставления файлов cookie, настроенного для учетной записи участника аукциона, включая параметры google_
и параметры, определяемые участником аукциона, в зависимости от тех, которые указаны в теге соответствия. Определены следующие параметры ответа google_
:
Параметр | Описание |
---|---|
google_gid | Идентификатор пользователя Google. Устанавливается, если в запросе указан google_cm и запрос прошел успешно. |
google_cver | Куки-версия. Устанавливается, если в запросе указан google_cm и запрос прошел успешно. |
google_error | Целочисленное значение, указывающее общую ошибку запроса. При получении это означает, что никакие операции не выполнялись и никакие другие параметры ответа
|
google_hm | Появляется только в том случае, если попытка записи в таблицу соответствия, размещенную в Google, не удалась. В этом случае его значением будет один из следующих кодов состояния:
|
google_ula | Статус операции добавления списка пользователей, повторяется, если в запросе указано несколько Пример: Операция
|
Примеры сценариев рабочего процесса сопоставления файлов cookie
Следующие сценарии описывают, как может выглядеть сопоставление файлов cookie для обычного пользователя, просматривающего веб-страницу.
Сценарий 1. Пользователь удаляет файлы cookie и просматривает сайт.
Джейн очищает кэш от всех файлов cookie. Затем они посещают домашнюю страницу exampleNews.com.
Вот что происходит:
- exampleNews.com отображает и вызывает рекламу Google (Менеджер рекламы).
- Поскольку рекламный блок имеет право на динамическое размещение, Google отправляет запросы ставок FinestDSP и другим участникам торгов через службу назначения ставок в реальном времени.
- Приложение участника торгов FinestDSP получает и обрабатывает запрос предложения и отправляет ответ на предложение.
- Google получает ответы на запросы ставок от участников торгов, включая ответ FinestDSP, в котором указано объявление с тегом соответствия (пикселем).
- FinestDSP выигрывает аукцион. Google передает Джейн рекламу FinestDSP и тег соответствия.
- Тег соответствия вызывает службу сопоставления файлов cookie Google, указывая параметры
google_nid
иgoogle_cm
. - Служба сопоставления файлов cookie считывает файлы cookie Google Джейн и отправляет браузеру Джейн перенаправление на URL-адрес сопоставления файлов cookie FinestDSP с установленными параметрами
google_user_id
иgoogle_cver
. - Браузер Джейн загружает перенаправление на URL-адрес соответствия файлов cookie FinestDSP.
- Конечная точка сопоставления файлов cookie FinestDSP обрабатывает запрос на перенаправление, который включает параметры URL-адреса, установленные Google, и их файлы cookie для Джейн в заголовках HTTP. FinestDSP теперь может хранить сопоставление своего файла cookie с
google_user_id
в своей таблице соответствия. - FinestDSP отвечает на перенаправление невидимым пикселем размером 1x1.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=7&hl=ru)
Сценарий 2: Пользователь с существующим сопоставлением
Через неделю после сценария 1 Джейн снова посещает сайт exampleNews.com. Теперь, когда на компьютере Джейн установлены файлы cookie системы назначения ставок и Менеджера рекламы, вот как работает сопоставление.
- Веб-страница отображается, в результате чего Google (Менеджер рекламы) запрашивает рекламу, которая будет отображаться на странице.
- Во время аукциона объявлений Google отправляет запрос ставки соответствующим участникам торгов, включая FinestDSP.
- FinestDSP получает запрос ставки, включая такие сигналы, как
google_user_id
. - FinestDSP ищет
google_user_id
в своей таблице соответствия и находит файл cookie, связанный с Джейн, который был создан неделей ранее (в сценарии 1). - На основе информации, связанной с файлом cookie, логика назначения ставок FinestDSP делает ставку за показ и выигрывает аукцион.
- Джейн может увидеть рекламу, соответствующую их интересам, на основе информации, которой обладает FinestDSP.
По инициативе участника торгов: однонаправленное сопоставление файлов cookie
Однонаправленное сопоставление файлов cookie похоже на двунаправленный рабочий процесс, за исключением того, что он изменен таким образом, что только Google размещает и заполняет таблицу соответствия. Это можно использовать в тех случаях, когда участнику торгов не разрешено размещать идентификаторы пользователей Google в собственной таблице соответствия. Чтобы использовать этот процесс, участники торгов должны разрешить Google размещать таблицу соответствия, больше не могут указывать google_cm
в запросах к службе сопоставления файлов cookie Google и, следовательно, не будут получать google_gid
для заполнения своей собственной таблицы соответствия. Как только Google установит соответствие для пользователя, участники торгов могут добавить его в списки пользователей, используя свои собственные данные cookie. Аналогичным образом, запросы ставок для этих пользователей будут исключать идентификатор пользователя Google, но включать размещенные данные соответствия. Простой пример пересмотренного рабочего процесса кратко изложен в следующих шагах.
Шаг 1. Разместите тег соответствия, направленный на URL-адрес сопоставления файлов cookie участника назначения ставок.
Чтобы инициировать этот процесс, участник торгов должен разместить тег соответствия так, чтобы он отображался в браузере пользователя. В отличие от рабочего процесса для пользователей, не проживающих в штате США с ограничениями конфиденциальности, тег соответствия должен направлять браузер пользователя на ваш URL-адрес сопоставления файлов cookie. Например, если URL-адрес сопоставления файлов cookie настроен как https://ad.network.com/pixel
, он будет выглядеть так:
<img src="https://ad.network.com/pixel" />
При загрузке в браузер пользователя он запрашивает пиксель из URL-адреса сопоставления файлов cookie участника торгов. Этот запрос будет содержать файл cookie в заголовке HTTP, который необходимо извлечь для следующего шага.
Шаг 2. Перенаправление на службу сопоставления файлов cookie Google.
Конечная точка сопоставления файлов cookie участника торгов должна перенаправляться в службу сопоставления файлов cookie Google, включая параметр google_hm
, заполненный веб-безопасными данными файлов cookie в кодировке Base64. URL-адрес перенаправления может выглядеть следующим образом:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Шаг 3. Браузер пользователя перенаправляется на службу сопоставления файлов cookie Google.
Google получит перенаправление, содержащее указанные вами параметры, а также файл cookie Google в заголовках HTTP.
Шаг 4. Google отображает пиксель при успешном или ошибочном перенаправлении, если указан URL отчета.
Если операция сопоставления файлов cookie прошла успешно или если для учетной записи участника аукциона не указан URL-адрес отчета о сопоставлении файлов cookie, Google по умолчанию будет использовать прозрачный пиксель размером 1x1, и на этом рабочий процесс завершится. Показы для этого пользователя в последующих запросах ставок будут включать размещенные данные соответствия участника торгов в BidRequest.hosted_match_data
для протокола Google или BidRequest.user.buyeruid
для реализации Google OpenRTB. Участники торгов также могут заполнять списки пользователей, используя указанные ими размещенные данные о совпадениях.
В противном случае, если произошла ошибка, Google отправит перенаправление на URL-адрес отчета о сопоставлении файлов cookie участника аукциона с указанием причины ошибки, указанной в параметре google_error
. Если URL-адрес отчета о сопоставлении файлов cookie участника торгов был https://ad.network.com/report
, URL-адрес перенаправления будет выглядеть так:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Шаг 5. Браузер пользователя перенаправляется на URL-адрес отчета о сопоставлении файлов cookie участника аукциона.
Браузер пользователя перенаправит на URL-адрес отчета о сопоставлении файлов cookie участника аукциона, включая причину ошибки (если таковая имеется), указанную Google в параметре google_error
. Подробнее об интерпретации кода ошибки см. в описании параметра .
Шаг 6. Система назначения ставок показывает прозрачный пиксель 1 x 1.
Участник торгов должен в ответ предоставить браузеру пользователя прозрачный пиксель размером 1x1.
Схема рабочего процесса сопоставления файлов cookie для пользователей из штатов США с ограничениями конфиденциальности
Рабочий процесс по умолчанию для пользователей в штатах США с ограничениями конфиденциальности показан на схеме ниже, где запросы и ответы представлены стрелкой, а сопровождающие их элементы данных перечислены в круглых скобках.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=7&hl=ru)
Параметры URL-адреса для перенаправления системы назначения ставок на службу сопоставления файлов cookie Google
Параметр | Описание |
---|---|
google_nid | Идентификатор сети (NID) для учетной записи участника торгов. Этот идентификатор можно получить через ресурс участников торгов . |
google_sc | Этот параметр устарел. Устанавливает для пользователя файл cookie Google, если он отсутствует. Значение параметра игнорируется и может быть опущено. Пропуск параметра приведет к ошибке, если файл cookie не существует. |
google_no_sc | Этот параметр устарел. Это указывает службе сопоставления файлов cookie Google, что ей не следует устанавливать для пользователя файл cookie, если он отсутствует. Значение параметра игнорируется и может быть опущено. |
google_hm | Содержит данные, которые система назначения ставок хочет сохранить в таблице соответствия, размещенной в Google. |
google_redir | Закодированный URL-адрес, который вы хотите, чтобы Google отправил перенаправление HTTP 302. Указанный URL-адрес будет получать перенаправления с параметром google_error как для ошибок, так и для успешных операций. |
google_ula | Строка, используемая для добавления пользователя в существующий список пользователей. Ожидаемый формат значения — userlistid[,timestamp] :
Этот параметр URL-адреса можно повторять, чтобы добавить пользователя в несколько списков. |
gdpr | Указывает, что на запрос распространяются ограничения GDPR на использование данных. Более подробную информацию см. ниже в разделе «Требования к согласию пользователей из ЕС» или «Влияние на соответствие файлов cookie» документации IAB TCF v2.0 для Авторизованных покупателей . Пример: |
gdpr_consent | Строка TC, представляющая согласие конечного пользователя. Более подробную информацию см. в разделе «Требования к согласию пользователей из ЕС» ниже или «Как будет передаваться строка TC?» в документации Авторизованных покупателей IAB TCF v2.0 . |
process_consent | Указывает, что участник торгов получил согласие конечного пользователя на использование данных, указанное в Политике согласия пользователей Google в ЕС . Если запрос не подпадает под действие Политики согласия пользователей ЕС или если в запросе доступны другие параметры согласия ( Пример: |
Параметры URL-адреса для перенаправления Google на URL-адрес отчета о сопоставлении файлов cookie участника аукциона
Параметр | Описание |
---|---|
google_error | Целочисленное значение, указывающее общую ошибку запроса. При получении это означает, что никакие операции не выполнялись и никакие другие параметры ответа
|
По инициативе Google: двунаправленное сопоставление пикселей
Двунаправленное сопоставление пикселей — это рабочий процесс службы сопоставления файлов cookie Google, при котором Google пытается сопоставить идентификатор пользователя Google с алгоритмически выбранным участником торгов, отличным от победителя аукциона с назначением ставок в реальном времени. При размещении объявления Google размещает тег соответствия, указывающий браузеру пользователя загрузить прозрачный пиксель из URL-адреса сопоставления файлов cookie выбранного участника торгов. Это позволит Google и системе назначения ставок заполнить таблицу соответствия данным пользователем. Ниже приведен простой пример этого рабочего процесса.
Шаг 1. Google размещает тег соответствия
Когда страница участвующего издателя загружается в браузере пользователя и рекламное место на этой странице заполняется Google, может быть размещен тег соответствия, который запрашивает пиксель у алгоритмически выбранного участника торгов. Тег Pixel Matching, размещенный Google, объединяет URL-адрес сопоставления файлов cookie участника торгов с дополнительными параметрами, которые он может использовать для заполнения своей таблицы соответствия. URL-адрес сопоставления файлов cookie, указанный как https://ad.network.com/pixel
, имеет следующую структуру:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Шаг 2. Участник торгов должен ответить перенаправлением на URL-адрес службы сопоставления файлов cookie Google.
Участники торгов, получающие запросы на сопоставление пикселей, должны в ответ перенаправить их в службу сопоставления файлов cookie Google, структура которой следующая:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Обратите внимание, что указанный выше URL-адрес перенаправления аналогичен URL-адресу, используемому в теге соответствия для рабочего процесса сопоставления файлов cookie, инициированного участником торгов . В Pixel Matching параметр google_cm
заменяется параметром google_push
, и его значение должно быть равно значению, предоставленному Google в запросе. Также, как и в рабочем процессе, инициированном участником торгов, можно указать дополнительные параметры для реализации дополнительных вариантов использования.
Шаг 3. Google обрабатывает перенаправление и отправляет в ответ пиксель.
Google регистрирует, что для пользователя было создано совпадение, и обрабатывает любые дополнительные операции, запрошенные через параметры запроса. Наконец, Google отвечает прозрачным пикселем 1x1.
Схема рабочего процесса сопоставления пикселей
Этот рабочий процесс проиллюстрирован диаграммой ниже, где запросы и ответы представлены стрелками, а сопровождающие их элементы данных перечислены в круглых скобках.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=7&hl=ru)
Параметры запроса тега соответствия Google
Параметр | Описание |
---|---|
google_gid | Идентификатор пользователя Google. Для пользователей за пределами штата США, где действуют ограничения конфиденциальности, это всегда будет указано в теге соответствия Google. |
google_cver | Версия cookie. Это всегда будет указано в теге соответствия Google. |
google_push | Указывает, что этот запрос инициирует рабочий процесс сопоставления пикселей. Значение должно быть возвращено через соответствующий параметр в ответе на перенаправление участника торгов. |
Параметры перенаправления с сопоставлением пикселей Bidder
Параметр | Описание |
---|---|
google_nid | Идентификатор сети (NID) для учетной записи участника торгов. Этот идентификатор можно получить через ресурс участников торгов . |
google_push | Указывает, что это перенаправление завершает рабочий процесс сопоставления пикселей. Здесь необходимо указать значение из соответствующего тега соответствия Google. |
google_hm | Содержит данные, которые система назначения ставок хочет сохранить в таблице соответствия, размещенной в Google. |
google_ula | Строка, используемая для добавления пользователя в существующий список пользователей. Ожидаемый формат значения — userlistid[,timestamp] :
Этот параметр URL-адреса можно повторять, чтобы добавить пользователя в несколько списков. |
По инициативе Google: однонаправленное сопоставление пикселей
Однонаправленное сопоставление пикселей отличается от двунаправленного рабочего процесса тем, что тег Match's Match Google не включает в себя параметр, указывающий идентификатор пользователя Google, но будет продолжать заполнять таблицу совпадения в Google. Это может использоваться в случаях, когда участнику претендента не разрешается размещать идентификаторы пользователей Google в своей собственной таблице соответствия. Простой пример пересмотренного рабочего процесса приведен в приведенных ниже шагах.
Шаг 1: Google помещает маги
Google размещает матч для алгоритмически выбранного участника. Тег соответствия включает в себя параметр google_push
. Вот пример:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Шаг 2: Пользовательский браузер запрашивает Pixel от URL -адреса Биддера
Браузер пользователя запрашивает пиксель из URL -адреса Cookie's Cookie's Cookie's Cookie, включая Cookie's Cookie's в заголовках HTTP.
Шаг 3: перенаправление в службу совпадения файлов cookie Google
Конечная точка Cookie's Cookie's Cookie, которая должна перенаправить в службу соответствия файлов cookie Google, включая параметр google_hm
, заполненный их веб-безопасными данными cookie Base64. URL перенаправления может выглядеть следующим образом:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Шаг 4: Браузер пользователя перенаправлен на службу соответствия файлов cookie Google
Google получит перенаправление, содержащее указанные вами параметры, в дополнение к Cookie Google в заголовках HTTP. Если операция была успешной, впечатления для этого пользователя в последующих запросах предложения будут включать в себя размещенные данные о совпадении участника в BidRequest.hosted_match_data
для протокола Google, или BidRequest.user.buyeruid
для реализации Google OpenRTB. Участники торгов также могут заполнять списки пользователей, используя указанные ими данные о размещенных соответствиях.
Наконец, Google возвращает прозрачный пиксель 1x1 в браузер пользователя.
Помощь в печенье
Открытие торгов позволяет биржам использовать инициированные претенденты , а Google инициировал рабочие процессы Cookie Cookie, чтобы соответствовать идентификатору пользователя Google с их файлом cookie. Cookie Match Assist (CMA) - дополнительная функция для обменов, которая позволяет им создавать столы со спинками со своими участниками.
Как работает помощь в печенье
При размещении рекламы Google Алгоритмически выбирает участие обмен и помещает ассистент Cookie Match Assist, который имеет следующую структуру:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Тег CMA Match от Google заставляет URL -адрес cookie Cookie для получения совпадения файла cookie Exchange.
- Конечная точка Cookie's Matchie Founding получает запрос, где его собственная служба совпадения cookie отвечает за сопоставление идентификатора пользователя с одним из его участников. На приведенной ниже диаграмме служба соответствия файлов cookie обмена отвечает на браузер пользователя с перенаправлением на одну из конечных точек своего участника.
- Участник получает запрос вместе с любыми параметрами, указанными в обмене, чтобы соответствовать идентификатору пользователя с их файлом cookie.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=7&hl=ru)
Ограничения
Частота CAP запросов на свежие матчи
Участники участников несут ответственность за ограничение количества звонков в службу соответствия файлов cookie для пользователей, которые имеют свежую запись в таблице матчей Google-Host. Запись в таблице размещенных матчей может считаться истекшим через 14 дней, после чего ее можно обновить.
Ответьте на все запросы на совпадение пикселей
Ожидается, что претенденты, использующие рабочую процесс сопоставления пикселей, отвечают на все входящие запросы на совпадение пикселей с ответом, включая параметр google_push
. Это позволяет Google обеспечивать соблюдение политики путем мониторинга использования. Если уровень ответов участника торгов упадет ниже 90%, Google закроет количество запросов на совпадение пикселей, отправленных на их счет.
Используйте https endpoints
Требуется, чтобы конечные точки, используемые во всех рабочих процессах, соответствующих соответствию файлов cookie, используют HTTPS.
При ответе на запрос на матч Pixel, отправленный вам по HTTPS, вы должны перенаправить в службу совпадения файлов cookie через HTTPS. Аналогичным образом, конечная точка помощи в печенье, которая перенаправляет участникам торгов, также должна использовать HTTPS. Если вы отправляете запросы в Google через HTTP чаще, чем один раз каждые 2 минуты, количество запросов на совпадение, отправляемых на вашу учетную запись, будет заброшенным.
Требования к согласию пользователя ЕС
Запросы на сопоставление cookie, которые подлежат политике согласия пользователя ЕС в ЕС, должны указывать на согласие конечного пользователя. Такие запросы необходимы, чтобы указать, что согласие было собрано с использованием одного из следующих способов:
- TCFV2: это включает параметры
gdpr
иgdpr_consent
. Для получения подробной информации обратитесь к документации по авторизованным покупателям IAB TCF v2.0 . -
process_consent
: объявление о том, что участник получения согласия пользователя получил необходимое согласие.
Примеры
Примеры ниже иллюстрируют, как использовать службу соответствия файлов cookie для достижения определенных целей. Обратите внимание, что, если не указано иное, предполагается, что поступающий пользователь не является из государства США с ограничениями конфиденциальности.
Заполнить таблицу матчей с участниками
Ударщик может использовать рабочую процесс Cookie -Matching для заполнения собственной таблицы совпадений, предоставляя только параметры google_nid
и google_cm
в их теге соответствия. Это может выглядеть:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Если URL -адрес для Cookie's Cookie's Satchie's Satchies установлен по адресу https://ad.network.com/pixel?id=1
, а операция по сопоставлению cookie успешна, Google отправляет в ответ на тег совпадения участника участника.
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Если операция по сопоставлению cookie не удастся, потому что у пользователя нет файла cookie Google, ответ будет:
https://ad.network.com/pixel?id=1&google_error=3
Код ошибки зависит от основной причины ошибки. Чтобы узнать больше о возможных кодах ошибок для рабочего процесса, соответствующего Cookie, см. Параметры Redirect URL -адреса .
Добавить в список пользователей.
Параметр google_ula
может быть указан в теге соответствия участника, чтобы добавить пользователя в список пользователей с данным идентификатором. Если таблица соответствия Google или участников, расположенной в размере для участников, имеет свежую запись для пользователя, участник участника может разместить параметры Match, включая параметры google_nid
и google_ula
, чтобы добавить пользователя в указанный список без инициирования полноценного рабочего процесса Cookie. Смотрите ограничения на вызов услуги по сопоставлению cookie для большего количества Deails. Соответствующий тег совпадения может выглядеть как:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Для успешного ответа, где URL -адрес для Cookie's Cookie's Cookie's Satchiess - https://ad.network.com/pixel
, URL -адрес Google Redirect будет:
https://ad.network.com/pixel?google_ula=12345,0
Если есть общая ошибка - например, нет никакого Google cookie для пользователя - URL -адрес redirect будет включать параметр google_error
:
-
https://ad.network.com/pixel?google_error=3
Если есть ошибка, специально касающаяся добавления пользователя в список, вы получите google_ula
в перенаправлении. В отличие от соответствующего параметра тега совпадения, это заменяет метку времени на код состояния, чтобы указать успех операции. Например, если запрос не удался, поскольку учетная запись участника торгов не имела доступа к указанному списку пользователей, URL -адрес redirect будет:
https://ad.network.com/pixel?google_ula=12345,2
Добавить в несколько списков пользователей
Участники могут указать, что пользователь должен быть добавлен в несколько списков пользователей, включив несколько параметров google_ula
в тег Match. На практике это может выглядеть как:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
Состояние операции для каждого списка пользователей аналогично сообщается через различные параметры google_ula
в перенаправлении:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
В приведенном выше перенаправлении мы видим, что операция была успешной для списка пользователей с ID 45678
, но не удалась для идентификатора списка пользователей 12345
, потому что участник торгов не имел разрешения на его доступ.
Перейдите через рабочий процесс Cookie Matching и добавьте в список пользователей
Чтобы выполнить сопоставление cookie и добавить пользователя в список пользователей в одном запросе, тег соответствия участника должен включать google_cm
и google_ula
:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
URL -адрес redirect, указанный Google, будет включать google_gid
, google_cver
и google_ula
. Это может выглядеть следующим образом:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Хранение совпадения в таблице матчей Google-Hosted
Если участник участника хочет сохранить данные своих файлов cookie в таблице сопоставления с Google, и не собирается хранить совпадение с идентификатором пользователя Google в их собственной таблице соответствия, их тег соответствия должен включать параметр google_hm
, где его значение должно быть сетью -safe base64-кодированная строка. Для пользователя, где некодируемые данные cookie's Data Foodisted Cookie number 1!
, кодированное значение будет Q29va2llIG51bWJlciAxIQ==
, который будет использоваться в тегке, как следующее:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Для успешного ответа, где URL-адреса Cookie's Cookie's Cookie's Matching- https://cookie-monster.com/pixel
, URL-адрес Google Redirect будет:
https://cookie-monster.com/pixel
Параметр google_gid
не находится в перенаправлении, потому что тег соответствия не включал google_cm
, а google_hm
не включен в успешные ответы. В будущих запросах на предложение для впечатлений для этого пользователя участник будет получать свои хостированные данные соответствия в BidRequest.hosted_match_data
за протокол Google RTB или BidRequest.user.buyeruid
для реализации Google OpenRTB.
Если участник вместо этого использовал метку совпадения, где значение google_hm
не было базовым 64-кодированием-например chocolate_chunk!
- URL перенаправления может выглядеть следующим образом:
https://cookie-monster.com/pixel?google_hm=2
Вышеуказанный URL -адрес rearect включает значение google_hm
2
, что позволяет предположить, что операция не удалась, поскольку значение не может быть декодировано.
Участники и Google-Hosted Match с списками пользователей
Если участник участника размещает свой собственный список использования в дополнение к списку пользователей Google-Hosted, и хочет, чтобы один тег соответствия соответствовал обеим таблицам и добавлению пользователя в определенный список пользователей, их тег Match должен включать google_cm
, google_hm
и google_ula
параметры. Если данные печенья торговли являются Cookie number 1!
, кодированное значение будет Q29va2llIG51bWJlciAxIQ==
, который будет создавать тег соответствия, например, следующее:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Для успешного ответа, где URL-адреса Cookie's Cookie's Cookie's Matching- https://cookie-monster.com/pixel
, URL-адрес Google Redirect будет выглядеть следующим образом:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
При получении перенаправления, участник торгов может соответствовать идентификатору пользователя Google, указанного в google_gid
с данными cookie в их таблице соответствия. Кроме того, они могут определить, что таблица матчей Google-Hosted и операции списка пользователей были успешными. Как следствие, любая предварительная предварительная деятельность, настроенная участниками, настраиваемой для нацеливания указанного идентификатора списка пользователей, теперь приведет к тому, что участник участника будет получать запросы на предложение на впечатления от пользователя. Аналогичным образом, в этих запросах заявки участник будет получать свои размещенные данные о соответствии в BidRequest.hosted_match_data
для протокола Google RTB, или BidRequest.user.buyeruid
для реализации Google OpenRTB.