Begin sessie

De gebeurtenis van het zittingsbegin opent een media volgende zitting. Het moet de eerste gebeurtenis zijn die voor om het even welk playback wordt verzonden. De reactie retourneert een sessie-id die alle volgende gebeurtenissen voor dezelfde sessie moeten bevatten.

Een zitting verloopt automatisch als geen gebeurtenissen voor 10 minuten worden ontvangen, of als er geen playhead beweging voor 30 minuten is. Als een sessie verloopt, moet u het begin van de sessie opnieuw aanroepen om een nieuwe sessie-id te verkrijgen.

Web SDK

Roep sendEvent ​ met eventType: "media.sessionStart" en de vereiste sessionDetails aan. Het antwoord bevat de sessie-id in handle[].payload[].sessionId (type media-analytics:new-session ). Sla deze waarde op en geef deze door als sessionID in alle volgende gebeurtenissen.

alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      playhead: 0
    }
  }
});

Mobile SDK

Roep trackSessionStart aan met een mediaobject en optionele metagegevens.

iOS (Zwift)

let mediaObject = Media.createMediaObjectWith(name: "video-123",
                                               id: "video-id-123",
                                           length: 128,
                                       streamType: MediaConstants.StreamType.VOD,
                                        mediaType: MediaType.Video)

tracker.trackSessionStart(info: mediaObject, metadata: nil)

Android (Kotlin)

val mediaObject = Media.createMediaObject("video-123",
                                          "video-id-123",
                                          128,
                                          MediaConstants.StreamType.VOD,
                                          Media.MediaType.Video)

tracker.trackSessionStart(mediaObject, null)

Roku (BrightScript)

Roep createMediaSession aan met de vereiste sessiedetails:

m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})

Media Edge API

Roep het ​ sessionStart ​ eindpunt. Het antwoord bevat de sessie-id in handle[].payload[].sessionId (type media-analytics:new-session ).

curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "playerName": "HTML5 Player",
          "contentType": "VOD",
          "length": 128,
          "channel": "Sports"
        },
        "playhead": 0
      }
    }
  }]
}'

Media SDK

Roep trackSessionStart aan met een mediaobject dat is gemaakt met ADB.Media.createMediaObject :

var mediaObject = ADB.Media.createMediaObject(
  "video-123",                  // name
  "video-id-123",               // media ID
  128,                          // length (seconds)
  ADB.Media.StreamType.VOD,     // stream type
  ADB.Media.MediaType.Video     // media type
);

tracker.trackSessionStart(mediaObject, null);

Media Collection-API

Verzend a sessionStart POST naar het ​ zittingseindpunt ​. De header van het antwoord Location bevat de sessie-id die moet worden gebruikt in alle volgende gebeurtenisaanvragen.

{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.channel": "Sports",
    "media.playerName": "HTML5 Player",
    "media.contentType": "vod",
    "media.length": 128,
    "media.id": "video-123"
  }
}