DocumentationAnalyticsGuide des services des médias en streaming

Identifiant de référencement

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable ID d’emplacement. Voir ID d’emplacement pour la dimension de rapport correspondante.

style
shade-box

La variable d’identifiant d’emplacement identifie l’emplacement publicitaire (généralement un emplacement ou une zone défini dans votre plateforme de serveur de publicités).

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

Types d’implémentation recommandés

SDK Web

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

Transmettez l’identifiant d’emplacement en tant que clé de métadonnées dans l’argument HashMap à trackEvent(AdStart). Utilisez MediaConstants.AdMetadataKeys.PLACEMENT_ID.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.PLACEMENT_ID] = "placement-12"

tracker.trackEvent(event: MediaEvent.AdStart, info: adObject, metadata: metadata)
Android

Transmettez l’identifiant d’emplacement en tant que clé de métadonnées dans l’argument HashMap à trackEvent(AdStart). Utilisez MediaConstants.AdMetadataKeys.PLACEMENT_ID.

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

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

placementID à 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",
                "placementID": "placement-12"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée adStart avec placementID à 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,
          "placementID": "placement-12"
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez l’identifiant d’emplacement dans l’objet contextData à l’aide de ADB.Media.AdMetadataKeys.PlacementId :

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.PlacementId] = "placement-12";

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

Définissez l’ID d’emplacement à l’aide de ADBMobile.media.AdMetadataKeys.PLACEMENT_ID dans l’objet de métadonnées publicitaire standard :

code language-javascript 
var adInfo = ADBMobile.media.createAdObject("Ford F-150", "ad-2125", 1, 30);
var standardAdMetadata = {};
standardAdMetadata[ADBMobile.media.AdMetadataKeys.PLACEMENT_ID] = "placement-12";
adInfo[ADBMobile.media.MediaObjectKey.StandardAdMetadata] = standardAdMetadata;
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
API Media Collection

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

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

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