Documentazione Analytics Guida ai servizi Streaming Media

Panoramica sull’implementazione di Edge

Ultimo aggiornamento: 4 giugno 2026

Argomenti:
Streaming Media

Creato per:

User
Admin
Developer

L’Edge Network di Adobe Experience Platform consente di inviare dati destinati a più prodotti a un singolo endpoint, che inoltra le informazioni appropriate a ciascun prodotto. Questo consolida lo sforzo di implementazione su più soluzioni di dati ed è il modo consigliato per implementare Streaming Media Collection sia per Adobe Analytics che per Customer Journey Analytics.

Indipendentemente dalla base di codice utilizzata, ovvero Web SDK, Mobile SDK (iOS o Android), Roku SDK o l’API di Media Edge, è innanzitutto necessario completare la configurazione della piattaforma descritta in questa pagina: crea uno schema, crea un set di dati e configura un datastream.

Prerequisiti

Completare i prerequisiti generali. Consulta i prerequisiti generali.
Conferma una soluzione Adobe compatibile. Devi disporre di un’implementazione funzionante di Customer Journey Analytics, Adobe Analytics, Adobe Journey Optimizer o Real-Time Customer Data Platform:

Configurare lo schema in Adobe Experience Platform

Per standardizzare la raccolta dei dati tra le applicazioni che utilizzano Adobe Experience Platform, Adobe ha creato lo standard Experience Data Model (XDM) aperto e documentato pubblicamente.

In Adobe Experience Platform, iniziare a creare lo schema come descritto in Creare e modificare gli schemi nell’interfaccia utente.
Nella pagina Dettagli schema, scegliere Experience Event come classe base per lo schema.
Seleziona Next.
Specificare il nome e la descrizione dello schema, quindi selezionare Finish.
Nell’area Composition, nella sezione Field groups, selezionare Add, quindi cercare e aggiungere i seguenti gruppi di campi allo schema:
- End User ID Details
- Implementation Details
- MediaAnalytics Interaction Details
Dopo aver aggiunto i gruppi di campi, questi vengono visualizzati nella sezione Field groups:
Seleziona Save per salvare le modifiche.

(Facoltativo) Puoi nascondere alcuni campi non utilizzati dall’API di Media Edge. Nascondere questi campi semplifica la lettura dello schema, ma non è obbligatorio. Questi campi fanno riferimento solo a quelli del gruppo di campi MediaAnalytics Interaction Details.

accordion

Espandi per visualizzare le istruzioni sui campi che puoi nascondere.

