Concordancia de cookies

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La concordancia de cookies es una función que le permite hacer coincidir su cookie (por ejemplo, un ID para un usuario que navegó por su sitio web) con un ID de usuario de Google específico del ofertante correspondiente y crear listas de usuarios que pueden ayudarlo a tomar decisiones de ofertas más eficaces. En esta guía, se describen los conceptos que se usan en la Concordancia de cookies, así como los diferentes flujos de trabajo de Coincidencia de cookies y cualquier variación que puedan tener para ciertos casos prácticos.

Conceptos

Por lo general, los propietarios del dominio establecen el contenido de las cookies para los usuarios que exploran su sitio, las cuales se usan para identificar a los usuarios dentro de ese dominio. Incluso si dos propietarios de dominio aceptaran el intercambio de estos datos, el modelo de seguridad de los navegadores de Internet limita la lectura de una cookie establecida por otro dominio.

En el contexto de la publicidad digital, Google identifica a los usuarios con cookies que pertenecen al dominio doubleclick.net, y los ofertantes que participan en las ofertas en tiempo real pueden tener su propio dominio en el que identifican a un conjunto de usuarios a quienes les gustaría mostrar anuncios. La concordancia de cookies permite al ofertante hacer coincidir sus cookies con las de Google, de modo que pueda determinar si una impresión enviada en una solicitud de oferta está asociada con uno de los usuarios a los que se orienta, 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 que se describe en esta guía facilita la creación y el mantenimiento de la asociación entre la cookie del ofertante y el ID del 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 bien otros datos, de un dominio a otro. Los ofertantes pueden usar el servicio de concordancia de cookies a fin de propagar sus propias tablas de coincidencias mediante la asignación de su cookie 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 ofertante de un ofertante pueda acceder a los datos de la cookie del usuario al que se le muestra la impresión.

Tablas de coincidencias alojadas en Google

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

  • Ofertas en tiempo real: En las solicitudes de ofertas posteriores para las impresiones asociadas con el usuario, Google te enviará los datos de la coincidencia alojada que coincidió con su ID de usuario de Google. Si tu extremo de ofertas está configurado para usar el protocolo RTB de Google, lo recibirás como bytes decodificados a través del campo BidRequest.hosted_match_data. En la implementación de OpenRTB de Google, BidRequest.user.buyeruid mostrará estos datos como una string codificada en base64 segura para la Web.

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

  • Orientación previa: Puedes configurar la orientación previa para que solo recibas solicitudes de ofertas que contengan datos de coincidencias alojados. Se puede usar para eliminar las impresiones menos relevantes para los usuarios fuera del espacio de cookies.

Listas de usuarios

Las listas de usuarios se pueden crear y administrar con la API de Ofertas en tiempo real. Una vez creadas, puedes propagar estas listas con los flujos de trabajo de Coincidencia de cookies que se describen a continuación o mediante el Servicio de carga masiva.

Cómo comenzar

Para comenzar a usar la concordancia de cookies, debes comunicarte con tu administrador técnico de cuentas, que puede habilitar flujos de trabajo específicos y ayudarte a configurar lo siguiente:

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

En cualquiera de los flujos de trabajo de coincidencia de cookies admitidos, 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 parámetros pueden colocar macros en su URL de concordancia de cookies para garantizar su posición.

Macros compatibles

De manera opcional, los ofertantes pueden configurar su URL de concordancia de cookies para incluir una o más macros 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_SINCRONIZAR &google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_SINCRONIZAR &cver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR. ERROR_ID
GOOGLE_ERROR_PAIR &google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_SINCRONIZAR &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 coincidencia de cookies con un extremo alojado en https://user.bidder.com.cookies, y su implementación requiere parámetros predeterminados definidos por el ofertante, además de parámetros de coincidencia de píxeles en el siguiente orden: google_push, google_gid, google_cver y google_error. Para ello, el ofertante debe configurar su URL de coincidencia de cookies en:

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

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

