Сопоставление файлов cookie

Функция сопоставления файлов cookie (Cookie Matching) позволяет сопоставлять файлы cookie (например, идентификатор пользователя, просматривавшего ваш веб-сайт) с соответствующим идентификатором пользователя Google, специфичным для конкретного участника торгов, и создавать списки пользователей, которые помогут вам принимать более эффективные решения при назначении ставок. В этом руководстве описываются концепции, используемые в сопоставлении файлов cookie (Cookie Matching), а также различные рабочие процессы сопоставления файлов 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 User ID для данного пользователя. После установления соответствия его можно использовать следующими способами:

• Торги в режиме реального времени : в последующих запросах ставок на показы, связанные с пользователем, Google отправит вам размещённые данные о сопоставлении, которые вы сопоставили с его идентификатором пользователя Google. Google укажет BidRequest.user.buyeruid как веб-безопасную строку в кодировке base64.

  Ключевой момент: для пользователей, которые были обнаружены в штатах США с ограничениями конфиденциальности, идентификатор пользователя Google не будет указан в запросе ставки. Вы по-прежнему будете получать данные о размещенных совпадениях, которые можно использовать для формирования вашей логики ставок.
  Внимание: По умолчанию значение buyeruid представляет собой веб-безопасную строку в кодировке base64 и должно быть эквивалентно значению, которое вы отправляете в google_hm . Если вы получаете неожиданные значения buyeruid в запросе ставки, это может означать, что вы отправляете незакодированное значение google_hm . Чтобы отключить кодировку в запросе ставки, обратитесь к своему техническому менеджеру по работе с клиентами.

• Списки пользователей : списки пользователей могут быть заполнены либо идентификаторами пользователей Google, либо размещенными данными о совпадениях.

  Внимание: Для пользователей, определённых как жители штатов США с ограничениями конфиденциальности, использование идентификатора пользователя Google для заполнения списков пользователей устарело и в конечном итоге будет прекращено. Участникам торгов рекомендуется заполнять списки пользователей, используя свои данные о совпадениях для этих пользователей.
• Предварительный таргетинг : вы можете настроить предварительный таргетинг таким образом, чтобы получать только запросы ставок, содержащие данные о сопоставлении, размещенные на сервере. Это можно использовать для исключения нерелевантных показов для пользователей за пределами вашего пространства cookie.

Списки пользователей

Списки пользователей можно создавать и управлять ими с помощью API торгов в реальном времени . После создания эти списки можно заполнять с помощью следующих рабочих процессов сопоставления файлов cookie или через службу массовой загрузки .

Ключевой момент: списки пользователей могут заполняться как идентификаторами пользователей Google, так и данными о совпадениях, размещенными на хостинге, и их смешивание возможно. Обратите внимание, что при указании последних они должны быть уже добавлены в таблицу соответствий, размещенную на хостинге Google. Для пользователей из штатов США с ограничениями конфиденциальности необходимо использовать модифицированные рабочие процессы, которые добавляют в списки пользователей данные о совпадениях, размещенные на хостинге, а не идентификаторы пользователей Google.

Начиная

Чтобы начать работу с функцией сопоставления файлов 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 Match Assist : для бирж, реализующих рабочий процесс Cookie Match Assist , это максимальное количество запросов, которые их URL-адрес для сопоставления файлов cookie может получать каждую секунду. Это сделано для того, чтобы предотвратить перегрузку серверов биржи запросами CMA.

Примечание: Авторизованные покупатели могут просматривать NID и URL-адрес сопоставления файлов cookie, настроенные для их учетных записей с помощью ресурса Bidders .

Макросы сопоставления файлов 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

Примечание: параметр google_error не заполняется тегом сопоставления Google для рабочего процесса сопоставления пикселей и поэтому исключается.

Рабочие процессы службы сопоставления файлов cookie

Служба сопоставления файлов cookie Google поддерживает следующие три рабочих процесса.

Инициировано участником торгов: двунаправленное сопоставление файлов cookie

Двунаправленное сопоставление файлов cookie — это рабочий процесс, инициируемый участником торгов, который помещает тег сопоставления в браузер пользователя, направляющий его в Google. Этот рабочий процесс позволяет как Google, так и участнику торгов заполнять таблицы сопоставления. Ниже приведён пример такого рабочего процесса.

Шаг 1: Разместите метку соответствия

Чтобы инициировать этот поток, участник торгов должен разместить свой тег сопоставления таким образом, чтобы он отображался в браузере пользователя. Тег сопоставления, который возвращает участнику торгов только идентификатор пользователя Google, может быть структурирован следующим образом:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />

