Domande frequenti sull'SDK Engage

Pubblica le domande frequenti

Chi gestisce l'attività di pubblicazione dei contenuti?

Lo sviluppatore di app gestisce il job di pubblicazione dei contenuti e invia richieste al servizio Engage. In questo modo, i partner sviluppatori hanno un maggiore controllo su quando e come pubblicare i contenuti per gli utenti. In questo modo si evita di attivare l'app partner troppo di frequente per pubblicare contenuti.

Uno sviluppatore deve pubblicare tutti i tipi di cluster?

Sebbene tecnicamente gli sviluppatori siano liberi di pubblicare un solo cluster, consigliamo vivamente di includerne altri. In caso contrario, gli sviluppatori perdono l'opportunità di generare un maggiore coinvolgimento con i loro contenuti. Ti consigliamo vivamente di pubblicare tutti i tipi di cluster per ogni verticale.

Con quale frequenza lo sviluppatore partner deve pubblicare i dati utilizzando WorkManager mentre l'app è in esecuzione?

Questo deve essere deciso dal partner sviluppatore. Google consiglia di pubblicare una o due volte al giorno per i contenuti di suggerimenti generali e di utilizzare una metodologia basata sugli eventi per i contenuti relativi al carrello acquisti, al riordino e ad altri contenuti di continuazione (ad esempio, avviare il worker come callback dell'utente che aggiunge articoli al carrello o dell'utente che interrompe un film a metà). Per le app social, è fondamentale pubblicare cluster di consigli aggiornati dopo ogni utilizzo dell'app. Gli utenti di app social sono più interessati ai consigli più recenti e, idealmente, vorrebbero vedere un post al massimo una volta.

Quando lo sviluppatore deve chiamare le API di eliminazione?

Le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti; le API di pubblicazione rimuovono automaticamente i contenuti precedenti.

Domande frequenti sull'intent di trasmissione

Perché gli sviluppatori di app per Android devono registrarsi per gli intent di trasmissione?

Per mostrare contenuti aggiornati all'utente, devi utilizzare gli intent di trasmissione per attivare una sincronizzazione dei dati nei casi in cui gli utenti potrebbero non utilizzare l'app di frequente.

Impossibile testare l'intent di trasmissione

L'app di verifica non supporta il test dell'intent di trasmissione con autorizzazione. Devi rimuovere le autorizzazioni durante i test e aggiungerle di nuovo prima di passare alla versione di produzione dell'SDK nel passaggio 6.

Esecuzione in background non consentita

Durante la registrazione dell'intent di trasmissione, potresti riscontrare il seguente errore:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

Devi registrare i broadcast receiver in modo dinamico.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION,
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null));
...

}

Domande frequenti sui workflow

Durante l'integrazione con l'SDK, potresti riscontrare i seguenti errori:

Errori di convalida a livello di app, cluster ed entità

I riepiloghi a livello di app, cluster ed entità mostrano un conteggio degli errori di convalida. Questi errori corrispondono a campi obbligatori mancanti o a valori non validi forniti. I messaggi di errore vengono visualizzati in rosso sotto ogni campo pertinente. Correggi tutti gli errori di convalida e verifica la correttezza prima di condividere l'APK.

I deep link sono associati al nome del pacchetto. Un buon modo per testare i deep link è utilizzare lo strumento adb.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

I deep link sono un ottimo modo per monitorare l'attribuzione. Gli URL dei deep link che indirizzano gli utenti alla tua app possono essere inclusi con parametri di monitoraggio aggiuntivi. Ad esempio, "http://xx/deeplink?source_tag=engage".

Gli sviluppatori possono aggiungere i propri parametri di monitoraggio e fornire l'attribuzione per calcolare l'impatto.

Domande frequenti su Engage per TV 2.0

Domande generali

Che cos'è Engage?

Engage porta l'esperienza "riprendi da dove avevi interrotto" a un livello superiore. Si tratta di un upgrade significativo che consente agli spettatori di riprendere la visione dei contenuti senza problemi su una gamma più ampia di dispositivi. Immagina di iniziare a guardare un film su Google TV e poi di continuare a guardarlo senza problemi sullo smartphone durante il tragitto giornaliero: questa è la potenza di Engage.

