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
llamadaXMLHttpRequest
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 registrar un evento de fuente de atribución. Los pasos completos se describen más adelante. Este es el resumen:
- Inicia el registro del activador. Usa un píxel o una llamada a
fetch()
para realizar una solicitud. Completa el registro del activador. Para ello, responde 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 enattributionsrc
, si elegiste usarattributionsrc
y le otorgaste un valor, responde con el encabezadoAttribution-Reporting-Register-Trigger
.En este encabezado, especifica los datos del activador que quieres que se muestren finalmente en los informes. Cualquier respuesta puede establecer este encabezado. Siempre que se trate de una respuesta a una solicitud realizada desde un sitio que coincida con
destination
, se establecerán coincidencias con las fuentes. 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 } }
Cómo tratar con 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 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 son obligatorios.
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 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: 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 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
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>
Cómo usar una etiqueta de secuencia de comandos
Puedes realizar el registro del activador con una etiqueta de secuencia de comandos; esta 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 });
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 la solicitud Attribution-Reporting-Eligible
.
Esto es útil si deseas realizar el registro del activador respondiendo a una solicitud independiente de la solicitud principal del elemento.
Por ejemplo, si necesitas registrar activadores en un elemento de imagen, es posible que, en realidad, no tengas el control de la respuesta de la imagen. En este caso, querrás una configuración mediante la cual envíes el encabezado de registro del activador como respuesta a una solicitud que es independiente de la imagen y que puedes controlar por completo. Cuando especificas un valor explícito para attributionsrc
, le indicas al navegador que realice esa solicitud adicional y configura 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"
});
Próximos pasos
Obtén información para registrar fuentes de atribución.