Documentazione
Come faccio ad abilitare il plugin?
Dopo aver acquistato Referral Source Tracking per Gravity Forms, installalo sul tuo sito web WordPress.
Passaggio 1Installazione
Accedi al tuo sito web WordPress e vai su Plugin → Aggiungi plugin → Carica plugin → Installa il file zip e attivalo.
Fase 2: Registra il plugin
Nel menu di navigazione a sinistra, vai su Moduli → Impostazioni → Monitoraggio referral.
Inserisci la tua chiave di licenza e attivala.
Passaggio 3: Attiva la funzione
Dopo aver attivato la licenza, appare una scheda Generale. Fai clic su di essa, spunta Abilita per impostazione predefinita (Attiva per impostazione predefinita il monitoraggio della fonte di riferimento su tutti i moduli), quindi fai clic su Salva le modifiche.
Lasciando quella casella deselezionata, il tracciamento rimarrà disattivato ovunque. In alternativa, è possibile abilitarlo modulo per modulo in Impostazioni modulo → Opzioni modulo.
Ecco fatto! Con l'opzione "Abilita per impostazione predefinita" attivata, il tracciamento della fonte di provenienza è attivo su tutti i moduli esistenti e su tutti quelli nuovi che creerai.
Dettagli tecnici
Fonti che rileva
Quando disponibile, acquisiamo l'URL di provenienza e lo memorizziamo nella voce. Per le piattaforme più comuni, aggiungiamo anche un'etichetta descrittiva per facilitare la lettura della fonte.
Una fonte viene etichettata come "Annunci" solo quando la visita contiene l'ID di clic dell'annuncio specifico della piattaforma (gclid, msclkid, li_fat_id, ttclid, oppref e così via). Una piattaforma nota che non presenta tale ID viene etichettata come "Organica". Facebook e Instagram fanno eccezione: Meta aggiunge fbclid a ogni clic, quindi questi siti vengono visualizzati come "Annunci" quando fbclid è presente con qualsiasi parametro UTM.
Ecco l'elenco delle fonti che vengono etichettate quando vengono rilevate:
- Google: Google Ads, Google Organic. Traffico Gemini taggato
utm_source=geminiè etichettato come Google Organic; non esiste un'etichetta Gemini separata. - Microsoft/Bing Bing Ads, Bing Organic
- Facebook: Facebook Ads, Facebook Organico
- Instagram: Annunci Instagram, Instagram organico
- LinkedIn: LinkedIn Ads, LinkedIn Organico
- X (Twitter): X Biologico
- Reddit Reddit Ads, Reddit Organic
- TikTok: TikTok Ads, TikTok Organic
- Pinterest Pinterest Ads, Pinterest Organico
- Snapchat: Inserzioni Snapchat, Snapchat Organico
- YouTube: YouTube Organico. Un clic su un annuncio YouTube che genera
gclidviene registrato come Google Ads a meno che l'URL non sia anche contrassegnatoutm_source=youtube, che registra gli annunci di YouTube. - Altri motori di ricerca: Yahoo, DuckDuckGo, Yandex
- Assistenti IA/LLM: ChatGPT Ads, ChatGPT Organic, Perplexity, Copilot, Claude, Grok, DeepSeek
- Piattaforme di posta elettronica (tracciamento delle campagne): Mailchimp, Constant Contact, Pardot (etichettato)
Salesforce), HubSpot - Diretto e Sconosciuto vengono usati quando appropriato.
- Personalizzato Le fonti possono essere definite nella sezione "Origini personalizzate" per il traffico proveniente da partner, affiliati e campagne.
parametri UTM che acquisisce
utm_sourceutm_mediumutm_campaignutm_termutm_contentutm_id
ID clic acquisiti
Ogni ID di clic viene inserito nel campo ID clic e, a meno che la riga non indichi diversamente, ciascuno di essi attribuisce la visita alla propria piattaforma.
| Piattaforma | ID clic acquisiti |
|---|---|
| Annunci Google | gclid, gbraid, wbraid |
| Google (altro) | campaignid, gad_campaignid, gad_sourceCatturati e attribuiti a Google, ma non contrassegnano la visita come annunci a sé stanti. Su un vero clic su Google Ads arrivano insieme gclid, che lo fa. |
| Annunci Microsoft (Bing) | msclkid |
| Meta (Facebook / Instagram) | fbclid |
| Annunci LinkedIn | li_fat_id |
| Annunci Reddit | rdt_cid, rd_ad |
| Annunci su TikTok | ttclid |
| Annunci Pinterest | pin_cid |
| Annunci Snapchat | snap_cid |
| Annunci ChatGPT | oppref |
| Mailchimp | mc_cid, mc_eid |
| Contatto costante | cc_cid, cc_eid, cc_campaignid |
| Salesforce Pardot | pi_cid, pi_eid, pi_uid, pi_oid, pi_opt_in |
| HubSpot | _hsenc, _hssc, _hsmi, _hstc, _hsml |
| DoubleClick / DV360 | dclidIl clic viene acquisito nel campo ID clic, ma non viene mappato a un'etichetta sorgente DoubleClick. La visita viene visualizzata come Annunci sconosciuti a meno che non venga identificata in altro modo. |
Fonti principali
Il rilevamento della fonte integrato copre già i principali motori di ricerca, piattaforme social, assistenti IA e strumenti di email marketing. Le fonti personalizzate consentono di aggiungere le proprie regole etichettate. Utilizzale per siti partner, referral di affiliazione, campagne nominate, accorciatori di URL di marca, link dei dipendenti e qualsiasi altra cosa in cui l'etichetta predefinita "Referral" o un'etichetta grezza utm_source Il valore non è sufficientemente specifico.

