Concordancia de cookies

La correlación de cookies es una función que te permite correlacionar tu cookie (por ejemplo, un ID de un usuario que navegó por tu sitio web) con un ID de usuario de Google específico del postor correspondiente y crear listas de usuarios que pueden ayudarte a tomar decisiones de ofertas más eficaces. En esta guía, se describen los conceptos que se utilizan en la correlación de cookies, así como los diferentes flujos de trabajo de la correlación de cookies y las variaciones que pueden tener para ciertos casos de uso.

Conceptos

Por lo general, los propietarios de dominios establecen el contenido de las cookies para los usuarios que navegan por su sitio, que se utilizan para identificar a los usuarios dentro de ese dominio. Incluso si dos propietarios de dominios aceptaran intercambiar estos datos, el modelo de seguridad de los navegadores de Internet restringe la lectura de una cookie establecida 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 postores que participan en la oferta en tiempo real pueden tener su propio dominio en el que identifican a un conjunto de usuarios a los que les gustaría mostrar anuncios. La correlación de cookies permite que el ofertante correlacione sus cookies con las de Google para determinar si una impresión enviada en una solicitud de oferta está asociada con uno de los usuarios segmentados. Recibirá sus propios datos de cookies o un ID de usuario de Google específico del ofertante que es una forma encriptada de la cookie doubleclick.net en la solicitud de oferta.

El servicio de correlación de cookies que se describe en esta guía facilita la creación y el mantenimiento de la asociación entre la cookie de un ofertante y el ID de usuario de Google, y también permite completar listas de usuarios.

Tablas de coincidencias

Se puede usar una tabla de coincidencias para asignar un ID o cualquier otro dato de un dominio a otro. Los postores pueden usar el Servicio de coincidencias de cookies para completar sus propias tablas de coincidencias asignando su cookie para un usuario determinado al ID de usuario de Google de ese usuario o para completar una tabla de coincidencias alojada por Google. Las tablas de correlación son necesarias para que la aplicación del ofertante de un ofertante acceda a los datos de cookies del usuario al que se le muestra la impresión.

Tablas de coincidencias alojadas en Google

Para facilitar el mantenimiento, mejorar la latencia y acceder a los datos de coincidencias de los usuarios en ciertas regiones, te recomendamos que permitas que Google aloje tu tabla de coincidencias. Esto te permite especificar una cadena codificada en base64 segura para la Web (en adelante, datos de coincidencia alojados) que se asignará al ID de usuario de Google de un usuario determinado. Una vez que se establece una coincidencia, se puede usar de las siguientes maneras:

  • Ofertas en tiempo real: En las solicitudes de ofertas posteriores para las impresiones asociadas con el usuario, Google te enviará los datos de correlación alojados con los que correlacionaste su ID de usuario de Google. Google especificará BidRequest.user.buyeruid como una cadena codificada en base64 segura para la Web.

  • Listas de usuarios: Las listas de usuarios se pueden completar con IDs de usuario de Google o datos de coincidencias alojados.

  • Segmentación previa: Puedes configurar tu segmentación previa de modo que solo recibas solicitudes de ofertas que contengan datos de coincidencias alojados. Esto se puede usar para eliminar las impresiones menos relevantes para los usuarios que no se encuentran en tu espacio de cookies.

Listas de usuarios

Las listas de usuarios se pueden crear y administrar con la API de Real-Time Bidding. Una vez creadas, puedes propagar estas listas con los siguientes flujos de trabajo de Cookie Matching o a través del Servicio de carga masiva.

Comenzar

