Questions fréquentes sur le SDK Engage

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Questions fréquentes sur la publication

Qui gère la tâche de publication de contenu ?

Le développeur de l'application gère la tâche de publication de contenu et envoie les requêtes au service Engage. De cette manière, les développeurs partenaires peuvent mieux contrôler quand et comment publier du contenu auprès des utilisateurs. Cette approche évite de réactiver trop souvent l'application partenaire pour publier du contenu.

Les développeurs doivent-ils publier tous les types de clusters ?

Bien que, techniquement, les développeurs soient libres de ne publier qu'un seul cluster, nous conseillons vivement d'en inclure d'autres. Sinon, les développeurs passent à côté d'une occasion d'améliorer l'engagement des utilisateurs avec leur contenu. Nous vous recommandons fortement de publier tous les types de clusters pour chaque secteur.

À quelle fréquence le développeur partenaire doit-il publier des données à l'aide de WorkManager pendant l'exécution de l'application ?

Cette décision revient aux partenaires développeurs. Google recommande de publier une ou deux fois par jour pour les contenus de recommandation généraux, et d'utiliser une méthodologie basée sur les événements pour le panier, le réordonnancement et d'autres contenus de continuation (par exemple, démarrer le worker en tant que rappel de l'utilisateur qui ajoute des articles au panier ou qui arrête un film à mi-parcours). Pour les applications sociales, il est essentiel de publier des clusters de recommandations mis à jour après chaque utilisation de l'application. Les utilisateurs d'applications de réseaux sociaux sont plus intéressés par les recommandations les plus récentes et, dans l'idéal, ils aimeraient voir un post au maximum une fois.

Quand le développeur doit-il appeler les API de suppression ?

Les API de suppression ne doivent être appelées que lorsqu'il n'y a pas de contenu à publier. N'appelez pas des API de suppression et de publication ultérieurement pour remplacer le contenu. les API de publication suppriment automatiquement le contenu précédent.

Questions fréquentes sur les intents de diffusion

Pourquoi les développeurs d'applications Android doivent-ils s'enregistrer pour les intents de diffusion ?

Pour pouvoir présenter des contenus actuels à l'utilisateur, vous devez utiliser des intents de diffusion. Cela permet de déclencher une synchronisation des données dans les cas où les utilisateurs ne se serviraient pas souvent de l'application.

Exécution en arrière-plan non autorisée

Lors de l'enregistrement de l'intent de diffusion, vous pouvez rencontrer l'erreur suivante :

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

Vous devez enregistrer les broadcast receivers de manière dynamique.

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));
...

}

Questions fréquentes sur les workflows

Lors de l'intégration avec le SDK, vous pouvez rencontrer les erreurs suivantes :

Tester les liens profonds

Les liens profonds sont associés au nom du package. L'outil adb est un bon moyen de tester les liens profonds.

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

Comment calculer l'impact de l'intégration ?

Les liens profonds sont un excellent moyen de suivre l'attribution. Les URL des liens profonds qui redirigent les utilisateurs vers votre application peuvent être incluses avec d'autres paramètres de suivi. Exemple : "http://xx/deeplink?source_tag=engage".

Les développeurs peuvent ajouter leurs propres paramètres de suivi et fournir une attribution pour calculer l'impact.

Questions fréquentes sur Engage pour TV 2.0

Questions générales

Qu'est-ce que Continuer à regarder 2.0 ?

La fonctionnalité de lecture en cours 2.0 (API Video Discovery) fait passer l'expérience de reprise là où vous vous étiez arrêté au niveau supérieur. Il s'agit d'une amélioration importante qui permet aux spectateurs de reprendre facilement leur contenu sur un plus grand nombre d'appareils. Imaginez commencer un film sur votre Google TV, puis le poursuivre facilement sur votre téléphone pendant votre trajet domicile-travail. C'est la puissance de la fonctionnalité Continuer à regarder 2.0.

