Concordancia de cookies

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

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 dominios aceptaran intercambiar estos datos, el modelo de seguridad de los navegadores de Internet impide que uno lea una cookie establecida por otro dominio.

En el contexto de la publicidad digital, Google identifica a los usuarios con cookies que pertenecen al dominio doubleclick.net, y los ofertantes que participan en las ofertas en tiempo real pueden tener su propio dominio en el que identifican 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 concordancia de cookies descrito 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 las listas de usuarios.

Tablas de coincidencias

Se puede usar una tabla de coincidencias para asignar un ID y otros datos de un dominio a otro. Los ofertantes pueden usar el servicio de concordancia de cookies para propagar sus propias tablas de coincidencias mediante la asignación de sus cookies para un usuario determinado al ID de usuario de Google del usuario, o 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, las mejoras en la latencia y el acceso a los datos coincidentes de los usuarios de ciertas regiones, se recomienda que permitas que Google aloje tu tabla de coincidencias. Esto te permite especificar una cadena codificada en base64 segura para la Web, que 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.buyeruid especificará 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 campo BidRequest.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. Se puede utilizar a fin de eliminar 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:

  • Cookie Matching Network ID (NID): Es un ID de cadena que identifica de forma única una cuenta de oferta 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 Cookie Matching.
  • 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 pueden publicar junto con los anuncios o colocarse en propiedades web fuera de los anuncios.
  • URL del informe de coincidencia de cookies (opcional): En el flujo de trabajo de coincidencia de cookies unidireccional, esta es una URL opcional que se puede proporcionar para especificar un extremo que recibirá detalles del error en caso de que falle la coincidencia de cookies a través de un redireccionamiento HTTP 302. De forma predeterminada, las respuestas solo se enviarán a esta URL si hubo un error 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. Esto está destinado a evitar que las solicitudes de la CMA sobrecarguen los servidores del intercambio con solicitudes.

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 admitidas y sus valores expandidos son los siguientes:

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

Ejemplo de macro

Un ofertante tiene una integración de 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 puede configurar su URL de concordancia de cookies de la siguiente manera:

https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%

Más adelante, cuando Google envíe una solicitud de coincidencia a este ofertante, se expandirá a un resultado similar al siguiente:

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

Actualmente, el Servicio de Concordancia de Cookies de Google admite tres flujos de trabajo para diferentes casos de uso que se describen a continuación.

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 concordancia

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

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

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

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

La etiqueta de coincidencia hará que el servicio de coincidencia de cookies de Google reciba una solicitud del navegador del usuario, que emitirá un redireccionamiento HTTP 302 a la URL de coincidencia de cookies del ofertante. El redireccionamiento incluirá parámetros de consulta que especifican el ID de usuario de Google y su número de versión en la URL, y el ofertante también recibirá su cookie incluida en los encabezados de la solicitud. En la práctica, para una URL 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 cadena codificada en base64 segura para la Web sin padding. Para los ofertantes que eligen alojar una tabla de coincidencias, se recomienda que almacenen la cadena exacta que muestra el Servicio de concordancia de cookies. En las solicitudes de oferta posteriores, esto corresponderá a los valores especificados a través de BidRequest.user.id en OpenRTB, o bien 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án su cookie en los encabezados HTTP. Si la operación se realizó correctamente, un ofertante que aloja su propia tabla de coincidencias podría hacer coincidir su cookie con el ID de usuario de Google incluido en la respuesta. Se recomienda que los ofertantes almacenen la cadena exacta que muestra el servicio de concordancia de cookies.

Si la operación no se realizó 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 establecer la coincidencia para ese usuario nuevamente. Para ello, coloca una nueva etiqueta de coincidencia.

El ofertante siempre debe responder publicando una imagen de píxeles invisibles de 1 x 1 o, como alternativa, mostrar una respuesta HTTP 204 Sin contenido.

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

Parámetros de URL de la etiqueta de coincidencia

