Concordancia de cookies

La concordancia de cookies es una función que le permite hacer coincidir su cookie para por ejemplo, un ID para un usuario que navegó por tu sitio web, con una dirección el ID de usuario de Google específico del ofertante y crear listas de usuarios opciones de ofertas más eficaces. En esta guía, se describen los conceptos que se usan en las de Concordancia, así como diferentes flujos de trabajo de Concordancia de Cookies y sus variaciones que podrían tener en ciertos casos de uso.

Conceptos

Los propietarios de dominios suelen establecer el contenido de las cookies para los usuarios que navegan su sitio, que se usan para identificar a los usuarios dentro de ese dominio. Incluso si dos propietarios del dominio aceptarían intercambiar estos datos, el modelo de seguridad de los navegadores de Internet impide que uno lea una cookie configurada por otro dominio.

En el contexto de la publicidad digital, Google identifica a los usuarios con cookies. que pertenecen al dominio doubleclick.net y los ofertantes que participan en Ofertas en tiempo real pueden tener su propio dominio, donde Identificar el conjunto de usuarios al que le gustaría que se le muestren sus anuncios. Concordancia de Cookies permite al ofertante hacer coincidir sus cookies con las de Google, de modo que pueda determinar si una impresión enviada en una solicitud de oferta está asociada con uno de a los usuarios objetivo, estos recibirán sus propios datos de cookies ID de usuario de Google específico del ofertante que es un formato encriptado del cookie doubleclick.net en la solicitud de oferta.

El servicio de concordancia de cookies descrito en esta guía facilita la creación y el mantenimiento de la asociación entre la cookie del ofertante y el User-ID, y permite propagar las listas de usuarios.

Tablas de coincidencias

Una tabla de coincidencias se puede usar para asignar un ID u otros datos de un dominio a con el otro. Los ofertantes pueden usar el servicio de concordancia de cookies para propagar que coinciden con las tablas asignando su cookie de un usuario determinado al servicio de Google ID de usuario, o para propagar una tabla de coincidencias alojada por Google. Las tablas de coincidencias son necesarios para que la aplicación de un ofertante acceda a los datos de cookies del usuario a ver la impresión.

Tablas de coincidencia alojadas en Google

Para facilitar el mantenimiento, las mejoras en la latencia y el acceso a los datos coincidentes para usuarios de ciertas regiones, se recomienda que permitas que Google aloje tus de coincidencias exactas. Esto te permite especificar una string codificada en base64 segura para la Web; en adelante, denominados datos de coincidencia alojados, que se asignarán al Es el ID de usuario de Google de un usuario determinado. Una vez que se establece la coincidencia, se puede se usan de las siguientes maneras:

  • Ofertas en tiempo real: En solicitudes de oferta posteriores para impresiones asociado con el usuario, Google te enviará los datos de coincidencia alojados que se coincidan con su ID de usuario de Google. Si tu extremo de ofertas está configurado para usar el protocolo de RTB de Google, lo recibirás como bytes decodificados mediante el campo BidRequest.hosted_match_data En OpenRTB de Google implementación, BidRequest.user.buyeruid devolverá esto como una cadena codificada en Base64 segura para la Web.

  • Listas de usuarios: Se pueden propagar las listas de usuarios. con IDs de usuario de Google o datos de coincidencia alojados.

  • Segmentación previa: Puedes configurar tu segmentación previa de modo que solo recibas solicitudes de oferta que contiene datos de coincidencias alojados. Esto se puede usar para eliminar menos relevantes impresiones para los usuarios fuera de su espacio de cookies.

Listas de usuarios

Las listas de usuarios se pueden crear y administrar con la API de Ofertas en tiempo real. Una vez creadas, puedes propagar estas listas con los flujos de trabajo de concordancia de cookies. que se describe a continuación, o bien a través del Servicio de carga masiva.

Comenzar

Para comenzar a utilizar la concordancia de cookies, debe ponerse en contacto con su Administrador técnico de cuentas, que puede habilitar flujos de trabajo específicos y ayudarte configura lo siguiente:

  • ID de red de concordancia de cookies (NID): Es un ID de cadena que identifica de forma inequívoca. una cuenta de ofertante para la Concordancia de Cookies y otras operaciones relacionadas.
  • URL de concordancia de cookies: Es la URL base del extremo que aceptará y administrar las solicitudes entrantes como parte de los flujos de trabajo de concordancia de cookies. Los ofertantes pueden incorporar macros en esta URL para lo siguiente: controlar el orden de los parámetros que se le pasan en los flujos de trabajo de concordancia de cookies.
  • Etiqueta de coincidencia: es la etiqueta que debes colocar en el navegador de un usuario para que el flujo de trabajo de Concordancia de Cookies iniciado por el ofertante. Se puede publicar junto con los anuncios. o que se ubiquen en propiedades web fuera de los anuncios.
  • URL del informe de concordancia de cookies (opcional): En la ruta unidireccional de concordancia de cookies. Esta es una URL opcional que se puede proporcionar a especifica un extremo que recibirá detalles del error en caso de que la cookie la coincidencia falla a través de un redireccionamiento HTTP 302. De forma predeterminada, las respuestas solo enviar a esta URL si se produce un error en la operación de concordancia de cookies pero el ofertante puede solicitar que siempre se envíe el redireccionamiento.
  • URL de contribución de coincidencia de cookies: Para los intercambios que implementan el Flujo de trabajo de Cookie Match Assist, este es el URL base del extremo destinado a responder a las solicitudes entrantes.
  • Cuota de Cookie Match Assist: para los intercambios que implementan el Flujo de trabajo de Cookie Match Assist, este es el la cantidad máxima de solicitudes que la URL de concordancia de cookies puede recibir cada por segundo. Esto es para evitar que las solicitudes de la CMA sobrecarguen el los servidores de Exchange con solicitudes.

