Marketing Revolution: Einrichtung und Hilfe

Laden Sie die Release-ZIP-Datei über Modul > "Module Manager" > "Upload a module" hoch und installieren Sie sie. Öffnen Sie "Marketing-Addons > Übersicht". Konfigurieren Sie Ziele unter "Marketing-Addons > Plattformen" und gemeinsame Einstellungen unter "Marketing-Addons > Einstellungen".

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.

Beginnen Sie mit einem Ziel. Entscheiden Sie, ob GA4 direkt oder über Ihren GTM-Container ausgeführt werden soll. Wenn beide Wege an dieselbe Property senden, konfigurieren Sie sie sorgfältig, um doppelte Ereignisse zu vermeiden. Prüfen Sie auch andere installierte Tracking-Module und Tags.

Geben Sie Mitarbeitern die erforderlichen Anzeige- und Bearbeitungsrechte für die Modul-Controller. Das Speichern von Plattformen und das Ausführen von Aktionen erfordern Bearbeitungsrechte und ein gültiges Admin-Token.

"Allgemein"

Verwenden Sie in Katalogfeed und Ereignissen eine einheitliche Kennung. Die gemeinsame Extraktion umfasst, soweit verfügbar, Artikelname, Marke, Kategoriehierarchie, Variantenbeschreibung, Preis und Menge. Bei Bestellungen kommen Währung, Steuern, Versand, Gutscheine und Bestellkennungen hinzu.

"Verfolgung"

Das Protokoll zeigt die Käufe, die Ihr Shop erfasst hat. Welche Conversions eine Plattform angenommen hat, sehen Sie in deren eigenen Berichten.

"Einwilligung"

Konfigurieren Sie einen unterstützten Einwilligungsanbieter, der die Auswahl des Besuchers erfasst. Das Modul arbeitet mit MPR Cookies Revolution und unterstützten Cookiebot-, OneTrust- und TCF-Integrationen. Consent-Mode-Standardwerte holen keine Einwilligung ein. Jede Plattform wendet außerdem ihre eigenen Einwilligungsanforderungen an.

"Automatisierung"

Unter "Automatisierung" gibt es keine bearbeitbaren Einstellungen. "Verpasste Käufe erneut senden", "Rückblick für erneutes Senden" und "Data Language" sind nicht verfügbar. Konfigurieren Sie Wiederherstellung und Serverübermittlung in den nachfolgend beschriebenen Plattformformularen.

Öffnen Sie "Marketing-Addons > Plattformen", wählen Sie die Plattform und öffnen Sie deren Konfiguration. Die meisten Plattformformulare besitzen einen Schalter "Aktiviert", der anfangs ausgeschaltet ist. Speichern Sie die Ziel-ID, bevor Sie ihn einschalten.

Google Tag Manager

Geben Sie die "GTM Container ID" ein, beispielsweise GTM-XXXXXXX. Die ID ist anfangs leer. Das Modul stellt Ecommerce-Pushes an dataLayer bereit. Tags und Trigger müssen Sie weiterhin im Container konfigurieren und veröffentlichen.

"Track Contact Signals" und "Track Product Engagement" sind anfangs ausgeschaltet. "Exclude Employee Browsers" ist in dieser Suite ebenfalls anfangs ausgeschaltet. Aktivieren Sie die Einstellung, wenn Besuche Ihrer Mitarbeiter ausgeschlossen werden sollen.

Testen Sie die entsprechenden Einstellungen für Kontakt- und Produktinteraktionen, bevor Sie sie allgemein aktivieren. Ein GTM-Container kann einen eigenen Seitenaufruf erzeugen. Das Modul sendet nicht für jede Seite ein separates generisches page_view-Ereignis an GTM.

Google Analytics GA4

Speichern Sie für die Wiederherstellung das API-Secret und aktivieren Sie "Recover Missing GA4 Purchases". Dies erfordert die Einwilligungsintegration von MPR Cookies Revolution. Die Wiederherstellung berücksichtigt Käufe, die nach Aktivierung der Funktion erfasst wurden und bei denen der Kunde die Bestellbestätigungsseite nicht erreicht hat. Bestellungen vor der Aktivierung sind ausgeschlossen. Fehlende Käuferidentität, Einwilligung oder ein passendes Ziel halten die Übermittlung zurück.

