DocumentationAnalyticsGuide des services des médias en streaming

Type de chargement des annonces

Dernière mise à jour : 4 juin 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Type de chargement des annonces. Voir Chargements d’annonces pour la dimension de reporting correspondante.

style
shade-box

La variable type de chargement de l’annonce publicitaire identifie le type d’annonce publicitaire chargé au début de la session. Cette valeur est définie par le système de diffusion de publicités interne de votre organisation et n’est pas limitée à une énumération standard. Vous pouvez utiliser n’importe quelle chaîne significative pour votre implémentation, telle que "linear", "dynamic" ou "programmatic".

Propriété
Valeur
Variable de données contextuelles
a.media.adLoad
champ de collection XDM
xdm.mediaCollection.sessionDetails.adLoad
Caractéristique
c_contextdata.a.media.adLoad
Obligatoire
Non
Envoyé avec
Début de session, fermeture de session

Types d’implémentation recommandés

SDK Web

adLoad à l’intérieur des xdm.mediaCollection.sessionDetails lors de l’appel de createMediaSession :

code language-javascript 
alloy("createMediaSession", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        friendlyName: "My Video",
        length: 300,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        adLoad: "linear"
      },
      playhead: 0
    }
  }
});
iOS

Transmettez le type de chargement de l’annonce publicitaire en tant que clé de métadonnées dans l’argument de dictionnaire à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-swift 
var videoMetadata: [String: String] = [:]
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

tracker.trackSessionStart(info: mediaObject, metadata: videoMetadata)
Android

Transmettez le type de chargement de l’annonce publicitaire en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-kotlin 
val videoMetadata = HashMap<String, String>()
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

tracker.trackSessionStart(mediaInfo, videoMetadata)
Roku

Utilisez createMediaSession pour définir des adLoad dans sessionDetails :

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "adLoad": "linear"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec adLoad à l’intérieur du xdm.mediaCollection.sessionDetails :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 300,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "adLoad": "linear"
        },
        "playhead": 0
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez le type de chargement d’annonce dans l’objet contextData à l’aide de ADB.Media.VideoMetadataKeys.AdLoad :

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.AdLoad] = "linear";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilisez ADBMobile.media.VideoMetadataKeys.AD_LOAD pour définir le type de chargement de l’annonce publicitaire dans la propriété StandardMediaMetadata de l’objet média avant d’appeler trackSessionStart :

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 300,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.AD_LOAD] = "linear";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Incluez media.adLoad dans l’objet params de votre sessionStart requête POST :

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.adLoad": "linear"
  }
}

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

recommendation-more-help
media-analytics-help