Parámetro Descripción
google_nid Es el ID de red (NID) de la cuenta de oferta. 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. Se ignora el valor del parámetro y se puede omitir.
google_hm

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

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

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]:
  • userlistid: Es un ID numérico de lista de usuarios único.
  • timestamp: Una marca de tiempo opcional en formato POSIX que indica cuándo se agregó el usuario a la lista de usuarios

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

gdpr Indica que la solicitud está sujeta a las restricciones del RGPD sobre el uso de datos. Para obtener más detalles, consulta los Requisitos de consentimiento de usuarios de la UE 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=1

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 (gdpr_consent), se ignora este parámetro.

Ejemplo: process_consent=T

Además de los parámetros anteriores, los ofertantes pueden especificar los suyos, que se adjuntará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 coincidencia que incluye los 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 google_:

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

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

  • 1: El usuario tiene una cookie de Google, pero inhabilitó cualquier seguimiento con esta cookie.
  • 2: No se especificaron operaciones válidas. Por ejemplo, se recibió una solicitud de no operación.
  • 3: El usuario no tiene una cookie de Google. Google no establecerá la cookie a través del servicio de coincidencia de cookies.
  • 4: Se especificaron operaciones en conflicto. No puedes especificar las marcas google_push y google_cm en la misma solicitud, ya que tienen propósitos en conflicto.
  • 5: Se pasó un parámetro google_push no válido en un redireccionamiento a un servidor de Google como parte de una solicitud de coincidencia de píxeles bidireccional. El redireccionamiento debe establecer google_push en el mismo valor que se te pasó en la solicitud de píxel inicial.
  • 6: Se proporcionó un NID no válido en la etiqueta de coincidencia.
  • 7: Se detectó una cookie no válida.
  • 8: Obsoleto. No se encontró ninguna cookie.
  • 9: No se encontró ninguna cookie, se intenta establecer una cookie de prueba.
  • 10: Se usó el parámetro google_redir sin especificar google_hm o se usó además de google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que la tabla de coincidencias esté alojada en Google. Como resultado, esta respuesta no contiene un ID de usuario de Google. Actualmente, esta función está habilitada solo para un pequeño porcentaje del tráfico, pero se espera que se habilite por completo en junio de 2020.
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:

  • 1: Prohibido: El cliente aún no está en la lista de entidades permitidas para escribir entradas de tablas de coincidencias alojadas.
  • 2: Error de decodificación: No se pudo decodificar el valor del parámetro.
  • 3: La carga útil es demasiado larga: el valor del parámetro se decodifica en más de 24 bytes de datos.
  • 4: Error interno: Se produjo un error interno al almacenar los datos.
  • 5: Limitada: Esta operación de escritura no se procesó debido a la regulación.
google_ula

Estado de la operación de adición de la lista de usuarios, repetida si se especificaron varios google_ula en la solicitud. El formato es el siguiente:
userlistid,status code

Ejemplo: google_ula=1234567890,0

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

  • 0: No hay error. Se agregó al usuario a la lista de usuarios.
  • 2: Se denegó el permiso. No tienes permiso para agregar usuarios a la lista de usuarios determinada.
  • 5: ID de lista de usuarios incorrecto. El ID de la lista de usuarios proporcionado no es válido.
  • 6: Es el ID del atributo cerrado. El ID de la lista de usuarios proporcionado está cerrado.
  • 10: Error interno. El servicio de concordancia de cookies detectó un error interno. Puedes intentar volver a establecer la coincidencia con el usuario.

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 navega por un sitio

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

