Registra activadores de atribución

Obtén información para registrar activadores de atribución para registrar tus conversiones.

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

Si sigues los pasos que se indican en este documento, podrás registrar activadores para registrar las conversiones que el navegador atribuirá a los eventos de fuentes relevantes, es decir, impresiones de anuncios o 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 debes responder con un encabezado de respuesta HTTP de registro de activador.

Registra un activador para atribuir una conversión

Registrar un activador es similar a lo siguiente: registrar un evento de 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. Completa el registro del activador respondiendo con el activador encabezado de registro.

   Después de recibir la solicitud de píxel, que se envía al extremo definido en el atributo src habitual o al extremo definido en attributionsrc si decidiste usar attributionsrc y le proporcionaste un valor; responde con el encabezado Attribution-Reporting-Register-Trigger

   En este encabezado, especifica los datos del activador que quieres que se muestren. en última instancia. Cualquier respuesta puede establecer este encabezado. Siempre y cuando sea un respuesta a una solicitud realizada desde un sitio que coincide con destination, y 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]"
     }]
   }
   

   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
     }
   }
   

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 sitio de origen y destino de attributionsrc al que pertenece esa página. Si se encuentran varias fuentes, el navegador elige la que se almacenó más recientemente, a menos que las fuentes tengan prioridades diferentes, y el navegador elegirá la que tenga la mayor prioridad.

Cómo tratar con subdominios

Si el valor de destination es https://advertiser.example, las conversiones de ambas Se pueden atribuir https://advertiser.example y sus subdominios, como https://shop.advertiser.example.

Si el valor de destination es https://shop.advertiser.example, las conversiones en https://advertiser.example y Se puede atribuir https://shop.advertiser.example.

Atributos obligatorios y opcionales

Cuando 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 como en los productos necesarios.

Si 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 transición de app a Web medición: Si attributionsrc está presente, el navegador envía el Encabezado Attribution-Reporting-Support.

Método de registro	Activador
Etiqueta <a>	N/A: Los 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 obligatorio
XMLHttpRequest	La opción attributionReporting es obligatorio
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

En el siguiente ejemplo, se agrega el atributo attributionsrc para activar la atribución en una imagen existente.

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 agrega un nuevo atributo attributionsrc de píxel de conversión para activar la atribución.

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

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

Punto clave: En ambos casos, una atribución solo se puede activar en una página cuyo sitio coincida con el sitio que se proporcionó en el destino al registrar la fuente.

Cómo usar una etiqueta de secuencia de comandos

Puedes realizar el registro del activador con una etiqueta de secuencia de comandos. 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 eficaz lo que haría una solicitud HTML con attributionsrc:

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 });

de

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

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

Punto clave:

• El origen o el url configurados en fetch() o open() deben coincidir con el origen que realizó el registro de la fuente.
• Una atribución solo se puede activar en una página cuyo sitio coincida con el sitio que se proporcionó en el destino al registrar 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, 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 la solicitud Attribution-Reporting-Eligible encabezado.

Esto es útil si deseas realizar el registro del activador respondiendo a un independiente de la principal del elemento.

Por ejemplo, si necesitas registrar activadores en un elemento de imagen es posible que, en realidad, no tenga el control de la respuesta de la imagen. en este caso, querrás una configuración mediante la cual envías el encabezado de registro del activador como una respuesta a una solicitud independiente de la imagen y que se puede controlar por completo. De si especificas un valor explícito para attributionsrc, le indicarás a la para realizar la solicitud adicional y configurar 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 estar anidado entre corchetes, ya que 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.