La Segmentación por cookies es una función que te permite hacer coincidir tu cookie (por ejemplo, un ID de un usuario que exploró 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 que se usan en la coincidencia de cookies, así como los diferentes flujos de trabajo de la coincidencia de cookies y las variaciones que pueden tener para 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 exploran su sitio, que 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 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 las ofertas en tiempo real pueden tener su propio dominio en el que identifican a un conjunto de usuarios que les gustaría mostrar anuncios. La coincidencia de cookies permite que el ofertante haga 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 segmenta la publicidad. Recibirá sus propios datos de cookies o un ID de usuario de Google específico del ofertante que es una forma encriptada de la cookie doubleclick.net en la solicitud de oferta.
El servicio de coincidencia 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 propagar listas de usuarios.
Tablas de coincidencias
Se puede usar una tabla de coincidencias para asignar un ID o cualquier otro dato de un dominio a otro. Los ofertantes pueden usar el servicio de coincidencia de cookies para propagar sus propias tablas de coincidencias asignando su cookie de un usuario determinado al ID de usuario de Google del usuario o para propagar una tabla de coincidencias alojada por Google. Las tablas de coincidencias son necesarias para que la aplicación de un ofertante acceda a los datos de cookies del usuario al que se le muestra la impresión.
Tablas de coincidencias alojadas en Google
Para facilitar el mantenimiento, mejorar la latencia y acceder a los datos de coincidencias de los usuarios en ciertas regiones, te recomendamos que permitas que Google aloje tu tabla de coincidencias. Esto te permite especificar una cadena codificada en base64 segura para la Web, que 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 ofertas posteriores para impresiones asociadas con el usuario, Google te enviará los datos de coincidencia alojados que coincidan con su ID de usuario de Google. En la implementación de OpenRTB de Google,
BidRequest.user.buyeruidespecificará esto como una cadena codificada en base64 segura para la Web. Si tu extremo de ofertas está configurado para usar el protocolo de RTB de Google obsoleto, lo recibirás como bytes decodificados a través del campoBidRequest.hosted_match_data.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 de modo que solo recibas solicitudes de ofertas que contengan datos de coincidencia alojados. Esto se puede usar para eliminar las impresiones menos relevantes para los usuarios fuera de tu espacio de cookies.
Listas de usuarios
Las listas de usuarios se pueden crear y administrar con la API de Real-Time Bidding. Una vez creadas, puedes propagar estas listas con los flujos de trabajo de coincidencia de cookies que se describen a continuación o a través del servicio de carga masiva.
Comenzar
Para comenzar a usar la Segmentación por cookies, debes comunicarte con tu administrador técnico de cuentas, quien puede habilitar flujos de trabajo específicos y ayudarte a configurar lo siguiente:
- ID de red de coincidencia de cookies (NID): Es un ID de cadena que identifica de forma inequívoca una cuenta de ofertante para la coincidencia de cookies y otras operaciones relacionadas.
- Cookie que coincide con la URL: Es la URL base de un extremo que aceptará y controlará las solicitudes entrantes como parte de los flujos de trabajo de Cookie Matching. Los ofertantes pueden incorporar macros en esta URL para controlar el orden de los parámetros que se le pasan en los flujos de trabajo de concordancia de cookies.
- Etiqueta de concordancia: Es la etiqueta que debes colocar en el navegador de un usuario para el flujo de trabajo de concordancia de cookies que inicia el ofertante. Se puede publicar junto con 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, esta es una URL opcional que se puede proporcionar para especificar un extremo que recibirá detalles de error en caso de que la coincidencia de cookies falle a través de un redireccionamiento HTTP 302. De forma predeterminada, las respuestas solo se enviarán a esta URL si hubo un error con la operación de coincidencia de cookies, pero el ofertante puede solicitar que siempre se envíe el redireccionamiento.
- URL de Cookie Match Assist: En el caso de los intercambios que implementan el flujo de trabajo de Cookie Match Assist, esta es la URL base del extremo que se diseñó para 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 Cookie Matching puede recibir por segundo. El objetivo es evitar que las solicitudes de la CMA sobrecarguen los servidores del intercambio con solicitudes.
Macros de concordancia de cookies
En cualquiera de los flujos de trabajo de coincidencia de cookies compatibles, la URL de coincidencia de cookies de un ofertante suele tener parámetros agregados en un orden no garantizado. Los ofertantes con integraciones que requieren un orden coherente de los parámetros pueden colocar macros en su URL de coincidencia de cookies para garantizar su posición.
Macros compatibles
De manera opcional, los ofertantes pueden configurar su URL de coincidencia de cookies para incluir una o más macros en forma de %%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 predefinidos definidos por el ofertante, además de los parámetros de Concordancia de píxeles en el siguiente orden: google_push, google_gid, google_cver y google_error. Para ello, el ofertante debe configurar su URL que coincide con la cookie 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 una solicitud de coincidencia a este ofertante más adelante, se expandirá a algo similar a lo siguiente:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Flujos de trabajo del Servicio de concordancia de cookies
Actualmente, el servicio de coincidencia de cookies de Google admite tres flujos de trabajo para diferentes casos de uso que se describen a continuación.
Iniciado por el ofertante: Concordancia bidireccional de cookies
La coincidencia de cookies bidireccional se refiere a un flujo de trabajo iniciado por el ofertante, en el que se coloca una etiqueta de coincidencia en el navegador del usuario que lo dirige a Google. Este flujo de trabajo permite que Google y el ofertante propaguen las tablas de coincidencias. A continuación, se muestra un ejemplo simple 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 concordancia simple que solo muestra el ID de usuario de Google al ofertante puede estructurarse de la siguiente manera:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Hay parámetros adicionales que puedes incluir en la etiqueta de concordancia para cumplir con diferentes casos de uso. Para obtener más información sobre estos parámetros, consulta Cómo hacer coincidir los parámetros de la URL de las etiquetas.
Paso 2: Google responde con un redireccionamiento que incluye datos de coincidencia
La etiqueta de coincidencia hará que el servicio de coincidencia de cookies de Google reciba una solicitud del navegador del usuario, que emitirá un redireccionamiento HTTP 302 a la URL de coincidencia de cookies del ofertante. El redireccionamiento incluirá parámetros de consulta que especifiquen el ID de usuario de Google y su número de versión en la URL, y el ofertante también recibirá su cookie incluida en los encabezados de solicitud. En la práctica, para una URL que coincide con una cookie especificada como https://ad.network.com/pixel, la URL de redireccionamiento de la etiqueta de concordancia simple, como se ve más arriba, podría verse de la siguiente manera:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
El ID de usuario de Google que se pasa a través del parámetro google_gid es una string codificada en base64 segura para la Web y sin padding. En el caso de los ofertantes que eligen alojar una tabla de coincidencias, se recomienda que almacenen la cadena exacta que muestra el servicio de coincidencia de cookies. En las solicitudes de oferta posteriores, esto corresponderá a los valores especificados a través de BidRequest.user.id en OpenRTB o BidRequest.google_user_id en el protocolo RTB de Google obsoleto.
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 y, luego, aumentará.
Si Google encuentra un error mientras procesa tu solicitud de coincidencia, se especificará un parámetro google_error.
Paso 3: El ofertante procesa el redireccionamiento y responde con píxeles
El ofertante recibe un redireccionamiento a su URL de coincidencia de cookies, que incluye los parámetros que especificó en el primer paso y los que proporcionó Google en el segundo paso. Además, también recibirá su cookie en los encabezados HTTP. Si la operación se realizó correctamente, un ofertante que aloja su propia tabla de coincidencias podría hacer coincidir su cookie con el ID de usuario de Google incluido en la respuesta. Se recomienda que los ofertantes almacenen la cadena exacta que devuelve el servicio de coincidencia 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. Obtén más información sobre los posibles valores de error aquí.
Si recibes un error, puedes intentar volver a hacer coincidir a ese usuario colocando una nueva etiqueta de coincidencia.
El ofertante debe responder siempre con una imagen de píxeles invisibles de 1 x 1 o, como alternativa, mostrar una respuesta HTTP 204 No Content.
Diagrama del flujo de trabajo de concordancia de cookies
En el siguiente diagrama, se ilustra este flujo de trabajo, en el que las solicitudes y las respuestas se representan con una flecha, y los elementos de datos que las acompañan se enumeran entre paréntesis.
Parámetros de URL de la etiqueta de coincidencia
| Parámetro | Descripción |
|---|---|
google_nid |
Es el ID de red (NID) de la cuenta del ofertante. Este ID se puede recuperar a través del recurso Bidders. |
google_cm |
Le indica al servicio de concordancia de cookies de Google que debe realizar la concordancia de cookies. Se ignora el valor del parámetro y se puede omitir. |
google_sc |
Este parámetro dejó de estar disponible. Establece la cookie de Google para el usuario si no hay una. Se ignora el valor del parámetro y se puede omitir. Si omites el parámetro, se producirá un error si no existe ninguna galleta. |
google_no_sc |
Este parámetro dejó de estar disponible. Esto le indica al servicio de coincidencia de cookies de Google que no debe establecer una cookie para el usuario si no hay una. El valor del parámetro se ignora y se puede omitir. |
google_hm |
Son los datos que el ofertante desea almacenar en una tabla de coincidencias alojada por Google.
El valor es una cadena codificada en base64 segura para la Web (relleno opcional). Los datos sin procesar deben ser de 40 bytes o menos. Por ejemplo, |
google_redir |
Es una cadena codificada como URL que un ofertante puede especificar si desea dirigir a Google para que envíe el redireccionamiento HTTP 302 a la URL codificada para esta etiqueta de concordancia. Esto permite que Google se coloque en primer lugar en 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 RGPD 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 la concordancia de cookies 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, consulta los requisitos de consentimiento de los 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 para compradores autorizados. |
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 parámetros, que se agregarán como parámetros a la URL de redireccionamiento. Ten en cuenta que se ignorarán los parámetros definidos por el ofertante que se nombren con el prefijo google_, ya que Google los reserva para el desarrollo futuro y no se garantiza la preservación del orden de los parámetros. Una etiqueta de concordancia que incluye parámetros definidos por el ofertante puede verse de la siguiente manera:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Parámetros de URL de redireccionamiento
La URL de redireccionamiento se crea a partir de la URL de coincidencia de cookies base configurada para la cuenta de un ofertante, incluidos google_ y los parámetros definidos por el ofertante, según los que se especifiquen en la etiqueta de coincidencia. Se definen los siguientes parámetros de respuesta de google_:
| Parámetro | Descripción |
|---|---|
google_gid |
ID de usuario de Google Se establece si se especifica google_cm en la solicitud y esta se realizó correctamente. |
google_cver |
Versión de la cookie. Se establece si se especifica google_cm en la solicitud y esta se realizó correctamente. |
google_error |
Un número entero que indica el error de solicitud general. Cuando se recibe, indica que no se realizaron operaciones y que no se establecerán otros parámetros de respuesta de
|
google_hm |
Solo aparece si falla el intento de escribir en la tabla de coincidencias alojada por Google. Cuando eso sucede, su valor es uno de los siguientes códigos de estado:
|
google_ula |
Estado de la operación de adición de la lista de usuarios, repetida si se especificaron varios Ejemplo: La operación
|
Situaciones de ejemplo del flujo de trabajo de coincidencia de cookies
En las siguientes situaciones, se describe cómo podría ser la coincidencia de cookies para un usuario típico que navega 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, visita la página principal de ExampleNews.com.
Esto es lo que ocurre:
- ExampleNews.com renderiza y llama a 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 oferta a FinestDSP y a otros ofertantes a través del servicio de ofertas en tiempo real.
- La aplicación del ofertante de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta de oferta.
- Google recibe respuestas de ofertas de los ofertantes, incluida la respuesta de FinestDSP que especifica 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 Cristina.
- La etiqueta de coincidencia llama al servicio de Cookie Match de Google y especifica los parámetros
google_nidygoogle_cm. - El servicio de concordancia de cookies lee la cookie de Google de Jane y envía al navegador de Jane un redireccionamiento a la URL de concordancia de cookies de FinestDSP con los parámetros
google_gidygoogle_cverestablecidos. - El navegador de Jane carga el redireccionamiento a la URL de coincidencia de cookies de FinestDSP.
- El extremo de coincidencia de cookies de FinestDSP procesa la solicitud de redireccionamiento, que incluye los parámetros de URL establecidos por Google y su cookie para Jane en los encabezados HTTP. FinestDSP ahora puede almacenar la asignación de su cookie a la
google_giden su tabla de coincidencias. - FinestDSP responde al redireccionamiento con un píxel invisible de 1 x 1.
Situación 2: Usuario con asignación existente
Una semana después del caso 1, Jane visita NoticiasDeEjemplo.com nuevamente. Ahora que Jane tiene las cookies del ofertante y de Ad Manager en su máquina, veamos cómo funciona la coincidencia.
- Se renderiza la página web, lo que hace 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 indicadores como
google_gid. - FinestDSP busca el
google_giden su tabla de coincidencias y encuentra la cookie asociada con Jane que se creó una semana antes (en la situación 1). - En función de la información asociada con la cookie, la lógica de ofertas de FinestDSP realiza una oferta en la impresión y gana la subasta.
- Es posible que Jane vea un anuncio personalizado según sus intereses, en función de la información que tiene FinestDSP.
Iniciado por el ofertante: Concordancia unidireccional de cookies
La coincidencia de cookies unidireccional es similar al flujo de trabajo bidireccional, excepto que se modifica de modo que solo Google aloje y propague una tabla de coincidencias. Esto se puede usar en casos en los que el ofertante no tiene permiso para 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 coincidencia de cookies de Google y, en consecuencia, no recibirán google_gid para propagar su propia tabla de coincidencias. Una vez que Google establece 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 ofertas 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: Coloca la etiqueta de coincidencia dirigida a la URL de coincidencia 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 los usuarios que no residen en un estado de EE.UU. y tienen restricciones de privacidad, la etiqueta de coincidencia debe dirigir el navegador del usuario a la URL de concordancia de cookies. Por ejemplo, con una URL de coincidencia de cookies configurada como https://ad.network.com/pixel, se vería de la siguiente manera:
<img src="https://ad.network.com/pixel" />
Cuando se cargue en el navegador del usuario, solicitará un píxel de la URL de coincidencia de cookies del ofertante. Esta solicitud contendrá su cookie en el encabezado HTTP, que se debe extraer para el siguiente paso.
Paso 2: Redirecciona al servicio de Cookie Matching de Google
El extremo de concordancia 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: El navegador del usuario se redirecciona al servicio de coincidencia de cookies de Google
Google recibirá un redireccionamiento que contiene los parámetros que especificaste, además de la cookie de Google en los encabezados HTTP.
Paso 4: Google publica el píxel en el redireccionamiento de éxito o error si se especifica la URL del informe
Si la operación de coincidencia de cookies se realiza correctamente o si no se especificó una URL de informe de coincidencia de cookies para la cuenta del ofertante, Google publicará un píxel transparente de 1 × 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 por el ofertante en BidRequest.user.buyeruid para OpenRTB o BidRequest.hosted_match_data para el Protocolo de RTB de Google obsoleto. 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 a la URL del informe de coincidencias 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 cookies que coinciden del ofertante
El navegador del usuario redireccionará a la URL del informe de coincidencia de cookies del ofertante, incluido el motivo del error (si corresponde) que Google especifique en el parámetro google_error. Para obtener más información sobre cómo interpretar el código de error, consulta la descripción del parámetro.
Paso 6: El ofertante publica un píxel transparente de 1 × 1
El ofertante debe responder publicando un píxel transparente de 1 × 1 en el navegador del usuario.
Diagrama de flujo de trabajo de Cookie Matching 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 de 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.
Parámetros de URL para redireccionar al ofertante al servicio de Cookie Matching de Google
| Parámetro | Descripción |
|---|---|
google_nid |
Es el ID de red (NID) de la cuenta de oferta. Este ID se puede recuperar a través del recurso Bidders. |
google_sc |
Este parámetro dejó de estar disponible. Establece la cookie de Google para el usuario si no hay una presente. Se ignora el valor del parámetro y se puede omitir. Omitir el parámetro genera un error si no existe ninguna cookie. |
google_no_sc |
Este parámetro dejó de estar disponible. Esto le indica al servicio de coincidencia de cookies de Google que no debe establecer una cookie para el usuario si no hay una. 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 por Google. |
google_redir |
Una URL codificada a la que deseas que Google envíe un redireccionamiento HTTP 302. La URL especificada recibirá redireccionamientos con el parámetro google_error tanto para los errores como para las operaciones correctas. |
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 RGPD sobre el uso de datos. Para obtener más detalles, consulta los
requisitos de consentimiento de los usuarios de la UE a continuación o el Impacto en la elegibilidad de la Segmentación por cookies en la
documentación de la versión 2.0 del MTC de IAB para Compradores Autorizados.
Ejemplo: |
gdpr_consent |
Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más información, 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 de la versión 2.0 del MTC de IAB de 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: |
Parámetros de URL para que Google redireccione a la URL del informe de cookies que coinciden con la URL del ofertante
| Parámetro | Descripción |
|---|---|
google_error |
Un número entero que indica el error de solicitud general. Cuando se recibe, indica que no se realizaron operaciones y que no se establecerán otros parámetros de respuesta de
|
Iniciado por Google: Coincidencia bidireccional de píxeles
La coincidencia de píxeles bidireccional es un flujo de trabajo para el servicio de coincidencia 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 ofertas en tiempo real. Cuando se publica un anuncio, Google coloca una etiqueta de coincidencia que dirige al navegador del usuario para que cargue un píxel transparente de la URL de coincidencia de cookies del ofertante elegido. Esto permitirá que tanto Google como el ofertante propaguen una tabla de coincidencias con un usuario determinado. A continuación, se muestra un ejemplo simple de este flujo de trabajo.
Paso 1: Google coloca una etiqueta de coincidencia
Cuando se carga la página de un editor participante en el navegador del usuario y Google completa un espacio de anuncios en esa página, se puede colocar una etiqueta de coincidencia que solicite un píxel a un ofertante seleccionado de forma algorítmica. La etiqueta de coincidencia de píxeles que coloca Google combina la URL de coincidencia de cookies del ofertante con 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 un redireccionamiento a la URL del servicio de coincidencia de cookies de Google
Los ofertantes que reciben solicitudes de coincidencia de píxeles deben responder con un redireccionamiento al servicio de coincidencia de cookies de Google que tiene la siguiente estructura:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Ten en cuenta que la URL de redireccionamiento anterior es similar a la de la URL que se usa en la etiqueta de coincidencia para el flujo de trabajo de coincidencia de cookies iniciado por el ofertante.
En la coincidencia de Pixel, el parámetro google_cm se reemplaza por el parámetro google_push y su valor debe ser igual al valor que proporciona Google en la solicitud. De manera similar al flujo de trabajo que inicia 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 las operaciones adicionales solicitadas a través de los parámetros de consulta. Por último, Google responde con un píxel transparente de 1 × 1.
Diagrama del flujo de trabajo de la coincidencia de píxeles
En el siguiente diagrama, se ilustra este flujo de trabajo, en el que las solicitudes y las respuestas se representan con una flecha, y los elementos de datos que las acompañan se enumeran entre paréntesis.
Parámetros de solicitud de la etiqueta de concordancia de Google
| Parámetro | Descripción |
|---|---|
google_gid |
ID de usuario de Google En el caso de los usuarios que no provienen de un estado de EE.UU. con restricciones de privacidad, esto siempre se especificará en la etiqueta de concordancia de Google. |
google_cver |
Es la versión de la cookie. Esto siempre se especificará en la etiqueta de coincidencia de Google. |
google_push |
Indica que esta solicitud inicia el flujo de trabajo de coincidencia de píxeles. El valor se debe mostrar a través del parámetro correspondiente en la respuesta de redireccionamiento del ofertante. |
gdpr_consent |
Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, consulta la sección [Requisitos de consentimiento del usuario de la UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) a continuación o la sección **¿Cómo se pasará la cadena de TC?** en la [documentación del MTC V2.0 de IAB para compradores autorizados](//support.google.com/authorizedbuyers/answer/9789378). |
Parámetros de redireccionamiento de la coincidencia de píxeles del ofertante
| Parámetro | Descripción |
|---|---|
google_nid |
Es el ID de red (NID) de la cuenta de oferta. Este ID se puede recuperar a través del recurso Bidders. |
google_push |
Indica que este redireccionamiento completa el flujo de trabajo de coincidencia de píxeles. El valor de la etiqueta de coincidencia de Google correspondiente debe especificarse aquí. |
google_hm |
Contiene datos que el ofertante desea almacenar en una tabla de coincidencias alojada por 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. |
gdpr_consent |
Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más detalles, consulta [requisitos de consentimiento del usuario de la UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) a continuación o la sección **¿Cómo se pasará la cadena de TC?** en la [documentación del MTC v2.0 de IAB para compradores autorizados](//support.google.com/authorizedbuyers/answer/9789378). |
Iniciado por Google: Coincidencia unidireccional de píxeles
La coincidencia de píxeles unidireccional 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á completando una tabla de coincidencias alojada por Google. Esto se puede usar en casos en los que el ofertante no tiene permiso para 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 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 coincidencia de cookies del ofertante, incluida la cookie del ofertante en los encabezados HTTP.
Paso 3: Redirecciona al servicio de coincidencia de cookies de Google
El extremo de concordancia 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: El navegador del usuario se redirecciona al servicio de coincidencia 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.user.buyeruid para OpenRTB o BidRequest.hosted_match_data para el Protocolo de RTB de Google obsoleto. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencia alojados que especificaron.
Por último, Google muestra un píxel transparente de 1 × 1 al navegador del usuario.
Asistencia de la concordancia de cookies
Open Bidding permite que los intercambios usen flujos de trabajo de concordancia de cookies iniciados por ofertantes y iniciados por Google para hacer coincidir un ID de usuario de Google con su cookie. La Asistencia de coincidencia de cookies (CMA) es una función adicional para los intercambios que les permite crear tablas de coincidencia con sus propios ofertantes.
Cómo funciona la función de Asistencia de la concordancia de cookies
Cuando se coloca un anuncio, Google selecciona de forma algorítmica un mercado participante y coloca una etiqueta de Asistencia de coincidencia de cookies 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 coincidencia de cookies del intercambio recibe la solicitud, en la que 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, el servicio de coincidencia de cookies del mercado responde al navegador del usuario con un redireccionamiento a uno de los extremos de su oferta.
- El ofertante recibe la solicitud, junto con cualquier parámetro que especifique el intercambio para hacer coincidir el ID del usuario con su cookie.
Restricciones
Limitar la frecuencia de las solicitudes de coincidencias nuevas
Los ofertantes son responsables de limitar la cantidad de llamadas al servicio de coincidencia de cookies para los usuarios que tienen una entrada nueva en la tabla de coincidencias alojada por Google. Una entrada en la tabla de coincidencias alojadas puede considerarse vencida en 14 días, después de los cuales se puede actualizar.
Responde todas las solicitudes de coincidencia de píxeles
Se espera que los ofertantes que utilizan el flujo de trabajo de la Segmentación por píxeles respondan a todas las solicitudes entrantes de Segmentación por píxeles con una respuesta que incluya el parámetro google_push. Esto permite que Google supervise el uso para aplicar las políticas. Si el porcentaje de respuestas de un ofertante cae por debajo del 90%, Google reducirá la cantidad de solicitudes de Segmentación por píxeles que se envían a su cuenta.
Usa extremos HTTPS
Es obligatorio que los extremos que se usan en todos los flujos de trabajo de Cookie Matching usen HTTPS.
Cuando respondas a una solicitud de Pixel Match que te envió a través de 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 coincidencia de cookies que están sujetas a la Política de Consentimiento de Usuarios de la UE de Google deben indicar el consentimiento del usuario final. Estas solicitudes deben indicar que se obtuvo el consentimiento de una de las siguientes maneras:
- TCFv2: Esto incluye los parámetros
gdprygdpr_consent. Para obtener más información, consulta la documentación del MTC v2.0 de IAB para compradores autorizados. process_consent: Una declaración que indique que el ofertante obtuvo el consentimiento del usuario necesario.
Ejemplos
En los siguientes ejemplos, se muestra 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 sobre el que se actúa no es de un estado de EE.UU. con restricciones de privacidad.
Cómo completar una tabla de coincidencias alojada por el ofertante
Un ofertante puede usar el flujo de trabajo de la concordancia de cookies para completar su propia tabla de concordancia. Para ello, solo debe proporcionar los parámetros google_nid y google_cm en su etiqueta de concordancia. El aspecto podría ser el siguiente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Si la URL de concordancia de cookies del ofertante está configurada como https://ad.network.com/pixel?id=1 y la operación de coincidencia de cookies se realiza correctamente, el redireccionamiento que envía Google en respuesta a la etiqueta de coincidencia del ofertante podría verse de la siguiente manera:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Si la operación de coincidencia de cookies falla porque el usuario no tiene una cookie de Google, la respuesta sería la siguiente:
https://ad.network.com/pixel?id=1&google_error=3
El código de error depende de la causa subyacente del error. Para obtener más información sobre los posibles códigos de error del flujo de trabajo de coincidencia de cookies, consulta los parámetros de URL de redireccionamiento.
Cómo agregar a una lista de un solo usuario
El parámetro google_ula se puede especificar 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 el 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 sobre la invocación del Servicio de concordancia de cookies para obtener más detalles. La etiqueta de coincidencia correspondiente podría verse de la siguiente manera:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Para que se muestre una respuesta correcta, en la que la URL de coincidencia 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 parámetro google_error:
https://ad.network.com/pixel?google_error=3
Si hay un error específico relacionado con la adición del usuario a la lista,
recibirás google_ula en el redireccionamiento. A diferencia del parámetro de etiqueta de coincidencia correspondiente, este reemplaza la marca de tiempo por un código de estado para indicar que la operación se realizó correctamente. 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. Para ello, deben incluir varios parámetros google_ula en la etiqueta de concordancia. En la práctica, esto puede 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 la lista de usuarios con el ID 45678, pero falló para el ID 12345 de la lista de usuarios porque el ofertante no tenía permiso para acceder a ella.
Sigue los pasos del flujo de trabajo de la Segmentación por cookies y agrégala a la lista de usuarios
Para realizar la coincidencia 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 que especifica Google incluiría google_gid, google_cver y google_ula. Esto podría verse de la siguiente manera:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Almacenamiento de una coincidencia en una tabla de coincidencias alojada por Google
Si un ofertante desea almacenar sus datos de cookies en una tabla de coincidencias alojada por Google y no tiene la intención de almacenar coincidencias con el ID de usuario de Google en su propia tabla de coincidencias, su etiqueta de coincidencia debe incluir el parámetro google_hm, cuyo valor debe ser una cadena codificada en base64 segura para la Web. Para un usuario en el que los datos de cookies sin codificar del ofertante son Cookie number 1!, el valor codificado sería Q29va2llIG51bWJlciAxIQ==, que se usaría en una etiqueta de concordancia como la siguiente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Para que se muestre una respuesta correcta, en la que la URL de coincidencia de cookies del ofertante sea https://cookie-monster.com/pixel, la URL de redireccionamiento de Google sería la siguiente:
https://cookie-monster.com/pixel
El parámetro google_gid no está en el redireccionamiento porque la etiqueta de coincidencia no incluyó google_cm, y google_hm no se incluye en las respuestas correctas. En solicitudes de ofertas futuras para impresiones de este usuario, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.user.buyeruid para OpenRTB o BidRequest.hosted_match_data para el protocolo de RTB de Google obsoleto.
En cambio, si el ofertante usó una etiqueta de concordancia en la que el valor de google_hm no estaba codificado en base64, como chocolate_chunk!, la URL de redireccionamiento podría verse de la siguiente manera:
https://cookie-monster.com/pixel?google_hm=2
La URL de redireccionamiento anterior incluye un valor google_hm de 2, lo que sugiere que la operación falló porque no se pudo decodificar el valor.
Tablas de coincidencias del ofertante y alojadas por Google con listas de usuarios
Si un ofertante aloja su propia lista de usuarios 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 cookies del ofertante son Cookie number 1!, el valor codificado sería Q29va2llIG51bWJlciAxIQ==, lo que generaría una etiqueta de coincidencia como la siguiente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Para que la respuesta sea exitosa, cuando la URL de concordancia de cookies del ofertante sea 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 de usuario de Google especificado en google_gid con sus datos de cookies en su tabla de coincidencias. Además, puede determinar si se realizaron correctamente las operaciones de la tabla de coincidencias y la lista de usuarios alojadas en Google. 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 ofertas para impresiones del usuario. Del mismo modo, en estas solicitudes de oferta, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.user.buyeruid para OpenRTB o en BidRequest.hosted_match_data para el protocolo de RTB de Google obsoleto.