El servicio de concordancia de cookies de Google actualmente admite tres flujos de trabajo para diferentes casos de uso que se describen a continuación.

La concordancia bidireccional de cookies se refiere a un flujo de trabajo iniciado por el ofertante, en el que colocan una etiqueta de coincidencia en el navegador del usuario que la dirige a Google. 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 procese en el navegador del usuario. Una etiqueta de coincidencia 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 coincidencia para cumplir con diferentes casos de uso. Para obtener más información sobre estos parámetros, consulta Parámetros de URL de etiquetas de coincidencia.

Paso 2: Google responde con el redireccionamiento, incluidos los datos de coincidencia

La etiqueta de coincidencia hará que el servicio de concordancia de cookies de Google reciba una solicitud del navegador del usuario, que emitirá un redireccionamiento HTTP 302 a la URL de coincidencia de cookies del ofertante. El redireccionamiento incluirá parámetros de búsqueda que especifican el ID del usuario de Google y su número de versión en la URL, y el ofertante también recibirá su cookie incluida en los encabezados de la solicitud. En la práctica, para una URL de coincidencia de cookies especificada como https://ad.network.com/pixel, la URL de redireccionamiento para la etiqueta de coincidencia simple como se ve 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 sin usar para la Web. Para los ofertantes que eligen alojar una tabla de coincidencias, se recomienda que almacenen la string exacta que muestra el servicio de concordancia de cookies. En las solicitudes de ofertas posteriores, esto corresponderá a los valores especificados a través de BidRequest.google_user_id en el protocolo RTB de Google o BidRequest.user.id en la implementación de OpenRTB de Google.

La versión especificada en google_cver indica el número de versión numérico del ID de usuario de Google. El ID de usuario de Google de un usuario determinado cambiará con poca frecuencia, después de lo cual se incrementará.

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 un píxel

El ofertante recibe un redireccionamiento a su URL de coincidencia de cookies, incluidos los parámetros que especificó en el primer paso y los que Google proporcionó en el segundo. Además, 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 string 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. Puedes obtener más información sobre los valores de error posibles aquí. Si recibes un error, puedes intentar establecer una coincidencia para ese usuario nuevamente si colocas una etiqueta de coincidencia nueva.

El ofertante siempre debe responder con una imagen de píxel invisible de 1 x 1 o, como alternativa, mostrar una respuesta Sin contenido HTTP 204.

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 los acompañan se enumeran entre paréntesis.

Parámetros de URL de etiqueta de coincidencia

Parámetro Descripción
google_nid ID de red (NID) de la cuenta del ofertante Este ID se puede obtener a través del campo cookieMatchingNid de las cuentas de la API de REST del comprador.
google_cm Indica al Servicio de concordancia de cookies de Google que debe realizar la concordancia de cookies. El valor del parámetro se ignora y puede omitirse.
google_sc Este parámetro es obsoleto. Establece la cookie de Google para el usuario si no está presente. El valor del parámetro se ignora y puede omitirse. Omitir el parámetro genera un error si no existe una cookie.
google_no_sc Este parámetro es obsoleto. Esto indica al Servicio de concordancia de cookies de Google que no debe establecer una cookie para el usuario si no está presente. El valor del parámetro se ignora y puede omitirse.
google_hm

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 (relleno opcional). Los datos sin procesar deben ser de 40 bytes o menos. Por ejemplo, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Es una string codificada en URL que un ofertante puede especificar si desea indicarle a Google que envíe el redireccionamiento HTTP 302 a la URL codificada para esta etiqueta de coincidencia. Esto permite que Google se ubique al principio de una llamada en cadena con los socios. Esto generará un error si se especifica sin google_hm o con google_cm.
google_ula Es una string 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 de lista de usuarios numérico único.
  • timestamp: Una marca de tiempo opcional en formato POSIX, que indica cuándo se agregó al usuario a la lista de usuarios

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

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 tengan el nombre google_, ya que Google los reserva para su desarrollo futuro y no se garantiza el orden de los parámetros. Una etiqueta de coincidencia que incluye parámetros definidos por el ofertante puede tener el siguiente aspecto:

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