Para comenzar a utilizar la correlación de cookies, debes comunicarte con tu administrador técnico de cuentas, quien puede habilitar flujos de trabajo específicos y ayudarte a configurar lo siguiente:

  • ID de red de coincidencia de cookies (NID): Es un ID de cadena que identifica de forma única una cuenta de ofertante para la coincidencia de cookies y otras operaciones relacionadas.
  • URL de Cookie Matching: Es la URL base de un extremo que aceptará y controlará las solicitudes entrantes como parte de los flujos de trabajo de Cookie Matching. Los ofertantes pueden incorporar macros en esta URL para controlar el orden de los parámetros que se le pasan en los flujos de trabajo de la correlación de cookies.
  • Etiqueta de coincidencia: Es la etiqueta que debes colocar en el navegador de un usuario para el flujo de trabajo de la correlación de cookies iniciada por el ofertante. Se puede publicar junto con anuncios o colocarse en propiedades web fuera de los anuncios.
  • URL del informe de coincidencias de cookies (opcional): En el flujo de trabajo de coincidencias de cookies unidireccional, esta es una URL opcional que se puede proporcionar para especificar un extremo que recibirá detalles del error en caso de que falle la coincidencia de cookies a través de un redireccionamiento HTTP 302. De forma predeterminada, las respuestas solo se enviarán a esta URL si hubo un error en la operación de coincidencia de cookies, pero los postores pueden solicitar que siempre se envíe el redireccionamiento.
  • URL de Cookie Match Assist: Para los intercambios que implementan el flujo de trabajo de Cookie Match Assist, esta es la URL base del extremo que responderá a las solicitudes entrantes.
  • Cuota de Cookie Match Assist: Para los intercambios que implementan el flujo de trabajo de Cookie Match Assist, esta es la cantidad máxima de solicitudes que puede recibir su URL de Cookie Matching por segundo. Esto tiene como objetivo evitar que las solicitudes de la CMA sobrecarguen los servidores del intercambio.

En cualquiera de los flujos de trabajo de la correlación de cookies admitidos, la URL de correlación de cookies de un ofertante suele tener parámetros anexados en un orden no garantizado. Los licitadores con integraciones que requieren un orden coherente de los parámetros pueden colocar macros en su URL de Cookie Matching para indicar su posición.

Macros compatibles

De manera opcional, los postores pueden configurar su URL de Cookie Matching para incluir una o más macros en formato %%GOOGLE_<PARAM_NAME>%% o %%GOOGLE_<PARAM_NAME>_PAIR%%. Las macros admitidas y sus valores expandidos son los siguientes:

Macro Valor expandido
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

Ejemplo de macro

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

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 más tarde una solicitud de coincidencia a este ofertante, se expandirá a algo similar a 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

El Servicio de correlación de cookies de Google admite los siguientes tres flujos de trabajo.

La correlación de cookies bidireccional hace referencia a un flujo de trabajo iniciado por el postor, en el que este coloca una etiqueta de correlación en el navegador del usuario que lo dirige a Google. Este flujo de trabajo permite que tanto Google como el ofertante completen las tablas de coincidencias. A continuación, se muestra un ejemplo de este flujo de trabajo.

Paso 1: Coloca la etiqueta de correlación

Para iniciar este flujo, el ofertante debe colocar su etiqueta de coincidencia de modo que se renderice en el navegador del usuario. Una etiqueta de coincidencia que solo devuelve el ID de usuario de Google al postor puede estructurarse de la siguiente manera:

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

Hay parámetros adicionales que puedes incluir en la etiqueta de coincidencia para satisfacer diferentes casos de uso. Para obtener más información sobre estos parámetros, consulta Parámetros de URL de la etiqueta de coincidencia.

Paso 2: Google responde con un redireccionamiento que incluye datos de coincidencia

La etiqueta de coincidencia hará que el Servicio de Coincidencia de Cookies de Google reciba una solicitud del navegador del usuario, que emitirá un redireccionamiento HTTP 302 a la URL de Coincidencia de Cookies del ofertante. El redireccionamiento incluirá parámetros de consulta que especifican el ID de usuario de Google y su número de versión en la URL, y el ofertante también recibirá su cookie incluida en los encabezados de la solicitud. En la práctica, para una URL de coincidencia de cookies especificada como https://ad.network.com/pixel, la URL de redireccionamiento de la etiqueta de coincidencia anterior podría verse de la siguiente manera:

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 cadena codificada en base64 segura para la Web y sin relleno. Para los ofertantes que eligen alojar una tabla de coincidencias, se recomienda que almacenen la cadena exacta que devuelve el Servicio de Cookie Matching. En las solicitudes de oferta posteriores, esto corresponderá a los valores especificados a través de BidRequest.user.id.

La versión especificada en google_cver indica el número de versión numérica del ID de usuario de Google. El ID de usuario de Google para un usuario determinado cambiará con poca frecuencia, y luego se incrementará.

Si Google encuentra un error mientras procesa tu solicitud de coincidencia, se especificará un parámetro google_error.

Paso 3: El procesador de ofertas procesa el redireccionamiento y responde con el píxel

