DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Anzeigenstart

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Das Anzeigenstartereignis signalisiert, dass die Wiedergabe einer einzelnen Anzeige begonnen hat. Sie muss innerhalb eines Anzeigenunterbrechungsstart/Anzeigenunterbrechung abgeschlossen-Paars erfolgen.

IMPORTANT
Dieses Ereignis muss von adBreakStart und adBreakComplete Buchstützen umgeben sein, selbst wenn eine einzige Anzeige abgespielt wird. Ohne diese Buchstützen werden Anzeigenereignisse ignoriert und die Anzeigendauer wird als Hauptinhaltsdauer gezählt.

Empfohlene Implementierungsarten

Web SDK

Rufen Sie sendEvent mit eventType: "media.adStart" und den erforderlichen advertisingDetails auf:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.adStart",
    mediaCollection: {
      advertisingDetails: {
        name: "ad-2125",
        friendlyName: "Ford F-150",
        length: 15,
        playerName: "Freewheel",
        podPosition: 0
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Übergeben Sie den Anzeigenamen, die ID, die Pod-Position und die Länge an createAdObject und rufen Sie dann trackEvent auf.

code language-swift 
let adObject = Media.createAdObjectWith(name: "Ford F-150",
                                          id: "ad-2125",
                                    position: 0,
                                      length: 15)

tracker.trackEvent(event: MediaEvent.AdStart, info: adObject, metadata: nil)
Android

Übergeben Sie den Anzeigenamen, die ID, die Pod-Position und die Länge an createAdObject und rufen Sie dann trackEvent auf.

code language-kotlin 
val adObject = Media.createAdObject("Ford F-150",
                                    "ad-2125",
                                    0,
                                    15)

tracker.trackEvent(Media.Event.AdStart, adObject, null)
Roku

Rufen Sie sendMediaEvent mit eventType: "media.adStart" und den erforderlichen advertisingDetails auf:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
            "advertisingDetails": {
                "name": "ad-2125",
                "friendlyName": "Ford F-150",
                "length": 15,
                "playerName": "Roku Player",
                "podPosition": 0
            },
            "playhead": 0
        }
    }
})
Media Edge-API

Rufen Sie den adStart-Endpunkt mit dem erforderlichen advertisingDetails auf:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/adStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.adStart",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 0,
        "advertisingDetails": {
          "name": "ad-2125",
          "length": 15,
          "playerName": "Freewheel",
          "podPosition": 0
        }
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie Anzeigenamen, ID, Position und Länge an ADB.Media.createAdObject:

code language-javascript 
var adInfo = ADB.Media.createAdObject(
  "Ford F-150",  // name (friendly name)
  "ad-2125",     // ad ID
  0,             // position in pod
  15             // length (seconds)
);

tracker.trackEvent(ADB.Media.Event.AdStart, adInfo, null);
Chromecast

Übergeben Sie Anzeigenamen, ID, Position und Länge an ADBMobile.media.createAdObject:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject(
  "Ford F-150",  // name (friendly name)
  "ad-2125",     // ad ID
  0,             // position in pod
  15             // length (seconds)
);

ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
Media Collection API

Senden eines adStart POST an den events-Endpunkt:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.id": "ad-2125",
    "media.ad.name": "Ford F-150",
    "media.ad.length": 15,
    "media.ad.podPosition": 0
  }
}
recommendation-more-help
media-analytics-help