Habilita la medición de conversiones

La medición de la atribución de conversiones puede involucrar a varias partes, desde el publicador, el anunciante, la tecnología publicitaria de publicación (la entidad que publica el anuncio), el proveedor de medición y mucho más. En este documento, ilustramos situaciones comunes de medición de conversiones, pero, en general, cualquier parte que desee recibir un informe de atribución de la API de Attribution Reporting (ARA) debe asegurarse de seguir los pasos de integración que se describen en este documento.

Por ejemplo, es común que un publicador tenga una o más tecnologías publicitarias responsables de publicar el anuncio, lo que podría incluir a las partes responsables de proporcionar el lenguaje de marcado para la creatividad, las partes que proporcionan la impresión o el píxel de seguimiento en la creatividad, y las partes que proporcionan el SDK o la etiqueta para el espacio publicitario en la página del publicador. Es posible que estas tecnologías publicitarias quieran recibir informes de atribución de ARA o no, pero están posicionadas para garantizar que las tecnologías publicitarias descendentes puedan recibir informes de atribución.

Además, es posible que el anunciante también use un proveedor de medición de conversiones de terceros para la atribución entre varias redes, así como otras funciones de informes. Los anunciantes usan esos datos para comprender el retorno de la inversión publicitaria en varios publicadores y canales únicos, por lo que es importante que las DSP o los servidores de anuncios comprendan cómo habilitar la API de Attribution Reporting para admitir estos casos de uso. Los anunciantes que deseen usar un tercero pueden seguir haciéndolo, ya sea con un proveedor de medición externo o configurando un servidor interno para registrar y recibir informes de la API.

La API de Attribution Reporting permite que varias tecnologías publicitarias registren fuentes de atribución y activadores para la misma impresión o conversión, y reciban informes independientes de la API. Por ejemplo, una DSP puede recibir sus propios informes de atribución de la API de Attribution Reporting y permitir informes independientes para el proveedor de medición externo del anunciante. Una tecnología publicitaria debe registrar fuentes de atribución y activadores para recibir informes de la API, y la atribución se realiza entre las fuentes de atribución y los activadores que la tecnología publicitaria registró de forma individual en la API.

Situaciones comunes de medición de conversiones

En esta sección, examinaremos dos situaciones comunes para la medición de conversiones.

Situación 1: Tanto la tecnología publicitaria de publicación como el proveedor de medición externo deben recibir informes de la API de Attribution Reporting

Un anunciante desea atribuir las conversiones en el inventario de anuncios con un proveedor de medición externo, y la tecnología publicitaria que aloja la creatividad desea atribuir las conversiones en el inventario de anuncios. Esto es común en las DSP o los servidores de anuncios del anunciante (servidores de anuncios de terceros, 3PAS) que proporcionan el marcado para las creatividades de anuncios, realizan sus propios informes de atribución y trabajan con anunciantes que se integran con proveedores de medición o estadísticas de terceros.

En este caso, la tecnología publicitaria de publicación también es la parte responsable de activar los eventos de clics e impresiones en la configuración actual. La tecnología publicitaria de publicación debe establecer el nuevo attributionsrc en las ubicaciones adecuadas y asegurarse de que los redireccionamientos estén configurados correctamente. Además, tanto la tecnología publicitaria de publicación como el proveedor de medición externo deben asegurarse de estar inscritos y de que sus servidores estén listos para recibir y responder las solicitudes de la API de Attribution Reporting.

Una configuración de campaña típica podría verse de la siguiente manera:

  1. El servidor de anuncios del anunciante (3PAS) proporciona el lenguaje de marcado de la creatividad del anuncio a la DSP, que incluye los píxeles de seguimiento de clics e impresiones del proveedor de medición externo. El servidor de anuncios debe garantizar que se incluya attributionsrc en el marcado de la creatividad del anuncio.

  2. La DSP ofrece capacidades para agregar impresiones de medición adicionales y píxeles de seguimiento de clics, y debe asegurarse de que se incluya attributionsrc en el marcado de la creatividad del anuncio final con el que oferta.

Situación 2: Solo el proveedor de medición externo debe recibir informes de la API de Attribution Reporting

Un anunciante desea atribuir las conversiones en el inventario de anuncios con un proveedor de medición externo, pero la tecnología publicitaria que aloja la creatividad no tiene requisitos de medición de atribución. Esto es común para los publicadores, las SSP o los servidores de anuncios del publicador que alojan creatividades y no planean usar los informes de atribución por su cuenta, pero que desean habilitar la API de Attribution Reporting para sus socios de DSP o para empresas de etiquetado de medición, como servidores de anuncios de terceros, proveedores de medición o estadísticas.