El postor recibe un redireccionamiento a su URL de coincidencia de cookies, incluidos los parámetros que especificó en el primer paso y los que proporcionó Google en el segundo. Además, también recibirán su cookie en los encabezados HTTP. 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. Se recomienda que los postores almacenen la cadena exacta que devuelve el Servicio de Cookie Matching.

Si la operación no se realizó correctamente, el postor recibirá un parámetro 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 obtener más información sobre los posibles valores de error en la descripción del parámetro de URL google_error. Si recibes un error, puedes intentar volver a hacer la correlación para ese usuario colocando una nueva etiqueta de correlación.

El postor siempre debe responder publicando una imagen de píxel invisible de 1 x 1 o, de manera alternativa, devolver una respuesta HTTP 204 Sin contenido.

Este flujo de trabajo se ilustra en el siguiente diagrama, en el que las solicitudes y las respuestas se representan con una flecha, y los elementos de datos que las acompañan se enumeran entre paréntesis.

Parámetros de URL de la etiqueta de coincidencia

Parámetro Descripción
google_nid Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar a través del recurso Bidders.
google_cm Indica al Servicio de Concordancia de Cookies de Google que debe realizar la concordancia de cookies. Se ignora el valor del parámetro y se puede omitir.
google_sc Este parámetro dejó de estar disponible. Establece la cookie de Google para el usuario si no hay una presente. Se ignora el valor del parámetro y se puede omitir. Si se omite el parámetro, se produce un error si no existe ninguna cookie.
google_no_sc Este parámetro dejó de estar disponible. Esto indica al servicio de correlación de cookies de Google que no debe establecer una cookie para el usuario si no hay una presente. Se ignora el valor del parámetro y se puede omitir.
google_hm

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

El valor es una cadena codificada en base64 segura para la Web (el relleno es opcional). Los datos sin procesar deben tener 40 bytes o menos. Por ejemplo, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.
google_redir Es una cadena codificada en URL que un postor puede especificar si desea indicarle a Google que envíe el redireccionamiento HTTP 302 a la URL codificada para esta etiqueta de coincidencia. Esto permite que Google se coloque al frente en una llamada encadenada 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 el usuario a una lista de usuarios existente. El formato esperado del valor es userlistid[,timestamp]:
  • userlistid: Es un solo ID numérico de la lista de usuarios.
  • timestamp: Es una marca de tiempo opcional en formato POSIX que 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 varias listas.
gdpr Indica que la solicitud está sujeta a las restricciones del RGPD sobre el uso de datos. Para obtener más detalles, consulta los requisitos de consentimiento de usuarios de la UE o el Impacto en la elegibilidad para la correlación de cookies 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, consulta los requisitos de consentimiento del usuario 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 los datos especificados en la 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 postores pueden especificar los suyos propios, que se agregarán como parámetros a la URL de redireccionamiento. Ten en cuenta que se ignorarán los parámetros definidos por el postor que tengan el prefijo google_, ya que Google los reserva para el desarrollo futuro, y no se garantiza la conservación del orden de los parámetros. Una etiqueta de coincidencia que incluye parámetros definidos por el postor puede verse 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 compila a partir de la URL base de la coincidencia de cookies configurada para la cuenta de un ofertante, incluidos los parámetros google_ y los definidos por el ofertante, según los especificados en la etiqueta de coincidencia. Se definen los siguientes parámetros de respuesta de google_:

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

Es un valor de número entero que indica el error general de la solicitud. Cuando se recibe, indica que no se realizaron operaciones y que no se establecerán otros parámetros de respuesta de google_. Los valores de error admitidos incluyen los siguientes:

  • 1: El usuario tiene una cookie de Google, pero inhabilitó cualquier seguimiento con esta cookie.
  • 2: No se especificaron operaciones válidas. Por ejemplo, se recibió una solicitud de no operación.
  • 3: El usuario no tiene una cookie de Google. Google no establecerá la cookie a través del Servicio de correlación de cookies.
  • 4: Se especificaron operaciones en conflicto. No puedes especificar las marcas google_push y google_cm en la misma solicitud, ya que tienen propósitos contradictorios.
  • 5: Se pasó un parámetro google_push no válido en un redireccionamiento a un servidor de Google como parte de una solicitud de Pixel Matching bidireccional. Tu redireccionamiento debe establecer google_push en el mismo valor que se te pasó en la solicitud inicial del píxel.
  • 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 encontró ninguna cookie.
  • 9: No se encontró ninguna cookie, se intentó establecer una cookie de prueba.
  • 10: Se usó el parámetro google_redir sin especificar google_hm, o bien se usó junto con google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que Google aloje la tabla de coincidencias. Como resultado, esta respuesta no contiene un ID de usuario de Google.
