Come installare il codice magnews sul tuo sito

Il codice magnews è lo script che collega il tuo sito a magnews e permette alla proprietà web di funzionare sulle pagine in cui viene installato.

Quando un visitatore apre una pagina che contiene il codice magnews, lo script comunica con la piattaforma. 
In base alla configurazione della proprietà web, può - ad esempio - mostrare messaggi on site e moduli di iscrizione, registrare le attività dei visitatori e inviare i dati raccolti a magnews.

In pratica:

• La proprietà web definisce impostazioni e funzionalità disponibili per il sito
• Il codice magnews permette al sito e a magnews di comunicare
• Le pagine in cui il codice viene caricato possono essere tracciate e mostrare banner e popup
• Le pagine senza codice magnews non sono collegate a magnews

Questa distinzione è utile se vuoi collegare a magnews solo alcune pagine del sito, ad esempio un'area di iscrizione o una sezione dedicata a un servizio specifico.

Puoi installare il codice magnews in due modi:

• Manualmente nel codice del sito
• Tramite Google Tag Manager

Quale metodo scegliere? 

La scelta dipende da come è gestito il tuo sito e da quanta autonomia vuoi avere nel tempo.

• L'installazione manuale è adatta se il sito ha poche pagine, se hai accesso diretto al codice e se vuoi inserire il codice magnews solo in punti specifici. È una buona scelta per siti semplici o per installazioni gestite direttamente da uno sviluppatore
• Google Tag Manager è più indicato se il sito ha molte pagine, se lo usi già o se vuoi evitare modifiche dirette al codice del sito. È la scelta più flessibile per i team marketing, perché permette di gestire da GTM dove caricare il codice magnews, dove escluderlo e come adattare l'integrazione nel tempo

Dove trovare il codice magnews

Il codice magnews è sempre collegato a una proprietà web: prima di installarlo, devi avere una proprietà web esistente oppure crearne una.

Se hai già creato una proprietà web, apri la home della proprietà e recupera il codice dal pulsante Integra nel tuo sito, se la proprietà non è ancora attiva, o Codice e verifica, se la proprietà è già attiva.

Se non hai ancora nessuna proprietà web, puoi crearne una nuova o partire dalla pagina dei moduli di iscrizione o dei messaggi on site del tuo journey e fare clic su Collega il tuo sito.

Quando colleghi il sito da un modulo di iscrizione o da un messaggio on site, ad esempio in fase di attivazione, magnews ti guida in una procedura in tre step. Trovi il codice magnews nel secondo passaggio, subito dopo aver inserito l'URL del sito da collegare.

Installare il codice manualmente

Copia il codice magnews della proprietà web che vuoi integrare e, se hai accesso al codice HTML del sito, incollalo nelle pagine in cui vuoi usare la proprietà web, subito prima del tag </head>.

Se non gestisci direttamente il sito, invia il codice magnews al team di sviluppo o alla persona che si occupa dell'integrazione.

Il codice magnews funziona solo nelle pagine in cui viene caricato: se vuoi usare la proprietà web su tutto il sito, assicurati che il codice sia presente in tutte le pagine. 

Quando aggiungi nuove pagine, dovrai inserirlo anche nel loro HTML.

Verificare l'installazione manuale

Dopo aver installato manualmente il codice, puoi verificare se magnews lo rileva correttamente.

Puoi eseguire la verifica:

• Dal secondo step della procedura guidata, quando colleghi il sito durante l'attivazione del primo messaggio on site o modulo di iscrizione
• Dalla home della proprietà web, usando Integra nel tuo sito se la proprietà non è ancora attiva o Codice e verifica se la proprietà è già attiva

Dopo la verifica, magnews mostra un feedback positivo se trova il codice sul sito o un feedback negativo se non riesce a rilevarlo.

La verifica cerca il codice magnews solo sul dominio principale della proprietà web e solo se il dominio non contiene wildcard. 

Puoi forzare l'attivazione della proprietà web anche se non esegui la verifica o se la verifica non va a buon fine.

Installare il codice con Google Tag Manager

Puoi usare Google Tag Manager per caricare il codice magnews sul sito senza modificarne direttamente il codice HTML.

Se non lo hai mai usato, prima di installare il codice magnews:

1. Crea un account e un container in Google Tag Manager
2. Installa il codice di Google Tag Manager nelle pagine del tuo sito seguendo le istruzioni ufficiali di Google
3. Verifica che il container GTM sia pubblicato correttamente