En este caso, la parte responsable de activar los eventos de clics y de impresiones en la configuración actual debe agregar el nuevo atributo attributionsrc a las creatividades y asegurarse de que los redireccionamientos funcionen según lo previsto. Esto depende en gran medida de la integración de cada publicador, pero, en el caso de los eventos de clic, puede ser la SSP, la tecnología publicitaria de publicación o el propio publicador. En el caso de los eventos de impresión, este es, por lo general, el proveedor de medición externo.

En el ejemplo de configuración de campaña típico de la Situación 1, es posible que el servidor de anuncios del publicador, la SSP o el propio publicador deban asegurarse de que el atributo attributionsrc que proporcionó la DSP llegue a la página del publicador.

Detalles de implementación

En la siguiente tabla, se describen los pasos de implementación de la API de Attribution Reporting de forma general:

Pasos Responsabilidad del trabajo Ejemplos
Paso 1: Habilita la fuente de atribución para las creatividades y el código de medición existentes La entidad responsable de activar eventos de impresión o controlar eventos de clic agrega el atributo attributionsrc. En el caso de los eventos de clic, por lo general, un comprador (DSP o servidor de anuncios del anunciante) que renderiza la creatividad agrega el atributo.

En el caso de los eventos de impresión, la plataforma de proveedores (SSP), la plataforma orientada a la demanda (DSP), el publicador, el servidor de anuncios o un proveedor de medición agregan el atributo, que depende de la configuración del publicador.

En el caso de los anuncios de video que usan el formato VAST, el publicador y el SDK de video agregan el atributo.
Paso 2: Habilita los informes de atribución para orígenes de terceros Esto funciona de forma inmediata si usas una ruta de redireccionamiento existente con redireccionamientos 302.

Si no se pueden usar los redireccionamientos 302, se puede usar el atributo attributionsrc para enumerar varios servidores de tecnología publicitaria.

 Por lo general, siempre que se agregue el atributo attributionsrc a la creatividad, los redireccionamientos de terceros deberían recibir las llamadas a la API de Attribution Reporting.
Paso 3: Configura las respuestas para las solicitudes a la API de Attribution Reporting Cualquier entidad que desee recibir informes de la API de Attribution Reporting La DSP y el proveedor de medición de terceros que usa el anunciante

Ten en cuenta que los detalles de cada paso dependen de cómo se renderizan y publican las creatividades en la página del publicador, y de qué entidades de tecnología publicitaria reciben los informes que envía la API de Attribution Reporting.

Paso 1: Habilita la fuente de atribución para las creatividades y el código de medición existentes

En el primer paso, se habilitan las fuentes de atribución.

Cómo funciona el atributo attributionsrc

El nuevo atributo attributionsrc especifica a dónde se enviarán las solicitudes de la API de Attribution Reporting. La entidad responsable de activar los eventos de impresión y clic debe actualizar las creatividades con el atributo attributionsrc. El attributionsrc se debe agregar a los eventos de clics e impresiones existentes y puede estar vacío o no.

En el caso de los eventos de clic que usan redireccionamientos, se debe agregar el atributo attributionsrc a la navegación. Los redireccionamientos 302 después de la navegación no necesitan agregar el atributo attributionsrc y serán aptos para la ARA, siempre y cuando la navegación inicial haya agregado attributionsrc.

Cuando attributionsrc esté vacío, las solicitudes de ARA se enviarán a la URL definida en el atributo href de la etiqueta de ancla (URL de clic). Cuando se define el atributo attributionsrc, las solicitudes de ARA se envían a la URL definida en el atributo attributionsrc. La URL de clic también es apta para registrar fuentes.

Por lo general, usa un atributo attributionsrc vacío si el servidor que aloja la URL de clic puede recibir y responder solicitudes de la API de Attribution Reporting. Define tu propia URL de attributionsrc si deseas que las solicitudes a la API de Attribution Reporting se dirijan a un servidor diferente.

Ejemplo de un atributo attributionsrc vacío:

Tu configuración existente Con integración de ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Cuando el atributo attributionsrc esté vacío, las solicitudes de la API de Attribution Reporting se enviarán a la URL definida por el atributo href de la etiqueta de anclaje.

Ejemplo de un atributo attributionsrc no vacío:

