Habilita la medición de conversiones

La medición de la atribución de conversiones puede incluir 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, mostramos 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 que se sigan los pasos de integración descritos en este documento.

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

Además, es posible que el anunciante también use un proveedor de medición de conversiones externo para la atribución de varias redes, así como otras funciones de generación de informes. Los anunciantes utilizan esos datos para comprender el retorno de la inversión publicitaria de 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 utilizar un tercero pueden seguir haciéndolo, ya sea mediante un proveedor de medición de terceros o mediante la configuración de 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 separados de la API. Por ejemplo, una DSP puede recibir sus propios informes de atribución de la API de Attribution Reporting y permitir la generación de 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ó individualmente en la API.

Situaciones comunes de medición de conversiones

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

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

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

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

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

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

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

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

Un anunciante desea atribuir conversiones en el inventario de anuncios mediante 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 en los publicadores, las SSP o los servidores de anuncios del publicador que alojan creatividades y no planean usar los informes de atribución ellos mismos, pero que desean habilitar la API de Attribution Reporting para sus socios de DSP o para empresas de etiquetado de mediciones, 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 para los eventos de clic, podría ser la SSP, la tecnología publicitaria de publicación o el publicador mismo. En el caso de los eventos de impresión, suele ser el proveedor de medición externo.

En el ejemplo típico de configuración de la campaña de la situación 1, es posible que el servidor de anuncios del publicador, la SSP o el publicador solo necesiten asegurarse de que el atributo attributionsrc proporcionado por la DSP llegue a la página del publicador.

Detalles de la implementación

En la siguiente tabla, se describen los pasos de implementación de la API de Attribution Reporting a un alto nivel:

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

Para los eventos de impresión, la plataforma orientada a la demanda (DSP), la plataforma de proveedores (SSP), el publicador, el servidor de anuncios o un proveedor de medición agregan el atributo, y 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 deben agregar el atributo.

Paso 2: Habilita Attribution Reporting para orígenes externos Esto funciona de inmediato si usas una ruta de redireccionamiento existente con redireccionamientos 302.

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

En 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 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 externo que utiliza 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 informes que envía la API de Attribution Reporting.

Paso 1: Habilite 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 a la API de Attribution Reporting. La entidad responsable de activar los eventos de impresiones y clics debe actualizar las creatividades con el atributo attributionsrc. El campo attributionsrc debe agregarse a los eventos de clics y de impresiones existentes, y puede estar vacío o no.

Para 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 que la navegación inicial haya agregado attributionsrc.

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

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

Ejemplo de un atributo attributionsrc vacío:

Tu configuración actual Con integración en la ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Cuando el atributo attributionsrc esté vacío, las solicitudes a 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 actual Con integración en la ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Si el elemento attributionsrc no está vacío, las solicitudes a 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.

Agregue attributionsrc para los eventos de clics y de impresiones

  • Eventos de clic:
    • Por lo general, la entidad responsable de agregar el attributionsrc es la tecnología publicitaria de publicación.
    • Se debe agregar un atributo attributionsrc a las etiquetas de anclaje con eventos de clic.
    • Los clics que utilizan window.open deben utilizar el argumento windowFeatures de la llamada a window.open para especificar la fuente de atribución.
  • Eventos de impresión:
    • Por lo general, la entidad responsable de agregar el elemento attributionsrc es 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 Fetch deben incluir un objeto attributionReporting en el argumento options que se pasa a la llamada a la API de fetch.

Consulta la siguiente tabla si deseas obtener un resumen de las modificaciones necesarias para los eventos de clics y de impresiones:

Evento Etiqueta Tu configuración actual Después de la integración de la 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 HTML <img> <img src="[IMPRESSION_URL]" /> <img src="[IMPRESSION_URL]" attributionsrc />
Etiqueta HTML <script> <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 la fuente de atribución en una subasta de Protected Audience

