> For the complete documentation index, see [llms.txt](https://sdn.docs.3q.video/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sdn.docs.3q.video/interface/analytics/auswertungen-mit-benutzer-token.md).

# Auswertungen mit Benutzer-Token

Der Benutzer-Token ist eine eindeutige ID für einen Benutzer, die dem 3Q Player übergeben werden kann. Bei der Auswertung werden dann die Nutzungsdaten pro Benutzer-Token erfasst und als JSON-Datei ausgegeben. Somit lässt sich das Nutzungsverhalten eines per Token definierten Nutzers dokumentieren. Der Nutzer bleibt dabei innerhalb der 3Q-Plattform anonym.

Beispiel einer JSON-Datei:

<figure><img src="/files/Ue41giY2ReQUJTIFr4pw" alt="" width="563"><figcaption></figcaption></figure>

## **Zugelassene Werte für einen Benutzer Token**

Es werden nur Werte mit Buchstaben und Zahlen (Alphanumerisch) mit einer Länge von bis zu 255 Zeichen akzeptiert. Es gibt jedoch einige Ausnahmen, die vom Analytics ignoriert werden. Ausnahmen sind:

* 0
* False
* NULL

Es sollten nur sinnvolle und eindeutige Werte verwendet werden. Eine falsche Anwendung kann dazu führen, dass die Auswertung unbrauchbar wird.

{% hint style="warning" %}
Die Verwendung von de-anonymisierten Benutzerdaten wie z. B. Name oder E-Mail-Adresse ist ausdrücklich untersagt.
{% endhint %}

## Auswertung filtern und herunterladen

Sie erhalten die Auswertungen im Bereich "**Zuschauer**" unter "**Benutzer Token**". Wählen Sie hier über das Filtermenü das entsprechende **Projekt** und den **Auswertungszeitraum**. Zum Abschluss klicken Sie auf "**Filter anwenden**", um die Auswertung zu erstellen.

<figure><img src="/files/xUFidkscKGYZybEFVpsF" alt=""><figcaption></figcaption></figure>

Über den Button “Export JSON” wird der Download gestartet.

{% hint style="info" %}
Der Auswertungszeitraum sollte möglichst exakt gewählt werden.
{% endhint %}

## Beispiel-Code für die Player-Integration mit Benutzer Token in eine Webseite

Um die Auswertung zu einem Benutzer Token zu aktivieren, muss der 3Q Player mit dem Parameter userToken und einem gültigen Wert initialisiert werden.

Beispiel-Code einer Integration:

```
let  js3qVideoPlayer = new js3q({
    dataid: '3Q_DATA_ID',
    container: 'PLAYER_CONTAINER_ID',
    userToken: 'MY_CUSTOM_USER_TOKEN'
});
```

```
<script
   type="text/javascript"
   src="https://player.3qsdn.com/js3q.latest.js">
</script>
<div id="player1"></div>
<script type="text/javascript">
   var js3qVideoPlayer = new js3q({
      dataid: 'e5741433-a90c-11eb-b839-0cc47a188158',
      container: 'player1',
      'userToken' : 'SAHBS49U'
   });
</script>

```