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 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 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. Esto podría incluir a las partes responsables de proporcionar el lenguaje de marcado para la creatividad, las partes que proporcionan el píxel de impresión o 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 o no recibir informes de atribución de la ARA, pero están posicionadas para garantizar que las tecnologías publicitarias posteriores puedan recibir informes de atribución.

Además, es posible que el anunciante también utilice un proveedor externo de medición de conversiones para la atribución en varias redes y otras funciones de generación de informes. Los anunciantes utilizan 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 utilizando 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 separados de la API. Por ejemplo, una DSP puede recibir sus propios informes de atribución de la API de Attribution Reporting y permitir informes separados 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 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 el caso de las DSP o los servidores de anuncios de los 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 medición o estadísticas de terceros.

En este caso, la tecnología publicitaria de publicación también es la entidad responsable de activar los eventos de clic y de impresión en la configuración actual. La tecnología publicitaria de publicación debe establecer el nuevo attributionsrc en las ubicaciones adecuadas y verificar que los redireccionamientos estén configurados correctamente. Además, tanto la tecnología publicitaria que publica el anuncio como el proveedor de medición externo deben verificar que estén inscritos y que sus servidores estén listos para recibir y responder a 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 para la creatividad del anuncio a la DSP, 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 attributionsrc se incluya en el lenguaje de marcado de la creatividad del anuncio.

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

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 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 de publicadores que alojan creatividades y no planean usar los informes de atribución por sí mismos, pero que desean habilitar la API de Attribution Reporting para sus socios de DSP o para las empresas de etiquetado de medición, como los servidores de anuncios de terceros o los proveedores de medición o análisis.

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 verificar 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, podría ser la SSP, la tecnología de publicación de anuncios o el publicador mismo. En el caso de los eventos de impresión, suele ser el proveedor de medición externo.

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

Detalles de implementación

En la siguiente tabla, se describen los pasos para implementar la API de Attribution Reporting a un nivel 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 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, un comprador (servidor de anuncios de la DSP o del anunciante) que renderiza la creatividad agrega el atributo.

En el caso de 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 este 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 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 externo 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 parámetro attributionsrc se debe agregar a los eventos de clic y de impresión 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. No es necesario que los redireccionamientos 302 posteriores a la navegación agreguen el atributo attributionsrc, y serán aptos para la ARA siempre que 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 anclaje (URL de clic). Cuando se define 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 a las 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 clic y de impresión

  • 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 usar 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 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 de la API de Fetch.

Consulta la siguiente tabla para ver el resumen de las modificaciones necesarias para los eventos de clic y de impresión:

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> de HTML <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Etiqueta <script> de 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 las 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 los worklets de informes, y registerAdMacro está disponible dentro del worklet de informes de victorias del comprador. Luego, los datos del evento dentro del marco del anuncio se pueden agregar a los píxeles contadores y las macros registrados con las funciones reportEvent y setReportEventDataForAutomaticBeacons de la API de Fenced Frame Ads Reporting. Esto permite que los indicadores de los worklets de informes de Protected Audience y la carga útil del evento del 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 balizas y las macros, o cuando el navegador activa las balizas automáticas. Puedes usar la respuesta del beacon para registrar una fuente de atribución. Es posible que las solicitudes de baliza se redireccionen para permitir la medición de terceros.

Para obtener más información, consulta la sección de compatibilidad con los informes de atribución del documento explicativo de la API de Fenced Frame Ad Reporting.

Habilita los informes de atribución para los formatos de 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 se deben considerar como posibles eventos fuente aptos para el registro con la API de Attribution Reporting. El Anexo de VAST para la compatibilidad con los informes de atribución abarca este tema en detalle, pero, 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 de elegibilidad de registro para estos eventos.

El complemento de VAST define nuevos atributos para estos elementos que permiten configurar 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 suplemento de VAST contiene ejemplos para cada situación.

Para lograr la máxima cobertura, las implementaciones de VAST deben, de forma predeterminada, hacer que todos los eventos enumerados sean aptos para el registro cuando se activen los pings de eventos. Por ejemplo, cuando se activa una URL del 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 siempre 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 verificador de impresiones independiente, por lo que los redireccionamientos son más relevantes para los verificadores de clics.

Cómo controlar orígenes de terceros en una cadena de redireccionamiento existente

En un clic en un anuncio típico, pueden estar presentes muchos seguidores de clics como una cadena de redireccionamientos 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 registrarse con la API de Attribution Reporting si el destino del clic 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 el caso de las subastas de Protected Audience, si se pasa eventData 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 generar informes de conversiones.

Diagrama que describe cómo el origen registra el dominio propio.
Ejemplo de cómo funciona la medición de conversiones con un tercero.

Durante el 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 los encabezados Attribution-Reporting-Register-Source y 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 fuente y usa serving-adtech.example como el origen del informe.
  4. Debido a que esta solicitud es un redireccionamiento, el navegador también realiza una nueva solicitud 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 el origen del informe.

Usa attributionsrc para orígenes de terceros que no estén en 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 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, verifica 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 construir la respuesta.

Registra varios activadores

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

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