Empfehlungs-Tracking für WPForms

Wie aktiviere ich das Plugin?

Nach dem Kauf von Referral Source Tracking für WPForms müssen Sie das Plugin auf Ihrer WordPress-Website installieren. Wir erklären Ihnen den Vorgang Schritt für Schritt.

Schritt 1: Installation

Melden Sie sich bei Ihrer WordPress-Website an und navigieren Sie zu Plugins > Plugin hinzufügen > Plugin hochladen > Installieren Sie die ZIP-Datei und aktivieren Sie sie.

Schritt 2: Plugin registrieren

Navigieren Sie in der linken Navigation zu WPForms > Referral Tracking.

Geben Sie Ihren Lizenzschlüssel ein und aktivieren Sie ihn.

Schritt 3: Funktion aktivieren

Nach der Aktivierung Ihrer Lizenz erscheint auf der Seite mit den Einstellungen für die Empfehlungsverfolgung ein Tab “Allgemein”. Klicken Sie darauf und anschließend auf “Änderungen speichern”.

Das war's! Ab sofort ist die Nachverfolgung der Verweisquelle für alle bestehenden und neu erstellten Formulare aktiv.

Funktionsdetails

Quellen, die es erkennt

Wir erfassen die Referrer-URL, sofern eine verfügbar ist. und speichern es im Eintrag. Wir verwenden außerdem benutzerfreundliche Labels für gängige Plattformen, damit der Quellcode auf einen Blick verständlich ist.

Hier ist die Liste der Quellen, die bei Erkennung gekennzeichnet werden:

• Google: Google Ads, organische Google-Suchergebnisse, Gemini
• Microsoft/Bing: Microsoft Ads, Bing Organic
• Facebook: Facebook-Anzeigen, organisches Facebook-Suchverhalten
• LinkedIn: LinkedIn-Anzeigen, LinkedIn-Organische Inhalte
• X (Twitter): X Anzeigen, X Organisch
• Reddit: Reddit-Anzeigen, Reddit Organic
• TikTok: TikTok-Anzeigen, TikTok-Organik
• Pinterest: Pinterest-Anzeigen, Pinterest Organic
• Snapchat: Snapchat-Anzeigen, Snapchat-Organik
• Andere Suchmaschinen: Yahoo, DuckDuckGo, Yandex
• KI-Assistenten (sofern verfügbar): ChatGPT, Perplexity, Microsoft Copilot, Claude, Grok, DeepSeek
• E-Mail-Plattformen (Kampagnen-Tracking): Mailchimp, Constant Contact, Salesforce Pardot, HubSpot
• Direkt und Unbekannt werden gegebenenfalls verwendet.
• Brauch Quellen können ebenfalls hinzugefügt werden!

UTM-Parameter, die es erfasst

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

Erfasste Klick-IDs

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

Smart Tags

{pb_ref_source} – die Bezeichnung der erkannten Verweisquelle (standardmäßig “Unbekannt”, wenn der Besuch nicht klassifiziert werden konnte).

{pb_ref_params} – vollständige Zeichenkette der erfassten Referrer-Parameter (UTMs und andere Abfragevariablen werden zusammengehalten).

{pb_ref_referrer} – Browser-Referrer, der den Besucher auf die Website geführt hat.

{pb_ref_utm_id} – erfasst utm_id.

{pb_ref_utm_source} – erfasst utm_source.

{pb_ref_utm_medium} – erfasst utm_medium.

{pb_ref_utm_campaign} – erfasst utm_campaign.

{pb_ref_utm_term} – erfasst utm_term.

{pb_ref_utm_content} – erfasst utm_content.

{pb_ref_clid} – die erste erkannte Klick-ID (gclid, fbclid, msclkid usw.).

Übersetzungen

Dieses Plugin ist vollständig übersetzungsbereit. Sie können es mit dem kostenlosen Tool in jede beliebige Sprache übersetzen. Loco Translate Plugin oder ein anderes WordPress-Übersetzungstool.

Standardsprache: Englisch (en_US)

FAQs

Funktioniert es mit WPForms Lite?

Ja. Die Erfassung von Empfehlungsdaten und die Verarbeitung von Smart Tags funktionieren mit WPForms Lite. Allerdings bietet WPForms Lite im Vergleich zu Pro eine eingeschränkte Benutzeroberfläche für die Eintragsverwaltung – Spalten für die Eintragsliste, die Seitenleiste zur Verfolgung von Empfehlungen für einzelne Einträge und die CSV-Exportintegration erfordern WPForms Pro.

Kann ich die Daten exportieren?

Ja. Tracking-Werte sind in den WPForms-CSV-Exporten enthalten. Alle Verweisfelder (Quelle, Referrer, UTM-Parameter, Klick-ID usw.) werden automatisch als Exportspalten hinzugefügt.

Was genau erfasst das Plugin?

