Conversion Tracking sendet native Meta Pixel-, TikTok Pixel- und Google Tag Manager dataLayer-Ereignisse von Ihren Kampagnenseiten, Spendenformularen und Bestätigungsseiten. Jedes Ereignis trägt den vollständigen Spendenkontext, einschließlich Betrag, Währung, Kampagnenname, Spendentyp und Zahlungsmethode, damit Ihre Werbeplattformen ihre Ausgaben basierend auf tatsächlichen Spendenerträgen optimieren können.
Verfügbar mit Charitable Pro 1.8.13.5 oder neuer auf Pro-, Agency- und Elite-Lizenzplänen.
Hauptmerkmale
- Meta Pixel
Purchase- undDonate-Ereignisse bei jeder bestätigten Spende auslösen - TikTok Pixel
CompletePayment-Ereignisse mit vollem Spendenwert und Währung auslösen - Reichhaltige Spendentaten an
window.dataLayerfür Google Tag Manager und GA4 pushen - Kampagnen-Seitenaufrufe und Öffnungen von Spendenformularen als Top-of-Funnel-Ereignisse verfolgen
- Spendenbetrag, Währung, Kampagnenname, Spendentyp und Zahlungsmethode in jede Konversion einbeziehen
- Besuchereinwilligung über die WP Consent API respektieren, mit einem Filter-Hook für benutzerdefinierte Einwilligungsmanager
- Doppelte Konversionen bei Aktualisierungen der Bestätigungsseite durch tab-bezogene Sitzungsverfolgung verhindern
- Tracking-Status für jede Spende im WordPress-Admin überprüfen
Warum Conversion Tracking verwenden?
Non-Profits, die bezahlte Anzeigen auf Meta, TikTok oder über Google Tag Manager schalten, benötigen eine genaue Konversionszuordnung, um ihre Werbeausgaben zu optimieren und den ROI nachzuweisen. Generische Pixel-Plugins lösen leere Ereignisse aus, die der Werbeplattform nur mitteilen, dass eine „Konversion“ stattgefunden hat. Charitable Conversion Tracking sendet den Spendenbetrag, die Währung und den Kampagnenkontext, den Meta- und TikTok-Algorithmen tatsächlich verwenden, um mehr Spender zu finden, die geben werden. Ihre Akquisitionskosten pro Spender sinken. Ihre Kampagnen lernen schneller.
Voraussetzungen
- Charitable Pro 1.8.13 oder neuer
- Ein Charitable Pro-, Agency- oder Elite-Lizenzplan
- WordPress 5.0 oder neuer
- PHP 7.2 oder neuer
- Optional: WP Consent API und ein kompatibles Einwilligungsmanagement-Plugin, wenn Sie Pixel durch die Einwilligung des Besuchers einschränken möchten
Erste Schritte
Aktivierung
- Laden Sie das Conversion Tracking Addon von Ihrem Charitable-Konto-Dashboard herunter.
- Gehen Sie in WordPress zu Plugins > Neu hinzufügen > Plugin hochladen und laden Sie die ZIP-Datei hoch.
- Aktivieren Sie Charitable – Conversion Tracking.
- Gehen Sie zu Charitable > Einstellungen > Erweitert > Conversion Tracking, um Ihre Pixel-IDs einzugeben.
Geben Sie Ihre Pixel-IDs ein
Jede Plattform hat ein einzelnes ID-Feld. Wenn ein Feld leer bleibt, wird diese Plattform deaktiviert. Es ist kein separater Ein-/Aus-Schalter erforderlich.
Nutzung
Conversion Tracking läuft automatisch, sobald Pixel-IDs eingegeben wurden. Es gibt keinen Block oder Shortcode, der platziert werden muss. Das Addon lauscht an drei Momenten auf Ihrer Website:
- Kampagnen-Seitenaufruf. Wird ausgelöst, wenn ein Besucher eine einzelne Kampagnenseite lädt.
- Spendenformular gerendert. Wird ausgelöst, wenn ein Spendenformular auf einer beliebigen Seite angezeigt wird.
- Spende bestätigt. Wird auf der Bestätigungsseite nach einer erfolgreichen Spende für alle Gateways ausgelöst, einschließlich Stripe, PayPal, Square, Braintree, Mollie und Offline.
Konfigurationsoptionen
Plattform-IDs
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
Meta-Pixel-ID | Zeichenkette | leer | Ihre 15-stellige Meta Pixel ID. Beispiel: 123456789012345 |
TikTok-Pixel-ID | Zeichenkette | leer | Ihre TikTok Pixel ID. Beispiel: CXXXXXXXXXXXXXXX |
GTM-Container-ID | Zeichenkette | leer | Ihre GTM Container ID. Charitable pusht dataLayer-Ereignisse, lädt aber GTM nicht selbst. Installieren Sie GTM über Ihr Theme oder ein separates Plugin. Beispiel: GTM-XXXXXXX |
Verhalten verfolgen
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
Pixel-Kampagnenaufrufe verfolgen | Kontrollkästchen | an | Feuern Sie ViewContent und charitable_campaign_view-Ereignisse, wenn ein Besucher eine Kampagnenseite lädt |
Pixel-Formularöffnungen verfolgen | Kontrollkästchen | an | Feuern Sie InitiateCheckout und charitable_initiate_checkout-Ereignisse, wenn ein Spendenformular gerendert wird |
Pixel-Einwilligungs-Integration | Kontrollkästchen | an | Prüfen Sie wp_has_consent( 'marketing' ), bevor Sie einen Pixel feuern |
Ereignisreferenz
| Moment | Meta Pixel | TikTok Pixel | GTM dataLayer-Ereignis |
|---|---|---|---|
| Kampagnenseitenaufruf | ViewContent | ViewContent | Spendenkampagnen-Aufruf |
| Spendenformular gerendert | InitiateCheckout | InitiateCheckout | Spenden-Checkout-Initiierung |
| Spende bestätigt | Purchase und Donate | CompletePayment | Spenden-Zahlung-Abschluss |
dataLayer Payload bei abgeschlossener Spende
window.dataLayer.push({
event: 'charitable_donation_complete',
donationId: 8937,
value: 28.87,
currency: 'USD',
campaignId: 7952,
campaignName: 'Clean Water for Rural Communities',
donationType: 'one-time',
paymentMethod: 'stripe'
});Anpassung
Mehrere Kampagnen bei einer Spende
Wenn eine Spende mehr als eine Kampagne abdeckt, verwendet die Conversion-Nachverfolgung die Kampagne mit dem höchsten Spendenbetrag als Attributionsziel. Der Gesamt value ist die Summe über alle Kampagnen. Verwenden Sie den charitable_pixel_primary_campaign -Filter, um diese Auswahl zu überschreiben.
Spendenstatus, die Conversions auslösen
Standardmäßig löst die Conversion-Nachverfolgung Pixel für Spenden mit den Status charitable-completed, charitable-preapproved und charitable-pending aus. Verwenden Sie den charitable_pixel_fire_statuses -Filter, um Status hinzuzufügen oder zu entfernen.
Fehlerbehebung
Keine Pixel-Events im Meta Events Manager oder TikTok Events Manager
Stellen Sie sicher, dass das Feld für die Pixel-ID für die jeweilige Plattform ausgefüllt ist und Ihr Besucher die Marketingzustimmung erteilt hat (oder dass pixel_consent_integration deaktiviert ist). Öffnen Sie die Netzwerk-Registerkarte Ihrer Browser-Entwicklertools auf der Empfangsseite und filtern Sie nach fbevents.js oder analytics.tiktok.com, um zu bestätigen, dass die Pixel-Bibliothek geladen wird.
GTM dataLayer-Events werden ausgelöst, aber GTM-Tags nicht
Charitable pusht Events in window.dataLayer, installiert aber nicht den GTM-Container selbst. Installieren Sie GTM über Ihren Theme-Header oder ein dediziertes GTM-Plugin. Bestätigen Sie, dass die Container-ID in GTM mit der in den Conversion-Tracking-Einstellungen eingegebenen ID übereinstimmt.
Events auf der Empfangsseite werden nicht ausgelöst
Überprüfen Sie den Spendenstatus. Offline-Spenden, die in charitable-pending verbleiben, ohne manuell genehmigt zu werden, lösen keine Pixel aus. Stellen Sie außerdem sicher, dass die Spende über die Empfangsseite und nicht über eine benutzerdefinierte Dankes-Weiterleitung erfolgt ist, da die Conversion-Nachverfolgung auf dem charitable_donation_receipt_page -Hook basiert.
Conversion zweimal nachverfolgt, wenn Besucher die Empfangsseite aktualisiert
Die Conversion-Nachverfolgung verwendet sessionStorage , das nach Spenden-ID verschlüsselt ist, um ein erneutes Auslösen im selben Browser-Tab zu verhindern. Das Öffnen der Empfangs-URL in einem neuen Tab wird als neue Sitzung gezählt und löst einmal aus, was das erwartete Verhalten ist.
Banner für inaktive Lizenz erscheint im Admin-Bereich
Stellen Sie sicher, dass Charitable Pro installiert und aktiviert ist, Ihre Lizenz auf dem Pro-, Agency- oder Elite-Plan ist und die Lizenz unter Charitable > Einstellungen > Lizenzen eingegeben und aktiviert wurde. Abgelaufene Lizenzen haben eine 30-tägige Kulanzfrist, bevor die Auslieferung blockiert wird.
Entwicklerressourcen
Hooks und Filter
charitable_pixel_fire_statuses— Array von Spendenstatus, die das Auslösen von Pixeln zulassencharitable_pixel_primary_campaign— Überschreibt die ausgewählte Kampagne für Spenden mit mehreren Kampagnencharitable_pixel_consent_granted— Fallback-Zuständigkeitsprüfung, wenn die WP Consent API nicht verfügbar istcharitable_ajax_donation_response— Hinzugefügt zu Charitable Pro Core; ermöglicht Add-ons, die AJAX-Spendenantwort für zukünftige Conversions API-Arbeiten anzureichern
Spenden-Metaschlüssel
_charitable_pixel_tracking_status—tracked,consent_blocked,status_blocked,license_blocked, odernot_configured_charitable_pixel_tracked_at— Unix-Zeitstempel des Tracking-Ereignisses_charitable_pixel_platforms— Array von Plattformen, die ausgelöst wurden, z. B.['meta', 'tiktok', 'gtm']_charitable_pixel_event_id— Eindeutige Ereignis-ID, die für die zukünftige Deduplizierung der Meta Conversions API reserviert ist
Einwilligungsintegration
Die Conversion-Nachverfolgung liest die Einwilligung über die WP Consent API, sofern verfügbar:
if ( function_exists( 'wp_has_consent' ) ) {
return (bool) wp_has_consent( 'marketing' );
}
return (bool) apply_filters( 'charitable_pixel_consent_granted', true, 'marketing' );Websites ohne Consent-Manager feuern Pixel standardmäßig. Websites mit einem kompatiblen Consent-Plugin (CookieYes, Complianz und andere, die die WP Consent API implementieren) respektieren die Einwilligung automatisch.
