Fehlerbehebung bei deiner WooCommerce-Integration

Übersicht

Erfahre, wie du Probleme bei der Einrichtung deiner WooCommerce-Integrationen löst, indem du dem unten beschriebenen relevanten Fehlerbehebungsszenario folgst. Wenn du Probleme hast, die nicht auf dieser Liste stehen, wende dich bitte in der Community oder an unser Support-Team.

Bevor du anfängst

Falls du das noch nicht getan hast, lies unseren Leitfaden zu Erste Schritte mit WooCommerce, um Schritt-für-Schritt-Anleitungen zur Integration zu erhalten. Wenn du dein Plug-in aktualisieren möchtest, sieh dir unseren Artikel zu so aktualisierst du dein WooCommerce-Plug-in an.

Szenarien zur Fehlerbehebung

Sieh dir die folgenden Szenarien basierend auf der in der App erhaltenen Fehlermeldung an, um dein Problem zu beheben.

„Um Funktionsstörungen zu vermeiden, musst du möglicherweise die folgenden Plug-ins deaktivieren: Name(n) des Plug-ins“

Wenn du aktive Cache- oder Redirect-Plug-ins in WordPress hast, können diese die Integrationen von Klaviyo beeinträchtigen und Verbindungsprobleme verursachen. Wir empfehlen, diese Plug-ins während der Einrichtung der Integrationen 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 in Cloudflare aktiviert hast oder beides.

Zur Behebung empfehlen wir sowohl, Klaviyo-Integrationstraffic auf die Allowlist zu setzen, als auch den Bot Fight Mode zu deaktivieren (falls du ihn aktiviert hast).

1. Erfahre, wie du IP-Adressen für Klaviyo-Integrationen-Traffic auf die Whitelist setzt.
2. So deaktivierst du den Bot Fight Mode in Cloudflare:
   1. Im Cloudflare-Dashboard einloggen.
   2. Wähle dein Konto und deine Domain aus.
   3. Gehe zu Sicherheit > Bots.
   4. Wähle für den Bot Fight Mode Aus.

„Stelle sicher, dass dein WooCommerce-Shop HTTPS und SSL aktiviert hat“

Klaviyo erwartet, dass sich die URL deines Shops an HTTPS-Protokolle hält, d. h., dass die Website ein gültiges SSL-Zertifikat hat. Wenn deine Website HTTP statt HTTPS verwendet, kann es zu Problemen kommen.

Du kannst prüfen, ob dein SSL-Zertifikat gültig ist, unter SSL Server Test (Powered by Qualys SSL Labs).

Klaviyo erfordert, dass die Tests mit der Benotung A bestehen.

„Zugriff auf API mit den angegebenen Zugriffsdaten nicht möglich“

Dieser Fehler kann auftreten, wenn du Anpassungen eingerichtet hast, um den API-Zugriff für nicht angemeldete Nutzer*innen zu verhindern. Normalerweise ist das eine Funktion in der functions.php -Datei von WordPress, 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.

„Zugriff auf die Bestell-API nicht möglich. Bitte überprüfe die Verbindungseinstellungen und versuche es erneut“

Dieser Fehler bedeutet, dass die API, wenn Klaviyo versucht, die WooCommerce-Integrationen zu validieren und eine Bestellanzahl abzurufen, keinen Wert zurückgibt, den Klaviyo erwartet, oder gar nichts zurückgibt.

Da sich die Integration noch nicht offiziell mit Klaviyo verbunden hat, bedeutet das, dass das Problem in WooCommerce behoben werden muss.

Um mehr Informationen zu diesem Fehler zu erhalten, musst du einen API-Aufruf an den Endpunkt für die Bestellanzahl senden, der mehr Erkenntnisse darüber liefert, was an Klaviyo übergeben wird. Hier ist ein Beispiel für eine cURL-Anfrage. Um es zu verwenden, gib deine Store-URL, deinen Consumer Key und dein Consumer Secret ein:

curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET

„Dein Klaviyo-Plug-in ist nicht auf dem aktuellen Stand“

Gelegentlich verzögert sich der Webhook beim Erreichen von Klaviyo, wodurch du vorübergehend die alte Einstellungsseite siehst. Das sollte sich nach ein paar Minuten von selbst erledigen.

404 beim Verbinden mit Klaviyo aus WordPress

Um das zu beheben, solltest du bestätigen, dass Permalinks für deine WordPress-Website aktiviert sind. Die WooCommerce-Authentifizierung funktioniert nur, wenn Permalinks aktiviert sind.

1. Navigiere zu deiner WordPress-Website und gehe zu Einstellungen > Permalinks.
2. Wähle unter Allgemeine Einstellungen eine beliebige Linkstruktur außer Einfach aus.
3. Bestätige, indem du auf Änderungen speichern klickst.
   

4. Wenn du fertig bist, integriere Klaviyo erneut.

Installation fehlgeschlagen – wir konnten deine Erweiterung nicht installieren

Möglicherweise tritt beim Versuch, die Integrationen über den WooCommerce Marketplace zu installieren, der Fehler „Installation Failed“ auf.

Falls du die Installation über den WooCommerce Marketplace nicht erfolgreich durchführen kannst, kannst du das Plug-in auch über deine WordPress-Plug-in-Administration installieren.

1. Navigiere zu deiner WordPress-Administration und gehe zu Plug-ins.
2. Wähle Plug-in hinzufügen.
3. Suche in Plug-ins suchen nach Klaviyo.
4. Wähle Jetzt installieren aus.
5. Wähle Aktivieren.
6. Wähle in der linken Navigation Marketing aus und klicke dann auf Klaviyo.
7. Klicke zum Start auf Konto verbinden und fahre dann mit die WooCommerce-Integration aktivieren im Artikel Erste Schritte mit WooCommerce fort.