Примечание: BIDDER_ACCOUNT_NID следует заменить на NID учётной записи участника торгов. Этот идентификатор предоставляется техническими менеджерами по работе с клиентами при настройке сопоставления файлов cookie для учётной записи участника торгов. Его также можно просмотреть с помощью ресурса Bidders API Real-time Bidding.

В тег соответствия можно включить дополнительные параметры для различных вариантов использования. Подробнее об этих параметрах см. в разделе «Параметры 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.user.id .

Версия, указанная в google_cver указывает числовой номер версии идентификатора пользователя Google. Идентификатор пользователя Google для данного пользователя будет меняться редко, после чего будет увеличиваться на единицу.

Если Google обнаружит ошибку при обработке вашего запроса на сопоставление, вместо этого будет указан параметр google_error .

Шаг 3: Участник торгов обрабатывает перенаправление и отвечает пикселем

Участник торгов получает перенаправление на URL-адрес для сопоставления cookie-файлов, включающий параметры, указанные на первом этапе, и параметры, предоставленные Google на втором этапе. Кроме того, он получит свой cookie-файл в HTTP-заголовках. В случае успеха участник торгов, разместивший собственную таблицу соответствий, может сопоставить свой cookie-файл с идентификатором пользователя Google, указанным в ответе. Участникам торгов рекомендуется сохранять точную строку, возвращаемую службой сопоставления cookie-файлов.

Если операция не удалась, участник торгов получит параметр google_error при перенаправлении. Это числовое значение, соответствующее различным состояниям ошибки, которые идентифицируют конкретную возникшую ошибку. Подробнее о возможных значениях ошибок см. в описании параметра URL google_error . Если вы получили сообщение об ошибке, вы можете повторить попытку сопоставления для этого пользователя, разместив новый тег сопоставления.

Участник торгов всегда должен отвечать, предоставляя невидимое изображение размером 1x1 пиксель или, в качестве альтернативы, возвращая ответ HTTP 204 No Content .

Диаграмма рабочего процесса сопоставления файлов cookie

Этот рабочий процесс проиллюстрирован на следующей диаграмме, где запросы и ответы обозначены стрелкой, а сопровождающие их элементы данных перечислены в скобках.

Параметры 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 байт. Например, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u .
google_redir	URL-кодированная строка, которую участник торгов может указать, если он хочет, чтобы Google отправлял перенаправление HTTP 302 на закодированный URL для этого тега сопоставления. Это позволяет разместить Google в начале цепочки вызовов партнёров. Это приведёт к ошибке, если указано без google_hm или с google_cm .
google_ula	Строка, используемая для добавления пользователя в существующий список пользователей. Ожидаемый формат значения: userlistid[,timestamp] : userlistid : один числовой идентификатор списка пользователей. timestamp : необязательная временная метка в формате POSIX, указывающая, когда пользователь был добавлен в список пользователей. Этот параметр URL можно повторить, чтобы добавить пользователя в несколько списков.
gdpr	Указывает, что запрос подпадает под ограничения GDPR на использование данных. Подробнее см. в разделе «Требования к согласию пользователей из ЕС» или «Влияние на соответствие файлов cookie» в документации Authorized Buyers IAB TCF v2.0 . Пример: gdpr=1
gdpr_consent	Строка TC, представляющая согласие конечного пользователя. Подробнее см. в разделе «Требования к согласию пользователей ЕС» или в разделе «Как будет передана строка TC?» в документации Authorized Buyers IAB TCF v2.0 .
process_consent	Указывает, что участник торгов получил согласие конечного пользователя на использование данных, указанное в Политике согласия пользователей в ЕС компании Google . Если запрос не подпадает под действие Политики согласия пользователей ЕС или в запросе доступны другие параметры согласия ( gdpr_consent ), этот параметр игнорируется. Пример: process_consent=T

В дополнение к ранее заданным параметрам, участники торгов могут указать свои собственные, которые будут добавлены в качестве параметров к 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_ и параметры, определяемые участником торгов, в зависимости от указанных в теге match. Определены следующие параметры ответа google_ :