Questo nuovo sistema è progettato per aumentare il coinvolgimento e la fidelizzazione degli spettatori offrendo un'esperienza fluida e senza interruzioni nell'intero ecosistema Google.

L'API Video Discovery è la stessa cosa di Engage?

Sì, sono uguali. L'SDK Engage è una libreria che include il supporto per la riga Continua a guardare. Engage supporta più tipi di entità di contenuti rispetto ai video, motivo per cui l'integrazione non si chiama più "Video Discovery".

Quali sono i vantaggi dell'utilizzo di Engage?

Risposta: Engage consente agli spettatori di riprendere più facilmente che mai la visione dei tuoi contenuti da dove l'avevano interrotta, indipendentemente dal dispositivo che utilizzano. Ecco come funziona:

  • Esperienza fluida su Google: inizia a guardare un contenuto su Google TV e continua senza interruzioni sul tuo smartphone Android, iPhone o tablet Android. Funziona anche sui dispositivi su cui non hai ancora installato l'app.
  • Maggiore coinvolgimento e fidelizzazione: Engage aiuta a riportare gli utenti alla tua app, anche su nuovi dispositivi. Consentendo agli utenti di riprendere la visione dei loro programmi preferiti, aumenti le probabilità che continuino a guardarli.
  • Copertura più ampia: oltre a Google TV, Engage funziona su altre esperienze multimediali Android, come Raccolte di Play e altre app multimediali di Google.
  • Compatibilità con le versioni precedenti: se utilizzi già la funzionalità "Cosa guardare" precedente, non preoccuparti. Engage è compatibile con le versioni precedenti, quindi la tua integrazione esistente continuerà a funzionare.

Nota importante: tutte le nuove integrazioni di Continua a guardare devono utilizzare Engage. Il sistema precedente "Prossimi contenuti su più dispositivi" verrà gradualmente ritirato.