Parámetros de URL de redireccionamiento

La URL de redireccionamiento se crea a partir de la URL base de concordancia de cookies configurada para la cuenta de un ofertante, incluidos google_ y los parámetros definidos por el ofertante según los especificados en la etiqueta de coincidencia. Se definen los siguientes parámetros de respuesta google_:

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

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

  • 1: El usuario tiene una cookie de Google, pero inhabilitó el seguimiento que la utiliza.
  • 2: No se especificaron operaciones válidas. Por ejemplo, se recibió una solicitud no operativa.
  • 3: El usuario no tiene una cookie de Google. Google no establecerá la cookie a través del servicio de concordancia de cookies.
  • 4: operaciones especificadas en conflicto No puedes especificar las marcas google_push y google_cm en la misma solicitud, ya que tienen fines contradictorios.
  • 5: Se pasó un parámetro google_push no válido en un redireccionamiento a un servidor de Google como parte de una solicitud de coincidencia de Pixel bidireccional. Tu redireccionamiento debe establecer google_push con 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 intentó establecer una cookie de prueba.
  • 10: El parámetro google_redir se usó sin especificar google_hm o se usó junto con google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que Google aloje la tabla de coincidencias. Como resultado, esta respuesta no contiene un ID de usuario de Google. Actualmente, esta opción está habilitada solo para un pequeño porcentaje de tráfico, pero se prevé que esté completamente habilitada en junio de 2020.
google_hm

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

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

Estado de la operación de agregar lista de usuarios, que se repite si se especificaron google_ula en la solicitud. El formato es:
userlistid,status code

Ej.: google_ula=1234567890,0

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

  • 0: no hay error. El usuario se agregó a la lista de usuarios.
  • 2: Permiso denegado. No tienes permiso para agregar usuarios a la lista de usuarios especificada.
  • 5: ID de lista de usuarios erróneo. El ID de la lista de usuarios que se proporcionó no es válido.
  • 6: ID de atributo cerrado. El ID de lista de usuarios proporcionado está cerrado.
  • 10: Error interno. El servicio de concordancia de cookies detectó un error interno. Puedes volver a establecer la coincidencia con el usuario.

En las siguientes situaciones, se describe cómo podría ser la concordancia 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, visitan la página principal de ExampleNews.com.

Esto es lo que ocurre:

  1. ExampleNews.com procesa y llama anuncios de Google (Ad Manager).
  2. Debido a que el bloque de anuncios es apto para la asignación dinámica, Google envía solicitudes de ofertas a FinestDSP y a otros ofertantes a través del servicio de ofertas en tiempo real.
  3. La aplicación ofertante de FinestDSP recibe y procesa la solicitud de oferta, y envía su respuesta a la oferta.
  4. Google recibe respuestas a la oferta 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 la etiqueta de coincidencia y el anuncio de FinestDSP para Jane.
  6. La etiqueta de coincidencia llama al servicio de concordancia de cookies de Google y especifica los parámetros google_nid y google_cm.
  7. El servicio de concordancia de cookies lee la cookie de Google de Juan y envía al navegador de Juan un redireccionamiento a la URL de coincidencia de cookies de FinestDSP con los parámetros google_user_id 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 que establece Google, y su cookie para Jane en los encabezados HTTP. Ahora, FinestDSP puede almacenar la asignación de su cookie en google_user_id en su tabla de coincidencias.
  10. 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 vuelve a visitar ExampleNews.com. Ahora que Jane tiene cookies de ofertantes y de Ad Manager en su máquina, así funciona la coincidencia.

  1. Se procesa la página web, lo que hace que Google (Ad Manager) solicite anuncios que se renderizarán en ella.
  2. Durante la subasta de anuncios, Google envía una solicitud de oferta a los ofertantes aplicables, incluido FinestDSP.
  3. FinestDSP recibe la solicitud de oferta, incluidas señales como google_user_id.
  4. FinestDSP busca la google_user_id en su tabla de coincidencias y encuentra la cookie asociada con Jane que se creó una semana antes (en la situación 1).
  5. Según la información asociada con la cookie, la lógica de oferta de FinestDSP realiza una oferta para la impresión y gana la subasta.
  6. Jane podría ver un anuncio adaptado a sus intereses, según la información que tenga FinestDSP.