Параметр	Описание
google_gid	Идентификатор пользователя Google. Устанавливается, если в запросе указан google_cm и запрос выполнен успешно.
google_cver	Версия cookie. Устанавливается, если в запросе указан google_cm и запрос выполнен успешно.
google_error	Целочисленное значение, указывающее общую ошибку запроса. При получении оно означает, что никакие операции не были выполнены, и никакие другие параметры ответа google_ не будут установлены. Поддерживаются следующие значения ошибок: 1 : У пользователя есть cookie-файл Google, но он отказался от отслеживания с помощью этого cookie-файла. 2 : Не указано ни одной допустимой операции. Например, получен запрос на выполнение без операции. 3 : У пользователя нет cookie-файла Google. Google не будет устанавливать cookie-файл через службу сопоставления cookie-файлов. 4 : Указаны конфликтующие операции. Не допускается указание флагов google_push и google_cm в одном запросе, поскольку они имеют конфликтующие цели. 5 : Недопустимый параметр google_push был передан при перенаправлении на сервер Google в рамках двунаправленного запроса Pixel Matching. При перенаправлении необходимо задать google_push то же значение, что было передано в исходном запросе пикселя. 6 : В теге сопоставления указан недействительный NID. 7 : Обнаружен недействительный файл cookie. 8 : Устарело. Файл cookie не найден. 9 : Файл cookie не найден, предпринимается попытка установить тестовый файл cookie. 10 : Параметр google_redir использовался без указания google_hm или использовался в дополнение к google_cm . 15 : Запрос поступил из региона, где Google требует, чтобы таблица соответствий размещалась в Google. В результате этот ответ не содержит идентификатор пользователя Google.
google_hm	Появляется только в случае неудачной попытки записи в таблицу соответствий, размещенную в Google. В этом случае значение принимает один из следующих кодов статуса: 1 — Запрещено: у клиента нет доступа для записи записей в размещенной таблице соответствий. 2 — Ошибка декодирования: значение параметра не может быть декодировано. 3 — Полезная нагрузка слишком длинная: значение параметра декодировано в более чем 40 байт данных. 4 — Внутренняя ошибка: произошла внутренняя ошибка при сохранении данных. 5 — Throttled: эта запись не была обработана из-за регулирования.
google_ula	Статус операции добавления списка пользователей, повторяется, если в запросе указано несколько google_ula . Формат: userlistid,status code Пример: google_ula=1234567890,0 Операция google_ula может вернуть любой из следующих кодов состояния: 0 — Ошибок нет. Пользователь добавлен в список пользователей. 2 — Отказано в доступе. У вас нет разрешения на добавление пользователей в указанный список. 5 — Неверный идентификатор списка пользователей. Предоставленный идентификатор списка пользователей недействителен. 6 — Идентификатор закрытого атрибута. Предоставленный идентификатор списка пользователей закрыт. 10 — Внутренняя ошибка. Служба сопоставления файлов cookie обнаружила внутреннюю ошибку. Попробуйте повторно сопоставить пользователя.

Примеры сценариев рабочего процесса сопоставления файлов cookie

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

Сценарий 1: Пользователь очищает свои файлы cookie и просматривает сайт.

Джейн очищает кэш всех файлов cookie. Затем они заходят на главную страницу ExampleNews.com.

Вот что происходит:

1. ExampleNews.com отображает и вызывает рекламу из Google (Менеджер рекламы).
2. Поскольку рекламный блок имеет право на динамическое размещение, Google отправляет запросы ставок FinestDSP и другим участникам торгов через службу торгов в реальном времени.
3. Приложение FinestDSP для подачи заявок получает и обрабатывает запрос заявки и отправляет ответ на заявку.
4. Google получает ответы на заявки от участников торгов, включая ответ FinestDSP, в котором указано объявление с тегом соответствия (пикселем).
5. FinestDSP выигрывает аукцион. Google показывает Джейн объявление FinestDSP и соответствующий тег.
6. Тег сопоставления вызывает службу сопоставления cookie-файлов Google, указывая параметры google_nid и google_cm .
7. Служба сопоставления файлов cookie считывает cookie-файлы Google Джейн и отправляет браузеру Джейн перенаправление на URL-адрес сопоставления файлов cookie FinestDSP с установленными параметрами google_gid и google_cver .
8. Браузер Джейн загружает перенаправление на URL-адрес cookie-соответствия FinestDSP.
9. Конечная точка сопоставления cookie FinestDSP обрабатывает запрос на перенаправление, который включает параметры URL, установленные Google, и cookie-файл Джейн в HTTP-заголовках. Теперь FinestDSP может сохранять сопоставление своего cookie-файла с google_gid в своей таблице соответствий.
10. FinestDSP отвечает на перенаправление невидимым пикселем размером 1x1.

Сценарий 2: Пользователь с существующим сопоставлением

Через неделю после сценария 1 Джейн снова заходит на ExampleNews.com. Теперь, когда на её компьютере установлены файлы cookie как биддера, так и Менеджера рекламы, сопоставление работает следующим образом.

