Mithilfe von PS.Content #Insights können nicht nur Artikel-Nutzungsdaten, sondern auch beliebige weitere Metriken, wie zB. Aufrufe von Webseiten, Web-Services, App-Interaktionen etc erfasst werden.
...
Dazu wird der Stammdatendialog "#Insights: Externes Tracking" verwendet.
In diesem Dialog wird zunächst ein neuer Tracking-Client (in Beispiel WebAnzeigen und HUP NewsReader App) angelegt.
Pro Tracking-Client können dann beliebige Tracking-Events angelegt werden. (Im Beispiel APP-LAUNCH, EPAPER-DL, etc.)
Die ClientDer Applikations- und Event-ID der Eventcode wird für die Tracking-API verwendet, der "Anzeigename" für die Anzeige im #Insights Dashboard. Beides kann nachträglich geändert werden, bereits erfasste Daten werden automatisch überführt.
Sind ein Client Ist eine Applikation oder ein Event nicht aktiv können über die Tracking-API keine neuen Impressions erzeugt werden. Vorhandene Daten bleiben bestehen.
...
http://INSIGHTS-PROXY-SERVER-URL/swagger-ui.html#/ext-impression-controller
Im Folgenden werden die APIs nach ihrem chronologsichen Ablauf beschrieben:
- (optional) Erstellen einer neuen eindeutigen Client ID
- Abrufen einer Impression ID
- (optional) Setzen einer bereits vorhandenen eindeutigen Client ID
- Auslösen eines Tracking-Ereignisses
...
Um Metriken gerätespezifisch oder sitzungsspezifisch aufzuzeichnen, kann über die API 'generateClientIdgenerateUniqueClientId' eine Client-ID erstellt und in allen API-Aufrufen optional übermittelt werden. Die Client-ID sollte in einem Cookie oder dem App-Speicher abgelegt und später wieder verwendet werden.
Beispiel:
/generateClientIdgenerateUniqueClientId
Response: 45bc2918-7151-4cb9-8ae9-5b39913af5fb (HTTP Code 200)
Abrufen einer Impression ID für ein Tracking-Objekt
Über die API "impression" wird eine eindeutige Impression ID abgerufen. Als Parameter ist der Tracking-Client als 'trackingcodeapplicationCode' und die Client-Version als 'version' zu übergeben. Optional kann eine 'clientiduniqueClientId' übermittelt werden. Alle Parameter sind vom Typ 'string'.
...
/impression?trackingcode=NWSRDR&version=1.50
Response: 56d2882f-68aa-43f6-8748-6c9e7e583ef5 (HTTP Code 200)
Setzen einer vorhandenen Client ID für eine Impression (optional)
...
Beispiel:
/clientid4impression?clientiduniqueClientId=45bc2918-7151-4cb9-8ae9-5b39913af5fb&impressionid=56d2882f-68aa-43f6-8748-6c9e7e583ef5
Response:(HTTP Code 200)
...
Die API 'event' akzeptiert optional eine JSON Struktur, mit der weitere Daten je Event fest gehalten werden können (also zB. das Datum und die jeweilige Ausgabe eines ePapers).
Beispiel:
/event?eventcodeeventCode=APP-LAUNCH&impressionidimpressionId=56d2882f-68aa-43f6-8748-6c9e7e583ef5
Response:(HTTP Code 200)
...