Du wirst lernen
Erfahre, wie du Probleme bei der Einrichtung deiner WooCommerce-Integration lösen kannst, indem du das unten beschriebene Szenario zur Fehlerbehebung befolgst. Wenn du Probleme hast, die nicht auf dieser Liste stehen, wende dich bitte an die Community oder an unser Support-Team.
Bevor du beginnstBevor du beginnst
Falls du es noch nicht getan hast, lies unseren Leitfaden für die ersten Schritte mit WooCommerce, um eine Schritt-für-Schritt-Anleitung für die Integration zu erhalten. Wenn du dein Plug-in aktualisieren möchtest, lies unseren Artikel Wie du dein WooCommerce Plug-in aktualisieren kannst.
Szenarien zur FehlerbehebungSzenarien zur Fehlerbehebung
Lies die folgenden Szenarien anhand der Fehlermeldung, die du in der App erhältst, um dein Problem zu lösen.
Bitte beachte, dass deine WooCommerce-Daten nicht aus Klaviyo gelöscht werden, wenn du dich entscheidest, deine Integration zu entfernen und dann wieder zu integrieren.
"Um Funktionsunterbrechungen zu vermeiden, musst du eventuell das folgende Plug-in deaktivieren: Plug-in Name(n)"
Wenn du ein aktives Caching Plug-in oder Redirect Plug-in in WordPress hast, können diese die Integration von Klaviyostören und Verbindungsprobleme verursachen. Wir empfehlen, diese Plug-ins während der Einrichtung der Integration zu deaktivieren.
"Wir können deine Einrichtung nicht abschließen"
Diese Meldung bedeutet, dass entweder deine Firewall die Anfragen von Klaviyo blockiert, dass du den Bot Fight Mode bei Cloudflare aktiviert hast oder beides.
Wir empfehlen, den Datenverkehr der Klaviyo-Integration auf die Liste zu setzen und den Bot Fight Mode zu deaktivieren (falls du ihn aktiviert hast).
- Hier erfährst du, wie du die IP-Adressen des Klaviyo Integrationsverkehrs auf eine Whitelist setzen kannst.
- So deaktivierst du den Bot Fight Mode in Cloudflare:
- Melde dich im Cloudflare Dashboard an.
- Wähle dein Konto und deine Domain aus.
- Gehe zu Sicherheit > Bots.
- Wähle für den Bot-Kampf-Modus die Option Aus.
"Stelle sicher, dass dein WooCommerce Laden https und SSL aktiviert hat"
Klaviyo erwartet, dass deine Laden-URL das HTTPS-Protokoll einhält, was bedeutet, dass die Website ein gültiges SSL-Zertifikat hat. Wenn deine Website über HTTP und nicht über HTTPS läuft, kann es zu Problemen kommen.
Ob dein SSL-Zertifikat gültig ist, kannst du bei SSL Server Test (Powered by Qualys SSL Labs) überprüfen.
Klaviyo verlangt, dass die Tests mit A-Noten bestanden werden.
"Der Zugriff auf die API mit den angegebenen Anmeldeinformationen ist nicht möglich""Der Zugriff auf die API mit den angegebenen Anmeldeinformationen ist nicht möglich"
Dieser Fehler kann auftreten, wenn du Anpassungen vorgenommen hast, die den API-Zugriff für nicht angemeldete Benutzer verhindern. In der Regel ist dies eine Funktion in der WordPress-Datei functions.php, die eine Antwort mit dem Statuscode 401 auslöst.
Wenn du eine solche Anpassung hast, lösche sie oder kommentiere sie aus, um den Fehler zu beheben. Weitere Informationen zu diesem Fehler findest du in den WooCommerce REST API FAQ.
"Der Zugriff auf die Bestell-API ist nicht möglich. Bitte überprüfe die Verbindungseinstellungen und versuche es erneut.""Der Zugriff auf die Bestell-API ist nicht möglich. Bitte überprüfe die Verbindungseinstellungen und versuche es erneut."
Dieser Fehler bedeutet, dass, wenn Klaviyo versucht, die Integration von WooCommerce zu validieren und eine Bestellungsanzahl zu erhalten, ihr API keinen Wert Klaviyo zurückgibt, den sie erwartet, oder sie gibt überhaupt nichts zurück.
Da die Integration noch nicht offiziell mit Klaviyo verbunden ist, bedeutet dies, dass das Problem innerhalb von WooCommerce behoben werden muss.
Um mehr Informationen über diesen Fehler zu erhalten, musst du einen API-Aufruf an den Endpunkt "Order Count" (Bestellungsanzahl) machen, der mehr Einblicke in das gibt, was an Klaviyo übergeben wird. Hier ist ein Beispiel für eine cURL-Anfrage. Um sie zu benutzen, gibst du deine Laden-URL, den Kundenschlüssel und das Kundengeheimnis ein:
curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET
"Dein Klaviyo Plug-in ist nicht mehr aktuell""Dein Klaviyo Plug-in ist nicht mehr aktuell"
Gelegentlich kann es vorkommen, dass der Webhook Klaviyo erst mit Verzögerung erreicht, so dass du vorübergehend die alte Einstellungsseite siehst. Das sollte sich nach ein paar Minuten von selbst erledigen.
404 beim Verbinden mit Klaviyo von WordPress aus404 beim Verbinden mit Klaviyo von WordPress aus
Um dieses Problem zu lösen, solltest du sicherstellen, dass du Permalinks für deine WordPress-Seite aktiviert hast. Die WooCommerce-Authentifizierung funktioniert nicht, wenn Permalinks nicht aktiviert sind.
- Navigiere zu deiner WordPress-Website und gehe zu Einstellungen > Permalinks.
- Wähle unter Allgemeine Einstellungen eine andere Linkstruktur als "Einfach".
- Bestätige, indem du auf Änderungen speichern klickst.
- Wenn du fertig bist, integriere Klaviyo wieder.