PICO kennenlernen: Entdecke die Oberfläche in der Produkttour oder beginne mit dem Schnellstart.

Eigene Ereignisse und Webhook-Ziele nutzen

Erstellt am 30 Oktober, 2026 • Ziele & Conversions • 16 Aufrufe • 3 Minuten Lesezeit

Nutze eigene JavaScript-Ereignisse oder Webhooks für bestätigte Abläufe. Erfahre, wie PICO Werte speichert und wiederholte Webhook-Anfragen zählt.

Manche Erfolge haben keine eigene Danke-Seite: Ein Formular bestätigt den Versand direkt im aktuellen Fenster, eine Anwendung schließt einen Arbeitsschritt ab oder dein Server verarbeitet einen Auftrag. Dafür bietet PICO Benutzerdefiniertes Ereignis und Webhook als Zielauslöser. Wähle den Auslöser danach, wo du den Erfolg zuverlässig feststellen kannst.

Voraussetzungen und wichtige Unterschiede

Für ein eigenes Ereignis brauchst du Zugriff auf den JavaScript-Code deiner Website oder Unterstützung bei dessen Einbindung. Ein Webhook benötigt ein System, das HTTP-POST-Anfragen senden kann. Verwende für das Beispiel den bestätigten Abschluss einer Anfrage auf example.com.

Prüfe vorab die Websiteauswahl und deine erste Messung. Die abgebildete Zielübersicht enthält noch keine Daten und bietet noch keine sichtbare Anlegeaktion. Die Einrichtung der folgenden Auslöser erfolgt im Dialog Ziel erstellen, sobald dieser für dich verfügbar ist.

PICO: Leere Zielübersicht als Ausgangspunkt. Die Abbildung enthält weder ein Ereignis-Snippet noch eine private Webhook-URL.
Leere Zielübersicht als Ausgangspunkt. Die Abbildung enthält weder ein Ereignis-Snippet noch eine private Webhook-URL.

Ein eigenes Ereignis Schritt für Schritt einbinden

  1. Bestimme den bestätigten Erfolg. Beim Kontaktformular ist das beispielsweise die erfolgreiche Antwort deiner Anwendung nach der Verarbeitung. Ein Klick auf „Absenden“ kann der Validierung vorausgehen und bestätigt allein noch keinen Erfolg.
  2. Wähle „Benutzerdefiniertes Ereignis“. Vergib einen eindeutigen Namen und den passenden Schlüssel, etwa kontakt-erfolgreich für eine bestätigte Kontaktanfrage. Halte die Benennung im Team einheitlich.
  3. Übernimm den Code aus PICO. Die Einrichtung stellt dir den zugehörigen JavaScript-Code bereit. Verwende dieses konkrete Snippet. So bleiben der tatsächliche Ereignisaufruf und dein Ziel korrekt miteinander verbunden.
  4. Füge den Aufruf an der richtigen Stelle ein. Führe das Snippet in deiner Anwendung aus, nachdem der gewünschte Erfolg bestätigt wurde. Prüfe, ob derselbe Programmablauf den Aufruf versehentlich mehrfach ausführt, etwa durch doppelt registrierte Ereignisbehandlung.
  5. Teste Erfolg und Fehlerfall. Ein erfolgreicher Vorgang soll das Ereignis auslösen. Ein abgewiesenes oder unvollständiges Formular soll den Erfolgsaufruf nicht ausführen. Kontrolliere danach Ziel und Testzeitraum in PICO.

Ein Webhook-Ziel Schritt für Schritt verwenden

  1. Wähle „Webhook“. Lege das Ziel mit einem aussagekräftigen Namen an. Die private Webhook-URL wird beim Bearbeiten des Ziels angezeigt. Übernimm sie in die dafür vorgesehene geschützte Konfiguration deines sendenden Systems.
  2. Sende einen POST nach dem Erfolg. PICO unterstützt JSON, Formulardaten und einen leeren POST. Ein optionales Feld heißt value. Ein beispielhafter JSON-Body für einen Betrag lautet {"value":49.90}. Dafür ist keine erfundene allgemeine Endpoint-Adresse nötig; maßgeblich ist deine Ziel-URL.
  3. Plane Wiederholungen bewusst. Jede akzeptierte POST-Anfrage zählt separat, auch eine wiederholte Anfrage für denselben Vorgang. Wenn dein System bei Fehlern erneut sendet, musst du die fachliche Behandlung möglicher Wiederholungen dort planen. PICO verspricht für diese Anfragen keine automatische Zusammenfassung zu einem einmaligen Abschluss.
  4. Kontrolliere Anzahl und Wert. Sende einen kontrollierten Test und prüfe die Zielauswertung. Dokumentiere, wie viele Anfragen tatsächlich angenommen wurden. Veröffentliche die private URL weder im Frontend noch in Screenshots oder frei zugänglichen Anleitungen.

Werte und Auswertung richtig verstehen

Fehlt beim Webhook der Wert, verwendet PICO den eingestellten Conversion-Wert. Der Betrag wird mit der jeweiligen neuen Conversion gespeichert. Änderst du den Zielwert später, werden historische Werte nicht nachträglich angepasst. Eine andere Website-Währung ändert nur die Beschriftung und rechnet vorhandene Beträge nicht um.

Webhook-Conversions enthalten Zeitpunkt und Wert. Sie sind keinem Besucher, keiner Sitzung und keinem Seitenereignis zugeordnet. Sie fließen in Gesamtsummen ein, lassen sich aber nicht über Besucher- oder Seitenfilter auswerten. Das erklärt mögliche Unterschiede zwischen einer Gesamtansicht und einer segmentierten Zielauswertung.

Häufige Fehler

Vermeide Ereignisse vor der Erfolgsbestätigung, ungeprüfte Wiederholungen und vermischte Einheiten. Ein gemessener Betrag ist nur so aussagekräftig wie seine Herkunft: Kennzeichne intern, ob du tatsächlichen Umsatz, einen Auftragswert oder eine geschätzte Bewertung übermittelst.

Passende Anleitungen