La coincidencia unidireccional de cookies es similar al flujo de trabajo bidireccional, excepto que se modifica de manera que solo Google aloje y propague una tabla de coincidencia. Esto se puede usar en casos en los que el ofertante no puede alojar ID de usuario de Google en su propia tabla de coincidencias. Para usar este flujo, los ofertantes deben permitir que Google aloje la tabla de coincidencia, 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 agregarlos a las listas de usuarios mediante sus propios datos de cookies. Del mismo modo, las solicitudes de oferta de estos usuarios excluirán el ID de usuario de Google, pero incluirán datos de coincidencias 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 procese en el navegador del usuario. A diferencia del flujo de trabajo para usuarios fuera de California, 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 a la URL de coincidencia de cookies del ofertante. Esta solicitud contendrá su cookie en el encabezado HTTP, que debe extraerse para el siguiente paso.

El extremo de coincidencia de cookies del ofertante debe redireccionar al servicio de concordancia de cookies de Google, incluido el parámetro google_hm propagado con sus datos de cookies codificados en Base64 seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto:

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

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

Paso 4: Google publica un píxel en caso de redireccionamiento correcto o de error si se especifica la URL del informe

Si la operación de coincidencia de cookies se realiza correctamente o si no se especificó ninguna URL del Informe de coincidencias de cookies para la cuenta del ofertante, Google entregará un píxel transparente de 1 x 1 de forma predeterminada y el flujo de trabajo terminará aquí. Las impresiones de este usuario en solicitudes de ofertas posteriores incluirán los datos de coincidencias alojados del ofertante en BidRequest.hosted_match_data para el Protocolo de Google o en BidRequest.user.buyeruid para la implementación de OpenRTB de Google. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencias 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 especificado en el parámetro google_error. Si la URL del Informe de coincidencias 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" />

El navegador del usuario lo redireccionará a la URL del Informe de coincidencias de cookies del ofertante, incluido el motivo del error (si lo hubiera) que especificó Google en el parámetro google_error. Para obtener más información sobre cómo interpretar el código de error, consulta la descripción del parámetro.

Paso 6: el ofertante publica 1 x 1 píxel transparente.

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

El flujo de trabajo predeterminado para los usuarios en California 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 los acompañan se enumeran entre paréntesis.

Parámetro Descripción
google_nid ID de red (NID) de la cuenta del ofertante Este ID se puede obtener a través del campo cookieMatchingNid de las cuentas de la API de REST del comprador.
google_sc Este parámetro es obsoleto. Establece la cookie de Google para el usuario si no está presente. El valor del parámetro se ignora y puede omitirse. Omitir el parámetro genera un error si no existe una cookie.
google_no_sc Este parámetro es obsoleto. Esto indica al Servicio de concordancia de cookies de Google que no debe establecer una cookie para el usuario si no está presente. El valor del parámetro se ignora y puede omitirse.
google_hm

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

google_redir Una URL codificada que quieres que Google envíe un redireccionamiento HTTP 302. La URL especificada recibirá redireccionamientos con el parámetro google_error para los errores y las operaciones correctas.
google_ula Es una string 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 de lista de usuarios numérico único.
  • timestamp: Una marca de tiempo opcional en formato POSIX, que indica cuándo se agregó al usuario a la lista de usuarios

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

