Fehlerbehebung bei Drittanbieter-Integrationen, -Events und -Onsite-Widgets in Klaviyo

Häufige Probleme mit Tools von Drittanbietern

Bei der Verwendung von Drittanbieter-Apps mit Klaviyo (z. B. E-Commerce-Plug-in, Bewertungstools oder Widgets) kannst du folgende Probleme feststellen:

• Integrationen, die Verbindungsprobleme melden
• Erwartete Ereignisse oder Eigenschaften werden in Klaviyo nicht angezeigt
• Dynamische Variablen (z. B. {{ review_url }} oder Gutschein-Tags), die als leer angezeigt werden
• Onsite-Widgets oder -Formulare, die nicht durchgehend auf deinen Seiten geladen werden

In diesem Leitfaden werden grundlegende Prüfungen beschrieben, die du vor der Kontaktaufnahme mit dem Support durchführen kannst.

Integrationsstatus und Konnektivität überprüfen

1. Prüfe die Integration in Klaviyo:

• Gehe zu Integrationen und bestätige, dass die entsprechende Integration (z. B. WooCommerce oder deine Bewertungs-App) aktiviert ist.
• Wenn du eine E-Mail zu einem Verbindungsproblem erhalten hast, befolge alle darin enthaltenen Anweisungen (z. B. zur erneuten Autorisierung der Integration).

2. Führe eine Testaktion von deiner Website oder App aus:

• Gib eine Testbestellung auf, reiche eine Bewertung ein oder schließe eine Testaktion ab, die Daten an Klaviyo senden soll.

3. In Klaviyo kannst du:

• Auswertungen > Metriken für neue Ereignisse im Zusammenhang mit diesem Tool.
• Ein betroffenes Profil für neue Aktivitäten aus dieser Integration.

Wenn die letzten Aktionen in Klaviyo überhaupt nicht angezeigt werden, kann es ein Verbindungs- oder Konfigurationsproblem in der Drittanbieter-App geben, das sie daran hindert, Daten zu senden.

Fehlende Ereignisse oder leere Variablen diagnostizieren

Manchmal ist die Integration verbunden, aber bestimmte Daten (z. B. eine Bewertungs-URL oder ein Gutscheincode) fehlen oder sind leer.

1. Ermittle, welches Ereignis dein Flow oder deine E-Mail verwendet:

• Öffne den Flow und beachte das Auslöserereignis (z. B. ein Ereignis für „Bestellung erfüllt“ oder ein benutzerdefiniertes Bewertungsereignis).

2. Gehe zu Auswertungen > Metriken, wähle diese Metrik aus und öffne ein aktuelles Ereignis.
3. In den Ereignisdetails:

• Vergewissere dich, dass die erwartete Eigenschaft (z. B. review_url oder ein Gutscheincode-Wert) vorhanden ist und einen Wert hat.

4. Wenn die Eigenschaft im Ereignis-Payload fehlt oder leer ist:

• Die Drittanbieter-App sendet diese Daten für diese Veranstaltung nicht an Klaviyo.
• Überprüfe die Integrationseinstellungen der App, um sicherzustellen, dass das Feld aktiviert ist, oder kontaktiere den Support der App.

5. Wenn die Eigenschaft mit einem Wert existiert, aber in deiner E-Mail leer erscheint:

• Überprüfe noch einmal, ob die dynamische Variable in deiner Vorlage genau mit dem Namen der Eigenschaft übereinstimmt (z. B. {{ review_url }}, wenn die Eigenschaft den Namen review_url hat).
• Bestätige, dass die E-Mail durch dasselbe Ereignis ausgelöst wird, das die Eigenschaft enthält. Wenn du ein anderes Ereignis verwendest, werden möglicherweise nicht die erwarteten Variablen bereitgestellt.

Bei Problemen mit Gutscheinen in Flows solltest du außerdem Folgendes überprüfen:

• Das Gutscheincode-Element oder Tag ist für deine Shop-Plattform richtig konfiguriert.
• Dass die zugrunde liegende Integration (z. B. WooCommerce oder Shopify) über aktive, gültige Gutscheine verfügt, die mit dem Flow verknüpft sind.

Fehlerbehebung bei nicht angezeigten Onsite-Widgets

Wenn Widgets aus einem Drittanbieter-Tool nur gelegentlich oder gar nicht auf deinen Seiten erscheinen:

1. Vergewissere dich, dass das Widget oder die Plug-in gemäß den Anweisungen des Anbieters korrekt installiert ist.
2. Stelle sicher, dass die entsprechenden Widgets (z. B. dein Bewertungsskript und das Klaviyo Onsite-Skript) auf den betroffenen Seiten geladen werden.
3. Prüfe auf häufige Probleme wie:

• Theme- oder Seiten-Builder-Caching, das das Laden neuer Skripts oder Abschnitte verhindert.
• Im Widerspruch zu JavaScript von anderen Apps.
• Fehlende oder fehlerhafte HTML-Container (z. B. eine fehlende div oder ID, bei der das Widget das Rendering erwartet).

4. Teste in einem privaten/inkognito Browserfenster und, wenn möglich, in einem anderen Theme oder auf einer Minimalseite, um Konflikte auszuschließen.

Wenn das Widget-Skript nie geladen wird oder wenn es geladen, aber keine Inhalte wiedergibt, teile die Protokolle und Screenshots der Browserkonsole mit dem Support-Team des Widget-Anbieters.

Wann kontaktierst du den App-Anbieter vs. Klaviyo Support?

Im Allgemeinen gilt:

• Wende dich an den App-Anbieter , wenn:
• In der Ereignis-Nutzlast, die an Klaviyo gesendet wurde, fehlen Daten oder sie sind leer.
• Ein Widget oder eine Plug-in wird auf deiner Website nicht wie erwartet angezeigt.
• Du benötigst sie, um zusätzliche Ereignisse oder Eigenschaften an Klaviyo zu senden.
• Wende dich an den Klaviyo Support, wenn:
• Ereignisse und Eigenschaften sind in Klaviyo vorhanden, aber du kannst sie nicht wie erwartet in Segmenten, Flows oder Vorlagen verwenden.
• Du siehst Fehler oder unerwartetes Verhalten in der Klaviyo-App selbst.

Bevor du dich meldest, solltest du Folgendes zusammentragen:

• Screenshots deiner Integrationseinstellungen.
• Beispiele für aktuelle Ereignisse aus Auswertungen > Metriken.
• Screenshots oder Links, die das Problem zeigen (z. B. leere Variablen in einer Testseite oder ein Widget, das auf einer bestimmten Produktseite fehlt).

Wenn du diese Angaben machst, können dein App-Anbieter und der Klaviyo Support schnell erkennen, ob das Problem mit den Daten besteht, die an Klaviyo gesendet werden, oder wie diese Daten verwendet werden, sobald sie eintreffen.