En cualquiera de los flujos de trabajo de concordancia de cookies compatibles, la URL de concordancia de cookies de un ofertante suele tener parámetros no garantizado. Ofertantes con integraciones que requieren coherencia el orden de los parámetros puede colocar macros en su URL de concordancia de cookies a garantizar su posición.

Macros compatibles

De manera opcional, los ofertantes pueden configurar su URL de concordancia de cookies para incluir una más macros en el formato de %%GOOGLE_<PARAM_NAME>%% o %%GOOGLE_<PARAM_NAME>_PAIR%% Las macros compatibles y sus los valores expandidos son los siguientes:

Macro Valor expandido
GOOGLE_GID GOOGLE_USER_ID
GOOGLE_GID_PAIR &amp;google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_PAIR &amp;cver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR ERROR_ID
GOOGLE_ERROR_PAIR &amp;google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_PAIR &amp;google_push=PIXEL_MATCH_DATA
GOOGLE_ALL_PARAMS google_gid=GOOGLE_USER_ID&amp;cver=COOKIE_VERSION_NUMBER&amp;google_error=ERROR_ID

Ejemplo de macro

Un ofertante tiene una integración de concordancia de cookies con un extremo alojado en https://user.bidder.com.cookies, y su implementación requiere parámetros definidos por el ofertante predeterminado, además de la coincidencia con píxeles parámetros en el siguiente orden: google_push, google_gid, google_cver y google_error El ofertante puede lograr esto si establece su URL de concordancia de cookies para:

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%%

Cuando Google envíe una solicitud de coincidencia a este ofertante, se expandirá en algo como lo siguiente:

https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3

Actualmente, el servicio de concordancia de cookies de Google admite tres flujos de trabajo para con los diferentes casos de uso que se describen a continuación.

La concordancia bidireccional de cookies hace referencia a un flujo de trabajo iniciado por el ofertante, en el que colocan una etiqueta de coincidencia en el navegador del usuario que la dirige a Google. Esta permite que tanto Google como el ofertante propaguen las tablas de coincidencias. A continuación, se incluye un un ejemplo sencillo de este flujo de trabajo.

Paso 1: Coloca la etiqueta de coincidencia

Para iniciar este flujo, el ofertante debe colocar su etiqueta de coincidencia de que se renderiza en el navegador del usuario. Una etiqueta de coincidencia simple que solo muestra el ID de usuario de Google para el ofertante se puede estructurar de la siguiente manera:

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

Existen parámetros adicionales que puede incluir en la etiqueta de coincidencia para cumplir diferentes casos de uso. Para obtener más información sobre estos parámetros, consulta Coinciden con los parámetros de URL de la etiqueta.

Paso 2: Google responde con redireccionamiento, incluidos los datos de coincidencia.

La etiqueta de coincidencia hará que el servicio de concordancia de cookies de Google reciba una solicitud desde el navegador del usuario, lo que emitirá un HTTP 302 redireccionar a la URL de concordancia de cookies del ofertante El redireccionamiento incluirá consultas parámetros que especifiquen el ID de usuario de Google y su número de versión en la URL el ofertante también recibirá su cookie incluida en los encabezados de la solicitud. En para una URL de concordancia de cookies especificada como https://ad.network.com/pixel, la URL de redireccionamiento para la etiqueta de coincidencia simple, como se ve anteriormente, podría verse así: lo siguiente:

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

El ID de usuario de Google que se pasa a través del parámetro google_gid es una interfaz segura para la Web sin padding una cadena vacía. Se recomienda a los ofertantes que elijan alojar una tabla de coincidencias almacenar la cadena exacta que devuelve el Servicio de concordancia de cookies. En los siguientes cursos: de solicitudes de ofertas, corresponderá a los valores especificados hasta el BidRequest.google_user_id en el protocolo de RTB de Google, o BidRequest.user.id en Implementación de OpenRTB.

La versión especificada en google_cver indica el valor numérico de versión para el ID de usuario de Google. El ID de usuario de Google de un usuario determinado cambian con poca frecuencia, después de lo cual aumentan.

Si Google encuentra un error al procesar tu solicitud de coincidencia, En su lugar, se especificará el parámetro google_error.

Paso 3: El ofertante procesa el redireccionamiento y responde con un píxel

El ofertante recibe un redireccionamiento a su URL de concordancia de cookies, que incluye lo siguiente: parámetros que especificó en el primer paso y los que Google proporcionó en la segundo paso. Además, también recibirán su cookie en el protocolo encabezados. Si la operación se realizó correctamente, un ofertante que aloja su propia tabla de coincidencias podría hacer coincidir su cookie con el ID de usuario de Google incluido en la respuesta. Sí Se recomendó que los ofertantes almacenen la cadena exacta que muestra la herramienta de concordancia de cookies. Servicio.

Si la operación no se realiza correctamente, el ofertante recibirá un google_error en el redireccionamiento. Es un valor numérico que corresponde a diferentes estados de error que identifican el error específico que ocurrió. Puedes aprender Obtén más información sobre los posibles valores de error aquí. Si recibes un mensaje de error, puedes intentar buscar a ese usuario nuevamente. Para ello, haz lo siguiente: colocar una nueva etiqueta de coincidencia.

