# etracker

URL: https://docs.ablyft.com/de/developers/integrations/etracker/

> Sende die Experiments und Variations, die ein Visitor gesehen hat, als benutzerdefiniertes Event an etracker und vergleiche sie mit Segmenten.



Mit einer Custom Integration sendet ABlyft ein benutzerdefiniertes Event an etracker, sobald ein Visitor ein Experiment
sieht. In etracker vergleichst du die Variations mit einem Segment pro Variation.

## Was du brauchst

* Der etracker-Tracking-Code ist auf deinen Seiten installiert.
* Events zählen auf dein etracker-Hit-Kontingent. Prüfe deinen Vertrag, wenn du viel Traffic erwartest.

## Die Integration in ABlyft anlegen

1. Öffne **Project → Integrations → Custom Integrations** und lege eine neue Integration an, zum Beispiel `etracker`.
2. Wähle den Trigger **Experiment viewed** (Standard) oder **User bucketed**.
3. Füge den Code unten ein und speichere. Das Snippet wird automatisch neu veröffentlicht.

Details zu Triggern, Timing und verfügbaren Daten: [Custom Integrations](https://docs.ablyft.com/de/developers/integrations/custom-integrations/).

## Integrationscode

```js
var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
_etrackerOnReady.push(function () {
  _etracker.sendEvent(new et_UserDefinedEvent(
    experimentName,
    'ABlyft',
    experimentId + ':' + variationId,
    variationName
  ));
});
```

Die vier Parameter von `et_UserDefinedEvent` sind Object, Category, Action und Type. Hier ist das Object der Name des
Experiments, die Category `ABlyft`, die Action `<experimentId>:<variationId>` und der Type der Name der Variation.

Die Konstanten `experimentId`, `experimentName`, `variationId` und `variationName` stellt ABlyft bereit. Du erreichst
sie auch als `experiment.data.id`, `experiment.data.name`, `variation.data.id` und `variation.data.name`.

> **Vor der Nutzung prüfen:** etracker erwartet URL-codierte Werte. Enthalten die Namen deiner Experiments oder Variations Sonderzeichen, packe sie
> in `encodeURIComponent()`. Ob das für deinen Account nötig ist und wie die codierten Namen in Reports erscheinen,
> steht nicht in der Dokumentation. Teste es zuerst.

## Wo du die Daten in etracker siehst

Die vier Werte werden zu den Dimensionen Object, Category, Action und Type des Events. So nutzt du sie:

1. Öffne in etracker **Web Analytics → Custom Reports** und lege einen Report für die Events an.
2. Lege pro Variation ein Segment an, zum Beispiel mit der Bedingung, dass die Action `<experimentId>:<variationId>`
   entspricht oder enthält.
3. Füge Metriken wie Visitors und Conversion Rate hinzu und wende die Segmente nebeneinander an.

etracker berechnet die statistische Signifikanz des Experiments nicht. Nutze dafür die **Results** in ABlyft.

## Das Setup prüfen

1. Öffne das Experiment mit **Run in preview mode** und aktiviere **Run in preview mode** in der Integration.
2. Suche in den Entwicklertools des Browsers bei den Requests an etracker das Event.
3. Prüfe in etracker, dass das Event mit der Category `ABlyft` ankommt.

> **Hinweise:** Custom Integrations laufen nicht, wenn ein Visitor widersprochen hat oder Do Not Track sendet. etracker braucht
> eventuell eine eigene Consent-Einstellung. Welche benutzerdefinierten Events in etracker eingerichtet sein müssen,
> bevor sie berichtet werden, hängt von deinem Account ab. Richte das Tracking daher zuerst in etracker ein. Die
> genauen Menünamen und Report-Pfade können sich je nach etracker-Version unterscheiden.

[etracker-Dokumentation](https://help.etracker.com/en/article/event-tracking/)