google_hm

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

  • 1 - Forbidden: El cliente no tiene acceso para escribir entradas en la tabla de coincidencias alojada.
  • 2: Error de decodificación. No se pudo decodificar el valor del parámetro.
  • 3: La carga útil es demasiado larga. El valor del parámetro se decodificó en más de 40 bytes de datos.
  • 4 - Error interno: Se produjo un error interno al almacenar los datos.
  • 5: Se limitó esta escritura, por lo que no se procesó.
google_ula

Es el estado de la operación de agregar listas de usuarios, que se repite si se especificaron varios google_ula en la solicitud. El formato es:
userlistid,status code

Ejemplo: google_ula=1234567890,0

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

  • 0: No hay errores. El usuario se agregó a la lista de usuarios.
  • 2: Se rechazó el permiso. No tienes permiso para agregar usuarios a la lista de usuarios proporcionada.
  • 5: El ID de la lista de usuarios no es válido. El ID de la lista de usuarios proporcionado no es válido.
  • 6: Es el ID del atributo cerrado. El ID de la lista de usuarios proporcionado está cerrado.
  • 10: Error interno. El servicio de Cookie Matching detectó un error interno. Puedes volver a intentar la correlación del usuario.

En las siguientes situaciones, se describe cómo podría ser la correlación de cookies para un usuario típico que navega por una página web.

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

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

Esto es lo que ocurre:

  1. ExampleNews.com renderiza y llama a los anuncios de Google (Ad Manager).
  2. Dado que la unidad de anuncios es apta para la asignación dinámica, Google envía solicitudes de ofertas a FinestDSP y a otros licitadores a través del servicio de Licitación en tiempo real.
  3. La aplicación del ofertante de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta de oferta.
  4. Google recibe respuestas de ofertas de los ofertantes, incluida la respuesta de FinestDSP que especifica 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 Ana.
  6. La etiqueta de coincidencia llama al servicio de Cookie Match de Google y especifica los parámetros google_nid y google_cm.
  7. El Servicio de concordancia de cookies lee la cookie de Google de Ana y envía al navegador de Ana un redireccionamiento a la URL de concordancia de cookies de FinestDSP con los parámetros google_gid y google_cver establecidos.
  8. El navegador de Jane carga el redireccionamiento a la URL de Cookie Match de FinestDSP.
  9. El extremo de coincidencia 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 los encabezados HTTP. Ahora FinestDSP puede almacenar la asignación de su cookie al google_gid 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 de la situación 1, Ana vuelve a visitar EjemploNoticias.com. Ahora que Jane tiene cookies del ofertante y de Ad Manager en su computadora, así es como funciona la correlación.

  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 aplicables, incluido FinestDSP.
  3. FinestDSP recibe la solicitud de oferta, incluidas señales como google_gid.
  4. FinestDSP busca el google_gid en su tabla de coincidencias y encuentra la cookie asociada a Ana que se creó una semana antes (en la situación 1).
  5. Según la información asociada con la cookie, la lógica de ofertas de FinestDSP realiza una oferta por la impresión y gana la subasta.
  6. Es posible que Julia vea un anuncio adaptado a sus intereses, según la información que posee FinestDSP.

La correlación de cookies unidireccional es similar al flujo de trabajo bidireccional, excepto que se modifica de modo que solo Google aloja y completa una tabla de correlación. Se puede usar en los casos en que el postor no tiene permiso para alojar IDs de usuario de Google en su propia tabla de coincidencias. Para usar este flujo, los postores deben permitir que Google aloje la tabla de coincidencias, ya no pueden especificar google_cm en las solicitudes al Servicio de Cookie Matching de Google y, en consecuencia, no recibirán google_gid para completar su propia tabla de coincidencias. Una vez que Google establece una coincidencia para un usuario, los postores pueden agregarlo a las listas de usuarios con sus propios datos de cookies. Del mismo modo, las solicitudes de ofertas para estos usuarios excluirán el ID de usuario de Google, pero incluirán los datos de la correlación alojada. En los siguientes pasos, se resume un ejemplo del flujo de trabajo revisado.