Tu configuración existente Con integración de ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Cuando attributionsrc no esté vacío, las solicitudes de la API de Attribution Reporting se enviarán a la URL definida por la etiqueta attributionsrc. La URL de clic también es apta para registrar fuentes.

Agrega attributionsrc para los eventos de clics e impresiones

  • Eventos de clic:
    • La entidad responsable de agregar el attributionsrc suele ser la tecnología publicitaria de publicación.
    • Las etiquetas de ancla con eventos de clic deben tener un atributo attributionsrc agregado.
    • Los clics que usan window.open deben usar el argumento windowFeatures de la llamada a window.open para especificar la fuente de atribución.
  • Eventos de impresión:
    • La entidad responsable de agregar el attributionsrc suele ser la tecnología publicitaria de publicación y los proveedores de medición.
    • Los eventos de impresión activados desde la etiqueta <img> o la etiqueta <script> deben incluir un atributo attributionsrc.
    • Los eventos de impresión que usan la API de recuperación deben incluir un objeto attributionReporting en el argumento options que se pasa a la llamada a la API de recuperación.

Consulta la siguiente tabla para ver el resumen de las modificaciones necesarias para los eventos de clics e impresiones:

Evento Etiqueta Tu configuración existente Después de la integración de ARA
Clic HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Impresión Etiqueta <img> HTML <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Etiqueta <script> HTML <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Habilita el registro de fuentes de atribución en una subasta de Protected Audience

Para medir las conversiones en subastas de Protected Audience, en lugar de usar attributionsrc, puedes usar registerAdBeacon/registerAdMacro y setReportEventDataForAutomaticBeacons/reportEvent para habilitar el registro de fuentes de atribución.

Para informar los indicadores de Protected Audience, la función registerAdBeacon está disponible dentro de las worklets de informes y registerAdMacro está disponible dentro de la worklet de informes de ganancias del comprador. Luego, los datos de eventos dentro del marco de anuncios se pueden agregar a los píxeles contadores y las macros registrados con las funciones reportEvent y setReportEventDataForAutomaticBeacons de la API de informes de anuncios de marco de contenido protegido. Esto permite que los indicadores de los worklets de informes de Protected Audience y la carga útil del evento de marco de la creatividad del anuncio se asocien entre sí.

El encabezado HTTP Attribution-Reporting-Eligible se agrega a la solicitud cuando la llamada reportEvent desde un marco activa los píxeles contadores y las macros, o cuando el navegador activa los píxeles contadores automáticos. Puedes usar la respuesta del píxel contador para registrar una fuente de atribución. Es posible que las solicitudes de píxeles contadores se redireccionen para permitir la medición de terceros.

Para obtener más información, consulta la sección Compatibilidad con los informes de atribución de la explicación de la API de Attribution Reporting.

Habilita los informes de atribución para los formatos VAST

VAST es un formato común para publicar y medir el inventario de anuncios de video, y muchos de los eventos definidos en ese estándar deben considerarse posibles eventos de origen aptos para registrarse en la API de Attribution Reporting. El Anexo de VAST para la compatibilidad con los informes de atribución lo explica en detalle, pero, en resumen, todos los eventos <Tracking>, <Impression>, <*ClickThrough> y <*ClickTracking> son posibles eventos de fuentes de atribución. Todas las implementaciones de VAST deben proporcionar cobertura de elegibilidad de registro para estos eventos.

El anexo de VAST define atributos nuevos para estos elementos que permiten establecer una URL secundaria específicamente para el registro de atribución. Cuando un evento contiene attributiontype="DOUBLE_PING" y attributionsrc="[URL]", el código que activa ese evento debe usar [URL] como el valor del atributo attributionsrc cuando se habilita la API de Attribution Reporting. El anexo de VAST contiene ejemplos para cada situación.

Para garantizar la máxima cobertura, las implementaciones de VAST deben hacer que todos los eventos enumerados sean aptos para el registro de forma predeterminada cuando se activan los pings de eventos. Por ejemplo, cuando se activa una URL de evento <Impression>, se debe usar el atributo attributionsrc (vacío) en el elemento <img> que se usa para enviar la solicitud (o el equivalente en la llamada de recuperación) para permitir que la parte receptora siempre pueda registrar ese evento con la API de Attribution Reporting.

Paso 2: Habilita los informes de atribución para orígenes de terceros

Para permitir que terceros usen la API de Attribution Reporting, puedes usar redireccionamientos existentes o agregar una lista de terceros al atributo attributionsrc. En la mayoría de los casos, cada tecnología publicitaria tiene su propio servicio de seguimiento de impresiones independiente, por lo que los redireccionamientos son más relevantes para los servicios de seguimiento de clics.

