Registra activadores de atribución

Obtén más información para registrar activadores de atribución y contabilizar tus conversiones.

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

Si sigues los pasos que se indican en este documento, podrás registrar activadores para registrar las conversiones que el navegador luego atribuirá a los eventos de origen pertinentes, es decir, las impresiones o los clics en anuncios.

Métodos de registro

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

• Etiqueta <img>
• Etiqueta <script>
• fetch llamada
• XMLHttpRequest

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 fuente de atribución. Los pasos completos se describen más adelante. Aquí tienes el resumen:

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

2. Completa el registro del activador respondiendo con el encabezado de registro del activador.

   Cuando recibas la solicitud de píxel (que se envía al extremo definido en el atributo src habitual o al extremo definido en attributionsrc si elegiste usar attributionsrc y le asignaste un valor), responde con el encabezado Attribution-Reporting-Register-Trigger.

   En este encabezado, especifica los datos del activador que deseas que aparezcan en los informes. Cualquier respuesta puede establecer este encabezado. Siempre y cuando sea una respuesta a una solicitud realizada desde un sitio que coincida con destination, se encontrarán coincidencias de las fuentes. Cuando se recibe el encabezado, el navegador busca fuentes coincidentes 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]"
     }]
   }
   

   Ejemplo de informes de resumen:

   {
     ... // 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
     }
   }
   

Cómo trabajar con subdominios

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

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

Atributos obligatorios y opcionales

A medida que uses elementos HTML o realices 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.

Cuando attributionsrc es opcional, su uso 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 la transición de la app a la Web: si attributionsrc está presente, el navegador envía el encabezado Attribution-Reporting-Support.

Paso 1: Inicia el registro del activador

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

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

En el siguiente ejemplo, se activa la atribución en una imagen existente agregando el atributo attributionsrc.

El origen de attributionsrc debe coincidir con el origen que realizó el registro de la fuente.

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

En el siguiente ejemplo, se activa la atribución agregando un nuevo atributo attributionsrc de píxel de conversión.

El origen de src debe coincidir con el origen que realizó el registro de la fuente.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Usa una etiqueta de secuencia de comandos

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

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

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

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

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

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

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, puede ser una o más URLs separadas por espacios.

El uso de 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 registrar el activador respondiendo a una solicitud que es independiente de la solicitud principal del elemento.

Por ejemplo, si necesitas registrar activadores en un elemento de imagen, es posible que no tengas el control de la respuesta de la imagen. En este caso, te convendrá una configuración en la que envíes el encabezado de registro del activador como respuesta a una solicitud independiente de la imagen y que puedas controlar por completo. Si especificas un valor explícito para attributionsrc, le indicas al navegador que realice esa solicitud adicional y configuras su destino.

Paso 2: Responde con un encabezado

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

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

Próximos pasos

Obtén más información para registrar fuentes de atribución.