Paso 1: Coloca la etiqueta de coincidencia dirigida a la URL de coincidencia de cookies del postor

Para iniciar este flujo, un ofertante debe colocar una etiqueta de coincidencia de modo que se renderice en el navegador del usuario. A diferencia del flujo de trabajo para los usuarios que no provienen de un estado de EE.UU. con restricciones de privacidad, la etiqueta de coincidencia debe dirigir el navegador del usuario a tu URL de Cookie Matching. Por ejemplo, con una URL de coincidencia 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, solicitará un píxel desde la URL de Cookie Matching del postor. Esta solicitud contendrá su cookie en el encabezado HTTP, que se debe extraer para el siguiente paso.

El extremo de concordancia de cookies del postor debe redireccionar al servicio de concordancia de cookies de Google, incluido el parámetro google_hm completado con los datos de cookies codificados en base64 seguro para la Web. La URL de redireccionamiento podría verse de la siguiente manera:

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

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

Paso 4: Google publica el píxel en el redireccionamiento de éxito o error si se especificó la URL del informe

Si la operación de correlación de cookies se realiza correctamente, o si no se especificó ninguna URL del Informe de correlación de cookies para la cuenta del postor, Google publicará un píxel transparente de 1 x 1 de forma predeterminada, y el flujo de trabajo finalizará aquí. Las impresiones para este usuario en las solicitudes de ofertas posteriores incluirán los datos de coincidencias alojados del ofertante en BidRequest.user.buyeruid. Los postores también pueden completar listas de usuarios con los datos de la correlación alojada que especificaron.

De lo contrario, si se produjo un error, Google enviará un redireccionamiento a la URL del Informe de correlación de cookies del postor con la causa del error especificada en el parámetro google_error. Si la URL del informe de coincidencias de cookies del postor fuera https://ad.network.com/report, la URL de redireccionamiento se vería de la siguiente manera:

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

El navegador del usuario se redireccionará a la URL del Informe de correlación de cookies del postor, que incluye 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 código de error, consulta la descripción del parámetro.

Paso 6: El ofertante publica un píxel transparente de 1 x 1

El postor debe responder publicando un píxel transparente de 1 x 1 en el navegador del usuario.

El siguiente diagrama ilustra el flujo de trabajo predeterminado para los usuarios de estados de EE.UU. con restricciones de privacidad, en el que las solicitudes y las respuestas se representan con una flecha, y los elementos de datos que las 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 a través del recurso Bidders.
google_sc Este parámetro dejó de estar disponible. Establece la cookie de Google para el usuario si no hay una presente. Se ignora el valor del parámetro y se puede omitir. Si se omite el parámetro, se produce un error si no existe ninguna cookie.
google_no_sc Este parámetro dejó de estar disponible. Esto indica al servicio de correlación de cookies de Google que no debe establecer una cookie para el usuario si no hay una presente. Se ignora el valor del parámetro y se puede omitir.
google_hm

Contiene los datos que el ofertante desea almacenar en una tabla de correlación alojada en Google.
google_redir Es una URL codificada a la que quieres que Google envíe un redireccionamiento HTTP 302. La URL especificada recibirá redireccionamientos con el parámetro google_error tanto para los errores como para las operaciones exitosas.
google_ula Es una cadena que se usa para agregar el usuario a una lista de usuarios existente. El formato esperado del valor es userlistid[,timestamp]:
  • userlistid: Es un solo ID numérico de la lista de usuarios.
  • timestamp: Es una marca de tiempo opcional en formato POSIX que 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 varias listas.
gdpr Indica que la solicitud está sujeta a las restricciones del RGPD sobre el uso de datos. Para obtener más detalles, consulta los requisitos de consentimiento de usuarios de la UE o el Impacto en la elegibilidad para la correlación de cookies 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, consulta los requisitos de consentimiento del usuario 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 los datos especificados en la 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