Parámetro Descripción
google_error

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

  • 1: El usuario tiene una cookie de Google, pero inhabilitó el seguimiento que la utiliza.
  • 2: No se especificaron operaciones válidas. Por ejemplo, se recibió una solicitud no operativa.
  • 3: El usuario no tiene una cookie de Google. Google no establecerá la cookie a través del servicio de concordancia de cookies.
  • 4: operaciones especificadas en conflicto No puedes especificar las marcas google_push y google_cm en la misma solicitud, ya que tienen fines contradictorios.
  • 5: Se pasó un parámetro google_push no válido en un redireccionamiento a un servidor de Google como parte de una solicitud de coincidencia de Pixel bidireccional. Tu redireccionamiento debe establecer google_push con 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 intentó establecer una cookie de prueba.
  • 10: El parámetro google_redir se usó sin especificar google_hm o se usó junto con google_cm.
  • 15: La solicitud proviene de una región en la que Google requiere que Google aloje la tabla de coincidencias. Como resultado, esta respuesta no contiene un ID de usuario de Google. Actualmente, esta opción está habilitada solo para un pequeño porcentaje de tráfico, pero se prevé que esté completamente habilitada en junio de 2020.

Iniciado por Google: coincidencia de píxeles bidireccional

La coincidencia bidireccional de píxeles es un flujo de trabajo para el servicio de concordancia de cookies de Google, en el que Google intenta hacer coincidir un ID de usuario de Google con un ofertante seleccionado de manera algorítmica que no sea el ganador de la subasta en tiempo real. Cuando se coloca un anuncio, Google coloca una etiqueta de coincidencia que dirige al navegador del usuario para cargar 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 llena un espacio publicitario en esa página, se puede colocar una etiqueta de coincidencia que solicita un píxel a un ofertante seleccionado a través de algoritmos. La etiqueta de coincidencia de píxeles que coloca Google combina la URL de coincidencia de cookies del ofertante con los parámetros adicionales que el ofertante 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 concordancia de cookies de Google que se estructura de la siguiente manera:

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

Ten en cuenta que la URL de redireccionamiento anterior es similar a la URL que se usa en la etiqueta de coincidencia 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 iniciado por el ofertante, se pueden especificar parámetros adicionales para entregar casos prácticos adicionales.

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

Google registra que se creó una coincidencia para el usuario y controla cualquier operación adicional que se solicite mediante los parámetros de búsqueda. Por último, Google responde con un píxel transparente de 1 x 1.

Diagrama de flujo de trabajo de Pixel Matching

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 los acompañan se enumeran entre paréntesis.

Parámetros de solicitud de etiqueta de coincidencia de Google

Parámetro Descripción
google_gid ID de usuario de Google. Para los usuarios fuera de California, esto siempre se especificará en la etiqueta de coincidencia de Google.
google_cver La versión de la cookie. Esto siempre se especifica en la etiqueta de coincidencia de Google.
google_push Indica que esta solicitud está iniciando el flujo de trabajo de coincidencia de Pixel. El valor se debe mostrar a través del parámetro correspondiente en la respuesta de redireccionamiento del ofertante.

Parámetros de redireccionamiento de Pixel Matching del ofertante

Parámetro Descripción
google_nid ID de red (NID) de la cuenta del ofertante Este ID se puede obtener a través del campo cookieMatchingNid de las cuentas de la API de REST del comprador.
google_push Indica que este redireccionamiento está completando el flujo de trabajo de coincidencia del Pixel. Aquí se debe especificar el valor de la etiqueta de coincidencia de Google correspondiente.
google_hm

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

google_ula Es una string 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 de lista de usuarios numérico único.
  • timestamp: Una marca de tiempo opcional en formato POSIX, que indica cuándo se agregó al usuario a la lista de usuarios

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

Iniciado por Google: Coincidencia unidireccional de píxeles

