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.
...
Tracking über die REST API
Die Tracking API ist selbstdokumentierend über eine Swagger-UI aufrufbar:
http://INSIGHTS-PROXY-SERVER-URL/swagger-ui.html#/impression-controller
Im Folgenden werden die APIs nach ihrem chronologsichen Ablauf beschrieben:
- (optional) Erstellen einer neuen Client ID
- Abrufen einer Impression ID
- (optional) Setzen einer bereits vorhandenen Client ID
- Auslösen eines Tracking-Ereignisses
Erstellen einer eindeutigen Client ID für ein Endgerät / eine Benutzersitzung (optional)
Um Metriken gerätespezifisch oder sitzungsspezifisch aufzuzeichnen, kann über die API 'generateClientId' 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.
...
/generateClientId
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 'trackingcode' und die Client-Version als 'version' zu übergeben. Optional kann eine 'clientid' ü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)
Einer bereits registrierten Impression kann über die API 'clientid4impression' nachträglich eine bereits vorhandene Client-ID aufgeprägt werden (zB. wenn sich der Anwender erst nachträglich anmeldet).
...