Suivi des recommandations pour WPForms

Comment puis-je activer le plugin ?

Après avoir acheté Referral Source Tracking pour WPForms, vous devrez installer l'extension sur votre site WordPress. Voici comment procéder.

Étape 1: Installation

Connectez-vous à votre site WordPress et accédez à Extensions > Ajouter une extension > Téléverser une extension > Installez le fichier zip et activez-le.

Étape 2 : Enregistrer le plugin

Dans le menu de navigation de gauche, accédez à WPForms > Suivi des parrainages.

Saisissez votre clé de licence et activez-la.

Étape 3 : Activer la fonctionnalité

Après avoir activé votre licence, un onglet “ Général ” apparaîtra sur la page des paramètres de suivi des parrainages. Cliquez dessus, puis sur “ Enregistrer les modifications ”.

Voilà ! Le suivi des sources de référence sera désormais actif sur tous les formulaires existants et sur tous les nouveaux formulaires que vous créerez.

Détails des fonctionnalités

Sources qu'il détecte

Nous capturons l'URL de référence lorsqu'elle est disponible. et nous l'enregistrons dans l'entrée. Nous appliquons également des étiquettes conviviales aux plateformes courantes afin que la source soit facile à comprendre en un coup d'œil.

Voici la liste des sources qui sont étiquetées lorsqu'elles sont détectées :

