DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Anzeigen-ID

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable Ad ID​behandelt. Siehe Anzeige für die entsprechende Reporting-Dimension.

style
shade-box

Die Variable ad ID identifiziert jede Anzeige eindeutig. Sie ist für jede Anzeige erforderlich, die Ihr Player verfolgt. Legen Sie sie bei jedem media.adStart fest.

Eigenschaft
Wert
Kontextdatenvariable
a.media.ad.name
XDM-Sammlungsfeld
xdm.mediaCollection.advertisingDetails.name
Audience Manager-Eigenschaft
c_contextdata.a.media.ad.name
Erforderlich
Ja
Gesendet mit
Anzeigenstart, Anzeigenschluss

Empfohlene Implementierungsarten

Web SDK

Legen Sie name in xdm.mediaCollection.advertisingDetails fest, wenn Sie sendEvent für media.adStart aufrufen:

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 die Anzeigen-ID als adId Argument an createAdObject. Das erste Argument (name) ist der Anzeigename, das zweite die ID.

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 die Anzeigen-ID als adId Argument an createAdObject. Das erste Argument (name) ist der Anzeigename, das zweite die ID.

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

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

Legen Sie name in xdm.mediaCollection.advertisingDetails fest, wenn Sie sendMediaEvent für media.adStart aufrufen:

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 Endpunkt adStart mit name in xdm.mediaCollection.advertisingDetails auf:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.adStart",
      "mediaCollection": {
        "advertisingDetails": {
          "name": "ad-2125",
          "length": 15,
          "playerName": "Freewheel",
          "podPosition": 0
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie die Anzeigen-ID als zweites Argument 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, contextData);
Chromecast

Übergeben Sie die Anzeigen-ID als zweites Argument an ADBMobile.media.createAdObject:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject(
  "Ford F-150",
  "ad-2125",
  1,
  30
);
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
Media Collection API

Fügen Sie media.ad.id in das params Ihrer adStart POST-Anfrage ein:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.id": "ad-2125"
  }
}

Die vollständige Anfragestruktur ​ Sie in der ​ zur Mediensammlungs-API-Ereignisreferenz .

recommendation-more-help
media-analytics-help