accordion
Espandi per visualizzare le istruzioni sui campi che puoi nascondere.
Nell’area Structure, selezionare il campo `Media Collection Details`, quindi selezionare Manage related fields. Abilita l’opzione a Show display names for fields, quindi aggiorna lo schema come segue: Nel campo `Media Collection Details` > `Advertising Details`, nascondi i seguenti campi di reporting: `Ad Completed`, `Ad Started` e `Ad Time Played`. Nel campo `Media Collection Details` > `Advertising Pod Details`, nascondi il seguente campo di reporting: `Ad Break ID` Nel campo `Media Collection Details` > `Chapter Details`, nascondere i seguenti campi di reporting: `Chapter Completed`, `Chapter ID`, `Chapter Started` e `Chapter Time Played`. Nel campo `Media Collection Details`, nascondere il campo `List Of States`. Nel campo `Media Collection Details` > `List Of States End` e `Media Collection Details` > `List Of States Start`, nascondi i seguenti campi di reporting: `Player State Count`, `Player State Set` e `Player State Time`. Nel campo `Media Collection Details` > `Qoe Data Details`, nascondere i seguenti campi di reporting: `Average Bitrate`, `Average Bitrate Bucket`, `Bitrate Change Impacted Streams`, `Bitrate Changes`, `Buffer Impacted Streams`, `Buffer Events`, `Dropped Frame Impacted Streams`, `Drops Before Starts`, `Errors`, `External Error IDs`, `Error Impacted Streams`, `Media SDK Error IDs`, `Player SDK Error IDs`, `Stalling Impacted Streams`, `Stalling Events`, `Total Buffer Duration` e `Total Stalling Duration`. Nel campo `Media Collection Details` > `Session Details`, nascondere i seguenti campi di reporting: `10% Progress Marker`, `25% Progress Marker`, `50% Progress Marker`, `75% Progress Marker`, `95% Progress Marker`, `Ad Count`, `Average Minute Audience`, `Content Completes`, `Chapter Count`, `Content Starts`, `Content Time Spent`, `Estimated Streams`, `Federated Data`, `Media Segment Views`, `Media Downloaded Flag`, `Media Starts`, `Media Session ID`, `Media Session Server Timeout`, `Media Time Spent`, `Pause Events`, `Pause Impacted Streams`, `Pev3`, `Pccr`, `Total Pause Duration`, `Unique Time Played` e `Video Segment`. Seleziona Confirm per salvare le modifiche. Nell’area Structure, abilitare l’opzione a Show display names for fields, quindi selezionare il campo `List Of Media Collection Downloaded Content Events`. Selezionare Manage related fields, quindi aggiornare lo schema come segue: Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details` > `Advertising Details`, nascondi i seguenti campi di reporting: `Ad Completed`, `Ad Started` e `Ad Time Played`. Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details` > `Advertising Pod Details`, nascondi il seguente campo di reporting: `Ad Break ID` Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details` > `Chapter Details`, nascondi i seguenti campi di reporting: `Chapter Completed`, `Chapter ID`, `Chapter Started` e `Chapter Time Played`. Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details`, nascondi il campo `List Of States`. Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details` > `List Of States End` e `Media Collection Details` > `List Of States Start`, nascondi i seguenti campi di reporting: `Player State Count`, `Player State Set` e `Player State Time`. Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details` > `Qoe Data Details`, nascondi i seguenti campi di reporting: `Average Bitrate`, `Average Bitrate Bucket`, `Bitrate Change Impacted Streams`, `Bitrate Changes`, `Buffer Events`, `Buffer Impacted Streams`, `Drops Before Starts`, `Dropped Frame Impacted Streams`, `Error Impacted Streams`, `Errors`, `External Error IDs`, `Media SDK Error IDs`, `Player SDK Error IDs`, `Stalling Events`, `Stalling Impacted Streams`, `Total Buffer Duration` e `Total Stalling Duration`. Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details` > `Session Details`, nascondere i seguenti campi di reporting: `10% Progress Marker`, `25% Progress Marker`, `50% Progress Marker`, `75% Progress Marker`, `95% Progress Marker`, `Ad Count`, `Average Minute Audience`, `Chapter Count`, `Content Completes`, `Content Starts`, `Content Time Spent`, `Estimated Streams`, `Federated Data`, `Media Downloaded Flag`, `Media Segment Views`, `Media Session ID`, `Media Session Server Timeout`, `Media Starts`, `Media Time Spent`, `Pause Events`, `Pause Impacted Streams`, `Pccr`, `Pev3`, `Total Pause Duration`, `Unique Time Played` e `Video Segment`. Nel campo `List Of Media Collection Downloaded Content Events` > `Media Details`, nascondi il campo `Media Session ID`. Seleziona Confirm per salvare le modifiche. Nell’area Structure, selezionare il campo `Media Reporting Details`, quindi selezionare Manage related fields. Abilita l’opzione a Show display names for fields, quindi aggiorna lo schema come segue: Nel campo `Media Reporting Details`, nascondere i campi seguenti: `Error Details`, `List Of States End`, `List of States Start` e `Media Session ID`. Seleziona Confirm > Save per salvare le modifiche.

Nell’area Structure, selezionare il campo Media Collection Details, quindi selezionare Manage related fields.
Abilita l’opzione a Show display names for fields, quindi aggiorna lo schema come segue:
- Nel campo Media Collection Details > Advertising Details, nascondi i seguenti campi di reporting: Ad Completed, Ad Started e Ad Time Played.
- Nel campo Media Collection Details > Advertising Pod Details, nascondi il seguente campo di reporting: Ad Break ID
- Nel campo Media Collection Details > Chapter Details, nascondere i seguenti campi di reporting: Chapter Completed, Chapter ID, Chapter Started e Chapter Time Played.
- Nel campo Media Collection Details, nascondere il campo List Of States.
- Nel campo Media Collection Details > List Of States End e Media Collection Details > List Of States Start, nascondi i seguenti campi di reporting: Player State Count, Player State Set e Player State Time.
- Nel campo Media Collection Details > Qoe Data Details, nascondere i seguenti campi di reporting: Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Impacted Streams, Buffer Events, Dropped Frame Impacted Streams, Drops Before Starts, Errors, External Error IDs, Error Impacted Streams, Media SDK Error IDs, Player SDK Error IDs, Stalling Impacted Streams, Stalling Events, Total Buffer Duration e Total Stalling Duration.
- Nel campo Media Collection Details > Session Details, nascondere i seguenti campi di reporting: 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Content Completes, Chapter Count, Content Starts, Content Time Spent, Estimated Streams, Federated Data, Media Segment Views, Media Downloaded Flag, Media Starts, Media Session ID, Media Session Server Timeout, Media Time Spent, Pause Events, Pause Impacted Streams, Pev3, Pccr, Total Pause Duration, Unique Time Played e Video Segment.
Seleziona Confirm per salvare le modifiche.
Nell’area Structure, abilitare l’opzione a Show display names for fields, quindi selezionare il campo List Of Media Collection Downloaded Content Events.
Selezionare Manage related fields, quindi aggiornare lo schema come segue:
- Nel campo List Of Media Collection Downloaded Content Events > Media Details > Advertising Details, nascondi i seguenti campi di reporting: Ad Completed, Ad Started e Ad Time Played.
- Nel campo List Of Media Collection Downloaded Content Events > Media Details > Advertising Pod Details, nascondi il seguente campo di reporting: Ad Break ID
- Nel campo List Of Media Collection Downloaded Content Events > Media Details > Chapter Details, nascondi i seguenti campi di reporting: Chapter Completed, Chapter ID, Chapter Started e Chapter Time Played.
- Nel campo List Of Media Collection Downloaded Content Events > Media Details, nascondi il campo List Of States.
- Nel campo List Of Media Collection Downloaded Content Events > Media Details > List Of States End e Media Collection Details > List Of States Start, nascondi i seguenti campi di reporting: Player State Count, Player State Set e Player State Time.
- Nel campo List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details, nascondi i seguenti campi di reporting: Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Events, Buffer Impacted Streams, Drops Before Starts, Dropped Frame Impacted Streams, Error Impacted Streams, Errors, External Error IDs, Media SDK Error IDs, Player SDK Error IDs, Stalling Events, Stalling Impacted Streams, Total Buffer Duration e Total Stalling Duration.
- Nel campo List Of Media Collection Downloaded Content Events > Media Details > Session Details, nascondere i seguenti campi di reporting: 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Chapter Count, Content Completes, Content Starts, Content Time Spent, Estimated Streams, Federated Data, Media Downloaded Flag, Media Segment Views, Media Session ID, Media Session Server Timeout, Media Starts, Media Time Spent, Pause Events, Pause Impacted Streams, Pccr, Pev3, Total Pause Duration, Unique Time Played e Video Segment.
- Nel campo List Of Media Collection Downloaded Content Events > Media Details, nascondi il campo Media Session ID.
Seleziona Confirm per salvare le modifiche.
Nell’area Structure, selezionare il campo Media Reporting Details, quindi selezionare Manage related fields.
Abilita l’opzione a Show display names for fields, quindi aggiorna lo schema come segue:
- Nel campo Media Reporting Details, nascondere i campi seguenti: Error Details, List Of States End, List of States Start e Media Session ID.
Seleziona Confirm > Save per salvare le modifiche.

(Facoltativo) Puoi aggiungere metadati personalizzati allo schema. Questo consente di includere metadati aggiuntivi definiti dall’utente per esigenze o contesti specifici. Per ulteriori informazioni sui metadati personalizzati con l’API di Media Edge, vedi Supporto per metadati personalizzati.

accordion
Espandi per visualizzare le istruzioni sull’aggiunta di metadati personalizzati allo schema.
Individuare il nome tenant dell’organizzazione selezionando Account info > Assigned orgs > * nome organizzazione * > tenant. I campi personalizzati vengono ricevuti tramite questo percorso. Ad esempio, nome tenant: _dcbl → percorso myCustomField: _dcbl.myCustomField. Aggiungi un gruppo di campi personalizzato allo schema multimediale definito. Aggiungi al gruppo di campi tutti i campi personalizzati di cui desideri tenere traccia. Utilizza il percorso generato per il campo personalizzato nel payload della richiesta.

accordion

Espandi per visualizzare le istruzioni sull’aggiunta di metadati personalizzati allo schema.

Individuare il nome tenant dell’organizzazione selezionando Account info > Assigned orgs >  nome organizzazione  > tenant.

I campi personalizzati vengono ricevuti tramite questo percorso. Ad esempio, nome tenant: _dcbl → percorso myCustomField: _dcbl.myCustomField.
Aggiungi un gruppo di campi personalizzato allo schema multimediale definito.
Aggiungi al gruppo di campi tutti i campi personalizzati di cui desideri tenere traccia.
Utilizza il percorso generato per il campo personalizzato nel payload della richiesta.

Continua con Crea un set di dati in Adobe Experience Platform.

Creare un set di dati in Adobe Experience Platform

Assicurarsi di impostare uno schema come descritto in Configurare lo schema in Adobe Experience Platform.
In Adobe Experience Platform, inizia a creare il set di dati come descritto nella Guida dell’interfaccia utente dei set di dati.

Quando selezioni uno schema per il set di dati, scegli lo schema creato in precedenza.
Continua con Configurare uno stream di dati in Adobe Experience Platform.

Configurare uno stream di dati in Adobe Experience Platform

Assicurarsi di aver creato un set di dati come descritto in Creare un set di dati in Adobe Experience Platform.

Creare un nuovo stream di dati come descritto in Configurare uno stream di dati.

Durante la creazione dello stream di dati, effettua le seguenti selezioni:

Nel campo Event Schema selezionare lo schema creato in Configurare lo schema in Adobe Experience Platform. Seleziona Save.

note important
IMPORTANT
Non selezionare Save and Add Mapping, perché in questo modo si verificano errori di mappatura per il campo Timestamp.

Crea un flusso di dati e seleziona uno schema

Aggiungi uno dei seguenti servizi al flusso di dati, a seconda che si utilizzi Adobe Analytics o Customer Journey Analytics:
- Adobe Analytics (se si utilizza Adobe Analytics)
  
  Se utilizzi Adobe Analytics, definisci una suite di rapporti come descritto in Creare una suite di rapporti.
- Adobe Experience Platform (se si utilizza Customer Journey Analytics)
Per informazioni sull’aggiunta di un servizio a un flusso di dati, vedere “Aggiungere servizi a un flusso di dati” in Configurare un flusso di dati.
Espandere Advanced Options, quindi abilitare l’opzione Media Analytics.

Scegli il metodo di implementazione

Con lo schema, il set di dati e lo stream di dati impostati, implementa una delle seguenti basi di codice per iniziare a inviare dati multimediali in streaming ad Edge Network. Ogni pagina descrive la configurazione specifica per i contenuti multimediali in streaming; il codice per evento e per variabile risiede in Eventi e Variabili.

Codebase

In-code

Tramite tag

Web

Web SDK

Estensione tag Web SDK

iOS

iOS (Tag)

Android

Android (Tag)

Roku

—