Kowal Data Layer für Magento 2
- Kompatibilität
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0
- Hyva Theme
- Hyva Theme Redy
Beschreibung / Kowal Data Layer für Magento 2
MAGENTO 2 · E-COMMERCE · GTM · ATTRIBUTION
Verknüpfen Sie E-Commerce-Ereignisse mit der Bestellquelle.
Kowal Data Layer
Bereiten Sie die Einkaufsdaten aus Magento für GA4 und die Konfiguration von Werbe-Tags vor. Speichern Sie First Touch und Last Non-Direct Touch bei der Bestellung und prüfen Sie die Tag-Implementierung in der GTM-Vorschau.
E-Commerce-Ereignisse · GTM-Exporte · Attribution im Admin-Panel
SO FUNKTIONIERT ES IN DER PRAXIS
01 · Daten und Kennungen auswählen
Sie konfigurieren item_id, Marke, Kategorie und Store View.
02 · Tags und Einwilligungen konfigurieren
Sie importieren den GTM-Export und verbinden ihn mit der CMP.
03 · Ereignisse und Bestellungen prüfen
Sie überprüfen Werte, Währungen und die gespeicherte Attribution.
Welche Vorteile bietet das Ihrem Shop?
Entdecken Sie die Funktionen, Einsatzmöglichkeiten und Einstellungen des Moduls.
Magento 2 Data Layer für GA4, GTM und Vertriebsattribution
Kowal Data Layer erstellt direkt aus Magento 2 eine konsistente E-Commerce-Datenschicht. Sie unterstützt die gesamte Customer Journey, Integrationen über Google Tag Manager und die Speicherung der Quelle einer konkreten Bestellung.
Diese Lösung richtet sich an Shops, die GA4-Analysen, Werbekampagnen und Magento-Daten miteinander verbinden möchten, ohne Skripte manuell in weitere Elemente des Themes und Checkouts einzufügen.
GA4 E-Commerce
Ereignisse von Produktlisten und PDP über Warenkorb, Wunschliste und Checkout bis zum Kauf.
Vorgefertigte GTM-Exporte
Pakete für GA4, Google Ads, Meta, TikTok, Pinterest, Microsoft Ads und OpenAI Ads.
Bestellattribution
First Touch und Last Non-Direct Touch mit Angaben zu Quelle, Medium, Kampagne, Landingpage und Referrer.
Analysen dürfen den Verkauf nicht blockieren
Das Modul wurde nach dem Fail-Safe-Prinzip entwickelt. Fehler der Datenschicht oder Attribution werden isoliert und protokolliert, sollten jedoch weder Warenkorb, Checkout oder Bestellung noch die Weiterleitung zur Zahlung stoppen.
Unterstützte E-Commerce-Ereignisse
user_data, view_item_list, select_item, view_item, add_to_cart, remove_from_cart, view_cart, add_to_wishlist, begin_checkout, add_shipping_info, add_payment_info, purchase und purchase_testverwenden.
Multistore und Produktfeeds
Die Konfiguration pro Store View ermöglicht die Anpassung von Kennungen, Währung, Namen, Kategorie und Marke. item_id kann den in Google Merchant Center, Meta Catalog und anderen Feeds verwendeten Kennungen entsprechen.
Consent Mode
Das Modul kann mit Kowal Cookie Consent zusammenarbeiten. Data Layer ist für die E-Commerce-Daten zuständig, die CMP für Einwilligungen und das Auslösen der entsprechenden Tags.
FAQ
Ersetzt das Modul den Google Tag Manager?
Nein. Es stellt E-Commerce-Daten und vorgefertigte Konfigurationsexporte bereit, die in GTM verwendet werden können.
Funktioniert es mit Varnish und FPC?
Ja, die Lösung berücksichtigt Shops, die Cache und dynamische Checkout-Elemente verwenden.
Speichert es die Bestellquelle in Magento?
Ja. Die Attribution für First Touch und Last Non-Direct Touch wird vom Warenkorb in die Bestellung übernommen.
Unterstützt es Multistore-Shops?
Ja. Kennungen und Daten können auf Store-View-Ebene konfiguriert werden.
Kann ein Analysefehler den Checkout blockieren?
Die Architektur wurde so konzipiert, dass Analysefehler vom Verkaufsprozess isoliert bleiben.
Der GTM-Export ist der Anfang der Implementierung
Über Kowal → Data Layer → GTM Exports können Sie nach der Konfiguration der Kennungen eine JSON-Datei für die ausgewählte Plattform herunterladen. Importieren Sie das Paket mit Merge in den GTM-Workspace, prüfen Sie die Tags und die Vorschau und veröffentlichen Sie die Konfiguration erst danach.
Ein Update des Magento-Moduls aktualisiert zuvor importierte GTM-Tags nicht. Laden Sie den entsprechenden Export erneut herunter, wenn sich dessen Logik ändert, und prüfen Sie auf doppelte Tags und Conversions.
Attribution im Admin-Panel und Grenzen der Messung
Data Layer → Customer Attribution zeigt Bestellungen mit gespeicherter Attribution, einschließlich Gastbestellungen. Das Grid bietet Filter, Sortierung und gespeicherte Ansichten; für den Zugriff ist eine separate Rollenberechtigung erforderlich.
UTM-Quellen, Click-ID-Typen sowie Organic und Referral werden erkannt, ohne vollständige Query-Strings oder rohe Click-IDs von Werbeplattformen zu speichern. Die Daten bilden erkannte Einstiege ab, nicht jedoch ein vollständiges Bild sämtlicher Kundenkontakte auf verschiedenen Geräten.
Purchase und das diagnostische purchase_test
purchase_test bedeutet im standardmäßigen REST-Checkout, dass eine Bestellung erstellt wurde, nicht dass der Kauf bezahlt wurde. Exportierte Conversion-Tags ignorieren dieses Ereignis. Das Ereignis muss in der Konfiguration separat aktiviert werden.
Weiterleitungen zu benutzerdefinierten Zahlungs-Gateways können einen Adapter erfordern. Fehler können Sie in den Logs unter var/log/kowal_datalayer.log prüfen; das Konzept isoliert sie vom Verkaufsprozess.
Einwilligungen, private Daten und Cache
Die CMP verwaltet Einwilligungen und aktualisiert deren Status. Wenn Kowal Cookie Consent GTM lädt, deaktivieren Sie den zweiten GTM-Loader in Data Layer. Der reine Tag-Export ersetzt nicht die Konfiguration der Einwilligungen.
Die Benutzeridentität wird von einem privaten Endpoint abgerufen, damit Kundendaten in FPC nicht vermischt werden. Berücksichtigen Sie bei einem externen GTM-Loader die Verfügbarkeit von user_data, die richtigen Einwilligungen und das Ergebnis in der Vorschau.
Hyvä und Kennungskonsistenz
Das Paket enthält das optionale Kowal_DataLayerHyva, das zusammen mit Enable Hyva Integration für die entsprechende Store View aktiviert wird. Der Adapter unterstützt private-content, dynamische Listen und FormData.
Der standardmäßige REST-Checkout ist abgedeckt. Hyvä Checkout/Magewire und GraphQL erfordern eine separate Integration. item_id im Export muss den Kennungen des jeweiligen Feeds oder Werbekatalogs entsprechen.
Installation über Composer
Paket kowal/module-datalayer, Modul Kowal_DataLayer. Installieren Sie nach der Konfiguration des Zugriffs auf das Kowal-Repository das Paket, aktivieren Sie das Modul, aktualisieren Sie Magento und leeren Sie den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte entsprechend dem Prozess des Shops.
Von der Konfiguration zum Ergebnis
1. Daten und Kennungen auswählen
Sie konfigurieren item_id, Marke, Kategorie und Store View.
2. Tags und Einwilligungen konfigurieren
Sie importieren den GTM-Export und verbinden ihn mit der CMP.
3. Ereignisse und Bestellungen prüfen
Sie überprüfen Werte, Währungen und die gespeicherte Attribution.
Vom Kampagneneinstieg bis zur Bestellung
Der Kunde gelangt über eine Kampagne in den Shop, sieht sich ein Produkt an und schließt den Kauf ab. Das Modul speichert erkannte Quellen im Quote und überträgt sie in die Bestellung.
Im Admin-Panel vergleichen Sie First Touch und Last Non-Direct Touch. In der GTM-Vorschau prüfen Sie das purchase-Ereignis mit Wert, Währung und Positionen.
Strukturieren Sie E-Commerce-Daten und Vertriebsattribution
Möchten Sie das Modul an Ihren Shop anpassen? Fragen Sie nach der Implementierung von Kowal Data Layer und besprechen Sie die Konfiguration oder benötigte Erweiterungen.
Weitere Informationen
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Übereinstimmung mit der Vorlage | Gut, Luma / Leer, KOWAL |
Installationsanleitung für das Modul
Installations- und Konfigurationsanleitung
Anforderungen
- Magento Open Source / Adobe Commerce 2.4.x.
- PHP, das mit der verwendeten Magento-Version kompatibel ist.
- Composer-Zugriff auf das private Modul-Repository.
- Das Modul
kowal/baseverwenden. - Berechtigung zur Ausführung von
setup:upgrade, da das Modul den Tabellenquoteundsales_orderverwenden. - Google-Tag-Manager-Webcontainer, wenn der Shop die vorgefertigten Integrationsexporte verwenden soll.
- Optional:
Kowal_CookieConsent, wenn der Shop dieses Modul für GTM und Consent Mode verwendet.
Installation mit Composer
Die Zugangsdaten für das Composer-Repository – E-Mail-Adresse des Kunden und Lizenz-Token – erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung auf kowal.storeebenfalls im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch das erhaltene Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.
composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-datalayer
php bin/magento module:enable Kowal_DataLayer
php bin/magento setup:upgrade
php bin/magento cache:flush
Der Befehlsetup:upgradeerstellt folgende Spalten:
quote.kowal_attribution_first;quote.kowal_attribution_last;sales_order.kowal_attribution_first;sales_order.kowal_attribution_lastverwenden.
Die Spalten enthalten serialisierte First-Touch- und Last-Touch-Daten. Sie dürfen nicht manuell erstellt werden.
Bestehende Installation aktualisieren
Erstellen Sie vor der Aktualisierung der Produktionsumgebung gemäß dem Projektverfahren eine Datenbanksicherung. Aktualisieren Sie anschließend das Paket und das Magento-Schema:
composer update kowal/module-datalayer --with-dependencies
php bin/magento module:enable Kowal_DataLayer
php bin/magento setup:upgrade
php bin/magento cache:flush
Führen Sie im Produktionsmodus die DI-Kompilierung und das Deployment der statischen Assets erneut durch. Dies ist unter anderem für den neuen Attributions-Endpoint, die Quote-/Order-Observer und Änderungen am Frontend-Skript erforderlich.
Führen Sie in der Produktionsumgebung, sofern das Projekt dies erfordert, das standardmäßige Magento-Deployment aus:
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
Nach einer Aktualisierung der ACL-Berechtigungen muss sich der Administrator möglicherweise erneut im Admin-Panel anmelden, um den MenüpunktData Layer > GTM Exportsverwenden.
Basiskonfiguration
Adminbereich:
Stores > Configuration > Kowal > Kowal Data Layer
Menü:
kowal.store > Modules > Data Layer > Settings
General
Enable Module– Aktivieren Sie das Modul für den ausgewählten Konfigurationsbereich.Debug Mode– Aktivieren Sie diese Option nur während Tests und der Überprüfung der Implementierung.Render Mode– Belassen Sie die Einstellung aufServer and JavaScript, sofern kein Grund besteht, den Betriebsmodus einzuschränken.Missing Value Strategy– Legen Sie fest, ob fehlende Werte ausgelassen oder alsundefinedverwenden.Clear Ecommerce Before Push– Empfohlene Einstellung:Yesverwenden.Fail-safe Mode– Empfohlene Einstellung:Yes; verkaufskritische Prozesse bleiben auch nach Deaktivierung dieser Option geschützt.Log Level– Für die Produktionsumgebung wirdErrors onlyverwenden.Log Payloads– Nur vorübergehend aktivieren.
Product Mapping
Product Identifier Attribute– Wählen Sie das alsitem_idverwendete Attribut. Standardmäßigskuverwenden.Brand Attribute– Wählen Sie das Hersteller-/Markenattribut. Standardmäßigmanufacturerverwenden.Category Strategy– Wählen Sie die Methode zur Erstellung vonitem_categoryverwenden.Category Attribute– Nur festlegen, wenn die Kategoriestrategie ein Produktattribut verwendet.Configurable Product Strategy– Legen Sie fest, ob die Daten des untergeordneten/einfachen oder des übergeordneten/konfigurierbaren Produkts verwendet werden sollen.Include Out Of Stock Products On Lists– Gilt für Ereignisse von Produktlisten.
Events
Aktivieren Sie die für die Implementierung erforderlichen Ereignisse:
user_dataview_item_listselect_itemview_itemadd_to_cartremove_from_cartview_cartadd_to_wishlistbegin_checkoutadd_shipping_infoadd_payment_infopurchasepurchase_test, wenn der Shop vor der Zahlung eine Zwischenseite verwendet.
Privacy
Send User ID– Sendet bei angemeldeten Kunden die Magento-Kunden-ID.Send Hashed Email– Sendet ausschließlich den SHA-256-Hash der E-Mail-Adresse. Die unverschlüsselte E-Mail-Adresse wird nicht andataLayerverwenden.
Attribution
Capture First and Last Touch Attributionspeichert die Einstiegsquelle des Kunden im Quote und in der Bestellung. Empfohlene Einstellung:Yesverwenden.
Die Einstellung gilt pro Store View. Nach der Deaktivierung erfasst das Modul keine neuen Touchpoints. Zuvor in bestehenden Bestellungen gespeicherte Daten verbleiben in der Datenbank.
Das Modul erkennt:
- die Parameter
utm_source,utm_medium,utm_campaign,utm_id,utm_term,utm_contentundutm_source_platform; - Click-ID-Typen von Google Ads, Microsoft Ads, Meta, TikTok, Pinterest, X und LinkedIn;
- Einstiege über organische Suchergebnisse;
- externe Referrals;
- direkte Einstiege.
Gespeichert werdenfirst_touchundlast_touch, also die letzte nicht direkte Quelle. Das gewöhnliche Navigieren zwischen den Unterseiten des Shops überschreibt die Quelle nicht. Referrals von Zahlungsadressen, Callbacks, Rückleitungs- und Erfolgsseiten werden ignoriert, damit der Zahlungsanbieter nicht als Verkaufsquelle eingestuft wird.
Die Erfassung erfolgt auf zwei Wegen:
- Magento-seitig für standardmäßige, nicht gecachte Einstiege;
- über eine schlanke Browser-Anfrage für Seiten, die über FPC oder Varnish bereitgestellt werden.
Die Daten werden in der Checkout-Sitzung vorgehalten, beim Quote gespeichert und vor dem Absenden der Bestellung in die Order kopiert. Der Mechanismus umfasst das klassische Frontend, AJAX-/REST-Checkout sowie Bestellungen, die aus einem Quote erstellt werden, das bereits Attributionsdaten enthält.
Die Rohwerte vongclid,fbclidund anderen Klickkennungen werden nicht gespeichert. Das Modul speichert ausschließlich den Parametertyp, beispielsweisegclid, und die daraus resultierende Quellenklassifizierung. Query-Strings werden aus der gespeicherten Landingpage und dem Referrer entfernt.
Die Attribution kann an folgenden Stellen geprüft werden:
- in der Bestellansicht im Abschnitt
Customer Attribution; - in
dataLayerin der Eigenschaftattributiondes Ereignissespurchase; - direkt in den Spalten
kowal_attribution_firstundkowal_attribution_lastder Tabellenquotesowiesales_orderverwenden.
Die Erfassung der Quelle muss entsprechend den Implementierungsrichtlinien in der Datenschutzerklärung des Shops berücksichtigt werden. Das Modul erstellt keine eigene langfristige Benutzerkennung und speichert keine Click-ID-Werte, bewahrt jedoch Kampagnenmetadaten und die Bestellquelle auf.
Integrations
Integrate With Kowal Cookie Consent– Aktivieren, wenn der ShopKowal_CookieConsentverwenden.Render GTM From DataLayer Module– AufNobelassen, wenn GTM bereits durch Cookie Consent oder ein anderes Modul gerendert wird.Google Tag Manager ID– Nur festlegen, wenn das Rendern von GTM über dieses Modul aktiviert ist.purchase_test Redirect Rules– Fügen Sie nur die Zahlungsmethoden hinzu, die die Zwischenseitepurchase_testverwenden.
Regelmodi fürpurchase_testfest:
Static URL– Nur für Zahlungen mit einer festen Anbieteradresse verwenden.URL Pattern– Verwenden, wenn ein URL-Muster mit den Platzhaltern{order_id},{order_increment_id},{store_id}oder{quote_id}verwenden.Adapter Required– Für Gateways verwenden, die eine dynamische Transaktions-URL generieren. Vor der Inbetriebnahme in der Produktionsumgebung muss ein spezieller Adapter für das jeweilige Zahlungsmodul hinzugefügt werden.
GTM Export Identifiers
Tragen Sie in diesem Abschnitt die Kennungen der Dienste ein, die in die generierten JSON-Dateien eingebettet werden sollen:
| Feld in Magento | Wert |
|---|---|
GA4 Measurement ID |
Kennung im FormatG-XXXXXXXXXX |
Google Ads Conversion ID |
Kennung im FormatAW-XXXXXXXXX |
Google Ads Purchase Conversion Label |
Label der Kauf-Conversion-Aktion |
Meta Pixel ID |
numerische Pixel-ID |
TikTok Pixel ID |
alphanumerische Pixel-ID |
Pinterest Tag ID |
numerische Tag-ID |
Microsoft Ads UET Tag ID |
numerische UET-Tag-ID |
Die Felder können leer bleiben, wenn der Shop die jeweilige Plattform nicht verwendet. Beim Speichern der Konfiguration wird das Format jedes ausgefüllten Werts geprüft. Die Exportschaltfläche prüft nur die für die ausgewählte Plattform erforderlichen Angaben. Daher erfordert beispielsweise ein GA4-Export keine Konfiguration von Meta oder TikTok.
Klicken Sie nach dem Ausfüllen der Felder aufSave Configund anschließend im FeldDownload ... JSONauf die entsprechende SchaltflächeGenerate GTM Exports. Die heruntergeladene Datei enthält bereits die endgültigen Kennungen. Konstante Variablen müssen nach dem Import in GTM nicht bearbeitet werden.
Multistore-Konfiguration
Konfigurieren Sie das Modul auf Store-View-Ebene, wenn sich die Shops in folgenden Punkten unterscheiden:
- Sprache;
- Währung;
- Werbefeed;
- Attribut für die Produktkennung;
- Markenattribut;
- Kategoriestruktur;
- Zahlungsmethoden;
- Regeln zur Erfassung der Attribution;
- Dienstkennungen, die in den importierten GTM-Paketen verwendet werden.
Überprüfung der Implementierung
- Öffnen Sie die Vorschau von Google Tag Manager.
- Prüfen Sie
dataLayerin der Browserkonsole oder mit der Erweiterung DataLayer Checker. - Testen Sie die Produktseite und das Ereignis
view_itemverwenden. - Öffnen Sie eine Kategorie oder die Suchergebnisse und prüfen Sie
view_item_listverwenden. - Klicken Sie auf ein Produkt in der Liste und prüfen Sie
select_itemverwenden. - Legen Sie ein Produkt in den Warenkorb und prüfen Sie
add_to_cartverwenden. - Ändern Sie die Menge oder entfernen Sie ein Produkt aus dem Warenkorb und prüfen Sie
remove_from_cartverwenden. - Fügen Sie ein Produkt zur Wunschliste hinzu und prüfen Sie
add_to_wishlistverwenden. - Öffnen Sie Warenkorb und Checkout und prüfen Sie
view_cartsowiebegin_checkoutverwenden. - Speichern Sie Versand- und Zahlungsmethode und prüfen Sie
add_shipping_infosowieadd_payment_infoverwenden. - Geben Sie eine Testbestellung auf und prüfen Sie
purchaseverwenden. - Aktualisieren Sie die Erfolgsseite und vergewissern Sie sich, dass
purchasenicht dupliziert wird. - Prüfen Sie
var/log/kowal_datalayer.logverwenden. - Öffnen Sie den Shop in einem neuen privaten Fenster mit der URL
?utm_source=test&utm_medium=cpc&utm_campaign=attribution_testverwenden. - Rufen Sie mehrere Unterseiten auf, legen Sie ein Produkt in den Warenkorb und geben Sie eine Bestellung auf.
- Prüfen Sie in der Bestellansicht den Abschnitt
Customer Attributionsowieattribution.first_touchundattribution.last_touchim Ereignispurchaseverwenden. - Bestätigen Sie, dass
first_touch.sourceden Werttest,mediumden Wertcpcundcampaignden Wertattribution_testverwenden. - Kehren Sie im selben Fenster und in derselben Sitzung über eine andere gekennzeichnete Quelle zum Shop zurück und bestätigen Sie, dass
first_touchunverändert geblieben ist undlast_touchaktualisiert wurde. - Wenn der Shop ein externes Gateway verwendet, bestätigen Sie nach der Rückkehr von der Zahlung, dass die Domain des Anbieters die Bestellquelle nicht ersetzt hat.
Export der Google-Tag-Manager-Konfiguration
Navigieren Sie im Magento-Admin-Panel zuStores > Configuration > Kowal > Kowal Data Layer > GTM Export Identifiers. Es stehen separate Pakete für GA4, Google Ads, Meta, TikTok, Pinterest und Microsoft Ads zur Verfügung.
- Wählen Sie den richtigen Konfigurationsbereich aus:
Default Config, Website oder Store View. - Tragen Sie die Kennungen der verwendeten Plattformen ein und speichern Sie die Konfiguration.
- Klicken Sie im Feld
Generate GTM Exportsverwenden. - Erstellen Sie in GTM einen neuen Workspace und wählen Sie
Admin > Import Containerverwenden. - Wählen Sie die heruntergeladene Datei aus und verwenden Sie den Modus
Mergeverwenden. - Prüfen Sie die Liste der hinzuzufügenden Variablen, Trigger und Tags und bestätigen Sie, dass die konstanten Variablen die richtigen Kennungen enthalten.
- Prüfen Sie die Einwilligungsanforderungen und starten Sie die GTM-Vorschau.
- Veröffentlichen Sie den Container erst, nachdem die Ereignisse im Diagnosetool der Plattform bestätigt wurden.
Den Elementnamen wird das PräfixKowal - nazwa platformyvorangestellt, sodass die Pakete in einem Container kombiniert werden können. Das Ereignispurchase_testwird nicht als Conversion exportiert; Verkäufe werden ausschließlich überpurchaseverwenden.
Wenn ein erforderliches Feld leer ist oder ein ungültiges Format aufweist, generiert das Modul keinen Export und zeigt eine Meldung mit dem zu korrigierenden Wert an. Dadurch wird der versehentliche Import eines Containers mit einem Platzhalter verhindert. Die alternative SeiteKowal > Data Layer > GTM Exportsbleibt verfügbar, verwendet jedoch die Werte aus dem BereichDefault Config. Für Multistore-Implementierungen werden die Schaltflächen in der Konfiguration empfohlen.
Die Exporte gelten für den Webcontainer und den browserseitigen Versand. Sie ersetzen keine serverseitigen Integrationen wie Meta Conversions API oder TikTok Events API.
Einwilligungen und Veröffentlichung von GTM
- Werbe-Tags erfordern
ad_storage,ad_user_dataundad_personalizationverwenden. - GA4 verwendet die integrierten Einwilligungsmechanismen des Google-Tags.
- Wenn GTM durch
Kowal_CookieConsentgerendert wird, belassen SieRender GTM From DataLayer ModuleaufNoverwenden. - Veröffentlichen Sie den Container nicht, ohne Consent Mode, GTM-Vorschau und die Ereignisdiagnose der jeweiligen Plattform zu prüfen.
- Fügen Sie bei einer restriktiven CSP die Skript-Domains und Endpoints der ausgewählten Plattformen entsprechend deren Dokumentation hinzu.
Integration vonpurchase_test
Wenn die Zahlungsmethode den Kunden aus dem Shop weiterleitet und die Ziel-URL des Anbieters bekannt ist, kann die Zahlungsintegration Folgendes verwenden:
Kowal\DataLayer\Model\PurchaseTestRedirect::prepare($paymentRedirectUrl)
Die Methode gibt die URL der Zwischenseite des Moduls zurück. Die Zwischenseite sendetpurchase_testund leitet den Kunden anschließend zum Zahlungsanbieter weiter. Wenn JavaScript oder DataLayer nicht funktioniert, sollte die Weiterleitung dennoch ausgeführt werden.
Verwenden Sie für eine Integration, bei der die URL von der Bestellung oder dem Transaktions-Token abhängt:
Kowal\DataLayer\Model\PurchaseTestRedirect::prepareForOrder($order, $fallbackRedirectUrl)
Wenn die Methode auf den ModusAdapter Requiredeingestellt ist, sollte der Adapter Folgendes implementieren:
Kowal\DataLayer\Api\PurchaseTestRedirectAdapterInterface
Der Adapter muss in DI als Element des ArraysadaptersfürKowal\DataLayer\Model\PurchaseTest\RedirectAdapterPoolregistriert werden. Der Adapter ist der geeignete Ort für Logik, die von einem bestimmten Zahlungsanbieter abhängt.
Diagnose
Der Abschnitt Customer Attribution fehlt in der Bestellung
- Prüfen Sie, ob
Capture First and Last Touch Attributionfür die richtige Store View aktiviert ist. - Bestätigen Sie die Ausführung von
php bin/magento setup:upgradeund das Vorhandensein der vier Attributionsspalten. - Leeren Sie den Konfigurations- und Layout-Cache.
- Führen Sie den Test in einem neuen privaten Fenster mit einer gekennzeichneten UTM-URL durch.
- Prüfen Sie
var/log/kowal_datalayer.logauf die Meldungenattribution capture failedoderattribution assignment failedverwenden.
Die Attribution funktioniert ohne FPC, aber nicht mit Varnish
- Prüfen Sie in den Entwicklertools die POST-Anfrage an
kowal_datalayer/attribution/captureverwenden. - Bestätigen Sie, dass die Anfrage den Status
200hat und an dieselbe Shop-Domain gesendet wird. - Prüfen Sie, ob CSP, WAF oder Reverse-Proxy-Regeln den Endpoint blockieren.
- Stellen Sie nach dem Deployment sicher, dass die aktuelle Datei
view/frontend/web/js/data-layer.jsverwenden.
Der Kauf weist fälschlicherweise den Zahlungsanbieter als Quelle auf
Prüfen Sie, ob die Bestellung aus einem Quote erstellt wurde, das bereits vor der Weiterleitung Attributionsdaten enthielt. Routen mitpayment,callback,returnodersuccesssollten Last Touch nicht durch ein Referral überschreiben. Wenn ein benutzerdefiniertes Zahlungsmodul eine andere Sequenz verwendet, prüfen Sie den Zeitpunkt der Erstellung der Order und der Speicherung des Quote.
Der GTM-Import meldet Konflikte
Verwenden Sie den ModusMergeund prüfen Sie die Details der Änderungen. Die Elemente der Exporte haben das PräfixKowal - .... Wenn im Container geänderte Elemente mit demselben Namen vorhanden sind, entscheiden Sie bewusst, ob diese überschrieben oder umbenannt werden sollen. Prüfen Sie nach einer Umbenennung die Verweise der Tags auf Variablen und Trigger.