DocumentazioneAnalyticsGuida ai servizi Streaming Media

ID risorsa

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile ID risorsa. Vedi ID risorsa per la dimensione di reporting corrispondente.

style
shade-box

La variabile ID risorsa è l’identificatore univoco della risorsa multimediale sottostante (ad esempio, un ID episodio, un ID filmato o un ID evento live). In genere proviene da autorità di metadati come EIDR, TMS/Gracenote o Rovi, ma sono accettati anche ID proprietari o interni. Utilizzalo quando devi confrontare il coinvolgimento tra piattaforme di distribuzione che possono assegnare ID di contenuto diversi alla stessa risorsa sottostante.

NOTE
Il campo della raccolta XDM utilizza ID in maiuscolo: assetID.
Proprietà
Valore
Variabile di dati di contesto
a.media.asset
Campo raccolta XDM
xdm.mediaCollection.sessionDetails.assetID
Caratteristica Audience Manager
c_contextdata.a.media.asset
Obbligatorio
No
Inviato con
Inizio sessione, chiusura sessione

Tipi di implementazione consigliati

Web SDK

Imposta assetID all’interno di xdm.mediaCollection.sessionDetails quando chiama sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        assetID: "89745363"
      },
      playhead: 0
    }
  }
});
iOS

Passa l’ID risorsa come chiave di metadati nell’argomento HashMap a trackSessionStart. Usa MediaConstants.VideoMetadataKeys.ASSET_ID.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.ASSET_ID] = "89745363"

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

Passa l’ID risorsa come chiave di metadati nell’argomento HashMap a trackSessionStart. Usa MediaConstants.VideoMetadataKeys.ASSET_ID.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.ASSET_ID] = "89745363"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Utilizza createMediaSession per impostare assetID in sessionDetails:

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

Chiama l’endpoint sessionStart con assetID in xdm.mediaCollection.sessionDetails:

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa l’ID risorsa nell’oggetto contextData utilizzando ADB.Media.VideoMetadataKeys.AssetId:

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilizzare ADBMobile.media.VideoMetadataKeys.ASSET_ID per impostare l’ID risorsa nella proprietà StandardMediaMetadata dell’oggetto multimediale prima di chiamare trackSessionStart:

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

Includi media.assetId nell’oggetto params:

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

Per la struttura completa delle richieste, consulta il Riferimento sessioni API di Media Collection.

recommendation-more-help
media-analytics-help