ID contenuto

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

La variabile ID contenuto identifica in modo univoco ogni elemento del contenuto multimediale. È richiesto per tutte le implementazioni di Streaming Media ed è la chiave primaria per la dimensione di reporting dei contenuti. Impostalo all’inizio della sessione e mantienilo stabile in tutte le sessioni per la stessa risorsa.

Proprietà
Valore
Variabile di dati di contesto
a.media.name
Campo raccolta XDM
mediaCollection.sessionDetails.name
Caratteristica Audience Manager
c_contextdata.a.media.name
Obbligatorio
Inviato con
Inizio sessione, chiusura sessione

Web SDK

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

alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        friendlyName: "My Video",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      playhead: 0
    }
  }
});

Mobile SDK

Passa l’ID contenuto come argomento mediaId a createMediaObject.

iOS (Swift)

let mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)

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

Android (Cotlino)

var mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)

tracker.trackSessionStart(mediaInfo, null)

Roku (BrightScript)

Imposta name in mediaCollection.sessionDetails quando chiama createMediaSession:

m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "friendlyName": "My Video",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})

API di Media Edge

Chiama l’endpoint sessionStart con name (ID contenuto) in mediaCollection.sessionDetails:

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

Media SDK

Passa l’ID contenuto come secondo argomento a ADB.Media.createMediaObject:

var mediaInfo = ADB.Media.createMediaObject(
  "My Video",               // name (friendly name)
  "video-123",              // media ID — Content ID
  128,                      // length (seconds)
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);

tracker.trackSessionStart(mediaInfo, contextData);

API Media Collection

Includi media.id nell’oggetto params della richiesta POST sessionStart:

{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.id": "video-123"
  }
}

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

recommendation-more-help
media-analytics-help