Registra activadores de atribución

Aprende a registrar activadores de atribución para registrar tus conversiones.

Un activador de atribución es el evento que le indica al navegador que capture las conversiones.

Sigue los pasos que se indican en este documento para registrar activadores para registrar las conversiones que el navegador atribuye a los eventos de fuente relevantes, es decir, impresiones de anuncios o clics en el anuncio.

Métodos de registro

Para registrar activadores, usa elementos HTML o llamadas de JavaScript:

• Etiqueta <a>
• Etiqueta <img>
• Etiqueta <script>
• fetch llamada
• XMLHttpRequest
• window.open

Esto genera solicitudes de red a las que luego respondes con un encabezado de respuesta HTTP de registro del activador.

Registra un activador para atribuir una conversión

Registrar un activador es similar a registrar un evento de la fuente de atribución. Los pasos completos se describen más adelante. Este es el resumen:

1. Inicia el registro del activador. Usa un píxel o una llamada a fetch() para hacer una solicitud.

2. Para completar el registro del activador, responde con el encabezado de registro del activador.
   
   

   Después de recibir la solicitud de píxel, enviada al extremo definido en el atributo src habitual o al extremo definido en attributionsrc si elegiste usar attributionsrc y darle un valor, responde con el encabezado Attribution-Reporting-Register-Trigger.
   
   

   En este encabezado, especifica los datos del activador que deseas que se muestren en los informes. Cualquier respuesta puede establecer este encabezado. Siempre que sea una respuesta a una solicitud realizada desde un sitio que coincide con destination, las fuentes coincidirán. Cuando se recibe el encabezado, el navegador busca fuentes que coincidan y programa un informe.

   Ejemplo de informes a nivel del evento:

   {
     "event_trigger_data": [{
       "trigger_data": "[unsigned 64-bit integer]",
       "priority": "[signed 64-bit integer]",
       "deduplication_key": "[unsigned 64-bit integer]"
     }]
   }
   ```
   
   **Example for summary reports:**
   
   ```json
   {
     ... // existing fields, such as "event_trigger_data"
   
     "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": ["campaignCounts"]
      },
      {
        "key_piece": "0xA80",
        "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
      }
     ],
     "aggregatable_values": {
       "campaignCounts": 32768,
       "geoValue": 1664
     }
   }
   ```
   

Nota: Cuando el navegador recibe una respuesta de activador de atribución de una URL de Attributionsrc en una página determinada, se realiza una búsqueda de almacenamiento local para encontrar una fuente que coincida con el origen de Attributionsrc y el eTLD+1 de la URL de esa página. <br> Si se encuentran varias fuentes, el navegador selecciona la que se almacenó más recientemente (a menos que las fuentes tengan prioridades diferentes, y en este caso el navegador elegirá la que tenga mayor prioridad).

Cómo abordar subdominios

Si destination es https://advertiser.example, se pueden atribuir las conversiones en https://advertiser.example y sus subdominios, como https://shop.advertiser.example.

Si destination es https://shop.advertiser.example, se pueden atribuir las conversiones en https://advertiser.example y https://shop.advertiser.example.

Atributos obligatorios y opcionales

A medida que usas elementos HTML o haces llamadas de JavaScript para registrar activadores, es posible que debas usar attributionsrc o attributionReporting. Consulta la siguiente tabla para obtener detalles sobre cuándo se requieren.

Si attributionsrc es opcional, usarlo indica que la solicitud es apta para Attribution Reporting. Si usas attributionsrc, el navegador envía el encabezado Attribution-Reporting-Eligible. También es útil para la medición de app a Web: si attributionsrc está presente, el navegador envía el encabezado Attribution-Reporting-Support.

Método de registro	Activador
Etiqueta <a>	N/A Las anclas no pueden registrar un activador.
Etiqueta <img>	attributionsrc es opcional. El encabezado es suficiente para registrar un activador.
Etiqueta <script>	attributionsrc es opcional. El encabezado es suficiente para registrar un activador.
fetch llamada	La opción attributionReporting es obligatoria.
XMLHttpRequest	La opción attributionReporting es obligatoria.
window.open()	N/A window.open no puede registrar un activador.

Paso 1: Inicia el registro del activador

Puedes registrar un activador con un píxel (etiqueta <img>) o una etiqueta de secuencia de comandos.

Con un píxel de conversión nuevo o existente

<img src="https://ad-tech.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

Punto clave: * El origen de src debe coincidir con el origen que realizó el registro de la fuente. * Una atribución solo se puede activar en una página cuyo eTLD+1 coincida con el sitio que se proporcionó en el destino cuando se registró la fuente.

Cómo usar una etiqueta de secuencia de comandos

Puedes realizar el registro del activador con una etiqueta de secuencia de comandos, que se comporta de manera idéntica a <img>. En las siguientes muestras de código, se ilustra el uso de fetch() y XMLHttpRequest() (XHR).

Este código simula de forma efectiva lo que haría una solicitud HTML con attributionsrc:

// With fetch
const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

// With XMLHttpRequest:
const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

const req = new XMLHttpRequest();
  req.open('GET', url);
  req.setAttributionReporting(
      attributionReporting);
  req.send();

Punto clave: El origen de <code>src</code> debe coincidir con el origen que realizó el registro de la fuente. - Una atribución solo se puede activar en una página cuyo <a href="https://web.dev/same-site-same-origin/#%22schemeful-same-site%22">eTLD+1</a> coincida con el sitio que se proporcionó en <code>destination</code> al momento del registro de la fuente.

attributionsrc con o sin un valor

Puedes agregar attributionsrc con o sin un valor.

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!--With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

Si estableces un valor para attributionsrc, debe ser una sola URL.

Usar una URL hace que el navegador inicie una solicitud de recuperación de keepalive independiente, una para cada URL, que incluye el encabezado de solicitud Attribution-Reporting-Eligible.

Esto es útil si deseas realizar el registro de la fuente respondiendo a una solicitud independiente de la solicitud principal del elemento.

Por ejemplo, si necesitas registrar fuentes de clics en un elemento de anclaje, es posible que en realidad no tengas el control del destino; en este caso, querrás una configuración en la que envíes el encabezado de registro de origen como respuesta a una solicitud que sea independiente de la navegación y que puedas controlar por completo. Si especificas un valor explícito para attributionsrc, le indicas al navegador que realice esa solicitud adicional y configure su destino.

Paso 2: Responde con un encabezado

Cuando recibas la solicitud del navegador, responde e incluye en tu respuesta el encabezado Attribution-Reporting-Register-Trigger:

JSON.stringify({event_trigger_data: [{
      trigger_data: '412444888111012',
      // Optional
      priority: '1000000000000',
      deduplication_key: '2345698765'
    }], debug_key: '1115698977'})

Precaución: El valor del campo event_trigger_data debe anidarse entre corchetes porque el navegador espera un array JSON. Esto es útil para los filtros.

Próximos pasos

Obtén información para registrar fuentes de atribución.