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.). So erhalten Sie umgehend Feedback dazu, ob in Ihrer Anfrage Probleme mit falschen Datentypen oder Informationen vorliegen. Verwenden Sie die JSON-Validierungsschemas , um zu überprüfen, ob Sie die richtigen Anfragedaten bereitstellen.
  1. Sammeln Sie standardmäßige, erforderliche Adobe Analytics- und Besucherdaten, die Sie für die Ausführung von Experience Cloud-Anwendungen bereitstellen müssen:
    • Experience Cloud-Organisations-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 im Location-Header. Die Sitzungs-ID stellt eine wichtige Information in der Antwort dar, 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.