Tracciare la riproduzione di base su iOS

Questa documentazione tratta il tracciamento nella versione 2.x dell’SDK.

1. Configurazione del tracciamento iniziale

   Identifica quando l’utente attiva l’intenzione di riproduzione (l’utente fa clic su play e/o l’esecuzione automatica è attiva) e crea un’istanza MediaObject.

   API createMediaObjectWithName

   Nome variabile	Descrizione	Obbligatorio
   name	Nome del video	Sì
   mediaid	Identificatore univoco del video	Sì
   length	Lunghezza video	Sì
   streamType	Tipo di flusso (vedi Costanti StreamType sotto)	Sì
   mediaType	Tipo di file multimediale (vedi Costanti MediaType sotto)	Sì

   Costanti StreamType:

   Nome costante	Descrizione
   ADBMediaHeartbeatStreamTypeVOD	Tipo di flusso per video on demand
   ADBMediaHeartbeatStreamTypeLIVE	Tipo di flusso per il contenuto live
   ADBMediaHeartbeatStreamTypeLINEAR	Tipo di flusso per il contenuto lineare
   ADBMediaHeartbeatStreamTypeAOD	Tipo di flusso per audio on-demand
   ADBMediaHeartbeatStreamTypeAUDIOBOOK	Tipo di flusso per audiolibro
   ADBMediaHeartbeatStreamTypePODCAST	Tipo di flusso per Podcast

   Costanti MediaType:

   Nome costante	Descrizione
   ADBMediaTypeAudio	Tipo di file multimediale per flussi Audio.
   ADBMediaTypeVideo	Tipo di file multimediale per i flussi Video.

   Il formato generale per la creazione del MediaObject:

   ADBMediaObject *mediaObject =
     [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME>
                                          mediaId:<MEDIA_ID>
                                           length:<MEDIA_LENGTH>
                                       streamType:<STREAM_TYPE>
                                        mediaType: <MEDIA_TYPE>];
   

2. Allegare metadati video

   Facoltativamente, puoi allegare oggetti metadati video standard e/o personalizzati alla sessione di tracciamento video attraverso variabili dei dati di contesto.

   • Metadati video standard

     • Implementare metadati standard su iOS

     • Chiavi metadati video

       Chiavi metadati iOS

     • Consulta l’elenco completo dei metadati video qui: Parametri audio e video

     NOTA

     Il collegamento dell’oggetto metadati video standard all’oggetto multimediale è facoltativo.

   • Metadati personalizzati

     Crea un oggetto variabile per le variabili personalizzate e lo popola con i dati del video. Ad esempio:

     NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init];
     [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"];
     [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];
     

3. Tracciare l’intenzione di avviare la riproduzione

   Per iniziare a tracciare una sessione multimediale, effettua una chiamata trackSessionStart sull’istanza Media Heartbit.

   SUGGERIMENTO

   Il secondo valore corrisponde al nome dell’oggetto metadati video personalizzato creato nel passaggio 2.

   - (void)onMainVideoLoaded:(NSNotification *)notification {
   //    [_mediaHeartbeat trackSessionStart:mediaObject data:nil];
       [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata];
   }
   

   IMPORTANTE

   trackSessionStart tiene traccia delle intenzioni dell’utente in merito alla riproduzione, non dell’inizio della riproduzione. Questa API viene utilizzata per caricare i dati/metadati video e per stimare la metrica QoS relativa al tempo di avvio (la durata tra trackSessionStart e trackPlay).

   NOTA

   Se non utilizzi metadati video personalizzati, invia semplicemente un oggetto vuoto per l’argomento data in trackSessionStart, come mostrato nella riga esterna di commento nell’esempio di iOS precedente.

4. Tracciare l'inizio effettivo della riproduzione

   Identifica l’evento dal lettore video per l’inizio della riproduzione, in cui viene eseguito il rendering del primo fotogramma del video sullo schermo ed effettua una chiamata trackPlay.

   - (void)onVideoPlay:(NSNotification *)notification {
       [_mediaHeartbeat trackPlay];
   }
   

5. Tracciare il completamento della riproduzione

   Identifica l’evento dal lettore video per il completamento della riproduzione in cui l’utente ha guardato il contenuto fino alla fine ed effettua una chiamata trackComplete.

   - (void)onVideoComplete:(NSNotification *)notification {
       [_mediaHeartbeat trackComplete];
   }
   

6. Tracciare la fine della sessione

   Identifica l’evento dal lettore video per lo scaricamento/la chiusura della riproduzione in cui l’utente chiude il video e/o il video viene completato e scaricato ed effettua una chiamata trackSessionEnd.

   - void)onMainVideoUnloaded:(NSNotification *)notification {
       [_mediaHeartbeat trackSessionEnd];
   }
   

   IMPORTANTE

   trackSessionEnd indica la fine di una sessione di tracciamento video. Se la sessione è stata vista correttamente fino al completamento, per cui l’utente ha guardato il contenuto fino alla fine, assicurati che trackComplete sia chiamato prima di trackSessionEnd. Dopo trackSessionEnd, qualsiasi chiamata API track* viene ignorata, tranne la chiamata trackSessionStart per una nuova sessione di tracciamento video.

7. Tracciare tutti gli scenari di pausa possibili

   Identifica l’evento dal lettore video relativo alla pausa e chiama trackPause:

   - (void)onVideoPause:(NSNotification *)notification {
       [_mediaHeartbeat trackPause];
   }
   

   Scenari di pausa

   Identifica uno scenario in cui il lettore video verrà messo in pausa e assicura che la chiamata trackPause venga effettuata correttamente. Tutti gli scenari seguenti richiedono che l’app chiami trackPause():

   • L’utente mette esplicitamente in pausa l’app.
   • Il lettore si mette in pausa da solo.
   • (App mobili) - L’utente mette l’applicazione in background, ma l’app deve mantenere aperta la sessione.
   • (App mobili) - Si verifica un qualsiasi tipo di interruzione di sistema che porta l’applicazione in background. Ad esempio, l’utente riceve una chiamata oppure la notifica da un’altra applicazione, ma desideri che l’applicazione mantenga aperta la sessione per dare all’utente l’opportunità di riprendere il video dal punto in cui è stato interrotto.

8. Identifica l’evento dal lettore relativo alla riproduzione e/o la ripresa del video in pausa e chiama trackPlay:

   - (void)onVideoPlay:(NSNotification *)notification {
       [_mediaHeartbeat trackPlay];
   }
   

   SUGGERIMENTO

   Potrebbe trattarsi della stessa origine evento utilizzata nel passaggio 4. Assicurati che ogni chiamata API trackPause() sia associata alla successiva chiamata API trackPlay() quando la riproduzione video riprende.

Per ulteriori informazioni sul tracciamento della riproduzione core, consulta:

• Scenari di tracciamento: Riproduzione VOD senza annunci
• Lettore di esempio incluso nell’SDK per iOS, con un esempio di tracciamento completo.