Tracciare la riproduzione di base su iOS track-core-playback-on-ios

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

StreamTypeCostanti:

MediaTypeCostanti:

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>];

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

  note note
  NOTE
  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:

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

Tracciare l’intenzione di avviare la riproduzione

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

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

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];
}

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];
}

Tracciamento della 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, quindi effettua una chiamata trackSessionEnd.

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

Tracciare tutti gli scenari di pausa possibili

Identifica l’evento dal lettore video per la pausa video e la chiamata trackPause:

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

Scenari di pausa

Identifica uno scenario in cui il lettore video si interrompe e verifica che trackPause sia chiamato correttamente. I seguenti scenari richiedono tutti una chiamata trackPause() dall’app:

• L’utente mette esplicitamente in pausa l’app.
• Il lettore si mette in pausa da solo.
• (App per dispositivi mobili): l’utente mette l’applicazione in background, ma si desidera invece che l’app mantenga aperta la sessione.
• (App per dispositivi mobili): si verifica una qualsiasi interruzione del sistema causando l’esecuzione in background dell’applicazione. 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.

Identifica l’evento dal lettore per la riproduzione video e/o la ripresa del video dalla pausa ed effettua una chiamata trackPlay.

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