Esto es lo que ocurre:

  1. ExampleNews.com renderiza y llama a anuncios de Google (Ad Manager).
  2. 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.
  3. La aplicación del ofertante de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta de oferta.
  4. Google recibe respuestas de ofertas de los ofertantes, incluida la respuesta de FinestDSP que especifica un anuncio con una etiqueta de coincidencia (píxel).
  5. FinestDSP gana la subasta. Google publica el anuncio y la etiqueta de coincidencia de FinestDSP para Cristina.
  6. La etiqueta de coincidencia llama al servicio de Cookie Match de Google y especifica los parámetros google_nid y google_cm.
  7. El servicio de coincidencia de cookies lee la cookie de Google de Jane y le envía al navegador de Jane un redireccionamiento a la URL de coincidencia de cookies de FinestDSP con los parámetros google_gid y google_cver establecidos.
  8. El navegador de Jane carga el redireccionamiento a la URL de coincidencia de cookies de FinestDSP.
  9. El extremo de coincidencia de cookies de FinestDSP procesa la solicitud de redireccionamiento, que incluye los parámetros de URL establecidos por Google, y su cookie para Jane en los encabezados HTTP. FinestDSP ahora puede almacenar la asignación de su cookie a google_gid en su tabla de coincidencias.
  10. FinestDSP responde al redireccionamiento con un píxel invisible de 1 × 1.
Situación 2: Usuario con asignación existente

Una semana después de la Situación 1, Jane vuelve a visitar ExampleNews.com. Ahora que Jane tiene cookies de ofertante y de Ad Manager en su máquina, a continuación se muestra cómo funciona la coincidencia.

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

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 permitido alojar los IDs de usuario de Google en su propia tabla de coincidencias. Para usar este flujo, los ofertantes deben permitir que Google aloje la tabla de coincidencias, ya no pueden especificar google_cm en las solicitudes al servicio de concordancia de cookies de Google y, 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 oferta para estos usuarios excluirán el ID de usuario de Google, pero incluirán datos de coincidencia alojados. En los pasos a continuación, se resume un ejemplo simple del flujo de trabajo revisado.

Para iniciar este flujo, un ofertante debe colocar una etiqueta de coincidencia de modo que se renderice en el navegador del usuario. A diferencia del flujo de trabajo para los usuarios que no provienen de un estado de EE.UU. con restricciones de privacidad, la etiqueta de coincidencia debe dirigir el navegador del usuario a tu URL de coincidencia 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.

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 verse de la siguiente manera:

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

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

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

Si la operación de concordancia de cookies se realiza correctamente, o si no se especificó ninguna URL de informe de concordancia de cookies para la cuenta del ofertante, Google publicará un píxel transparente de 1 x 1 de forma predeterminada, y el flujo de trabajo finalizará aquí. Las impresiones de este usuario en solicitudes de ofertas 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.

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 cookies que coinciden con la URL 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" />

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.

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á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. 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 Concordancia de Cookies de Google que no debe establecer una cookie para el usuario si no hay una presente. Se ignora el valor del parámetro y se puede omitir.
google_hm

Contiene 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 para errores y 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]:
  • userlistid: Es un ID numérico de lista de usuarios único.
  • timestamp: Una marca de tiempo opcional en formato POSIX que indica cuándo se agregó el usuario a la lista de usuarios

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

gdpr Indica que la solicitud está sujeta a las restricciones del RGPD sobre el uso de datos. Para obtener más detalles, consulta los requisitos de consentimiento de 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=1

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 (gdpr_consent), se ignora este parámetro.

Ejemplo: process_consent=T

Parámetro Descripción
google_error

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

  • 1: El usuario tiene una cookie de Google, pero inhabilitó cualquier seguimiento con esta cookie.
  • 2: No se especificaron operaciones válidas. Por ejemplo, se recibió una solicitud de no operación.
  • 3: El usuario no tiene una cookie de Google. Google no establecerá la cookie a través del servicio de coincidencia de cookies.
  • 4: Se especificaron operaciones en conflicto. No puedes especificar las marcas google_push y google_cm en la misma solicitud, ya que tienen propósitos en conflicto.
  • 5: Se pasó un parámetro google_push no válido en un redireccionamiento a un servidor de Google como parte de una solicitud de coincidencia de píxeles bidireccional. Tu redireccionamiento debe establecer google_push en el mismo valor que se te pasó en la solicitud de píxeles inicial.
  • 6: Se proporcionó un NID no válido en la etiqueta de coincidencia.
  • 7: Se detectó una cookie no válida.
  • 8: Obsoleto. No se encontró ninguna cookie.
  • 9: No se encontró ninguna cookie, se intenta establecer una cookie de prueba.
  • 10: Se usó el parámetro google_redir sin especificar google_hm o se usó además de google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que la tabla de coincidencias esté alojada en Google. Como resultado, esta respuesta no contiene un ID de usuario de Google. Actualmente, esta función está habilitada solo para un pequeño porcentaje del tráfico, pero se espera que se habilite por completo en junio de 2020.

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 Google y el ofertante propaguen una tabla de coincidencias con un usuario determinado. A continuación, se muestra un ejemplo simple de este flujo de trabajo.