Controla los orígenes de terceros en una cadena de redireccionamiento existente

En un clic en un anuncio típico, es posible que muchos servicios de seguimiento de clics estén presentes como una cadena de redireccionamientos 302 que se realizan como parte de la navegación a la página de destino final. Cada solicitud de la cadena de redireccionamiento es apta para registrarse en la API de Attribution Reporting si el objetivo de clic original se anoto con attributionsrc o se registró con registerAdBeacon/registerAdMacro en la API de Protected Audience. La tecnología publicitaria de la cadena de redireccionamiento también debe estar inscrita.

Ten en cuenta que el cuerpo de la solicitud inicial no se envía en los redireccionamientos. En el caso de las subastas de Protected Audience, si eventData se pasa a reportEvent y se debe usar setReportEventDataForAutomaticBeacons como parte del redireccionamiento, se debe pasar de forma explícita como parte de la URL de redireccionamiento.

En el siguiente ejemplo, usaremos una tecnología publicitaria de publicación (serving-adtech.example) y un proveedor de medición externo (3p-measurement.example) como dos entidades distintas que buscan generar y recibir informes de atribución. La tecnología publicitaria de publicación en este ejemplo puede ser una DSP que renderiza la creatividad en el sitio del publicador y tiene su propio producto de informes. El proveedor de medición externo puede ser una entidad que el anunciante utiliza para los informes de conversiones.

Un diagrama que describe cómo el propietario registra la fuente y, luego, el tercero registra el

En el momento del registro de la fuente, se realizan los siguientes pasos:

  1. serving-adtech.example establece el atributo attributionsrc en la creatividad. El usuario visita la página del publicador y el navegador envía una solicitud a serving-adtech.example..
  2. serving-adtech.example responde con el encabezado Attribution-Reporting-Register-Source y el encabezado Location.
    1. serving-adtech.example usa el encabezado Attribution-Reporting-Register-Source para responder con metadatos sobre la fuente que se registrará.
    2. serving-adtech.example usa el encabezado Location para incluir un redireccionamiento a 3p-measurement.example. Ten en cuenta que es probable que el encabezado Location ya se esté usando en tus flujos de seguimiento de clics existentes para admitir redireccionamientos 302 a un tercero.
  3. El navegador recibe la respuesta de serving-adtech.example y analiza el encabezado Attribution-Reporting-Register-Source. El navegador almacena el evento de origen y usa serving-adtech.example como el origen de los informes.
  4. Debido a que esta solicitud es un redireccionamiento, el navegador también realiza una solicitud nueva a 3p-measurement.example.
  5. 3p-measurement.example responde con una respuesta que contiene el encabezado Attribution-Reporting-Register-Source.
  6. El navegador recibe esta respuesta de 3p-measurement.example y lee Attribution-Reporting-Register-Source. El navegador almacena el evento de origen y usa 3p-measurement.example como el origen de los informes.

Usa attributionsrc para orígenes de terceros que no estén en una cadena de redireccionamiento

Si varios orígenes de generadores de informes desean registrar una fuente en un evento de navegación, pero no pueden aparecer en una cadena de redireccionamiento por algún motivo, puedes enumerar varios sitios como fuentes de atribución en attributionsrc como solución alternativa.

Tu configuración existente Con modificación de ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

En este ejemplo, las solicitudes aptas para la API de Attribution Reporting se enviarán a REPORTING_URL_1 y a REPORTING_URL_2. La solicitud de navegación que se envía a la URL de clic también es apta para registrar fuentes de atribución.

Paso 3: Configura las respuestas para las solicitudes a la API de Attribution Reporting

Para todos los orígenes que reciben una solicitud de la API de Attribution Reporting, asegúrate de que el servidor responda con el encabezado Attribution-Reporting-Register-Source adecuado. Consulta la guía Cómo registrar fuentes y la explicación para saber cómo se debe construir la respuesta.

Registra varios activadores

Para registrar varios activadores de atribución, agrega varios elementos de píxeles en el lado de la conversión (uno por activador). El elemento attributionsrc es opcional para el registro de activadores.

También puedes registrar varios activadores desde un solo elemento de píxel con solicitudes de redireccionamiento o enumerando varias URLs en el elemento attributionsrc de la misma manera que para el registro de la fuente. Se hará coincidir los eventos de origen y los eventos activador que hayan generado los mismos orígenes.