Installation über Google Tag Manager und wann du es lassen solltest

Google Tag Manager kann Provedly mit einem benutzerdefinierten HTML-Tag und dem Trigger „All Pages“ laden, und für Teams, die nicht an die Templates der Website dürfen, ist das der schnellste Weg. Aber GTM ist eine Zwischenschicht mit eigener Ladereihenfolge, eigener Einwilligungssteuerung und eigener Angriffsfläche für Blocker, und bei einem Widget, dessen ganzer Wert darin liegt, gesehen zu werden, kostet jeder dieser Punkte etwas. Dieser Beitrag zeigt die Installation und sagt dir dann, wann du GTM auslassen solltest.

Das Tag

Leg ein neues Tag vom Typ „Benutzerdefiniertes HTML“ an und füge entweder das einfache Script-Tag oder die Funktionsform ein. GTM akzeptiert beides; die Funktionsform erzeugt das Dashboard für Leisten, weil sie die Attribute explizit setzt.

<script>
    (function () {
        var s = document.createElement('script');
        s.src = 'https://provedly.app/w/widget.js';
        s.setAttribute('data-token', 'pp_your_token');
        s.async = true;
        document.body.appendChild(s);
    })();
</script>

Trigger: All Pages. Gib dem Tag einen Namen, den ein Nachfolger versteht, veröffentliche den Container und prüf innerhalb weniger Minuten im Provedly-Dashboard, ob die ersten Impressionen ankommen. Für eine CTA-Leiste wiederholst du das mit https://provedly.app/w/cta.js und dem Token der Leiste.

Füge in GTM keine URL-Filter hinzu, um zu steuern, wo das Widget erscheint. Das URL-Targeting von Provedly (all pages, only these, all except) und das Geräte-Targeting werden im Dashboard konfiguriert und gelten gleichermaßen, egal ob das Script aus GTM oder direkt aus der Seite kommt. Ein Ort für die Regel ist besser als zwei.

Single-Page-Apps

Wenn deine Website eine SPA ist, feuert der Trigger „All Pages“ von GTM einmal beim ersten Laden, und das ist für Provedly richtig. Der Loader ist idempotent und kümmert sich selbst um Routenwechsel. Füge für dieses Tag keinen Trigger für Verlaufsänderungen hinzu; er würde bei jeder Navigation ein zweites Script-Element einfügen. Der Loader prüft vor der Initialisierung, ob schon eine Instanz existiert, der Schaden sind also verschwendete Requests statt doppelter Toasts, aber einen Vorteil gibt es nicht.

Wann GTM das falsche Werkzeug ist

Die Einwilligungssteuerung verzögert oder blockiert das Widget

Viele Consent-Setups halten alle GTM-Tags zurück, bis der Besucher Cookies akzeptiert. Wenn Provedly hinter dieser Schranke sitzt, sehen Besucher, die ablehnen oder nie mit dem Banner interagieren, keine einzige Benachrichtigung. Ob das Widget überhaupt eine Einwilligung braucht, ist eine Frage für deine eigene Datenschutzprüfung; es setzt eine Besucher-ID für Session-Limits und Zuordnung. Wenn deine Prüfung ergibt, dass keine Einwilligung nötig ist, umgehst du mit dem direkten Laden in der Seite eine Schranke, die für Analytics und Werbung gedacht war.

Blocker

Content-Blocker blockieren häufig den GTM-Container selbst. Ein Besucher, der einen nutzt, sieht keine Tags aus diesem Container, Provedly eingeschlossen. Ein direktes Script-Tag von provedly.app ist für den Blocker eine eigene Entscheidung und wird von Regeln, die auf googletagmanager.com zielen, nicht erfasst. Das ist bei einem eher technischen Publikum wichtiger.

Shopify

Nutze bei Shopify die Provedly-App und ihr Theme App Embed statt GTM. Die App importiert bei der Installation die Bestellungen der letzten 60 Tage, empfängt jede neue Bestellung über einen signierten Webhook und markiert Käufe dadurch als „Verified“, ganz ohne Script-Tag. Außerdem läuft GTM bei Shopify in den meisten Plänen nicht im Checkout, die Installation wäre also unvollständig. Siehe die Einrichtungsanleitung für Shopify.

Du brauchst die Besucher-ID im Checkout

Proof-unterstützte Bestellungen im Dashboard werden über die Besucher-ID zugeordnet. Dein Checkout-Code liest sie mit window.Provedly?.visitorId() und übergibt sie als Stripe-metadata.provedly_visitor oder als Feld visitor der Records API. Wenn GTM Provedly spät lädt, existiert die ID möglicherweise noch nicht, wenn dein Checkout-Code läuft. Mit einer kurzen Wartezeit lässt sich das lösen, aber ein direktes async defer-Tag im Template beseitigt die Race Condition.

Reihenfolge und Performance

GTM lädt den Container, wertet dann die Trigger aus und fügt dann das Script ein. Das sind zwei zusätzliche Schritte vor einer 6-KB-Datei. Auf einer schnellen Seite sind das ein paar hundert Millisekunden; auf einer langsamen kann es den ersten Toast über den Punkt hinausschieben, an dem der Besucher schon weitergescrollt hat. Das Widget wartet standardmäßig ohnehin 3 Sekunden vor der ersten Benachrichtigung, und du kommst noch obendrauf.

Eine Entscheidungstabelle

Die Installation prüfen

Öffne deine Website, warte ein paar Sekunden und halte nach dem Toast Ausschau. Wenn nichts erscheint, prüf in dieser Reihenfolge: Der GTM-Container ist veröffentlicht (nicht nur in der Vorschau); das Tag wurde im Debug-Panel von GTM ausgelöst; die Domain der Seite steht in Provedly auf der Liste erlaubter Domains der Website; das Widget hat mindestens einen Datensatz zum Anzeigen, sonst hat es nichts zu sagen. Ein neues Widget ohne Datensätze ist die häufigste Meldung „es funktioniert nicht“. Poste einen Datensatz über die API oder importiere eine CSV, dann erscheint er mit dem Label Imported. Oder verbinde Stripe und warte auf die erste echte Bestellung.

Häufige Fragen

Kann ich das Widget erst nach der Einwilligung laden und Impressionen trotzdem genau zählen?

Ja. Impressionen werden gezählt, wenn eine Benachrichtigung tatsächlich angezeigt wird, ein zurückgehaltenes Widget, das nie lädt, verbraucht also nie eine Impression. Der Preis ist Reichweite, nicht Genauigkeit.

Zählt das Script von GTM selbst zu meinem Impressionskontingent?

Nein. Nur gerenderte Benachrichtigungen zählen. Eine Impression ist eine Benachrichtigung, die einem Besucher angezeigt wird, rund 3 pro Besuch.

Kann ich GTM für das Widget und ein direktes Tag für die Leiste nutzen?

Ja, das sind unabhängige Loader mit getrennten Tokens. Mischen ist in Ordnung, solange jeder nur einmal pro Seite vorkommt.

Welchen Weg du auch wählst, der Free-Plan reicht, um ihn auf einer echten Website zu testen: Konto anlegen.