> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snowplow

> Senden Sie Kameleoon Experiment-Expositionsereignisse an die Verhaltensdatenplattform Snowplow, um Ihre Datenpipeline mit Experimentdaten auf Variations-Ebene anzureichern.

[Snowplow](https://snowplowanalytics.com/) ist eine Verhaltensdatenplattform. Mit Snowplow konnen Sie:

* Einen hochwertigen Verhaltensdatensatz erzeugen.
* Die Qualitat und Compliance Ihrer Daten mit Governance-Tools steuern, die in jeder Phase der Losung integriert sind.
* Verhaltensdaten mit anpassbaren inkrementellen Web- und Mobile-Modellen modellieren, die die Time-to-Value verkurzen und sicher in der Snowplow BDP Console verwaltet werden.

**Hauptvorteile:**

* Zoomen Sie auf einzelne Kunden und Ereignisse.
* Zoomen Sie heraus, um Verhaltensweisen zwischen Kohorten und im Zeitverlauf zu vergleichen.
* Segmentieren Sie Ihr Publikum nach Verhalten.
* Entwickeln Sie Empfehlungs- und Personalisierungs-Engines.

Mit unserer Snowplow-Integration konnen Sie nun Kameleoon-Kampagnenereignisse in jedem [Snowplow Collector](https://docs.snowplowanalytics.com/docs/getting-started-on-snowplow-open-source/setup-snowplow-on-aws/setup-the-snowplow-collector/) verwenden.

## Snowplow in Kameleoon aktivieren

Der erste Schritt besteht darin, Snowplow zu aktivieren. Gehen Sie dazu wie folgt vor:

1. Melden Sie sich bei der Kameleoon-App an.
2. Klicken Sie auf **Admin** > **Integrations** > **Install the tool**.
3. Wahlen Sie die Projekte aus, fur die Sie Snowplow konfigurieren mochten.
4. Klicken Sie auf **Validate**.

Sie sehen dann einen **ON**-Schalter rechts neben der Zeile des Tools sowie die Anzahl der Projekte, fur die das Tool konfiguriert ist.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/snowplow/Capture-decran-2023-03-08-a-14.28.58.png)
</Frame>

Die Daten werden automatisch mithilfe des [JavaScript-Trackers von Snowplow](https://docs.snowplow.io/docs/collecting-data/collecting-from-own-applications/javascript-trackers/javascript-tracker/) an Snowplow gesendet.

<Note>
  Wenn Sie das Verhalten unserer nativen Brucke andern mussen, konnen Sie [eine benutzerdefinierte Analytics-Brucke erstellen](../analytics/custom-analytics-integration) und den Snowplow-Beispielcode in [unserem Github-Repository](https://github.com/Kameleoon/custom-analytics-integrations/tree/main/snowplow) verwenden.
</Note>

### Kameleoon Snowplow Event-Dispatcher

Wenn Ihre Kameleoon-Ereignisse von mehreren Quellen erzeugt werden, ist unsere Snowplow Event-Dispatcher-Integration besser fur diese Anwendungsfalle geeignet.

Diese Integration ist direkt mit unserer Event-Streaming-Ebene verbunden. Sie isoliert die Expositionsereignisse, die mit Ihrer Projekt-ID verbunden sind, und sendet sie uber einen HTTP-Aufruf an Ihren Snowplow Stream Collector.

Um den Dispatcher fur ein bestimmtes Projekt einzurichten, geben Sie Ihrem technischen Account Manager die folgenden Informationen:

* Die URL Ihres Snowplow Stream Collectors
* Den Host Ihres Iglu Schema Registry und Ihren Snowplow API Key.

Das Schema-Register und der API-Key werden verwendet, um Ihre Snowplow-Pipeline uber das benutzerdefinierte Schema des Kameleoon-Expositionsereignistyps zu informieren, sodass Ihr System die anschliessend gesendeten Daten korrekt interpretieren kann. Ihr API-Key wird daher nur einmal verwendet.

Das Schema eines Kameleoon-Expositionsereignisses, das wir in Ihr Register pushen, lautet wie folgt:

```json theme={null}
    {
        "$schema": "http://iglucentral.com/schemas/com.snowplowanalytics.self-desc/schema/jsonschema/1-0-0#",
        "self": {
            "vendor": "kameleoon",
            "name": "kameleoon_experiment_exposure",
            "format": "jsonschema",
            "version": "1-0-0"
        },
        "type": "object",
        "properties": {
            "nonce": {
                "type": "number"
            },
            "visitor_code": {
                "type": "string"
            },
            "timestamp": {
                "type": "number"
            },
            "experiment_id": {
                "type": "number"
            },
            "variation_id": {
                "type": "number"
            }
        },
        "required": ["nonce","visitor_code","timestamp","experiment_id","variation_id"],
        "additionalProperties": false
    }
```

Wobei:

* `nonce` der Event-UUID entspricht
* `visitor_code` eine eindeutige Benutzerkennung ist, die im an Snowplow gesendeten JSON-Ereignis als `user_id` verwendet wird
* `timestamp` der Zeitstempel des Ereignisses ist
* `experiment_id` die eindeutige ID des Kameleoon-Experiments ist, dem der Benutzer ausgesetzt war
* `variation_id` die eindeutige ID der Variation ist, der der Benutzer im angegebenen Experiment ausgesetzt war

Kameleoon-Expositionsereignisse werden im Body des HTTP-Aufrufs als benutzerdefiniertes selbstbeschreibendes JSON gebundelt. Dieses Format enthalt eine Referenz auf das oben beschriebene Beschreibungsschema, das Kameleoon wahrend der Einrichtung an Ihr Snowplow Iglu Schema Registry gepusht hat.

Moglicherweise haben Sie fur Ihr Projekt einen Mapping Identifier eingerichtet, um z. B. die Visitor-ID, die Sie fur Ihre Standard-Snowplow-Ereignisse verwenden, mit Ihren Kameleoon-Visitor-Sessions zu verknupfen. Falls ja, wird dieser Mapping Identifier anstelle des Kameleoon-Visitor-Codes als Parameter `user_id` im selbstbeschreibenden Ereignis-JSON verwendet, das an Snowplow gesendet wird.

Weitere Informationen zum HTTP-Format zum Senden von Ereignissen an Snowplow finden Sie in der [Snowplow Tracker Protocol-Spezifikation](https://docs.snowplow.io/docs/collecting-data/collecting-from-own-applications/snowplow-tracker-protocol/).

## Snowplow mit einer Kameleoon-Kampagne verknupfen

### Im Grafik-/Code-Editor

1. Klicken Sie im Finalisierungspanel auf **Integrations**.
2. Wahlen Sie **Snowplow**.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/snowplow/Capture-decran-2023-11-20-a-15.55.59.png)
</Frame>

Snowplow wird vor der Inbetriebnahme im Zusammenfassungs-Pop-In erwahnt. Kameleoon ubertragt die Daten automatisch an Snowplow, und Sie konnen Ihre Ergebnisse direkt im Tool einsehen.

### Auf der Seite zur Erstellung einer Personalisierung

Sie konnen Snowplow als Reporting-Tool fur eine Personalisierung auf die gleiche Weise wie in einem A/B-Test auswahlen.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/snowplow/Capture-decran-2023-06-12-a-10.11.12.png)
</Frame>

### Auf der Ergebnisseite

Sobald Snowplow als Reporting-Tool fur ein Experiment festgelegt ist, konnen Sie es uber die Kameleoon-Ergebnisseite auswahlen (oder abwahlen). Gehen Sie dazu wie folgt vor:

1. Klicken Sie auf **Reporting Tools** > **Edit**.
2. Wahlen oder deselektieren Sie Snowplow.
3. Klicken Sie auf **Validate**.

### In einem Feature Flag

[Erfahren Sie, wie Sie Drittanbieter-Analytics-Integrationen verwalten](../../../experimentation/feature-experimentation/track-your-feature-experiments/managing-third-party-integrations)
