Questions fréquentes sur le SDK Engage

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 les partenaires développeurs doivent-ils 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 du contenu de recommandation générale une ou deux fois par jour, et d'utiliser une méthodologie axée sur les événements pour le contenu lié au panier, à la réorganisation et à la poursuite (par exemple, démarrer le worker en tant que rappel lorsque l'utilisateur ajoute des articles au panier ou 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 sociales sont plus intéressés par les recommandations les plus récentes et préfèrent idéalement ne voir un post qu'une seule 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.

Impossible de tester l'intent de diffusion

L'application de validation n'est pas compatible avec le test de l'intent de diffusion avec autorisation. Vous devez supprimer les autorisations pendant les tests et les ajouter de nouveau avant de passer à la version de production du SDK à l'étape 6.

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,
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null));
...

}

Questions fréquentes sur les workflows

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

Erreurs de validation au niveau de l'application, du cluster et de l'entité

Les récapitulatifs au niveau de l'application, du cluster et de l'entité affichent le nombre d'erreurs de validation. Ces erreurs correspondent à des champs obligatoires manquants ou à des valeurs non valides fournies. Les messages d'erreur s'affichent en rouge sous chaque champ concerné. Corrigez toutes les erreurs de validation et vérifiez l'exactitude avant de partager l'APK.

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>

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é "Reprendre la lecture" 2.0 (API Video Discovery) améliore l'expérience "Reprendre la lecture là où vous vous étiez arrêté". Il s'agit d'une amélioration significative 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 continuer sans effort sur votre téléphone pendant votre trajet : c'est tout le potentiel de la fonctionnalité Continuer à regarder 2.0.

Ce nouveau système est conçu pour stimuler 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é Continuer à regarder 2.0 ?

Réponse : La fonctionnalité Reprendre la lecture 2.0 permet aux spectateurs de reprendre plus facilement la lecture de vos contenus là où ils l'ont laissée, 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 et continuez-le facilement 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 accrus : la fonctionnalité Reprendre la lecture 2.0 permet de ramener les utilisateurs vers 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 à les regarder.
  • Une couverture plus large : en plus de Google TV, la fonctionnalité "Continuer à regarder 2.0" fonctionne avec d'autres expériences multimédias Android, comme les Play Cubes et d'autres applications multimédias Google.
  • Rétrocompatibilité : si vous utilisez déjà l'ancienne fonctionnalité À suivre, pas de problème. La fonctionnalité Reprendre la lecture 2.0 est rétrocompatible. Votre intégration existante continuera donc de fonctionner.

Important : Toutes les nouvelles intégrations "Reprendre la lecture" doivent utiliser "Reprendre la lecture 2.0". L'ancien système "Ma sélection inter-appareils" est en cours d'abandon.

