Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

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.

...

/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). 

...