DocumentationAnalyticsGuide des services des médias en streaming

URL de l’élément créatif

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable URL Creative. Voir URL ​ pour la dimension de reporting correspondante.

style
shade-box

La variable URL de création est l’URL de la création publicitaire. Utilisez la variable pour effectuer le suivi de l’emplacement des ressources de chaque élément créatif lorsque l’URL elle-même a du sens pour l’analyse (par exemple, pour distinguer les chemins d’accès au réseau CDN ou les versions de contenu créatif).

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

Types d’implémentation recommandés

SDK Web

creativeURL à 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",
        creativeURL: "https://cdn.example.com/ads/creative-987.mp4"
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Transmettez l’URL de création en tant que clé de métadonnées dans l’argument HashMap à trackEvent(AdStart). Utilisez MediaConstants.AdMetadataKeys.CREATIVE_URL.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.CREATIVE_URL] = "https://cdn.example.com/ads/creative-987.mp4"

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

Transmettez l’URL de création en tant que clé de métadonnées dans l’argument HashMap à trackEvent(AdStart). Utilisez MediaConstants.AdMetadataKeys.CREATIVE_URL.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.AdMetadataKeys.CREATIVE_URL] = "https://cdn.example.com/ads/creative-987.mp4"

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

creativeURL à 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",
                "creativeURL": "https://cdn.example.com/ads/creative-987.mp4"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée adStart avec creativeURL à 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,
          "creativeURL": "https://cdn.example.com/ads/creative-987.mp4"
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez l’URL de création dans l’objet contextData à l’aide de ADB.Media.AdMetadataKeys.CreativeUrl :

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.CreativeUrl] = "https://cdn.example.com/ads/creative-987.mp4";

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

Définissez l’URL de création à l’aide de ADBMobile.media.AdMetadataKeys.CREATIVE_URL 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.CREATIVE_URL] = "https://cdn.example.com/ads/creative-987.mp4";
adInfo[ADBMobile.media.MediaObjectKey.StandardAdMetadata] = standardAdMetadata;
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
API Media Collection

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

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.creativeURL": "https://cdn.example.com/ads/creative-987.mp4"
  }
}

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