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, Your AI Connector 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.youraiconnector.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 Your AI Connector 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 Your AI Connector 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.youraiconnector.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 Your AI Connector all’arrivo della visita

Quando una visita viene associata, Your AI Connector elabora anche da tali dati approssimativamente dove si trovasse il visitatore (città e paese, in modo approssimativo, dall’indirizzo IP) e quale dispositivo abbia utilizzato (telefono, tablet o computer, il sistema operativo e il browser, ad esempio il browser in-app di Instagram). La posizione rimane vuota quando non può essere determinata, il che è comune sulle reti mobili.

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, Your AI Connector 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.

Quando un contatto che ha già una corrispondenza torna tramite un altro annuncio e invia un messaggio contenente un numero di richiesta più recente, quel clic viene conservato come clic più recente del contatto. La prima corrispondenza rimane invariata.

• Primo clic, per i tuoi report: il contatto continua a mostrare da dove proveniva inizialmente il lead. Questo non cambia mai.
• Clic più recente, per Meta: gli eventi inviati a Meta utilizzano il clic più recente, poiché Meta attribuisce il merito all’annuncio che ha riportato la persona indietro e solo all’interno della sua finestra di attribuzione. Riportare un clic vecchio attribuirebbe il merito all’annuncio sbagliato, o a nessuno.
• Il clic più recente viene preso solo da un numero di richiesta, mai dal solo testo corrispondente, e una visita più vecchia non sostituisce mai una più recente.

Limiti:

• La prima corrispondenza non viene mai sovrascritta. I clic più recenti vengono inseriti nel clic più recente.
• 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 contatto: Proveniente da un clic su annuncio con la campagna o la fonte e la data del primo clic. Passa il mouse sopra per i dettagli: la campagna, l’Annuncio (utm_content) e il Gruppo di annunci (utm_term), la Posizione approssimativa e il Dispositivo, ciascuno solo quando noto, più lo stesso per l’ultimo clic quando presente. I tag della campagna mai compilati (un tocco sull’anteprima dell’annuncio invia il modello del tag invece dei nomi) vengono omessi. Una visita conta come clic su un annuncio solo quando la pagina è stata aperta da un link pubblicitario (un id clic di Meta o Google, o tag di campagna). Chiunque abbia raggiunto la pagina in altro modo, ad esempio da una ricerca Google, digitando il tuo indirizzo o cliccando sul tuo sito, vedrà Proveniente dal tuo sito web con l’indicazione della provenienza, come Ricerca Google, o Visita al sito web, nessun referrer registrato quando il browser non ha fornito informazioni.
• Pagina contatto: la stessa riga si trova sotto il nome del contatto in Contatti, così la vedi subito, anche sul telefono. Passa il mouse o tocca per i dettagli.
• Attività: la cronologia del contatto inizia con Ha toccato il tuo pulsante WhatsApp dopo un annuncio (o sul tuo sito web) al momento del clic, prima del loro primo messaggio. Il pannello contatto della chat mostra la stessa riga sotto Attività.
• 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 restituito.

Il valore è null quando il contatto non ha alcuna corrispondenza. I campi sottostanti descrivono il primo clic. Quando viene abbinato un clic successivo, latest lo contiene con gli stessi campi; è assente fino a quel momento.

Invia risultati a Meta (opzionale) #

Puoi consentire a Your AI Connector 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 il tuo ID pixel (chiamato anche dataset) sotto 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. Fai clic su Salva dettagli Meta.
3. Facoltativo: verifica la connessione. In Meta Events Manager, apri il tuo pixel e vai alla scheda Test eventi, copia il codice di test mostrato lì, incollalo sotto Invia un evento di test e fai clic su Invia evento di test. La riga sotto il pulsante indica “Meta ha ricevuto 1 evento di test” (cercala sotto Test eventi in Meta), oppure mostra il motivo di Meta in caso di rifiuto, ad esempio un token errato. Il codice viene utilizzato solo per quel test e non viene mai salvato.
4. Apri l’editor dell’agente, vai alla scheda Tag e apri un tag. Sotto Invia a Meta, scegli l’evento: Lead, Contatto, Pianificazione, 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), Your AI Connector invia l’evento a Meta con i dati del clic più recente del contatto (fbc, fbp, indirizzo IP, browser, pagina di destinazione, dal clic più recente quando presente, altrimenti il primo) più il loro numero di 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 il numero di telefono, l’email e il nome sottoposti ad hashing.

