DocumentationAnalyticsMedia Analytics Guide

Quick start quick-start

Last update: Fri Nov 11 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User
  • Admin
  • Developer
TIP
Gather the request data necessary for completing a successful Session request to the Media Analytics (MA) Collection API back-end server. You can quickly verify your request data by sending requests manually (with curl, or Postman, etc.). This will give you immediate feedback on whether you have any issues with incorrect data types or incorrect information in your request. Use the JSON validation schemas to verify that you are supplying proper request data.

  1. Gather the standard, required Adobe Analytics and Visitor data that you must supply to run any of the Experience Cloud applications:

    • Visitor Experience Cloud Org ID
    • Visitor Experience Cloud User ID
    • Analytics Report Suite ID
    • Analytics Tracking Server URL

  2. Create a JSON object for your sessions request body, containing the minimum data required for a successful call. For example:

    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
    You must use the correct data types in the JSON request body. E.g., analytics.enableSSL requires a boolean, media.length is numeric, etc. You can check parameter types and mandatory versus optional requirements by checking the JSON validation schemas.

  3. Send Sessions requests to the MA Collection API endpoint. If your request payload is invalid, identify the problem and retry until you get a 201 Created response. In this curl example, the JSON request body is in a file named 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

If the Sessions request succeeds, you receive a 201 Created response similar to the one above. The response includes a Session ID in the Location header. The Session ID is the crucial piece of information in the response, as it is required for all subsequent tracking calls. After a successful return of a Sessions request, you can confidently proceed with implementing video tracking using the MA API in your video player.

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