Schnellstart quick-start

TIP
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:

    code language-json
    {
        "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
        }
    }
    
    note note
    NOTE
    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:

    code language-sh
    $ 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.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb