Attribuzione dei clic sugli annunci per WhatsApp #

Se pubblichi annunci Meta o Google che rimandano a una pagina del tuo sito web, e quella pagina contiene un pulsante WhatsApp, DM Champ può dirti da quale clic sull’annuncio proviene ogni conversazione WhatsApp. Inserisci un piccolo script sul tuo sito web. Quando un visitatore tocca il tuo pulsante WhatsApp, il clic viene memorizzato e associato al primo messaggio che ti invia. Il contatto mostrerà quindi la campagna di provenienza e i dati del clic verranno trasmessi con il contatto nei webhook, nell’API e, se lo desideri, inviati nuovamente a Meta.

Funziona per qualsiasi pagina con un pulsante WhatsApp: una landing page, una pagina di prenotazione, una pagina dei prezzi o un quiz che termina con “Invia le mie risposte su WhatsApp”.

Questa pagina riguarda gli annunci che indirizzano le persone prima al tuo sito web. Se i tuoi annunci aprono direttamente WhatsApp (annunci “Click-to-WhatsApp” di Meta), ciò è gestito automaticamente, senza alcuno script, in Attribuzione degli annunci Click-to-WhatsApp.

Configurazione #

1. Vai su Impostazioni → Monitoraggio clic annunci (gruppo Integrazioni).
2. Fai clic su Attiva e ottieni il mio script. Il tuo account riceverà la propria chiave del sito e uno script di una riga.
3. Copia lo script e incollalo subito prima del tag di chiusura </body> in ogni pagina che contiene un pulsante WhatsApp:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. Facoltativo: in Numero WhatsApp, digita il numero a cui rimandano i tuoi pulsanti. Solo i link a quel numero verranno monitorati. Lascialo vuoto per monitorare ogni link WhatsApp sul sito.
5. Scegli la dicitura del numero di richiesta (vedi sotto) e fai clic su Salva. Non è necessario modificare lo script sul tuo sito web dopo una modifica delle impostazioni.
6. Esegui un test: apri la tua pagina da un link con un tag di campagna, ad esempio https://yoursite.com/?utm_source=test&utm_campaign=setup-check, tocca il tuo pulsante WhatsApp e invia il messaggio. Apri quel contatto in Chat: il pannello del contatto mostrerà Proveniente da un clic sull’annuncio con la campagna.

La chiave del sito è già inclusa nello script. Non è una password, quindi può essere tranquillamente inserita in una pagina pubblica.

Cosa fa lo script #