El ofertante siempre debe responder publicando una imagen de píxel invisible de 1 x 1. Como alternativa, puedes mostrar una respuesta HTTP 204 No Content.

Este flujo de trabajo se ilustra en el siguiente diagrama, donde las solicitudes y las respuestas están representadas por una flecha y los elementos de datos que las acompañan se enumeran entre paréntesis.

Hacer coincidir los parámetros de la URL de la etiqueta

Parámetro Descripción
google_nid Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar mediante la pestaña Ofertantes recurso.
google_cm Le indica al Servicio de concordancia de cookies de Google que debe realizar. concordancia de cookies. El valor del parámetro se ignora y puede omitido.
google_sc Este parámetro dejó de estar disponible. Establece la cookie de Google para la usuario si no hay uno presente. El valor del parámetro se ignora y puede omitirse. Omitir el parámetro genera un error si no hay cookies existe.
google_no_sc Este parámetro dejó de estar disponible. Esto indica a la nube de concordancia de cookies que no debería establecer una cookie para el usuario si uno no está presente. El valor del parámetro se ignora y puede omitido.
google_hm

Son los datos que el ofertante desea almacenar en una tabla de coincidencias alojada en Google.

El valor es una string codificada en base64 segura para la Web (padding opcional). Los datos sin procesar deben ser 40 bytes o menos. Por ejemplo, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Es una cadena codificada en URL que un ofertante puede especificar si desea dirigirlo. que Google envíe el redireccionamiento HTTP 302 a la URL codificada para esta etiqueta de coincidencia. Esto permite colocar Google en la parte delantera con una cadena llamada a los socios. Esto generará un error si se especifica sin google_hm o con google_cm.
google_ula Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El valor el formato esperado es userlistid[,timestamp]:
  • userlistid: Es un ID numérico de lista de usuarios único.
  • timestamp: Es una marca de tiempo opcional en formato POSIX. indica cuándo se agregó el usuario a la lista de usuarios.

Este parámetro de URL se puede repetir para agregar al usuario a varios listas.
gdpr Indica que la solicitud está sujeta a las restricciones de datos del GDPR de uso de la nube. Para obtener más información, consulta Requisitos de consentimiento de usuarios de la UE a continuación, o bien Impacto en la concordancia de cookies la elegibilidad en la . Documentación del MTC v2.0 de IAB de Authorized Buyers

Ejemplo: gdpr=1
gdpr_consent Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, Consulte los requisitos de consentimiento de usuarios de la UE. o ¿Cómo se pasará la cadena de TC? en la . Documentación del MTC v2.0 de IAB de Authorized Buyers
process_consent Indica que el ofertante obtuvo el consentimiento del usuario final para los usos de datos especificados en Política de Consentimiento de Usuarios de la UE de Google

Si la solicitud no está sujeta a la Política de Consentimiento de Usuarios de la UE o si hay otros parámetros de consentimiento disponibles en la solicitud (gdpr_consent), se ignora este parámetro.

Ejemplo: process_consent=T

Además de los parámetros anteriores, los ofertantes pueden especificar sus propios parámetros, que se agregarán como parámetros a la URL de redireccionamiento. Ten en cuenta que las definiciones los parámetros nombrados con el prefijo google_ se ignorarán que Google reserva para el desarrollo y la preservación de la parámetros el orden de los datos no está garantizado. Una etiqueta de coincidencia que incluye valores definidos por el ofertante de la siguiente manera:

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

Parámetros de URL de redireccionamiento

La URL de redireccionamiento se crea a partir de la URL base de concordancia de cookies configurada para la cuenta de un ofertante, incluidos google_ y los parámetros definidos por el ofertante dependiendo de los especificados en la etiqueta de coincidencia. Los siguientes google_ se definen los parámetros de respuesta:

Parámetro Descripción
google_gid Es el ID de usuario de Google. Se establece si se especifica google_cm en la solicitud y esta se realizó de forma correcta.
google_cver Versión de cookie. Se establece si se especifica google_cm en la solicitud y esta se realizó de forma correcta.
google_error

Un número entero que indica el error de solicitud general. Cuándo recibidos, indica que no se realizaron operaciones y que ninguna otra Se establecerán google_ parámetros de respuesta. El error admitido incluyen lo siguiente:

  • 1: El usuario tiene una cookie de Google, pero inhabilitó alguna el seguimiento con esta cookie.
  • 2: No se especificaron operaciones válidas. por ejemplo, un modelo no-op si recibiste esa solicitud.
  • 3: El usuario no tiene una cookie de Google. Google no hará lo siguiente: configura la cookie a través del Servicio de concordancia de cookies.
  • 4: Se especificaron operaciones en conflicto. No estás se permite especificar los elementos google_push y google_cm en la misma solicitud, ya que tienen propósitos contradictorios.
  • 5: El parámetro google_push no es válido pasan un redireccionamiento a un servidor de Google como parte de una red bidireccional Solicitud de coincidencia de Pixel. El redireccionamiento debe establecer google_push con el mismo valor que se te pasó en la solicitud inicial de píxeles.
  • 6: Se proporcionó un NID no válido en la etiqueta de coincidencia.
  • 7: Se detectó una cookie no válida.
  • 8: Obsoleto. No se encontraron cookies.
  • 9: No se encontraron cookies; se intenta establecer una cookie de prueba.
  • 10: Se usó el parámetro google_redir. sin que se especifique google_hm, o se usó de forma adicional a google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que la tabla de coincidencias esté alojada en Google. Como resultado, esta respuesta no contiene un ID de usuario de Google. Actualmente, esta opción está habilitada para un pequeño porcentaje de tráfico, pero está planificado habilitarse por completo en Junio de 2020.