• Google: Google Ads, Google Organic, Gemini
• Microsoft/Bing : Publicités Microsoft, Bing Organic
• Facebook : Publicités Facebook, Référencement naturel Facebook
• LinkedIn : Publicités LinkedIn, référencement naturel LinkedIn
• X (Twitter) : X Publicités, X Bio
• Reddit : Publicités Reddit, Reddit Organic
• TikTok : Publicités TikTok, TikTok Organic
• Pinterest : Publicités Pinterest, Résultats de recherche Pinterest
• Snapchat : Publicités Snapchat, Snapchat Organisé
• Autres moteurs de recherche : Yahoo, DuckDuckGo, Yandex
• Assistants IA (lorsqu'ils sont disponibles) : ChatGPT, Perplexité, Microsoft Copilot, Claude, Grok, DeepSeek
• Plateformes de messagerie (suivi des campagnes) : Mailchimp, Constant Contact, Salesforce Pardot, HubSpot
• Direct et Inconnu sont utilisées le cas échéant.
• Coutume Des sources peuvent également être ajoutées !

Paramètres UTM capturés

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

Identifiants de clics capturés

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

Étiquettes intelligentes

{pb_ref_source} – l’étiquette de la source de référence détectée (par défaut “ Inconnu ” lorsque la visite n’a pas pu être classée).

{pb_ref_params} – chaîne complète des paramètres de référence capturés (UTM et autres variables de requête conservés ensemble).

{pb_ref_referrer} – le référent du navigateur qui a amené le visiteur sur le site.

{pb_ref_utm_id} – capturé utm_id.

{pb_ref_utm_source} – capturé utm_source.

{pb_ref_utm_medium} – capturé utm_medium.

{pb_ref_utm_campaign} – capturé utm_campaign.

{pb_ref_utm_term} – capturé utm_term.

{pb_ref_utm_content} – capturé utm_content.

{pb_ref_clid} – l’identifiant du premier clic détecté (gclid, fbclid, msclkid, etc.).

Traductions

Ce plugin est entièrement compatible avec la traduction. Vous pouvez le traduire dans n'importe quelle langue grâce à l'outil gratuit de traduction. Loco Translate plugin ou tout autre outil de traduction WordPress.

Langue par défaut : anglais (en_US)

FAQ

Est-ce compatible avec WPForms Lite ?

Oui. La capture du suivi des parrainages et le traitement des étiquettes intelligentes fonctionnent avec WPForms Lite. Cependant, WPForms Lite possède une interface utilisateur de gestion des entrées limitée par rapport à la version Pro : les colonnes de la liste des entrées, la barre latérale de suivi des références pour une seule entrée et l’intégration de l’exportation CSV nécessitent WPForms Pro.

Puis-je exporter les données ?

Oui. Les valeurs de suivi sont incluses dans les exportations CSV de WPForms. Tous les champs de référence (source, référent, UTM, ID de clic, etc.) sont automatiquement ajoutés comme colonnes d'exportation.

Que capture exactement ce plugin ?

Nous capturons les champs d'attribution communs et les stockons avec chaque entrée WPForms, notamment Paramètres UTM (source, support, campagne, terme, contenu), Identifiants de clic (gclid, msclkid, gbraid/wbraid, etc.), le URL de référence d'origine, et le contexte de la page de destination associée, afin que vous puissiez clairement voir d'où provient chaque prospect.

Puis-je ajouter des sources personnalisées ?

Oui ! Qu'il s'agisse d'un site de parrainage, d'un partenariat d'affiliation, etc., vous pouvez ajouter des sources personnalisées avec des étiquettes claires.

Où sont enregistrées les données de parrainage ?

Dans votre base de données WordPress, dans une table dédiée du plugin et liée aux entrées WPForms. Nous n'envoyons aucune donnée de conversion ni d'événement aux plateformes publicitaires.

S’agit-il d’une attribution au premier contact ou au dernier contact ?

Ce plugin se concentre sur attribution au premier contact en stockant le original Paramètres de référence et de campagne qui ont amené le visiteur sur votre site (dans la fenêtre de rétention).

Combien de temps conserve-t-il les données d'attribution d'un visiteur ?

La fenêtre de rétention est 7 jours. Si un visiteur soumet un formulaire dans les 7 jours suivant sa première visite enregistrée, les valeurs d'attribution d'origine seront appliquées à l'entrée.

Est-ce compatible avec la mise en cache/les CDN ?

En général, oui. Le suivi s'effectue côté client, la plupart des configurations de cache/CDN fonctionnent donc correctement. Si vous utilisez une optimisation poussée des scripts (minification/report), excluez les scripts du plugin ci-dessous et effectuez un test :

• /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

Est-ce compatible avec les formulaires WPForms prenant en charge AJAX ?

Oui. Cela fonctionne avec les formulaires AJAX (par défaut de WPForms) et les soumissions standard.

Puis-je suivre plusieurs formulaires ?

Oui. Cela fonctionne pour tous vos formulaires WPForms : chaque soumission enregistre ses propres valeurs d’attribution pour cette entrée.

Est-ce que cela remplace le suivi des conversions GA4 / Google Ads ?

Non. Ce plugin ne déclenche pas de pixels ni n'envoie d'événements de conversion à Google Analytics (GA4) ou aux plateformes publicitaires. Il stocke les données d'attribution. à l'intérieur de l'entrée WPForms, afin que votre équipe puisse consulter les données sources des prospects directement dans WordPress et les exporter.

Collecte-t-il des données personnelles ?

Par défaut, il capture les données d'attribution (UTM, gclid, URL de référence). Cela fonctionne pas La collecte de données personnelles supplémentaires est activée par défaut. Vos champs de formulaire et les paramètres inclus dans les URL sont gérés par la configuration de votre site et de vos actions marketing.

Est-ce conforme au RGPD/CCPA ?

Ce plugin est compatible avec le RGPD et le CCPA. Il stocke les données d'attribution avec vos articles et ne transmet aucun événement aux plateformes publicitaires. Il vous incombe d'obtenir le consentement, de justifier l'intérêt légitime et d'assurer une information appropriée à votre configuration.

Est-ce compatible avec un réseau WordPress Multisite ?

TL;DR

• Licence illimitée : Activez le mode réseau une seule fois ; une seule touche suffit pour gérer chaque Paramètres et assistance du sous-site.
• Activé par le réseau : Tous les sous-sites utilisent le suivi des parrainages et reçoivent les mises à jour immédiatement.
• Formule limitée / sans licence de sous-site : Le suivi reste activé, mais les paramètres du sous-site sont en lecture seule.
• L'assistance est soumise à la licence : Les sites couverts par la clé active sont éligibles.

Oui, le plugin fonctionne immédiatement sur chaque sous-site dès son activation réseau.Aucune configuration manuelle n'est requise. Chaque sous-site peut utiliser le suivi et recevoir les mises à jour même sans licence locale. Pour modifier les paramètres d'un formulaire ou obtenir une assistance directe sur un sous-site, vous devez toutefois activer une licence sur celui-ci.

Si vous disposez d'une licence illimitée, vous pouvez activer le mode réseau depuis le site principal et déployer cette clé unique sur tous les sous-sites en une seule fois (avec suivi de la progression en temps réel). Ces sous-sites hériteront automatiquement des paramètres et du support liés à la licence.

Crochets

Actes

pb_wpforms_referral_tracking_loaded

Se déclenche une fois le plugin entièrement initialisé : toutes les classes sont chargées, les hooks enregistrés et l’API est prête. Il s’agit du point d’entrée fiable pour les modules complémentaires ou les plugins associés qui étendent le suivi des sources de référence.

Paramètres :

• $plugin (Plugin) — L'instance du 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 );
    }
} );