Ce nouveau système est conçu pour améliorer l'engagement et la fidélisation des spectateurs en offrant une expérience fluide et sans friction dans l'ensemble de l'écosystème Google.

Quels sont les avantages de la fonctionnalité de lecture en cours 2.0 ?

Réponse: La fonctionnalité de lecture 2.0 de la section "À regarder ensuite" permet aux spectateurs de reprendre là où ils s'étaient arrêtés sur vos contenus, quel que soit l'appareil qu'ils utilisent. Voici comment cela fonctionne:

• Expérience fluide sur Google: commencez à regarder un contenu sur votre Google TV, puis poursuivez sur votre téléphone Android, votre iPhone ou votre tablette Android. Il fonctionne même sur les appareils sur lesquels vous n'avez pas encore installé l'application.
• Engagement et fidélisation améliorés: la fonctionnalité Continuer à regarder 2.0 permet de ramener les utilisateurs sur votre application, même sur de nouveaux appareils. En permettant aux utilisateurs de reprendre leurs séries préférées, vous augmentez les chances qu'ils continuent à regarder.
• Couverture plus large: au-delà de Google TV, la fonctionnalité Continuer à regarder 2.0 fonctionne sur d'autres expériences multimédias Android, comme les cubes Play et d'autres applications multimédias Google.
• Compatibilité ascendante: si vous utilisez déjà l'ancienne fonctionnalité À regarder ensuite, pas de problème ! La fonctionnalité de lecture en cours 2.0 est rétrocompatible. Votre intégration existante continuera donc de fonctionner.

Remarque importante: Toutes les nouvelles intégrations de la fonctionnalité de lecture en cours doivent utiliser la version 2.0 de la fonctionnalité. L'ancien système "À regarder ensuite sur plusieurs appareils" est en cours d'abandon.

Quelles surfaces sont compatibles avec la fonctionnalité de lecture en cours 2.0 ?

