FAQ für Shopware 5
FAQ für Shopware 5
Diese Seite beantwortet Fragen, die speziell das Shopware 5 Plugin betreffen. Allgemeine Fragen zu allen Meta Pixel Plugins (Tracking, Consent, Event Match Quality, Deduplizierung usw.) findest Du in der allgemeinen FAQ.
Wie wird das Plugin mit Usercentrics oder einem anderen externen Cookie-Consent-Tool korrekt verbunden?
Stelle den Datenschutzmodus im Plugin auf „Meta/Facebook Pixel manuell per JavaScript starten". Danach muss das externe Consent Tool bei Zustimmung den JavaScript-Code zum Starten des Plugins ausführen. Bei Usercentrics muss außerdem der Wert im Attribut data-usercentrics exakt zum Namen des Services in Usercentrics passen, z. B. „Meta Pixel" statt „Facebook Pixel", wenn der Service so heißt. Der Stop-Code darf nicht direkt nach dem Start-Code ausgeführt werden, sondern nur dann, wenn eine bereits erteilte Zustimmung wieder entzogen wird. Für die konkrete Einbindung im jeweiligen Consent Tool sollte die technische Betreuung oder der Support des Consent-Tool-Anbieters eingebunden werden.
Welche API-Version soll verwendet werden, wenn Meta bereits eine neuere Version anbietet als im Plugin auswählbar ist?
Ein in Meta für eine neue API-Version generierter Schlüssel kann in der letzten im Plugin verfügbaren Version eingetragen werden. Meta macht in der Verbindung in der Regel keinen relevanten Unterschied. Nach dem Eintragen sollte die Einrichtung über das Live Test Tool im Events Manager geprüft werden. Neue API-Versionen werden in der Regel mit einem späteren Plugin-Update als Auswahl nachgezogen.
Warum lässt sich das Plugin per Composer nicht installieren oder aktualisieren?
Composer-Fehler liegen häufig an der Shop-Umgebung und nicht direkt am Plugin: fehlendes Shopware Packagist Repository, Konflikte mit anderen Plugins, veraltete oder widersprüchliche Composer-Abhängigkeiten, fehlende PHP-Extensions, nicht beschreibbare Cache-Verzeichnisse oder Shopware-Versionen, die durch Composer-Security-Advisories blockiert werden. Prüfe die vollständige Fehlermeldung, die composer.json, vorhandene path repositories, installierte Plugins mit eigenem vendor-Ordner und ob Shopware Packagist eingebunden ist. Bei Meldungen zu Sicherheitslücken sollte zuerst Shopware aktualisiert oder die Composer-Konfiguration gemäß Fehlermeldung angepasst werden.