google_hm

Solo aparece si se intenta escribir en la tabla de coincidencias alojada en Google. falla. Cuando eso sucede, su valor es uno de los siguientes códigos de estado:

  • 1 - Prohibido: El cliente aún no está incluido en la lista blanca para escribir entradas de tablas de coincidencias alojadas.
  • 2: Error de decodificación: no se pudo determinar el valor del parámetro se decodifican.
  • 3: Carga útil demasiado larga: el valor del parámetro se decodifica en con más de 24 bytes de datos.
  • 4: Error interno: Se produjo un error interno al almacenar los datos.
  • 5 - Limitado: Esta escritura no se procesó debido a limitación.
google_ula

Estado de la operación para agregar la lista de usuarios, que se repite si hay varios google_ula se especificaron en la solicitud. El formato es el siguiente:
userlistid,status code

Ejemplo: google_ula=1234567890,0

La operación google_ula puede mostrar cualquiera de los siguientes códigos de estado:

  • 0: No hay error. Se agregó al usuario a la lista de usuarios.
  • 2: se denegó el permiso. No tienes permiso para agregar usuarios a la lista de usuarios especificada.
  • 5: ID de lista de usuarios erróneo. El ID de la lista de usuarios proporcionado no es válido.
  • 6: ID del atributo cerrado. El ID de la lista de usuarios proporcionado está cerrado.
  • 10: Error interno. El servicio de concordancia de cookies tiene Se produjo un error interno. puedes intentar volver a encontrar la coincidencia con el usuario.

Las siguientes situaciones describen cómo sería la coincidencia de cookies para un usuario típico navegando por una página web.

Situación 1: El usuario borra sus cookies y explora un sitio

Jane borra todas las cookies de la caché. Luego, visitan la página principal de NoticiasdeEjemplo.com.

Esto es lo que ocurre:

  1. ExampleNews.com renderiza y llama a los anuncios de Google (Ad Manager).
  2. Debido a que la unidad de anuncios es apta para la asignación dinámica, Google envía la oferta solicitudes a FinestDSP y otros ofertantes a través del servicio de ofertas en tiempo real.
  3. La solicitud de ofertante de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta a la oferta.
  4. Google recibe respuestas a la oferta de los ofertantes, incluida la respuesta de FinestDSP que especifique un anuncio con una etiqueta de coincidencia (píxel).
  5. FinestDSP gana la subasta. Google publica el anuncio y la etiqueta de coincidencia de FinestDSP para Julia.
  6. La etiqueta de coincidencia llama al servicio de concordancia de cookies de Google y especifica la Parámetros google_nid y google_cm
  7. El servicio de concordancia de cookies lee la cookie de Google de Jane y envía la de navegador un redireccionamiento a la URL de concordancia de cookies de FinestDSP con el Se configuraron los parámetros google_user_id y google_cver.
  8. El navegador de Jane carga el redireccionamiento a la URL de Cookie Match de FinestDSP.
  9. El extremo de concordancia de cookies de FinestDSP procesa la solicitud de redireccionamiento, que incluye los parámetros de URL establecidos por Google y su cookie para Jane en encabezados HTTP. FinestDSP ahora puede almacenar la asignación de su cookie al google_user_id en su tabla de coincidencias.
  10. FinestDSP responde al redireccionamiento con un píxel invisible de 1 x 1.
Situación 2: Usuario con una asignación existente

Una semana después del caso 1, Jane visita NoticiasDeEjemplo.com nuevamente. Ahora que Jane tiene cookies de ofertantes y de Ad Manager en su máquina, así es como funciona.

  1. La página web se renderiza, lo que hace que Google (Ad Manager) solicite anuncios que se renderizarán en la página.
  2. Durante la subasta de anuncios, Google envía una solicitud de oferta a los ofertantes correspondientes, incluido FinestDSP.
  3. FinestDSP recibe la solicitud de oferta, incluidos indicadores como el google_user_id
  4. FinestDSP busca el elemento google_user_id en su tabla de coincidencias. y encuentra la cookie asociada con Jane que se creó una semana antes (en el escenario 1).
  5. Según la información asociada a la cookie, la oferta de FinestDSP establece una oferta en la impresión y gana la subasta.
  6. Jane podría ver un anuncio adaptado a sus intereses, en función de la información que posee FinestDSP.

La concordancia unidireccional de cookies es similar al flujo de trabajo bidireccional, excepto que se altera de modo que solo Google aloje y propague una coincidencia desde una tabla de particiones. Se puede utilizar en los casos en que el ofertante no tenga permiso para alojar Los IDs de usuario de Google en su propia tabla de coincidencias Para usar este flujo, los ofertantes debe permitir que Google aloje la tabla de coincidencias, ya no puede especificar google_cm en las solicitudes al Servicio de Concordancia de Cookies de Google por lo tanto, no recibirán google_gid para propagar sus propios de coincidencias exactas. Una vez que Google establece una coincidencia para un usuario, los ofertantes pueden agregar a las listas de usuarios utilizando sus propios datos de cookies. Del mismo modo, las solicitudes de oferta para estos usuarios excluirán el ID de usuario de Google, pero incluirán datos de coincidencia alojados. R del flujo de trabajo revisado se resume en los pasos a continuación.