1. Google TV
2. Android TV (sur l'appareil uniquement, mais compatible avec le SDK Engage)
3. Application mobile Google TV pour Android
4. Application mobile Google TV pour iOS
5. Cubes Play
6. Espace de divertissement Google
7. Appareils iOS (avec intégration de l'API REST)

Le SDK Engage est-il compatible avec la version 2.0 de la fonctionnalité de lecture en cours ?

Oui, le SDK Engage est destiné à la fonctionnalité Continuer à regarder 2.0. Il est obligatoire pour l'intégration à la fonctionnalité Continuer à regarder 2.0.

La fonctionnalité Continuer à regarder 2.0 est-elle disponible pour tous les utilisateurs ?

La fonctionnalité de lecture en cours 2.0 est déployée par phases.

• Accès anticipé: nous accordons d'abord l'accès à un groupe restreint de partenaires via un programme en accès anticipé (PAA).
• Élargissement de l'accès: nous mettons tout en œuvre pour que la fonctionnalité de lecture en cours 2.0 soit bientôt disponible pour tous les développeurs.

Pour assurer un lancement fluide et réussi, nous avons mis en place des mesures de protection pour gérer le déploiement. Cela implique à la fois une liste d'autorisation du côté de la fonctionnalité de lecture en cours 2.0 et une vérification distincte dans le SDK Engage. Que vous soyez un partenaire du programme en accès anticipé ou que vous souhaitiez le rejoindre prochainement, veuillez nous contacter afin que nous puissions configurer les autorisations d'accès avant que vous ne commenciez à intégrer le SDK Engage.

Existe-t-il une taille d'image recommandée que nous devrions fournir ?

Les exigences concernant les images ont été mises à jour dans la section Créer des entités.

Avec cette nouvelle documentation d'API, les données de la section "Continuer à regarder" seront-elles extraites par le serveur Google auprès du client et seront-elles reflétées sur tous les appareils ?

Cette nouvelle API présente des avantages importants pour la fonctionnalité de lecture en cours, par exemple:

• Expérience fluide sur tous les Google TV:les utilisateurs peuvent commencer à regarder un contenu sur un Google TV et le reprendre sur n'importe quel autre Google TV connecté avec le même compte. Cette fonctionnalité est également compatible avec les anciennes versions d'Android TV.

• Intégration à l'application mobile:la fonctionnalité Continuer à regarder est disponible dans l'application mobile Google TV pour Android et iOS, ce qui permet aux utilisateurs de passer facilement de leur téléviseur à leur appareil mobile.

• Amélioration de la fidélisation des utilisateurs:même sur les appareils sur lesquels l'application n'est pas installée ou où l'utilisateur n'est pas connecté, la fonctionnalité de lecture en cours invite les utilisateurs à réengager leur relation avec votre application, ce qui améliore la fidélisation.

• Extension à d'autres plates-formes:cette intégration étend la fonctionnalité de lecture en cours à d'autres plates-formes multimédias Google, comme Android, les cubes Play, les tablettes et d'autres applications et surfaces multimédias Google sur Android, ce qui maximise l'engagement des utilisateurs sur tous les appareils.

Quelle est la limite du nombre d'entités que je peux publier dans le cluster "Suite" ?

Chaque développeur partenaire est limité à cinq entités maximum dans le cluster "Suite". Cette limite garantit une répartition équitable des contenus sur la ligne "Continuer à regarder" sur Google TV, qui est un espace partagé par plusieurs fournisseurs de contenus multimédias.

Que se passe-t-il si j'essaie de publier plus de cinq entités ?

EngageSDK refusera votre demande de publication si elle dépasse la limite de cinq entités. Vous devez réduire le nombre d'entités dans votre requête pour que la publication aboutisse. Vous ne devez inclure que les entités où les utilisateurs ont arrêté de regarder. Dans la plupart des cas, il n'y en aura que quelques-unes. Si vous en avez plus de cinq, vous pouvez choisir les plus récentes à publier.

Pourquoi le nombre d'entités est-il limité ?

La ligne "Continuer à regarder" sur Google TV affiche les contenus de différents fournisseurs de contenus multimédias. Limiter le nombre d'entités par fournisseur garantit aux utilisateurs une sélection variée de contenus provenant de toutes leurs sources préférées, ce qui favorise une expérience utilisateur équitable et équilibrée.

Questions sur la validation de l'application

Dois-je tester mon application avec l'application de validation avant de l'envoyer ?

Oui, il est essentiel de tester votre application avec l'application de validation avant d'envoyer votre APK.

Nous comprenons que vous soyez confiant dans votre implémentation, mais l'intégration de la fonctionnalité de lecture en continu 2.0 comporte de nombreux composants complexes. L'application de validation sert de filet de sécurité, détectant les problèmes potentiels dès le départ et vous faisant gagner du temps et des efforts à long terme.

Il s'agit d'un contrôle rapide qui permet de garantir un lancement fluide et une expérience utilisateur de qualité.

En identifiant et en corrigeant les problèmes à l'avance, vous pouvez éviter les refus et les renvois.

Pour envoyer votre APK, vous devez inclure une capture d'écran montrant que votre application a réussi le processus de validation.

#### Quelles sont les erreurs courantes à éviter lors de l'intégration ?

L'application de validation est conçue pour détecter les problèmes potentiels liés à votre intégration de la fonctionnalité de lecture en continu 2.0. Voici quelques erreurs courantes que les développeurs rencontrent souvent:

Pour tous les types de contenus (films, épisodes de séries, diffusions en direct, extraits vidéo):

• Liens manquants: assurez-vous de fournir des URI (liens) spécifiques à la plate-forme valides pour votre contenu. Ces liens indiquent au système où trouver vos contenus sur chaque plate-forme.
• Titres manquants: n'oubliez pas d'inclure un titre pour tous vos contenus. Cela permet aux utilisateurs d'identifier ce qu'ils regardaient.
• Format des images: assurez-vous que toutes les images associées à votre contenu ont un format proche de 16:9. Vous vous assurez ainsi que vos images s'affichent correctement sur différents écrans.

Pour les épisodes de séries TV:

• Informations complètes sur l'épisode: veillez à inclure le titre de la série, le numéro de l'épisode et le numéro de la saison. Cela permet d'organiser les épisodes et de naviguer dans une série.
• Position de lecture exacte: vérifiez que la dernière position de lecture est inférieure ou égale à la durée totale de l'épisode. Cela garantit que les utilisateurs reprennent à partir du bon endroit.

Pour les films:

• Position de lecture exacte: comme pour les épisodes de série TV, assurez-vous que la dernière position de lecture est exacte.

Pour les vidéos diffusées en direct:

• Informations sur le diffuseur: indiquez le nom du diffuseur pour les diffusions en direct.

Pour les extraits vidéo:

• Informations sur le créateur: indiquez le créateur de l'extrait vidéo.

N'oubliez pas: l'application de vérification signalera ces problèmes, ce qui vous permettra de les résoudre avant d'envoyer votre application. Vous gagnerez ainsi du temps et vos utilisateurs bénéficieront d'une expérience plus fluide.

Questions sur le compte et le profil

Mon application utilise des connexions utilisateur anonymes. AccountProfile est-il toujours nécessaire pour la fonctionnalité de lecture en cours 2.0 ?

AccountProfile est conçu pour les applications qui utilisent des comptes utilisateur individuels. Toutefois, nous comprenons que certaines applications, comme la vôtre, peuvent s'appuyer sur des connexions anonymes. Voici comment fonctionne la fonctionnalité de lecture en cours 2.0 dans ce scénario:

• AccountProfile est techniquement obligatoire, mais vous pouvez toujours intégrer la fonctionnalité de lecture en cours 2.0, même si votre application ne dispose pas d'un système de compte utilisateur.
• Limité à l'utilisation sur l'appareil: les fonctionnalités multi-appareils de la fonctionnalité de lecture en continu 2.0 s'appuient sur l'identification des utilisateurs sur différents appareils. Étant donné que les connexions anonymes ne fournissent pas cette information, la fonctionnalité sera limitée à l'appareil actuel de l'utilisateur.
• Pour configurer cette fonctionnalité, vous devez désactiver la synchronisation entre les appareils. Cela garantit que les entrées "Continuer à regarder" ne s'affichent que sur l'appareil spécifique sur lequel le contenu a été lancé.

En résumé: Bien que vous puissiez intégrer la fonctionnalité de lecture en cours 2.0 aux connexions anonymes, les utilisateurs ne pourront reprendre le contenu que sur le même appareil.

Puis-je utiliser AccountProfile avec uniquement accountId et sans profileId, même si mon application est compatible avec les deux ?

Pour fonctionner correctement, AccountProfile nécessite à la fois accountId et profileId. Pourquoi ?

• Identification cohérente: accountId identifie l'utilisateur, tandis que profileId permet de distinguer les différents profils du compte de cet utilisateur (le cas échéant). En fournissant les deux, vous vous assurez que la fonctionnalité de lecture en cours suit et affiche précisément les contenus pour chaque profil.
• Prévention des erreurs: l'utilisation incohérente de accountId et de profileId dans différents appels d'API peut entraîner un comportement et des erreurs inattendus. Par exemple, si vous incluez les deux lorsque vous ajoutez du contenu à la section "À regarder plus tard", mais que vous n'utilisez que le compte lorsque vous supprimez du contenu, il est possible que le système ne puisse pas identifier et supprimer correctement les éléments souhaités.

Le profileId est-il obligatoire pour Continuer à regarder 2.0 ?

• Le champ accountId est obligatoire. Il permet d'identifier l'utilisateur sur tous les appareils.
• Le profileId est essentiel pour une bonne expérience utilisateur. Bien que techniquement facultatif, profileId est vivement recommandé si votre service accepte plusieurs profils (comme de nombreux services de streaming). Pourquoi est-ce si important ? En effet, sans profileId, la section "À regarder ensuite" peut afficher du contenu provenant d'autres profils du même compte. Cela peut entraîner une expérience déroutante et frustrante pour vos utilisateurs.
• En résumé: Fournir le profileId garantit que la section "Continuer à regarder" reflète précisément l'historique de visionnage de chaque utilisateur. Sauf si votre application n'est pas compatible avec le concept de profil dans un compte, vous devez le fournir.

Comment Google utilise-t-il le profileId de son côté ?

Si le service propose différents profils pour regarder des contenus, accountId et profileId sont utilisés pour associer le contenu regardé sur l'appareil au compte Google connecté sur l'appareil. Google enregistre les données de la fonctionnalité Continuer à regarder en fonction de la combinaison accountId-profileId. Tout appareil Google connecté au même compte Google recevra les dernières données mises à jour du ou des mêmes identifiants de compte et de profil associés, dans la ligne "Continuer à regarder".

L'association de comptes est-elle obligatoire pour implémenter la fonctionnalité de lecture en cours 2.0 ?

L'association de comptes n'est pas nécessaire. Elle est en cours de dépriorisation, et tous les cas d'utilisation associés seront couverts par la nouvelle API Device Entitlements.

Questions sur la synchronisation entre les appareils

Que signifie "synchronisation entre les appareils" lorsque les utilisateurs donnent leur consentement ?

Si l'utilisateur accepte la synchronisation entre les appareils, le contenu qu'il regarde est enregistré sur les serveurs Google TV, ce qui lui permet de reprendre là où il s'était arrêté sur n'importe quel appareil connecté. Sans autorisation, l'historique des vidéos regardées reste local sur l'appareil actuel.

Pouvons-nous définir la valeur "sync across devices" sur "false" ?

L'indicateur UserConsentToSyncAcrossDevices contrôle si les données de ContinuationCluster d'un utilisateur sont synchronisées sur ses appareils (téléviseur, téléphone, tablette, etc.).Si cet indicateur est défini sur "false", la lecture en continu ne se produit que sur le même appareil.

Pour exploiter pleinement notre fonctionnalité multi-appareil, nous vous recommandons vivement de demander le consentement de l'utilisateur et de définir SyncAcrossDevices sur "true" dans votre application.

Comment obtenir le consentement de l'utilisateur pour partager l'historique des vidéos regardées sur un appareil autre qu'Android

appareils ? Quels points de données sont partagés avec des serveurs tiers à partir d'appareils autres qu'Android ?

Le consentement est recueilli au niveau de l'utilisateur (profil ou compte). Une fois le consentement obtenu, les charges utiles de lecture en continu basées sur l'engagement peuvent être envoyées n'importe où afin que Google puisse refléter l'état de reprise de l'ubiquité des utilisateurs sur toutes les entités avec lesquelles ils ont un engagement partiel ou futur, sur n'importe quel appareil (sans avoir à demander à nouveau le consentement sur chaque appareil ou plate-forme). Les partenaires enverront le dernier état de la lecture en cours (selon les spécifications) associé à l'ID de profil (déposé sur Android).

Questions sur l'API REST

Existe-t-il une documentation sur l'API REST ?

La date d'arrivée prévue de l'API REST est mars 2025, comme indiqué dans la documentation destinée aux développeurs sur la fonctionnalité de lecture en cours 2.0.

Questions sur l'ancienne fonctionnalité "À regarder ensuite"

L'API Video Discovery remplace-t-elle l'API Watch Next ?

L'API Video Discovery sera rétrocompatible sur tous les appareils Android TV compatibles avec l'API Watch Next. Tous les développeurs doivent utiliser l'API Video Discovery (Continuer à regarder 2.0) pour publier des contenus dans la ligne "Continuer à regarder".

Questions sur les tests et l'intégration

Quelle est la différence entre LastPlaybackPositionTimeMillis et duration ?

LastPlayBackPositionTimeMillis doit refléter la durée de la lecture en millisecondes à l'endroit où l'utilisateur a cessé de regarder (par exemple, 605 000 ms pour 10 minutes et 5 secondes). Elle ne doit jamais être supérieure à la durée totale de l'entité.

LastEngagementTime correspond au code temporel de la dernière interaction de l'utilisateur avec le contenu.

Quels cas de test devons-nous effectuer ?

Vous trouverez ci-dessous les scénarios de test pour Google TV que notre équipe d'assurance qualité effectue. Des cas de test similaires peuvent également être effectués sur d'autres surfaces.

1. Regardez une vidéo de plus de 20 minutes pendant environ cinq minutes. Quittez l'application. La fiche vidéo doit s'afficher dans la ligne "Continuer à regarder". Remarque: Nous n'affichons que cinq cartes par application tierce dans la fiche Play Store.
2. Si vous sélectionnez la fiche qui vient d'apparaître dans la ligne "Continuer à regarder", la lecture de la vidéo doit reprendre au bon endroit. Remarque: Tout contenu nouveau ou ancien doit reprendre la lecture là où il s'était arrêté la dernière fois.
3. Le changement de compte sur l'appareil Google TV devrait modifier les cartes de la ligne "Continuer à regarder". Seules les vidéos du compte actuel devraient s'afficher. Triées par ordre récent. Le profil d'application tierce CW sera mélangé. Remarque: La notification de visionnage pour GoogleAccount2 affichera les contenus tiers que GoogleAccount2 a regardés.
4. Quitter l'application avec le bouton RETOUR > Vérifier que la fiche s'affiche dans la ligne "Continuer à regarder"
5. Masquer la vidéo dans la ligne "Continuer à regarder". Elle ne devrait plus s'afficher. Vérifiez si le contenu masqué reste masqué au-delà de 24 heures, même après l'ouverture de l'application. Vérifiez que le masquage d'un élément ne masque pas plusieurs éléments.
   1. Disponibilité du contenu dans "Continuer à regarder" avec des métadonnées complètes: image de la fiche, nom de l'application, titre, numéro de l'épisode de la saison pour les contenus TV
6. "Vérifier la progression" s'affiche dans la barre de progression
7. L'utilisateur a regardé le contenu jusqu'aux crédits de fin. Le contenu ne s'affiche pas dans "Continuer à regarder".
8. Vérifier qu'aucun élément non regardé ne s'affiche dans la ligne "Continuer à regarder"
9. Vérifiez que les éléments de la vue "Watch Time" sont organisés chronologiquement en fonction de l'heure à laquelle l'activité de visionnage a eu lieu, et non de la date et de l'heure à laquelle l'application a été ouverte pour la dernière fois.
10. Vérifier que les informations sur l'épisode et la saison sur la fiche The CW correspondent à ce qui a été regardé dans le contenu en épisodes
11. Vérifier que les éléments terminés (avec des crédits ou plus) ne s'affichent pas dans la section "Continuer à regarder"
12. Éteignez l'appareil à mi-chemin de l'épisode/du film/de la série. "Éteignez l'appareil à mi-chemin de la lecture de l'épisode/du film/de la série. Vérifiez que lorsque vous allumez l'appareil et un autre téléviseur, la carte CW s'affiche à la bonne position et avec la barre de progression appropriée."
13. Éteignez l'appareil après avoir regardé l'épisode 1 dans son intégralité, puis vérifiez les points suivants :
    1. L'épisode 1 disparaît et ne réapparaît pas dans la ligne "Continuer à regarder" [sur un deuxième appareil et à l'allumage de l'appareil de test]
    2. L'épisode 2 (le cas échéant) doit s'afficher dans la ligne "Continuer à regarder" [sur le deuxième appareil et à l'allumage de l'appareil de test]

14. Premier scénario: TV1: compte Google: maman, compte tiers / profil: compte 1/profil_1. Regarder des contenus et vérifier que les données CW affichent les contenus regardés par le compte tiers account_1/profile_1

    1. TV2: Compte Google: maman. Vérifiez les données CW du premier scénario. Connectez-vous maintenant à l'application tierce avec un autre compte. Compte / profil tiers : account_2 / profile_2. Regarder des contenus et vérifier que les données CW affichent les contenus regardés par le compte tiers account_2/profile_2

15. GoogleAccount: maman. Nouvelle coque d'appareil /application tierce non installée Sur un nouvel appareil(FDR de l'appareil), Verify CW affiche les données de la dernière application tierce utilisée par le compte Google. Remarque: La ligne CW ne doit pas afficher de contenus tiers si GAIA n'est pas encore associé à un profil tiers sur un autre appareil.

    1. GoogleAccount: maman. Nouvelle coque d'appareil /application tierce installée, mais pas de connexion. Sur un nouvel appareil(FDR de l'appareil), Verify CW affiche les données de la dernière application tierce utilisée par le compte Google.
    2. Remarque: Lorsque l'application est installée et connectée, l'état de la notification de consentement reflète l'utilisateur tiers actif connecté à l'application tierce.
    3. Remarque: La ligne "Continuer à regarder" ne doit pas afficher de contenus tiers si le compte Google n'est pas encore associé à un profil tiers.