La coincidencia unidireccional de píxeles difiere del flujo de trabajo bidireccional en el que la etiqueta de coincidencia de Google no incluye un parámetro que especifique el ID de usuario de Google, pero continuará propagando una tabla de coincidencia alojada en Google. Esto se puede usar en casos en los que el ofertante no puede alojar ID de usuario de Google en su propia tabla de coincidencias. En los pasos a continuación, 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 a través de algoritmos. La etiqueta de coincidencia incluye el parámetro google_push. Por ejemplo:

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

Paso 2: el navegador del usuario solicita el píxel de la URL de concordancia de la cocina del ofertante

El navegador del usuario solicita un píxel a la URL de coincidencia de cookies del ofertante, incluida la cookie del ofertante en los encabezados HTTP.

El extremo de coincidencia de cookies del ofertante debe redireccionar al servicio de concordancia de cookies de Google, incluido el parámetro google_hm propagado con sus datos de cookies codificados en Base64 seguros para la Web. La URL de redireccionamiento podría tener el siguiente aspecto:

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

Google recibirá un redireccionamiento que contenga 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 ofertas posteriores incluirán los datos de coincidencias alojados del ofertante en BidRequest.hosted_match_data para el protocolo de Google o BidRequest.user.buyeruid para la implementación de OpenRTB de Google. Los ofertantes también pueden propagar listas de usuarios con los datos de coincidencia alojados que especificaron.

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

Open Bidding permite que los socios de intercambio 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. Cookie Match Assist (CMA) es una función adicional para los socios de intercambio que les permite compilar tablas de coincidencias con sus propios ofertantes.

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

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
  2. La etiqueta de coincidencia de CMA de Google hace que la URL de coincidencia de cookies de Ad Exchange reciba una solicitud de píxel.

  3. El extremo de coincidencia de cookies de Ad Exchange 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 diagrama que se muestra a continuación, el servicio de concordancia de cookies de Ad Exchange responde al navegador del usuario con un redireccionamiento a uno de los extremos del ofertante.
  4. El ofertante recibe la solicitud, junto con los parámetros especificados por 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 concordancia de cookies para los usuarios que tienen una entrada nueva en la tabla de coincidencias alojada en Google. Una entrada en la tabla de coincidencias alojada puede considerarse vencida en 14 días, después de la cual se puede actualizar.

Cómo responder a todas las solicitudes de coincidencia de píxeles

Se espera que los ofertantes que usan el flujo de trabajo de Pixel Matching respondan a todas las solicitudes entrantes de Pixel Match con una respuesta que incluya el parámetro google_push. Esto permite que Google aplique políticas mediante la supervisión del uso. Si la tasa de respuesta de un ofertante cae por debajo del 90%, Google limitará la cantidad de solicitudes de Pixel Match enviadas a su cuenta.

Usa extremos HTTPS

Es obligatorio que los extremos que se usan en todos los flujos de trabajo de Coincidencia de cookies usen HTTPS.

Cuando respondas a una solicitud de coincidencia de Pixel que se 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 coincidencias enviadas a tu cuenta.

Ejemplos

Los siguientes ejemplos ilustran cómo usar el servicio de concordancia de cookies para lograr objetivos específicos. Ten en cuenta que, a menos que se indique lo contrario, se supone que el usuario que actúa es ajeno a California.

Propagar una tabla de coincidencias alojada por el ofertante

Un ofertante puede usar el flujo de trabajo de concordancia de cookies para propagar su propia tabla de coincidencias si proporciona solo los parámetros google_nid y google_cm en su etiqueta de coincidencia. El aspecto podría ser el siguiente:

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

Si la URL de concordancia de cookies del ofertante se establece en https://ad.network.com/pixel?id=1 y la operación de coincidencia de cookies se realiza de forma correcta, 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. Si quieres obtener más información sobre los códigos de error posibles para el flujo de trabajo de la Coincidencia de cookies, consulta los parámetros de URL de redireccionamiento.

Agregar a una sola lista de usuarios

