- 03 Nov 2025
- 5 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Fehlersuche bei Beacons mit Whatfix Diagnostics
- Aktualisiert am 03 Nov 2025
- 5 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Nehmen wir an, Sie haben ein Beacon in Ihrer Anwendung erstellt. Wann Sie das Beacon in der Vorschau anzeigen, erscheint es nicht wie erwartet. Sie versuchen, das Problem zu beheben, wissen aber nicht, was schief gelaufen ist und wie man es beheben kann. Mit dem Diagnosticskönnen Sie Probleme mit Beacons erkennen, verstehen, warum sie nicht funktionieren, und erhalten verwertbare Insights, um sie zu lösen.
Verwenden Sie die folgenden Schritte, um auf die Diagnostics zuzugreifen:
Gehen Sie zur Seite, auf der Sie Ihre Inhalte beheben möchten, und starten Sie dann das Whatfix Desktop Studio.

Klicken Sie auf das Symbol Diagnostics.

Klicken Sie Vorschaumodus.

Klicken Sie auf Enter und warten Sie, bis die Seite automatisch aktualisiert wird.

Note:
Wenn Sie Vorschaumodus von der Seite zur Inhaltserstellung aktivieren, müssen Sie die Seite manuell aktualisieren, um den Vorschaumodus zu aktivieren.
.png?sv=2022-11-02&spr=https&st=2025-11-05T07%3A26%3A43Z&se=2025-11-05T07%3A36%3A43Z&sr=c&sp=r&sig=%2FnhPdRFItnA5662nf1HobiYpPUPvmiTEDjkNNp%2FPlcU%3D)
Nach der Vorschau starten Sie Diagnostics mit Ctrl + alt + ;.
Sobald es geöffnet ist, hilft Ihnen Diagnostics, alle relevanten Inhalte und Widgets für diese Seite anzuzeigen.
Info:
Stellen Sie sich vor, Sie haben mehrere Inhalte in Ihrer Anwendung erstellt. Beim Testen dieses Inhalts auf verschiedenen Seiten würden Sie erwarten, dass er auf der richtigen Seite oder im richtigen Abschnitt erscheint.
Um Ihnen zu helfen, den Inhalt zu identifizieren, der auf einer bestimmten Seite angezeigt werden kann, kategorisiert Diagnostics den Inhalt in zwei Abschnitte:
Auf dieser Seite: Listet Inhalte und Widgets auf, die auf der aktuellen Seite konfiguriert sind, um angezeigt zu werden. Dies umfasst Inhalte, die eine gültige URL oder Page Tag Bedingung haben, die mit der aktuellen Seite übereinstimmt.
Nicht auf dieser Seite: Listet Inhalte und Widgets auf, die auf der aktuellen Seite nicht angezeigt werden. Dies könnte möglicherweise auf eine Bedingungskollision zurückzuführen sein, wie z. B. eine falsche URL, ein ungültiger Page Tag oder falsche Visibility Rules für Widgets.
Die Abschnitte fungieren als integrierter Filter, der Ihnen hilft, fehlenden Inhalt zu identifizieren und Probleme effizienter zu beheben.
Verwenden Sie die Suche Leiste, um spezifische Inhalte oder Widgets zu finden.
Erweitern Sie das Beacons Akkordeon und klicken Sie auf Diagnose für das Beacon Segment, das Sie beheben möchten.
Info:
Whatfix wertet die Beacon Widgets auf der Seite aus und zeigt den Status als Ausgewertet oder Nicht Ausgewertet an.

Klicken Sie auf den Abschnitt Beacons, um alle Beacons der Sammlung zu sehen.

Note:
Erweitern Sie unter dem Abschnitt Visibility Rules die Akkordeons für Wo, Wann Beginn, Wann Ende und Wer, um Probleme mit den Visibility Rules für Widgets zu beheben.