Wir erfassen gängige Attributfelder und speichern sie zusammen mit jedem WPForms-Eintrag, einschließlich UTM-Parameter (Quelle, Medium, Kampagne, Begriff, Inhalt), Klick-IDs (gclid, msclkid, gbraid/wbraid usw.), die ursprüngliche Referrer-URL, und den zugehörigen Kontext der Landingpage, damit Sie klar erkennen können, woher jeder Lead stammt.

Kann ich benutzerdefinierte Datenquellen hinzufügen?

Ja! Ob Empfehlungsseite, Affiliate-Partnerschaft usw., Sie können benutzerdefinierte Quellen mit eindeutigen Bezeichnungen hinzufügen.

Wo werden die Empfehlungsdaten gespeichert?

In Ihrer WordPress-Datenbank in einer separaten Plugin-Tabelle, die mit den WPForms-Einträgen verknüpft ist. Wir senden keine Conversions oder Ereignisse an Werbeplattformen.

Handelt es sich um First-Touch- oder Last-Touch-Attribution?

Dieses Plugin konzentriert sich auf Zuordnung zum ersten Kontakt durch Speichern der Original Referrer- und Kampagnenparameter, die den Besucher (innerhalb des Retention-Fensters) auf Ihre Website geführt haben.

Wie lange werden die Besucherdaten gespeichert?

Das Aufbewahrungsfenster ist 7 Tage. Wenn ein Besucher innerhalb von 7 Tagen nach seinem ersten erfassten Besuch ein Formular einreicht, werden die ursprünglichen Attributionswerte auf den Eintrag angewendet.

Funktioniert es mit Caching/CDNs?

Normalerweise ja. Das Tracking läuft clientseitig, daher funktionieren die meisten Caching-/CDN-Konfigurationen problemlos. Wenn Sie eine aggressive Skriptoptimierung (Minifizierung/Verzögerung) verwenden, schließen Sie die unten aufgeführten Plugin-Skripte aus und testen Sie eine Übermittlung:

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

Funktioniert es mit AJAX-fähigen WPForms?

Ja. Es funktioniert sowohl mit AJAX-Formularen (Standardeinstellung von WPForms) als auch mit herkömmlichen Formularübermittlungen.

Kann ich mehr als ein Formular verfolgen?

Ja. Es funktioniert für alle Ihre WPForms – jede Einsendung speichert ihre eigenen Attributierungswerte für diesen Eintrag.

Ersetzt dies das Conversion-Tracking von GA4 / Google Ads?

Nein. Dieses Plugin löst keine Pixel aus und sendet keine Conversion-Ereignisse an GA4 oder Werbeplattformen. Es speichert Attributionsdaten. innerhalb des WPForms-Eintrags, So kann Ihr Team die Lead-Quelldaten direkt in WordPress einsehen und exportieren.

Werden personenbezogene Daten erfasst?

Standardmäßig erfasst es Attributionsdaten (UTMs, gclid, Referrer-URLs). Es tut nicht Zusätzliche personenbezogene Daten werden standardmäßig erfasst. Ihre Formularfelder und alle in URLs enthaltenen Parameter werden durch Ihre Website- und Marketingeinstellungen gesteuert.

Ist es DSGVO-/CCPA-konform?

Es kann DSGVO-/CCPA-konform verwendet werden. Das Plugin speichert die Zuordnungsdaten zusammen mit Ihren Einträgen und übermittelt keine Ereignisse an Werbeplattformen. Sie sind für die Einwilligung/das berechtigte Interesse und die korrekte Offenlegung in Ihrem spezifischen Setup verantwortlich.

Funktioniert es mit einem WordPress-Multisite-Netzwerk?

TL;DR

• Unbegrenzte Lizenz: Netzwerkmodus einmalig aktivieren; eine Taste kann verwaltet werden jeder Einstellungen und Support für die Subsite.
• Netzwerkaktiviert: Alle Subsites nutzen Referral-Tracking und erhalten Aktualisierungen sofort.
• Eingeschränkter Tarif / keine Unterstandortlizenz: Die Nachverfolgung bleibt aktiviert, die Einstellungen der Unterseite sind jedoch schreibgeschützt.
• Der Support richtet sich nach der Lizenz: Standorte, die durch den aktiven Schlüssel abgedeckt sind, sind teilnahmeberechtigt.

Ja, das Plugin läuft sofort nach der Netzwerkaktivierung auf jeder Subsite.– Keine manuelle Einrichtung erforderlich. Jede Subsite kann das Tracking nutzen und erhält Aktualisierungen auch ohne lokale Lizenz. Um Formulareinstellungen zu ändern oder direkten Support auf einer Subsite zu erhalten, muss dort jedoch weiterhin eine Lizenz aktiviert werden.

