# Mapp

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

> Übergib das Experiment und die Variation, die ein Visitor gesehen hat, als Session-Parameter an Mapp Intelligence.



Mit einer Custom Integration schreibt ABlyft die Variation eines Experiments in einen Mapp-Intelligence-Session-Parameter.
In Mapp kannst du Visitors dann nach Variation auswerten.

## Was du brauchst

* Den Mapp Intelligence Smart Pixel (`wtSmart`) auf deiner Website.
* Einen Session-Parameter in Mapp mit einer Parameter-ID deiner Wahl und dem Datentyp **Text**. Lege ihn in Mapp unter
  **Configuration → Custom Parameters → Session Parameters** an. In dieser Seite ist die ID `51`. Ersetze sie durch deine.
* Ein ABlyft-Project mit aktivem Abo, denn Custom Integrations sind Teil davon.

## Integration in ABlyft erstellen

1. Öffne **Project → Integrations → Custom Integrations** und erstelle eine neue Integration, zum Beispiel `Mapp`.
2. Setze den Trigger auf **Experiment viewed** (Standard) oder **User bucketed**.
3. Füge den Code aus dem nächsten Abschnitt ein und speichere.

Mehr zu den Feldern und zur Ausführung: [Custom Integrations](https://docs.ablyft.com/de/developers/integrations/custom-integrations/).

## Integrationscode

Der Code nutzt die Konstanten `experimentName` und `variationName`. Sie sind auch als `experiment.data.name` und
`variation.data.name` verfügbar.

```js
if (typeof wtSmart === 'undefined') {
  throw new Error('Mapp Smart Pixel not loaded yet');
}

// 51 = your session parameter ID in Mapp
var parameter = {};
parameter[51] = experimentName + ': ' + variationName;
wtSmart.session.parameter.add(parameter);
```

`add` aktualisiert nur diese ID und behält andere Session-Parameter. Nutze nicht `set`, denn es überschreibt alle
vorhandenen Session-Parameter. Läuft der Code zweimal, wird derselbe Wert zweimal gesetzt.

Ist ein Visitor in mehreren Experiments, hält eine Parameter-ID nur einen Wert. Lege pro Experiment einen eigenen Parameter
an und nutze in jeder Integration eine andere ID, oder akzeptiere, dass der neueste Wert gilt.

## Wo du die Daten in Mapp siehst

Text-Session-Parameter erscheinen in Mapp Q3 unter **Visitors → Session Parameters**. Nutze den Parameter als Dimension,
um deine Kennzahlen nach dem Wert aufzuschlüsseln, zum Beispiel `Checkout: Variation 1`. Ein Session-Parameter gehört zum
gesamten Besuch, nicht zu einer einzelnen Seite. Du kannst ihn nicht an eine bestimmte Seite binden.

## Setup prüfen

1. Öffne ein Experiment in der Preview mit aktiviertem **Run in preview mode** an der Integration.
2. Führe in der Browser-Konsole `wtSmart.session.parameter.get()` aus. Das zurückgegebene Objekt enthält deine ID und den
   Wert.
3. Schau im Network-Tab auf den Tracking-Request an Mapp. Der Session-Parameter wird als `cs51` gesendet (mit deiner ID).

## Hinweise

> **Consent und Limits:** Custom Integrations laufen nicht, wenn ein Visitor Opt-out gewählt hat oder Do Not Track sendet. Mapp braucht eventuell
> eine eigene Consent-Kategorie. Lädt der Smart Pixel erst nach dem Consent, wartet die Integration höchstens etwa
> 2 Sekunden.

> **Vor der Nutzung prüfen:** ABlyft mit Mapp ist von uns nicht getestet. Mapp dokumentiert `wtSmart.session.parameter.add`, aber wir konnten nicht
> verifizieren, wann der Wert im Verhältnis zum Tracking-Request des Smart Pixel gesetzt sein muss. Prüfe im Network-Tab,
> dass `cs51` mit einem Tracking-Request gesendet wird, der nach dem Setzen des Werts erfolgt. Ältere Smart-Pixel-Versionen
> nutzen einen anderen Aufruf (`wts.push`), den wir nicht verifizieren konnten, deshalb zeigt diese Seite ihn nicht. Mapp
> wertet je nach Konfiguration deines Accounts den ersten oder den letzten Wert eines Parameters in einem Besuch aus. Frage
> deinen Mapp-Ansprechpartner, welche Variante aktiv ist.

[Mapp documentation](https://docs.mapp.com/docs/intelligence-smart-pixel-sessions)