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

Сопоставление файлов cookie – это функция, которая позволяет сопоставлять файлы cookie (например, идентификатор пользователя, просматривавшего ваш веб-сайт) с соответствующим идентификатором пользователя Google, специфичным для участника торгов, и создавать списки пользователей, которые помогут вам сделать более эффективный выбор ставок. В этом руководстве описаны концепции, используемые в сопоставлении файлов 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. В реализации OpenRTB от Google BidRequest.user.buyeruid будет указывать это как безопасную для Интернета строку в кодировке Base64. Если ваша конечная точка назначения ставок настроена на использование устаревшего протокола Google RTB, вы получите его в виде декодированных байтов через поле BidRequest.hosted_match_data .

  • Списки пользователей : списки пользователей могут быть заполнены либо идентификаторами пользователей 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 к 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 Google в настоящее время поддерживает три рабочих процесса для различных вариантов использования, которые описаны ниже.

Двунаправленное сопоставление файлов 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.user.id в OpenRTB или BidRequest.google_user_id в устаревшем протоколе Google RTB.

Версия, указанная в 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 .

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

Сопоставить параметры 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» в документации IAB TCF v2.0 для Авторизованных покупателей .

Пример: gdpr=1

gdpr_consent Строка TC, представляющая согласие конечного пользователя. Более подробную информацию см. в разделе «Требования к согласию пользователей из ЕС» ниже или «Как будет передаваться строка TC?» в документации Авторизованных покупателей 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_ и параметры, определяемые участником аукциона, в зависимости от тех, которые указаны в теге соответствия. Определены следующие параметры ответа google_ :

Параметр Описание
google_gid Идентификатор пользователя Google. Устанавливается, если в запросе указан google_cm и запрос прошел успешно.
google_cver Куки-версия. Устанавливается, если в запросе указан 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 как часть двунаправленного запроса сопоставления пикселей. Ваше перенаправление должно установить для google_push то же значение, которое было передано вам в исходном запросе пикселя.
  • 6 : В теге соответствия указан неверный NID.
  • 7 : Обнаружен недействительный файл cookie.
  • 8 : Устарело. Файл cookie не найден.
  • 9 : Файл cookie не найден, предпринята попытка установить тестовый файл cookie.
  • 10 : параметр google_redir использовался без указания google_hm или использовался в дополнение к google_cm .
  • 15 : Запрос поступает из региона, где Google требует, чтобы таблица соответствия размещалась на сервере Google. В результате этот ответ не содержит идентификатора пользователя Google. В настоящее время эта функция доступна лишь для небольшого процента трафика, но планируется, что она будет полностью включена в июне 2020 года.
google_hm

Появляется только в том случае, если попытка записи в таблицу соответствия, размещенную в Google, не удалась. В этом случае его значением будет один из следующих кодов состояния:

  • 1 – запрещено: клиент еще не внесен в белый список для записи записей в размещенной таблице соответствия.
  • 2 — Ошибка декодирования: значение параметра не удалось декодировать.
  • 3 — Полезная нагрузка слишком длинная: значение параметра декодировано в более чем 24 байта данных.
  • 4 — Внутренняя ошибка: произошла внутренняя ошибка при сохранении данных.
  • 5 — Дросселировано: эта запись не была обработана из-за регулирования.
google_ula

Статус операции добавления списка пользователей, повторяется, если в запросе указано несколько google_ula . Формат:
userlistid,status code

Пример: google_ula=1234567890,0

Операция google_ula может возвращать любой из следующих кодов состояния:

  • 0 – нет ошибки. Пользователь добавлен в список пользователей.
  • 2 – Разрешение отклонено. У вас нет разрешения на добавление пользователей в данный список пользователей.
  • 5 – неверный идентификатор списка пользователей. Указанный идентификатор списка пользователей недействителен.
  • 6 - Идентификатор закрытого атрибута. Указанный идентификатор списка пользователей закрыт.
  • 10 - Внутренняя ошибка. В службе сопоставления файлов 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 похоже на двунаправленный рабочий процесс, за исключением того, что он изменен таким образом, что только Google размещает и заполняет таблицу соответствия. Это можно использовать в тех случаях, когда участнику торгов не разрешено размещать идентификаторы пользователей Google в собственной таблице соответствия. Чтобы использовать этот процесс, участники торгов должны разрешить Google размещать таблицу соответствия, больше не могут указывать google_cm в запросах к службе сопоставления файлов cookie Google и, следовательно, не будут получать google_gid для заполнения своей собственной таблицы соответствия. Как только Google установит соответствие для пользователя, участники торгов могут добавить его в списки пользователей, используя свои собственные данные cookie. Аналогично, запросы ставок для этих пользователей будут исключать идентификатор пользователя Google, но включать размещенные данные о совпадениях. Простой пример пересмотренного рабочего процесса кратко изложен в следующих шагах.

