Documentazione Analytics Guida a Streaming Media Collection

Parametri di richiesta

Ultimo aggiornamento: 5 agosto 2024

Argomenti:

Creato per:

Utente
Amministratore
Sviluppatore

Dati di Analytics

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`analytics.trackingServer`	S	string	`sessionStart`	URL del server Adobe Analytics
`analytics.reportSuite`	S	string	`sessionStart`	ID che identifica i dati di reporting di Analytics
`analytics.enableSSL`	N	booleano	`sessionStart`	True o false per abilitare SSL
`analytics.visitorId`	N	string	`sessionStart`	L’identificatore Adobe Visitor ID è un ID personalizzato che puoi utilizzare in più applicazioni Adobe. `visitorId` dell’heartbeat è uguale a `VID.` di Analytics

Dati del visitatore

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`visitor.marketingCloudOrgId`	S	string	`sessionStart`	L’ID organizzazione di Experience Cloud permette di identificare la tua organizzazione nell’ecosistema Adobe Experience Cloud
`visitor.marketingCloudUserId`	N	string	`sessionStart`	Questo è l’ID utente di Experience Cloud (ECID). Nella maggior parte degli scenari è l’ID da utilizzare per identificare un utente. `marketingCloudUserId` dell’heartbeat è uguale a `MID` in Adobe Analytics. Anche se tecnicamente non è necessario, questo parametro è richiesto per accedere alla famiglia di app di Experience Cloud.
`visitor.aamLocationHint`	N	numero intero	`sessionStart`	Fornisce dati edge di Adobe Audience Manager; se non viene inserito un valore, il valore è nullo.
`appInstallationId`	N	string	`sessionStart`	L’appInstallationId identifica in modo univoco l’app e il dispositivo

Dati del contenuto

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`media.id`	S	string	`sessionStart`	Identificativo univoco per il contenuto
`media.name`	N	string	`sessionStart`	Nome leggibile per il contenuto
`media.length`	S	number	`sessionStart`	Durata del contenuto (secondi)
`media.contentType`	S	string	`sessionStart`	Formato del flusso (può essere qualsiasi stringa, alcuni valori consigliati sono “Live”, “VOD” o “Linear”)
`media.playerName`	S	string	`sessionStart`	Nome del lettore responsabile del rendering del contenuto
`media.channel`	S	string	`sessionStart`	Canale di distribuzione del contenuto. Può trattarsi del nome di un’app mobile, di un sito web o di una proprietà
`media.resume`	N	booleano	`sessionStart`	Indica se un utente sta riprendendo una sessione precedente, anziché avviare una nuova sessione
`media.sdkVersion`	N	string	`sessionStart`	Versione SDK utilizzata dal lettore

Metadati standard del contenuto

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`media.streamFormat`	N	string	`sessionStart`	Formato flusso, ad esempio “HD“
`media.show`	N	string	`sessionStart`	Nome del programma o della serie
`media.season`	N	string	`sessionStart`	Numero della stagione a cui appartiene il programma o la serie
`media.episode`	N	string	`sessionStart`	Numero dell’episodio
`media.assetId`	N	string	`sessionStart`	Identificatore univoco per il contenuto della risorsa video, ad esempio l’identificatore dell’episodio della serie TV, della risorsa filmato o dell’evento in diretta. In genere questi ID hanno origine da autorità metadati come EIDR, TMS/Gracenote o Rovi. Questi identificatori possono provenire anche da altri sistemi proprietari o interni.
`media.genre`	N	string	`sessionStart`	Tipo di contenuto definito dal produttore del contenuto
`media.firstAirDate`	N	string	`sessionStart`	Data in cui il contenuto è andato in onda per la prima volta in televisione
`media.firstDigitalDate`	N	string	`sessionStart`	Data in cui il contenuto è stato trasmesso per la prima volta su qualsiasi piattaforma digitale
`media.rating`	N	string	`sessionStart`	La classificazione è definita da TV Parental Guidelines
`media.originator`	N	string	`sessionStart`	Creatore del contenuto
`media.network`	N	string	`sessionStart`	Nome della rete o del canale
`media.showType`	N	string	`sessionStart`	Tipo di contenuto, espresso come numero intero compreso tra 0 e 3: 0 - Episodio completo 1 - Anteprima 2 - Clip 3 - Altro
`media.adLoad`	N	string	`sessionStart`	Tipo di annuncio caricato
`media.pass.mvpd`	N	string	`sessionStart`	MVPD fornita dall’autenticazione Adobe
`media.pass.auth`	N	string	`sessionStart`	Indica che l’utente è stato autorizzato dall’autenticazione Adobe (può essere true solo se è impostato)
`media.dayPart`	N	string	`sessionStart`	Ora del giorno in cui il contenuto è stato trasmesso
`media.feed`	N	string	`sessionStart`	Tipo di feed, ad esempio “West-HD”