• Al caricamento della pagina, mantiene gli ID dei clic sugli annunci e i tag della campagna (i parametri utm_) dall’indirizzo della pagina nella memoria di sessione della scheda del browser, in modo che siano ancora presenti se il visitatore visualizza prima un’altra pagina. Non imposta cookie, non carica nient’altro e non invia nulla.
• Quando il visitatore tocca un link WhatsApp (wa.me, api.whatsapp.com/send o whatsapp://send), aggiunge il numero di richiesta al messaggio, registra la visita e consente al tocco di proseguire verso WhatsApp come di consueto.

Nulla viene inviato a DM Champ prima del tocco.

Il numero di richiesta #

Un breve numero, simile al riferimento che ti fornisce un negozio o una clinica, viene aggiunto al messaggio WhatsApp del visitatore. È così che DM Champ sa esattamente quale clic sull’annuncio appartiene a quale conversazione. Un messaggio appare così:

Hi, I would like to know more.
Enquiry no. 4827

• Dicitura: “N. richiesta” è l’impostazione predefinita. Puoi utilizzare qualsiasi riga di testo che suoni naturale per la tua attività, come “Rif. prenotazione” o “Rif.”. Nessuna cifra.
• Dove: Su una riga a sé stante alla fine (impostazione predefinita) o Alla fine del testo. La pagina delle impostazioni mostra un’anteprima in tempo reale.
• Lunghezza: 4 cifre, o 5 quando il tuo sito è molto trafficato.
• Il tuo agente IA non lo vede mai e non lo ripete mai. La casella di posta mostra il messaggio completo, numero incluso.

Puoi disattivare il numero di richiesta. In tal caso, la corrispondenza funzionerà solo in base al testo del messaggio; pertanto, due visitatori che inviano esattamente lo stesso testo (ad esempio le stesse risposte a un quiz) non potranno essere distinti e alcuni clic non verranno associati.

Il tuo codice per quiz o pulsanti #

Se la tua pagina genera autonomamente il messaggio WhatsApp (un quiz che inserisce le risposte nel testo o il tuo codice personalizzato per i pulsanti), aggiungi data-manual al tag script:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

Con data-manual, lo script non modifica più automaticamente i link di WhatsApp. Il tuo codice lo richiama subito prima dell’apertura di WhatsApp, in modo che ogni visita venga registrata una sola volta:

• window.ChatAttribution.text(finalText, number) restituisce il tuo testo con l’aggiunta del numero di richiesta e registra la visita. Utilizza il testo restituito nel tuo link WhatsApp.
• window.ChatAttribution.link(finalText, number) esegue la stessa operazione e restituisce un link wa.me pronto all’uso con quel testo. Ometti il numero per utilizzare quello impostato in Numero WhatsApp nelle impostazioni.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

Il ramo else mantiene il pulsante funzionante anche se lo script non è stato caricato, ad esempio quando un’estensione del browser lo blocca. Un testo che contiene già un numero assegnato dallo script non viene mai modificato una seconda volta.

Cosa viene registrato #

Al momento del clic, il registro della visita contiene:

• gli ID dei clic sugli annunci presenti nell’indirizzo della pagina, come fbclid (Meta) e gclid (Google)
• i cookie _fbc e _fbp, se il tuo pixel Meta li ha impostati sul tuo sito (lo script li legge, non li imposta mai)
• i tag della campagna (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• la pagina di destinazione, la pagina di provenienza del visitatore, il browser e il testo del messaggio
• l’indirizzo IP e l’orario, aggiunti da DM Champ all’arrivo della visita

I registri delle visite vengono conservati per 90 giorni. Quando una visita viene associata, una copia dei dati del clic viene memorizzata sul contatto e rimane associata ad esso finché non la elimini.

Informativa sulla privacy: lo script viene eseguito sul tuo sito web, pertanto l’informativa sulla privacy del tuo sito dovrebbe menzionarlo: cosa registra (l’elenco sopra) e che lo fa quando un visitatore tocca un pulsante WhatsApp.

Come funziona la corrispondenza #

Quando arriva il primo messaggio di un contatto, DM Champ cerca una visita avvenuta nei 15 minuti precedenti:

1. Prima tramite il numero di richiesta. Un messaggio che contiene un numero assegnato dallo script viene associato a quella visita.
2. Altrimenti tramite testo identico. Un messaggio con lo stesso identico testo di una visita viene associato ad essa. Quando due visitatori diversi inviano lo stesso testo entro l’intervallo di tempo, nessuno dei due viene associato, intenzionalmente, in modo che un contatto non venga mai attribuito all’annuncio sbagliato.

Anche un messaggio successivo che contiene il numero di richiesta viene associato, a condizione che il contatto non abbia ancora una corrispondenza.

Limiti:

• Vince la prima corrispondenza. Una volta che un contatto ha una corrispondenza, questa non viene mai sovrascritta.
• Solo WhatsApp: i canali WhatsApp Business API e WhatsApp Web.
• 15 minuti: un visitatore che tocca il pulsante ma invia il messaggio molto più tardi non viene abbinato.
• Solo in avanti: i contatti precedenti all’installazione dello script non hanno alcuna corrispondenza.

Dove puoi vederlo #

• Pannello contatti: Proveniente da un clic sull’annuncio con la campagna o la sorgente e la data. Passa il mouse sopra per i dettagli.
• Webhook: contact.ad_attribution nei webhook dei tag agente e in ogni evento di sottoscrizione webhook che trasporta un contatto.
• API: ad_attribution nell’elenco contatti e adAttribution su un singolo contatto, nella sezione Contatti del riferimento API.
• Strumenti MCP: lo stesso oggetto su ogni contatto che restituiscono.

Il valore è null quando il contatto non ha alcuna corrispondenza.

Invia risultati a Meta (opzionale) #

Puoi consentire a DM Champ di segnalare i risultati al tuo account pubblicitario Meta, in modo che Meta impari quali annunci portano lead e vendite reali e li ottimizzi. Questo utilizza i dettagli della tua Meta Conversions API.

1. In Meta Events Manager, trova l’ID del tuo pixel (chiamato anche dataset) in Origini dati e crea un token di accesso in Impostazioni, Conversions API, Genera token di accesso.
2. In Impostazioni → Monitoraggio clic annuncio, sotto Invia risultati a Meta (opzionale), inserisci l’ID Pixel / dataset e il Token di accesso. Durante i test puoi aggiungere il Codice evento di test dalla scheda Eventi di test di Meta; cancellalo quando hai finito. Clicca su Salva dettagli Meta.
3. Apri l’editor dell’agente, vai alla scheda Tag e apri un tag. Sotto Invia a Meta, scegli l’evento: Lead, Contatto, Appuntamento, Acquisto o un nome personalizzato. Facoltativamente, aggiungi un valore e una valuta.

Da quel momento in poi, ogni volta che quel tag viene applicato a un contatto (dall’IA, manualmente, tramite API o tramite un’automazione), DM Champ invia l’evento a Meta con i dati del clic memorizzati del contatto (fbc, fbp, indirizzo IP, browser, pagina di destinazione) più telefono, email e nome, sottoposti ad hashing, in modo che Meta possa collegarli all’annuncio. Un contatto senza corrispondenza invia comunque l’evento, solo con telefono, email e nome sottoposti ad hashing.

• Nessun doppio conteggio: ogni evento ha un id fisso composto dall’id del contatto e dal nome del tag. Se il tuo CRM invia lo stesso evento a Meta con lo stesso id, Meta ne conserva solo uno.
• Finestra di attribuzione di Meta: Meta accredita un evento a un annuncio solo all’interno della sua finestra di attribuzione, che è di 7 giorni dopo il clic per impostazione predefinita. Un accordo che si chiude settimane dopo non conterà da solo, quindi invia anche un evento precedente, ad esempio un tag per la consulenza prenotata o pagata.

FAQ #

Funziona se il mio annuncio apre direttamente WhatsApp? Quegli annunci non passano attraverso il tuo sito web, quindi lo script non viene mai eseguito. Meta invia i dettagli dell’annuncio con il primo messaggio, vedi Attribuzione annuncio Click-to-WhatsApp.

Lo script rallenta il mio sito web o imposta cookie? Si carica in background (async), non imposta cookie e non carica nient’altro. Invia qualcosa solo quando un visitatore tocca un pulsante WhatsApp.

Posso monitorare Google Ads oltre agli annunci Meta? Sì. Gli id dei clic di Google (gclid, gbraid, wbraid) e tutti i tag della campagna vengono registrati e mostrati sul contatto. L’invio dei risultati è disponibile solo per Meta.

Perché un contatto non ha ottenuto una corrispondenza? I motivi più comuni: il messaggio è arrivato più di 15 minuti dopo il tocco, il numero di richiesta è stato rimosso dal messaggio, il numero di richiesta è disattivato e un altro visitatore ha inviato lo stesso testo, o la pagina non contiene lo script.

Il mio sito web rimanda a due numeri WhatsApp. Posso monitorarne solo uno? Sì. Digita quel numero sotto Numero WhatsApp nelle impostazioni. Lascialo vuoto per monitorare ogni link WhatsApp.

Posso modificare il testo in un secondo momento? Sì. Le modifiche vengono applicate immediatamente al tuo sito web; non è necessario incollare nuovamente lo script.