Li trovi sotto Moduli → Impostazioni → Monitoraggio dei referral nel Fonti personalizzate sezione. Ogni riga rappresenta una regola.
Come viene valutata una regola
Per ogni visita, il plugin controlla le tue fonti personalizzate prima rilevamento integrato. La prima regola che corrisponde vince: il plugin imposta la sorgente del visitatore su quella regola Etichetta e salta il rilevamento integrato per quella visita. Se non viene trovato alcun risultato, il rilevamento integrato viene eseguito normalmente (Google, Facebook, Direct, ecc.).
I campi, uno per uno
- Etichetta – Il testo salvato come sorgente della visita (ad esempio.
Partner: Acme,Email: Newsletter,Campaign: Spring Sale). Questo è esattamente ciò che appare nella voce, nel{pb_ref_source}Unisci tag, nella scheda Report e in qualsiasi mappatura CRM. Scegli qualcosa che riconoscerai in una schermata con molte voci. - Campo di gioco – Dove guardare:
- Host referente – il dominio nel referrer del browser (ad esempio corrispondenze
acme.comquando qualcuno arriva dahttps://www.acme.com/blog/post). - Sorgente UTM / Mezzo / Campagna / Termine / Contenuto – il corrispondente
?utm_*=parametro sull'URL di destinazione.
- Host referente – il dominio nel referrer del browser (ad esempio corrispondenze
- Tipo di corrispondenza – Cosa cercare:
- Contiene – il valore del campo include il tuo Valore di corrispondenza ovunque al suo interno. Non sensibile alle maiuscole/minuscole. Ottimo per intercettare varianti come
acme.com,blog.acme.com,partner.acme.comcon una sola regola. - Uguale – il valore del campo è esattamente il tuo valore di corrispondenza (senza distinzione tra maiuscole e minuscole). Più rigoroso, quindi usalo quando hai bisogno di una corrispondenza precisa come
utm_sourceesattamente ugualenewsletter.
- Contiene – il valore del campo include il tuo Valore di corrispondenza ovunque al suo interno. Non sensibile alle maiuscole/minuscole. Ottimo per intercettare varianti come
- Valore corrispondente – Il testo da cercare. Niente virgolette, niente asterischi, solo la stringa letterale.
- Priorità – Un numero che controlla l'ordine. Le corse più alte per prime, quindi dove le regole si sovrappongono, vince quella con priorità più alta. L'impostazione predefinita è
10; spinta a20o50per le regole che devono superare le tue impostazioni predefinite, vai a5per le soluzioni generiche.
Esempi pratici
Etichetta un sito partner in base al referrer
| Etichetta | Campo di gioco | Tipo di corrispondenza | Valore corrispondente | Priorità |
|---|---|---|---|---|
Partner: Acme | Host referente | Contiene | acme.com | 20 |
Chiunque arrivi da qualsiasi sottodominio di acme.com è etichettato Partner: Acme invece del generico Referral.
Etichetta una campagna di newsletter con tag
| Etichetta | Campo di gioco | Tipo di corrispondenza | Valore corrispondente | Priorità |
|---|---|---|---|---|
Email: Newsletter | Origine UTM | Uguale | newsletter | 20 |
Utilizza questa opzione quando controlli l'URL dalla tua parte (ad esempio i link all'interno della tua email settimanale) ?utm_source=newsletter).
Etichetta una campagna a pagamento utilizzando il suo nome UTM della campagna.
| Etichetta | Campo di gioco | Tipo di corrispondenza | Valore corrispondente | Priorità |
|---|---|---|---|---|
Campaign: Spring Sale | Campagna UTM | Contiene | spring-sale | 15 |
Catture ?utm_campaign=spring-sale-2026, ?utm_campaign=spring-sale-google-ads, e varianti simili in un'unica regola.
Ignora il rilevamento integrato di Google per uno specifico affiliato
| Etichetta | Campo di gioco | Tipo di corrispondenza | Valore corrispondente | Priorità |
|---|---|---|---|---|
Affiliate: Acme via Google Ads | Origine UTM | Uguale | acme-gads | 50 |
Un'alta priorità garantisce che questa regola prevalga su quella integrata utm_source=google → Google Ads etichettatura ogni volta che arriva la sorgente taggata.
“Aggiungi etichette Organico/Annunci” con fonti personalizzate
Le sorgenti integrate vengono sempre visualizzate come Google Ads, Facebook Organic, ecc. Il Aggiungi etichette Organico/Pubblicità (Fonti personalizzate) La casella di controllo (disponibile anche in Moduli → Impostazioni → Monitoraggio referral) determina se alle etichette personalizzate viene aggiunto lo stesso suffisso.
- Controllato (predefinito) – una regola personalizzata etichettata
Partner: AcmediventaPartner: Acme Organicsul traffico di riferimento ePartner: Acme Adsse la visita contiene un ID di clic a pagamento come gclid. - Non controllato – le tue etichette personalizzate vengono visualizzate esattamente come le hai digitate e il plugin non aggiunge alcun suffisso.
Scegli l'opzione più adatta alle tue esigenze di reporting. La maggior parte dei team preferisce il suffisso per poter confrontare il traffico a pagamento con quello organico proveniente dai partner, ma se utilizzi l'etichetta stessa per veicolare l'identità completa, disattivalo.
Aggiunta di regole a livello di programmazione
Se stai creando un componente aggiuntivo o desideri regole sotto controllo di versione, pb_gforms_referral_tracking_custom_sources Il filtro accetta la stessa struttura dell'interfaccia utente di amministrazione e si integra con essa. Il plugin ordina le regole provenienti da entrambe le fonti in base alla priorità prima che vengano valutate dal front-end.
Campi di specchi
I nostri campi di tracciamento vengono aggiunti al modulo dinamicamente al momento del rendering. Non fanno parte dell'elenco dei campi salvati del modulo. Questo mantiene i moduli puliti, ma alcuni componenti aggiuntivi per CRM, email marketing e webhook creano i loro menu a tendina di mappatura dei campi solo dai campi salvati, quindi non possono "vedere" i nostri campi dinamici.
I campi specchio risolvono questo problema. In Moduli → [il tuo modulo] → Impostazioni → Opzioni modulo, fai clic Aggiungi campi speculari Il plugin aggiunge al modulo una serie parallela di campi nascosti visibili nell'editor. I campi di tracciamento originali rimangono la fonte di riferimento; il plugin copia i valori acquisiti nei campi speculari al momento della creazione della voce, in modo che il componente aggiuntivo possa mapparli dal suo normale menu a tendina dei campi. Il blocco dei campi speculari appare solo quando l'interruttore di tracciamento dei referral del modulo è attivo.
Se il tuo componente aggiuntivo supporta un'opzione di mappatura "Valore personalizzato", non hai bisogno di specchiare i campi. Basta mappare direttamente i nostri tag di unione (ad esempio {pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}).
Gestione dei campi specchio:
- Aggiungi campi speculari – crea il set visibile all'editor.
- Aggiungere N campi speculari mancanti – appare ogni volta che un modulo contiene alcuni, ma non tutti, i campi mirror correnti e ne indica il conteggio. Ciò accade se qualcuno elimina manualmente i campi e anche dopo aver abilitato l'attribuzione dell'ultimo tocco, che aggiunge un nuovo set di definizioni. Il plugin lascia inalterati gli ID dei campi rimanenti, in modo che le mappature salvate continuino a funzionare.
- Rimuovi 2 campi speculari duplicati – appare solo quando esistono duplicati e ne indica il conteggio. Mantiene la prima occorrenza di ciascuno.
- Rimuovere i campi speculari – elimina il set (con conferma). I valori già salvati per le voci precedenti rimangono nel database, ma i componenti aggiuntivi non li visualizzeranno più tramite le ricerche dell'ID campo.
Quando l'attribuzione dell'ultimo tocco è abilitata, anche i campi specchio possono includere il set dell'ultimo tocco. I moduli che avevano già il set del primo tocco non li acquisiranno automaticamente: utilizzare Aggiungere N campi speculari mancanti su ciascuno per riempirlo.
Rapporti
Trova i report sotto Moduli → Impostazioni → Tracciamento dei referral → Report. La scheda visualizza ogni voce tracciata che è arrivata durante l'intervallo di date selezionato, suddivisa per origine, dimensione UTM e referrer. Le voci inviate prima che il plugin fosse attivo, le voci nei moduli con il tracciamento disattivato e le voci eliminate o contrassegnate come spam non vengono conteggiate, quindi questi totali potrebbero essere inferiori al conteggio delle voci di Gravity Forms. Gli intervalli coprono giorni interi e terminano con l'ultima voce completata. UTC mezzanotte, quindi i confronti tra periodi rimangono omogenei. A seconda di quanto il fuso orario del tuo sito sia distante dall'UTC, tale limite può cadere a metà della tua giornata locale.