Para iniciar este flujo, el ofertante debe colocar una etiqueta de coincidencia de modo que se renderiza en el navegador del usuario. A diferencia del flujo de trabajo para los usuarios que no residan en EE.UU. con restricciones de privacidad, la etiqueta de coincidencia debe dirigir el navegador del usuario a tu cookie La URL coincide. Por ejemplo, con una URL de concordancia de cookies configurada como https://ad.network.com/pixel, se vería de la siguiente manera:

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

Cuando se cargue en el navegador del usuario, se solicitará un píxel al directorio URL de concordancia de cookies. Esta solicitud contendrá su cookie en el encabezado HTTP que se debe extraer para el siguiente paso.

El extremo de concordancia de cookies del ofertante debe redireccionar a la cookie de Google Servicio de concordancia, incluido el parámetro google_hm propagado con sus datos de cookies codificados en Base64 y seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto: lo siguiente:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

Google recibirá un redireccionamiento con los parámetros que especificaste, en además de la cookie de Google en los encabezados HTTP.

Paso 4: Si se especifica la URL del informe, Google muestra píxeles en caso de éxito o redireccionamiento de error

Si la operación de concordancia de cookies se realiza correctamente o si no hay ninguna cookie Se especificó la URL del informe coincidente para la cuenta del ofertante: Google publicará un píxel transparente de 1 x 1 de forma predeterminada y el flujo de trabajo finalizará aquí. Las impresiones de este usuario en las solicitudes de oferta posteriores incluirán la columna datos de coincidencia alojados en BidRequest.hosted_match_data para la Protocolo, o BidRequest.user.buyeruid para OpenRTB de Google para implementarlos. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencia alojados que especificaron.

De lo contrario, si se produce un error, Google enviará un redireccionamiento al URL del informe de concordancia de cookies con la causa del error especificada en el Parámetro google_error. Si la URL del Informe de concordancia de cookies del ofertante fuera https://ad.network.com/report, la URL de redireccionamiento se vería como:

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

El navegador del usuario redireccionará a la URL del Informe de concordancia de cookies del ofertante incluido el motivo del error (si corresponde) especificado por Google en el Parámetro google_error. Para obtener más información sobre cómo interpretar el error consulta la descripción del parámetro.

Paso 6: El ofertante publica píxeles transparentes de 1 x 1

El ofertante debe responder entregando un píxel transparente de 1 x 1 al navegador.

En este diagrama, se ilustra el flujo de trabajo predeterminado para los usuarios de estados de EE.UU. con restricciones de privacidad a continuación, donde las solicitudes y respuestas están representadas por una flecha, y los datos los artículos que los acompañan se enumeran entre paréntesis.

Parámetro Descripción
google_nid Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar mediante la pestaña Ofertantes recurso.
google_sc Este parámetro dejó de estar disponible. Establece la cookie de Google para la usuario si no hay uno presente. El valor del parámetro se ignora y puede omitirse. Omitir el parámetro genera un error si no hay cookies existe.
google_no_sc Este parámetro dejó de estar disponible. Esto indica a la nube de concordancia de cookies que no debería establecer una cookie para el usuario si uno no está presente. El valor del parámetro se ignora y puede omitido.
google_hm

Contiene datos que el ofertante desea almacenar en una coincidencia alojada en Google desde una tabla de particiones.
google_redir Una URL codificada a la que deseas que Google envíe un redireccionamiento HTTP 302. El la URL especificada recibirá redireccionamientos con el google_error para los errores y las operaciones exitosas.
google_ula Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El valor el formato esperado es userlistid[,timestamp]:
  • userlistid: Es un ID numérico de lista de usuarios único.
  • timestamp: Es una marca de tiempo opcional en formato POSIX. indica cuándo se agregó el usuario a la lista de usuarios.

Este parámetro de URL se puede repetir para agregar al usuario a varios listas.
gdpr Indica que la solicitud está sujeta a las restricciones de datos del GDPR de uso de la nube. Para obtener más información, consulta Requisitos de consentimiento de usuarios de la UE a continuación, o bien Impacto en la concordancia de cookies la elegibilidad en la . Documentación del MTC v2.0 de IAB de Authorized Buyers

Ejemplo: gdpr=1
gdpr_consent Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, Consulte los requisitos de consentimiento de usuarios de la UE. o ¿Cómo se pasará la cadena de TC? en la . Documentación del MTC v2.0 de IAB de Authorized Buyers
process_consent Indica que el ofertante obtuvo el consentimiento del usuario final para los usos de datos especificados en Política de Consentimiento de Usuarios de la UE de Google

Si la solicitud no está sujeta a la Política de Consentimiento de Usuarios de la UE o si hay otros parámetros de consentimiento disponibles en la solicitud (gdpr_consent), se ignora este parámetro.

Ejemplo: process_consent=T
Parámetro Descripción
google_error