Google-Einstellungen für Produktinteraktionen

GTM und GA4 bieten diese Einstellungen in ihren jeweiligen Formularen:

Testen Sie die Selektoren in Ihrem tatsächlichen Theme. Diese Einstellungen erfassen beobachtete Interaktionen. Sie belegen keinen Kauf und erfordern kein Werbe-Conversion-Label.

Geben Sie die "Google Ads Conversion ID" ein, beispielsweise AW-123456789, und aktivieren Sie die Plattform. Alle Labels sind anfangs leer. Füllen Sie nur die gewünschten Conversion-Aktionen aus:

Ein leeres Label deaktiviert die jeweilige Conversion. Die Plattform besitzt außerdem "Track Contact Signals" und "Exclude Employee Browsers", beide anfangs ausgeschaltet. Kontakt-Conversions verwenden "Phone Click Conversion Label", "Chat Start Conversion Label" und "Confirmed Contact Form Conversion Label", alle anfangs leer. Verwenden Sie das Label für die gewünschte Aktion.

Optionale Erstattungskorrekturen

"Correct Refunded Google Ads Conversions" ist anfangs ausgeschaltet. Konfigurieren Sie vor der Aktivierung diese Felder:

Die OAuth-Datei muss Client-ID, Client-Secret und Refresh-Token enthalten. Speichern Sie die Felder und prüfen Sie die Bereitschaft, bevor Sie Korrekturen aktivieren. Korrigiert werden nur Käufe, die nach der Einrichtung vom Browser gesendet wurden; ältere Conversions bleiben unverändert. Die Korrekturaufgabe läuft nur, wenn Ihr Cron-Scheduler sie ausführt.

Öffnen Sie "Meta Pixel" und geben Sie die "Pixel ID" ein, die anfangs leer ist. "Enable Facebook Pixel" ist anfangs ausgeschaltet. Der Standardwert für "Exclude employees" ist in dieser Suite aus. "Respect cookie consent" ist anfangs eingeschaltet. "Persist marketing consent withdrawals" ist anfangs ausgeschaltet.

Die Standardschalter "Track ViewContent", "Track AddToCart", "Track InitiateCheckout", "Track Purchase", "Track Search", "Track AddToWishlist" und "Track CompleteRegistration" sind anfangs eingeschaltet. Deaktivieren Sie Ereignisse, die Ihre Einrichtung nicht verwendet. Wunschlisten- und Registrierungsereignisse benötigen eine unterstützte erfolgreiche Aktion.

"Track custom events" ist anfangs ausgeschaltet. "Custom event rules" ist anfangs leer und akzeptiert die dokumentierten JSON-Triggerregeln. Konfigurieren und testen Sie eine Regel, bevor Sie sie aktivieren.

"Enable Conversions API purchase events" ist bei einer Neuinstallation anfangs ausgeschaltet. Fügen Sie vor der Aktivierung "Conversions API access token" hinzu. Das Tokenfeld behält ein gespeichertes Token bei, wenn es leer bleibt. "Test-Event-Code" ist anfangs leer. "Graph API version" beginnt bei v25.0.

Dies ist eine serverseitige Kaufübermittlung parallel zum Browser-Pixel mit gemeinsamer Ereignisidentität zur Deduplizierung. Sie ist nicht auf das stündliche erneute Senden verpasster Käufe beschränkt. Prüfen Sie das Verbindungspanel, die Anbieterwarteschlange und Metas eigene Diagnose. Entfernen Sie einen vorübergehenden Testcode vor dem Produktiveinsatz.

Das Modul unterstützt auch diese Ziele. Ihre Zielzugangsdaten sind anfangs leer und ihre Hauptschalter ausgeschaltet. Verwenden Sie das Formular des tatsächlich genutzten Netzwerks.

Ereignisse, Datenschutz und eigene Regeln

Jeder Anbieter ordnet die gemeinsamen Ereignisse seiner unterstützten API zu. Prüfen Sie seine Ereignisschalter einzeln. Jede Werbeplattform erhält nur die von ihr unterstützten Ereignisse.