• Gli eventi live contano sempre: un codice evento di test non viene mai memorizzato con i tuoi dettagli Meta, quindi gli eventi inviati dai tuoi tag e dalle tue automazioni vanno sempre ai tuoi dati reali in Meta, mai alla scheda Test eventi.
• Nessun conteggio doppio: ogni evento ha un ID fisso composto dall’ID 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 per impostazione predefinita è di 7 giorni dopo il clic. Un affare che si conclude settimane dopo non verrà conteggiato da solo, quindi invia anche un evento precedente, ad esempio un tag per la consulenza prenotata o pagata.

Invia conversioni dalle automazioni #

Un tag invia il suo evento quando viene applicato. Quando il risultato si verifica altrove, come la chiusura di una trattativa nel tuo CRM o la prenotazione di una consulenza, utilizza l’azione Invia conversione a Meta in un’automazione. Questa azione segnala un evento al tuo dataset Meta tramite la Conversions API, in modo che Meta ottimizzi le tue inserzioni basandosi sui risultati reali e non solo sui messaggi.

Utilizza gli stessi dettagli Meta dei tag: l’ID Pixel / dataset e il Token di accesso presenti in Impostazioni → Monitoraggio clic annuncio. Senza di essi, il passaggio fallisce con il messaggio “Meta non è connesso”.

I campi

Compila almeno uno tra Contatto, Email o Telefono. La persona non deve necessariamente essere un contatto: una trattativa HubSpot che raggiunge lo stato “Chiusa vinta” può inviare un evento di tipo Purchase con l’importo della trattativa e l’email dell’acquirente.

Quando selezioni un Contatto, vengono utilizzati il suo telefono, la sua email e il suo nome. Se proviene da un clic su un annuncio che lo script ha associato, vengono inviati anche i dettagli del clic, il che aiuta Meta ad associare l’evento all’annuncio. Email, telefono e nomi vengono sottoposti ad hashing prima dell’invio. L’ID del clic, l’indirizzo IP e il browser vengono inviati come richiesto da Meta.

ID evento e conteggio doppio

Meta conteggia una sola volta gli eventi con lo stesso nome evento e lo stesso ID evento. Utilizza un ID fisso, come l’ID della trattativa, quando anche un altro strumento segnala la stessa conversione o quando l’automazione potrebbe essere eseguita due volte per essa. Lascialo vuoto per generare un nuovo ID a ogni esecuzione, in modo che ogni esecuzione venga conteggiata.

In cosa differisce dagli eventi dei tag

L’evento Invia a Meta di un tag viene inviato una volta per contatto per quel tag (al massimo una volta ogni 30 giorni). Questa azione invia l’evento ogni volta che viene eseguita. L’ID evento è ciò che impedisce a una conversione di essere conteggiata due volte.

Esempio: una trattativa chiusa e una consulenza prenotata

1. Avvia un’automazione che venga eseguita quando un affare viene vinto: un trigger App event sull’evento dell’affare del tuo CRM, con una Condition affinché procedano solo gli affari vinti. HubSpot invia eventi relativi alla fase dell’affare solo alle app per sviluppatori, quindi per HubSpot utilizza un trigger Schedule con una ricerca HubSpot per gli affari che hanno raggiunto lo stato “Chiuso vinto” dall’ultima esecuzione, e un Loop su di essi.
2. Aggiungi Send conversion to Meta. Imposta Event name su Purchase, Value sull’importo dell’affare (inseriscilo con il pulsante +) e Currency sulla tua valuta. Inserisci l’email dell’acquirente in Email e l’id dell’affare in Event ID, in modo che lo stesso affare non venga mai conteggiato due volte.
3. Per una consulenza prenotata, avvia una seconda automazione con il trigger Appointment booked e aggiungi Send conversion to Meta con Event name impostato su Schedule e il contatto dal trigger in Contact. Se lo desideri, aggiungi un secondo passaggio Send conversion to Meta che invii un Purchase con un valore fisso, come il prezzo della consulenza.

Puoi anche inviare una conversione tramite API con POST https://api.youraiconnector.com/v1/ad-attribution/meta-event. Accetta gli stessi campi in formato snake case: event_name, value, currency, contact_id, email, phone, first_name, last_name, external_id, event_id, event_time, event_source_url e test_event_code.

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.