Show Menu
TOPICS×

Schnellstart

Erfassen Sie die Anforderungsdaten, die zum Abschluss einer erfolgreichen Sitzungsanforderung beim Backend-Server der Media Analytics (MA) Collection API erforderlich sind. Sie können Ihre Anfragedaten schnell überprüfen, indem Sie Anfragen manuell senden (mit
curl
, Postman usw.). Auf diese Weise erhalten Sie sofort Rückmeldungen darüber, ob Ihre Anfrage Probleme mit falschen Datentypen oder falschen Informationen enthält. Überprüfen Sie mithilfe der JSON-Validierungs-Schemata , ob Sie die richtigen Anfragedaten bereitstellen.
  1. Erfassen Sie die standardmäßig erforderlichen Adobe Analytics- und Besucherdaten, die Sie zur Ausführung einer Experience Cloud-Anwendung bereitstellen müssen:
    • Experience Cloud-Org-ID des Besuchers
    • Experience Cloud-Benutzer-ID des Besuchers
    • Analytics-Report Suite-ID
    • Analytics-Tracking-Server-URL
  2. Erstellen Sie ein JSON-Objekt für Ihren
    sessions
    -Anfrageinhalt, das die erforderlichen Daten für einen erfolgreichen Aufruf enthält. Beispiel:
    { "playerTime": { "playhead": 0, "ts": 1234560890123 }, "eventType": "sessionStart", "params": { "media.playerName": "sample-html5-api-player", "analytics.trackingServer": "[YOUR_TS]", "analytics.reportSuite": "[YOUR_RSID]", "media.contentType": "VOD", "media.length": 60.39333333333333, "media.id": "MA Collection API Sample Player", "visitor.marketingCloudOrgId": "[YOUR_ORG_ID]", "visitor.marketingCloudUserId": "[YOUR_ECID]", "media.name": "ClickMe", "media.channel": "sample-channel", "media.sdkVersion": "va-api-0.0.0", "analytics.enableSSL": false } }
    Sie müssen die richtigen Datentypen im JSON-Anforderungstext verwenden. So erfordert
    analytics.enableSSL
    beispielsweise einen booleschen Wert,
    media.length
    einen numerischen usw. Sie können die Parametertypen sowie ihre Erforderlichkeit anhand der JSON-Validierungsschemas überprüfen.
  3. Senden Sie Sitzungsanforderungen an den MA Collection API-Endpunkt. Wenn die Anfrage-Payload ungültig ist, ermitteln Sie das Problem und versuchen es erneut, bis Sie eine
    201 Created
    -Antwort erhalten. In diesem
    curl
    -Beispiel befindet sich der JSON-Anforderungstext in einer Datei namens
    sample_data_session
    :
    $ curl -i -d \ @sample_data_session https://{uri}/api/v1/sessions \ > curl.sessions.out $ cat curl.sessions.out HTTP/1.1 201 Created Server: nginx/1.13.5 Date: Mon, 18 Dec 2017 22:34:12 GMT Content-Type: application/octet-stream Content-Length: 0 Connection: keep-alive Location: /api/v1/sessions/a39c037641f[...] # <== Session ID Access-Control-Allow-Origin: * Access-Control-Allow-Methods: OPTIONS,POST,PUT Access-Control-Allow-Headers: Content-Type Access-Control-Expose-Headers: Location
Wenn die Sitzungsanfrage erfolgreich ist, erhalten Sie eine
201 Created
-Antwort ähnlich der oben aufgeführten. Die Antwort enthält eine Sitzungs-ID in der Kopfzeile „Position“. Die Sitzungs-ID ist eine entscheidende Information in der Antwort, da sie für alle nachfolgenden Tracking-Aufrufe erforderlich ist. Nach der erfolgreichen Rückgabe einer Sitzungsanforderung können Sie mit der Implementierung des Video-Trackings mithilfe der MA-API in Ihrem Videoplayer fortfahren.