Wo angeboten, sind "Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" und "Track product engagement" anfangs ausgeschaltet. Die zugehörigen Felder "Phone target", "Chat target", "Form target" oder "Engagement target" sind anfangs leer. Geben Sie das genaue, vom Konto ausgegebene Ziel ein, wenn das Formular eines verlangt. Ziele werden nicht aus der Pixel-ID abgeleitet.

"Send confirmed forms through the server API" ist, soweit unterstützt, anfangs ausgeschaltet. Ein Formular zählt erst, wenn der Server eine erfolgreiche Übermittlung meldet; ein Klick auf "Submit" reicht nicht. Telefonklicks und tatsächliche Chatstarts sind separate Signale. "Product engagement thresholds" verwendet die gemeinsamen Standardwerte von 3 Galerieaufrufen, 1 Variantenwechsel, 1 Detailklick, 45 Sekunden und 1500 Millisekunden. Ändern Sie das JSON nur, um die gewünschten Schwellen und Theme-Selektoren abzubilden.

"Custom event rules" ist anfangs leer und benutzerdefiniertes Tracking ist, wo vorhanden, ausgeschaltet. Regeln können unterstützte Klicks, URLs, Controller oder DOM-Ereignisse auswählen. Anbieterbeschränkungen gelten weiterhin. Criteo ordnet beispielsweise seinem unterstützten OneTag-Vokabular zu, statt beliebige neue Ereignisnamen zu akzeptieren.

Prüfen Sie den Mitarbeiterausschluss für jede Plattform separat. Es gibt keinen universellen, standardmäßig eingeschalteten Schalter. Diese Suite behält ausgeschaltete Standardwerte für den Mitarbeiterausschluss bei Google, Meta, TikTok, Snapchat, Reddit und AdRoll bei. Einwilligungs-, Ausgangshost- und Zuständigkeitsprüfungen gelten weiterhin unabhängig davon.

Optionale Serverübermittlung

Die Serverübermittlung wird pro Plattform eingerichtet und ist für die folgenden optionalen Wege anfangs ausgeschaltet. Geben Sie die erforderlichen Zugangsdaten ein und prüfen Sie die Einwilligungseinstellungen der Plattform, bevor Sie sie aktivieren.

Bei Pinterest sind "Include tax in purchase value", "Include shipping in purchase value" und "Subtract discounts from purchase value" jeweils anfangs ausgeschaltet. Prüfen Sie diese anbieterspezifischen Werte, statt anzunehmen, die allgemeine Preiseinstellung bestimme den Kaufgesamtwert.

Testschaltflächen der Anbieter verhalten sich unterschiedlich. Eine Schaltfläche namens "Check test availability" oder "Check test requirements" kann Hinweise zurückgeben, ohne ein Ereignis zu senden. Verwenden Sie den dokumentierten Testweg und die erforderlichen Testkennungen des Anbieters. Eine Wiederholungsaktion stellt zulässige fehlgeschlagene Zeilen erneut zur Verarbeitung bereit. Sie behebt keine fehlenden Zugangsdaten oder fehlende ursprüngliche Einwilligung.

Öffnen Sie "ChatGPT Ads (OpenAI)". Sowohl der globale Schalter "Tracking aktivieren" als auch "Tracking enabled" in diesem Formular müssen für dieses Ziel eingeschaltet sein.

Beschaffen Sie die Pixel-ID und den Conversions-API-Schlüssel für die gewünschte Datenquelle. Der API-Schlüssel unterscheidet sich von einem Advertiser-API-Schlüssel. Bei erforderlicher Einwilligung benötigt die Serverübermittlung die entsprechende Zustimmung zur Werbespeicherung. Der Browser benötigt außerdem das Nutzerdatensignal. Ein Widerruf unterdrückt Ereignisse, die noch in der Warteschlange warten.

Browser und Server verwenden eine gemeinsame Kaufidentität, um die Deduplizierung auf der Zielplattform zu unterstützen. Die Zielplattform übernimmt Kaufberichte und Attribution. Fehlgeschlagene wartende Ereignisse verfallen in der mitgelieferten Warteschlange nach 6 Tagen und 22 Stunden.

