###### tags: `HbbTV-App` `App`

# App-Tracking mit AT-Internet

Als WDR wollen wir die Nutzung von Apps mit AT Internet (WDR Währung) messen, um den Erfolg der App zu messen und eine Entscheidungsgrundlage für weitere Content-Typ Produktionen zu haben.

In welchem Umfang ein Event-Tracking zu implementieren ist wird durch die Anforderungen der Medienforschung und zuständigen Redaktion festgelegt.

### AT-Internet SDK

SDKs werden vom WDR in der neusten Version bereitgestellt.
Das SDK verwaltet das Session-Management und stellt Methoden zum Senden von Tags zur Verfügung.

### Opt-Out

Die Nutzerin muss die Möglichkeit haben, das Tracking in der App zu deaktivieren.
Mit dem deaktivieren des Trackings ist das Senden von Tags zu unterbinden.

### Konfiguration
Die Level1-ID gibt an, in welchen Datentopf die Tracking-Daten fließen.

| Level1-ID | Name - Einsatzgebiet |
| -------- | ------------ |
| 621457 | WDR - Live / Production |
| 621455 | Dev Umgebung - Test / Staging|

weitere Konfigurations-Parameter: [Android](https://developers.atinternet-solutions.com/android-en/getting-started-android-en/configuration-android-en/), [iOS](https://developers.atinternet-solutions.com/apple-universal-en/getting-started-apple-universal-en/configuration-apple-universal-en/)

| Konfigurations-Parameter | Value |
|---|---|
|log|logX|
|logSSL|logsX|
|domain|xiti.com|
|pixelPath|/hit.xiti|
|site|Level1-ID|
|secure|true|
|identifier|uuid|
|plugins||
|enableBackgroundTask|true|
|storage|required|
|hashUserId|false|
|persistIdentifiedVisitor|true|
|campaignLastPersistence|false|
|sessionBackgroundDuration|60|

## Events und Properties

### page.display Events
Jeder Screen-Aufruf eines Nutzers löst ein page.display-Event aus.
Dabei sind Produkt-, Page- und falls vorhanden Content-Properties zu senden.

Zum senden des Events wird die sogenannte [_Custom-Event-Tagging_](https://developers.atinternet-solutions.com/events-en/custom-event-tagging-sdk-en/)-Methode des SDK genutzt.

#### CG-Properties (Bereits mit Webtrekk erfasste Produkte)
Falls das Produkt bereits mit Webtrekk gemessen wird, so sind die CG-Parameter 1zu1 zu übernehmen.

|Property|Details|
|---|---|
|s:cg1 | siehe Webtrekk-Messung |
|s:cg2|siehe Webtrekk-Messung |
|...|...|
|s:cg9|siehe Webtrekk-Messung |

#### Product-Properties
Dieses Property-Set definiert das Produkt und die Einordnung in die WDR Produktwelt.

| Property | Wert |
|---| ---|
|s:level2 |Stolpersteine NRW App|
|s:brand|Stolpersteine NRW|
|s:editorial_department|PB Internet|
|s:plattform|App|
|s:app_version | |
|s:app_build_number| falls vorhanden|

#### Page-Properties*
Diese Property-Set beschreibt den Screen.
Die Definition der entsprechende Werte erfolgt in Zusammenarbeit mit der Medienforschung.

|Property|Details|
|---|---|
|s:title|Content-Titel / Label des Screens |
|s:page_chapter1|hierarchische App-Struktur |
|s:page_chapter2|hierarchische App-Struktur / s:title |
|s:page_chapter3|hierarchische App-Struktur / s:title |
|s:page_chapter4|hierarchische App-Struktur / s:title |
|s:page_chapter5|hierarchische App-Struktur / s:title |
|s:page|`${chapter1}_${chapter2}_...`, wobei die Werte der Chapter nur dann angehangen werden, wenn diese auch einen Wert haben.|

\*Sollte die App bereits mit Webtrekk getrackt werden, so entspricht die App-Hierarchie zu großen Teilen den sich ändernden Werten der CG-Struktur. Details sind via Medienforschung in Erfahrung zu bringen.

#### Content-Properties*
Diese Property-Set beschreibt den Content der Seite.
Dieser wird in der Regel via _API-Call_ bereitgestellt.

|Property|Details|
|---|---|
|s:page_url| api-call, falls vorhanden|
|s:content_id| |
|s:content_type||
|s:content_creator||
|d:publication_time||
|d:last_editorial_update||
|n:days_since_publication|Date.Now - Date.publication_time|
|s:content_categories|Liste aller Content-Kategorien, falls vorhanden (Trennungszeichen: ",")|
|s:content_tags|Liste aller Content-Tags, falls vorhandenden (Trennungszeichen: ",")|

\*_die finalen Properites sind mit der Medienforschung abzusprechen_

### AV-Insights
Mit AV-Insights werden Player-Aktionen erfasst.

Neben den spezifischen AV-Properties werden auch die die CG-, Product-, Page- und Content-Properites mitgegeben, den ein Player wird immer von einem bestimmten Screen aus gestartet.

#### AV-Insights-Events

|Event|Details|
|---|---|
|av.play| Klick auf Play-Button
|av.start| Tatsächlicher Start des Videos (nach Klick auf Play und möglichem Buffering)|
|av.pause| Pausieren des Videos|
|av..resume| Fortsetzen des Videos (nach Pausieren) |
|av.stop| Ende des Videos (nur falls Event erkennbar) |
|av.speed| \*Falls die Wiedergabe Geschwindigkeit angepasst werden kann |

#### AV-Properties*
Die AV-Properties beschreiben den AV-Content.
Die Werte werden in der Regel via _API-Call_ bereitgestellt.

|Property|Details|
|---|---|
|s:av_series | |
|s:av_episode| |
|s:av_content_type| Audio / Video|
|s:av_content_id| |
|b:av_web_only| |
|n:av_content_duration| |
|s:av_broadcasting_type| |

\*_die finalen Properites werden noch mitgeteilt_

### Weitere Events
Alle weiteren Events finden immer auf einem App-Screen statt. Daher sind für sämliche weiteren Events Product-, Page-, Content- und falls vorhanden CG-Properties mitzusenden.
Zusätzlich werden Event-Spezifische Properties mitgesendet.

- Interne Suche
- Teaser-Auswertung
- Scrolltiefen-Analyse