Play

The play event signals that the media player changed state to playing. Send it on the initial start of content, on autoplay, and whenever the player resumes after a pause or buffer. There is no separate resume event; a play event after Pause start or Buffer start serves as the resume.

Web SDK

Call sendEvent with eventType: "media.play":

alloy("sendEvent", {
  xdm: {
    eventType: "media.play",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 0
    }
  }
});

Mobile SDK

Call trackPlay when the media player begins or resumes playback.

iOS (Swift)

tracker.trackPlay()

Android (Kotlin)

tracker.trackPlay()

Roku (BrightScript)

Call sendMediaEvent with eventType: "media.play":

m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.play",
        "mediaCollection": {
            "playhead": 0
        }
    }
})

Media Edge API

Call the play endpoint:

curl -X POST "https://edge.adobedc.net/ee/va/v1/play?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.play",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 0
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Media SDK

Call trackPlay when the media player begins or resumes playback:

tracker.trackPlay();

Media Collection API

Send a play POST to the events endpoint:

{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "play"
}