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

Zusätzliche Angaben mit Custom Parameters übergeben

Erstellt am 30 Oktober, 2026 • Tracking & Einrichtung • 8 Aufrufe • 2 Minuten Lesezeit

Ergänze den PICO-Pixel um gültige JSON-Parameter und prüfe neutrale Zusatzangaben in den Besucherfiltern.

Benutzerdefinierte Parameter ergänzen die Besucheranalyse um Angaben, die deine Website bereitstellt. Du kannst damit etwa einen Inhaltsbereich kennzeichnen. Diese Anleitung zeigt eine neutrale technische Vorlage und die passenden PICO-Filter. Verwende nur Angaben, die du für deine konkrete Analyse wirklich benötigst.

Voraussetzungen

Die Produkthilfe beschreibt benutzerdefinierte Besucherparameter als Funktion von „Erweitertes Tracking“. Du benötigst einen funktionierenden Pixel dieses Website-Eintrags und Zugriff auf dessen Einbindung. Prüfe zunächst die normale Messung. Wenn bereits die Grundmessung fehlt, erschweren zusätzliche Parameter die Fehlersuche.

Parameter Schritt für Schritt übergeben

  1. Lege Schlüssel und Bedeutung fest. Für example.com verwenden wir bereich mit dem Wert hilfe. Dieser Beispielwert beschreibt den aufgerufenen Bereich und enthält keine Namen, E-Mail-Adressen oder Zugangsdaten.
  2. Hole den richtigen Pixel aus „Pixel installieren“. Öffne in „Websites“ das Code-Symbol der passenden Zeile. Arbeite mit dem dort angebotenen Skript und dessen tatsächlichem Schlüssel.
  3. Ergänze das Attribut data-custom-parameters. Die PICO-Hilfe erwartet darin JSON. Im Beispiel umfasst das JSON-Objekt genau einen Schlüssel und einen Textwert. Doppelte Anführungszeichen gehören innerhalb von JSON zu Schlüsseln und Zeichenketten.
  4. Setze die ergänzte Version anstelle der bisherigen Einbindung ein. Vermeide einen zweiten, zusätzlich eingefügten Pixel. Veröffentliche die Änderung in deiner kontrollierten Website und prüfe den tatsächlich ausgelieferten HTML-Code.
  5. Führe einen neuen, bekannten Testbesuch aus. Öffne die Seite, auf der die Ergänzung veröffentlicht wurde. Notiere Zeitpunkt und Pfad. Achte auf dieselben Voraussetzungen wie bei der Grundmessung, insbesondere Tracking-Aktivierung, Ausschlüsse und vorhandene Einwilligungssteuerung.
  6. Prüfe „Besucher“ und die verfügbaren Filter. Die Hilfe beschreibt ein Fingerabdruck-Symbol bei Besuchern mit übermittelten Parametern. Zusätzlich sind „Schlüssel des benutzerdefinierten Parameters“ und „Wert des benutzerdefinierten Parameters“ als Analysefilter vorhanden.
  7. Kontrolliere zuerst einen einzelnen Wert. Suche beispielsweise nach dem Schlüssel bereich oder dem Wert hilfe. Prüfe die tatsächlich gespeicherte Darstellung, bevor du mehrere Bedingungen oder komplexere Datenstrukturen verwendest.

Technische Vorlage

<script defer
  src="https://app.pico-analytics.com/pixel/DEIN_PIXEL_SCHLUESSEL.js"
  data-custom-parameters='{"bereich":"hilfe"}'></script>

Ersetze DEIN_PIXEL_SCHLUESSEL durch den Schlüssel deiner Website. Der Code ist eine Vorlage, keine bereits funktionierende Einbindung. Die äußeren einfachen Anführungszeichen begrenzen hier das HTML-Attribut; die doppelten Anführungszeichen im Inneren bilden gültiges JSON. Wenn dein System Werte dynamisch einsetzt, muss es sie korrekt für JSON und HTML kodieren.

PICO: Die Besucheransicht ist der Ausgangspunkt für besucherbezogene Zusatzangaben. Im leeren Dokumentationsbeispiel sind noch keine Besucher oder Parameter vorhanden.
Die Besucheransicht ist der Ausgangspunkt für besucherbezogene Zusatzangaben. Im leeren Dokumentationsbeispiel sind noch keine Besucher oder Parameter vorhanden.

Erfolgskontrolle

Der normale Pixel bleibt funktionsfähig, und der neue Testbesuch lässt sich mit der erwarteten Zusatzangabe prüfen. Kontrolliere nicht nur, ob das Attribut im HTML steht, sondern auch, ob der Wert in PICO ankommt. Die Dokumentationsabbildung zeigt bewusst keine erfundenen Parameter an einem vermeintlich echten Besucher.

Typische Fehler und Grenzen

Ungültiges JSON, typografische Anführungszeichen oder eine unveröffentlichte Vorlage können die Übermittlung verhindern. Übertrage keine Passwörter, Sitzungstoken oder andere Geheimnisse als Parameter. Ein neutraler Schlüsselname allein macht einen personenbezogenen Wert nicht automatisch unkritisch.

Die hier belegte Anleitung beschreibt das Skriptattribut. Sie legt nicht fest, wann spätere dynamische Wertänderungen übernommen oder ältere Werte überschrieben werden. Wenn du Parameter während eines Besuchs ändern willst, prüfe diesen konkreten Ablauf gesondert und erfinde dafür keinen zusätzlichen JavaScript-Aufruf.

Passende Anleitungen