Carica gli agenti IA di ASDK con Google Tag Manager

Google Tag Manager permette a un team marketing di aggiungere script a un sito senza aspettare uno sviluppatore. Se il tuo sito carica già un container di Tag Manager, puoi aggiungere gli agenti IA di ASDK come hai aggiunto gli analytics: un tag, un attivatore, pubblica. Nel codice del sito non cambia nulla, e puoi mettere in pausa o rimuovere gli agenti da Tag Manager in qualsiasi momento.

Cosa ottieni tramite Tag Manager

Tag Manager decide solo quando si carica lo script di ASDK. Tutto il resto funziona esattamente come con qualsiasi altra installazione: ASDK costruisce un’unica base di conoscenza dalle tue pagine pubbliche e dai documenti, e ogni agente che attivi nella dashboard risponde da lì.

• Chat (accesso anticipato, dal piano Free) risponde ai visitatori con i tuoi contenuti, linka le pagine da cui viene ogni risposta e si offre di raccogliere i recapiti quando non può aiutare.
• Sales (accesso anticipato, dal piano Pro) fa le domande di qualifica che scrivi in parole semplici e propone una riunione ai visitatori in target.
• Agent-Ready (accesso anticipato, dal piano Free) pubblica ciò che sa la tua base di conoscenza in formati che gli assistenti IA leggono bene.
• Search arriverà prossimamente. Risponderà al posto di una casella di ricerca, con le fonti.

Cambiare in seguito agenti, colori o testi avviene nella dashboard di ASDK. Per questo non ti serve una nuova versione in Tag Manager.

Quando Tag Manager è la scelta giusta

Tag Manager è adatto quando il tuo team marketing gestisce già lì gli script e i tuoi sviluppatori preferiscono così. Non è obbligatorio: incollare lo snippet nel template del sito funziona altrettanto bene ed è più facile da tenere sotto controllo.

• Scegli Tag Manager se il container si carica già su ogni pagina, se vuoi la cronologia delle versioni e una modalità di anteprima per ogni modifica, o se pubblicare una modifica al codice richiede settimane.
• Scegli il template o il tema se il tuo sito non usa ancora Tag Manager, se uno strumento di consenso blocca Tag Manager per molti visitatori o se la tua piattaforma ha un’impostazione per il codice personalizzato più semplice. Le guide per piattaforma coprono ogni opzione.

In ogni caso, non caricare ASDK in entrambi i modi sulla stessa pagina.

Due modi per aggiungerlo

Tag HTML personalizzato

Funziona oggi in qualsiasi container. La pagina Install della dashboard ha una scheda Google Tag Manager con un codice come questo, già compilato con l’ID del tuo sito:

<script>
  window.asdkConfig = { siteId: "SITE_ID" };
</script>
<script async src="https://cdn.asdk.com/v1/asdk.js"></script>

I tag manager inseriscono gli script in un modo che può far perdere gli attributi data-, quindi questa versione passa l’ID del sito in window.asdkConfig, che il widget legge. La pagina di aiuto di Google sui tag personalizzati descrive il tipo di tag Custom HTML (verificato a ottobre 2026).

Il template del tag ASDK

Un template di tag trasforma il codice in un modulo con dei campi, più facile da controllare e più difficile da rompere. Il template di ASDK arriverà prossimamente nella Community Template Gallery di Tag Manager. I template lì vengono pubblicati da un repository GitHub pubblico con licenza Apache 2.0 e un file di metadati, e Tag Manager avvisa gli utenti quando un template che usano ha un aggiornamento, secondo la documentazione della gallery di Google (verificato a ottobre 2026). Se hai già il file del template, puoi importarlo in Templates → Tag Templates → New.

Configura ASDK con un tag HTML personalizzato

Cosa è disponibile e cosa arriverà presto

ASDK nel suo insieme è in accesso anticipato: gli agenti funzionano e puoi usarli, ma possono cambiare mentre li miglioriamo.

Dettagli di Tag Manager da conoscere

• Come funziona qui la verifica dell’installazione. Quando lo aggiunge Tag Manager, lo snippet non è nell’HTML della pagina. La verifica della dashboard riconosce il tuo container e aspetta il segnale del widget dal tuo sito, quindi apri una pagina dopo la pubblicazione.
• Impostazioni di consenso. Se usi le impostazioni di consenso di Tag Manager, indica ciò che serve al tag ASDK in Advanced Settings → Consent Settings del tag. Il widget non imposta cookie; conserva un ID visitatore casuale nel local storage. Decidi la categoria con chi si occupa della privacy del tuo sito. Vedi consent manager.
• Solo su alcune pagine. Un attivatore diverso da All Pages limita dove compare il widget, per esempio solo sulle pagine dei prezzi e dei prodotti. Gli agenti rispondono comunque da tutta la tua base di conoscenza.
• Content Security Policy. Se il tuo sito invia una policy, deve consentire https://cdn.asdk.com per gli script e https://api.asdk.com per le connessioni, così come consente Tag Manager stesso. Vedi Content Security Policy.
• Una sola copia per pagina. Se ASDK è incollato anche nel template del sito, rimuovi una delle due copie. La seconda viene ignorata, ma costa una richiesta.

Chiamare il widget da altri tag

Le configurazioni di Tag Manager reagiscono spesso agli eventi della pagina. Il widget aggiunge una funzione globale asdk, così un altro tag può aprire la chat, per esempio dopo che un visitatore ha passato un po’ di tempo sulla pagina dei prezzi:

<script>
  window.asdk = window.asdk || function () { (asdk.q = asdk.q || []).push(arguments); };
  asdk("open");
</script>

La prima riga mette in coda le chiamate fatte prima che il widget sia caricato. Usalo con moderazione: una chat che si apre da sola su ogni pagina dà fastidio. La nostra guida su come qualificare i lead senza infastidire i visitatori spiega quando i messaggi proattivi aiutano e quando danneggiano.