Widget auf einer Webseite installieren

Skript, Token und Domain bilden eine einheitliche Kontrolle

Der von Wavize bereitgestellte Code lädt das Widget mit einem signierten öffentlichen Token. "Öffentlich" bedeutet, dass es im Browser sichtbar sein kann; das heißt nicht, dass es auf beliebigen Websites wiederverwendbar ist. Das Token ist an die registrierte Domain gebunden.

Installieren Sie den Block, ohne seine ID zu verändern, und testen Sie dann die dem Besucher tatsächlich gelieferte Seite. Ein Editor zeigt Code vielleicht an, ohne ihn zu veröffentlichen, und ein Cache kann weiterhin alte Versionen ausliefern.

Keine falschen Daten teilen
Das Widget-Token kann im Browser eingesehen werden. Jedoch sind Schlüssel für WooCommerce, PrestaShop, Shopify, Wix, Klaviyo oder Mailchimp geheim und dürfen niemals im HTML eingefügt werden.

Richtige Domain vorbereiten

Die während des Onboardings eingegebene Domain muss mit der öffentlich getesteten Adresse übereinstimmen.

1. HTTPS und www-Variante

   Überprüfen Sie die finale Browser-Weiterleitung. Wenn die Website auf www.beispiel.de landet, testen Sie nicht nur beispiel.de ohne zu bestätigen, dass die autorisierte Domain diese Variante einschließt.

2. Ein Token pro autorisierter Domain

   Kopieren Sie den Code nicht von einer Umgebung in eine andere Produktions- oder Vorproduktions-Domain. Generieren oder wählen Sie das entsprechende Token im Assistant > Installation aus.

3. Verfügbares Abonnement

   Die öffentliche Ladefunktion hängt auch vom Zugriff auf den Tarif ab. Ein korrektes Skript bleibt unsichtbar, wenn das Abonnement nicht mehr aktiv ist.

Code plattformgerecht platzieren

Die Methode hängt vom CMS ab, aber das Ergebnis ist immer gleich: Das Skript erscheint nur einmal auf allen gewünschten Seiten.

1. HTML-Seite oder Tag-Manager

   Fügen Sie den Block vor dem schließenden Body-Tag oder an einer globalen Stelle nach erforderlicher Zustimmung ein. Vermeiden Sie das doppelte Laden im Theme und im Tag-Manager.

2. WordPress / WooCommerce

   Nutzen Sie das während des Onboardings heruntergeladene Modul, aktivieren Sie es und fügen Sie das Token in der Konfiguration ein. JavaScript-Optimierungen dürfen das Skript nicht verzögern oder invalidieren.

3. PrestaShop

   Installieren Sie das Modul über den Manager, öffnen Sie die Konfiguration und geben Sie das Token ein. Leeren Sie anschließend den Smarty/PrestaShop-Cache und ggf. den CDN-Cache.

4. Shopify und Wix

   Der Shopify App Store verwaltet normalerweise App Embed und Verbindung. Auf Wix verwenden Sie den globalen benutzerdefinierten Code nur, wenn Ihr Wix-Angebot diese Art der Einbindung erlaubt, und platzieren ihn auf allen Seiten.

Veröffentlichen und im Browser prüfen

Testen Sie im privaten Modus, um Cache-, Zustimmungs- oder Administrator-Sitzungsprobleme auszuschließen.

1. Skript finden

   Öffnen Sie den Quellcode oder das Netzwerk-Tab und suchen Sie nach Wavize. Fehlt es, liegt das Problem vor dem Aufruf: Veröffentlichung, Theme, Tag oder Cache.

2. Konsole und Netzwerk auswerten

   Ein CSP-Fehler zeigt, dass Sicherheitsrichtlinien ein Skript- oder Verbindungs-Domain blockieren. Ein 401 / 403 verweist auf Token, Domain oder Zugriff; Extensions-Blockaden verschwinden oft ohne Werbeblocker.

3. Cookies und Overlay prüfen

   Akzeptieren Sie die Consent-Kategorie, die Ihre Richtlinie vorsieht. Wenn der Button existiert, aber versteckt ist, prüfen Sie Position, Z-Index und Überlappungen mit Warenkorb, Navigation oder Cookie-Banner.

Minimale Abnahme nach Veröffentlichung

Führen Sie den Test sowohl an einem Computer als auch an einem echten Smartphone durch.

• Öffnung — Der Button erscheint, öffnet das Widget und verzerrt die Seite nicht.
• Gespräch — Eine Besucher-Nachricht erhält eine Antwort und erscheint im Posteingang.
• Proaktiver Empfang — Die Kampagne erscheint entsprechend Zeitlimit und Budget, nicht bei jedem Neuladen.
• Sekundäre Seite — Eine zweite Seite bestätigt, dass die Installation global ist.