Es un valor de número entero que indica el error general de la solicitud. Cuando se recibe, indica que no se realizaron operaciones y que no se establecerán otros parámetros de respuesta de google_. Los valores de error admitidos incluyen los siguientes:

  • 1: El usuario tiene una cookie de Google, pero inhabilitó cualquier seguimiento con esta cookie.
  • 2: No se especificaron operaciones válidas. Por ejemplo, se recibió una solicitud de no operación.
  • 3: El usuario no tiene una cookie de Google. Google no establecerá la cookie a través del Servicio de correlación de cookies.
  • 4: Se especificaron operaciones en conflicto. No puedes especificar las marcas google_push y google_cm en la misma solicitud, ya que tienen propósitos contradictorios.
  • 5: Se pasó un parámetro google_push no válido en un redireccionamiento a un servidor de Google como parte de una solicitud de Pixel Matching bidireccional. Tu redireccionamiento debe establecer google_push en el mismo valor que se te pasó en la solicitud inicial del píxel.
  • 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 encontró ninguna cookie.
  • 9: No se encontró ninguna cookie, se intentó establecer una cookie de prueba.
  • 10: Se usó el parámetro google_redir sin especificar google_hm, o bien se usó junto con google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que Google aloje la tabla de coincidencias. Como resultado, esta respuesta no contiene un ID de usuario de Google.

Iniciada por Google: Coincidencia de píxeles bidireccional

La concordancia de píxeles bidireccional es un flujo de trabajo del servicio de concordancia de cookies de Google en el que Google intenta correlacionar un ID de usuario de Google con un ofertante seleccionado de forma algorítmica que no sea el ganador de la subasta de Licitación en tiempo real. Cuando se publica un anuncio, Google coloca una etiqueta de coincidencia que dirige el navegador del usuario para que cargue un píxel transparente desde la URL de Cookie Matching del ofertante elegido. Esto permitirá que tanto Google como el ofertante propaguen una tabla de coincidencias con un usuario determinado. A continuación, se muestra un ejemplo de este flujo de trabajo.

Paso 1: Google coloca una etiqueta de coincidencia

Cuando se carga la página de un publicador participante en el navegador del usuario y Google completa un espacio publicitario en esa página, es posible que se coloque una etiqueta de coincidencia que solicite un píxel a un ofertante seleccionado de forma algorítmica. La etiqueta de Pixel Matching que coloca Google combina la URL de Cookie Matching del ofertante con parámetros adicionales que el ofertante puede usar para completar su tabla de coincidencias. Para una URL de coincidencia de cookies especificada como https://ad.network.com/pixel, se estructura de la siguiente manera:

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

Los postores que reciben solicitudes de coincidencia de píxeles deben responder con un redireccionamiento al Servicio de coincidencia de cookies de Google estructurado 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 que se usa en la etiqueta de coincidencia para el flujo de trabajo de coincidencia de cookies iniciada por el ofertante. En la correlación de píxeles, el parámetro google_cm se reemplaza por el parámetro google_push, y su valor debe ser igual al valor que proporciona Google en la solicitud. Al igual que en el flujo de trabajo iniciado por el ofertante, se pueden especificar parámetros adicionales para satisfacer casos de uso adicionales.

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

Google registra que se creó una coincidencia para el usuario y controla cualquier operación adicional solicitada 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 la coincidencia de píxeles