Dati dell’annuncio

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`media.ad.podFriendlyName`	N	string	`adBreakStart`	Nome descrittivo dell’interruzione pubblicitaria
`media.ad.podIndex`	S	numero intero	`adBreakStart`	Indice del pod dell'annuncio nel video
`media.ad.podSecond`	S	number	`adBreakStart`	Il secondo in cui è iniziato il pod
`media.ad.podPosition`	S	numero intero	`adStart`	Indice dell’annuncio nell’interruzione pubblicitaria, partendo da 1
`media.ad.name`	N	string	`adStart`	Nome descrittivo dell’annuncio
`media.ad.id`	S	string	`adStart`	Nome dell’annuncio
`media.ad.length`	S	number	`adStart`	Lunghezza dell’annuncio video in secondi
`media.ad.playerName`	S	string	`adStart`	Nome del lettore che esegue il rendering dell’annuncio

Metadati standard dell’annuncio

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`media.ad.advertiser`	N	string	`adStart`	Azienda o marchio il cui prodotto è inserito nell’annuncio
`media.ad.campaignId`	N	string	`adStart`	ID della campagna pubblicitaria
`media.ad.creativeId`	N	string	`adStart`	ID del contenuto creativo
`media.ad.siteId`	N	string	`adStart`	ID del sito dell’annuncio
`media.ad.creativeURL`	N	string	`adStart`	URL del contenuto dell’annuncio
`media.ad.placementId`	N	string	`adStart`	ID di posizionamento dell’annuncio

Dati sui capitoli

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`media.chapter.index`	S	numero intero	`chapterStart`	Identifica la posizione del capitolo nel contenuto
`media.chapter.offset`	S	number	`chapterStart`	Il secondo nella riproduzione da cui inizia il capitolo
`media.chapter.length`	S	number	`chapterStart`	Durata del capitolo in secondi
`media.chapter.friendlyName`	N	string	`chapterStart`	Nome descrittivo del capitolo

Dati sulla qualità

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`media.qoe.bitrate`	N	numero intero	Qualsiasi	Velocità in bit media (in bps). Il bitrate medio è calcolato come media ponderata di tutti i valori del bitrate relativi alla durata di riproduzione che si è verificata durante una sessione di riproduzione.
`media.qoe.droppedFrames`	N	numero intero	Qualsiasi	Numero di fotogrammi non elaborati nel flusso
`media.qoe.framesPerSecond`	N	numero intero	Qualsiasi	Numero di fotogrammi al secondo
`media.qoe.timeToStart`	N	numero intero	Qualsiasi	Tempo (in millisecondi) trascorso tra il momento in cui l’utente preme il tasto Play e quando il contenuto si carica e inizia la riproduzione

Parametri relativi al California Consumer Privacy Act (CCPA)