Un número entero que indica el error de solicitud general. Cuándo recibidos, indica que no se realizaron operaciones y que ninguna otra Se establecerán google_ parámetros de respuesta. El error admitido incluyen lo siguiente:

  • 1: El usuario tiene una cookie de Google, pero inhabilitó alguna el seguimiento con esta cookie.
  • 2: No se especificaron operaciones válidas. por ejemplo, un modelo no-op si recibiste esa solicitud.
  • 3: El usuario no tiene una cookie de Google. Google no hará lo siguiente: configura la cookie a través del Servicio de concordancia de cookies.
  • 4: Se especificaron operaciones en conflicto. No estás se permite especificar los elementos google_push y google_cm en la misma solicitud, ya que tienen propósitos contradictorios.
  • 5: El parámetro google_push no es válido pasan un redireccionamiento a un servidor de Google como parte de una red bidireccional Solicitud de coincidencia de Pixel. El redireccionamiento debe establecer google_push con el mismo valor que se te pasó en la solicitud inicial de píxeles.
  • 6: Se proporcionó un NID no válido en la etiqueta de coincidencia.
  • 7: Se detectó una cookie no válida.
  • 8: Obsoleto. No se encontraron cookies.
  • 9: No se encontraron cookies; se intenta establecer una cookie de prueba.
  • 10: Se usó el parámetro google_redir. sin que se especifique google_hm, o se usó de forma adicional a google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que la tabla de coincidencias esté alojada en Google. Como resultado, esta respuesta no contiene un ID de usuario de Google. Actualmente, esta opción está habilitada para un pequeño porcentaje de tráfico, pero está planificado habilitarse por completo en Junio de 2020.

Iniciado por Google: Coincidencia bidireccional de píxeles

La concordancia bidireccional de píxeles es un flujo de trabajo para la concordancia de cookies de Google Servicio en el que Google intenta hacer coincidir un ID de usuario de Google con un ID al ofertante seleccionado que no sea el ganador de la subasta de Ofertas en tiempo real. Cuando un anuncio se Google colocará una etiqueta de coincidencia que indicará al navegador del usuario que cargue una píxel transparente de la URL de concordancia de cookies del ofertante elegido Esto habilitará tanto Google como el ofertante para completar una tabla de coincidencias con un usuario determinado. Abajo está un ejemplo sencillo de este flujo de trabajo.

Paso 1: Google coloca una etiqueta coincidente

Cuando la página de un editor participante se carga en el navegador del usuario, y una Google rellena el espacio publicitario de esa página, se puede colocar una etiqueta de concordancia solicita un píxel a un ofertante seleccionado algorítmico. La coincidencia de Pixel etiqueta colocada por Google combina la URL de concordancia de cookies del ofertante con parámetros adicionales que que el ofertante puede usar para propagar su tabla de coincidencias. Para una URL de concordancia de cookies especificado como https://ad.network.com/pixel, se estructura como sigue:

<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />

Los ofertantes que reciben solicitudes de coincidencia de píxeles deben responder con un redireccionar al Servicio de Concordancia de Cookies de Google que se estructura de la siguiente manera:

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

Ten en cuenta que la URL de redireccionamiento anterior es similar a la de la URL utilizada en el etiqueta de coincidencia del flujo de trabajo de concordancia de cookies iniciado por el ofertante. En la coincidencia de píxeles, el parámetro google_cm se reemplaza por el el parámetro google_push y su valor debe ser igual al valor proporcionadas por Google en la solicitud. También es similar a lo que inició el ofertante flujo de trabajo, parámetros adicionales para cumplir con casos de uso adicionales.

Paso 3: Google procesa el redireccionamiento y responde con píxeles

Google registra que se creó una coincidencia para el usuario y controla operaciones adicionales solicitadas a través de parámetros de consulta. Por último, Google responde con un píxel transparente de 1 x 1.

Diagrama del flujo de trabajo de Coincidencia de píxeles

Este flujo de trabajo se ilustra en el siguiente diagrama, donde las solicitudes y las respuestas están representadas por una flecha y los elementos de datos que las acompañan se enumeran entre paréntesis.

Parámetros de solicitud de la etiqueta de coincidencia de Google

Parámetro Descripción
google_gid Es el ID de usuario de Google. En el caso de los usuarios que no residen en un estado de EE.UU. con restricciones de privacidad, esta opción siempre se especificadas en la etiqueta de coincidencia de Google.
google_cver Es la versión de la cookie. Esto siempre se especificará en la coincidencia de Google etiqueta.
google_push Indica que esta solicitud inicia el flujo de trabajo de coincidencia de píxeles. El valor se debe devolver a través del parámetro correspondiente en la columna respuesta de redireccionamiento.

Parámetros de redireccionamiento de coincidencia de píxeles del ofertante

Parámetro Descripción
google_nid Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar mediante la pestaña Ofertantes recurso.
google_push Indica que este redireccionamiento está completando el proceso de coincidencia de Pixel. en el flujo de trabajo. El valor de la etiqueta de coincidencia de Google correspondiente debe tener se especifican aquí.
google_hm

Contiene datos que el ofertante desea almacenar en una coincidencia alojada en Google desde una tabla de particiones.
google_ula Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El valor el formato esperado es userlistid[,timestamp]:
  • userlistid: Es un ID numérico de lista de usuarios único.
  • timestamp: Es una marca de tiempo opcional en formato POSIX. indica cuándo se agregó el usuario a la lista de usuarios.

Este parámetro de URL se puede repetir para agregar al usuario a varios listas.

Iniciado por Google: Coincidencia unidireccional de píxeles

La Coincidencia unidireccional de píxeles difiere del flujo de trabajo bidireccional en que la etiqueta de coincidencia de Google no incluya un parámetro que especifique el nombre de usuario ID, pero continuará propagando una tabla de coincidencias alojada en Google. Esto se puede usar en los casos en que el ofertante no tenga permiso para alojar IDs de usuario de Google en su propia tabla de coincidencias. Un ejemplo sencillo del flujo de trabajo revisado se resume en el pasos a continuación.

