Habilita la medición de conversiones

La medición de atribución de conversiones puede involucrar a varias partes, entre las que se incluyen el publicador, el anunciante, la tecnología publicitaria de publicación (la entidad que publica el anuncio), el proveedor de medición y muchos 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 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. Entre ellas, se pueden incluir las partes responsables de proporcionar el lenguaje de marcado para la creatividad, las que proporcionan la impresión o el píxel de seguimiento de la creatividad y las partes que proporcionan el SDK o la etiqueta para el espacio publicitario en la página del publicador. Estas tecnologías publicitarias pueden o no querer 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 utilice 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 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 utilizar un tercero pueden seguir haciéndolo, ya sea mediante 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ó individualmente 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 conversiones en el inventario de anuncios a través de 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 de anunciantes (servidores de anuncios de terceros, 3PAS) que proporcionan lenguaje de marcado para 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 impresiones y clics en la configuración actual. La tecnología publicitaria de publicación debe establecer el nuevo attributionsrc en las ubicaciones adecuadas y garantizar 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 que estén inscritos y de que sus servidores estén listos para recibir y responder las solicitudes a la API de Attribution Reporting.

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

  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 clics del proveedor de medición externo. 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 funciones para agregar píxeles de seguimiento de clics y impresiones de medición adicionales, y debe asegurarse de que se incluya attributionsrc en el lenguaje de marcado final de la creatividad del anuncio con el que se ofertan.

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

Un anunciante desea atribuir conversiones en el inventario de anuncios a través de 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 de publicadores que alojan creatividades y no planean usar los informes de atribución, 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 externos, 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, puede ser la SSP, la tecnología publicitaria de publicación o el propio publicador. En el caso de los eventos de impresión, suele ser el proveedor de medición externo.

En el ejemplo de configuración típico 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 que proporcionó la DSP se incluya en 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: Habilita la fuente de atribución para las creatividades existentes y el código de medición 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 (el servidor de anuncios del anunciante o de la 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 agregan el atributo.
Paso 2: Habilita Attribution Reporting para orígenes de terceros Esto funciona de inmediato si se usa una ruta de redireccionamiento existente con redireccionamientos 302.

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

 En general, siempre que se agregue el atributo attributionsrc a la creatividad, los redireccionamientos de terceros deben 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 de terceros 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 enviados por la API de Attribution Reporting.

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

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 se debe agregar a los eventos de impresiones y clics 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 posteriores a 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 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.

Por lo general, usa un atributo attributionsrc vacío si el servidor que aloja la URL de clic puede recibir y responder las solicitudes a la API de Attribution Reporting. Define tu propia URL de attributionsrc si quieres 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 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>

Cuando el 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.

Agregar attributionsrc para los eventos de impresiones y clics

  • Eventos de clic:
    • Por lo general, la entidad responsable de agregar el attributionsrc es la tecnología publicitaria de publicación.
    • Las etiquetas de anclaje con eventos de clic deben tener agregado un atributo attributionsrc.
    • Los clics que usan window.open deben utilizar el argumento windowFeatures de la llamada window.open para especificar la fuente de atribución.
  • Eventos de impresión:
    • Por lo general, la entidad responsable de agregar el 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 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 obtener un resumen de las modificaciones necesarias para los eventos de clics e 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 las conversiones en una subasta 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 los indicadores de Protected Audience, la función registerAdBeacon está disponible dentro de los worklets de informes, y registerAdMacro está disponible dentro del worklet de informes de anuncios ganadores del comprador. Luego, los datos de eventos dentro del marco del anuncio se pueden agregar a las macros y píxeles contadores registrados con las funciones reportEvent y setReportEventDataForAutomaticBeacons de la API de informes de anuncios de marcos vallados. Esto permite que se asocien los indicadores de los worklets de informes de Protected Audience y la carga útil del evento del marco de creatividad del anuncio.

El encabezado HTTP Attribution-Reporting-Eligible se agrega a la solicitud cuando la llamada reportEvent de un marco activa los píxeles contadores y las macros, o cuando el navegador activa los píxeles contadores automáticos. Puede utilizar la respuesta de la baliza para registrar una fuente de atribución. Es posible que las solicitudes de la baliza se redireccionen 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 informes de anuncios de marcos vallados.

Cómo habilitar 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 Apéndice de VAST para la compatibilidad con Informes de atribución aborda esto 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 apéndice de VAST define nuevos atributos para estos elementos a fin de permitir la configuración de 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 apéndice de VAST contiene ejemplos para cada caso.

Para garantizar la máxima cobertura, las implementaciones de VAST deben hacer que todos los eventos enumerados sean aptos de registro de forma predeterminada cuando se activan 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 su equivalente en la llamada de recuperación) para permitir que la parte receptora registre potencialmente ese evento con la API de Attribution Reporting.

Paso 2: Habilita Attribution Reporting 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 seguimiento de impresiones independiente, por lo que los redireccionamientos son más relevantes para estos servicios.

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

En un clic de anuncio típico, es posible que muchos rastreadores 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 en la cadena de redireccionamiento es apta para registrarse 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 en 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 pasa 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 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 tenga su propio producto de informes. El proveedor de medición de terceros puede ser una entidad que el anunciante utilice para los informes de conversiones.

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

Durante el 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 esté usando 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 el 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 estén en una cadena de redireccionamiento

Si varios orígenes denunciantes 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 Registra fuentes y la explicación para saber 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 si usas solicitudes de redireccionamiento o enumeras varias URLs en el elemento attributionsrc de la misma manera que para el registro de fuentes. Se establecerán coincidencias con los eventos de origen y los activadores que hayan generado los mismos orígenes.