Este flujo de trabajo se ilustra en el siguiente diagrama, en el que las solicitudes y las respuestas se representan con 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 ID de usuario de Google. Para los usuarios que no provienen de un estado de EE.UU. con restricciones de privacidad, esto siempre se especificará en la etiqueta de coincidencia de Google.
google_cver Es la versión de la cookie. Siempre se especificará en la etiqueta de coincidencia de Google.
google_push Indica que esta solicitud inicia el flujo de trabajo de la correlación de píxeles. El valor se debe devolver a través del parámetro correspondiente en la respuesta de redireccionamiento del postor.
gdpr_consent Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, consulta [Requisitos de consentimiento del usuario de la UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) o **¿Cómo se pasará la cadena de TC?** en la [documentación de Authorized Buyers sobre el MTC de IAB v2.0](//support.google.com/authorizedbuyers/answer/9789378).

Parámetros de redireccionamiento de la 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 a través del recurso Bidders.
google_push Indica que este redireccionamiento completa el flujo de trabajo de la correlación de píxeles. Aquí se debe especificar el valor de la etiqueta de coincidencia de Google correspondiente.
google_hm

Contiene los datos que el ofertante desea almacenar en una tabla de correlación alojada en Google.
google_ula Es una cadena que se usa para agregar el usuario a una lista de usuarios existente. El formato esperado del valor es userlistid[,timestamp]:
  • userlistid: Es un solo ID numérico de la lista de usuarios.
  • timestamp: Es una marca de tiempo opcional en formato POSIX que 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 varias listas.
gdpr_consent Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, consulta [Requisitos de consentimiento del usuario de la UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) o **¿Cómo se pasará la cadena de TC?** en la [documentación de la versión 2.0 del MTC del IAB de Compradores Autorizados](//support.google.com/authorizedbuyers/answer/9789378).

Iniciada por Google: Coincidencia de píxeles unidireccional

La correlación de píxeles unidireccional difiere del flujo de trabajo bidireccional en que la etiqueta de correlación de Google no incluye un parámetro que especifique el ID de usuario de Google, pero seguirá completando una tabla de correlación alojada en Google. Se puede usar en los casos en los que el ofertante no tiene permiso para alojar IDs de usuario de Google en su propia tabla de coincidencias. En los siguientes pasos, se resume un ejemplo del flujo de trabajo revisado.

Paso 1: Google coloca una etiqueta de coincidencia

Google coloca una etiqueta de coincidencia para un ofertante seleccionado de forma algorítmica. 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 a la URL de Cooking Matching del postor

El navegador del usuario solicita un píxel a la URL de Cookie Matching del postor, lo que incluye la cookie del postor en los encabezados HTTP.

El extremo de concordancia de cookies del postor debe redireccionar al servicio de concordancia de cookies de Google, incluido el parámetro google_hm completado con los datos de cookies codificados en base64 seguro para la Web. La URL de redireccionamiento podría verse de la siguiente manera:

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

Google recibirá un redireccionamiento que contiene los parámetros que especificaste, además de la cookie de Google en los encabezados HTTP. Si la operación se realizó correctamente, las impresiones para este usuario en las solicitudes de ofertas posteriores incluirán los datos de coincidencia alojados del ofertante en BidRequest.user.buyeruid. Los postores también pueden completar listas de usuarios con los datos de la correlación alojada que especificaron.

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

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

  1. Cuando se publica un anuncio, el algoritmo de Google selecciona un intercambio participante y coloca una etiqueta de Cookie Match Assist que tiene la siguiente estructura:

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

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

  3. El extremo de Cookie Matching del intercambio recibe la solicitud, en la que su propio servicio de Cookie Matching es responsable de correlacionar el ID de usuario con uno de sus ofertantes. En el siguiente diagrama, el servicio de coincidencia de cookies del exchange responde al navegador del usuario con un redireccionamiento a uno de los extremos del ofertante.
  4. El ofertante recibe la solicitud junto con los parámetros que especificó el exchange para hacer coincidir el ID de usuario con su cookie.

Restricciones

Limita la frecuencia de las solicitudes de coincidencias recientes

Los licitadores son responsables de limitar la cantidad de llamadas al servicio de Cookie Matching para los usuarios que tienen una entrada nueva en la tabla de coincidencias alojada en Google. Una entrada en la tabla de coincidencias alojada se puede considerar vencida después de 14 días, tras lo cual se puede actualizar.

Responde a todas las solicitudes de coincidencia de píxeles

Se espera que los postores que utilizan el flujo de trabajo de la correlación de píxeles respondan a todas las solicitudes entrantes de correlación de píxeles con una respuesta que incluya el parámetro google_push. Esto permite que Google aplique políticas supervisando el uso. Si la tasa de respuesta de un ofertante es inferior al 90%, Google limitará la cantidad de solicitudes de Pixel Match que se envíen a su cuenta.

Usa extremos HTTPS

Es obligatorio que los extremos utilizados en todos los flujos de trabajo de la correlación de cookies usen HTTPS.

Cuando respondas a una solicitud de Pixel Match que se te envió a través de HTTPS, deberás redireccionar al Servicio de Cookie Matching a través de HTTPS. Del mismo modo, un extremo de Cookie Match Assist que redirecciona a los licitadores también debe usar HTTPS. Si envías solicitudes a Google a través de HTTP más de una vez cada 2 minutos, se limitará la cantidad de solicitudes de coincidencia que se envíen a tu cuenta.

Las solicitudes de correlación de cookies que estén sujetas a la Política de Consentimiento de Usuarios de la UE de Google deben indicar el consentimiento del usuario final. Estas solicitudes deben indicar que se obtuvo el consentimiento de una de las siguientes maneras:

Ejemplos

En los siguientes ejemplos, se ilustra cómo usar el servicio de Cookie Matching para lograr objetivos específicos. Ten en cuenta que, a menos que se indique lo contrario, se supone que el usuario sobre el que se realiza la acción no es de un estado de EE.UU. con restricciones de privacidad.

Cómo completar una tabla de coincidencias alojada por el ofertante

Un ofertante puede usar el flujo de trabajo de la Concordancia de cookies para completar su propia tabla de concordancia proporcionando solo los parámetros google_nid y google_cm en su etiqueta de concordancia. 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 Cookie Matching del postor está configurada como https://ad.network.com/pixel?id=1 y la operación de correlación de cookies se realiza correctamente, el redireccionamiento que Google envía en respuesta a la etiqueta de correlación del postor podría verse de la siguiente manera:

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

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

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

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

Agregar a la lista de un solo usuario

El parámetro google_ula se puede especificar en una etiqueta de coincidencia del ofertante para agregar al usuario a una lista de usuarios con el ID determinado. Si la tabla de coincidencias alojada por Google o por el postor tiene una entrada reciente para el usuario, el postor puede colocar una etiqueta de coincidencia que incluya los parámetros google_nid y google_ula para agregar al usuario a la lista especificada sin iniciar el flujo de trabajo completo de la Correlación de cookies. Consulta las restricciones para invocar el Servicio de Cookie Matching y obtener más detalles. La etiqueta de coincidencia correspondiente podría verse de la siguiente manera:

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

Para una respuesta correcta, en la que la URL de Cookie Matching del postor es 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 parámetro google_error:

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

Si hay un error específico relacionado con la adición del usuario a la lista, recibirás google_ula en el redireccionamiento. A diferencia del parámetro de etiqueta de coincidencia correspondiente, este reemplaza la marca de tiempo por un código de estado 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 postores pueden especificar que se debe agregar un usuario a varias listas de usuarios si incluyen varios parámetros google_ula en la etiqueta de coincidencia. En la práctica, esto podría verse de la siguiente manera:

<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 la lista de usuarios con el ID 45678, pero falló para el ID de la lista de usuarios 12345 porque el ofertante no tenía permiso para acceder a ella.

Para realizar la correlación de cookies y agregar el usuario a una lista de usuarios en una sola solicitud, la etiqueta de correlación 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 incluiría google_gid, google_cver y google_ula. Podría verse de la siguiente manera:

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

Almacena una coincidencia en una tabla de coincidencias alojada por Google

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

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

Para una respuesta correcta, en la que la URL de Cookie Matching del postor es https://cookie-monster.com/pixel, la URL de redireccionamiento de Google sería la siguiente:

https://cookie-monster.com/pixel

El parámetro google_gid no está en el redireccionamiento porque la etiqueta de coincidencia no incluía google_cm, y google_hm no se incluye en las respuestas exitosas. En las futuras solicitudes de ofertas para las impresiones de este usuario, el ofertante recibirá sus datos de coincidencias alojados en BidRequest.user.buyeruid.

Si, en cambio, el postor usara una etiqueta de coincidencia en la que el valor de google_hm no estuviera codificado en base64 (por ejemplo, chocolate_chunk!), la URL de redireccionamiento podría verse de la siguiente manera:

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 no se pudo decodificar el valor.

Tablas de coincidencias alojadas en Google y del ofertante con listas de usuarios

Si un ofertante aloja su propia lista de uso además de una lista de usuarios alojada por Google y desea que una sola etiqueta de coincidencia coincida con ambas tablas y agregue al usuario a una lista de usuarios determinada, su etiqueta de coincidencia debe incluir los parámetros google_cm, google_hm y google_ula. Si los datos de la cookie del ofertante son Cookie number 1!, el valor codificado sería Q29va2llIG51bWJlciAxIQ==, lo que generaría una etiqueta de coincidencia como la 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, en la que la URL de Cookie Matching del postor es https://cookie-monster.com/pixel, la URL de redireccionamiento de Google se vería de la siguiente manera:

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

Cuando recibe el redireccionamiento, el postor puede correlacionar el ID de usuario de Google especificado en google_gid con los datos de cookies en su tabla de correlación. Además, pueden determinar que las operaciones de la tabla de coincidencias y la lista de usuarios alojadas en Google se realizaron correctamente. Como consecuencia, cualquier segmentación previa que el ofertante haya configurado para segmentar por el ID de la lista de usuarios especificado ahora hará que el ofertante reciba solicitudes de ofertas para las impresiones del usuario. Del mismo modo, en estas solicitudes de ofertas, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.user.buyeruid.