DocumentationAnalyticsStreaming media services guide

Play

Last update: May 28, 2026

CREATED FOR:

  • Developer

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

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

Call trackPlay when the media player begins or resumes playback.

code language-swift 
tracker.trackPlay()
Android

Call trackPlay when the media player begins or resumes playback.

code language-kotlin 
tracker.trackPlay()
Roku

Call sendMediaEvent with eventType: "media.play":

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.play",
        "mediaCollection": {
            "playhead": 0
        }
    }
})
Media Edge API

Call the play endpoint:

code language-sh 
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"
    }
  }]
}'

Legacy implementation types (Analytics-only)

Media SDK JS 3.x

Call trackPlay when the media player begins or resumes playback:

code language-javascript 
tracker.trackPlay();
Chromecast

Call trackPlay when the media player begins or resumes playback:

code language-javascript 
ADBMobile.media.trackPlay();
Media Collection API

Send a play POST to the events endpoint:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "play"
}
recommendation-more-help
media-analytics-help