Paso 1: Google coloca una etiqueta coincidente

Google coloca una etiqueta de coincidencia para un ofertante seleccionado algorítmico. La etiqueta de coincidencia incluye el Parámetro google_push. Por ejemplo:

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

Paso 2: El navegador del usuario solicita el píxel de la URL de cocina de coincidencia del ofertante

El navegador del usuario solicita un píxel de la URL de concordancia de cookies del ofertante. incluida la cookie del ofertante en los encabezados HTTP.

El extremo de concordancia de cookies del ofertante debe redireccionar a la cookie de Google Servicio de concordancia, incluido el parámetro google_hm propagado con sus datos de cookies codificados en Base64 y seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto: lo siguiente:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

Google recibirá un redireccionamiento con los parámetros que especificaste, en además de la cookie de Google en los encabezados HTTP. Si la operación era correctas, las impresiones para este usuario en las solicitudes de oferta posteriores incluirán los datos de coincidencia alojados del ofertante en BidRequest.hosted_match_data por el protocolo de Google, o BidRequest.user.buyeruid para la interfaz Implementación de OpenRTB. Los ofertantes también pueden propagar listas de usuarios coinciden con los datos que especificaron.

Por último, Google muestra un píxel transparente de 1 x 1 al navegador del usuario.

Open Bidding permite que los intercambios usen las ofertas Iniciadas por el ofertante. e iniciadas por Google flujos de trabajo de concordancia de cookies, para hacer coincidir un ID de usuario de Google con su cookie. Para galletas Match Assist (CMA) es una función adicional para los intercambios que les permite y crear tablas de coincidencias con sus propios ofertantes.

  1. Al colocar un anuncio, Google selecciona algorítmicamente un usuario Exchange y coloca una etiqueta de Cookie Match Assist con la siguiente información: estructura:

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

  2. La etiqueta de coincidencia de CMA de Google hace que la URL de concordancia de cookies del intercambio recibir una solicitud de píxel.

  3. El extremo de coincidencia de cookies del intercambio recibe la solicitud, su propio servicio de concordancia de cookies es responsable de hacer coincidir el ID del usuario con uno de sus ofertantes. En el siguiente diagrama, la coincidencia de cookies del intercambio servicio responde al navegador del usuario con un redireccionamiento a uno de los servidores de en los extremos.
  4. El ofertante recibe la solicitud, junto con cualquier parámetro que especifique que el intercambio haga coincidir el ID del usuario con su cookie.

Restricciones

Limitar la frecuencia de las solicitudes de coincidencias nuevas

Los ofertantes son responsables de limitar la cantidad de llamadas a la cookie. Servicio de coincidencias para los usuarios que tienen una entrada nueva en la coincidencia alojada en Google desde una tabla de particiones. Una entrada en la tabla de coincidencias alojada se puede considerar vencida en 14 días después de lo cual se puede actualizar.

Responde a todas las solicitudes de coincidencia de píxeles

Se espera que los ofertantes que utilizan el flujo de trabajo de Concordancia con píxeles respondan a todos Solicitudes entrantes de Pixel Match con una respuesta que incluye google_push parámetro. Esto le permite a Google aplicar políticas mediante la supervisión del uso. Si un si la tasa de respuesta del ofertante cae por debajo del 90%, Google limitará la cantidad de Se enviaron las solicitudes de Pixel Match a su cuenta.

Usa extremos HTTPS

Es obligatorio que los extremos que se usan en todos los flujos de trabajo de concordancia de cookies usen HTTPS

Al responder a una solicitud de Pixel Match que se te envió a través de HTTPS, tienes las siguientes opciones: para redireccionar al Servicio de concordancia de cookies a través de HTTPS. Del mismo modo, un extremo de Cookie Match Assist que redireccione a los ofertantes también debe usar HTTPS. Si envías solicitudes a Google a través de HTTP con más frecuencia que una vez cada 2 minutos Se limitará la cantidad de solicitudes de coincidencia enviadas a tu cuenta.

las solicitudes de concordancia de cookies que están sujetas Usuario de la UE de Google La Política de Consentimiento debe indicar el consentimiento del usuario final. Dichas solicitudes son necesarias para indique que se recopiló el consentimiento de una de las siguientes maneras:

Ejemplos

Los siguientes ejemplos ilustran cómo utilizar el servicio de concordancia de cookies para lo siguiente: lograr objetivos específicos. Ten en cuenta que, a menos que se indique lo contrario, es se supone que el usuario sobre el que se actúa no es Estado de EE.UU. con restricciones de privacidad.

Propagar una tabla de coincidencias alojada por el ofertante

Un ofertante puede usar el flujo de trabajo de concordancia de cookies para propagar su propia coincidencia proporcionando solo los objetos google_nid y google_cm parámetros en su etiqueta de coincidencia. El aspecto podría ser el siguiente:

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

Si la URL de concordancia de cookies del ofertante está configurada como https://ad.network.com/pixel?id=1 y la operación de concordancia de cookies es exitosa, el redireccionamiento que envía Google respuesta a la etiqueta de coincidencia del ofertante podría tener el siguiente aspecto:

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

Si la operación de concordancia de cookies falla porque el usuario no tiene un cookie de Google, la respuesta sería:

https://ad.network.com/pixel?id=1&google_error=3

El código de error depende de la causa subyacente del error. Para aprender para obtener más información sobre los posibles códigos de error del flujo de trabajo de concordancia de cookies, consulta la parámetros de redireccionamiento de la URL.

