La concordancia de cookies es una función que le permite hacer coincidir su cookie para por ejemplo, un ID para un usuario que navegó por tu sitio web, con una dirección el ID de usuario de Google específico del ofertante y crear listas de usuarios opciones de ofertas más eficaces. En esta guía, se describen los conceptos que se usan en las de Concordancia, así como diferentes flujos de trabajo de Concordancia de Cookies y sus variaciones que podrían tener en ciertos casos de uso.
Conceptos
¿Qué es la concordancia de cookies?
Los propietarios de dominios suelen establecer el contenido de las cookies para los usuarios que navegan su sitio, que se usan para identificar a los usuarios dentro de ese dominio. Incluso si dos propietarios del dominio aceptarían intercambiar estos datos, el modelo de seguridad de los navegadores de Internet impide que uno lea una cookie configurada por otro dominio.
En el contexto de la publicidad digital, Google identifica a los usuarios con cookies.
que pertenecen al dominio doubleclick.net
y los ofertantes
que participan en Ofertas en tiempo real pueden tener su propio dominio, donde
Identificar el conjunto de usuarios al que le gustaría que se le muestren sus anuncios. Concordancia de Cookies
permite al ofertante hacer coincidir sus cookies con las de Google, de modo que pueda
determinar si una impresión enviada en una solicitud de oferta está asociada con uno de
a los usuarios objetivo, estos recibirán sus propios datos de cookies
ID de usuario de Google específico del ofertante que es un formato encriptado del
cookie doubleclick.net
en la solicitud de oferta.
El servicio de concordancia de cookies descrito en esta guía facilita la creación y el mantenimiento de la asociación entre la cookie del ofertante y el User-ID, y permite propagar las listas de usuarios.
Tablas de coincidencias
Una tabla de coincidencias se puede usar para asignar un ID u otros datos de un dominio a con el otro. Los ofertantes pueden usar el servicio de concordancia de cookies para propagar que coinciden con las tablas asignando su cookie de un usuario determinado al servicio de Google ID de usuario, o para propagar una tabla de coincidencias alojada por Google. Las tablas de coincidencias son necesarios para que la aplicación de un ofertante acceda a los datos de cookies del usuario a ver la impresión.
Tablas de coincidencia alojadas en Google
Para facilitar el mantenimiento, las mejoras en la latencia y el acceso a los datos coincidentes para usuarios de ciertas regiones, se recomienda que permitas que Google aloje tus de coincidencias exactas. Esto te permite especificar una string codificada en base64 segura para la Web; en adelante, denominados datos de coincidencia alojados, que se asignarán al Es el ID de usuario de Google de un usuario determinado. Una vez que se establece la coincidencia, se puede se usan de las siguientes maneras:
Ofertas en tiempo real: En solicitudes de oferta posteriores para impresiones asociado con el usuario, Google te enviará los datos de coincidencia alojados que se coincidan con su ID de usuario de Google. Si tu extremo de ofertas está configurado para usar el protocolo de RTB de Google, lo recibirás como bytes decodificados mediante el campo
BidRequest.hosted_match_data
En OpenRTB de Google implementación,BidRequest.user.buyeruid
devolverá esto como una cadena codificada en Base64 segura para la Web.Listas de usuarios: Se pueden propagar las listas de usuarios. con IDs de usuario de Google o datos de coincidencia alojados.
- Segmentación previa: Puedes configurar tu segmentación previa de modo que solo recibas solicitudes de oferta que contiene datos de coincidencias alojados. Esto se puede usar para eliminar menos relevantes impresiones para los usuarios fuera de su espacio de cookies.
Listas de usuarios
Las listas de usuarios se pueden crear y administrar con la API de Ofertas en tiempo real. Una vez creadas, puedes propagar estas listas con los flujos de trabajo de concordancia de cookies. que se describe a continuación, o bien a través del Servicio de carga masiva.
Comenzar
Para comenzar a utilizar la concordancia de cookies, debe ponerse en contacto con su Administrador técnico de cuentas, que puede habilitar flujos de trabajo específicos y ayudarte configura lo siguiente:
- ID de red de concordancia de cookies (NID): Es un ID de cadena que identifica de forma inequívoca. una cuenta de ofertante para la Concordancia de Cookies y otras operaciones relacionadas.
- URL de concordancia de cookies: Es la URL base del extremo que aceptará y administrar las solicitudes entrantes como parte de los flujos de trabajo de concordancia de cookies. Los ofertantes pueden incorporar macros en esta URL para lo siguiente: controlar el orden de los parámetros que se le pasan en los flujos de trabajo de concordancia de cookies.
- Etiqueta de coincidencia: es la etiqueta que debes colocar en el navegador de un usuario para que el flujo de trabajo de Concordancia de Cookies iniciado por el ofertante. Se puede publicar junto con los anuncios. o que se ubiquen en propiedades web fuera de los anuncios.
- URL del informe de concordancia de cookies (opcional): En la ruta unidireccional de concordancia de cookies. Esta es una URL opcional que se puede proporcionar a especifica un extremo que recibirá detalles del error en caso de que la cookie la coincidencia falla a través de un redireccionamiento HTTP 302. De forma predeterminada, las respuestas solo enviar a esta URL si se produce un error en la operación de concordancia de cookies pero el ofertante puede solicitar que siempre se envíe el redireccionamiento.
- URL de contribución de coincidencia de cookies: Para los intercambios que implementan el Flujo de trabajo de Cookie Match Assist, este es el URL base del extremo destinado a responder a las solicitudes entrantes.
- Cuota de Cookie Match Assist: para los intercambios que implementan el Flujo de trabajo de Cookie Match Assist, este es el la cantidad máxima de solicitudes que la URL de concordancia de cookies puede recibir cada por segundo. Esto es para evitar que las solicitudes de la CMA sobrecarguen el los servidores de Exchange con solicitudes.
Macros de concordancia de cookies
En cualquiera de los flujos de trabajo de concordancia de cookies compatibles, la URL de concordancia de cookies de un ofertante suele tener parámetros no garantizado. Ofertantes con integraciones que requieren coherencia el orden de los parámetros puede colocar macros en su URL de concordancia de cookies a garantizar su posición.
Macros compatibles
De manera opcional, los ofertantes pueden configurar su URL de concordancia de cookies para incluir una
más macros en el formato de %%GOOGLE_<PARAM_NAME>%%
o
%%GOOGLE_<PARAM_NAME>_PAIR%%
Las macros compatibles y sus
los valores expandidos son los siguientes:
Macro | Valor expandido |
---|---|
GOOGLE_GID | GOOGLE_USER_ID |
GOOGLE_GID_PAIR | &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 predeterminado, además de la coincidencia con píxeles
parámetros en el siguiente orden: google_push
,
google_gid
, google_cver
y
google_error
El ofertante puede lograr esto si establece su
URL de concordancia de cookies para:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Cuando Google envíe una solicitud de coincidencia a este ofertante, se expandirá en algo como lo siguiente:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Flujos de trabajo del Servicio de concordancia de cookies
Actualmente, el servicio de concordancia de cookies de Google admite tres flujos de trabajo para con los diferentes casos de uso que se describen a continuación.
Iniciado por el ofertante: Concordancia bidireccional de cookies
La concordancia bidireccional de cookies hace referencia a un flujo de trabajo iniciado por el ofertante, en el que colocan una etiqueta de coincidencia en el navegador del usuario que la dirige a Google. Esta permite que tanto Google como el ofertante propaguen las tablas de coincidencias. A continuación, se incluye un un ejemplo sencillo de este flujo de trabajo.
Paso 1: Coloca la etiqueta de coincidencia
Para iniciar este flujo, el ofertante debe colocar su etiqueta de coincidencia de que se renderiza en el navegador del usuario. Una etiqueta de coincidencia simple que solo muestra el ID de usuario de Google para el ofertante se puede estructurar de la siguiente manera:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Existen parámetros adicionales que puede incluir en la etiqueta de coincidencia para cumplir diferentes casos de uso. Para obtener más información sobre estos parámetros, consulta Coinciden con los parámetros de URL de la etiqueta.
Paso 2: Google responde con redireccionamiento, incluidos los datos de coincidencia.
La etiqueta de coincidencia hará que el servicio de concordancia de cookies de Google reciba una
solicitud desde el navegador del usuario, lo que emitirá un HTTP 302
redireccionar a la URL de concordancia de cookies del ofertante El redireccionamiento incluirá consultas
parámetros que especifiquen el ID de usuario de Google y su número de versión en la URL
el ofertante también recibirá su cookie incluida en los encabezados de la solicitud. En
para una URL de concordancia de cookies especificada como https://ad.network.com/pixel
,
la URL de redireccionamiento para la etiqueta de coincidencia simple, como se ve anteriormente, podría verse así:
lo siguiente:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
El ID de usuario de Google que se pasa a través del parámetro google_gid
es
una interfaz segura para la Web sin padding
una cadena vacía. Se recomienda a los ofertantes que elijan alojar una tabla de coincidencias
almacenar la cadena exacta que devuelve el Servicio de concordancia de cookies. En los siguientes cursos:
de solicitudes de ofertas, corresponderá a los valores especificados hasta el BidRequest.google_user_id
en el protocolo de RTB de Google, o BidRequest.user.id
en
Implementación de OpenRTB.
La versión especificada en google_cver
indica el valor numérico
de versión para el ID de usuario de Google. El ID de usuario de Google de un usuario determinado
cambian con poca frecuencia, después de lo cual aumentan.
Si Google encuentra un error al procesar tu solicitud de coincidencia,
En su lugar, se especificará el parámetro google_error
.
Paso 3: El ofertante procesa el redireccionamiento y responde con un píxel
El ofertante recibe un redireccionamiento a su URL de concordancia de cookies, que incluye lo siguiente: parámetros que especificó en el primer paso y los que Google proporcionó en la segundo paso. Además, también recibirán su cookie en el protocolo encabezados. Si la operación se realizó correctamente, un ofertante que aloja su propia tabla de coincidencias podría hacer coincidir su cookie con el ID de usuario de Google incluido en la respuesta. Sí Se recomendó que los ofertantes almacenen la cadena exacta que muestra la herramienta de concordancia de cookies. Servicio.
Si la operación no se realiza correctamente, el ofertante recibirá un google_error
en el redireccionamiento. Es un valor numérico que corresponde a diferentes
estados de error que identifican el error específico que ocurrió. Puedes aprender
Obtén más información sobre los posibles valores de error aquí.
Si recibes un mensaje de error, puedes intentar buscar a ese usuario nuevamente. Para ello, haz lo siguiente:
colocar una nueva etiqueta de coincidencia.
El ofertante siempre debe responder publicando una imagen de píxel invisible de 1 x 1.
Como alternativa, puedes mostrar una respuesta HTTP 204
No Content.
Diagrama del flujo de trabajo de concordancia de cookies
Este flujo de trabajo se ilustra en el siguiente diagrama, donde las solicitudes y las respuestas están representadas por una flecha y los elementos de datos que las acompañan se enumeran entre paréntesis.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=19&hl=es)
Hacer coincidir los parámetros de la URL de la etiqueta
Parámetro | Descripción |
---|---|
google_nid |
Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar mediante la pestaña Ofertantes recurso. |
google_cm |
Le indica al Servicio de concordancia de cookies de Google que debe realizar. concordancia de cookies. El valor del parámetro se ignora y puede omitido. |
google_sc |
Este parámetro dejó de estar disponible. Establece la cookie de Google para la usuario si no hay uno presente. El valor del parámetro se ignora y puede omitirse. Omitir el parámetro genera un error si no hay cookies existe. |
google_no_sc |
Este parámetro dejó de estar disponible. Esto indica a la nube de concordancia de cookies que no debería establecer una cookie para el usuario si uno no está presente. El valor del parámetro se ignora y puede omitido. |
google_hm |
Son los datos que el ofertante desea almacenar en una tabla de coincidencias alojada en Google.
El valor es una string codificada en base64 segura para la Web (padding opcional). Los datos sin procesar deben ser 40
bytes o menos. Por ejemplo, |
google_redir |
Es una cadena codificada en URL que un ofertante puede especificar si desea dirigirlo.
que Google envíe el redireccionamiento HTTP 302 a la URL codificada para
esta etiqueta de coincidencia. Esto permite colocar Google en la parte delantera con una cadena
llamada a los socios. Esto generará un error si se especifica sin
google_hm o con google_cm . |
google_ula |
Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El valor
el formato esperado es userlistid[,timestamp] :
Este parámetro de URL se puede repetir para agregar al usuario a varios listas. |
gdpr |
Indica que la solicitud está sujeta a las restricciones de datos del GDPR
de uso de la nube. Para obtener más información, consulta
Requisitos de consentimiento de usuarios de la UE a continuación, o bien Impacto en la concordancia de cookies
la elegibilidad en la
.
Documentación del MTC v2.0 de IAB de Authorized Buyers
Ejemplo: |
gdpr_consent |
Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, Consulte los requisitos de consentimiento de usuarios de la UE. o ¿Cómo se pasará la cadena de TC? en la . Documentación del MTC v2.0 de IAB de Authorized Buyers |
process_consent |
Indica que el ofertante obtuvo el consentimiento del usuario final para los usos de datos especificados en
Política de Consentimiento de Usuarios de la UE de Google
Si la solicitud no está sujeta a la Política de Consentimiento de Usuarios de la UE o si
hay otros parámetros de consentimiento disponibles en la solicitud
( Ejemplo: |
Además de los parámetros anteriores, los ofertantes pueden especificar sus propios parámetros, que
se agregarán como parámetros a la URL de redireccionamiento. Ten en cuenta que las definiciones
los parámetros nombrados con el prefijo google_
se ignorarán
que Google reserva para el desarrollo y la preservación de la
parámetros el orden de los datos no está garantizado. Una etiqueta de coincidencia que incluye valores definidos por el ofertante
de la siguiente manera:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Parámetros de URL de redireccionamiento
La URL de redireccionamiento se crea a partir de la URL base de concordancia de cookies configurada para
la cuenta de un ofertante, incluidos google_
y los parámetros definidos por el ofertante
dependiendo de los especificados en la etiqueta de coincidencia. Los siguientes google_
se definen los parámetros de respuesta:
Parámetro | Descripción |
---|---|
google_gid |
Es el ID de usuario de Google. Se establece si se especifica google_cm en la solicitud y esta se realizó de forma correcta. |
google_cver |
Versión de cookie. Se establece si se especifica google_cm en la solicitud y esta se realizó de forma correcta. |
google_error |
Un número entero que indica el error de solicitud general. Cuándo
recibidos, indica que no se realizaron operaciones y que ninguna otra
Se establecerán
|
google_hm |
Solo aparece si se intenta escribir en la tabla de coincidencias alojada en Google. falla. Cuando eso sucede, su valor es uno de los siguientes códigos de estado:
|
google_ula |
Estado de la operación para agregar la lista de usuarios, que se repite si hay varios Ejemplo: La operación
|
Casos de ejemplo del flujo de trabajo de concordancia de cookies
Las siguientes situaciones describen cómo sería la coincidencia de cookies para un usuario típico navegando por una página web.
Situación 1: El usuario borra sus cookies y explora un sitio
Jane borra todas las cookies de la caché. Luego, visitan la página principal de NoticiasdeEjemplo.com.
Esto es lo que ocurre:
- ExampleNews.com renderiza y llama a los anuncios de Google (Ad Manager).
- Debido a que la unidad de anuncios es apta para la asignación dinámica, Google envía la oferta solicitudes a FinestDSP y otros ofertantes a través del servicio de ofertas en tiempo real.
- La solicitud de ofertante de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta a la oferta.
- Google recibe respuestas a la oferta de los ofertantes, incluida la respuesta de FinestDSP que especifique un anuncio con una etiqueta de coincidencia (píxel).
- FinestDSP gana la subasta. Google publica el anuncio y la etiqueta de coincidencia de FinestDSP para Julia.
- La etiqueta de coincidencia llama al servicio de concordancia de cookies de Google y especifica la
Parámetros
google_nid
ygoogle_cm
- El servicio de concordancia de cookies lee la cookie de Google de Jane y envía la de
navegador un redireccionamiento a la URL de concordancia de cookies de FinestDSP con el
Se configuraron los parámetros
google_user_id
ygoogle_cver
. - El navegador de Jane carga el redireccionamiento a la URL de Cookie Match de FinestDSP.
- El extremo de concordancia de cookies de FinestDSP procesa la solicitud de redireccionamiento,
que incluye los parámetros de URL establecidos por Google y su cookie para Jane en
encabezados HTTP. FinestDSP ahora puede almacenar la asignación de su cookie al
google_user_id
en su tabla de coincidencias. - 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=19&hl=es)
Situación 2: Usuario con una asignación existente
Una semana después del caso 1, Jane visita NoticiasDeEjemplo.com nuevamente. Ahora que Jane tiene cookies de ofertantes y de Ad Manager en su máquina, así es como funciona.
- La página web se renderiza, lo que hace que Google (Ad Manager) solicite anuncios que se renderizarán en la página.
- 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 indicadores como el
google_user_id
- FinestDSP busca el elemento
google_user_id
en su tabla de coincidencias. y encuentra la cookie asociada con Jane que se creó una semana antes (en el escenario 1). - Según la información asociada a la cookie, la oferta de FinestDSP establece una oferta en la impresión y gana la subasta.
- Jane podría ver un anuncio adaptado a sus intereses, en función de la información que posee FinestDSP.
Iniciado por el ofertante: Concordancia unidireccional de cookies
La concordancia unidireccional de cookies es similar al flujo de trabajo bidireccional,
excepto que se altera de modo que solo Google aloje y propague una coincidencia
desde una tabla de particiones. Se puede utilizar en los casos en que el ofertante no tenga permiso para alojar
Los IDs de usuario de Google en su propia tabla de coincidencias Para usar este flujo, los ofertantes
debe permitir que Google aloje la tabla de coincidencias, ya no puede especificar
google_cm
en las solicitudes al Servicio de Concordancia de Cookies de Google
por lo tanto, no recibirán google_gid
para propagar sus propios
de coincidencias exactas. Una vez que Google establece una coincidencia para un usuario, los ofertantes pueden agregar
a las listas de usuarios
utilizando sus propios datos de cookies. Del mismo modo, las solicitudes de oferta para
estos usuarios excluirán el ID de usuario de Google, pero incluirán datos de coincidencia alojados. R
del flujo de trabajo revisado se resume en los pasos a continuación.
Paso 1: Coloca la etiqueta de coincidencia dirigida a la URL de concordancia de cookies del ofertante
Para iniciar este flujo, el ofertante debe colocar una etiqueta de coincidencia de modo que
se renderiza en el navegador del usuario. A diferencia del flujo de trabajo para los usuarios
que no residan en EE.UU. con restricciones de privacidad,
la etiqueta de coincidencia debe dirigir el navegador del usuario a tu cookie
La URL coincide. Por ejemplo, con una URL de concordancia de cookies configurada como
https://ad.network.com/pixel
, se vería de la siguiente manera:
<img src="https://ad.network.com/pixel" />
Cuando se cargue en el navegador del usuario, se solicitará un píxel al directorio URL de concordancia de cookies. Esta solicitud contendrá su cookie en el encabezado HTTP que se debe extraer para el siguiente paso.
Paso 2: Redirecciona al servicio de concordancia de cookies de Google
El extremo de concordancia de cookies del ofertante debe redireccionar a la cookie de Google
Servicio de concordancia, incluido el parámetro google_hm
propagado con
sus datos de cookies codificados en Base64 y seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto:
lo siguiente:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Paso 3: El navegador del usuario se redirecciona al servicio de concordancia de cookies de Google
Google recibirá un redireccionamiento con los parámetros que especificaste, en además de la cookie de Google en los encabezados HTTP.
Paso 4: Si se especifica la URL del informe, Google muestra píxeles en caso de éxito o redireccionamiento de error
Si la operación de concordancia de cookies se realiza correctamente o si no hay ninguna cookie
Se especificó la URL del informe coincidente para la cuenta del ofertante: Google
publicará un píxel transparente de 1 x 1 de forma predeterminada y el flujo de trabajo finalizará aquí.
Las impresiones de este usuario en las solicitudes de oferta posteriores incluirán la columna
datos de coincidencia alojados en BidRequest.hosted_match_data
para la
Protocolo, o BidRequest.user.buyeruid
para OpenRTB de Google
para implementarlos. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencia alojados
que especificaron.
De lo contrario, si se produce un error, Google enviará un redireccionamiento al
URL del informe de concordancia de cookies con la causa del error especificada en el
Parámetro google_error
. Si la URL del Informe de concordancia de cookies del ofertante
fuera https://ad.network.com/report
, la URL de redireccionamiento se vería
como:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
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
. Para obtener más información sobre cómo interpretar el error
consulta la descripción del parámetro.
Paso 6: El ofertante publica píxeles transparentes de 1 x 1
El ofertante debe responder entregando un píxel transparente de 1 x 1 al navegador.
Diagrama del flujo de trabajo de concordancia de cookies para usuarios de estados de EE.UU. con restricciones de privacidad
En este diagrama, se ilustra el flujo de trabajo predeterminado para los usuarios de estados de EE.UU. con restricciones de privacidad a continuación, donde las solicitudes y respuestas están representadas por una flecha, y los datos los artículos que los acompañan se enumeran entre paréntesis.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=19&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 mediante la pestaña Ofertantes recurso. |
google_sc |
Este parámetro dejó de estar disponible. Establece la cookie de Google para la usuario si no hay uno presente. El valor del parámetro se ignora y puede omitirse. Omitir el parámetro genera un error si no hay cookies existe. |
google_no_sc |
Este parámetro dejó de estar disponible. Esto indica a la nube de concordancia de cookies que no debería establecer una cookie para el usuario si uno no está presente. El valor del parámetro se ignora y puede omitido. |
google_hm |
Contiene datos que el ofertante desea almacenar en una coincidencia alojada en Google desde una tabla de particiones. |
google_redir |
Una URL codificada a la que deseas que Google envíe un redireccionamiento HTTP 302. El
la URL especificada recibirá redireccionamientos con el google_error
para los errores y las operaciones exitosas. |
google_ula |
Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El valor
el formato esperado es userlistid[,timestamp] :
Este parámetro de URL se puede repetir para agregar al usuario a varios listas. |
gdpr |
Indica que la solicitud está sujeta a las restricciones de datos del GDPR
de uso de la nube. Para obtener más información, consulta
Requisitos de consentimiento de usuarios de la UE a continuación, o bien Impacto en la concordancia de cookies
la elegibilidad en la
.
Documentación del MTC v2.0 de IAB de Authorized Buyers
Ejemplo: |
gdpr_consent |
Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, Consulte los requisitos de consentimiento de usuarios de la UE. o ¿Cómo se pasará la cadena de TC? en la . Documentación del MTC v2.0 de IAB de Authorized Buyers |
process_consent |
Indica que el ofertante obtuvo el consentimiento del usuario final para los usos de datos especificados en
Política de Consentimiento de Usuarios de la UE de Google
Si la solicitud no está sujeta a la Política de Consentimiento de Usuarios de la UE o si
hay otros parámetros de consentimiento disponibles en la solicitud
( 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 de solicitud general. Cuándo
recibidos, indica que no se realizaron operaciones y que ninguna otra
Se establecerán
|
Iniciado por Google: Coincidencia bidireccional de píxeles
La concordancia bidireccional de píxeles es un flujo de trabajo para la concordancia de cookies de Google Servicio en el que Google intenta hacer coincidir un ID de usuario de Google con un ID al ofertante seleccionado que no sea el ganador de la subasta de Ofertas en tiempo real. Cuando un anuncio se Google colocará una etiqueta de coincidencia que indicará al navegador del usuario que cargue una píxel transparente de la URL de concordancia de cookies del ofertante elegido Esto habilitará tanto Google como el ofertante para completar una tabla de coincidencias con un usuario determinado. Abajo está un ejemplo sencillo de este flujo de trabajo.
Paso 1: Google coloca una etiqueta coincidente
Cuando la página de un editor participante se carga en el navegador del usuario, y una
Google rellena el espacio publicitario de esa página, se puede colocar una etiqueta de concordancia
solicita un píxel a un ofertante seleccionado algorítmico. La coincidencia de Pixel
etiqueta colocada por Google combina la URL de concordancia de cookies del ofertante con
parámetros adicionales que
que el ofertante puede usar para propagar su tabla de coincidencias. Para una URL de concordancia de cookies
especificado como https://ad.network.com/pixel
, se estructura como
sigue:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Paso 2: El ofertante debe responder con un 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 redireccionar al Servicio de Concordancia de Cookies de Google que se estructura de la siguiente manera:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Ten en cuenta que la URL de redireccionamiento anterior es similar a la de la URL utilizada en el
etiqueta de coincidencia del flujo de trabajo de concordancia de cookies iniciado por el ofertante.
En la coincidencia de píxeles, el parámetro google_cm
se reemplaza por el
el parámetro google_push
y su valor debe ser igual al valor
proporcionadas por Google en la solicitud. También es similar a lo que inició el ofertante
flujo de trabajo, parámetros adicionales
para cumplir con casos de uso adicionales.
Paso 3: Google procesa el redireccionamiento y responde con píxeles
Google registra que se creó una coincidencia para el usuario y controla operaciones adicionales solicitadas a través de parámetros de consulta. Por último, Google responde con un píxel transparente de 1 x 1.
Diagrama del flujo de trabajo de Coincidencia de píxeles
Este flujo de trabajo se ilustra en el siguiente diagrama, donde las solicitudes y las respuestas están representadas por una flecha y los elementos de datos que las acompañan se enumeran entre paréntesis.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=19&hl=es)
Parámetros de solicitud de la etiqueta de coincidencia de Google
Parámetro | Descripción |
---|---|
google_gid |
Es el ID de usuario de Google. En el caso de los usuarios que no residen en un estado de EE.UU. con restricciones de privacidad, esta opción siempre se especificadas en la etiqueta de coincidencia de Google. |
google_cver |
Es la versión de la cookie. Esto siempre se especificará en la coincidencia de Google etiqueta. |
google_push |
Indica que esta solicitud inicia el flujo de trabajo de coincidencia de píxeles. El valor se debe devolver a través del parámetro correspondiente en la columna respuesta de redireccionamiento. |
Parámetros de redireccionamiento de coincidencia de píxeles del ofertante
Parámetro | Descripción |
---|---|
google_nid |
Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar mediante la pestaña Ofertantes recurso. |
google_push |
Indica que este redireccionamiento está completando el proceso de coincidencia de Pixel. en el flujo de trabajo. El valor de la etiqueta de coincidencia de Google correspondiente debe tener se especifican aquí. |
google_hm |
Contiene datos que el ofertante desea almacenar en una coincidencia alojada en Google desde una tabla de particiones. |
google_ula |
Es una cadena que se usa para agregar al usuario a una lista de usuarios existente. El valor
el formato esperado es userlistid[,timestamp] :
Este parámetro de URL se puede repetir para agregar al usuario a varios listas. |
Iniciado por Google: Coincidencia unidireccional de píxeles
La Coincidencia unidireccional de píxeles difiere del flujo de trabajo bidireccional en que la etiqueta de coincidencia de Google no incluya un parámetro que especifique el nombre de usuario ID, pero continuará propagando una tabla de coincidencias alojada en Google. Esto se puede usar en los casos en que el ofertante no tenga permiso para alojar IDs de usuario de Google en su propia tabla de coincidencias. Un ejemplo sencillo del flujo de trabajo revisado se resume en el pasos a continuación.
Paso 1: Google coloca una etiqueta coincidente
Google coloca una etiqueta de coincidencia para un ofertante seleccionado algorítmico. La etiqueta de coincidencia incluye el
Parámetro google_push
. Por ejemplo:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Paso 2: El navegador del usuario solicita el píxel de la URL de cocina de coincidencia del ofertante
El navegador del usuario solicita un píxel de la URL de concordancia de cookies del ofertante. incluida la cookie del ofertante en los encabezados HTTP.
Paso 3: Redirecciona al Servicio de concordancia de cookies de Google
El extremo de concordancia de cookies del ofertante debe redireccionar a la cookie de Google
Servicio de concordancia, incluido el parámetro google_hm
propagado con
sus datos de cookies codificados en Base64 y seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto:
lo siguiente:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Paso 4: El navegador del usuario se redirecciona al servicio de concordancia de cookies de Google
Google recibirá un redireccionamiento con los parámetros que especificaste, en
además de la cookie de Google en los encabezados HTTP. Si la operación era
correctas, las impresiones para este usuario en las solicitudes de oferta posteriores incluirán
los datos de coincidencia alojados del ofertante en BidRequest.hosted_match_data
por
el protocolo de Google, o BidRequest.user.buyeruid
para la interfaz
Implementación de OpenRTB. Los ofertantes también pueden propagar listas de usuarios
coinciden con los datos que especificaron.
Por último, Google muestra un píxel transparente de 1 x 1 al navegador del usuario.
Cookie Match Assist
Open Bidding permite que los intercambios usen las ofertas Iniciadas por el ofertante. e iniciadas por Google flujos de trabajo de concordancia de cookies, para hacer coincidir un ID de usuario de Google con su cookie. Para galletas Match Assist (CMA) es una función adicional para los intercambios que les permite y crear tablas de coincidencias con sus propios ofertantes.
Cómo funciona Cookie Match Assist
Al colocar un anuncio, Google selecciona algorítmicamente un usuario Exchange y coloca una etiqueta de Cookie Match Assist con la siguiente información: estructura:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
La etiqueta de coincidencia de CMA de Google hace que la URL de concordancia de cookies del intercambio recibir una solicitud de píxel.
- El extremo de coincidencia de cookies del intercambio recibe la solicitud, su propio servicio de concordancia de cookies es responsable de hacer coincidir el ID del usuario con uno de sus ofertantes. En el siguiente diagrama, la coincidencia de cookies del intercambio servicio responde al navegador del usuario con un redireccionamiento a uno de los servidores de en los extremos.
- El ofertante recibe la solicitud, junto con cualquier parámetro que especifique que el intercambio haga coincidir el ID del usuario con su cookie.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=19&hl=es)
Restricciones
Limitar la frecuencia de las solicitudes de coincidencias nuevas
Los ofertantes son responsables de limitar la cantidad de llamadas a la cookie. Servicio de coincidencias para los usuarios que tienen una entrada nueva en la coincidencia alojada en Google desde una tabla de particiones. Una entrada en la tabla de coincidencias alojada se puede considerar vencida en 14 días después de lo cual se puede actualizar.
Responde a todas las solicitudes de coincidencia de píxeles
Se espera que los ofertantes que utilizan el flujo de trabajo de Concordancia con píxeles respondan a todos
Solicitudes entrantes de Pixel Match con una respuesta que incluye google_push
parámetro. Esto le permite a Google aplicar políticas mediante la supervisión del uso. Si un
si la tasa de respuesta del ofertante cae por debajo del 90%, Google limitará la cantidad de
Se enviaron las solicitudes de Pixel Match a su cuenta.
Usa extremos HTTPS
Es obligatorio que los extremos que se usan en todos los flujos de trabajo de concordancia de cookies usen HTTPS
Al responder a una solicitud de Pixel Match que se te envió a través de HTTPS, tienes las siguientes opciones: para redireccionar al Servicio de concordancia de cookies a través de HTTPS. Del mismo modo, un extremo de Cookie Match Assist que redireccione a los ofertantes también debe usar HTTPS. Si envías solicitudes a Google a través de HTTP con más frecuencia que una vez cada 2 minutos Se limitará la cantidad de solicitudes de coincidencia enviadas a tu cuenta.
Requisitos de consentimiento de usuarios de la UE
las solicitudes de concordancia de cookies que están sujetas Usuario de la UE de Google La Política de Consentimiento debe indicar el consentimiento del usuario final. Dichas solicitudes son necesarias para indique que se recopiló el consentimiento de una de las siguientes maneras:
- MTCv2: Incluye
gdpr
ygdpr_consent
parámetros. Para obtener más información, consulta la Documentación del MTC v2.0 de IAB en Authorized Buyers process_consent
: Es una declaración que obtuvo el ofertante el consentimiento necesario de los usuarios.
Ejemplos
Los siguientes ejemplos ilustran cómo utilizar el servicio de concordancia de cookies para lo siguiente: lograr objetivos específicos. Ten en cuenta que, a menos que se indique lo contrario, es se supone que el usuario sobre el que se actúa no es Estado de EE.UU. con restricciones de privacidad.
Propagar una tabla de coincidencias alojada por el ofertante
Un ofertante puede usar el flujo de trabajo de concordancia de cookies para propagar su propia coincidencia
proporcionando solo los objetos google_nid
y google_cm
parámetros en su etiqueta de coincidencia. El aspecto podría ser el siguiente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Si la URL de concordancia de cookies del ofertante está configurada como https://ad.network.com/pixel?id=1
y la operación de concordancia de cookies es exitosa, el redireccionamiento que envía Google
respuesta a la etiqueta de coincidencia del ofertante podría tener el siguiente aspecto:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Si la operación de concordancia de cookies falla porque el usuario no tiene un cookie de Google, la respuesta sería:
https://ad.network.com/pixel?id=1&google_error=3
El código de error depende de la causa subyacente del error. Para aprender para obtener más información sobre los posibles códigos de error del flujo de trabajo de concordancia de cookies, consulta la parámetros de redireccionamiento de la URL.
Agregar a una sola lista de usuarios
El parámetro google_ula
se puede especificar en la coincidencia de un ofertante
etiqueta para agregar al usuario a una lista de usuarios con un ID determinado. Si el botón de Google o
la tabla de coincidencias alojada por el ofertante tiene una entrada nueva para el usuario, este puede colocar
una etiqueta de coincidencia que incluya google_nid
y google_ula
parámetros para agregar al usuario a la lista especificada sin iniciar el proceso
Flujo de trabajo de concordancia de cookies. Consulta las restricciones.
sobre cómo invocar el servicio de concordancia
de cookies para obtener más detalles. El modelo de
la etiqueta de coincidencia podría verse así:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Para una respuesta exitosa, cuando la URL de concordancia de cookies del ofertante sea
https://ad.network.com/pixel
, la URL de redireccionamiento de Google sería la siguiente:
https://ad.network.com/pixel?google_ula=12345,0
Si hay un error general, por ejemplo, no hay una cookie de Google
para el usuario, la URL de redireccionamiento incluirá el elemento
Parámetro google_error
:
https://ad.network.com/pixel?google_error=3
Si hay un error específicamente relacionado con agregar al usuario a la lista,
recibirás google_ula
en el redireccionamiento. A diferencia de
parámetro de etiqueta de coincidencia correspondiente; esto reemplaza la marca de tiempo por un estado
código para indicar el éxito de la operación. Por ejemplo, si la solicitud falló
porque la cuenta del ofertante no tenía acceso a la lista de usuarios especificada,
la URL de redireccionamiento sería la siguiente:
https://ad.network.com/pixel?google_ula=12345,2
Agregar a varias listas de usuarios
Los ofertantes pueden especificar que un usuario se debe agregar a varias listas de usuarios de la siguiente manera:
incluidos varios parámetros google_ula
en la etiqueta de coincidencia. En
práctica, esto podría verse así:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
El estado de la operación para cada lista de usuarios se informa de manera similar a través de
Parámetros google_ula
distintos en el redireccionamiento:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
En el redireccionamiento anterior, podemos ver que la operación se realizó correctamente para el usuario.
lista con el ID 45678
, pero falló con el ID de lista de usuarios 12345
porque el ofertante no tenía permiso para acceder a ella.
Analizar el flujo de trabajo de concordancia de cookies y agregar elementos a la lista de usuarios
Para realizar la concordancia de cookies y agregar el usuario a una lista de usuarios de una
solicitud, la etiqueta de coincidencia de un ofertante debe incluir google_cm
y
google_ula
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
La URL de redireccionamiento especificada por Google incluye google_gid
,
google_cver
y google_ula
. Esto podría verse así
lo siguiente:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Cómo almacenar una coincidencia en una tabla de coincidencias alojada en Google
Si un ofertante quiere almacenar sus datos de cookies en una tabla de coincidencias alojada en Google,
y no pretende almacenar una coincidencia con el ID de usuario de Google en su propia coincidencia.
tabla, su etiqueta de coincidencia debe incluir el parámetro google_hm
, en el que
su valor debe ser una cadena codificada en base64 segura para la Web. Para un usuario en el que
los datos de cookies sin codificación del ofertante son Cookie number 1!
, el
valor sería Q29va2llIG51bWJlciAxIQ==
, que se usaría en un
coincide con la etiqueta como se muestra a continuación:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Para una respuesta exitosa, cuando la URL de concordancia de cookies del ofertante sea
https://cookie-monster.com/pixel
, la URL de redireccionamiento de Google
ser:
https://cookie-monster.com/pixel
El parámetro google_gid
no se encuentra en el redireccionamiento porque el elemento
la etiqueta de coincidencia no incluía google_cm
, y google_hm
es
no se incluyen en las respuestas exitosas. En futuras solicitudes de oferta para impresiones
para este usuario, el ofertante recibirá sus datos de coincidencia alojados en
BidRequest.hosted_match_data
para el protocolo de RTB de Google
BidRequest.user.buyeruid
para la implementación de OpenRTB de Google.
Si, en cambio, el ofertante usó una etiqueta de coincidencia en la que el valor de
google_hm
no estaba codificado en base64, por ejemplo,
chocolate_chunk!
: la URL de redireccionamiento podría ser similar a la
lo siguiente:
https://cookie-monster.com/pixel?google_hm=2
La URL de redireccionamiento anterior incluye un valor google_hm
de
2
, lo que sugiere que la operación falló porque el valor podría
no pueden decodificarse.
Tablas de coincidencia alojadas en Google y ofertantes con listas de usuarios
Si un ofertante aloja su propia lista de uso además de un usuario alojado en Google
y desea que una sola etiqueta de coincidencia coincida con ambas tablas y agregue al usuario a un
lista de usuarios determinada, su etiqueta de coincidencia debe incluir google_cm
,
Parámetros google_hm
y google_ula
. Si el ofertante
los datos de cookies son Cookie number 1!
, el valor codificado sería
Q29va2llIG51bWJlciAxIQ==
, que produciría una etiqueta de coincidencia como la
lo siguiente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Para una respuesta exitosa, cuando la URL de concordancia de cookies del ofertante sea
https://cookie-monster.com/pixel
, la URL de redireccionamiento de Google
verse de la siguiente manera:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Al recibir el redireccionamiento, el ofertante puede coincidir con el ID de usuario de Google especificado.
en google_gid
con los datos de sus cookies en su tabla de coincidencias. En
además de determinar si la tabla de coincidencias
y la lista de usuarios alojadas en Google
de que se llevaron a cabo correctamente. En consecuencia, cualquier segmentación previa para el ofertante
configurado para orientarse al ID de la lista de usuarios especificado, ahora el ofertante
recibir solicitudes de oferta para impresiones del usuario. Del mismo modo, en estas ofertas
el ofertante recibirá sus datos de coincidencia alojados en
BidRequest.hosted_match_data
para el protocolo de RTB de Google
BidRequest.user.buyeruid
para la implementación de OpenRTB de Google.