El parámetro google_ula se puede especificar en una etiqueta de coincidencia del ofertante para agregar al usuario a una lista de usuarios con el ID determinado. Si la tabla de coincidencia alojada en el ofertante o en Google 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 a fin de agregar al usuario a la lista especificada sin iniciar el flujo de trabajo completo de concordancia de cookies. Consulta las restricciones para invocar el servicio de concordancia de cookies para obtener más información. La etiqueta de coincidencia correspondiente puede tener el siguiente aspecto:

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

Para obtener una respuesta exitosa, en la que la URL de coincidencia de cookies del ofertante es https://ad.network.com/pixel, la URL de redireccionamiento de Google sería:

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

Si hay un error general, por ejemplo, si 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, esto reemplaza la marca de tiempo con un código de estado para indicar el éxito de la operación. Por ejemplo, si la solicitud fallaba porque la cuenta del ofertante no tenía acceso a la lista de usuarios especificada, la URL de redireccionamiento sería:

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

Agregar a varias listas de usuarios

Los ofertantes pueden especificar que se debe agregar un usuario a varias listas de usuarios mediante la inclusión de varios parámetros google_ula en la etiqueta de coincidencia. En la práctica, esto podría verse así:

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

El estado de la operación para cada lista de usuarios se informa de manera similar a través de parámetros google_ula distintos en el redireccionamiento:

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

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

Para realizar una coincidencia de cookies y agregar al usuario a una lista de usuarios en una sola solicitud, una etiqueta de coincidencia del ofertante debe incluir google_cm y google_ula:

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

La URL de redireccionamiento especificada por Google incluiría google_gid, google_cver y google_ula. Esto podría verse de la siguiente manera:

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

Almacenar una coincidencia en una tabla de coincidencias alojada en Google

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

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

Para una respuesta exitosa, en la que la URL de coincidencia de cookies del ofertante es https://cookie-monster.com/pixel, la URL de redireccionamiento de Google sería:

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 ofertas para este usuario, el ofertante recibirá los datos de coincidencias alojados en BidRequest.hosted_match_data para el protocolo de RTB de Google o en BidRequest.user.buyeruid para la implementación de OpenRTB de Google.

En cambio, si el ofertante usó una etiqueta de coincidencia en la que el valor de google_hm no estaba codificado en base64, como chocolate_chunk!, la URL de redireccionamiento podría verse de la siguiente manera:

https://cookie-monster.com/pixel?google_hm=2

La URL de redireccionamiento anterior incluye un valor google_hm de 2, lo que sugiere que la operación falló porque no se pudo decodificar el valor.

Tablas de coincidencias alojadas por el ofertante y por Google con listas de usuarios

Si un ofertante aloja su propia lista de uso además de una lista de usuarios alojada en Google y desea que una sola etiqueta de coincidencia coincida con ambas tablas y agrega al usuario a una lista de usuarios determinada, su etiqueta de coincidencia debe incluir los parámetros google_cm, google_hm y google_ula. Si los datos de la cookie del ofertante son Cookie number 1!, el valor codificado sería Q29va2llIG51bWJlciAxIQ==, lo que produciría una etiqueta de coincidencia como la siguiente:

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

Para una respuesta exitosa, en la que la URL de coincidencia de cookies del ofertante es https://cookie-monster.com/pixel, la URL de redireccionamiento de Google tendría el siguiente aspecto:

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

Al recibir el redireccionamiento, el ofertante puede hacer coincidir el ID de usuario de Google especificado en google_gid con los datos de su cookie en su tabla de coincidencias. Además, pueden determinar que la tabla de coincidencias alojada en Google y las operaciones de la lista de usuarios se realizaron de forma correcta. Como consecuencia, cualquier orientación previa al ofertante configurada para orientarse al ID de la lista de usuarios especificada ahora hará que el ofertante reciba solicitudes de oferta por impresiones del usuario. Del mismo modo, en estas solicitudes de oferta, el ofertante recibirá sus datos de coincidencia alojados en BidRequest.hosted_match_data para el protocolo de RTB de Google o en BidRequest.user.buyeruid para la implementación de OpenRTB de Google.