DocumentazioneAnalyticsGuida ai servizi Streaming Media

Nome del lettore dell’annuncio

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile Ad Player name. Vedi Nome del lettore dell’annuncio per la dimensione di reporting corrispondente.

style
shade-box

La variabile del nome del lettore dell’annuncio identifica quale lettore ha eseguito il rendering di ciascun annuncio (ad esempio, "Freewheel", "Google IMA"). Il lettore di annunci può differire dal lettore di contenuto principale quando gli annunci sono uniti da un servizio di inserimento di annunci lato server. Utilizza questa variabile per confrontare qualità e completamento tra gli stack di ad-serving.

Proprietà
Valore
Variabile di dati di contesto
a.media.ad.playerName
Campo raccolta XDM
xdm.mediaCollection.advertisingDetails.playerName
Caratteristica Audience Manager
c_contextdata.a.media.ad.playerName
Obbligatorio
Sì
Inviato con
Inizio annuncio, chiusura annuncio

Tipi di implementazione consigliati

Web SDK

Imposta playerName all’interno di xdm.mediaCollection.advertisingDetails quando chiama sendEvent:

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

Passa il nome del lettore dell’annuncio come chiave MediaConstants.AdMetadataKeys.AD_PLAYER nell’argomento HashMap dei metadati 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

Passa il nome del lettore dell’annuncio come chiave MediaConstants.AdMetadataKeys.AD_PLAYER nell’argomento HashMap dei metadati 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

Imposta playerName in xdm.mediaCollection.advertisingDetails quando chiama sendMediaEvent per 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 Media Edge

Chiama l’endpoint adStart con playerName in 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
      }
    }
  }]
}

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa il nome del lettore dell’annuncio nell’oggetto contextData utilizzando ADB.Media.AdMetadataKeys.AdPlayer:

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

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

Passa il nome del lettore dell’annuncio nell’oggetto metadati contestuali durante il tracciamento dell’evento di inizio annuncio:

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 Media Collection

Includi media.ad.playerName nell’oggetto params della richiesta POST adStart:

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

Per la struttura completa delle richieste, consulta il Riferimento eventi API di Media Collection.

recommendation-more-help
media-analytics-help