DocumentazioneAnalyticsGuida ai servizi Streaming Media

Migrazione da Milestone a Media Analytics migrating-from-milestone-to-media-analytics

Last update: Tue Jul 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

Panoramica overview

I concetti di base della misurazione video sono gli stessi per Milestone e Media Analytics, ovvero l’acquisizione degli eventi del lettore video e la relativa mappatura sui metodi di Analytics, nonché l’acquisizione dei metadati e dei valori del lettore e la relativa mappatura sulle variabili di Analytics. La soluzione Media Analytics è stata sviluppata da Milestone, quindi anche se molti dei metodi e delle metriche sono gli stessi, l’approccio di configurazione e il codice sono cambiati in modo significativo. Dovrebbe essere possibile aggiornare il codice evento del lettore per indicare i nuovi metodi di Media Analytics. Per maggiori informazioni sull’implementazione di Media Analytics, consulta Panoramica di SDK e Panoramica del tracciamento.

Le tabelle seguenti forniscono traduzioni tra la soluzione Milestone e Media Analytics.

Guida alla migrazione migration-guide

Riferimento variabile

Metrica Milestone
Tipo di variabile
Metrica di Media Analytics
Contenuto
Scadenza predefinita eVar
: visita
Contenuto
Tipo di contenuto
Scadenza predefinita eVar
: visualizzazione pagina
Tipo di contenuto
Tempo trascorso dei contenuti
Tipo di
evento: contatore
Tempo trascorso dei contenuti
Inizia video
Tipo di
evento: contatore
Inizia video
Completamento video
Tipo di
evento: contatore
Completamento contenuto

Variabili del modulo multimediale

Milestone
Sintassi di Milestone
Media Analytics
Sintassi di Media Analytics
Media.trackUsingContextData
s.Media.trackUsingContextData
= true;
N/D
Tutti i dati di Media Analytics vengono inviati solamente utilizzando i dati contestuali.
Media.contextDataMapping
s.Media.contextDataMapping = {
"a.media.name":"eVar2,prop2",
"a.media.segment":"eVar3",
"a.contentType":"eVar1",
"a.media.timePlayed":"event3",
"a.media.view":"event1",
"a.media.segmentView":"event2",
"a.media.complete":"event7",
"a.media.milestones": {
25:"event4",
50:"event5",
75:"event6"
}
};
N/D
I dati contestuali di Media Analytics vengono popolati automaticamente in variabili riservate. Mappatura per eVar, prop ed eventi non più necessari all’interno del codice di implementazione. I clienti possono mappare i dati contestuali per le variabili utilizzando le regole di elaborazione.
Media.trackVars
s.Media.trackVars =
"events,
prop2,
eVar1,
eVar2,
eVar3";
N/D
Non è più necessario in quanto la mappatura avviene tramite variabili riservate e regole di elaborazione.
media.trackEvents
s.Media.trackEvents =
"event1,
event2,
event3,
event4,
event5,
event6,
event7"
N/D
Non è più necessario in quanto la mappatura avviene tramite variabili riservate e regole di elaborazione.

Variabili facoltative

Milestone
Sintassi di Milestone
Media Analytics
Sintassi di Media Analytics
Media.autoTrack
s.Media.autoTrack
= true;
N/D
Le mappature del lettore predefinite non sono più fornite.
Media.autoTrackNetStreams
s.Media.
autoTrackNetStreams
= true
N/D
Le mappature del lettore predefinite non sono più fornite.
Media.completeByCloseOffset
s.Media.
completeByCloseOffset
= true
N/D
Il completamento del contenuto supporta solo un indicatore di avanzamento al 100%.
Media.completeCloseOffsetThreshold
s.Media.
completeCloseOffsetThreshold
= 1
N/D
Il completamento del contenuto supporta solo un indicatore di avanzamento al 100%.
Media.playerName
s.Media.playerName
= "Custom Player Name"
Chiave SDK: playerName;
Chiave API: media.playerName
MediaHeartbeatConfig.
playerName
Media.trackSeconds
s.Media.
trackSeconds
= 15
N/D
Media Analytics è impostato su 10 secondi per il contenuto e su 1 secondo per gli annunci. Non sono disponibili altre opzioni.
Media.trackMilestones
s.Media.
trackMilestones
= "25,50,75";
N/D
Media Analytics tiene sempre traccia degli indicatori di avanzamento al 10%, 25%, 50%, 75%, 95%.
Media.trackOffsetMilestones
s.Media.
trackOffsetMilestones
= "20,40,60";
N/D
Media Analytics tiene sempre traccia degli indicatori di avanzamento al 10%, 25%, 50%, 75%, 95%.
Media.segmentByMilestones
s.Media.segmentByMilestones
= true;
N/D
Il tracciamento automatico non è più disponibile.
Media.segmentByOffsetMilestones
s.Media.
segmentByOffsetMilestones
= true;
N/D
Il tracciamento automatico non è più disponibile.

Variabili di tracciamento degli annunci