"Check test-mode availability" sendet kein Ereignis und validiert keinen Beispielkauf. "Retry failed events" stellt zulässige fehlgeschlagene Ereignisse für den ausgewählten Shop und die Pixel-ID erneut in die Warteschlange.

Beim Ausschalten von "Browser-Pixel" bleibt die Serverübermittlung separat steuerbar. Lassen Sie für eine reine Kaufeinrichtung "Purchases" eingeschaltet und deaktivieren Sie die anderen Commerce-Ereignisse. Produkt- und Varianten-IDs verwenden Werte wie 42-7. Produkte ohne Variante behalten ihre Produkt-ID.

Die oben beschriebenen optionalen Kontakt- und Interaktionsschalter sind auch hier anfangs ausgeschaltet. Wenn das eigenständige Modul Pixel for ChatGPT Ads dasselbe Ziel nutzt, entscheidet die koordinierte Zuständigkeit, welches Modul ausgibt und die gemeinsame Warteschlange verarbeitet. Prüfen Sie den Zuständigkeitsstatus, bevor Sie Duplikate untersuchen.

Öffnen Sie das Plattformformular und legen Sie Folgendes fest:

Testen Sie das Badge und die Einwilligung zur Umfrage auf einer zulässigen Bestellbestätigung. Ihr Merchant-Center-Konto muss Google Kundenrezensionen unterstützen; darüber entscheidet Google, nicht die Moduleinstellungen.

Diese Einstellungen unterstützen globale, Shopgruppen- und Shop-Vererbung. "Use inherited settings" entfernt lokale Überschreibungen für diese Plattform. Die meisten anderen Moduleinstellungen gelten gemeinsam für alle Shops. Das Auswählen eines Shops erzeugt allein keine unabhängigen GA4-, Meta- oder OpenAI-Zugangsdaten.

Verbinden Sie die installierte Cron-Infrastruktur mit einer regelmäßigen externen Ausführung. Das Modul registriert diese Aufgabenkennungen:

Verwenden Sie den authentifizierten Runner oder Befehl des für diesen Shop installierten Schedulers. Stellen Sie keinen unauthentifizierten Schreibendpunkt bereit. Die wichtigsten Server-Worker laufen nicht über Besucheraufrufe. Eine Aufgabe läuft nur, wenn Ihr Host den Scheduler tatsächlich aufruft; prüfen Sie das.

Die Storefront erhält Tracking-Skripte statt eines neuen sichtbaren Widgets, ausgenommen optionale Bewertungs-Badges und Umfrageausgaben. Die normale Integration verwendet displayHeader, displayBeforeBodyClosingTag, displayOrderConfirmation, displayAfterBodyOpeningTag und Medien-Hooks sowie Warenkorb-/Konto-/Bestellaktionen und den alten Footer-Pfad.

Die gemeinsame Erfassung umfasst Seitenaufrufe, Produktaufrufe, unterstützte Listen und Suchen, Warenkorbaufrufe, Starts des Bestellvorgangs, Registrierungen und Anmeldungen. Das Browser-Tracking liefert bestätigte Warenkorbhinzufügungen und unterstützte erfolgreiche Wunschlistenhinzufügungen. Prüfen Sie Signale zu Bestellschritten und andere Interaktionen separat. Gehen Sie nicht davon aus, dass sie automatisch erfasst werden. Jeder Anbieter wendet seine eigenen unterstützten Zuordnungen und Freigabeprüfungen an.

1. Konfigurieren Sie eine Plattform bei weiterhin ausgeschaltetem globalen Schalter.
2. Prüfen Sie ihre erforderlichen Zugangsdaten und Einwilligungsintegration.
3. Aktivieren Sie die Plattform und "Tracking aktivieren" und browsen Sie dann als Kunde.
4. Prüfen Sie Produkt-IDs, Preise, Währung und Kategoriedaten in Browseranfragen oder der GTM-Vorschau.
5. Fügen Sie ein Produkt hinzu und entfernen Sie es. Prüfen Sie das bestätigte Ereignis und dessen Menge.
6. Schließen Sie den Bestellvorgang ab und prüfen Sie Kaufziel, Wert, Währung, Artikel und Transaktionskennung.
7. Prüfen Sie "Tracking-Protokoll", Anbieterstatus, Anbieterwarteschlangen und die Diagnose der Zielplattform separat.
8. Testen Sie Ablehnung, Einwilligungswiderruf und gegebenenfalls Ihren zeitgesteuerten Serverweg. Schalten Sie anschließend "Debug-Modus" aus.

