Questa pagina è stata tradotta dall'API Cloud Translation.

Registra gli attivatori di attribuzione

Scopri come registrare gli attivatori di attribuzione per conteggiare le conversioni.

Un attivatore di attribuzione è l'evento che indica al browser di acquisire le conversioni.

Seguendo la procedura descritta in questo documento, puoi registrare gli attivatori per registrare le conversioni che il browser attribuirà poi agli eventi di origine pertinenti, cioè le impressioni degli annunci o i clic sugli annunci.

Metodi di registrazione

Per registrare i trigger, utilizza elementi HTML o chiamate JavaScript:

Tag <img>
Tag <script>
fetch chiamata
XMLHttpRequest

In questo modo vengono generate richieste di rete a cui rispondi con un'intestazione di risposta HTTP della registrazione trigger.

Registra un attivatore per attribuire una conversione

La registrazione di un trigger è simile alla registrare un evento di origine di attribuzione. I passaggi completi sono descritti più avanti. Ecco il riepilogo:

Avvia la registrazione dell'attivatore. Usa un pixel o una chiamata fetch() per effettuare una richiesta.
Completa la registrazione dell'attivatore rispondendo con l'attivatore intestazione registrazione.

Dopo aver ricevuto la richiesta di pixel, inviata al endpoint definito nel consueto attributo src o all'endpoint definito in attributionsrc se hai scelto di usare attributionsrc e gli hai fornito un valore, rispondi con l'intestazione Attribution-Reporting-Register-Trigger.

In questa intestazione, specifica i dati del trigger che devono essere visualizzati report in ultima analisi. Questa intestazione può essere impostata da qualsiasi risposta. Purché si tratti di un risposta a una richiesta effettuata da un sito che corrisponde a destination, le fonti corrispondenti. Quando l'intestazione viene ricevuta, Il browser cerca le origini corrispondenti e pianifica un report.

Esempio di report a livello di evento:
```
{
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}
```
Esempio per i report di riepilogo:
```
{
  ... // 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
  }
}
```

di Gemini Advanced.

Nota: quando il browser riceve una risposta all'attivatore di attribuzione da un URL attributionsrc su una determinata pagina, viene eseguita una ricerca nello spazio di archiviazione locale per trovare un'origine che corrisponda sia all'origine attributionsrc sia al sito di destinazione a cui appartiene la pagina. Se vengono trovate più origini, il browser sceglie quella archiviata più di recente, a meno che le fonti non abbiano priorità diverse, in cui il browser sceglie quella con la priorità maggiore.

Gestire i sottodomini

Se destination è https://advertiser.example, le conversioni su entrambi È possibile attribuire https://advertiser.example e i relativi sottodomini, come https://shop.advertiser.example.

Se destination è https://shop.advertiser.example, le conversioni sia su https://advertiser.example che su È possibile attribuire https://shop.advertiser.example.

Attributi obbligatori e facoltativi

Quando utilizzi elementi HTML o effettui chiamate JavaScript per registrare i trigger, potrebbe essere necessario usare attributionsrc o attributionReporting. Consulta la tabella seguente per maggiori dettagli su quando vengono obbligatorio.

Quando attributionsrc è facoltativo, il suo utilizzo indica che la richiesta è idonea per Attribution Reporting. Se utilizzi attributionsrc, il browser invia l'errore Intestazione Attribution-Reporting-Eligible. È utile anche per il passaggio misurazione: se è presente attributionsrc, il browser invia Intestazione Attribution-Reporting-Support.

Metodo di registrazione	Trigger
Tag `<a>`	N/D: gli ancoraggi non possono registrare un trigger.
Tag `<img>`	`attributionsrc` è facoltativo. L'intestazione sia sufficiente per registrare un trigger.
Tag `<script>`	`attributionsrc` è facoltativo. L'intestazione sia sufficiente per registrare un trigger.
`fetch` chiamata	L'opzione `attributionReporting` è obbligatorio.
`XMLHttpRequest`	L'opzione `attributionReporting` è obbligatorio.
`window.open()`	N/D: `window.open` non può registrare un attivatore.

Passaggio 1: avvia la registrazione dell'attivatore

Puoi registrare un attivatore utilizzando un pixel (tag <img>) o un tag script.

Utilizzo di un pixel di conversione nuovo o esistente

Il seguente esempio attiva l'attribuzione su un'immagine esistente aggiungendo l'attributo attributionsrc.

L'origine di attributionsrc deve corrispondere all'origine che ha eseguito la registrazione dell'origine.

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

Il prossimo esempio attiva l'attribuzione aggiungendo un nuovo attributo del pixel di conversione attributionsrc.

L'origine di src deve corrispondere all'origine che ha eseguito la registrazione dell'origine.

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

Utilizzo di un tag script

Puoi eseguire la registrazione del trigger con un tag script; si comporta in modo identico a <img>. I seguenti esempi di codice illustrano l'utilizzo di fetch() e XMLHttpRequest() (XHR).

Questo codice simula in modo efficace ciò che fa una richiesta 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 senza un valore

Puoi aggiungere attributionsrc con o senza un valore.

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

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

Se imposti un valore per attributionsrc, il valore può essere costituito da uno o più URL separati da spazi.

Se utilizzi un URL, il browser avvia una richiesta di recupero keepalive separata: per ogni URL, che include la richiesta Attribution-Reporting-Eligible intestazione.

È utile se vuoi effettuare la registrazione del trigger rispondendo a un separata da quella principale dell'elemento.

Ad esempio, se devi registrare i trigger su un elemento immagine, potresti non avere il controllo della risposta dell'immagine; In questo caso ti consigliamo di una configurazione in cui invii l'intestazione della registrazione del trigger in risposta a una richiesta separato dall'immagine e che puoi controllare completamente. Di specificando un valore esplicito per attributionsrc, indichi browser per effettuare questa richiesta aggiuntiva e configurare la sua destinazione.

Passaggio 2: rispondi con un'intestazione

Dopo aver ricevuto la richiesta del browser, rispondi e includi nella risposta l'intestazione Attribution-Reporting-Register-Trigger:

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

Attenzione:il valore del campo event_trigger_data deve essere nidificato tra parentesi quadre, perché il browser prevede un array JSON. Questo è utile per i filtri.

Passaggi successivi

Scopri come registrare le origini di attribuzione.