Monitoraggio dei referral per WPForms

Come faccio ad abilitare il plugin?

Dopo aver acquistato Referral Source Tracking per WPForms, dovrai installare il plug-in sul tuo sito web WordPress. Vediamo come procedere passo dopo passo.

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 WPForms > Referral Tracking.

Inserisci la tua chiave di licenza e attivala.

Passaggio 3: Attiva la funzione

Dopo aver attivato la licenza, apparirà una scheda “Generale” nella pagina delle impostazioni di Referral Tracking, fai clic su di essa e fai clic su “Salva modifiche”.

Ecco fatto! Ora il tracciamento della fonte di rinvio sarà attivo su qualsiasi modulo esistente o nuovo modulo che crei.

Dettagli della funzione

Fonti che rileva

Acquisisciamo l'URL del referrer quando ne è disponibile uno e lo memorizziamo sulla voce. Applichiamo anche etichette intuitive per le piattaforme più comuni, in modo che la fonte sia facile da comprendere a colpo d'occhio.

Ecco l'elenco delle fonti che vengono etichettate quando vengono rilevate:

• Google: Google Ads, Google Organico, Gemini
• Microsoft/Bing Microsoft Ads, Bing Organico
• Facebook: Facebook Ads, Facebook Organico
• LinkedIn: LinkedIn Ads, LinkedIn Organico
• X (Twitter): Annunci X, X Organico
• Reddit Reddit Ads, Reddit Organic
• TikTok: TikTok Ads, TikTok Organic
• Pinterest Pinterest Ads, Pinterest Organico
• Snapchat: Inserzioni Snapchat, Snapchat Organico
• Altri motori di ricerca: Yahoo, DuckDuckGo, Yandex
• Assistenti IA (quando disponibili): ChatGPT, Perplexity, Microsoft Copilot, Claude, Grok, DeepSeek
• Piattaforme di posta elettronica (tracciamento delle campagne): Mailchimp, Constant Contact, Salesforce Pardot, HubSpot
• Diretto e Sconosciuto vengono usati quando appropriato.
• Personalizzato È possibile aggiungere anche le fonti!

Parametri UTM che acquisisce

• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content
• utm_id

ID clic acquisiti

• gclid
• gbraid
• wbraid
• msclkid
• li_fat_id
• rdt_cid
• ttclid
• pin_cid
• snap_cid
• mc_cid
• mc_eid
• dclid

Smart Tags

{pb_ref_source} – l'etichetta della fonte di riferimento rilevata (impostata su "Sconosciuto" quando la visita non può essere classificata).

{pb_ref_params} – stringa completa dei parametri di riferimento acquisiti (UTM e altre variabili di query mantenute insieme).

{pb_ref_referrer} – browser di riferimento che ha indirizzato il visitatore al sito.

{pb_ref_utm_id} – catturato utm_id.

{pb_ref_utm_source} – catturato utm_source.

{pb_ref_utm_medium} – catturato utm_medium.

{pb_ref_utm_campaign} – catturato utm_campaign.

{pb_ref_utm_term} – catturato utm_term.

{pb_ref_utm_content} – catturato utm_content.

{pb_ref_clid} – l'ID del primo clic rilevato (gclid, fbclid, msclkid, ecc.).

Traduzioni

Questo plugin è completamente pronto per la traduzione. Puoi tradurlo in qualsiasi lingua utilizzando il plugin gratuito Loco Translate plugin o qualsiasi altro strumento di traduzione per WordPress.

Lingua predefinita: inglese (en_US)

Domande frequenti

Funziona con WPForms Lite?

Sì. L'acquisizione del tracciamento dei referral e l'elaborazione degli Smart Tag funzionano con WPForms Lite. Tuttavia, WPForms Lite ha un'interfaccia utente di gestione delle voci limitata rispetto a Pro: le colonne dell'elenco delle voci, la barra laterale per il monitoraggio dei referral a voce singola e l'integrazione con l'esportazione CSV richiedono WPForms Pro.

Posso esportare i dati?

Sì. I valori di tracciamento sono inclusi nelle esportazioni CSV di WPForms. Tutti i campi di riferimento (origine, referrer, UTM, ID clic e altro) vengono aggiunti automaticamente come colonne di esportazione.