Kein Tracking: Prüfen Sie beide Schalter, erforderliche Zugangsdaten, Einwilligung, Mitarbeiter-/internen Traffic-Status, Ausgangshost-Regeln und Zuständigkeitshinweise. Auf nicht unterstützten Staging-/Klon-Routen wird Tracking zurückgehalten.

Fehlende Käufe: Prüfen Sie für die Browserübermittlung, ob Ihr Bestellvorgang die normale Bestellbestätigungsseite anzeigt, die den Bestellbestätigungs-Hook ausführt. Prüfen Sie bei einem aktivierten API-Weg die Serverwarteschlange und den Scheduler-Status. Browserblocker, verweigerte Einwilligung und Plattformausfälle können Tracking weiterhin verhindern.

Doppelte Ereignisse: Prüfen Sie den koordinierten Verantwortlichen, ältere unabhängige Module, fest im Theme eingebaute Tags und in GTM veröffentlichte Tags. Native Integrationen von ps_facebook oder ps_googleanalytics mit demselben Ziel können weiterhin doppelte Tags ausgeben und besitzen ausdrückliche Warnungen.

Kaufprotokoll meldet beobachtet: Dies erfasst die Beobachtung der Bestellbestätigung und die Liste aktiver Plattformen. Es ist keine Empfangsbestätigung der externen Plattform.

Unerwartete Such- oder Kundendaten: Das Modul bereinigt Begriffe mit E-Mail- oder Telefondaten und wendet Prüfungen auf passende Einwilligung an. Prüfen Sie die tatsächlichen Nutzdaten Ihrer Einrichtung, statt anzunehmen, dass alle Daten enthalten sind.

Halten Sie bei eigenen Produktkarten die Produktidentität für den unterstützten Tracker verfügbar. Das ursprüngliche Muster lautet:

<article class="product-miniature" data-id-product="123" data-list-name="Category page">
  <h3 class="product-title"><a href="/example-product">Example product</a></h3>
  <span class="price" content="49.99">49.99</span>
</article>

Testen Sie nach Markup-Änderungen Klicks und echtes Hinzufügen zum Warenkorb: Das Warenkorbereignis wird erst gesendet, wenn ein Produkt tatsächlich hinzugefügt wurde. Ein passender Selektor reicht nicht.

GTM-Kaufdaten verwenden ein Ecommerce-Objekt. Ein konfigurierter Container kann beispielsweise Folgendes erhalten:

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: '123',
    value: 99.99,
    tax: 16.67,
    shipping: 4.99,
    currency: 'EUR',
    items: [{
      item_id: 'SKU-001', item_name: 'Example product',
      item_brand: 'Example brand', item_category: 'Category',
      item_category2: 'Subcategory', price: 99.99, quantity: 1
    }]
  }
});

Dies veranschaulicht die Datenstruktur. Fügen Sie keinen zweiten Kaufsender in das Theme ein. Konfigurieren Sie den Container so, dass er die vorhandene Ausgabe des Moduls verarbeitet.

Schalten Sie "Tracking aktivieren" aus, um das Tracking zu stoppen. Bereits eingereihte Ereignisse und Widerrufe werden nach eigenem Zeitplan verarbeitet. Sichern Sie vor der Deinstallation alle benötigten Protokolle oder Konfigurationen.

Deinstallieren Sie über "Module Manager". Das Modul entfernt sein Menü, registrierte Aufgaben, moduleigene Datenbanktabellen, Konfiguration sowie seine Warteschlangen-/Attributionszuständigkeit über die gemeinsamen Pakete. Gemeinsame Tabellen folgen den Bereinigungsregeln ihrer Pakete. Bereits an externe Plattformen gemeldete Ereignisse werden durch die Deinstallation nicht gelöscht.