1. Веб-страница отображается, в результате чего Google (Менеджер объявлений) запрашивает рекламу, которая будет отображена на странице.
2. Во время аукциона объявлений Google отправляет запрос ставки соответствующим участникам торгов, включая FinestDSP.
3. FinestDSP получает запрос ставки, включая такие сигналы, как google_gid .
4. FinestDSP ищет google_gid в своей таблице соответствий и находит файл cookie, связанный с Джейн, который был создан неделей ранее (в сценарии 1).
5. На основе информации, связанной с cookie-файлом, логика торгов FinestDSP делает ставку на показ и выигрывает аукцион.
6. Джейн может увидеть рекламу, подобранную с учетом ее интересов на основе информации, которой располагает 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.user.buyeruid . Участники торгов также могут заполнять списки пользователей, используя указанные ими данные о сопоставлении, размещённые участником торгов.

В противном случае, если произошла ошибка, Google перенаправит вас на URL-адрес отчёта о соответствии файлов cookie участника торгов с указанием причины ошибки в параметре google_error . Если URL-адрес отчёта о соответствии файлов cookie участника торгов был https://ad.network.com/report , URL-адрес перенаправления будет выглядеть следующим образом:

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

Примечание: Участники торгов могут запросить, чтобы их учётная запись всегда получала перенаправления на URL-адрес отчёта о сопоставлении файлов cookie, даже при успешных операциях. Чтобы включить эту функцию, они могут обратиться к своему техническому менеджеру по работе с клиентами.

Шаг 5: Браузер пользователя перенаправляется на URL-адрес отчета о соответствии файлов cookie участника торгов.

Браузер пользователя перенаправит его на URL-адрес отчёта о соответствии файлов cookie участника торгов, включая причину ошибки (если таковая имеется), указанную Google в параметре google_error . Подробнее об интерпретации кода ошибки см. в описании параметра .

Примечание : этот шаг будет выполнен только в том случае, если учетная запись участника торгов настроена на отправку информации об успешном или неудачном выполнении операции на URL-адрес отчета о соответствии файлов cookie.

Шаг 6: Участник торгов подает заявку на прозрачный пиксель размером 1x1.

Участник торгов должен отобразить в браузере пользователя прозрачный пиксель размером 1x1.

Примечание : этот шаг будет выполнен только в том случае, если учетная запись участника торгов настроена на отправку информации об успешном или неудачном выполнении операции на URL-адрес отчета о соответствии файлов cookie.

Схема рабочего процесса сопоставления файлов cookie для пользователей из штатов США с ограничениями конфиденциальности

Рабочий процесс по умолчанию для пользователей в штатах США с ограничениями конфиденциальности проиллюстрирован на следующей диаграмме, где запросы и ответы обозначены стрелкой, а сопровождающие их элементы данных перечислены в скобках.

Параметры URL для перенаправления участника торгов в службу сопоставления файлов cookie Google

Параметр	Описание
google_nid	Сетевой идентификатор (NID) учетной записи участника торгов. Этот идентификатор можно получить через ресурс «Участники торгов» .
google_sc	Этот параметр устарел. Устанавливает cookie-файл Google для пользователя, если он отсутствует. Значение параметра игнорируется и может быть опущено. Отсутствие параметра приводит к ошибке, если cookie-файл отсутствует.
google_no_sc	Этот параметр устарел. Это указывает службе сопоставления файлов cookie Google, что не следует устанавливать файл cookie для пользователя, если он отсутствует. Значение параметра игнорируется и может быть опущено.
google_hm	Содержит данные, которые участник торгов хочет сохранить в таблице соответствий, размещенной в Google. Примечание: значение представляет собой веб-безопасную строку в кодировке Base64 (дополнение необязательно), длина которой не должна превышать 40 байт. Например, это может выглядеть так: Q29va2llIG51bWJlciAxIQ== .
google_redir	Закодированный URL-адрес, на который Google должен отправлять перенаправление HTTP 302. Указанный URL-адрес будет получать перенаправления с параметром google_error как в случае ошибок, так и в случае успешных операций.
google_ula	Строка, используемая для добавления пользователя в существующий список пользователей. Ожидаемый формат значения: userlistid[,timestamp] : userlistid : один числовой идентификатор списка пользователей. timestamp : необязательная временная метка в формате POSIX, указывающая, когда пользователь был добавлен в список пользователей. Этот параметр URL можно повторить, чтобы добавить пользователя в несколько списков.
gdpr	Указывает, что запрос подпадает под ограничения GDPR на использование данных. Подробнее см. в разделе «Требования к согласию пользователей из ЕС» или «Влияние на соответствие файлов cookie» в документации Authorized Buyers IAB TCF v2.0 . Пример: gdpr=1
gdpr_consent	Строка TC, представляющая согласие конечного пользователя. Подробнее см. в разделе «Требования к согласию пользователей ЕС» или в разделе «Как будет передана строка TC?» в документации Authorized Buyers IAB TCF v2.0 .
process_consent	Указывает, что участник торгов получил согласие конечного пользователя на использование данных, указанное в Политике согласия пользователей в ЕС компании Google . Если запрос не подпадает под действие Политики согласия пользователей ЕС или в запросе доступны другие параметры согласия ( gdpr_consent ), этот параметр игнорируется. Пример: process_consent=T