Quelles sont les surfaces compatibles avec la fonctionnalité Continuer à regarder 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. Google Entertainment Space
  7. Appareils iOS (avec intégration de l'API REST)

Le SDK Engage est-il destiné à la fonctionnalité Continuer à regarder 2.0 ?

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

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

La fonctionnalité Continuer à regarder 2.0 est déployée par phases.

  • Accès anticipé : nous accordons initialement l'accès à un groupe restreint de partenaires via un programme d'accès anticipé (PAA).
  • Élargissement de l'accès : nous mettons tout en œuvre pour rendre la fonctionnalité "Reprendre la lecture" 2.0 disponible pour tous les développeurs prochainement.

Pour 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é Reprendre la lecture 2.0 et une vérification distincte dans le SDK Engage. Que vous soyez un partenaire du programme d'accès anticipé ou que vous souhaitiez bientôt le devenir, veuillez nous contacter afin que nous puissions configurer les autorisations d'accès avant que vous ne commenciez l'intégration du SDK Engage.

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

Avec cette nouvelle documentation sur l'API, les données "Reprendre la lecture" extraites par le serveur Google du client seront-elles reflétées sur tous les appareils ?

Cette nouvelle API présente des avantages majeurs pour la fonctionnalité Reprendre la lecture :

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

  • Intégration de 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 à leurs appareils mobiles.

  • Fidélisation améliorée des utilisateurs : même sur les appareils sur lesquels l'application n'est pas installée ou sur lesquels l'utilisateur n'est pas connecté, la fonctionnalité Reprendre la lecture incite les utilisateurs à réutiliser votre application, ce qui améliore la fidélisation.

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

Quel est le nombre maximal d'entités que je peux publier dans le cluster "Continuation" ?

Chaque développeur partenaire est limité à un maximum de cinq entités dans le cluster "Suite". Cette limite permet de distribuer équitablement les contenus dans 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 rejettera votre demande de publication si elle dépasse la limite de cinq entités. Pour publier votre demande, vous devez réduire le nombre d'entités. Vous ne devez inclure que les entités que les utilisateurs ont commencé à regarder. Dans la plupart des cas, il n'y en aura que quelques-unes. Si vous avez plus de cinq entités de ce type, vous pouvez choisir de publier les plus récentes.

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

La ligne "Continuer à regarder" sur Google TV affiche des contenus provenant de différents fournisseurs de contenus multimédias. Limiter le nombre d'entités par fournisseur afin que les utilisateurs voient 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 l'application de validation

Dois-je obligatoirement 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 fichier APK.

Nous comprenons que vous puissiez avoir confiance en votre implémentation, mais l'intégration de la fonctionnalité Reprendre la lecture 2.0 comporte de nombreux composants complexes. L'application de validation agit comme un filet de sécurité, en détectant les problèmes potentiels dès le début et en vous faisant gagner du temps et de l'énergie à long terme.

Considérez-la comme un examen rapide qui vous aidera à garantir un lancement fluide et une expérience utilisateur optimale.

En identifiant et en résolvant les problèmes à l'avance, vous pouvez éviter la frustration liée aux refus et aux renvois.

Pour envoyer votre fichier 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é Reprendre la lecture 2.0. Voici quelques erreurs courantes que les développeurs rencontrent souvent :

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

  • Liens manquants : assurez-vous de fournir des URI (liens) valides spécifiques à la plate-forme pour votre contenu. Ces liens indiquent au système où trouver vos contenus sur chaque plate-forme.
  • Titres manquants : n'oubliez pas d'inclure des titres pour tous vos contenus. Cela aide les utilisateurs à identifier ce qu'ils regardaient.
  • Proportions des images : vérifiez que toutes les images associées à votre contenu ont des proportions proches de 16:9. Cela permet de s'assurer 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 aux utilisateurs de naviguer dans une série.
  • Position de lecture précise : vérifiez que la dernière position de lecture est inférieure ou égale à la durée totale de l'épisode. Cela permet aux utilisateurs de reprendre la lecture au bon endroit.

Pour les films :

  • Position de lecture précise : comme pour les épisodes TV, vérifiez que la dernière position de lecture est précise.

Pour les vidéos diffusées en direct :

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

Pour les clips vidéo :

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

N'oubliez pas que l'application de validation signalera ces problèmes, ce qui vous permettra de les résoudre avant d'envoyer votre application. Vous gagnerez ainsi du temps et offrirez une expérience plus fluide à vos utilisateurs.

Questions sur le compte et le profil

Mon application utilise des identifiants de connexion anonymes. Le champ AccountProfile est-il toujours requis pour Continuer à regarder 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 identifiants anonymes. Voici comment fonctionne la fonctionnalité Continuer à regarder 2.0 dans ce scénario :

  • AccountProfile est techniquement requis, mais vous pouvez toujours intégrer la fonctionnalité Reprendre la lecture 2.0 même si votre application ne dispose pas d'un système de compte utilisateur.
  • Limitation à l'utilisation sur l'appareil : les fonctionnalités multi-appareils de la fonctionnalité Reprendre la lecture 2.0 reposent sur l'identification des utilisateurs sur différents appareils. Étant donné que les connexions anonymes ne fournissent pas ces informations, la fonctionnalité sera limitée à l'appareil actuel de l'utilisateur.
  • Comment configurer : pour configurer cette fonctionnalité, vous devez désactiver la synchronisation multi-appareils. Cela permet de s'assurer que les entrées "Continuer à regarder" n'apparaissent que sur l'appareil spécifique sur lequel le contenu a été lancé.

En résumé : Vous pouvez intégrer Continuer la lecture 2.0 avec des identifiants anonymes, mais les utilisateurs ne pourront reprendre la lecture de contenus que sur le même appareil.

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

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

  • Identification cohérente : accountId identifie l'utilisateur, tandis que profileId fait la distinction entre les différents profils du compte de cet utilisateur (le cas échéant). En fournissant les deux, vous vous assurez que la section "Reprendre la lecture" suit et affiche correctement le contenu de chaque profil individuel.
  • Éviter les erreurs : l'utilisation incohérente des accountId et profileId dans différents appels d'API peut entraîner des comportements inattendus et des erreurs. Par exemple, si vous incluez les deux lors de l'ajout de contenu à "Reprendre la lecture", mais que vous n'utilisez que accountId lors de la suppression de contenu, il est possible que le système ne puisse pas identifier et supprimer correctement les éléments souhaités.

L'ID de profil est-il requis pour Continuer à regarder 2.0 ?

  • accountId est obligatoire. Cela permet d'identifier l'utilisateur sur tous les appareils.
  • L'ID de profil est essentiel pour une bonne expérience utilisateur. Bien que techniquement facultatif, profileId est fortement recommandé si votre service accepte plusieurs profils (comme de nombreux services de streaming). Pourquoi est-ce si important ? En effet, sans profileId, la section "Reprendre la lecture" 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 bref : fournir un profileId permet de s'assurer que la section "Continuer à regarder" reflète précisément l'historique des vidéos regardées de chaque utilisateur. Vous devez fournir un profil dans un compte, sauf si votre application n'est pas compatible avec ce concept.

Comment Google utilise-t-il l'ID de profil de son côté ?

Si le service propose différents profils pour regarder des contenus, accountId et profileId seront utilisés pour associer les contenus regardés sur l'appareil au compte Google connecté sur l'appareil. Google enregistre les données ContinueWatching en fonction de la combinaison accountId-profileId. Tout appareil Google sur lequel ce même compte Google est connecté recevra les dernières données mises à jour des mêmes accountId-profileId associés dans sa ligne "Reprendre la lecture".

L'association de compte est-elle requise pour implémenter la fonctionnalité Continuer la lecture 2.0 ?

L'association de compte 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

Avec le consentement de l'utilisateur pour la synchronisation sur plusieurs appareils, le contenu qu'il regarde sera enregistré sur les serveurs Google TV, ce qui lui permettra de reprendre facilement la lecture là où il l'avait laissée sur n'importe quel appareil connecté. Sans consentement, leur historique des vidéos regardées reste local sur l'appareil actuel.

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

L'indicateur UserConsentToSyncAcrossDevices contrôle si les données 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 fonctionnalité "Reprendre la lecture" ne fonctionne que sur le même appareil.

Pour profiter pleinement de notre fonctionnalité multi-appareil, nous vous conseillons vivement d'obtenir le consentement de l'utilisateur et de définir SyncAcrossDevices sur "true".

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

Le consentement est recueilli au niveau de l'utilisateur (au niveau du profil ou du compte). Une fois le consentement obtenu, les charges utiles "Reprendre la lecture" 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 suivant, sur n'importe quel appareil (sans avoir à redemander le consentement sur chaque appareil ou plate-forme). Les partenaires enverront le dernier état de la fonctionnalité Continuer à regarder (conformément aux 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 ?

L'API REST devrait être disponible en mars 2025. Vous trouverez plus d'informations dans la documentation pour les développeurs Continuer à regarder 2.0.

Anciennes questions "Ma sélection"

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 la durée ?

LastPlayBackPositionTimeMillis doit refléter la durée de lecture en millisecondes à laquelle l'utilisateur a arrêté de regarder la vidéo (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 à l'horodatage de la dernière interaction de l'utilisateur avec le contenu.

Quels cas de test devons-nous effectuer ?

Vous trouverez ci-dessous des scénarios de test pour Google TV que notre équipe QA 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 5 minutes. Quittez l'application. La carte vidéo doit s'afficher dans la ligne "Reprendre la lecture". Remarque : Nous n'affichons que cinq cartes par application tierce dans CW.
  2. Si vous sélectionnez la nouvelle fiche dans la ligne "Reprendre la lecture", la lecture de la vidéo doit reprendre au bon endroit. Remarque : Tout contenu nouveau ou ancien doit reprendre la lecture là où elle s'était arrêtée.
  3. Lorsque vous changez de compte sur l'appareil GTV, les cartes de la ligne "Reprendre la lecture" doivent changer. Seules les vidéos du compte actuel doivent s'afficher. Triée par ordre chronologique inverse. Les profils d'applications tierces seront mélangés. Remarque : La CW pour GoogleAccount2 affichera les contenus tiers que GoogleAccount2 a regardés.
  4. Quittez l'application à l'aide du bouton RETOUR > Vérifiez que la carte s'affiche dans la ligne "Reprendre la lecture".
  5. Masquez la vidéo dans la ligne "Reprendre la lecture". Elle ne devrait plus s'afficher. Testez si le contenu masqué reste masqué au-delà de 24 heures et même après l'ouverture de l'application après 24 heures. Vérifiez que le masquage d'un élément n'entraîne pas le masquage de plusieurs éléments.
  6. 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 et de la saison pour les contenus TV
  7. L'option "Vérifier la progression" s'affiche dans la barre de progression.
  8. L'utilisateur a regardé le contenu jusqu'à la fin du générique, mais il ne s'affiche pas dans "Reprendre la lecture".
  9. Vérifiez qu'aucun élément non regardé ne s'affiche dans la ligne "Reprendre la lecture".
  10. Vérifiez que les éléments de la section "Avertissement de contenu" sont classés par ordre chronologique en fonction de la date de l'activité de visionnage, et non de la date de la dernière ouverture de l'application ou du dernier jour.
  11. Vérifiez que les informations sur l'épisode et la saison sur la fiche CW correspondent à ce qui a été regardé dans le contenu épisodique.
  12. Les éléments marqués comme terminés (avec des crédits ou plus) ne s'affichent pas dans "Reprendre la lecture"
  13. Éteignez l'appareil à mi-parcours de l'épisode, du film ou de la série. "Éteignez l'appareil à mi-parcours de l'épisode/du film/de la série. Vérifiez que, lorsque vous allumez l'appareil et sur un autre téléviseur, CW affiche la bonne carte, à la bonne position et avec la bonne barre de progression."
  14. Éteignez l'appareil après avoir regardé l'épisode 1 en entier, puis vérifiez
  15. L'épisode 1 disparaît de la ligne "Continuer à regarder" [sur le deuxième appareil et lorsque l'appareil de test est allumé]
    1. L'épisode 2 (s'il est disponible) doit apparaître dans la ligne "Reprendre la lecture" [sur le deuxième appareil et lorsque l'appareil de test est allumé].
  16. Premier scénario : TV1 : compte Google : maman, compte / profil tiers : compte 1/profil_1. Regarder du contenu et vérifier que les données de la chaîne de télévision affichent le contenu regardé par le compte tiers account_1/profile_1
  17. TV2: GoogleAccount: mom. 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 du contenu et vérifier que les données de l'historique des visionnages affichent le contenu regardé par le compte tiers account_2/profile_2

  18. GoogleAccount: mom. La nouvelle coque de l'appareil ou l'application tierce ne sont pas installées. Sur un nouvel appareil(FDR 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 contenu tiers si le compte GAIA n'est pas encore associé à un profil tiers sur un autre appareil.

    1. GoogleAccount: mom. Nouvelle coque /application tierce installée, mais non connectée. Sur un nouvel appareil(après réinitialisation), Verify CW affiche les données de la dernière application tierce utilisée par le compte Google.
    1. Remarque : La ligne "Continuer à regarder" ne doit pas afficher de contenus tiers si le compte Google n'est pas encore associé à un profil tiers.

Nous ne voyons pas l'option "Continuer à regarder" dans l'application Google TV pour iOS. Pourquoi ?

Vous devrez envoyer des liens profonds iOS pour que la section "Reprendre la lecture" s'affiche sur les appareils iOS.

À quelle fréquence dois-je mettre à jour les informations de la section "Reprendre la lecture" ? Dois-je mettre à jour fréquemment les informations "Reprendre la lecture", 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 exerce une pression inutile sur nos serveurs, ce qui peut ralentir le système pour tout le monde.
  • Données inutiles : la position de lecture d'un utilisateur change constamment lorsqu'il regarde une vidéo. L'envoi de mises à jour toutes les quelques secondes crée une grande quantité de données redondantes qui ne sont pas utiles pour reprendre la lecture.

Quand mettre à jour les informations de la section "Reprendre la lecture" :

Concentrez-vous sur la capture des changements significatifs dans la progression de visionnage de l'utilisateur. Voici les principaux scénarios :

  • Lecture mise en pause ou arrêtée : lorsqu'un utilisateur met en pause ou arrête la lecture, envoyez une mise à jour pour enregistrer sa position actuelle.
  • L'application est fermée ou mise 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.
  • Lorsqu'un utilisateur supprime un élément de la ligne "Reprendre la lecture" dans l'application

Comment mettre à jour efficacement :

Au lieu d'utiliser des mises à jour programmées, utilisez des événements dans votre lecteur vidéo ou le cycle de vie de votre 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 utiliserez efficacement les ressources tout en offrant à vos utilisateurs une expérience fluide de la fonctionnalité Reprendre la lecture.