Quali piattaforme supportano Engage?

  1. Google TV
  2. Android TV (solo sul dispositivo, ma supporta l'SDK Engage)
  3. App mobile Google TV per Android
  4. App mobile Google TV per iOS
  5. Raccolte di Google Play
  6. Google Entertainment Space
  7. Dispositivi iOS (con integrazione dell'API REST).

L'SDK Engage è per Continua a guardare?

Sì, l'SDK Engage supporta i contenuti per la riga Continua a guardare. È obbligatorio per l'integrazione con Engage.

Engage è disponibile per tutti?

Engage è in fase di implementazione graduale.

  • Accesso in anteprima: inizialmente concederemo l'accesso a un gruppo selezionato di partner tramite un programma di accesso in anteprima (EAP).
  • Ampliamento dell'accesso: stiamo lavorando per rendere Engage disponibile a tutti gli sviluppatori a breve.

Per un lancio fluido e di successo, abbiamo adottato misure di salvaguardia per gestire l'implementazione. Ciò comporta sia una lista consentita sul lato di Engage sia un controllo separato all'interno dell'SDK Engage. Se sei un partner EAP o vuoi diventarlo a breve, contattaci per consentirci di configurare le autorizzazioni di accesso prima di iniziare l'integrazione dell'SDK Engage.

I requisiti delle immagini sono stati aggiornati nella sezione Crea entità.

Con questa nuova documentazione dell'API, i dati di Continua a guardare verranno estratti dal server Google dal client e verranno mostrati su tutti i dispositivi?

La nuova API offre miglioramenti significativi per i contenuti della riga Continua a guardare, tra cui:

  • Esperienza fluida su Google TV: gli utenti possono iniziare a guardare un contenuto su una Google TV e riprendere su qualsiasi altra Google TV su cui hanno eseguito l'accesso con lo stesso account. Questa funzionalità è disponibile anche con le versioni precedenti di Android TV.

  • Integrazione con l'app mobile: i contenuti di Engage vengono mostrati nell'app mobile Google TV per Android e iOS, consentendo agli utenti di passare facilmente dalla TV ai dispositivi mobili.

  • Fidelizzazione utenti migliorata: anche sui dispositivi su cui l'app non è installata o su cui l'utente non ha eseguito l'accesso, i contenuti della riga Continua a guardare incoraggiano gli utenti a interagire di nuovo con la tua app, aumentando la fidelizzazione.

  • Espansione ad altre piattaforme: Engage si estende ad altre piattaforme multimediali di Google, come Android, Raccolte di Play, tablet e altre app e piattaforme multimediali di Google su Android, massimizzando il coinvolgimento degli utenti su tutti i dispositivi.

Qual è il limite al numero di entità che posso pubblicare nel cluster di continuazione?

Ogni partner sviluppatore è limitato a un massimo di 5 entità nel cluster Continuation. Questo limite serve a garantire una distribuzione equa dei contenuti nella riga "Continua a guardare" su Google TV, che è uno spazio condiviso per più fornitori di contenuti multimediali.

Che cosa succede se provo a pubblicare più di 5 entità?

L'SDK Engage rifiuterà la richiesta di pubblicazione se supera il limite di 5 entità. Per pubblicare correttamente, dovrai ridurre il numero di entità nella richiesta. Devi includere solo le entità in cui gli utenti hanno interrotto la visione, quindi nella maggior parte dei casi saranno presenti solo alcune di queste entità. Se sono presenti più di 5 entità di questo tipo, puoi scegliere di pubblicare quelle più recenti.

Perché esiste un limite al numero di entità?

La riga Continua a guardare su Google TV mostra i contenuti di vari fornitori di contenuti multimediali. Limitando il numero di entità per fornitore in modo che gli utenti vedano una selezione diversificata di contenuti da tutte le loro fonti preferite, promuovendo un'esperienza utente equa e bilanciata.

Domande sull'app di verifica

È obbligatorio testare la mia app con l'app di verifica prima dell'invio?

Sì, testare l'app con l'app di verifica è essenziale prima di inviare l'APK.

Anche se comprendiamo che potresti avere fiducia nella tua implementazione, l'integrazione di Engage presenta molti componenti complessi. L'app di verifica funge da rete di sicurezza, rilevando tempestivamente potenziali problemi e facendoti risparmiare tempo e fatica preziosi nel lungo periodo.

È come un rapido controllo che aiuta a garantire un lancio senza problemi e un'esperienza utente ottimale.

Identificando e risolvendo eventuali problemi in anticipo, puoi evitare la frustrazione di rifiuti e nuovi invii.

Per inviare l'APK, devi includere uno screenshot che dimostri che l'app ha superato la procedura di verifica.

Quali sono alcuni errori comuni da tenere d'occhio durante l'integrazione?

L'app di verifica è progettata per rilevare potenziali problemi con l'integrazione di Engage. Ecco alcuni errori comuni che gli sviluppatori spesso riscontrano:

Per tutti i tipi di contenuti (film, puntate TV, live streaming, video clip):

  • Link mancanti: assicurati di fornire URI (link) validi specifici per la piattaforma per i tuoi contenuti. Questi link indicano al sistema dove trovare i tuoi contenuti su ogni piattaforma.
  • Titoli mancanti: non dimenticare di includere i titoli per tutti i tuoi contenuti. In questo modo, gli utenti possono identificare ciò che stavano guardando.
  • Proporzioni delle immagini: verifica che tutte le immagini associate ai tuoi contenuti abbiano proporzioni vicine a 16:9. In questo modo, le immagini vengono visualizzate correttamente su schermi diversi.

Per le puntate TV:

  • Informazioni complete sulla puntata: assicurati di includere il titolo della serie, il numero della puntata e il numero della stagione. In questo modo, le puntate vengono organizzate e gli utenti possono navigare all'interno di una serie.
  • Posizione di riproduzione accurata: verifica che l'ultima posizione di riproduzione sia inferiore o uguale alla durata totale della puntata. In questo modo, gli utenti riprendono la riproduzione dal punto corretto.

Per i film:

  • Posizione di riproduzione accurata: come per le puntate TV, verifica che l'ultima posizione di riproduzione sia accurata.

Per i video in live streaming:

  • Informazioni sull'emittente: includi il nome dell'emittente per i live streaming.

Per i video clip:

  • Informazioni sul creator: specifica il creator del video clip.

Ricorda: l'app di verifica segnalerà questi problemi, consentendoti di risolverli prima di inviare l'app. In questo modo risparmierai tempo e garantirai un'esperienza più fluida per i tuoi utenti.

Domande su account e profilo

La mia app utilizza accessi di utenti anonimi. AccountProfile è ancora obbligatorio per Engage?

AccountProfile è progettato per le app che utilizzano account utente individuali. Tuttavia, siamo consapevoli che alcune app, come la tua, potrebbero basarsi su accessi anonimi. Ecco come funziona Engage in questo scenario:

  • AccountProfile è tecnicamente obbligatorio, ma puoi comunque integrare Engage anche se la tua app non dispone di un sistema di account utente.
  • Limitazione all'utilizzo on-device: le funzionalità cross-device di Engage si basano sull'identificazione degli utenti su diversi dispositivi. Poiché gli accessi anonimi non forniscono queste informazioni, la funzionalità sarà limitata al dispositivo corrente dell'utente.
  • Come configurare: per configurare questa opzione, devi disattivare la sincronizzazione cross-device. In questo modo, le voci di continuazione vengono visualizzate solo sul dispositivo specifico su cui sono stati avviati i contenuti.

In sintesi: sebbene sia possibile integrare Engage con gli accessi anonimi, gli utenti potranno riprendere i contenuti solo sullo stesso dispositivo.

Posso utilizzare AccountProfile solo con accountId e senza profileId, anche se la mia app supporta sia accountId sia profileId?

AccountProfile richiede sia accountId che profileId per funzionare correttamente. Ecco perché:

  • Identificazione coerente: accountId identifica l'utente, mentre profileId distingue tra i diversi profili all'interno dell'account dell'utente (se applicabile). Fornire entrambi garantisce che Engage monitori e mostri con precisione i contenuti per ogni singolo profilo.
  • Prevenzione degli errori: l'utilizzo incoerente di accountId e profileId in diverse chiamate API può causare comportamenti imprevisti ed errori. Ad esempio, se includi entrambi i parametri quando aggiungi contenuti a Engage, ma utilizzi solo accountId quando elimini i contenuti, il sistema potrebbe non essere in grado di identificare e rimuovere correttamente gli elementi previsti.

profileId è obbligatorio per Engage?

  • Il campo accountId è obbligatorio. In questo modo, l'utente viene identificato su tutti i dispositivi.
  • profileId è fondamentale per una buona esperienza utente. Sebbene sia tecnicamente facoltativo, profileId è vivamente consigliato se il tuo servizio supporta più profili (come molti servizi di streaming). Perché è così importante? Senza profileId, la riga Continua a guardare potrebbe mostrare contenuti di altri profili dello stesso account. Ciò può causare un'esperienza confusa e frustrante per gli utenti.
  • In breve: l'invio di profileId garantisce che i contenuti forniti alla riga Continua a guardare riflettano accuratamente la cronologia delle visualizzazioni di ogni individuo. A meno che la tua app non supporti il concetto di profilo all'interno di un account, devi fornirlo.

In che modo Google utilizza i profileId?

Se il servizio offre profili diversi per guardare i contenuti, accountId e profileId verranno utilizzati per associare i contenuti guardati sul dispositivo all'Account Google che ha eseguito l'accesso sul dispositivo. Google registrerà i dati di ContinueWatching per la combinazione di accountId e profileId. Qualsiasi dispositivo Google su cui è stato eseguito l'accesso con lo stesso Account Google riceverà i dati aggiornati più di recente dagli stessi accountId e profileId associati, nella riga Continua a guardare.

Il collegamento degli account è obbligatorio per implementare Engage?

Il collegamento dell'account non è necessario. La sua priorità è stata ridotta e tutti i casi d'uso correlati saranno coperti dalla nuova API Entitlements per dispositivi.

Domande sulla sincronizzazione su più dispositivi

Con il consenso dell'utente alla "sincronizzazione su tutti i dispositivi", i contenuti che sta guardando verranno salvati sui server di Google TV, consentendogli di riprendere senza problemi da dove aveva interrotto su qualsiasi dispositivo su cui è stato fatto l'accesso. Senza il consenso, la cronologia delle visualizzazioni rimane locale sul dispositivo corrente.

Possiamo impostare "Sincronizza su più dispositivi" su false?

Il flag setUserConsentToSyncAcrossDevices controlla se i dati di ContinuationCluster di un utente vengono sincronizzati tra i suoi dispositivi (TV, smartphone, tablet e così via). Se questo flag è impostato su false, i contenuti di Continua a guardare vengono visualizzati solo sullo stesso dispositivo.

Per ottenere il massimo dalla nostra funzionalità cross-device, ti consigliamo vivamente di ottenere il consenso dell'utente per la tua app e di impostare SyncAcrossDevices su true.

dispositivi? Quali punti dati vengono condivisi con i server di terze parti dai dispositivi non Android?

Il consenso viene raccolto a livello di utente (profilo o account). Una volta ottenuto il consenso, i payload di Continua a guardare basati sul coinvolgimento possono essere inviati ovunque, in modo che Google possa riflettere lo stato di ripresa ubiquitaria degli utenti in tutte le entità con cui hanno un coinvolgimento parziale o successivo, su qualsiasi dispositivo (senza dover richiedere nuovamente il consenso su ogni dispositivo o piattaforma). I partner invieranno agli utenti lo stato di continuazione della visione più recente (come da specifiche) associato all'ID profilo (che è stato depositato su Android).

Domande sull'API REST

È disponibile la documentazione sull'API REST?

L'ETA per l'API REST è marzo 2025, come documentato nella documentazione per gli sviluppatori di Engage.

Domande sulla sezione Cosa guardare precedente

Engage sostituirà l'API Cosa guardare?

Engage sarà compatibile con le versioni precedenti su tutti i dispositivi Android TV che supportano l'API Cosa guardare. Per l'integrazione su Google TV e altre piattaforme che supportano Engage, gli sviluppatori devono utilizzare l'SDK Engage.

Domande su test e integrazione

Qual è la differenza tra LastPlayBackPositionTimeMillis e duration?

LastPlayBackPositionTimeMillis deve riflettere la durata della riproduzione in millisecondi in cui l'utente ha interrotto la visione (ad es.605.000 ms per 10 minuti e 5 secondi). Non deve mai essere superiore alla durata totale dell'entità.

LastEngagementTime è il timestamp dell'ultima interazione dell'utente con i contenuti.

Quali sono gli scenari di test che dobbiamo eseguire?

Di seguito sono riportati gli scenari di test per Google TV eseguiti dal nostro team addetto al QA. Scenari di test simili possono essere eseguiti anche su altre piattaforme.

  1. Guarda un video di durata superiore a 20 minuti per circa 5 minuti. Esci dall'app. La scheda del video dovrebbe essere visualizzata nella riga Continua a guardare. Nota: Mostriamo solo 5 schede per app di terze parti in CW
  2. Selezionando la scheda appena visualizzata nella riga Continua a guardare, la riproduzione del video dovrebbe riprendere dal punto corretto. Nota: la riproduzione di qualsiasi contenuto nuovo o meno recente dovrebbe riprendere dal punto in cui è stata interrotta l'ultima volta.
  3. La modifica degli account sul dispositivo GTV dovrebbe modificare le schede nella riga Continua a guardare. Dovrebbero essere visualizzati solo i video dell'account corrente. In ordine di data. Il CW del profilo dell'app di terze parti verrà combinato. Nota: la riga Continua a guardare per GoogleAccount2 mostrerà i contenuti di terze parti che GoogleAccount2 stava guardando
  4. Esci dall'app con il pulsante Indietro > Verifica che la scheda venga visualizzata nella riga "Continua a guardare"
  5. Nascondi il video nella riga Continua a guardare. Non dovrebbe essere più visualizzato. Verifica se i contenuti nascosti rimangono nascosti per più di 24 ore e anche dopo l'apertura dell'app dopo 24 ore. Verifica che nascondendo un elemento non vengano nascosti più elementi.
  6. Disponibilità dei contenuti nella riga Continua a guardare con metadati completi: immagine della scheda, nome dell'app, titolo, numero della puntata della stagione per i contenuti TV
  7. Verifica l'avanzamento visualizzato nella barra di avanzamento
  8. L'utente ha guardato i contenuti fino ai titoli di coda: i contenuti non vengono visualizzati nella riga Continua a guardare
  9. Verifica che nella riga Continua a guardare non vengano visualizzati elementi non guardati
  10. Verifica che gli elementi CW siano disposti in ordine cronologico in base a quando si è verificata l'attività di visualizzazione e non a quando l'app è stata aperta l'ultima volta o all'ultimo giorno
  11. Conferma che i dettagli della puntata e della stagione sulla scheda Continua a guardare corrispondano a quelli dei contenuti a puntate guardati
  12. Verifica che gli elementi completati (elementi con i titoli di coda o oltre) non vengano visualizzati nella riga Continua a guardare
  13. Spegni il dispositivo a metà della visione della puntata, del film o del programma. "Spegni il dispositivo a metà della visione della puntata/del film/del programma. Verifica che, all'accensione del dispositivo e su un'altra TV, CW mostri la scheda corretta, nella posizione corretta e con la barra di avanzamento"
  14. Spegni il dispositivo dopo aver guardato completamente la puntata 1, verifica
  15. La puntata 1 viene eliminata e non viene più visualizzata nella riga Continua a guardare [sul secondo dispositivo e all'accensione del dispositivo di test]
    1. La puntata 2 (se disponibile) dovrebbe essere visualizzata nella riga Continua a guardare [sul secondo dispositivo e all'accensione del dispositivo di test]
  16. Primo scenario: TV1: Account Google: mamma, account/profilo di terze parti: account 1/profilo_1. Guarda i contenuti e verifica che i dati di Continua a guardare mostrino i contenuti guardati da account_1/profilo_1 di terze parti

  17. TV2: Account Google: mamma. Verifica i dati di CW del primo scenario. Ora accedi all'app di terze parti con un altro account. Account/profilo di terze parti: account_2/ profilo_2. Guarda i contenuti e verifica che i dati di CW mostrino i contenuti guardati dall'account di terze parti account_2/profile_2

  18. Account Google: mamma. Nuova custodia per dispositivo/app di terze parti non installata. Su un nuovo dispositivo (FDR del dispositivo), verifica che l'app Connessione Salute mostri i dati dell'ultima app di terze parti utilizzata dall'Account Google. Nota: la riga CW non deve mostrare contenuti di terze parti se l'account GAIA non è ancora associato a un profilo di terze parti su un altro dispositivo

    1. Account Google: mamma. Nuova custodia del dispositivo/app di terze parti installata, ma senza accesso. Su un nuovo dispositivo (FDR del dispositivo), verifica che CW mostri i dati dell'ultima app di terze parti utilizzata dall'Account Google.
    1. Nota: la riga Continua a guardare non deve mostrare contenuti di terze parti se l'Account Google non è ancora associato a un profilo di terze parti

Non vediamo i contenuti di continuazione nell'app Google TV per iOS. Che cosa è successo?

Per far apparire i contenuti nella riga Continua a guardare sui dispositivi iOS, dovrai inviare deep link per iOS.

Con quale frequenza devo aggiornare le informazioni sui contenuti per la riga Continua a guardare? Devo aggiornarlo di frequente, ad esempio ogni 15 secondi?

No, gli aggiornamenti frequenti non sono consigliati. Ecco perché:

  • Impatto sulle prestazioni: l'invio continuo di aggiornamenti sovraccarica inutilmente i nostri server, rallentando potenzialmente il sistema per tutti.
  • Dati non necessari: mentre un utente guarda attivamente un video, la sua posizione di riproduzione cambia costantemente. L'invio di aggiornamenti ogni pochi secondi crea molti dati ridondanti che non sono utili per riprendere la riproduzione.

Quando aggiornare le informazioni sui contenuti per la riga Continua a guardare:

Concentrati sull'acquisizione di modifiche significative nell'avanzamento della visualizzazione dell'utente. Ecco gli scenari principali:

  • Riproduzione in pausa o interrotta: quando un utente mette in pausa o interrompe la visione, invia un aggiornamento per memorizzare la sua posizione attuale.
  • App chiusa o in background: se un utente esce dall'app o passa a un'altra app mentre guarda un video, invia un aggiornamento per salvare i suoi progressi.
  • Quando l'utente rimuove un elemento dalla riga Continua a guardare all'interno dell'app

Come eseguire l'aggiornamento in modo efficiente:

Anziché aggiornamenti programmati, utilizza gli eventi all'interno del video player o del ciclo di vita dell'app per attivare gli aggiornamenti. Ad esempio:

  • onPause, onStop: quando la riproduzione del video viene messa in pausa o interrotta.
  • onAppClose, onAppBackgrounded: quando l'app viene chiusa o spostata in background.

Se segui queste linee guida, garantirai un utilizzo efficiente delle risorse, offrendo al contempo un'esperienza fluida nella riga Continua a guardare per i tuoi utenti.