Para medir 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 generar informes de indicadores de Protected Audience, la función registerAdBeacon está disponible en los worklets de informes, y registerAdMacro está disponible dentro del worklet de informes de victoria del comprador. Luego, los datos de eventos dentro del marco de anuncios se pueden agregar a los píxeles contadores y macros registrados con las funciones reportEvent y setReportEventDataForAutomaticBeacons de la API de informes de anuncios de marcos protegidos. Esto permite que se asocien entre sí los indicadores de los Worklets de informes de Protected Audience y la carga útil de eventos del marco de la creatividad del anuncio.

El encabezado HTTP Attribution-Reporting-Eligible se agrega a la solicitud cuando el navegador activa los píxeles contadores y las macros mediante la llamada reportEvent desde un marco. Puedes utilizar la respuesta de la baliza para registrar una fuente de atribución. Las solicitudes de baliza se pueden redireccionar para permitir la medición de terceros.

Para obtener información más detallada, consulta la sección Compatibilidad con Attribution Reporting de la explicación de la API de Ad Reporting de marco cercado.

Habilite los informes de atribución para 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 fuente aptos para el registro en la API de Attribution Reporting. En el Anexo de VAST para la Asistencia de Attribution Reporting, se aborda este tema en detalle. Sin embargo, en resumen, todos los eventos <Tracking>, <Impression>, <*ClickThrough> y <*ClickTracking> son posibles eventos de fuente de atribución. Todas las implementaciones de VAST deben proporcionar cobertura para la elegibilidad del registro en estos eventos.

En el anexo de VAST, se definen nuevos atributos para estos elementos a fin de permitir la configuración de una URL secundaria específicamente para el registro de atribuciones. 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 indicados sean aptos para registrarse de forma predeterminada cuando se activen 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 utiliza para enviar la solicitud (o el equivalente en la llamada de recuperación) para permitir siempre que la parte receptora pueda registrar ese evento con la API de Attribution Reporting.

Paso 2: Habilita Attribution Reporting para orígenes externos

Para permitir que los terceros usen la API de Attribution Reporting, puedes usar los 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 seguimiento de impresiones independiente, por lo que los redireccionamientos son más relevantes para los servicios de seguimiento de clics.

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

En un clic típico en un anuncio, muchos servicios de seguimiento de clics pueden estar presentes como una cadena de redireccionamientos de 302 que se realizan como parte de la navegación a la página de destino final. Todas las solicitudes de la cadena de redireccionamiento son aptas para el registro con la API de Attribution Reporting si el objetivo de clics original se anotó 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 las subastas de Protected Audience, si eventData se pasó a reportEvent y setReportEventDataForAutomaticBeacons debe usarse como parte del redireccionamiento, se debe pasar explícitamente 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 de terceros (3p-measurement.example) como dos entidades distintas que buscan generar y recibir informes de atribución. En este ejemplo, la tecnología publicitaria de publicación puede ser una DSP que renderiza la creatividad en el sitio del publicador y que 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 en el que se describe cómo el tercero registra la fuente y, luego, el tercero registra la

En el momento del registro de la fuente, se llevan a cabo 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 use en tus flujos de seguimiento de clics existentes para admitir redireccionamientos de 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 fuente y usa serving-adtech.example como origen del informe.
  4. Como 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 la Attribution-Reporting-Register-Source. El navegador almacena el evento fuente y usa 3p-measurement.example como origen del informe.

Usa attributionsrc para orígenes de terceros que no pertenezcan a una cadena de redireccionamiento

Si varios orígenes 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 actual Con modificación de la 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 enviada a la URL de clic también es apta para registrar fuentes de atribución.

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

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

Registra varios activadores

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

También puedes registrar varios activadores desde un solo elemento de píxel mediante solicitudes de redireccionamiento o enumerando varias URLs en el elemento attributionsrc de la misma manera que para el registro de la fuente. Se detectarán coincidencias con los eventos de fuente y los eventos de activación generados por los mismos orígenes.