DocumentaciónAnalyticsGuía de servicios de medios de streaming

Nombre del reproductor del anuncio

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Nombre del reproductor del anuncio. Ver Nombre del reproductor del anuncio para la dimensión de informe correspondiente.

style
shade-box

La variable del nombre del reproductor del anuncio identifica qué reproductor procesó cada anuncio (por ejemplo, "Freewheel", "Google IMA"). El reproductor de anuncios puede diferir del reproductor de contenido principal cuando un servicio de inserción de anuncios del lado del servidor vincula los anuncios. Utilice esta variable para comparar la calidad y la finalización en las pilas de servidores de publicidad.

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

Tipos de implementación recomendados

SDK web

Establecer playerName dentro de xdm.mediaCollection.advertisingDetails al llamar a sendEvent:

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

Pase el nombre del reproductor de anuncios como clave MediaConstants.AdMetadataKeys.AD_PLAYER en el argumento HashMap de metadatos a trackEvent(AdStart).

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.AD_PLAYER] = "Freewheel"

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

Pase el nombre del reproductor de anuncios como clave MediaConstants.AdMetadataKeys.AD_PLAYER en el argumento HashMap de metadatos a trackEvent(AdStart).

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.AdMetadataKeys.AD_PLAYER] = "Freewheel"

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

Establecer playerName 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",
                "playerName": "Freewheel",
                "length": 15,
                "podPosition": 0
            },
            "playhead": 0
        }
    }
})
API de Media Edge

Llame al extremo adStart con playerName 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 nombre del reproductor de anuncios en el objeto contextData mediante ADB.Media.AdMetadataKeys.AdPlayer:

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.AdPlayer] = "Freewheel";

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

Pase el nombre del reproductor de publicidad en el objeto de metadatos de contexto al rastrear el evento de inicio de publicidad:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject("Ford F-150", "ad-2125", 1, 30);
var metadata = { "a.media.ad.playerName": "Chromecast Player" };
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, metadata);
API de recopilación de medios

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

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

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

recommendation-more-help
media-analytics-help