DocumentationAnalyticsGuide des services des médias en streaming

Nom du lecteur publicitaire

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page couvre la collecte de données pour la variable Nom du lecteur d’annonces. Voir Nom du lecteur d’annonces pour la dimension de compte rendu des performances correspondante.

style
shade-box

La variable de nom du lecteur d’annonces identifie le lecteur qui a rendu chaque annonce publicitaire (par exemple, "Freewheel", "Google IMA"). Le lecteur d’annonces publicitaires peut différer du lecteur de contenu principal lorsque des annonces sont regroupées par un service d’insertion d’annonces côté serveur. Utilisez cette variable pour comparer la qualité et l’achèvement des piles de diffusion d’annonces.

Propriété
Valeur
Variable de données contextuelles
a.media.ad.playerName
champ de collection XDM
xdm.mediaCollection.advertisingDetails.playerName
Caractéristique
c_contextdata.a.media.ad.playerName
Obligatoire
Oui
Envoyé avec
Début de la publicité, fin de la publicité

Types d’implémentation recommandés

SDK Web

playerName à l’intérieur des xdm.mediaCollection.advertisingDetails lors de l’appel de sendEvent :

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

Transmettez le nom du lecteur d’annonces comme clé MediaConstants.AdMetadataKeys.AD_PLAYER dans l’argument HashMap des métadonnées à 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

Transmettez le nom du lecteur d’annonces comme clé MediaConstants.AdMetadataKeys.AD_PLAYER dans l’argument HashMap des métadonnées à trackEvent(AdStart).

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

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

playerName à l’intérieur des xdm.mediaCollection.advertisingDetails lors de l’appel de sendMediaEvent pour 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

Appelez le point d’entrée adStart avec playerName à l’intérieur du 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
      }
    }
  }]
}

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Transmettez le nom du lecteur d’annonces publicitaires dans l’objet contextData à l’aide de ADB.Media.AdMetadataKeys.AdPlayer :

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

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

Transmettez le nom du lecteur de publicités dans l’objet de métadonnées contextuelles lors du suivi de l’événement de début de la publicité :

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

Incluez media.ad.playerName dans l’objet params de votre adStart requête POST :

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

Consultez la référence des événements de l’API Media Collection pour obtenir la structure complète des requêtes.

recommendation-more-help
media-analytics-help