Riepilogo dei grafici
- Analisi della fonte – grafico a ciambella che mostra la quota di invii per fonte etichettata (Google Organico, Facebook Ads, le tue fonti personalizzate, Diretto, ecc.).
- Voci nel corso del tempo – Grafico a linee del numero totale di voci per intervallo. Passando il mouse su un punto, il tooltip suddivide il totale per fonte. Gli intervalli più lunghi (90 e 365 giorni) raggruppano i dati per mese, in modo che l'asse rimanga leggibile; nell'intervallo di 30 giorni, il grafico disegna un'etichetta di data ogni 7 per evitare che si sovrapponga.
- Fonte UTM principale / Mezzo / Campagna – grafici a barre orizzontali dei valori con il maggior numero di occorrenze in ciascuna dimensione UTM.
- Principali referenti – grafico a barre orizzontali dei domini di riferimento che generano il maggior numero di invii. Il plugin memorizza il traffico diretto con il referrer
Direct, quindi appare qui come una barra a sé stante piuttosto che come un dominio.
Filtri
- Modulo – limitare l'ambito a un singolo modulo oppure lasciare selezionata l'opzione "Tutti i moduli" per una visualizzazione a livello di sito.
- Intervallo di date – finestre temporali preimpostate (ultimi 7, 30, 90 e 365 giorni).
- Rispetto al periodo precedente – mostra il totale del periodo con la sua variazione percentuale rispetto alla finestra temporale precedente equivalente (ultimi 7 giorni rispetto ai 7 giorni precedenti, ultimi 30 giorni rispetto ai 30 giorni precedenti, ecc.) e sovrappone tale periodo precedente come una linea tratteggiata sul grafico temporale. I grafici a barre UTM e referrer non vengono confrontati.
- Nascondi non attribuiti – nasconde le categorie Non impostato e Sconosciuto per consentirti di concentrarti sulle fonti attribuite. La modalità diretta rimane attiva.
Il plugin memorizza le tue scelte relative all'intervallo di date, al periodo di confronto e all'occultamento dei dati non attribuiti per ciascun utente, in modo da non doverle reimpostare alla tua prossima visita.
Prestazioni e caching
Il plugin calcola i report dalle voci di Gravity Forms e memorizza nella cache il risultato, in modo che i caricamenti ripetuti siano veloci. Le nuove voci invalidano automaticamente la cache, con un blocco di 60 secondi per evitare che i moduli ad alto volume la sovraccarichino. Gli sviluppatori possono regolare la finestra di debounce (o disabilitarla completamente) con pb_gforms_rt_invalidate_debounce filtro. Vedi i ganci qui sotto.
Riepilogo via email
Se preferisci ricevere i dati di attribuzione in formato e-mail anziché aprire la dashboard, abilita il riepilogo via e-mail in Moduli → Impostazioni → Monitoraggio referral → Report via email. Il giorno e l'ora selezionati vengono valutati nel fuso orario del tuo sito, ma il periodo riportato stesso viene misurato in unità intere UTC giorni, fino all'ultima mezzanotte UTC completa prima dell'invio dell'e-mail. Nei siti lontani dall'UTC, l'intervallo di giorni coperto è sfalsato rispetto ai giorni locali.