Параметры URL для перенаправления Google на URL отчета о сопоставлении файлов cookie участника торгов

Параметр

Описание

google_error

Целочисленное значение, указывающее общую ошибку запроса. При получении оно означает, что никакие операции не были выполнены, и никакие другие параметры ответа google_ не будут установлены. Поддерживаются следующие значения ошибок: 1 : У пользователя есть cookie-файл Google, но он отказался от отслеживания с помощью этого cookie-файла. 2 : Не указано ни одной допустимой операции. Например, получен запрос на выполнение без операции. 3 : У пользователя нет cookie-файла Google. Google не будет устанавливать cookie-файл через службу сопоставления cookie-файлов. 4 : Указаны конфликтующие операции. Не допускается указание флагов google_push и google_cm в одном запросе, поскольку они имеют конфликтующие цели. 5 : Недопустимый параметр google_push был передан при перенаправлении на сервер Google в рамках двунаправленного запроса Pixel Matching. При перенаправлении необходимо задать google_push то же значение, что было передано в исходном запросе пикселя. 6 : В теге сопоставления указан недействительный NID. 7 : Обнаружен недействительный файл cookie. 8 : Устарело. Файл cookie не найден. 9 : Файл cookie не найден, предпринимается попытка установить тестовый файл cookie. 10 : Параметр google_redir использовался без указания google_hm или использовался в дополнение к google_cm . 15 : Запрос поступил из региона, где Google требует, чтобы таблица соответствий размещалась в Google. В результате этот ответ не содержит идентификатор пользователя Google.

Инициировано Google: Двунаправленное сопоставление пикселей

Двунаправленное сопоставление пикселей (Bidirect Pixel Matching) — это рабочий процесс службы сопоставления файлов cookie Google, в рамках которого Google пытается сопоставить идентификатор пользователя Google с алгоритмически выбранным участником торгов, не являющимся победителем аукциона Real-Time Bidding. При размещении объявления Google добавляет тег сопоставления, указывающий браузеру пользователя загрузить прозрачный пиксель с URL-адреса сопоставления файлов cookie выбранного участника торгов. Это позволяет как Google, так и участнику торгов заполнить таблицу соответствий для заданного пользователя. Ниже приведён пример этого рабочего процесса.

Шаг 1: Google размещает тег соответствия

Когда страница участвующего издателя загружается в браузере пользователя и рекламное место на этой странице заполняется Google, может быть размещён тег сопоставления, который запрашивает пиксель у алгоритмически выбранного участника торгов. Тег сопоставления пикселей, размещённый 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 в запросе. Аналогично рабочему процессу, инициированному участником торгов, можно указать дополнительные параметры для реализации дополнительных вариантов использования.

Внимание: параметры google_cm и google_push никогда не должны появляться в одном запросе к службе сопоставления файлов cookie Google.

Шаг 3: Google обрабатывает перенаправление и отвечает пикселем

Google регистрирует, что для пользователя создано совпадение, и обрабатывает любые дополнительные операции, запрошенные с помощью параметров запроса. Наконец, Google отвечает прозрачным пикселем размером 1x1.

Диаграмма рабочего процесса сопоставления пикселей

Этот рабочий процесс проиллюстрирован на следующей диаграмме, где запросы и ответы обозначены стрелкой, а сопровождающие их элементы данных перечислены в скобках.

Параметры запроса тега соответствия Google

