DocumentationAnalyticsGuide des services des médias en streaming

Démarrage de la publicité

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

L’événement de début de la publicité indique qu’une publicité individuelle a commencé à être lue. Cela doit se produire dans une paire Début de la coupure publicitaire / Fin de la coupure publicitaire.

IMPORTANT
Cet événement doit être entouré de adBreakStart et de adBreakComplete bookends, même lorsqu’une seule publicité est lue. Sans ces signets, les événements publicitaires sont ignorés et la durée de l’annonce publicitaire est comptabilisée comme la durée du contenu principal.

Types d’implémentation recommandés

SDK Web

Appelez sendEvent avec les eventType: "media.adStart" et les advertisingDetails requises :

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

Transmettez le nom, l’ID, la position du pod et la longueur de l’annonce à createAdObject, puis appelez trackEvent.

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 le nom, l’ID, la position du pod et la longueur de l’annonce à createAdObject, puis appelez trackEvent.

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

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

Appelez sendMediaEvent avec les eventType: "media.adStart" et les advertisingDetails requises :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
            "advertisingDetails": {
                "name": "ad-2125",
                "friendlyName": "Ford F-150",
                "length": 15,
                "playerName": "Roku Player",
                "podPosition": 0
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée adStart avec les advertisingDetails requises :

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/adStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.adStart",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 0,
        "advertisingDetails": {
          "name": "ad-2125",
          "length": 15,
          "playerName": "Freewheel",
          "podPosition": 0
        }
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

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

Media SDK JS 3.x

Transmettez le nom, l’ID, la position et la longueur de l’annonce publicitaire à ADB.Media.createAdObject :

code language-javascript 
var adInfo = ADB.Media.createAdObject(
  "Ford F-150",  // name (friendly name)
  "ad-2125",     // ad ID
  0,             // position in pod
  15             // length (seconds)
);

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

Transmettez le nom, l’ID, la position et la longueur de l’annonce publicitaire à ADBMobile.media.createAdObject :

code language-javascript 
var adInfo = ADBMobile.media.createAdObject(
  "Ford F-150",  // name (friendly name)
  "ad-2125",     // ad ID
  0,             // position in pod
  15             // length (seconds)
);

ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
API Media Collection

Envoyez une adStart POST au point d’entrée événements :

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.id": "ad-2125",
    "media.ad.name": "Ford F-150",
    "media.ad.length": 15,
    "media.ad.podPosition": 0
  }
}
recommendation-more-help
media-analytics-help