Dokumentation

Debugging von Problemen mit Visual Experience Composer (VEC) in Single Page Applications (SPA)

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Dieser Artikel enthält Best Practices zum Debugging von Problemen mit Visual Experience Composer (VEC) bei Single Page Applications (SPA) in Adobe Target.

Beschreibung description

Umgebung

Adobe Target

Problem/Symptome

Adobe Target VEC für SPA nutzt ein neues Konzept namens Ansichten (eine logische Gruppe visueller Elemente, die zusammen ein SPA-Erlebnis bilden).

Da SPA nicht darauf angewiesen ist, Angebote beim Laden der Seite abzurufen, gibt es einige Einschränkungen und Voraussetzungen:

  • SPA VEC unterstützt keine automatischen Targeting-, Automated Personalization- oder Recommendations-Aktivitäten.

  • at.js 2.0+ und die adobe.target.triggerView() müssen in der App implementiert werden, bevor Sie den SPA VEC verwenden können.

  • Die Reihenfolge der Vorgänge für das erste Laden der Seite ist wie folgt:

    Laden VisitorAPI JS" Laden at.js 2.x" Ausführen Target-Anfrage (Vorabruf)" triggerView().

Auflösung resolution

Stellen Sie beim Debuggen von VEC-Problemen im Zusammenhang mit SPA Folgendes sicher:

  1. Stellen Sie sicher, dass adobe.target.triggerView() Funktion für jede Ansicht ausgelöst wird.

  2. Stellen Sie sicher, dass die Seite die Parameter mboxEdit=1 und mboxDisable=1 nicht zuschneidet oder entfernt

    Target fügt beim Öffnen der Website im Visual Experience Composer zwei Parameter (mboxEdit=1 und mboxDisable=1) hinzu.

    Wenn Ihre Website (insbesondere Single Page Apps) Ihre Parameter zuschneidet oder entfernt, während Sie von einer Seite zur anderen navigieren (ohne dass die Seite neu geladen wird), funktioniert die Target-Funktion nicht mehr und die Target-Bibliotheken werden nicht geladen.

  3. Suchen Sie nach Fehlermeldungen, die in den Konsolenprotokollen angezeigt werden können. Beispielsweise könnte ein Problem auftreten, wenn der i-Frame das Laden der Ansicht blockiert. Eine häufige Fehlermeldung ist:

    code language-none 
    Uncaught DOMException: Blocked a frame with origin "https://view.customer-website.com" from accessing a cross-origin frame.
at https://www.adobe.com

  4. Prüfen Sie die Netzwerkprotokolle auf Target View Notification Call (Target-Benachrichtigungsaufruf mit Status 204). Wenn der Anruf blockiert ist, überprüfen Sie den Status.

  5. Bei Problemen, bei denen die Änderung nicht mehr im VEC angezeigt wird, sondern im Bedienfeld „Änderung“ angezeigt wird und Sie die Änderungen nicht aus dem Bedienfeld löschen können, stellen Sie sicher, dass der Name Ansicht keine nachfolgenden Leerzeichen enthält.

  6. Weitere Details, die beim Einrichten des view name sichergestellt werden müssen, sind:

    • Keine nachfolgenden Leerzeichen.
    • Darf nicht leer sein.
    • Ansicht Der Name sollte für alle Seiten eindeutig sein.
    • Ansicht Der Name darf nicht mit "/" beginnen oder enden. Dies liegt daran, dass man im Allgemeinen den Ansichtsnamen aus dem URL-Pfad extrahiert. Für uns Home und /Home unterschiedlich.
    • Dieselbe Ansicht sollte nicht mehrmals hintereinander mit der Option {page: true} ausgelöst werden.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f