Agregar a una sola lista de usuarios

El parámetro google_ula se puede especificar en la coincidencia de un ofertante etiqueta para agregar al usuario a una lista de usuarios con un ID determinado. Si el botón de Google o la tabla de coincidencias alojada por el ofertante tiene una entrada nueva para el usuario, este puede colocar una etiqueta de coincidencia que incluya google_nid y google_ula parámetros para agregar al usuario a la lista especificada sin iniciar el proceso Flujo de trabajo de concordancia de cookies. Consulta las restricciones. sobre cómo invocar el servicio de concordancia de cookies para obtener más detalles. El modelo de la etiqueta de coincidencia podría verse así:

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

Para una respuesta exitosa, cuando la URL de concordancia de cookies del ofertante sea https://ad.network.com/pixel, la URL de redireccionamiento de Google sería la siguiente:

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

Si hay un error general, por ejemplo, no hay una cookie de Google para el usuario, la URL de redireccionamiento incluirá el elemento Parámetro google_error:

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

Si hay un error específicamente relacionado con agregar al usuario a la lista, recibirás google_ula en el redireccionamiento. A diferencia de parámetro de etiqueta de coincidencia correspondiente; esto reemplaza la marca de tiempo por un estado código para indicar el éxito de la operación. Por ejemplo, si la solicitud falló porque la cuenta del ofertante no tenía acceso a la lista de usuarios especificada, la URL de redireccionamiento sería la siguiente:

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

Agregar a varias listas de usuarios

Los ofertantes pueden especificar que un usuario se debe agregar a varias listas de usuarios de la siguiente manera: incluidos varios parámetros google_ula en la etiqueta de coincidencia. En práctica, esto podría verse así:

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

El estado de la operación para cada lista de usuarios se informa de manera similar a través de Parámetros google_ula distintos en el redireccionamiento:

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

En el redireccionamiento anterior, podemos ver que la operación se realizó correctamente para el usuario. lista con el ID 45678, pero falló con el ID de lista de usuarios 12345 porque el ofertante no tenía permiso para acceder a ella.

Para realizar la concordancia de cookies y agregar el usuario a una lista de usuarios de una solicitud, la etiqueta de coincidencia de un ofertante debe incluir google_cm y google_ula

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

La URL de redireccionamiento especificada por Google incluye google_gid, google_cver y google_ula. Esto podría verse así lo siguiente:

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

Cómo almacenar una coincidencia en una tabla de coincidencias alojada en Google

Si un ofertante quiere almacenar sus datos de cookies en una tabla de coincidencias alojada en Google, y no pretende almacenar una coincidencia con el ID de usuario de Google en su propia coincidencia. tabla, su etiqueta de coincidencia debe incluir el parámetro google_hm, en el que su valor debe ser una cadena codificada en base64 segura para la Web. Para un usuario en el que los datos de cookies sin codificación del ofertante son Cookie number 1!, el valor sería Q29va2llIG51bWJlciAxIQ==, que se usaría en un coincide con la etiqueta como se muestra a continuación:

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

Para una respuesta exitosa, cuando la URL de concordancia de cookies del ofertante sea https://cookie-monster.com/pixel, la URL de redireccionamiento de Google ser:

https://cookie-monster.com/pixel

El parámetro google_gid no se encuentra en el redireccionamiento porque el elemento la etiqueta de coincidencia no incluía google_cm, y google_hm es no se incluyen en las respuestas exitosas. En futuras solicitudes de oferta para impresiones para este usuario, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.hosted_match_data para el protocolo de RTB de Google BidRequest.user.buyeruid para la implementación de OpenRTB de Google.

Si, en cambio, el ofertante usó una etiqueta de coincidencia en la que el valor de google_hm no estaba codificado en base64, por ejemplo, chocolate_chunk!: la URL de redireccionamiento podría ser similar a la lo siguiente:

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

La URL de redireccionamiento anterior incluye un valor google_hm de 2, lo que sugiere que la operación falló porque el valor podría no pueden decodificarse.

Tablas de coincidencia alojadas en Google y ofertantes con listas de usuarios

Si un ofertante aloja su propia lista de uso además de un usuario alojado en Google y desea que una sola etiqueta de coincidencia coincida con ambas tablas y agregue al usuario a un lista de usuarios determinada, su etiqueta de coincidencia debe incluir google_cm, Parámetros google_hm y google_ula. Si el ofertante los datos de cookies son Cookie number 1!, el valor codificado sería Q29va2llIG51bWJlciAxIQ==, que produciría una etiqueta de coincidencia como la lo siguiente:

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

Para una respuesta exitosa, cuando la URL de concordancia de cookies del ofertante sea https://cookie-monster.com/pixel, la URL de redireccionamiento de Google verse de la siguiente manera:

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

Al recibir el redireccionamiento, el ofertante puede coincidir con el ID de usuario de Google especificado. en google_gid con los datos de sus cookies en su tabla de coincidencias. En además de determinar si la tabla de coincidencias y la lista de usuarios alojadas en Google de que se llevaron a cabo correctamente. En consecuencia, cualquier segmentación previa para el ofertante configurado para orientarse al ID de la lista de usuarios especificado, ahora el ofertante recibir solicitudes de oferta para impresiones del usuario. Del mismo modo, en estas ofertas el ofertante recibirá sus datos de coincidencia alojados en BidRequest.hosted_match_data para el protocolo de RTB de Google BidRequest.user.buyeruid para la implementación de OpenRTB de Google.