Per configurarlo da zero, consulta la documentazione ufficiale di Google Tag Manager.

Se usi già Google Tag Manager o se il container è già installato nelle pagine del sito, puoi aggiungere direttamente il codice magnews:

1. Apri Google Tag Manager e accedi al tuo account
2. Crea un nuovo tag dal menu Tag
3. Dai un nome al tag e seleziona il tipo di tag HTML personalizzato
4. Copia il codice magnews della proprietà web che vuoi integrare
5. Incolla il codice magnews
6. Imposta come attivatore All Pages
7. Fai clic su Salva
8. Per applicare le modifiche al sito web, fai clic su Invia

Con questa configurazione, Google Tag Manager carica il codice magnews su tutte le pagine in cui è presente il container GTM.

Se vuoi usare configurazioni particolari, ad esempio attivatori diversi da All Pages o esclusioni su pagine specifiche, consulta la documentazione ufficiale di Google Tag Manager.

Esempi

Mostrare un popup solo su una pagina

Immagina di gestire il sito di una concessionaria multimarca. Oltre alla vendita di automobili, offri servizi post-vendita come revisioni e tagliandi.

Per promuovere l'apertura di una nuova officina, vuoi mostrare il popup Tagliandi a metà prezzo solo nella pagina Servizi del sito.

Per farlo, installa il codice magnews nelle pagine in cui vuoi usare la proprietà web:

• Se usi Google Tag Manager, crea un tag HTML personalizzato con il codice magnews e usa l'attivatore All Pages
• Se installi il codice manualmente, inseriscilo in tutte le pagine in cui vuoi poter mostrare messaggi on site o tracciare i visitatori

Poi, in magnews:

1. Crea il messaggio on site
2. Configura una regola di visualizzazione basata sull'URL, ad esempio con la regola Pagina attuale e la condizione URL contiene servizi
3. Attiva il messaggio on site

In questo modo:

• Nella Home e nelle altre pagine il codice magnews viene caricato, ma il popup non viene mostrato
• Nella pagina Servizi il codice magnews viene caricato e il popup viene mostrato

Non devi creare una proprietà web diversa per ogni popup. Puoi usare la stessa proprietà web e controllare la visualizzazione di messaggi on site e moduli di iscrizione tramite le regole che trovi nelle impostazioni.

Escludere una pagina dal monitoraggio

Se non vuoi tracciare i visitatori che aprono una certa pagina, devi evitare che il codice magnews venga caricato su quella pagina.

Ad esempio, potresti scegliere di non caricare il codice magnews nella pagina Privacy e cookie policy, perché di solito non è utile per segmentare i contatti, mostrare messaggi personalizzati o misurare conversioni.

Con l'installazione manuale, è sufficiente non inserire il codice magnews nell'HTML della pagina. Con Google Tag Manager, invece, devi configurare il tag in modo che non venga eseguito su quell'URL.

Ricorda che le regole dei messaggi on site controllano quando mostrare un messaggio, ma non impediscono il caricamento del codice magnews.

Controllare se la proprietà web funziona

Dopo aver installato il codice magnews nel tuo sito, puoi controllare se la proprietà web sta ricevendo dati in due modi:

• Controlla lo stato della proprietà web
  Apri la home della proprietà web e verifica lo stato dell'integrazione: se magnews riceve eventi dal sito, significa che il codice sta comunicando correttamente con la piattaforma. Se invece non vengono registrati eventi, vedrai uno stato di attesa oppure un avviso dopo 48 ore senza attività

• Simula la visita di un contatto riconosciuto
  Per verificare che le visite vengano associate correttamente ai contatti riconosciuti, invia una comunicazione al tuo indirizzo email, associato a un contatto presente in un database di magnews.
  Inserisci nella comunicazione un link a una pagina del sito in cui è installato il codice magnews.
  Dopodiché, apri la comunicazione, fai clic sul link e poi apri la scheda del contatto in magnews: nella sezione Web tracking dovresti vedere l'inizio di una nuova sessione web

Se qualcosa non funziona

Se hai installato il codice magnews ma la proprietà web non riceve eventi, il messaggio on site non viene visualizzato o il modulo di iscrizione non appare sul sito, consulta la pagina di risoluzione dei problemi più comuni.