Cadenza e tempistica
- Settimanale – Seleziona il giorno della settimana (da domenica a sabato) e l'ora di invio dell'e-mail.
- Mensile – Seleziona il giorno del mese (con un limite massimo del 28, in modo che l'email arrivi sempre, anche a febbraio) e l'ora.
- Il programma di invio segue il tuo fuso orario del sito (WordPress → Impostazioni → Generali), e la pagina delle impostazioni mostra quella corrente proprio accanto al selettore dell'ora. La finestra di reporting stessa è ancora misurata in giorni UTC.
Destinatari
Un indirizzo email per riga. Lascia il campo vuoto e il riepilogo torna all'impostazione predefinita. indirizzo email dell'amministratore del sito al momento dell'invio. Questo è utile quando l'indirizzo email dell'amministratore potrebbe cambiare in seguito e si desidera che il riepilogo si aggiorni automaticamente.
Il Invia un'email di prova a me adesso il pulsante fornisce lo stesso corpo digest utilizzando il tuo salvato impostazioni. Due cose differiscono da un invio programmato: l'oggetto è preceduto da [TEST], e ignora Salta i digest vuoti, quindi un test effettuato durante un periodo di silenzio arriva comunque laddove il riepilogo reale sarebbe rimasto in silenzio. Il pulsante si disattiva automaticamente in presenza di modifiche non salvate; salvare prima, poi testare.
Opzioni dei contenuti
- Salta i digest vuoti – non inviare affatto l'e-mail se il totale del riepilogo per il periodo è zero. In un modulo sparso, questo ti evita un riepilogo vuoto nelle settimane tranquille. Con Nascondi non attribuiti Inoltre, tale totale ignora le voci Non impostato e Sconosciuto, pertanto un periodo contenente solo voci non attribuite viene considerato vuoto e viene saltato.
- Rispetto al periodo precedente – Mostra la variazione percentuale rispetto al periodo equivalente precedente nella parte superiore dell'e-mail (settimana scorsa rispetto alla settimana precedente, mese scorso rispetto al mese precedente, ecc.).
- Nascondi non attribuiti – omettere i valori Non impostato e Sconosciuto dalle tabelle degli indirizzi email in modo che l'attenzione rimanga focalizzata sulle fonti attribuite.
Unisci tag
{pb_ref_source} – valore memorizzato nel campo nascosto “Origine” (con valore predefinito “Sconosciuto” quando la visita non può essere classificata).
{pb_ref_params} – stringa completa dei parametri di riferimento acquisiti (UTM e altre variabili di query che conserviamo insieme).
{pb_ref_referrer} – l'URL di riferimento per la visita. Questo è il referrer effettivo, non il valore grezzo del browser. Quando un ID di clic o un riconosciuto utm_source identifica la piattaforma, il plugin memorizza invece l'URL canonico della piattaforma. Di conseguenza, un gclid registri delle visite https://www.google.com/ anche quando il clic proveniva da un'email. Registra le visite dallo stesso dominio e senza referrer Direct. Nessun tag di unione espone il referrer del browser non modificato.
{pb_ref_utm_id} – utm_id.
{pb_ref_utm_source} – utm_source.
{pb_ref_utm_medium} – utm_medium.
{pb_ref_utm_campaign} – utm_campaign.
{pb_ref_utm_term} – utm_term.
{pb_ref_utm_content} – utm_content.
{pb_ref_clid} – primo ID del clic rilevato per la visita (gclid, fbclid, msclkid e altri ID di clic della piattaforma).
{pb_ref_custom_source} – la tua etichetta personale per la visita, scritta da pb_gforms_referral_tracking_source_label filtro (vedi Hook). Il tag esiste solo quando a quel filtro è associata una funzione di callback. Il plugin memorizza la sorgente rilevata separatamente e non la modifica mai.
tag di unione last-touch
Quando l'attribuzione dell'ultimo tocco è abilitata, il plugin aggiunge un set parallelo:
{pb_ref_last_source}{pb_ref_last_referrer}{pb_ref_last_params}{pb_ref_last_clid}{pb_ref_last_utm_source}{pb_ref_last_utm_medium}{pb_ref_last_utm_campaign}{pb_ref_last_utm_term}{pb_ref_last_utm_content}{pb_ref_last_utm_id}{pb_ref_last_custom_source}
Ciascuna replica la sua controparte iniziale, ma memorizza la fonte più recente prima dell'invio. {pb_ref_last_custom_source} ha bisogno anche del pb_gforms_referral_tracking_source_label filtro, identico alla sua controparte al primo tocco.
Invio dei dati a Google Analytics
Il monitoraggio della fonte di riferimento non contatta mai Google autonomamente. Tutto ciò che acquisisce rimane nella tua pagina di Gravity Forms. Se attivi l'impostazione GA4, sarà il tuo tag Google a inviare l'evento.
Dalla versione 1.6.0 è possibile attivare un evento GA4. Attiva GA4 / Tag Manager in Moduli → Impostazioni → Monitoraggio referral → Generale. Dopo la conferma, il plugin invia un evento personalizzato denominato pb_referral_submit (rinominarlo nella stessa impostazione) con i parametri sorgente, referrer, ID clic e UTM, oltre ai valori last-touch quando last-touch è attivo. Una convalida non riuscita non invia. Le conferme di reindirizzamento e di ringraziamento della pagina richiedono la versione 1.7.1.
Controlla GA4 Realtime o DebugView per l'evento. Non è necessario un trigger di Tag Manager. Il tuo tag Google si occupa dell'invio; il plugin non contatta mai Google.
Opzionale: puoi anche passare tag di unione nella stringa di query di conferma del reindirizzamento (sotto) se converti già dai parametri della campagna nell'URL di ringraziamento. Questo è separato dall'evento personalizzato.
Cosa comporta l'evento
Le chiavi dei parametri corrispondono ai nomi dei tag di unione. I valori vuoti vengono completamente esclusi dal payload e l'evento viene attivato al massimo una volta per visualizzazione di pagina.
| Parametro | Valore |
|---|---|
pb_ref_source | Fonte etichettata, ad esempio. Google Ads |
pb_ref_referrer | URL di riferimento efficace |
pb_ref_clid | ID del primo clic rilevato |
pb_ref_params | Stringa completa dei parametri acquisiti |
pb_ref_utm_source, _medium, _campaign, _term, _content, _id | I sei valori UTM |
pb_ref_last_* | Il set di ultimo tocco parallelo, solo quando l'attribuzione dell'ultimo tocco è attiva |
pb_ref_form_id | L'ID del modulo Gravity Forms. Presente solo nelle conferme AJAX, dove l'ID è noto |
Opzionale: passare valori nell'URL di ringraziamento
- Apri le conferme del tuo modulo in Moduli → [il tuo modulo] → Impostazioni → Conferme, quindi modifica (o aggiungi) un Reindirizzamento conferma.
- Nel URL di reindirizzamento Nel campo, inserisci l'URL della tua pagina di ringraziamento seguito da una stringa di query creata a partire dai tag di unione di tracciamento:
https://yoursite.com/thank-you/?gclid={pb_ref_clid}&utm_source={pb_ref_utm_source}&utm_medium={pb_ref_utm_medium}&utm_campaign={pb_ref_utm_campaign}&utm_term={pb_ref_utm_term}&utm_content={pb_ref_utm_content}Gravity Forms compila e codifica in URL ogni valore al momento dell'invio, in modo che un visitatore arrivato tramite un clic su Google Ads atterri su un URL simile a questo:
https://yoursite.com/thank-you/?gclid=EAIaIQ...&utm_source=google&utm_medium=cpc&utm_campaign=spring-saleLa configurazione di GA4 o Google Tag Manager sulla pagina di ringraziamento legge quindi questi parametri nello stesso modo in cui gestisce qualsiasi URL di campagna, attivando l'evento di conversione o di lead con l'ID della sorgente, della campagna e del clic acquisiti allegati. I valori che non sono stati acquisiti per una determinata visita vengono visualizzati vuoti.
Qui puoi utilizzare uno qualsiasi dei tag di unione di tracciamento. Vedi Unisci tag per l'elenco completo. (Se preferisci, Passare i dati del campo tramite stringa di query opzione sulla stessa conferma di reindirizzamento accetta questi stessi tag di unione.)
Perché utilizzare i tag di unione invece dei propri campi nascosti?
Se stai già inviando i dati della campagna alla tua pagina di ringraziamento dai tuoi campi nascosti, indirizza la stringa di query ai nostri tag di unione. In questo modo, sia il valore salvato nell'inserzione che quello inviato a GA4 proverranno dalla stessa fonte di acquisizione, evitando così che i due valori si discostino. L'inserzione e GA4 mostreranno sempre la stessa campagna. Inoltre, ciò significa un set di campi in meno da gestire.
Una nota sugli ID dei clic
{pb_ref_clid} Contiene l'ID del primo clic rilevato durante la visita, indipendentemente dalla piattaforma da cui proviene: gclid per Google, ma anche msclkid (Microsoft), fbclid (Meta) e altri. Se lo stai mappando specificamente su un gclid= parametro per Google Ads, una visita non Google inserirebbe il suo ID clic in quello slot. Se vuoi che l'ID clic sia incluso solo nelle visite di Google Ads, aggiungi la logica condizionale alla conferma in modo che gclid= il parametro viene inviato solo quando Fonte È Annunci Google.
Verificare che funzioni
È possibile verificare l'intera catena in quattro passaggi:
- Aggiungi i parametri di test a qualsiasi URL della landing page (ad esempio
?gclid=TEST123&utm_source=google&utm_medium=cpc), quindi inviare il modulo. - Nella pagina di ringraziamento, controlla la barra degli indirizzi: i tuoi valori dovrebbero essere presenti nell'URL.
- Apri gli strumenti per sviluppatori del tuo browser, vai a Rete scheda e filtro per
collect. La richiesta a Google dovrebbe includere il tuogclideutmvalori. - Confermare la ricezione in GA4 Visualizzazione debug o In tempo reale rapporto.
Esegui il test in una finestra di navigazione privata o senza aver effettuato il logout. Quando si è connessi come amministratore, il plugin viene eseguito intenzionalmente in modalità di sola sessione, scrivendo cookie senza scadenza, pertanto la finestra di attribuzione non può essere riprodotta da una sessione amministrativa.
Questi quattro passaggi controllano il metodo opzionale della stringa di query. Per l'evento personalizzato integrato, invia il modulo, quindi nella pagina di conferma o di ringraziamento apri Strumenti per sviluppatori → Rete, filtra per g/collect, e cerca en=pb_referral_submit (o il nome del tuo evento). Oppure usa GA4 DebugView. Se l'evento è presente nella scheda Rete ma non in GA4, la mancanza è dovuta al tuo tag Google. Se non è presente nella scheda Rete, il plugin non è stato attivato.
Invio dell'evento a GA4
Dalla versione 1.6.0 è possibile inviare il codice sorgente già presente nella voce Gravity Forms a GA4 come evento personalizzato. Questa opzione è disattivata per impostazione predefinita. L'invio viene effettuato dal tuo tag Google, senza che il plugin contatti direttamente Google. Puoi verificare l'evento in GA4 Realtime o DebugView. Non è necessario un trigger di Tag Manager.
Vai a Moduli → Impostazioni → Monitoraggio dei Referral → Generale. Tic tac Invia i parametri acquisiti a GA4 come evento personalizzato alla conferma del modulo.. Lascia il nome dell'evento come pb_referral_submit a meno che tu non abbia un motivo per modificarlo, fai clic su Salva modifiche.

Traduzioni
Questo plugin è pronto per la traduzione e include traduzioni predefinite per:
- arabo (
ar) - bengalese (
bn_BD) - filippino (
fil) - tedesco (
de_DE) - spagnolo (
es_ES) - spagnolo (
es_MX) - Francese (
fr_FR) - Hindi (
hi_IN) - indonesiano (
id_ID) - Italiano (
it_IT) - Giapponese (
ja) - Portoghese (
pt_BR) - Russo (
ru_RU) - Urdu (
ur) - Cinese semplificato (
zh_CN) - Tradizionale cinese (
zh_HK)
Lingua predefinita: inglese (en_US)
Se la tua lingua non è elencata sotto Traduzioni sopra, puoi ancora tradurre il plugin da solo. È pronto per la traduzione. Usa il gratuito Plugin Loco Translate per creare una traduzione per la lingua/localizzazione del tuo sito. Sei nuovo di Loco Translate? Ecco un tutorial adatto ai principianti.
Domande frequenti
Posso esportare i dati?
Sì. I valori di tracciamento vengono salvati per ogni voce inserita in Gravity Forms, quindi vengono visualizzati nelle esportazioni delle voci.
Che cosa cattura esattamente il plugin?
Acquisiamo i campi di attribuzione comuni e li memorizziamo nella voce Gravity Forms. Ciò include Parametri UTM (fonte, mezzo, campagna, termine, contenuto), ID di clic (gclid, msclkid, gbraid/wbraid, ecc.), il URL di riferimento originale, e il contesto della landing page correlata, in modo da poter vedere da dove proviene ogni lead.
Posso aggiungere sorgenti personalizzate?
Sì. Aggiungi le regole sotto Moduli → Impostazioni → Monitoraggio referral → Origini personalizzate per etichettare siti partner, traffico di affiliazione, campagne di marca e visite simili con un nome. Ogni regola corrisponde all'host referrer o a un parametro UTM e applica un'etichetta a tua scelta. Vedi il Fonti principali sezione dedicata alla guida dettagliata campo per campo ed esempi pratici.
Il mio componente aggiuntivo CRM/email/webhook non visualizza i campi di tracciamento nel menu a tendina di mappatura. Cosa posso fare?
I nostri campi di tracciamento vengono aggiunti al modulo dinamicamente al momento del rendering, non salvati nell'elenco dei campi del modulo, quindi i componenti aggiuntivi che creano il loro menu a tendina solo dai campi salvati non possono vederli. Hai due opzioni. Se il tuo componente aggiuntivo ha una mappatura "Valore personalizzato", mappa direttamente i nostri tag di unione ({pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}, e così via). Se supporta solo un menu a tendina dei campi, apri Impostazioni modulo → Opzioni modulo → Campi specchio e fai clic Aggiungi campi speculari. Questo aggiunge campi nascosti visibili all'editor e il plugin li compila automaticamente. Per una spiegazione completa, consulta la sezione Campi specchio.
Dove vengono salvati i dati relativi alle segnalazioni?
Nel database di WordPress, all'interno delle voci di Gravity Forms. Il plugin non invia mai i dati da nessuna parte autonomamente. Se desideri che i valori acquisiti vengano visualizzati in GA4, attiva l'impostazione GA4. Il plugin rimane la fonte dei dati; l'invio avviene tramite il tuo tag Google.
Si tratta di un'attribuzione al primo o all'ultimo contatto?
Entrambi. Per impostazione predefinita utilizza l'attribuzione al primo tocco, memorizzando il referrer originale e i parametri della campagna che hanno portato per la prima volta il visitatore al tuo sito (all'interno della finestra di attribuzione). C'è una casella di controllo per ignorare le visite di ritorno dirette, quindi l'ultimo tocco mantiene l'annuncio o il referral precedente. Gli ID clic delle visite di ritorno vengono memorizzati solo su ID clic (ultimo tocco). Ciò ti fornisce un set parallelo di {pb_ref_last_*} Unisci tag, colonne elenco voci e colonne per l'esportazione CSV. La scheda Report include un interruttore Primo/Ultimo che permette di passare da una visualizzazione all'altra per ogni grafico.
Per quanto tempo conserva i dati di attribuzione di un visitatore?
Il periodo di attribuzione predefinito è di 7 giorni ed è possibile modificarlo in Moduli → Impostazioni → Monitoraggio referral. Se un visitatore invia un modulo entro tale periodo dalla sua prima visita tracciata, a tale voce verranno associati i valori di attribuzione originali del primo contatto.
Funziona con la cache/CDN?
Di solito sì. Il tracciamento viene eseguito lato client, quindi la maggior parte delle configurazioni di caching/CDN funzionano correttamente. Se si utilizza un'ottimizzazione aggressiva degli script (minimizzazione o differimento), spuntare Proteggi gli script dall'ottimizzazione In Moduli → Impostazioni → Monitoraggio referral → Avanzate, quindi svuota la cache. In questo modo gli script del plugin vengono contrassegnati in modo da essere ignorati e aggiunti automaticamente agli elenchi di esclusione di WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize e Cloudflare Rocket Loader. Se utilizzi Breeze o un altro minificatore non presente in tale elenco, escludi manualmente i due file indicati di seguito e svuota la cache CDN per essi dopo un aggiornamento.
Per qualsiasi ottimizzatore non coperto da tale impostazione, escludere manualmente questi due file e testare l'invio:
/wp-content/plugins/pb-gforms-referral-tracking/assets/js/front-end.js/wp-content/plugins/pb-gforms-referral-tracking/assets/dist/js.cookie.min.js
Funziona con Gravity Forms che supporta AJAX?
Sì. Funziona con i moduli AJAX e con gli invii standard (non AJAX). I reindirizzamenti e le conferme di ringraziamento della pagina su Gravity Forms 2.9+ richiedono la versione 1.7.1 per l'evento GA4.
Posso monitorare più di un modulo?
Sì. Funziona con tutti i tuoi moduli Gravity Forms. Ogni invio salva i propri valori di attribuzione per quella voce.
Questo sistema sostituisce il monitoraggio delle conversioni di GA4/Google Ads?
No. Si tratta di una fonte di dati, non di un pixel di conversione, e non attiva mai pixel né contatta direttamente Google. Se desideri l'attribuzione all'interno di GA4, l'impostazione GA4/Tag Manager (attivabile) la invia come evento personalizzato tramite il tuo tag Google alla conferma del modulo.
Raccoglie dati personali?
Per impostazione predefinita, acquisisce i dati di attribuzione (UTM, gclid, URL di riferimento). Lo fa non Acquisiamo ulteriori dati personali per impostazione predefinita. I campi del modulo e gli eventuali parametri inclusi negli URL sono controllati dalle impostazioni del tuo sito e delle tue strategie di marketing.
È conforme al GDPR/CCPA?
Se è necessario il consenso prima che vengano acquisiti dati di attribuzione, abilita il gate di consenso opzionale. Questo blocca i dati di primo contatto nel browser finché il visitatore non concede il consenso tramite il banner dei cookie (tramite un flag della finestra, una callback o un evento), dopodiché lo applica.
Funziona con una rete WordPress Multisite?
In breve
- Licenza illimitata: abilita la modalità di rete una volta; un solo tasto può gestire ogni Impostazioni del sottosito + supporto.
- Attivato tramite rete: Tutti i sottositi utilizzano il tracciamento dei referral e ricevono aggiornamenti in tempo reale.
- Piano limitato / nessuna licenza per sotto-siti: Il tracciamento è inattivo su quel sottosito. Nessun campo di tracciamento, tag di unione o dato di inserimento viene acquisito finché non viene attivata una chiave o finché la Modalità di rete non ne invia una.
- L'assistenza segue la licenza: I siti coperti dalla chiave attiva sono idonei.
Sì, una volta che ogni sottosito è stato concesso in licenza e attivato. L'attivazione a livello di rete installa il plugin ovunque e gli aggiornamenti vengono gestiti a livello di rete, ma un sottosito necessita di una propria licenza attivata (o di una chiave Unlimited inviata tramite la modalità di rete) prima che il plugin aggiunga campi di tracciamento o acquisisca valori. Dopodiché, attiva l'opzione "Abilita per impostazione predefinita" in quel sito oppure abilita il tracciamento per singolo modulo.
Se disponi di una licenza Unlimited, puoi abilitare la Modalità di rete dal sito principale e distribuire la stessa chiave a tutti i sottositi in un'unica operazione (con avanzamento in tempo reale). I sottositi erediteranno automaticamente le impostazioni e il supporto gestiti dalla licenza.
Riferimento alle impostazioni
Tutto ciò che è sotto vive sotto Moduli → Impostazioni → Monitoraggio dei referral, sulla scheda indicata in ciascuna intestazione.
Dati e privacy
| Collocamento | Predefinito | Cosa fa |
|---|---|---|
| Archiviazione di fallback senza cookie | Off | La modalità disattivata mantiene l'attribuzione solo nei cookie. Persistent Per i visitatori che bloccano i cookie, il sistema utilizza la memoria locale del browser, scartando tutto ciò che è più vecchio della finestra di attribuzione. Si attiva solo quando i cookie non sono disponibili e, con il meccanismo di consenso attivo, lo script di tracciamento scrive nella memoria locale solo dopo aver ricevuto il consenso. La memoria locale del browser è soggetta agli stessi obblighi previsti dal GDPR e dalla normativa ePrivacy dei cookie, quindi è necessario includerla nella propria informativa sulla privacy. |
| Rimozione dei dati durante la disinstallazione | Off | Disattivando il plugin, tutto rimane invariato. Attivando, vengono eliminate le impostazioni del plugin, la configurazione del tracciamento per ogni modulo, i dati di licenza, gli eventi pianificati e le preferenze di Report per ogni utente. I dati inseriti in Gravity Forms e i valori di tracciamento salvati in essi non vengono modificati in entrambi i casi. |
Avanzato
| Collocamento | Predefinito | Cosa fa |
|---|---|---|
| Proteggi gli script dall'ottimizzazione | Off | Contrassegna gli script front-end del plugin in modo che gli strumenti di minimizzazione e differimento li ignorino e li registra negli elenchi di esclusione di WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize e Cloudflare Rocket Loader. Attiva questa opzione se i dati di riferimento scompaiono dopo aver abilitato un plugin di caching. |
Porta del consenso
Non è presente alcuna casella di controllo per questo. Il gate di consenso è un'opzione dello sviluppatore: imposta consentRequired attraverso il pb_gforms_referral_tracking_js_config filtro. Lo script di tracciamento contiene i dati del primo tocco in sessionStorage fino all'arrivo del consenso, dopodiché viene trasferito in un luogo di conservazione durevole.
add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
$config['consentRequired'] = true;
return $config;
} );Esprimi il tuo consenso tramite il banner dei cookie in uno di questi tre modi:
- Impostato
window.PBReferralTrackingConsent = true. - Invia l'evento:
window.dispatchEvent( new Event( 'pb-ref-tracking:consent-granted' ) ). - Assegna un
consentGrantedFunzione di callback che restituisce true una volta ottenuto il consenso.
Ganci
Azioni
pb_gforms_referral_tracking_loaded
Si attiva una volta che il plugin è completamente inizializzato: classi caricate, hook registrati, API pronta. Questo è il punto di avvio affidabile per i componenti aggiuntivi o i plugin complementari che estendono Referral Source Tracking.
Parametri:
$plugin(Collegare) – La regolazione del plugin.
add_action( 'pb_gforms_referral_tracking_loaded', function( $plugin ) {
// Safe to interact with the plugin's classes and filters here.
// Example: register your own add-on after the plugin is ready.
if ( class_exists( 'MyReferralAddon' ) ) {
new MyReferralAddon( $plugin );
}
} );Filtri
pb_gforms_referral_tracking_enabled
Sovrascrivi l'impostazione che consente di abilitare o disabilitare il tracciamento dei referral per un modulo specifico. Restituisci true per forzare l'attivazione del tracciamento, false per disattivarlo, indipendentemente dall'impostazione predefinita per il singolo modulo o da quella globale.
Parametri:
$enabled(bool) – Indica se il tracciamento è attualmente abilitato.$form_id(int) – L'ID del modulo corrente.$form(array|null) – L'array di metadati del modulo, oppure null se non disponibile.
// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_gforms_referral_tracking_enabled', function( $enabled, $form_id, $form ) {
$excluded_form_ids = [ 12, 27 ];
if ( in_array( $form_id, $excluded_form_ids, true ) ) {
return false;
}
return $enabled;
}, 10, 3 );pb_gforms_referral_tracking_field_definitions
Filtra l'array di definizioni dei campi di tracciamento nascosti prima che il plugin li inserisca nel modulo. Utilizza questa funzione per aggiungere, rimuovere o modificare qualsiasi singolo campo di tracciamento.
Parametri:
$fields(vettore) – Array di array di definizioni di campo.$form(vettore) – Il modulo meta corrente.
// Remove the Referral Parameters field from all forms.
add_filter( 'pb_gforms_referral_tracking_field_definitions', function( $fields, $form ) {
return array_filter( $fields, function( $field ) {
return ! isset( $field['cssClass'] ) || $field['cssClass'] !== 'pb-ref-tracking-ref-params';
} );
}, 10, 2 );pb_gforms_referral_tracking_form
Filtra l'intero array del modulo dopo che il plugin ha aggiunto tutti i suoi campi di tracciamento. L'oggetto modulo finale è modificabile prima della sua visualizzazione.
Parametri:
$form(vettore) – Il modulo contiene già i campi di tracciamento.$field_definitions(vettore) – Le definizioni dei campi utilizzate.
// Log which forms have tracking fields injected (useful for debugging).
add_filter( 'pb_gforms_referral_tracking_form', function( $form, $field_definitions ) {
error_log( 'Referral tracking fields added to form ID: ' . $form['id'] );
return $form;
}, 10, 2 );pb_gforms_referral_tracking_merge_tag_map
Modifica la mappa dei tag di unione che definisce quali tag di unione sono disponibili e a quali ID di campo corrispondono. Usala per aggiungere tag di unione completamente personalizzati o per rinominare quelli esistenti.
Parametri:
$map(vettore) – Array associativo di tag => [ 'label' => stringa, 'field_id' => stringa ].$base_id(corda) – Il prefisso dell'ID del campo base.$constants(Costanti) – Regola le costanti del plugin.
// Rename the "Source" merge tag label as it appears in the GF dropdown.
add_filter( 'pb_gforms_referral_tracking_merge_tag_map', function( $map, $base_id, $constants ) {
if ( isset( $map['pb_ref_source'] ) ) {
$map['pb_ref_source']['label'] = 'Traffic Source';
}
return $map;
}, 10, 3 );pb_gforms_referral_tracking_value
Filtra il valore grezzo di un campo di tracciamento prima che il plugin lo formatti e lo utilizzi per sostituire un tag di unione in una notifica o conferma. Questo è il punto in cui sanificare o trasformare un valore specifico.
Parametri:
$value(corda) – Il valore grezzo del campo.$tag(corda) – La chiave del tag di unione (ad esempio pb_ref_source).$data(vettore) – I metadati del tag di unione (etichetta, field_id).$entry(vettore) – La voce corrente.$form(vettore) – La forma attuale.
// Truncate long referrer URLs in merge tag output.
add_filter( 'pb_gforms_referral_tracking_value', function( $value, $tag, $data, $entry, $form ) {
if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
return substr( $value, 0, 100 ) . '…';
}
return $value;
}, 10, 5 );pb_gforms_referral_tracking_formatted_value
Filtra il valore del tag merge completamente formattato dopo che Gravity Forms ha eseguito su di esso la propria pipeline di formattazione (escape, codifica URL, ecc.).
Parametri:
$formatted(corda) – La stringa di output formattata.$tag(corda) – La chiave del tag di unione.$data(vettore) – I metadati del tag di unione.$entry(vettore) – La voce corrente.$form(vettore) – La forma attuale.$url_encode(bool)$esc_html(bool)$nl2br(bool)$format(corda)
// Wrap the source value in a bold tag in HTML-format notifications.
add_filter( 'pb_gforms_referral_tracking_formatted_value', function( $formatted, $tag, $data, $entry, $form, $url_encode, $esc_html, $nl2br, $format ) {
if ( $tag === 'pb_ref_source' && $format === 'html' && ! $url_encode ) {
return '<strong>' . $formatted . '</strong>';
}
return $formatted;
}, 10, 9 );pb_gforms_referral_tracking_default_value
Sovrascrivi il valore di fallback utilizzato quando un campo di tracciamento è vuoto al momento dell'invio. Il valore predefinito è "Sconosciuto".
Parametri:
$default(corda) – Il valore predefinito corrente (“Sconosciuto”).$key(corda) – Chiave di contesto: source, referrer o front_end.
// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_gforms_referral_tracking_default_value', function( $default, $key ) {
if ( $key === 'source' ) {
return 'Direct';
}
return $default;
}, 10, 2 );pb_gforms_referral_tracking_js_config
Sovrascrivi l'intero oggetto di configurazione JavaScript front-end prima che il plugin lo passi allo script di tracciamento. Il tuo callback controlla le impostazioni dei cookie, le mappe sorgente (utmSourceMap e utmReferrerMap), fonti note e il paidClickIds elenco che determina quali parametri di query dimostrano un clic a pagamento.
Parametri:
$config(vettore) – L'intero array di configurazione JS.
I tasti, con i relativi valori predefiniti:
| Chiave | Predefinito | Comandi |
|---|---|---|
cookieExpiry | 7 | Periodo di attribuzione in giorni. |
cookiePrefix | pb-ref-tracking- | Prefisso su ogni chiave memorizzata. |
cookiePath | / | Percorso dei cookie. |
cookieSameSite | Lax | Attributo SameSite. |
defaultValue | Unknown | Valore registrato quando non era stato catturato nulla. |
appendOrganicPaid | true | Se le etichette personalizzate riceveranno il suffisso Organic/Ads. |
paidClickIds | 10 ID | Parametri di query che dimostrano un clic a pagamento e che quindi generano un'etichetta "Annunci". |
utmSourceMap / utmReferrerMap | vedi sotto | Mappe di stringhe semplici da un utm_source valore per un'etichetta e un URL di riferimento canonico. |
customSources | [] | Regole di origine personalizzate. Si consiglia di utilizzare il filtro dedicato indicato sopra. |
sessionOnlyMode | false | Cookie di sessione senza scadenza. Attivati obbligatoriamente per gli amministratori che hanno effettuato l'accesso. |
fallbackStorage | none | local abilita il fallback senza cookie. |
consentRequired / consentGranted | false / null | Il cancello del consenso. Vedi la sezione Impostazioni. |
enableLastTouch | false | Cattura anche l'ultimo tocco. |
enableDataLayerPush | false | Emetti l'evento GA4. |
dataLayerEventName | pb_referral_submit | Nome di quell'evento. |
trackingFieldBaseId | '' | ID del campo base per i campi iniettati. |
debug | false | Imposta su "true" per registrare le decisioni di acquisizione nella console del browser. È il modo più rapido per capire perché una visita è stata etichettata in un determinato modo. |
sourcePatterns è volutamente assente da quell'elenco. Le sue voci necessitano di JavaScript attivo. RegExp oggetti e qualsiasi cosa restituisca una callback PHP arriva come stringa una volta che la configurazione è codificata in JSON, il che genera un errore al momento della corrispondenza. Per estendere i modelli di referrer, assegnare a window.PBReferralTrackingConfig da JavaScript prima dell'esecuzione dello script di tracciamento.
// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
// Extend the first-touch attribution window to 30 days.
$config['cookieExpiry'] = 30;
// Turn on the cookieless localStorage fallback for visitors who block cookies.
$config['fallbackStorage'] = 'local';
return $config;
} );pb_gforms_referral_tracking_custom_sources
Consente di iniettare programmaticamente regole di origine personalizzate che vengono eseguite insieme alle regole configurate nell'interfaccia utente di amministrazione. Il plugin unisce le regole di questo filtro con le regole salvate nell'interfaccia utente, ordina il set combinato per priorità e lo passa al front-end.
Parametri:
$sources(vettore) – Array vuoto. Restituisce un array di array di regole da aggiungere.
Ogni regola deve avere: etichetta, campo di corrispondenza (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), tipo di corrispondenza (contiene o è uguale a), valore di corrispondenza e, facoltativamente, priorità (predefinita 10, le priorità più alte vengono eseguite per prime).
Le regole aggiunte tramite questo filtro possono anche essere utilizzate referrer_url come matchField, che confronta l'URL di riferimento completo, inclusi percorso e query, anziché solo l'host. L'interfaccia di amministrazione non lo offre, quindi è disponibile solo qui.
// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_gforms_referral_tracking_custom_sources', function( $sources ) {
$sources[] = [
'label' => 'Partner: Acme Corp',
'matchField' => 'referrer',
'matchType' => 'contains',
'matchValue' => 'acme.com',
'priority' => 20,
];
$sources[] = [
'label' => 'Campaign: Spring Sale',
'matchField' => 'utm_campaign',
'matchType' => 'contains',
'matchValue' => 'spring-sale',
'priority' => 10,
];
return $sources;
} );pb_gforms_referral_tracking_source_label
Inserisci la tua etichetta personalizzata in un campo "Origine personalizzata" separato al momento dell'invio. L'origine rilevata non viene mai modificata, quindi il dato inserito conserva entrambi: quello calcolato dal plugin e quello restituito dall'utente. Utile quando un CRM richiede un'etichetta semplificata o interna e non si desidera perdere l'origine reale. Dalla versione 1.6.0.
L'aggiunta di una funzione di callback è ciò che attiva la funzionalità. Senza alcuna funzione di callback, i campi Origine personalizzata e i relativi tag di unione non esistono. Aggiungendone uno, il plugin inizierà ad aggiungere un campo Origine personalizzata ai moduli, oltre a un campo Origine personalizzata (Ultimo contatto) quando l'attribuzione dell'ultimo contatto è abilitata. Restituisci una stringa vuota per lasciare il campo vuoto per una determinata visita; in questo caso, non verrà utilizzato il valore predefinito rilevato.
Parametri:
$label(corda) – L'etichetta della sorgente rilevata, ad esempioGoogle Ads.$key(corda) – Quale tocco viene etichettato:sourceolast_source.$form(vettore) – L'oggetto modulo corrente.
// Roll the detected source up into a few buckets for the CRM.
add_filter( 'pb_gforms_referral_tracking_source_label', function( $label, $key, $form ) {
if ( 0 === strpos( $label, 'Google' ) || 0 === strpos( $label, 'Bing' ) ) {
return 'Search';
}
if ( 0 === strpos( $label, 'Facebook' ) || 0 === strpos( $label, 'Instagram' ) ) {
return 'Social';
}
// Anything else: leave the Custom Source field empty.
return '';
}, 10, 3 );pb_gforms_referral_tracking_enqueue_assets
Controlla se le risorse front-end del plugin (libreria di cookie e script di tracciamento) vengono messe in coda. Restituisci false per disabilitare completamente il caricamento su una pagina o in una determinata condizione.
Parametri:
$enqueue(bool) – Indica se mettere in coda le risorse. Valore predefinito: true.
// Disable tracking assets on the homepage only.
add_filter( 'pb_gforms_referral_tracking_enqueue_assets', function( $enqueue ) {
if ( is_front_page() ) {
return false;
}
return $enqueue;
} );pb_gforms_referral_tracking_inline_css
Sovrascrivi il CSS inline che nasconde i campi di tracciamento sul front-end e nell'anteprima dell'editor a blocchi. Il CSS predefinito nasconde i wrapper dei campi di tracciamento, del tracker Google Ads legacy e del mirror field, targeting .gform_wrapper .gfield con i prefissi di classe pb-ref-tracking-, pb-gads-tracking- e pb-ref-mirror-.
Parametri:
$css(corda) – La stringa CSS inline.
// Replace the default hide rule with a more specific selector.
add_filter( 'pb_gforms_referral_tracking_inline_css', function( $css ) {
return '.my-theme .gform_wrapper .gfield[class*="pb-ref-tracking-"] { display: none !important; }';
} );pb_gforms_rt_invalidate_debounce
Regola (o disattiva) la finestra di debounce per l'invalidazione della cache dei report. Dopo l'inserimento di una nuova voce, la cache dei report viene ricostruita al massimo una volta ogni intervallo di secondi specificato, in modo che i moduli con un elevato volume di richieste non la sovraccarichino. Il valore predefinito è 60 secondi; restituisci 0 per invalidare immediatamente ogni voce.
Parametri:
$seconds(int) – La finestra di debounce in secondi. Valore predefinito: 60.
// Rebuild Reports data immediately on every new entry (no debounce).
add_filter( 'pb_gforms_rt_invalidate_debounce', function( $seconds ) {
return 0;
} );pb_gforms_referral_tracking_mirror_field_definitions
Personalizza le definizioni dei campi specchio persistenti create quando i campi specchio vengono aggiunti a un modulo. label è la parte che puoi cambiare senza problemi.
Vattene cssClass da solo. All'invio il plugin legge la chiave di tracciamento canonica al suo interno, tutto dopo pb-ref-mirror-, per trovare il valore da copiare. Rinominare la classe e il campo specchio viene inviato vuoto ogni volta.
Parametri:
$fields(vettore) – Array di array di definizione del campo specchio.$form(vettore) – Il modulo meta corrente.
// Prefix every mirror field label so they're easy to spot in the editor.
add_filter( 'pb_gforms_referral_tracking_mirror_field_definitions', function( $fields, $form ) {
foreach ( $fields as &$field ) {
$field['label'] = 'Tracking: ' . $field['label'];
}
return $fields;
}, 10, 2 );pb_gforms_referral_tracking_docs_url
Reindirizza il link "Ulteriori informazioni nella documentazione" visualizzato nella schermata delle impostazioni. Utile per installazioni white-label o di agenzie che gestiscono la propria documentazione.
Parametri:
$url(corda) – L'URL della documentazione. Restituisci il tuo per sostituirlo.
// Point the settings-screen docs link at our own handbook.
add_filter( 'pb_gforms_referral_tracking_docs_url', function( $url ) {
return 'https://example.com/handbook/referral-tracking/';
} );