Milestone
Sintassi di Milestone
Media Analytics
Sintassi di Media Analytics
Media.adTrackSeconds
s.Media.
adTrackSeconds
= 15
N/D
Media Analytics è impostato su 10 secondi per il contenuto e su 1 secondo per gli annunci. Non sono disponibili altre opzioni.
Media.adTrackMilestones
s.Media.
adTrackMilestones
= "25,50,75";
N/D
Per impostazione predefinita, gli indicatori di avanzamento non sono disponibili per gli annunci. Utilizza le metriche calcolate per creare gli indicatori di avanzamento degli annunci.
Media.adTrackOffsetMilestones
s.Media.
adTrackOffsetMilestones
= "20,40,60";
N/D
Media Analytics è impostato a 1 secondo per gli annunci. Non sono disponibili altre opzioni.
Media.adSegmentByMilestones
s.Media.
adSegmentByMilestones
= true;
N/D
Il tracciamento automatico non è più disponibile.
Media.adSegmentByOffsetMilestones
s.Media.
adSegmentByOffsetMilestones
= true;
N/D
Il tracciamento automatico non è più disponibile.

Metodi del modulo multimediale

Milestone
Sintassi di Milestone
Media Analytics
Sintassi di Media Analytics
Media.open
s.Media.open(
mediaName,
mediaLength,
mediaPlayerName)
trackSessionStart
trackSessionStart(
mediaObject,
contextData)
mediaName
mediaName: (obbligatorio) il nome del video come desideri che venga visualizzato nei rapporti video.
name
createMediaObject(
name,
mediaId,
length,
streamType)
mediaLength
mediaLength: (obbligatorio) la durata del video in secondi.
length
createMediaObject(
name,
mediaId,
length,
streamType)
mediaPlayerName
mediaPlayerName: (obbligatorio) il nome del lettore multimediale utilizzato per visualizzare il video, come desideri che venga visualizzato nei rapporti video.
playerName
MediaHeartbeatConfig.
playerName
Media.openAd
s.Media.openAd(
name,
length,
playerName,
parentName,
parentPod,
parentPodPosition,
CPM)
trackEvent
mediaHeartbeat.trackEvent(
MediaHeartbeat.
Event.
AdBreakStart,
adBreakObject);
...
trackEvent(
MediaHeartbeat.
Event.
AdStart,
adObject,
adCustomMetadata);
name
name: (obbligatorio) il nome o l’ID dell’annuncio.
name
createAdObject(
name,
adId,
position,
length)
length
length: (obbligatorio) la durata dell’annuncio.
length
createAdObject(
name,
adId,
position,
length)
playerName
playerName: (obbligatorio) il nome del lettore multimediale utilizzato per visualizzare l’annuncio.
playerName
MediaHeartbeatConfig.
playerName
parentName
parentName: il nome o l’ID del contenuto principale in cui l’annuncio è incorporato.
N/D
Ereditato automaticamente.
parentPod
parentPod: la posizione nel contenuto principale in cui è stato riprodotto l’annuncio.
position
createAdBreakObject(
name,
position,
startTime)
parentPodPosition
parentPodPosition: la posizione all’interno del pod in cui viene riprodotto l’annuncio.
position
createAdObject(
name,
adId,
position,
length)
CPM
CPM: il CPM o il CPM crittografato (con prefisso “~”) che si applica a questa riproduzione.
N/D
Non disponibile per impostazione predefinita in Media Analytics.
Media.click
s.Media.click(name, offset)
N/D
Utilizza una chiamata Analytics del collegamento personalizzato per tenere traccia dei clic.
Media.close
s.Media.close(mediaName)
trackSessionEnd
trackSessionEnd()
Media.complete
s.Media.complete(name, offset)
trackComplete
trackComplete()
Media.play
s.Media.play(
name,
offset,
segmentNum,
segment,
segmentLength)
trackPlay
trackPlay()
Media.stop
s.Media.stop(mediaName, mediaOffset)
trackPause
o
trackEvent
trackPause()
o trackEvent(
MediaHeartbeat.
Event.
SeekStart)
o
trackEvent(
MediaHeartbeat.
Event.
BufferStart);
Media.monitor
s.Media.monitor(s, media)
Utilizza metadati personalizzati o standard per impostare variabili aggiuntive.
var customVideoMetadata =
{
isUserLoggedIn:
"false",
tvStation:
"Sample TV station",
programmer:
"Sample programmer"
};
...
var standardVideoMetadata
= {};
standardVideoMetadata
[MediaHeartbeat.
VideoMetadataKeys.
EPISODE] =
"Sample Episode";
standardVideoMetadata
[MediaHeartbeat.
VideoMetadataKeys.
SHOW] = "Sample Show";
...
mediaObject.setValue(
MediaHeartbeat.
MediaObjectKey.
StandardVideoMetadata,
standardVideoMetadata);
Media.track
s.Media.track(mediaName)
N/D
La frequenza della chiamata del tracciamento viene impostata automaticamente.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb