DocumentaciónAnalyticsGuía de servicios de medios de streaming

URL del anuncio

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable URL de Creative. Ver URL de Creative para la dimensión de informes correspondiente.

style
shade-box

La variable URL creativa es la dirección URL del creador de la publicidad. Utilice la variable para rastrear la ubicación de los recursos de cada creativo cuando la propia URL sea significativa para el análisis (por ejemplo, distinguir rutas de CDN o versiones creativas).

Propiedad
Valor
Variable de datos de contexto
a.media.ad.creativeURL
Campo de colección XDM
xdm.mediaCollection.advertisingDetails.creativeURL
rasgo de Audience Manager
c_contextdata.a.media.ad.creativeURL
Requerido
No
Enviado con
Inicio del anuncio, cierre del anuncio

Tipos de implementación recomendados

SDK web

Establecer creativeURL dentro de xdm.mediaCollection.advertisingDetails al llamar a 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

Pase la dirección URL de creatividad como clave de metadatos en el argumento HashMap a trackEvent(AdStart). Utilice 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

Pase la dirección URL de creatividad como clave de metadatos en el argumento HashMap a trackEvent(AdStart). Utilice 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

Establecer creativeURL dentro de xdm.mediaCollection.advertisingDetails al llamar a sendMediaEvent para 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 de Media Edge

Llame al extremo adStart con creativeURL dentro de 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
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase la dirección URL de creatividad en el objeto contextData mediante 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

Establezca la URL creativa con ADBMobile.media.AdMetadataKeys.CREATIVE_URL en el objeto de metadatos de publicidad estándar:

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 de recopilación de medios

Incluir media.ad.creativeURL en el objeto params:

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

Consulte la referencia de eventos de API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help