Che cosa cattura esattamente il plugin?

Acquisiamo i campi di attribuzione comuni e li memorizziamo insieme a ogni voce di WPForms, inclusi 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 chiaramente da dove proviene ogni lead.

Posso aggiungere sorgenti personalizzate?

Sì! Che si tratti di un sito di referral, di una partnership di affiliazione ecc., puoi aggiungere fonti personalizzate con etichette chiare.

Dove vengono salvati i dati relativi alle segnalazioni?

Nel database di WordPress, in una tabella dedicata ai plugin, collegata alle voci di WPForms. Non inviamo conversioni o eventi alle piattaforme pubblicitarie.

Si tratta di un'attribuzione al primo o all'ultimo contatto?

Questo plugin si concentra su attribuzione del primo contatto memorizzando il originale Referrer e parametri della campagna che hanno portato il visitatore al tuo sito (entro il periodo di fidelizzazione).

Per quanto tempo conserva i dati di attribuzione di un visitatore?

La finestra di conservazione è 7 giorni. Se un visitatore invia un modulo entro 7 giorni dalla sua prima visita tracciata, i valori di attribuzione originali verranno applicati alla voce.

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/deferred), escludere gli script del plugin indicati di seguito ed eseguire un test di invio:

• /wp-content/plugins/pb-wpforms-referral-tracking/assets/dist/js.cookie.min.js
• /wp-content/plugins/pb-wpforms-referral-tracking/assets/js/front-end.js

Funziona con WPForms che supporta AJAX?

Sì. Funziona con i moduli AJAX (WPForms predefinito) e con gli invii standard.

Posso monitorare più di un modulo?

Sì. Funziona con tutti i tuoi moduli WPForms: ogni invio salva i propri valori di attribuzione per quella voce.

Questo sistema sostituisce il monitoraggio delle conversioni di GA4/Google Ads?

No. Questo plugin non attiva pixel né invia eventi di conversione a GA4 o alle piattaforme pubblicitarie. Memorizza i dati di attribuzione. all'interno della voce WPForms, in modo che il tuo team possa visualizzare i dati relativi alla fonte dei lead direttamente in WordPress ed esportarli.

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?

Può essere utilizzato in modo conforme al GDPR/CCPA. Il plugin memorizza i dati di attribuzione insieme ai tuoi post e non trasmette gli eventi alle piattaforme pubblicitarie. Sei responsabile del consenso/interesse legittimo e della corretta informativa per la tua specifica configurazione.

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 rimane attivo, ma le impostazioni del sottosito sono di sola lettura.
• L'assistenza segue la licenza: I siti coperti dalla chiave attiva sono idonei.

Sì; il plugin funziona immediatamente su ogni sottosito non appena lo si attiva a livello di rete.—Non è richiesta alcuna configurazione manuale. Ogni sottosito può utilizzare il tracciamento e ricevere aggiornamenti anche senza una licenza locale. Per modificare le impostazioni a livello di modulo o ottenere assistenza diretta su un sottosito, è comunque necessario attivare una licenza in quel sito.

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.

Ganci

Azioni

pb_wpforms_referral_tracking_loaded

Si attiva dopo che il plugin è stato completamente inizializzato: tutte le classi sono state caricate, gli hook sono stati registrati e l'API è pronta. Questo è il punto di avvio affidabile per i componenti aggiuntivi o i plugin complementari che estendono Referral Source Tracking.

Parametri:

• $plugin (Collegare) — L'istanza del plugin.

add_action( 'pb_wpforms_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_wpforms_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_data (array|null) — L'array dei dati del modulo, oppure null se non disponibile.

Esempio di utilizzo:

// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_wpforms_referral_tracking_enabled', function( $enabled, $form_id, $form_data ) {
    $excluded_form_ids = [ 12, 27 ];
    if ( in_array( $form_id, $excluded_form_ids, true ) ) {
        return false;
    }
    return $enabled;
}, 10, 3 );

pb_wpforms_referral_tracking_merge_tag_map

Modifica la mappa degli Smart Tag che definisce quali Smart Tag sono disponibili e a quali chiavi di tracciamento corrispondono. Utilizza questa funzione per aggiungere Smart Tag completamente personalizzati o rinominare quelli esistenti.