Chiave della richiesta	Obbligatorio	Chiave tipo di richiesta	Impostata su…	Descrizione
`analytics.optOutServerSideForwarding`	N	booleano	`sessionStart`	Impostato su true se l’utente finale rinuncia alla condivisione dei dati tra Adobe Analytics e altre soluzioni di Experience Cloud (ad esempio Audience Manager).
`analytics.optOutShare`	N	booleano	`sessionStart`	Impostato su true se l’utente finale rinuncia alla federazione dei propri dati (ad esempio ad altri clienti di Adobe Analytics).

Dettagli aggiuntivi

visitor.marketingCloudUserId

Passa l’ID utente Experience Cloud (noto anche come MID o MCID) alla chiamata sessionStart includendolo all’interno della mappa params e utilizzando la seguente chiave: visitor.marketingCloudUserId. Questa è una funzione utile se è già stata effettuata l’integrazione con altri prodotti Experience Cloud ed è già stato ottenuto il MCID.

NOTE

Media Analytics (MA) è integrato con la famiglia di app di Experience Cloud (Adobe Analytics, Audience Manager, Target e così via). È necessario un Experience Cloud ID per accedere a queste app. Nella maggior parte degli scenari, per identificare gli utenti dovrai usare l’ECID.

appInstallationId

Se non si passa un valore appInstallationId - Il back-end MA non genera più un MCID, ma si basa su Adobe Analytics a questo scopo. Adobe consiglia di inviare un MCID se disponibile oppure un appInstallationId (insieme a marketingCloudOrgId, sempre obbligatorio), in modo che l’API Media Collection generi l’identificativo MCID e lo invii a tutte le chiamate.
Se si passa un valore appInstallationId - L’identificativo MCID può essere generato dal back-end MA, se si trasmettono i valori per appInstallationId e i parametri marketingCloudOrgId (obbligatori). Se trasmetti appInstallationId, devi assicurarti di renderlo persistente lato client. Deve essere specifico per l’app su un dispositivo e deve essere mantenuto finché l’app non viene reinstallata.

NOTE

appInstallationId identifica in modo univoco l’app e il dispositivo. Deve essere univoco per ogni app su ciascun dispositivo, ovvero due utenti che utilizzano la stessa versione della stessa app su dispositivi diversi devono inviare ciascuno un appInstallationId diverso (univoco).

visitor.marketingCloudOrgId

Oltre a essere necessario per la generazione di MCID se non viene fornito, questo parametro viene utilizzato anche come valore per l’ID dell’editore (in base al quale Media Analytics esegue la corrispondenza della regola federativa.)

ID dell’utente legacy di Analytics (aid) e ID degli utenti dichiarati (customerID)

analytics.aid:

Il valore di questa chiave deve essere una stringa che rappresenta l’ID utente legacy di Analytics

visitor.customerIDs:

Il valore di questa chiave deve essere un oggetto del seguente formato:

"<<insert your ID name here>>": {
  "id": " <<insert your id here>>",
   "authState": <<insert one of 0, 1, 2>>
}

Tieni presente che il valore visitor.customerIDs può contenere un numero qualsiasi di oggetti nel formato presentato.

visitor.aamLocationHint

Questo parametro indica quale rete Edge di Adobe Audience Manager (AAM) viene raggiunta quando Adobe Analytics invia i dati del cliente ad Audience Manager. Se non si immette alcun valore, tale valore sarà nullo. Ciò è particolarmente importante se gli utenti finali utilizzano i loro dispositivi in posizioni geograficamente distanti (ad esempio, Stati Uniti orientali, Stati Uniti occidentali, Europa, Asia). In caso contrario, i dati dell’utente saranno distribuiti su più reti Edge di AAM.

media.resume

Se l’app determina che una sessione è stata chiusa e ripresa in un secondo momento (ad esempio se l’utente interrompe il video e lo riprende più tardi dal punto in cui era stata interrotta la riproduzione), puoi inviare un parametro booleano facoltativo media.resume all’interno del bucket dei parametri della chiamata sessionStart.

recommendation-more-help