Parametri per i capitoli

Ultimo aggiornamento: 15 luglio 2025
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

Questo argomento descrive un elenco di dati di capitoli e/o segmenti, inclusi i valori dei dati di contesto, che Adobe raccoglie tramite le variabili di soluzione.

Descrizione dei dati della tabella:

  • Implementazione: informazioni sui valori e i requisiti di implementazione

    • Chiave: variabile, impostata manualmente nell’app o automaticamente dall’SDK di Adobe Media.
    • Obbligatorio: indica se il parametro è necessario per il tracciamento video di base.
    • Tipo: specifica il tipo di variabile da impostare, stringa o numero.
    • Inviato con: indica quando i dati vengono inviati. Avvia file multimediale è la chiamata di Analytics inviata all’avvio del file multimediale. Avvia annuncio è la chiamata di Analytics inviata all’avvio dell’annuncio e così via. Le chiamate di Chiusura sono le chiamate compilate di Analytics inviate direttamente dal server heartbeat a quello di Analytics al termine della sessione multimediale, oppure dell’annuncio, del capitolo, ecc. Le chiamate di chiusura non sono disponibili nelle chiamate dei pacchetti di rete.
    • Versione SDK min.: indica la versione SDK necessaria per accedere al parametro.
    • Valore di esempio: fornisce un esempio di utilizzo comune delle variabili.

  • Parametri di rete: mostra i valori trasferiti ai server di Adobe Analytics o Heartbeat. Questa colonna mostra i nomi dei parametri visualizzati nelle chiamate di rete generate dagli SDK di Adobe Media.

  • Reporting: informazioni su come visualizzare e analizzare i dati video.

    • Disponibile: indica se i dati sono disponibili nel reporting per impostazione predefinita (Sì) o richiede la configurazione personalizzata (Personalizzato)
    • Variabile riservata: indica se i dati vengono acquisiti come evento, eVar, prop o classificazione in una variabile riservata.
    • Nome del rapporto: nome del report Adobe Analytics per la variabile
    • Dati contestuali: nome dei dati contestuali di Adobe Analytics trasferiti al server di reporting e utilizzati nelle regole di elaborazione.
    • Feed di dati: nome della colonna per la variabile trovata nei feed di dati Clickstream o Live Stream
    • Audience Manager: nome degli elementi presenti in Adobe Audience Manager
IMPORTANTE
Non modificare i nomi delle classificazioni per le variabili elencate di seguito e descritte nella variabile Reporting/Reserved (Reporting/Riservato) come “classificazione”.
Le classificazioni per i file multimediali vengono definite quando una suite di rapporti è abilitata per il tracciamento dei contenuti multimediali. Periodicamente Adobe aggiunge nuove proprietà e in questo caso i clienti devono riabilitare le suite di rapporti per accedere alle nuove proprietà multimediali. Durante il processo di aggiornamento, l’Adobe determina se le classificazioni sono abilitate controllando i nomi delle variabili. Se manca qualcuno di questi, Adobe aggiunge di nuovo quelli mancanti.

Metadati capitolo

Nome del capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    nome
  • Chiave API:
    media.chapter.friendlyName
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
    “Il Big Bang Capitolo 2 - Incontri”
  • Descrizione:
    nome del capitolo e/o del segmento.
  • Adobe Analytics:
    (a.media.chapter.
    friendlyName)
  • Heartbeat:
    (s:stream:chapter_name)
  • Disponibile:
    creato per impostazione predefinita…
  • Variabile riservata:
    classificazione
  • Nome rapporto:
    nome del capitolo
  • Dati contestuali:
    (a.media.chapter.
    friendlyName)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    friendlyName)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetReference._dc.title
  • Percorso campo XDM per raccolta:
    mediaCollection.chapterDetails.friendlyName
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.friendlyName

Posizione del capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    position
  • Chiave API:
    media.chapter.index
  • Obbligatorio:
    SDK: no. API: sì.
  • Tipo:
    numero
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
    2
  • Descrizione:
    Posizione (indice, numero intero) del capitolo all’interno del contenuto.
  • Adobe Analytics:
    (a.media.chapter.
    position)
  • Heartbeat:
    (l:stream:chapter_pos)
  • Disponibile:
    Sì
  • Variabile riservata:
    Classificazione
  • Nome rapporto:
    Posizione capitolo
  • Dati contestuali:
    (a.media.chapter.
    position)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    position)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.index
  • Percorso campo XDM per raccolta:
    mediaCollection.chapterDetails.index
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.index