Чтобы инициировать этот процесс, участник торгов должен разместить тег соответствия так, чтобы он отображался в браузере пользователя. В отличие от рабочего процесса для пользователей, не проживающих в штате США с ограничениями конфиденциальности, тег соответствия должен направлять браузер пользователя на ваш URL-адрес сопоставления файлов cookie. Например, если URL-адрес сопоставления файлов cookie настроен как https://ad.network.com/pixel , он будет выглядеть так:

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

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

Конечная точка сопоставления файлов 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 получит перенаправление, содержащее указанные вами параметры, а также файл cookie Google в заголовках HTTP.

Шаг 4. Google отображает пиксель при успешном или ошибочном перенаправлении, если указан URL отчета.

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

В противном случае, если произошла ошибка, 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 участника аукциона, включая причину ошибки (если таковая имеется), указанную Google в параметре google_error . Подробнее об интерпретации кода ошибки смотрите в описании параметра .

Шаг 6. Система назначения ставок показывает прозрачный пиксель 1 x 1.

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

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

Параметр Описание
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] :
  • userlistid : одиночный числовой идентификатор списка пользователей.
  • timestamp : необязательная временная метка в формате POSIX, указывает, когда пользователь был добавлен в список пользователей.

Этот параметр URL-адреса можно повторять, чтобы добавить пользователя в несколько списков.

gdpr Указывает, что на запрос распространяются ограничения GDPR на использование данных. Более подробную информацию см. ниже в разделе «Требования к согласию пользователей из ЕС» или «Влияние на возможность сопоставления файлов cookie» в документации IAB TCF v2.0 для Авторизованных покупателей .

Пример: gdpr=1

gdpr_consent Строка TC, представляющая согласие конечного пользователя. Более подробную информацию см. ниже в разделе «Требования к согласию пользователей из ЕС» или «Как будет передаваться строка TC?» в документации Авторизованных покупателей IAB TCF v2.0 .
process_consent Указывает, что участник торгов получил согласие конечного пользователя на использование данных, указанное в Политике согласия пользователей Google в ЕС .

Если запрос не подпадает под действие Политики согласия пользователей ЕС или если в запросе доступны другие параметры согласия ( gdpr_consent ), этот параметр игнорируется.

Пример: process_consent=T

Параметр Описание
google_error

Целочисленное значение, указывающее общую ошибку запроса. При получении это означает, что никакие операции не выполнялись и никакие другие параметры ответа google_ не будут установлены. Поддерживаемые значения ошибок включают следующее:

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

По инициативе 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" />

Участники торгов, получающие запросы на сопоставление пикселей, должны ответить перенаправлением в службу сопоставления файлов 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.

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

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

Параметры запроса тега соответствия 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] :
  • userlistid : одиночный числовой идентификатор списка пользователей.
  • timestamp : необязательная временная метка в формате POSIX, указывает, когда пользователь был добавлен в список пользователей.

Этот параметр 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.

Конечная точка 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

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

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

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

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

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
  2. Тег CMA Match от Google заставляет URL -адрес cookie Cookie для получения совпадения файла cookie Exchange.

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

Ограничения

Частота CAP запросов на свежие матчи

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

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

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

Используйте https endpoints

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

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

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

Примеры

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

https://cookie-monster.com/pixel

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

Если участник вместо этого использовал метку совпадения, где значение 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: 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.user.buyeruid для openrtb, или BidRequest.hosted_match_data для устаревшего протокола Google RTB.