# 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**

Grundsätzlich werden beliebige Zeichenketten mit einer Länge von bis zu 254 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>

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sdn.docs.3q.video/interface/analytics/auswertungen-mit-benutzer-token.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.