Parametri:

• $map (vettore) — Array associativo di tag => chiave di tracciamento (es. 'pb_ref_source' => 'source').

Esempio di utilizzo:

// Add a custom Smart Tag that maps to a custom tracking key.
add_filter( 'pb_wpforms_referral_tracking_merge_tag_map', function( $map ) {
    $map['pb_ref_landing_page'] = 'landing_page';
    return $map;
} );

pb_wpforms_referral_tracking_value

Filtra un valore di tracciamento grezzo prima che venga utilizzato per sostituire uno Smart Tag in una notifica o conferma. Utile per sanificare o trasformare valori specifici.

Parametri:

• $value (corda) — Il valore di tracciamento grezzo.
• $tag (corda) — La chiave Smart Tag (ad esempio. pb_ref_source).
• $form_data (vettore) — L'array dei dati del modulo.
• $fields (vettore) — I campi di inserimento.
• $entry_id (int) — L'ID della voce.

Esempio di utilizzo:

// Truncate long referrer URLs in Smart Tag output.
add_filter( 'pb_wpforms_referral_tracking_value', function( $value, $tag, $form_data, $fields, $entry_id ) {
    if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
        return substr( $value, 0, 100 ) . '…';
    }
    return $value;
}, 10, 5 );

pb_wpforms_referral_tracking_formatted_value

Filtra il valore Smart Tag completamente formattato dopo l'elaborazione.

Parametri:

• $formatted (corda) — La stringa di output formattata.
• $tag (corda) — La chiave Smart Tag.
• $form_data (vettore) — L'array dei dati del modulo.
• $fields (vettore) — I campi di inserimento.
• $entry_id (int) — L'ID della voce.

// Wrap the source value in a bold tag in HTML notifications.
add_filter( 'pb_wpforms_referral_tracking_formatted_value', function( $formatted, $tag, $form_data, $fields, $entry_id ) {
    if ( $tag === 'pb_ref_source' ) {
        return '<strong>' . esc_html( $formatted ) . '</strong>';
    }
    return $formatted;
}, 10, 5 );

pb_wpforms_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) — Legenda del contesto: source, referrer, O front_end.

// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_wpforms_referral_tracking_default_value', function( $default, $key ) {
    if ( $key === 'source' ) {
        return 'Direct';
    }
    return $default;
}, 10, 2 );

pb_wpforms_referral_tracking_js_config

Sovrascrivi l'intero oggetto di configurazione JavaScript front-end prima che venga passato allo script di tracciamento. Questo ti offre il pieno controllo sulle impostazioni dei cookie, sui modelli di rilevamento della fonte, sulle fonti note, sui mezzi a pagamento e altro ancora.

Parametri:

• $config (vettore) — L'intero array di configurazione JS.

// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_wpforms_referral_tracking_js_config', function( $config ) {
    $config['cookieExpiry'] = 30;

    // Add "social" as a paid medium indicator.
    $config['paidMediums'][] = 'social';

    // Add a custom source pattern for an internal platform.
    $config['sourcePatterns']['custom_platforms'][] = [
        'pattern' => 'myplatform\.com',
        'name'    => 'My Platform',
    ];

    return $config;
} );

pb_wpforms_referral_tracking_custom_sources

Consente di iniettare a livello di codice regole di origine personalizzate che vengono eseguite insieme alle regole configurate nell'interfaccia utente di amministrazione. Le regole di questo filtro vengono unite alle regole salvate nell'interfaccia utente e ordinate per priorità prima di essere passate al front-end.

Parametri:

• $sources (vettore) — Array vuoto. Restituisce un array di array di regole da aggiungere.

Ogni regola deve avere: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains o equals), matchValue, e facoltativamente priority (valore predefinito 10, i valori più alti vengono eseguiti per primi).

// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_wpforms_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_wpforms_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) — Se mettere in coda le risorse. Predefinito true.

// Disable tracking assets on the homepage only.
add_filter( 'pb_wpforms_referral_tracking_enqueue_assets', function( $enqueue ) {
    if ( is_front_page() ) {
        return false;
    }
    return $enqueue;
} );