Параметр	Описание
google_gid	Идентификатор пользователя Google. Для пользователей из штатов США, не имеющих ограничений конфиденциальности, этот идентификатор всегда будет указан в теге соответствия Google.
google_cver	Версия cookie. Она всегда будет указана в теге соответствия Google.
google_push	Указывает, что этот запрос инициирует рабочий процесс сопоставления пикселей. Значение должно быть возвращено через соответствующий параметр в ответе перенаправления участника торгов.
gdpr_consent	Строка TC, представляющая согласие конечного пользователя. Подробнее см. в разделе [Требования к согласию пользователей из ЕС](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) или в разделе **Как будет передаваться строка TC?** в [документации IAB TCF v2.0 для авторизованных покупателей](//support.google.com/authorizedbuyers/answer/9789378).

Параметры перенаправления Bidder Pixel Matching

Параметр	Описание
google_nid	Сетевой идентификатор (NID) учетной записи участника торгов. Этот идентификатор можно получить через ресурс «Участники торгов» .
google_push	Указывает, что это перенаправление завершает процесс сопоставления пикселей. Здесь необходимо указать значение из соответствующего тега сопоставления Google.
google_hm	Содержит данные, которые участник торгов хочет сохранить в таблице соответствий, размещенной в Google. Примечание: значение представляет собой веб-безопасную строку в кодировке Base64 (дополнение необязательно), длина которой не должна превышать 40 байт. Например, это может выглядеть так: Q29va2llIG51bWJlciAxIQ== .
google_ula	Строка, используемая для добавления пользователя в существующий список пользователей. Ожидаемый формат значения: userlistid[,timestamp] : userlistid : один числовой идентификатор списка пользователей. timestamp : необязательная временная метка в формате POSIX, указывающая, когда пользователь был добавлен в список пользователей. Этот параметр URL-адреса можно повторять, чтобы добавить пользователя в несколько списков.
gdpr_consent	Строка TC, представляющая согласие конечного пользователя. Подробнее см. в разделе [Требования к согласию пользователей из ЕС](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) или **Как будет передаваться строка TC?** в [Документации IAB TCF v2.0 для Авторизованных покупателей](//support.google.com/authorizedbuyers/answer/9789378).

По инициативе Google: однонаправленное сопоставление пикселей

Однонаправленное сопоставление пикселей отличается от двунаправленного рабочего процесса тем, что тег соответствия Google не включает параметр, определяющий идентификатор пользователя Google, но продолжает заполнять таблицу соответствия, размещенную в Google. Это можно использовать в тех случаях, когда участнику торгов не разрешено размещать идентификаторы пользователей Google в собственной таблице соответствия. Пример пересмотренного рабочего процесса кратко описан в следующих шагах.

Примечание . Этот рабочий процесс необходим для пользователей из штатов США с ограничениями конфиденциальности, но участники торгов могут при желании применить этот рабочий процесс и для других регионов.

Шаг 1. Google размещает тег соответствия

Google размещает тег соответствия для алгоритмически выбранного участника торгов. Тег соответствия включает параметр google_push . Вот пример:

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

Шаг 2. Браузер пользователя запрашивает пиксель по URL-адресу сопоставления кулинарии, указанному в системе назначения ставок.

Браузер пользователя запрашивает пиксель из URL-адреса сопоставления файлов cookie участника торгов, включая файлы cookie участника торгов в заголовках HTTP.

Шаг 3. Перенаправление на службу сопоставления файлов 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&google_push=PUSH_DATA

Шаг 4. Браузер пользователя перенаправляется на службу сопоставления файлов cookie Google.

Google получит перенаправление, содержащее указанные вами параметры, а также файл cookie Google в заголовках HTTP. Если операция прошла успешно, показы для этого пользователя в последующих запросах ставок будут включать размещенные данные о совпадении участника торгов в BidRequest.user.buyeruid . Участники торгов также могут заполнять списки пользователей, используя указанные ими размещенные данные о совпадениях.

Наконец, Google возвращает браузеру пользователя прозрачный пиксель размером 1x1.

Помощь в сопоставлении файлов cookie

Open Bidding позволяет биржам использовать рабочие процессы сопоставления файлов cookie, инициированные участником торгов и Google , для сопоставления идентификатора пользователя Google со своими файлами cookie. Cookie Match Assist (CMA) — это дополнительная функция для бирж, которая позволяет им создавать таблицы сопоставления со своими собственными участниками торгов.

Как работает функция Cookie Match Assist

Примечание. Функция «Помощь в сопоставлении файлов cookie» будет прекращена 28 октября 2025 г.

1. При размещении объявления Google алгоритмически выбирает участвующую биржу и размещает тег Cookie Match Assist, имеющий следующую структуру:

   <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

   Внимание! Для пользователей из штатов США с ограничениями конфиденциальности Cookie Match Assist не будет включать параметр google_gid .

2. Тег соответствия CMA Google заставляет URL-адрес сопоставления файлов cookie биржи получать запрос пикселя.

   Примечание. В отличие от рабочих процессов, инициированных Google, здесь исключается параметр google_push .
3. Конечная точка сопоставления файлов cookie биржи получает запрос, в котором ее собственная служба сопоставления файлов cookie отвечает за сопоставление идентификатора пользователя с одним из участников торгов. На следующей диаграмме служба сопоставления файлов cookie биржи отвечает браузеру пользователя перенаправлением на одну из конечных точек системы назначения ставок.
4. Участник торгов получает запрос вместе со всеми параметрами, указанными биржей для сопоставления идентификатора пользователя с его файлом cookie.

Примечание. В зависимости от реализации биржи может использоваться дополнительное перенаправление от участника торгов на биржу для установки файла cookie в таблицу соответствия, размещенную на бирже.

Ограничения

Ограничение частоты запросов на свежие совпадения

Участники торгов несут ответственность за ограничение количества вызовов службы сопоставления файлов cookie для пользователей, у которых есть новая запись в таблице соответствия, размещенной в Google. Запись в размещенной таблице соответствий может считаться устаревшей через 14 дней, после чего ее можно обновить.

Предупреждение. Google не ограничивает частоту показов во время показа. Однако он периодически контролирует соблюдение вами политики ограничения частоты показов и оставляет за собой право прервать обслуживание в случае нарушения.

Отвечать на все запросы на совпадение пикселей

Ожидается, что участники торгов, использующие рабочий процесс Pixel Matching, будут отвечать на все входящие запросы Pixel Match ответом, включающим параметр google_push . Это позволяет Google применять политики, отслеживая использование. Если доля ответов участника торгов составляет менее 90 %, Google ограничит количество запросов Pixel Match, отправляемых в его аккаунт.

Используйте конечные точки HTTPS

Требуется, чтобы конечные точки, используемые во всех рабочих процессах сопоставления файлов cookie, использовали HTTPS.

При ответе на запрос Pixel Match, отправленный вам по HTTPS, вам необходимо перенаправиться в Службу сопоставления файлов cookie по HTTPS. Аналогично, конечная точка Cookie Match Assist, которая перенаправляет участников торгов, также должна использовать HTTPS. Если вы отправляете запросы в Google по HTTP чаще, чем раз в 2 минуты, количество запросов на совпадение, отправляемых в вашу учетную запись, будет ограничено.

Требования к согласию пользователей из ЕС

Запросы на сопоставление файлов cookie, подпадающие под действие Политики Google в отношении согласия пользователей из ЕС, должны указывать на согласие конечного пользователя. В таких запросах необходимо указать, что согласие было получено одним из следующих способов:

• TCFv2: сюда входят параметры gdpr и gdpr_consent . Подробную информацию см. в документации Authorized Buyers IAB TCF v2.0 .
• process_consent : заявление о том, что участник торгов получил необходимое согласие пользователя.

Примеры

Следующие примеры иллюстрируют, как использовать службу сопоставления файлов cookie для достижения конкретных целей. Обратите внимание: если не указано иное, предполагается, что пользователь, против которого совершаются действия, не из штата США с ограничениями конфиденциальности.

Заполнение таблицы соответствия, размещенной в системе назначения ставок

Участник торгов может использовать рабочий процесс сопоставления файлов cookie для заполнения собственной таблицы соответствия, указав в теге соответствия только параметры google_nid и google_cm . Это может выглядеть так:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />

Если URL-адрес сопоставления файлов cookie системы назначения ставок установлен на 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, см. параметры URL-адреса перенаправления .

Примечание. id параметра, определенного системой назначения ставок, который отображается в теге соответствия, передается в неизменном виде, когда Google перенаправляет на URL-адрес сопоставления файлов cookie участника назначения ставок.

Добавить в список одного пользователя

Параметр google_ula можно указать в теге соответствия системы назначения ставок, чтобы добавить пользователя в список пользователей с заданным идентификатором. Если в таблице соответствия Google или системе назначения ставок есть новая запись для пользователя, система назначения ставок может разместить тег соответствия, включающий параметры google_nid и google_ula , чтобы добавить пользователя в указанный список, не запуская полный рабочий процесс сопоставления файлов cookie. Дополнительную информацию см. в ограничениях на использование службы сопоставления файлов cookie. Соответствующий тег соответствия может выглядеть так:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />

Для успешного ответа, если URL-адрес сопоставления файлов cookie участника аукциона – https://ad.network.com/pixel , URL-адрес перенаправления Google будет следующим:

https://ad.network.com/pixel?google_ula=12345,0

Ключевой момент: значение google_ula равно 12345,0 , что указывает на то, что пользователя следует добавить в список пользователей с идентификатором 12345 , и в этом случае временная метка устанавливается на 0 , что указывает на то, что она не указана. Альтернативно можно было бы указать только идентификатор списка пользователей.

Если произошла общая ошибка — например, для пользователя нет файла cookie Google — URL-адрес перенаправления будет включать параметр google_error :

• https://ad.network.com/pixel?google_error=3

Если возникла ошибка, связанная именно с добавлением пользователя в список, вы получите google_ula в перенаправлении. В отличие от соответствующего параметра тега соответствия, здесь временная метка заменяется кодом состояния, указывающим на успех операции. Например, если запрос не выполнен из-за того, что учетная запись участника торгов не имела доступа к указанному списку пользователей, URL-адрес перенаправления будет следующим:

https://ad.network.com/pixel?google_ula=12345,2

Добавить в несколько списков пользователей

Участники торгов могут указать, что пользователя следует добавить в несколько списков пользователей, включив в тег соответствия несколько параметров google_ula . На практике это может выглядеть так:

<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

В предыдущем перенаправлении мы видим, что операция завершилась успешно для списка пользователей с идентификатором 45678 , но не удалась для списка пользователей с идентификатором 12345 поскольку у участника торгов не было разрешения на доступ к нему.

Выполните рабочий процесс сопоставления файлов cookie и добавьте в список пользователей.

Чтобы выполнить сопоставление файлов cookie и добавить пользователя в список пользователей с помощью одного запроса, тег соответствия системы назначения ставок должен включать google_cm и google_ula :

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />

URL-адрес перенаправления, указанный Google, будет включать google_gid , google_cver и google_ula . Это может выглядеть следующим образом:

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

Сохраните совпадение в таблице соответствий, размещенной в Google.

Если участник торгов хочет хранить данные своих файлов cookie в таблице соответствия, размещенной в Google, и не намерен хранить совпадение с идентификатором пользователя Google в своей собственной таблице соответствия, его тег соответствия должен включать параметр google_hm , где его значение должно быть веб-безопасной строкой в кодировке Base64. Для пользователя, у которого незакодированные данные файла cookie участника торгов имеют Cookie number 1! , закодированное значение будет Q29va2llIG51bWJlciAxIQ== , которое будет использоваться в теге соответствия, как показано ниже:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

Для успешного ответа, если URL-адрес сопоставления файлов cookie участника торгов — https://cookie-monster.com/pixel , URL-адрес перенаправления Google будет следующим:

https://cookie-monster.com/pixel

Параметр google_gid отсутствует в перенаправлении, поскольку тег соответствия не включает google_cm , а google_hm не включается в успешные ответы. В будущих запросах ставок на показы для этого пользователя участник торгов будет получать размещенные данные о совпадениях в BidRequest.user.buyeruid .

Если вместо этого участник торгов использовал тег соответствия, в котором значение google_hm не было закодировано в формате Base64, например chocolate_chunk! — URL-адрес перенаправления может выглядеть следующим образом:

https://cookie-monster.com/pixel?google_hm=2

Предыдущий URL-адрес перенаправления содержит значение google_hm равное 2 , что указывает на то, что операция не удалась, поскольку значение не удалось декодировать.

Таблицы соответствия системы назначения ставок и Google со списками пользователей

Если участник торгов размещает свой собственный список использования в дополнение к списку пользователей, размещенному в Google, и хочет, чтобы один тег соответствия соответствовал обеим таблицам и добавлял пользователя в определенный список пользователей, его тег соответствия должен включать параметры google_cm , google_hm и google_ula . Если данные файла cookie участника торгов имеют 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 участника аукциона — https://cookie-monster.com/pixel , URL-адрес перенаправления Google будет выглядеть следующим образом:

https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0

Получив перенаправление, участник торгов может сопоставить идентификатор пользователя Google, указанный в google_gid с данными своих файлов cookie в своей таблице соответствия. Кроме того, они могут определить, что операции с таблицей соответствия и списком пользователей, размещенные в Google, прошли успешно. Как следствие, любой предварительный таргетинг системы назначения ставок, настроенный для таргетинга на указанный идентификатор списка пользователей, теперь приведет к тому, что система назначения ставок будет получать запросы ставок на показы от пользователя. Аналогично, в этих запросах ставок участник торгов получит размещенные данные о совпадениях в BidRequest.user.buyeruid .