Paso 1: Google coloca una etiqueta de coincidencia

Cuando 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 concordancia de píxeles que coloca Google combina la URL de concordancia de cookies del ofertante con parámetros adicionales que este puede usar para propagar su tabla de coincidencias. Para una URL de coincidencia de cookies especificada como https://ad.network.com/pixel, se estructura de la siguiente manera:

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

Los 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 píxeles, el parámetro google_cm se reemplaza por el parámetro google_push, y su valor debe ser igual al 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 coincidencia 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 concordancia 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 la coincidencia de píxeles. Aquí se debe especificar el valor de la etiqueta de concordancia de Google correspondiente.
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]:
  • userlistid: Es un ID numérico de lista de usuarios único.
  • timestamp: Una marca de tiempo opcional en formato POSIX que indica cuándo se agregó el usuario a la lista de usuarios

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

gdpr_consent Es una cadena de TC que representa el consentimiento del usuario final. Para obtener más información, consulta los [requisitos de consentimiento de usuarios de la UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) 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 Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378).

Iniciada por Google: Coincidencia de píxeles unidireccional

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 los casos en 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 concordancia para un ofertante seleccionado de forma algorítmica. La etiqueta de coincidencia incluye el parámetro google_push. Por ejemplo:

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

Paso 2: El navegador del usuario solicita el píxel de la URL de coincidencia de Cooking 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.

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 verse de la siguiente manera:

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

Google recibirá un redireccionamiento que contiene los parámetros que especificaste, además de la cookie de Google en los encabezados HTTP. Si la operación se realizó correctamente, las impresiones 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 x 1 al navegador del usuario.

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

  1. Cuando se 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"/>
  2. La etiqueta de coincidencia de la CMA de Google hace que la URL de coincidencia de cookies del mercado reciba una solicitud de píxeles.

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

Restricciones

Limita 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 más de una vez cada 2 minutos, se limitará la cantidad de solicitudes de coincidencia enviadas a tu cuenta.

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 recopiló el consentimiento de una de las siguientes maneras:

Ejemplos

En los siguientes ejemplos, se muestra cómo usar el servicio de coincidencia 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.

Propagar 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 coincidencia de cookies del ofertante está configurada en https://ad.network.com/pixel?id=1 y la operación de coincidencia de cookies se realiza correctamente, el redireccionamiento que Google envía en respuesta a la etiqueta de coincidencia del ofertante podría 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 para invocar el servicio de coincidencia de cookies y obtener más detalles. La etiqueta de coincidencia correspondiente podría verse de la siguiente manera:

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

Para que 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 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 falla porque la cuenta del ofertante no tiene acceso a la lista de usuarios especificada, la URL de redireccionamiento será la siguiente:

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

Cómo 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 de cada lista de usuarios se informa de manera similar a través de parámetros google_ula distintos en el redireccionamiento:

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

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

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 incluye 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 futuras solicitudes de oferta 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.

Si el ofertante usó una etiqueta de coincidencia en la que el valor de google_hm no estaba codificado en base64, como chocolate_chunk!, la URL de redireccionamiento podría tener el siguiente aspecto:

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 obtener una respuesta correcta, en la que la URL de coincidencia de cookies del ofertante es https://cookie-monster.com/pixel, la URL de redireccionamiento de Google se vería de la siguiente manera:

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

Cuando recibe el redireccionamiento, el 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, pueden determinar que las operaciones de la lista de usuarios y la tabla de coincidencias alojadas por Google se realizaron correctamente. 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 BidRequest.hosted_match_data para el protocolo de RTB de Google obsoleto.