Weitere Informationen über New Visibility Rules finden Sie unter New Visibility Rules verstehen.
Info:
Diagnostics verwendet verschiedene Status, um den aktuellen Zustand der einzelnen Schritte oder Inhalte zu beschreiben.
Erweitern Sie das Akkordeon, um den Arbeitsablauf im Diagnostic Panel zu verstehen.
Den Arbeitsablauf in der Diagnostics verstehen
Wann Sie die Diagnostics aktivieren, beginnt Whatfix mit der Auswertung der für die Seite konfigurierten Inhalte und Widgets.
Während Sie mit dem Inhalt interagieren, aktualisiert Whatfix den Status bei jedem Schritt und hilft Ihnen zu verstehen, was funktioniert und was nicht.
Erfolgspfad: Wann der Inhalt oder Schritt wie erwartet funktioniert
Status
Was bedeutet das?
Suchen
Whatfix sucht auf der Seite nach dem Zielelement. Es wird versucht, die UI Komponente zu finden, mit der der Inhalt oder Schritt verknüpft ist.
Gefunden
Whatfix hat das Zielelement erfolgreich gefunden und wartet auf eine Interaktion, um die zugehörige Tooltip anzuzeigen
Vervollständigt
Whatfix markiert den Schritt als abgeschlossen und zeigt damit an, dass mit dem Inhalt nun interagiert werden kann. Zum Beispiel durch Anklicken eines Beacons.
Nicht gefundener Pfad: Wann der Inhalt nicht erscheint
Status
Was bedeutet das?
Suchen
Whatfix beginnt mit der Suche nach dem Zielelement auf der Seite. Es wird versucht, die UI Komponente zu finden, mit der der Inhalt oder Schritt verknüpft ist.
Nicht gefunden
Whatfix findet das Zielelement nicht. Dies geschieht aus Gründen wie einer falschen URL oder fehlenden Page Tags.
Note:
Wenn ein Beacon den Status Nicht gefunden anzeigt, bedeutet dies, dass Whatfix das Zielelement auf der Seite nicht findet. Wenn Sie z. B. auf den Status klicken, wird eine Meldung angezeigt, dass ein CSS Selektor Problem erkannt wurde. Um dieses Problem zu beheben, befolgen Sie die vorgeschlagenen Lösungsschritte in Diagnostics oder wählen Sie das Element manuell erneut aus, um seine Eigenschaften zu aktualisieren.
Klicken Sie auf das folgende Akkordeon, um die Fehlermeldung, ihre Bedeutung und die Schritte zur Behebung des Problems anzuzeigen.
Fehlermeldungen, ihre Bedeutung und Schritte zu ihrer Behebung
Status | Status des Schrittes | Fehlercode | Fehlermeldung | Was bedeutet das? | Was können Sie tun? |
|---|---|---|---|---|---|
Nicht ausgewertet | - | - | Visibility Rule stimmen nicht überein oder Fehler | Whatfix kann das Widget nicht auswerten, weil einige der Bedingungen der Visibility Rule nicht erfüllt sind. | Überprüfen Sie den Visibility Rule Bedingungen und nehmen Sie die erforderlichen Änderungen vor. Wenn das Problem weiterhin besteht, wenden Sie sich an support@whatfix.com. |
Nicht gefunden | Nicht übereinstimmende Eigenschaften entdeckt | PROP_001 | Whatfix kann das Zielelement nicht finden, weil sich die eindeutigen Eigenschaften, mit denen es bei der Erstellung identifiziert wurde, geändert haben oder nicht vorhanden sind. | Whatfix kann das Element nicht lokalisieren, da sich seine einzigartigen Identifizierungseigenschaften geändert haben oder nicht mehr existieren. | Das Zielelement erneut auswählen. Wenn das Problem weiterhin besteht, wenden Sie sich an support@whatfix.com. |
PROP_002 | Whatfix kann das Zielelement nicht finden, weil die für das Element konfigurierten HTML-Eigenschaften auf der Seite fehlen. | Whatfix kann das Element nicht lokalisieren, da die erforderlichen HTML Eigenschaften von der Seite fehlen | Das Zielelement erneut auswählen. Wenn das Problem weiterhin besteht, wenden Sie sich an support@whatfix.com. | ||
CSS Selektor Problem erkannt | CSS_001 | Whatfix kann das Zielelement nicht finden, weil der für das Element konfigurierte CSS-Selektor falsch ist oder fehlt. | Whatfix kann das Zielelement nicht finden, weil der CSS Selector, der für das Element konfiguriert wurde, falsch ist oder fehlt. | Überprüfen Sie den hinzugefügten CSS Selector und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, wenden Sie sich an support@whatfix.com. | |
CSS_002 | Whatfix kann das Zielelement nicht finden, weil der automatisch generierte CSS-Selektor für das Element fehlt | Whatfix kann das Zielelement nicht finden, weil der automatisch generierte CSS Selector nicht existiert. | Das Zielelement erneut auswählen. Wenn das Problem weiterhin besteht, wenden Sie sich an support@whatfix.com. | ||
Suchzeit abgelaufen | ETO_001 | Whatfix kann das Zielelement nicht finden, weil die Element-Suchoperation eine Zeitüberschreitung aufweist. Das Zielelement wurde möglicherweise noch nicht geladen oder existiert nicht auf der Seite. | Whatfix kann das Element nicht finden, da es nicht auf der Seite geladen ist oder nicht existiert, was zu einem Timeout führt. | Vergewissern Sie sich, dass sich das Element auf der Seite befindet, oder führen Sie eine Aktion durch, damit das Element angezeigt wird. Wenn das Problem weiterhin besteht, wenden Sie sich an support@whatfix.com. | |
Beheben Sie das Problem anhand der Fehlermeldung.
Sobald der Fehler behoben ist, wird der Status auf Gefunden aktualisiert, und das Beacon erscheint wie vorgesehen..png?sv=2022-11-02&spr=https&st=2025-11-05T07%3A26%3A43Z&se=2025-11-05T07%3A36%3A43Z&sr=c&sp=r&sig=%2FnhPdRFItnA5662nf1HobiYpPUPvmiTEDjkNNp%2FPlcU%3D)