Filtres

pb_wpforms_referral_tracking_enabled

Permet de désactiver ou non le suivi des parrainages pour un formulaire spécifique. Renvoie « true » pour activer le suivi, « false » pour le désactiver, indépendamment du paramètre par formulaire ou de la valeur par défaut globale.

Paramètres :

• $enabled (booléen) — Indique si le suivi est actuellement activé.
• $form_id (int) — L'identifiant du formulaire actuel.
• $form_data (tableau|null) — Le tableau de données du formulaire, ou null s'il n'est pas disponible.

Exemple d'utilisation :

// 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

Modifiez la table de correspondance des balises intelligentes qui définit les balises intelligentes disponibles et les clés de suivi auxquelles elles sont associées. Utilisez-la pour ajouter des balises intelligentes entièrement personnalisées ou renommer celles existantes.

Paramètres :

• $map (tableau) — Tableau associatif d'étiquettes => clé de suivi (par exemple. 'pb_ref_source' => 'source').

Exemple d'utilisation :

// 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

Filtrer une valeur de suivi brute avant son utilisation pour remplacer une étiquette intelligente dans une notification ou une confirmation. Utile pour nettoyer ou transformer des valeurs spécifiques.

Paramètres :

• $value (chaîne) — La valeur de suivi brute.
• $tag (chaîne) — La clé Smart Tag (par exemple. pb_ref_source).
• $form_data (tableau) — Le tableau de données du formulaire.
• $fields (tableau) — Les champs de saisie.
• $entry_id (int) — L'identifiant de l'entrée.

Exemple d'utilisation :

// 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

Filtrer la valeur de la balise intelligente entièrement formatée après traitement.

Paramètres :

• $formatted (chaîne) — La chaîne de sortie formatée.
• $tag (chaîne) — La clé Smart Tag.
• $form_data (tableau) — Le tableau de données du formulaire.
• $fields (tableau) — Les champs de saisie.
• $entry_id (int) — L'identifiant de l'entrée.

// 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

Modifiez la valeur par défaut utilisée lorsqu'un champ de suivi est vide au moment de la soumission. La valeur par défaut est “ Inconnu ”.

Paramètres :

• $default (chaîne) — La valeur par défaut actuelle (“ Inconnu ”).
• $key (chaîne) — Clé de contexte : source, referrer, ou 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

Remplacez l'intégralité de l'objet de configuration JavaScript côté client avant qu'il ne soit transmis au script de suivi. Vous bénéficiez ainsi d'un contrôle total sur les paramètres des cookies, les modèles de détection des sources, les sources connues, les supports payants, et bien plus encore.

Paramètres :

• $config (tableau) — Le tableau de configuration JS complet.

// 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

Injectez par programmation des règles de source personnalisées qui s'exécutent en parallèle des règles configurées dans l'interface d'administration. Les règles issues de ce filtre sont fusionnées avec les règles d'interface utilisateur enregistrées et triées par priorité avant d'être transmises au frontend.

Paramètres :

• $sources (tableau) — Tableau vide. Renvoie un tableau de tableaux de règles à ajouter.

Chaque règle doit comporter : label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains ou equals), matchValue, et éventuellement priority (valeur par défaut 10, les valeurs les plus élevées s'exécutent en premier).

// 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

Contrôlez si les ressources front-end du plugin (bibliothèque de cookies et script de suivi) sont chargées. Retournez « false » pour désactiver complètement leur chargement sur une page ou sous certaines conditions.

Paramètres :

• $enqueue (booléen) — Indique si les ressources doivent être mises en file d'attente. Par défaut 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;
} );