---
# System prepended metadata

title: App-Tracking mit AT-Internet
tags: [HbbTV-App, App]

---

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