Mit einer Unlimited-Lizenz können Sie den Netzwerkmodus auf der Hauptseite aktivieren und diesen Schlüssel in einem Schritt (mit Live-Fortschritt) an alle Subsites verteilen. Diese Subsites übernehmen die lizenzverwalteten Einstellungen und werden automatisch unterstützt.

Haken

Aktionen

pb_wpforms_referral_tracking_loaded

Wird ausgelöst, nachdem das Plugin vollständig initialisiert wurde – alle Klassen sind geladen, Hooks registriert und die API ist einsatzbereit. Dies ist der zuverlässige Startpunkt für Add-ons oder Begleit-Plugins, die Referral Source Tracking erweitern.

Parameter:

• $plugin (Plugin) — Die Plugin-Instanz.

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 );
    }
} );

Filter

pb_wpforms_referral_tracking_enabled

Legen Sie fest, ob die Weiterleitungsverfolgung für ein bestimmtes Formular aktiviert ist. Geben Sie „true“ zurück, um die Verfolgung zu erzwingen, und „false“, um sie zu deaktivieren, unabhängig von der Einstellung für das jeweilige Formular oder der globalen Standardeinstellung.

Parameter:

• $enabled (bool) — Ob die Nachverfolgung aktuell aktiviert ist.
• $form_id (int) — Die ID des aktuellen Formulars.
• $form_data (array|null) — Das Formulardaten-Array oder null, falls nicht verfügbar.

Anwendungsbeispiel:

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

Ändern Sie die Smart-Tag-Zuordnung, die festlegt, welche Smart Tags verfügbar sind und welchen Tracking-Schlüsseln sie zugeordnet sind. Verwenden Sie diese Funktion, um vollständig benutzerdefinierte Smart Tags hinzuzufügen oder vorhandene umzubenennen.

Parameter:

• $map (Array) — Assoziatives Array von Tag => Tracking-Schlüssel (z. B. 'pb_ref_source' => 'source').

Anwendungsbeispiel:

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

Filtern Sie einen Rohdaten-Trackingwert, bevor er in einer Benachrichtigung oder Bestätigung anstelle eines Smart Tags verwendet wird. Dies ist nützlich, um bestimmte Werte zu bereinigen oder zu transformieren.

Parameter:

• $value (Zeichenkette) — Der Roh-Tracking-Wert.
• $tag (Zeichenkette) — Der Smart-Tag-Schlüssel (z. B. pb_ref_source).
• $form_data (Array) — Das Formulardaten-Array.
• $fields (Array) — Die Eingabefelder.
• $entry_id (int) — Die Eintrags-ID.

Anwendungsbeispiel:

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

Filtern Sie den vollständig formatierten Smart-Tag-Wert nach der Verarbeitung.

Parameter:

• $formatted (Zeichenkette) — Die formatierte Ausgabezeichenfolge.
• $tag (Zeichenkette) — Der Smart-Tag-Schlüssel.
• $form_data (Array) — Das Formulardaten-Array.
• $fields (Array) — Die Eingabefelder.
• $entry_id (int) — Die Eintrags-ID.

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

Überschreiben Sie den Ausweichwert, der verwendet wird, wenn ein Tracking-Feld zum Zeitpunkt der Übermittlung leer ist. Der Standardwert ist “Unbekannt”.

Parameter:

• $default (Zeichenkette) — Der aktuelle Standardwert (“Unbekannt”).
• $key (Zeichenkette) — Kontextschlüssel: source, referrer, oder 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

Überschreiben Sie das gesamte JavaScript-Konfigurationsobjekt im Frontend, bevor es an das Tracking-Skript übergeben wird. Dadurch erhalten Sie die volle Kontrolle über Cookie-Einstellungen, Quellenerkennungsmuster, bekannte Quellen, bezahlte Medien und mehr.

Parameter:

• $config (Array) — Das vollständige JS-Konfigurationsarray.

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

Programmatisch können benutzerdefinierte Quellregeln eingefügt werden, die parallel zu den in der Admin-Oberfläche konfigurierten Regeln ausgeführt werden. Die Regeln dieses Filters werden mit gespeicherten UI-Regeln zusammengeführt und nach Priorität sortiert, bevor sie an das Frontend übergeben werden.

Parameter:

• $sources (Array) — Leeres Array. Gibt ein Array von Regel-Arrays zurück, die addiert werden sollen.

Jede Regel muss Folgendes enthalten: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains oder equals), matchValue, und optional priority (Standardwert 10, höhere Werte werden zuerst ausgeführt).

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

Steuern Sie, ob die Frontend-Ressourcen des Plugins (Cookie-Bibliothek und Tracking-Skript) geladen werden. Geben Sie „false“ ein, um das Laden auf einer Seite oder unter einer bestimmten Bedingung vollständig zu deaktivieren.

Parameter:

• $enqueue (bool) — Gibt an, ob Assets in die Warteschlange gestellt werden sollen. Standardwert 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;
} );