La concordancia de cookies es una función que te permite hacer coincidir tu cookie (por ejemplo, el ID de un usuario que navegó por tu sitio web) con un ID de usuario de Google específico del ofertante y crear listas de usuarios que pueden ayudarte a tomar decisiones de ofertas más eficaces. En esta guía, se describen los conceptos usados en la concordancia de cookies, así como sus diferentes flujos de trabajo y las variaciones que puedan tener para ciertos casos de uso.
Conceptos
¿Qué es la concordancia de cookies?
Por lo general, los propietarios de dominios configuran el contenido de las cookies para los usuarios que navegan por su sitio, las cuales se usan para identificar a los usuarios dentro de ese dominio. Incluso si dos propietarios de dominio aceptaran intercambiar estos datos, el modelo de seguridad de los navegadores de Internet restringe a uno 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 ofertantes que participan en las ofertas en tiempo real pueden tener su propio dominio, en el que identifican un conjunto de usuarios a los que les gustaría mostrar anuncios. La 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 los usuarios a los que se orienta. El ofertante recibirá sus propios datos de cookies o un ID del usuario de Google específico del ofertante que sea una forma encriptada de la cookie doubleclick.net
en la solicitud de oferta.
El servicio de concordancia 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 que uno propague las listas de usuarios.
Tablas de coincidencias
Se puede usar una tabla de coincidencias para asignar un ID u otros datos de un dominio a otro. Los ofertantes pueden usar el servicio de concordancia de cookies a fin de propagar sus propias tablas de coincidencias mediante la asignación de sus cookies para un usuario determinado al ID de usuario de Google del usuario o a fin de propagar una tabla de coincidencias alojada por Google. Las tablas de coincidencias 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
A fin de facilitar el mantenimiento, las mejoras de latencia y el acceso para hacer coincidir los datos de los usuarios en ciertas regiones, se recomienda que permitas que Google aloje tu tabla de coincidencias. Esto te permite especificar una cadena codificada en base64 segura para la Web, que de aquí en adelante se denominará 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 oferta posteriores de impresiones asociadas con el usuario, Google te enviará los datos de coincidencia alojados que hiciste coincidir 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 en el campo
BidRequest.hosted_match_data
. En la implementación de OpenRTB de Google,BidRequest.user.buyeruid
mostrará estos datos como una string codificada en base64 segura para la Web.Listas de usuarios: Las listas de usuarios se pueden propagar con IDs de usuario de Google o datos de coincidencia alojados.
- Segmentación previa: Puedes configurar la segmentación previa para que solo recibas solicitudes de ofertas que contengan datos de coincidencia alojados. Esto se puede usar para eliminar impresiones menos relevantes para los usuarios fuera de tu espacio de cookies.
Listas de usuarios
Las listas de usuarios pueden crearse y administrarse 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 describen a continuación o mediante el servicio de carga masiva de cargas.
Getting Started
Para comenzar con la concordancia de cookies, debes comunicarte con tu administrador técnico de cuentas, quien podrá habilitar flujos de trabajo específicos y ayudarte a configurar lo siguiente:
- ID de red de concordancia de cookies (NID): Es un ID de string que identifica de forma única una cuenta de ofertante para la concordancia de cookies y otras operaciones relacionadas.
- URL de concordancia de cookies: Es la URL base para un extremo que aceptará y controlará las solicitudes entrantes como parte de los flujos de trabajo de concordancia de cookies. 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 Concordancia de Cookies.
- Etiqueta de coincidencia: Es la etiqueta que debes colocar en el navegador del usuario para el flujo de trabajo de concordancia de cookies iniciado por el ofertante. Se puede publicar junto a los anuncios o colocarse en propiedades web fuera de los anuncios.
- URL del informe de concordancia de cookies (opcional): En el flujo de trabajo de concordancia unidireccional de cookies, se trata de una URL opcional que se puede proporcionar para especificar un extremo que recibirá detalles del error en caso de que la coincidencia de cookies falle por medio 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 concordancia de cookies, pero el ofertante puede solicitar que siempre se envíe el redireccionamiento.
- URL de asistencia de concordancia de cookies: Para los intercambios que implementan el flujo de trabajo de Asistencia de concordancia de cookies, esta es la URL base del extremo destinada a 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 su URL de concordancia de cookies puede recibir cada segundo. Esto se hace para evitar que las solicitudes de CMA sobrecarguen los servidores del intercambio con solicitudes.
Macros de concordancia de cookies
En cualquiera de los flujos de trabajo de Concordancia de Cookies admitidos, la URL de Concordancia de Cookies de un ofertante generalmente tiene parámetros agregados en un orden no garantizado. Los ofertantes con integraciones que requieren un orden coherente de parámetros pueden colocar macros en su URL de concordancia de cookies para garantizar su posición.
Macros compatibles
De manera opcional, los ofertantes pueden configurar su URL de concordancia de cookies para incluir una o más macros con el formato %%GOOGLE_<PARAM_NAME>%%
o %%GOOGLE_<PARAM_NAME>_PAIR%%
. Las macros compatibles 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 concordancia de cookies con un extremo alojado en https://user.bidder.com.cookies
, y su implementación requiere parámetros definidos por el ofertante predeterminados, además de los parámetros de coincidencia de Pixel en el siguiente orden: google_push
, google_gid
, google_cver
y google_error
. Para ello, el ofertante puede configurar su URL de concordancia 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 adelante una solicitud de coincidencia a este ofertante, se expandirá a uno similar al 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
Flujos de trabajo del Servicio de concordancia de cookies
Actualmente, el servicio de concordancia de cookies de Google admite tres flujos de trabajo para diferentes casos de uso que se describen a continuación.
Iniciada por el ofertante: concordancia bidireccional de cookies
La Concordancia bidireccional de cookies se refiere a un flujo de trabajo iniciado por el ofertante, en el que coloca una etiqueta de coincidencia en el navegador del usuario que la dirige a Google. Este flujo de trabajo permite que tanto Google como el ofertante propaguen las tablas de coincidencias. A continuación, se muestra 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 modo que se renderice en el navegador del usuario. Una etiqueta de coincidencia simple que solo muestra el ID de usuario de Google al ofertante se puede estructurar 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 cumplir con diferentes casos de uso. Para obtener más información sobre estos parámetros, consulta Parámetros de URL de coincidencias de etiquetas.
Paso 2: Google responde con un redireccionamiento, incluidos los datos de coincidencia
La etiqueta de coincidencia hará que el servicio de concordancia de cookies de Google reciba una solicitud del navegador del usuario, que emitirá un redireccionamiento HTTP 302
a la URL de concordancia de cookies del ofertante. El redireccionamiento incluirá parámetros de búsqueda que especifiquen el ID de usuario de Google y su número de versión en la URL, y el ofertante también recibirá la cookie incluida en los encabezados de la solicitud. En la práctica, para una URL de concordancia de cookie especificada como https://ad.network.com/pixel
, la URL de redireccionamiento de la etiqueta de coincidencia simple, como se vio antes, 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 mediante el parámetro google_gid
es una string codificada en base64 sin relleno y segura para la Web. Para los ofertantes que eligen alojar una tabla de coincidencias, se recomienda que almacenen la string exacta que muestra el servicio de concordancia de cookies. En las solicitudes de oferta posteriores, esto corresponderá a los valores especificados a través de BidRequest.google_user_id
en el protocolo de RTB de Google o BidRequest.user.id
en la implementación de OpenRTB de Google.
La versión especificada en google_cver
indica el número de versión numérico del ID de usuario de Google. El ID de usuario de Google de un usuario determinado cambiará con poca
frecuencia, después de lo cual se aumentará.
Si Google encuentra un error mientras procesa tu solicitud de coincidencia, se especificará un parámetro google_error
en su lugar.
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 los parámetros que especificaron en el primer paso y los que proporcionó Google en el segundo. Además, recibirán las cookies 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 ofertantes almacenen la string exacta que muestra el servicio de concordancia de cookies.
Si la operación no se realiza correctamente, el ofertante recibirá un parámetro google_error
en el redireccionamiento. Este es un valor numérico que corresponde a diferentes estados de error que identifican el error específico que se produjo. Puedes obtener más información sobre los posibles valores de error aquí.
Si recibes un error, puedes colocar una etiqueta de coincidencia nueva para intentar encontrar la coincidencia con ese usuario de nuevo.
Como alternativa, el ofertante debe responder publicando una imagen de píxel invisible de 1 x 1, o bien mostrar una respuesta HTTP 204
Sin contenido.
Diagrama del flujo de trabajo de concordancia de cookies
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.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=7&hl=es)
Parámetros de URL de 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 Ofertantes. |
google_cm |
Indica al servicio de concordancia de cookies de Google que debe realizar la concordancia de cookies. El valor del parámetro se ignora y se puede omitir. |
google_sc |
Este parámetro dejó de estar disponible. Configura la cookie de Google para el usuario si no hay una presente. El valor del parámetro se ignora y se puede omitir. Omitir el parámetro genera un error si no existe una cookie. |
google_no_sc |
Este parámetro dejó de estar disponible. Esto le indica al Servicio de Concordancia de Cookies de Google que no debe establecer una cookie para el usuario si no hay una presente. El valor del parámetro se ignora y se puede omitir. |
google_hm |
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 (el relleno es opcional). Los datos sin procesar deben ser de 40 bytes o menos. Por ejemplo, |
google_redir |
Una string codificada en URL que un ofertante 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 colocar a Google al frente de una llamada en cadena 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 formato esperado del valor es userlistid[,timestamp] :
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 GDPR sobre el uso de datos. Para obtener más detalles, consulta los
Requisitos de Consentimiento de Usuarios de la UE a continuación o Impacto en la elegibilidad
de las coincidencias de cookies en la
documentación del MTC v2.0 de IAB en Authorized Buyers.
Ejemplo: |
gdpr_consent |
Una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, consulta los Requisitos de consentimiento de usuarios de la UE a continuación o ¿Cómo se pasará la cadena de TC? en la documentación del MTC v2.0 de IAB en Authorized Buyers. |
process_consent |
Indica que el ofertante obtuvo el consentimiento del usuario final para los usos de 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 ( Ejemplo: |
Además de los parámetros anteriores, los ofertantes pueden especificar sus propios, que se agregarán como parámetros a la URL de redireccionamiento. Ten en cuenta que los parámetros definidos por el ofertante que llevan el prefijo google_
se ignorarán, ya que Google los reserva para desarrollos futuros, y no se garantiza la conservación del orden de los parámetros. Una etiqueta de coincidencia que incluye parámetros definidos por el ofertante puede tener el siguiente aspecto:
<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 concordancia de cookies configurada para la cuenta de un ofertante, incluidos google_
y los parámetros definidos por el ofertante según los especificados en la etiqueta de coincidencia. Se definen los siguientes parámetros de respuesta 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ó de forma correcta. |
google_cver |
Versión de la 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 general de la solicitud. Cuando se recibe, indica que no se realizaron operaciones y que no se establecerán otros parámetros de respuesta
|
google_hm |
Solo aparece si falla el intento de escritura en la tabla de coincidencias alojada en Google. Cuando eso sucede, su valor es uno de los siguientes códigos de estado:
|
google_ula |
Estado de la operación para agregar listas de usuarios, repetido si se especificaron varios Ejemplo: La operación
|
Situaciones de ejemplo del flujo de trabajo de concordancia de cookies
En las siguientes situaciones, se describe cómo podría verse la coincidencia de cookies para un usuario típico que navega en una página web.
Situación 1: El usuario borra las cookies y navega por un sitio
Jane borra todas las cookies de su caché. Luego, visitan la página principal de NoticiasDeEjemplo.com.
Esto es lo que ocurre:
- ExampleNews.com procesa y llama anuncios de Google (Ad Manager).
- Debido a que la unidad de anuncios es apta para la asignación dinámica, Google envía solicitudes de ofertas a FinestDSP y a otros ofertantes a través del servicio de ofertas en tiempo real.
- La aplicación de ofertantes de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta a la oferta.
- Google recibe respuestas de oferta de los ofertantes, incluida la respuesta de FinestDSP que especifica un anuncio con una etiqueta coincidente (píxel).
- FinestDSP gana la subasta. Google publica el anuncio de FinestDSP y la etiqueta de coincidencia con Jane.
- La etiqueta de coincidencia llama al Servicio de concordancia de cookies de Google y especifica los parámetros
google_nid
ygoogle_cm
. - El servicio de concordancia de cookies lee la cookie de Google de Jane y envía al navegador de esta un redireccionamiento a la URL de concordancia de cookies de FinestDSP con los parámetros
google_user_id
ygoogle_cver
configurados. - El navegador de Juana carga el redireccionamiento a la URL de concordancia de cookies de FinestDSP.
- El extremo de coincidencia de cookies de FinestDSP procesa la solicitud de redireccionamiento, que incluye los parámetros de URL que estableció Google y su cookie para Jane en los encabezados HTTP. FinestDSP ahora puede almacenar la asignación de su cookie a
google_user_id
en su tabla de coincidencias. - FinestDSP responde al redireccionamiento con un píxel invisible de 1 x 1.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=7&hl=es)
Situación 2: Usuario con asignación existente
Una semana después de la situación 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 la coincidencia.
- Se procesa la página web, lo que provoca que Google (Ad Manager) solicite anuncios que se renderizarán en ella.
- Durante la subasta de anuncios, Google envía una solicitud de oferta a los ofertantes correspondientes, incluido FinestDSP.
- FinestDSP recibe la solicitud de oferta, incluidos los indicadores, como
google_user_id
. - FinestDSP busca el
google_user_id
en su tabla de coincidencias y encuentra la cookie asociada con Jane que se creó una semana antes (en la situación 1). - Según la información asociada con la cookie, la lógica de ofertas de FinestDSP establece una oferta en la impresión y gana la subasta.
- Juana podría ver un anuncio adaptado a sus intereses, en función de la información que posee FinestDSP.
Iniciada por el ofertante: Concordancia unidireccional de cookies
La Concordancia unidireccional de cookies es similar al flujo de trabajo bidireccional, excepto que se modifica para que solo Google aloje y propague una tabla de coincidencias. Esto se puede usar en instancias en las que el ofertante no tiene permitido alojar los IDs de usuario de Google en su propia tabla de coincidencias. Para usar este flujo, los ofertantes deben permitir que Google aloje la tabla de coincidencias, ya no pueden especificar google_cm
en las solicitudes al servicio de concordancia de cookies de Google y, por lo tanto, no recibirán google_gid
para propagar su propia tabla de coincidencias. Una vez que Google haya establecido una coincidencia para un usuario, los ofertantes pueden agregarlo
a las listas de usuarios con 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. En los siguientes pasos, se resume un ejemplo simple del flujo de trabajo revisado.
Paso 1: Coloque la etiqueta de coincidencia dirigida a la URL de concordancia de cookies del ofertante
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 usuarios que no pertenecen a un estado de EE.UU. con restricciones de privacidad, la etiqueta de coincidencia debe dirigir el navegador del usuario a tu URL de concordancia de cookies. 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 de la URL de concordancia de cookies del ofertante. Esta solicitud contendrá la cookie en el encabezado HTTP, que se debe extraer para el paso siguiente.
Paso 2: Redireccionar al servicio de concordancia de cookies de Google
El extremo de coincidencia de cookies del ofertante debe redireccionar al servicio de concordancia de cookies de Google, incluido el parámetro google_hm
propagado con sus datos de cookies codificados en Base64 seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Paso 3: Se redirecciona el navegador del usuario al servicio de concordancia de cookies de Google
Google recibirá un redireccionamiento con los parámetros que especificaste, además de la cookie de Google en los encabezados HTTP.
Paso 4: Google muestra píxeles cuando el proceso se realiza correctamente o se redirecciona el error si se especifica una URL del informe.
Si la operación de concordancia de cookies se realiza correctamente, o si no se especificó ninguna URL de informe de coincidencias de cookies 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 los datos de coincidencia alojados del ofertante en BidRequest.hosted_match_data
para el protocolo de Google o BidRequest.user.buyeruid
para la implementación de OpenRTB de Google. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencia alojados que especificaron.
De lo contrario, si se produjo un error, Google enviará un redireccionamiento a la URL
del informe de concordancia de cookies del ofertante 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 de la siguiente manera:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Paso 5: El navegador del usuario redirecciona a la URL del informe de concordancia de cookies del ofertante
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
. Si deseas obtener más información para 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
Como respuesta, el ofertante debe entregar un píxel transparente de 1 x 1 en el navegador del usuario.
Diagrama del flujo de trabajo de concordancia de cookies para usuarios de estados de EE.UU. con restricciones de privacidad
En el siguiente diagrama, se ilustra el flujo de trabajo predeterminado para los usuarios en estados de EE.UU. con restricciones de privacidad, en el que las solicitudes y respuestas se representan con una flecha y los elementos de datos que las acompañan se enumeran entre paréntesis.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=7&hl=es)
Los parámetros de URL para el ofertante redireccionan al servicio de concordancia de cookies de Google
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 Ofertantes. |
google_sc |
Este parámetro dejó de estar disponible. Configura la cookie de Google para el usuario si no hay una presente. El valor del parámetro se ignora y se puede omitir. Omitir el parámetro genera un error si no existe una cookie. |
google_no_sc |
Este parámetro dejó de estar disponible. Esto le indica al Servicio de Concordancia de Cookies de Google que no debe establecer una cookie para el usuario si no hay una presente. El valor del parámetro se ignora y se puede omitir. |
google_hm |
Contiene datos que el ofertante desea almacenar en una tabla de coincidencias alojada en Google. |
google_redir |
Una URL codificada para la que deseas que Google envíe un redireccionamiento HTTP 302. La URL especificada recibirá redireccionamientos con el parámetro google_error para los errores y las operaciones realizadas correctamente. |
google_ula |
Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El formato esperado del valor es userlistid[,timestamp] :
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 GDPR sobre el uso de datos. Para obtener más detalles, consulta los
Requisitos de Consentimiento de Usuarios de la UE a continuación o Impacto en la elegibilidad
de las coincidencias de cookies en la
documentación del MTC v2.0 de IAB en Authorized Buyers.
Ejemplo: |
gdpr_consent |
Una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, consulta los Requisitos de consentimiento de usuarios de la UE a continuación o ¿Cómo se pasará la cadena de TC? en la documentación del MTC v2.0 de IAB en Authorized Buyers. |
process_consent |
Indica que el ofertante obtuvo el consentimiento del usuario final para los usos de 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 ( Ejemplo: |
Los parámetros de URL para Google redireccionan a la URL del informe de concordancia de cookies del ofertante
Parámetro | Descripción |
---|---|
google_error |
Un 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
|
Iniciada por Google: Concordancia bidireccional de píxeles
La Concordancia bidireccional de píxeles es un flujo de trabajo para el servicio de concordancia de cookies de Google en el que Google intenta hacer coincidir un ID de usuario de Google con un ofertante seleccionado de forma algorítmica que no sea el ganador de la subasta de la oferta en tiempo real. Cuando se coloca un anuncio, Google coloca una etiqueta de coincidencia que indica al navegador del usuario que cargue un píxel transparente de la URL de concordancia de cookies del ofertante seleccionado. Esto permitirá que Google y el ofertante propaguen una tabla de coincidencias con un usuario determinado. A continuación, se muestra un ejemplo simple de este flujo de trabajo.
Paso 1: Google coloca una etiqueta de coincidencia
Cuando la página de un publicador participante se carga en el navegador del usuario y Google llena un espacio publicitario en esa página, se puede colocar una etiqueta de coincidencia que solicita un píxel a un ofertante seleccionado mediante algoritmos. La etiqueta de Concordancia de Pixel que coloca Google combina la URL de Concordancia de Cookies del ofertante con los parámetros adicionales que el ofertante puede usar para propagar su tabla de coincidencias. Para una URL de concordancia 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" />
Paso 2: El ofertante debe responder con el redireccionamiento a la URL del Servicio de concordancia de cookies de Google
Los ofertantes que reciben solicitudes de coincidencia de píxeles deben responder con un redireccionamiento 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 URL que se usa en la etiqueta de coincidencia del flujo de trabajo de concordancia de cookies iniciada por el ofertante.
En Pixel Matching, se reemplaza el parámetro google_cm
por el parámetro google_push
, y su valor debe ser igual al valor proporcionado por Google en la solicitud. Al igual que el flujo de trabajo iniciado por el ofertante, se pueden especificar parámetros adicionales para cumplir con casos de uso adicionales.
Paso 3: Google procesa el redireccionamiento y responde con un píxel
Google registra que se creó una coincidencia para el usuario y controla cualquier operación adicional solicitada a través de los parámetros de consulta. Por último, Google responde con un píxel transparente de 1 x 1.
Diagrama del flujo de trabajo de la búsqueda de coincidencias de Pixel
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.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=7&hl=es)
Parámetros de solicitud de etiqueta de coincidencia de Google
Parámetro | Descripción |
---|---|
google_gid |
ID de usuario de Google. Para los usuarios que no residen en un estado de EE.UU. y tienen restricciones de privacidad, esto siempre se especificará en la etiqueta de coincidencia de Google. |
google_cver |
Indica 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 Pixel Matching. El valor debe mostrarse a través del parámetro correspondiente en la respuesta de redireccionamiento del ofertante. |
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 a través del recurso Ofertantes. |
google_push |
Indica que este redireccionamiento está completando el flujo de trabajo de Pixel Matching. Aquí se debe especificar el valor de la etiqueta de coincidencia de Google correspondiente. |
google_hm |
Contiene datos que el ofertante desea almacenar en una tabla de coincidencias alojada en Google. |
google_ula |
Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El formato esperado del valor es userlistid[,timestamp] :
Este parámetro de URL se puede repetir para agregar al usuario a varias listas. |
Iniciada por Google: Concordancia unidireccional de píxeles
La Concordancia unidireccional de píxeles difiere del flujo de trabajo bidireccional en que la etiqueta de coincidencia de Google no incluye un parámetro que especifique el ID de usuario de Google, pero seguirá propagando una tabla de coincidencias alojada en Google. Esto se puede usar en instancias en las que el ofertante no tiene permitido alojar los IDs de usuario de Google en su propia tabla de coincidencias. En los siguientes pasos, se resume un ejemplo simple del flujo de trabajo revisado.
Paso 1: Google coloca una etiqueta de coincidencia
Google coloca una etiqueta de coincidencia para un ofertante seleccionado mediante algoritmos. 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 un píxel a la URL de Coincidencia de cocina 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.
Paso 3: Redireccionar al servicio de concordancia de cookies de Google
El extremo de coincidencia de cookies del ofertante debe redireccionar al servicio de concordancia de cookies de Google, incluido el parámetro google_hm
propagado con sus datos de cookies codificados en Base64 seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Paso 4: Se redirecciona el navegador del usuario al servicio de concordancia de cookies de Google
Google recibirá un redireccionamiento con 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 de este usuario en las solicitudes de oferta posteriores incluirán los datos de coincidencia alojados del ofertante en BidRequest.hosted_match_data
para el protocolo de Google o BidRequest.user.buyeruid
para la implementación de OpenRTB de Google. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencia alojados que especificaron.
Por último, Google devuelve un píxel transparente de 1 x 1 al navegador del usuario.
Asistencia de concordancia de cookies
Open Bidding permite que los intercambios usen flujos de trabajo de concordancia de cookies iniciados por el ofertante y Google para que coincidan un ID de usuario de Google con su cookie. La Asistencia de concordancia de cookies (CMA) es una función adicional para los intercambios que les permite crear tablas de coincidencias con sus propios ofertantes.
Cómo funciona la Asistencia de concordancia de cookies
Cuando colocas un anuncio, Google selecciona algorítmicamente 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"/>
La etiqueta de coincidencia de CMA de Google hace que la URL de concordancia de cookies del intercambio reciba una solicitud de píxel.
- El extremo de concordancia de cookies del intercambio recibe la solicitud, y su propio servicio de concordancia de cookies es responsable de hacer coincidir el ID de usuario con uno de sus ofertantes. En el siguiente diagrama, el servicio de concordancia de cookies del intercambio responde al navegador del usuario con un redireccionamiento a uno de los extremos de su ofertante.
- El ofertante recibe la solicitud, junto con los parámetros especificados por el intercambio para hacer coincidir el ID de usuario con su cookie.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=7&hl=es)
Restricciones
Limitar la frecuencia de las solicitudes de coincidencias nuevas
Los ofertantes son responsables de limitar la cantidad de llamadas al servicio de concordancia de cookies para los usuarios que tienen una entrada nueva en la tabla de coincidencias alojada en Google. Es posible que una entrada de la tabla de coincidencias alojada haya vencido en 14 días, después de lo cual se podrá actualizar.
Cómo responder a todas las solicitudes de coincidencia de píxeles
Se espera que los ofertantes que usan el flujo de trabajo de Pixel Match respondan a todas
las solicitudes entrantes de Pixel Match con una respuesta que incluya el parámetro
google_push
. Esto le permite a Google supervisar el uso para aplicar políticas. Si la tasa de respuesta de un ofertante cae por debajo del 90%, Google limitará la cantidad de solicitudes de Pixel Match que se envíen a su cuenta.
Usa extremos HTTPS
Es necesario que los extremos que se usan en todos los flujos de trabajo de concordancia de cookies usen HTTPS.
Cuando respondas una solicitud de Pixel Match que recibas mediante HTTPS, debes redireccionar al servicio de concordancia de cookies a través de HTTPS. Del mismo modo, un extremo de Cookie Match Assist que redirecciona 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 que se envíen a tu cuenta.
Requisitos de consentimiento de usuarios de la UE
Las solicitudes de Concordancia 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 son necesarias para indicar que se recopiló el consentimiento mediante una de las siguientes maneras:
- MTCv2: Incluye los parámetros
gdpr
ygdpr_consent
. Para obtener más información, consulta la documentación del MTC v2.0 de IAB para Authorized Buyers. process_consent
: Es una declaración de que el ofertante obtuvo el consentimiento necesario del usuario.
Ejemplos
Los siguientes ejemplos ilustran cómo usar el servicio de concordancia de cookies para lograr objetivos específicos. Ten en cuenta que, a menos que se indique lo contrario, se asume que el usuario ante el que se realiza la acción no proviene de un estado de EE.UU. con restricciones de privacidad.
Propaga una tabla de coincidencias alojada por el ofertante
Un ofertante puede usar el flujo de trabajo de Concordancia de Cookies para propagar su propia tabla de coincidencias proporcionando solo los parámetros google_nid
y google_cm
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 se configura como https://ad.network.com/pixel?id=1
y la operación de coincidencia de cookies se realiza correctamente, el redireccionamiento que Google envía
en respuesta a la etiqueta de coincidencia del ofertante podría ser de la siguiente manera:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Si la operación de coincidencia de cookies falla porque el usuario no tiene una cookie de Google, la respuesta será 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 para el flujo de trabajo de Concordancia de Cookies, consulta los parámetros de URL de redireccionamiento.
Agregar a una lista de un solo usuario
Se puede especificar el parámetro google_ula
en la etiqueta de coincidencia
de un ofertante para agregar al usuario a una lista de usuarios con el ID determinado. Si la tabla de coincidencias alojada por Google o por un ofertante tiene una entrada nueva para el usuario, el ofertante 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 Coincidencia de cookies. Consulta las restricciones para invocar el servicio de concordancia de cookies para obtener información adicional. 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 concordancia de cookies del ofertante 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 se produce 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 se produce un error específico relacionado con agregar al 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 falla porque la cuenta del ofertante no tiene 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 incluyendo varios parámetros google_ula
en la etiqueta de coincidencia. En la práctica, 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 lista de usuarios 12345
, ya que el ofertante no tenía permiso para acceder a ella.
Cómo revisar el flujo de trabajo de Concordancia de Cookies y agregarla a la lista de usuarios
Para realizar la concordancia de cookies y agregar al usuario a una lista de usuarios en una sola 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 incluiría google_gid
, google_cver
y google_ula
. Es posible que se vea 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 en 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 del usuario de Google en su propia tabla de coincidencias, su etiqueta de coincidencia debe incluir el parámetro google_hm
, en el que su valor debe ser una string 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 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 concordancia de cookies del ofertante es https://cookie-monster.com/pixel
, la URL de redireccionamiento de Google debe ser la siguiente:
https://cookie-monster.com/pixel
El parámetro google_gid
no se encuentra en el redireccionamiento porque la etiqueta de coincidencia no incluyó google_cm
, y google_hm
no se incluye en las respuestas correctas. En las solicitudes de oferta futuras por impresiones para este usuario, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.hosted_match_data
para el protocolo de RTB de Google o BidRequest.user.buyeruid
para la implementación de OpenRTB de Google.
En cambio, si el ofertante usó una etiqueta de coincidencia en la que el valor de
google_hm
no estaba codificado en base64, como
chocolate_chunk!
, la URL de redireccionamiento podría ser similar
a la 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 no se pudo decodificar el valor.
Tablas de coincidencias alojadas en Google y de ofertantes con listas de usuarios
Si un ofertante aloja su propia lista de uso, además de una lista de usuarios alojada en 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 producirí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 correcta, en la que la URL de concordancia de cookies del ofertante es https://cookie-monster.com/pixel
, la URL de redireccionamiento de Google se verá de la siguiente manera:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Cuando recibe el redireccionamiento, el ofertante puede hacer coincidir el ID del usuario de Google especificado en google_gid
con los datos de sus cookies en su tabla de coincidencias. Además, puede determinar si se ejecutaron correctamente las operaciones de la tabla de coincidencias alojada en Google y la lista de usuarios. Como consecuencia, cualquier segmentación previa que el ofertante haya configurado para segmentar el ID de lista de usuarios especificado ahora hará que el ofertante reciba solicitudes de oferta por impresiones del usuario. Del mismo modo, en estas solicitudes de oferta, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.hosted_match_data
para el protocolo de RTB de Google o BidRequest.user.buyeruid
para la implementación de OpenRTB de Google.