DocumentationAnalyticsGuide des services des médias en streaming

Heure de début de la coupure publicitaire

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page couvre la collecte de données pour la variable Heure de début de la coupure publicitaire. Voir Position de la capsule pour la dimension de rapport correspondante.

style
shade-box

La variable de temps de début de coupure publicitaire correspond au décalage de la coupure publicitaire à l’intérieur du contenu, mesuré en secondes. Pour un pre-roll, la valeur est 0 ; pour un mid-roll, la valeur est la position de la tête de lecture à laquelle la coupure commence.

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

Types d’implémentation recommandés

SDK Web

offset à l’intérieur des xdm.mediaCollection.advertisingPodDetails lors de l’appel de sendEvent :

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.adBreakStart",
    mediaCollection: {
      advertisingPodDetails: {
        friendlyName: "mid-roll-1",
        index: 2,
        offset: 90
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Transmettez l’heure de début en secondes comme troisième argument à createAdBreakObject.

code language-swift 
let adBreakObject = Media.createAdBreakObjectWith(name: "mid-roll-1",
                                              position: 2,
                                             startTime: 90)

tracker.trackEvent(event: MediaEvent.AdBreakStart, info: adBreakObject, metadata: nil)
Android

Transmettez l’heure de début en secondes comme troisième argument à createAdBreakObject.

code language-kotlin 
val adBreakObject = Media.createAdBreakObject("mid-roll-1",
                                              2L,
                                              90.0)

tracker.trackEvent(Media.Event.AdBreakStart, adBreakObject, null)
Roku

offset à l’intérieur des xdm.mediaCollection.advertisingPodDetails lors de l’appel de sendMediaEvent pour media.adBreakStart :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adBreakStart",
        "mediaCollection": {
            "advertisingPodDetails": {
                "friendlyName": "mid-roll-1",
                "index": 2,
                "offset": 90
            },
            "playhead": 90
        }
    }
})
API Media Edge

Appelez le point d’entrée adBreakStart avec offset à l’intérieur du xdm.mediaCollection.advertisingPodDetails :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.adBreakStart",
      "mediaCollection": {
        "advertisingPodDetails": {
          "index": 2,
          "offset": 90
        },
        "sessionID": "{sid}",
        "playhead": 90
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez l’heure de début comme troisième argument à ADB.Media.createAdBreakObject :

code language-javascript 
var adBreakInfo = ADB.Media.createAdBreakObject(
  "mid-roll-1",
  2,
  90
);

tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakInfo, null);
Chromecast

Transmettez l’heure de début en secondes comme troisième argument à ADBMobile.media.createAdBreakObject :

code language-javascript 
var adBreakInfo = ADBMobile.media.createAdBreakObject(
  "mid-roll-1",
  2,
  90
);
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakStart, adBreakInfo);
API Media Collection

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

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "adBreakStart",
  "params": {
    "media.ad.podSecond": 90
  }
}

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