L'option "Continuer à regarder" ne s'affiche pas dans l'application Google TV pour iOS. Pourquoi ?

Vous devez envoyer des liens profonds iOS pour que la section "Continuer à regarder" s'affiche sur les appareils iOS.

À quelle fréquence dois-je mettre à jour les informations de la section "À regarder ensuite" ? Dois-je mettre à jour fréquemment les informations de la section "À regarder ensuite", par exemple toutes les 15 secondes ?

Non, les mises à jour fréquentes ne sont pas recommandées. Pourquoi ?

• Impact sur les performances: l'envoi continu de mises à jour met une pression inutile sur nos serveurs, ce qui peut ralentir le système pour tous les utilisateurs.
• Données inutiles: lorsque l'utilisateur regarde activement un contenu, sa position de lecture change constamment. L'envoi de mises à jour toutes les quelques secondes crée de nombreuses données redondantes qui ne sont pas utiles pour reprendre la lecture.

Quand mettre à jour les informations de la section "À regarder ensuite" :

Concentrez-vous sur la capture des modifications significatives de la progression de l'utilisateur. Voici les principaux scénarios:

• Lecture mise en pause ou arrêtée: lorsqu'un utilisateur met la lecture en pause ou arrête de regarder, envoyez une mise à jour pour enregistrer sa position actuelle.
• Application fermée ou en arrière-plan: si un utilisateur quitte l'application ou passe à une autre application pendant qu'il regarde une vidéo, envoyez une mise à jour pour enregistrer sa progression.
• Lorsque l'utilisateur supprime un élément de la ligne "À regarder ensuite" dans l'application

Pour mettre à jour efficacement:

Au lieu de mises à jour programmées, utilisez des événements dans le lecteur vidéo ou le cycle de vie de l'application pour déclencher des mises à jour. Exemple :

• onPause, onStop: lorsque la lecture de la vidéo est mise en pause ou arrêtée.
• onAppClose, onAppBackgrounded: lorsque l'application se ferme ou passe en arrière-plan.

En suivant ces consignes, vous vous assurerez d'utiliser efficacement les ressources tout en offrant une expérience de lecture en cours fluide à vos utilisateurs.