Offset del capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    startTime
  • Chiave API:
    media.chapter.offset
  • Obbligatorio:
    SDK: no. API: sì.
  • Tipo:
    numero
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio
    58
  • Descrizione:
    Offset del capitolo all’interno del contenuto, in secondi dall’inizio.
  • Adobe Analytics:
    (a.media.chapter.
    offset)
  • Heartbeat:
    (l:stream:chapter_offset)
  • Disponibile:
    Sì
  • Variabile riservata:
    Classificazione
  • Nome rapporto:
    Offset capitolo
  • Dati contestuali:
    (a.media.chapter.
    offset)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    offset)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.offset
  • Percorso campo XDM per raccolta:
    mediaCollection.chapterDetails.offset
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.offset

Durata capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
  • Chiave API:
    media.chapter.length
  • Obbligatorio:
    SDK: no. API: sì.
  • Tipo:
    numero
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
    486
  • Descrizione:
    Durata del capitolo in secondi.
  • Adobe Analytics:
    (a.media.chapter.
    length)
  • Heartbeat:
    (l:stream:chapter_length)
  • Disponibile:
    Sì
  • Variabile riservata:
    Classificazione
  • Nome rapporto:
    Durata capitolo
  • Dati contestuali:
    (a.media.chapter.
    length)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    length)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetReference._xmpDM.duration
  • Percorso campo XDM per raccolta:
    mediaCollection.chapterDetails.length
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.length

Capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
  • Descrizione:
    ID del capitolo generato automaticamente.
  • Adobe Analytics:
    (a.media.chapter.
    name)
  • Heartbeat:
    (s:stream:chapter_id)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    Capitolo
  • Dati contestuali:
    (a.media.chapter.
    name)
  • Feed dati:
    videochapter
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    name)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetReference._id
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.ID

Metriche dei capitoli

Inizio capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
    TRUE
  • Descrizione:
    Numero di avvii del capitolo. Importante: se questo evento è impostato, l'unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    (a.media.chapter.
    view)
  • Heartbeat:
    (s:event:
    type=chapter_start)
  • Disponibile:
    Sì
  • Variabile riservata:
    evento
  • Nome rapporto:
    Avvio capitolo
  • Dati contestuali:
    (a.media.chapter.
    view)
  • Feed dati:
    videochapterstart
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    view)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    impressions.value > 0 => "TRUE"
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.isStarted

Capitolo completato

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
    TRUE
  • Descrizione:
    Numero di completamenti del capitolo. Importante: se questo evento è impostato, l’unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    (a.media.chapter.
    complete)
  • Heartbeat:
    (s:event:
    type=chapter_complete)
  • Disponibile:
    Sì
  • Variabile riservata:
    evento
  • Nome rapporto:
    Completamento capitolo
  • Dati contestuali:
    (a.media.chapter.
    complete)
  • Feed dati:
    videochaptercomplete
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    complete)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    completes.value
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.isCompleted

Tempo trascorso capitolo

ImplementazioneParametri di reteReporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    Sì
  • Tipo:
    numero
  • Inviato con:
    Chiusura capitolo
  • Versione SDK min.: 1.3
  • Valore di esempio:
  • Descrizione:
    Tempo trascorso sul capitolo. Il valore verrà visualizzato nel formato ora (HH:MM:SS) in Analysis Workspace. In Feed dati, Data Warehouse e API di reporting i valori verranno visualizzati in secondi.
  • Adobe Analytics:
    (a.media.chapter.
    timePlayed)
  • Heartbeat:
  • Disponibile:
    sì
  • Variabile riservata:
    evento
  • Nome rapporto:
    Tempo trascorso su capitolo
  • Dati contestuali:
    (a.media.chapter.
    timePlayed)
  • Feed dati:
    videochaptertime
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    timePlayed)
  • Percorso campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    timePlayed.value
  • Percorso campo XDM per reporting:
    mediaReporting.chapterDetails.timePlayed