DocumentaciónAnalyticsGuía de servicios de medios de streaming

ID de anuncio

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable ID de anuncio. Ver Ad para la dimensión de informe correspondiente.

style
shade-box

La variable de ID de anuncio identifica de forma exclusiva cada anuncio. Es necesario para cada anuncio que rastrea el reproductor. Configúrelo en cada evento media.adStart.

Propiedad
Valor
Variable de datos de contexto
a.media.ad.name
Campo de colección XDM
xdm.mediaCollection.advertisingDetails.name
rasgo de Audience Manager
c_contextdata.a.media.ad.name
Requerido
Sí
Enviado con
Inicio del anuncio, cierre del anuncio

Tipos de implementación recomendados

SDK web

Establecer name dentro de xdm.mediaCollection.advertisingDetails al llamar a sendEvent para media.adStart:

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

Pase el id. de anuncio como el argumento adId a createAdObject. El primer argumento (name) es el nombre descriptivo; el segundo es el identificador.

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

Pase el id. de anuncio como el argumento adId a createAdObject. El primer argumento (name) es el nombre descriptivo; el segundo es el identificador.

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

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

Establecer name dentro de xdm.mediaCollection.advertisingDetails al llamar a sendMediaEvent para media.adStart:

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
        }
    }
})
API de Media Edge

Llame al extremo adStart con name dentro de xdm.mediaCollection.advertisingDetails:

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase el id. de anuncio como segundo argumento a 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

Pase el id. de anuncio como segundo argumento a 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);
API de recopilación de medios

Incluir media.ad.id en el objeto params de su solicitud POST de adStart:

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

Consulte la referencia de eventos de API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help