Integrazione · destinazione
Microsoft Advertising
Tag UET più Microsoft Conversions API (capi.uet.microsoft.com) con ID evento condivisi, identificatori in hash e segnali di consenso.
Come gli eventi raggiungono Microsoft Ads
Ogni percorso finisce nello stesso punto: il motore delle policy verifica la finalità di consenso richiesta da questa destinazione, rimuove ciò che non può uscire e il worker consegna con l’ID evento condiviso.
- Tag browser: caricato dallo snippet di Track dopo il consenso; lo script del vendor non risiede mai nel tuo template e non viene mai caricato senza la finalità richiesta.
- API server: consegna tramite il worker con retry, health check, classificazione degli errori e un’anteprima del payload con dati oscurati per ogni tentativo.
- Conversioni offline: gli eventi server contrassegnati come offline (opportunità CRM, ordini telefonici, acquisti in negozio) raggiungono questa piattaforma con l’origine di azione offline del vendor.
- Ibrido: tag browser e richiesta server condividono un unico ID evento; la piattaforma deduplica su eventId.
Cosa viene inviato
Solo ciò che configuri nella mappatura degli eventi, e solo dopo che il motore delle policy ha autorizzato l’evento per questa destinazione.
- Nome dell’evento e timestamp, mappati dagli eventi standard di Track ai nomi evento della piattaforma.
- L’ID evento condiviso nel campo eventId della piattaforma, così le consegne browser e server contano una sola volta.
- Click ID che questa piattaforma può ricevere: msclkid. I click ID di altri fornitori non vengono mai inoltrati.
- ID ordine, valore, valuta e articoli per gli eventi di tipo acquisto.
- Identificatori con hash SHA-256 (e-mail, telefono, ID esterno) per il matching, solo con il consenso richiesto e solo se acquisiti.
- Lo stato del consenso con cui l’evento è stato raccolto, dove la piattaforma accetta segnali di consenso.
Mai inviato
- Indirizzi e-mail, numeri di telefono o nomi in chiaro: gli identificatori vengono sottoposti a hash all’ingresso.
- Valori dedotti: ciò che è sconosciuto resta sconosciuto, niente viene indovinato.
- Eventi raccolti senza la finalità richiesta da questa destinazione.
- Secret: i token vivono nel vault cifrato e non raggiungono mai il browser, l’assistente o un log.
Fatti tecnici
- Campo di deduplicazione
eventId— eventId (UET + CAPI)- Click ID
msclkid- Finalità di consenso
- Marketing
- Versione API bloccata
v1- Stato dell’implementazione
- Implementata · verificata sulla documentazione del vendor · verificata il 2026-09-03
- Documentazione del vendor
- Documentazione API di Microsoft Ads
Cosa ti serve
Gli identificatori pubblici possono essere inseriti in chat o nella procedura guidata; i secret passano dalla scheda credenziali sicura o da OAuth e vengono salvati cifrati.
Identificatori pubblici
- uet_tag_id
- ID tag UET
Credenziali
- Token di accesso API
access_token— salvato nel vault cifrato
Consenso
Richiede la finalità marketing. Senza di essa niente viene caricato nel browser e niente viene inviato dal server. Il consenso dedotto non viene mai esportato e gli opt-out tramite Global Privacy Control bloccano la consegna.
Configurazione in pochi passaggi
L’assistente esegue i controlli di dettaglio. Tu vedi le tappe che richiedono una tua decisione.
Inserisci gli identificatori
Aggiungi gli ID pubblici della piattaforma. I formati vengono validati sulla documentazione del vendor prima di salvare qualsiasi cosa.
Collega le credenziali
Incolla il token nella scheda sicura o collega l’account via OAuth. I secret finiscono direttamente nel vault cifrato.
Mappa e testa
Gli eventi standard sono già mappati ai nomi evento della piattaforma. Un evento di test contrassegnato percorre la pipeline reale e mostra la risposta del vendor.
Pubblica
Controlla il diff, approva, pubblica una versione di configurazione firmata. Se serve, torna indietro con un clic.
Da Tracking Knowledge
Guide scritte dal team che sviluppa questo connettore.
Microsoft Advertising Conversions API: tag UET più eventi server con msclkid
Come funziona la Microsoft Advertising Conversions API accanto al tag UET — l'endpoint degli eventi per ID del tag, la deduplicazione tramite eventId, msclkid e identificatori con hash, i limiti dei batch e la gestione degli errori riga per riga.
Tutorial · 3 min di lettura
Una deduplicazione che regge alla realtà: ID evento, ID ordine e su quale chiave si basa davvero ogni piattaforma
Una tabella piattaforma per piattaforma delle chiavi di deduplicazione — Meta, Google Ads, GA4, TikTok, Microsoft, LinkedIn, Pinterest, Snapchat, Reddit, X, CM360 — e la strategia a due chiavi che mantiene onesto il tracking ibrido.
Riferimento · 4 min di lettura
Click ID e finestre di attribuzione: quali parametri acquisire, per quanto conservarli e dove salvarli
Una guida di riferimento ai click ID pubblicitari (gclid, gbraid, wbraid, dclid, msclkid, fbclid, ttclid, li_fat_id, rdt_cid, epik, ScCid, twclid, tblci, ob_click_id, ID affiliate), a come il consenso ne regola l'acquisizione, a come le finestre di attribuzione cambiano da piattaforma a piattaforma e a come dovrebbe scadere lo storage first-party.
Riferimento · 4 min di lettura
Domande
Posso usare solo la modalità server?
Sì. Scegli la modalità server nella procedura guidata; lo script del vendor non viene mai caricato e il matching si basa su identificatori con hash e click ID acquisiti dal tracker.
Come vengono evitati i duplicati?
Il tag browser e la richiesta server trasportano lo stesso ID evento e gli acquisti aggiungono l’ID ordine. Il worker deduplica inoltre gli eventi sorgente ripetuti prima della consegna.
E se l’API del vendor cambia?
Le versioni API sono bloccate centralmente con la data di verifica; gli avvisi di dismissione compaiono nello stato di salute della destinazione molto prima che un endpoint venga ritirato.
Collega Microsoft Ads
Configura l’integrazione con la procedura guidata o lascia che l’assistente lo faccia in chat.