DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Begintijd

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

Deze pagina behandelt gegevensinzameling voor de Tijd​variabele te beginnen. Zie Time to start voor de overeenkomstige rapporteringsafmeting en metrisch.

style
shade-box

De beginvariabele is de tijd, in milliseconden, tussen de speler die het afspelen start en de eerste frame rendering. Stel deze in op het QoE-object voordat de gebeurtenis start van de sessie wordt gestart. Adobe slaat de waarde op en rapporteert deze in seconden; pass milliseconds en Adobe converteert bij ingest.

IMPORTANT
Wanneer de speler begint met het renderen van inhoudsframes, moet u het bijwerken van timeToStart stoppen. De waarde kan tijdens de eerste bufferfase of laadfase toenemen, maar moet worden beschouwd als een vaste waarde vanaf het moment dat het afspelen begint. Als u doorgaat met bijwerken nadat het eerste frame is gerenderd, levert dit een opgepompte of onjuiste Time to start metrische waarde op.
Eigenschap
Waarde
de gegevensvariabele van de context
a.media.qoe.timeToStart
XDM inzamelingsgebied
xdm.mediaCollection.qoeDataDetails.timeToStart
eigenschap van Audience Manager
c_contextdata.a.media.qoe.timeToStart
Vereist
Nee
Verzonden met
​ Begin van de Zitting ​, zittingsdichte

Aanbevolen implementatietypen

SDK van het Web

Stel timeToStart inside xdm.mediaCollection.qoeDataDetails on media.sessionStart in wanneer u sendEvent ​ aanroept:

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

Geef starttijd als tweede argument (startupTime) aan createQoEObject door.

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 30000,
                                               fps: 24,
                                     droppedFrames: 0)

tracker.updateQoEObject(qoe: qoeObject)
Android

Geef starttijd als tweede argument (startupTime) aan createQoEObject door.

code language-kotlin 
val qoeObject = Media.createQoEObject(3200L,
                                      30000.0,
                                      24.0,
                                      0L)

tracker.updateQoEObject(qoeObject)
Roku

Stel timeToStart inside xdm.mediaCollection.qoeDataDetails on media.sessionStart in bij het aanroepen van createMediaSession :

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "qoeDataDetails": {
                "timeToStart": 30000
            },
            "playhead": 0
        }
    }
})
Media Edge API

Roep het ​ sessionStart ​ eindpunt met timeToStart binnen xdm.mediaCollection.qoeDataDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "qoeDataDetails": {
          "timeToStart": 30000
        },
        "playhead": 0
      }
    }
  }]
}

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Geef tijd door om als tweede argument te beginnen: ADB.Media.createQoEObject

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(3200, 30000, 24, 0);
tracker.updateQoEObject(qoeObject);
Chromecast

Geef de opstarttijd in milliseconden door als het tweede argument (startupTime) aan ADBMobile.media.createQoSObject en werk de tracker bij:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,   // bitrate
  0,      // startupTime (ms)
  24,     // fps
  0       // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
de Inzameling API van Media

Neem media.qoe.timeToStart op in het params object on sessionStart :

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.qoe.timeToStart": 30000
  }
}

Zie de ​ Verwijzing van de Inzameling API van Media ​ voor de volledige verzoekstructuur.

recommendation-more-help
media-analytics-help