DocumentationAnalyticsGuide des services des médias en streaming

Position de l’annonce publicitaire dans la capsule

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Position de l’annonce dans la capsule. Voir Annonce publicitaire dans la position de la capsule pour la dimension de rapport correspondante.

style
shade-box

La variable de position de l’annonce publicitaire dans la capsule correspond à la position indexée sur zéro de l’annonce publicitaire dans sa coupure publicitaire parente. La première publicité d’une capsule a un index 0, la seconde a un index 1, etc. Utilisez la dimension pour comparer l’engagement et l’achèvement par position au sein d’une coupure publicitaire.

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

Types d’implémentation recommandés

SDK Web

podPosition à 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",
        podPosition: 0
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Transmettez la position comme troisième argument à createAdObject.

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

Transmettez la position comme troisième argument à createAdObject.

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

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

podPosition à 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",
                "podPosition": 0,
                "length": 15,
                "playerName": "Roku Player"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée adStart avec podPosition à 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 la position comme troisième argument à ADB.Media.createAdObject :

code language-javascript 
var adInfo = ADB.Media.createAdObject(
  "Ford F-150",
  "ad-2125",
  0,
  15
);

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

Transmettez la position comme troisième argument à 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 Media Collection

Incluez media.ad.podPosition dans l’objet params :

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

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