Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Ad Manager sur le serveur de la communauté Google Advertising and Measurement.
Enregistrer et charger des favoris de flux d'annonces
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce guide explique comment intégrer les favoris à l'aide du SDK IMA DAI
lorsque vous utilisez l'insertion dynamique d'annonces pour les flux de vidéo à la demande.
Cela suppose que l'implémentation d'IMA DAI fonctionne correctement, comme celle présentée dans l'article
Premiers pas
Qu'est-ce que l'ajout de favoris ?
Les favoris permettent d'enregistrer un point spécifique, puis de revenir à ce dernier.
dans le flux de contenu. Supposons qu'un utilisateur regarde cinq minutes de contenu
quitte le flux vidéo, puis y retourne. L'ajout aux favoris
la position de l'utilisateur dans le flux pour que celui-ci puisse reprendre
pour offrir une expérience fluide à l'utilisateur.
Options avancées de l'ajout de favoris pour l'insertion dynamique d'annonces
Lorsque vous ajoutez un flux pour l'insertion dynamique d'annonce aux favoris, vous devez enregistrer l'ID et l'heure du flux.
lorsque l'utilisateur quitte la vidéo. Lorsque l'utilisateur revient, demandez à nouveau
et rechercher le temps gagné. Puisque chaque instance de la requête
peut comporter des coupures publicitaires de différentes durées. Il suffit d'enregistrer la diffusion.
l'heure ne fonctionnera pas. Ce que vous voulez vraiment faire, c'est continuer
date et heure du contenu.
Les méthodes de conversion à la rescousse
Le SDK IMA DAI fournit deux méthodes pour demander l'heure du contenu
pour une durée de diffusion donnée et la durée de diffusion d'un contenu donné
heure. À l'aide de ces méthodes de conversion, vous pouvez stocker les favoris
durée du contenu, puis recherchez la durée de la diffusion correspondante dans
la nouvelle instance du flux. Voici l'approche à adopter, avec un lien
à un exemple d'application qui montre une implémentation opérationnelle de la fonction d'ajout de favoris.
Enregistrement des favoris
Enregistrer un favori lorsque Activity est en pause.
Chargez le favori lors d'une nouvelle demande de flux. Cela fait partie de l'implémentation
l'interface VideoStreamPlayer.
publicvoidloadUrl(Stringurl,List<HashMap<String,String>>subtitles){//Setvideoplayer's stream URL and subtitles, and play the stream....//Bookmarking.if(bookmarkTime > 0){doublestreamTime=streamManager.getStreamTimeForContentTime(bookmarkTime);videoPlayer.seek((long)(streamTime*1000.0));//stoms.}}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/21 (UTC)."],[[["\u003cp\u003eThis guide explains how to implement bookmarking in video-on-demand (VOD) streams using the IMA DAI SDK for a seamless viewing experience.\u003c/p\u003e\n"],["\u003cp\u003eBookmarking involves saving the user's content time, not just stream time, to ensure accurate playback resumption.\u003c/p\u003e\n"],["\u003cp\u003eThe IMA DAI SDK provides methods to convert between stream time and content time for bookmarking purposes.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can save bookmarks when the activity is paused and load them when the stream is re-requested.\u003c/p\u003e\n"],["\u003cp\u003eA sample app demonstrating bookmarking implementation is available on GitHub.\u003c/p\u003e\n"]]],["Bookmarking in IMA DAI involves saving the user's position in a video stream for later continuation. Instead of recording the stream time, the key is to save the content time. When a user leaves, record the stream ID and convert the current stream time to content time using `getContentTimeForStreamTime()`. Upon return, re-request the stream and use `getStreamTimeForContentTime()` to find the corresponding stream time to seek to. Bookmarks are saved when the `Activity` pauses and loaded when re-requesting a stream.\n"],null,["# Save and load ad stream bookmarks\n\nThis guide shows how to implement bookmarking using the IMA DAI SDK\nwhen using Dynamic Ad Insertion (DAI) for video-on-demand (VOD) streams.\nThis assumes a working IMA DAI implementation, such as the one presented in\n\n\n[Get Started](/interactive-media-ads/docs/sdks/android/dai-quickstart).\n\n\nWhat is bookmarking?\n--------------------\n\nBookmarking is the ability to save and then return to a specific point\nin the content stream. Suppose a user watches five minutes of content,\nleaves the video stream, and then returns to it. Bookmarking saves the\nuser's position in the stream so the stream can pick up from where it\nleft off, providing a seamless experience to the viewer.\n\nDAI bookmarking under the hood\n------------------------------\n\nWhen bookmarking a DAI stream, you must record the stream id and time\nwhen the user leaves the video. When the user returns, re-request the\nstream and seek to the saved time. Since each instance of the requested\nstream can have ad breaks of different durations simply saving the stream\ntime won't work. What you really want to do is continue from the same\n**content time**.\n\nConversion methods to the rescue\n--------------------------------\n\nThe IMA DAI SDK provides a pair of methods to request the **content time**\nfor a given **stream time** and the **stream time** for a given **content\ntime** . Using these conversion methods you can store the bookmarked\n**content time** and then seek to the corresponding **stream time** in\nthe new instance of the stream. Here's the approach, including a link\nto a sample app that shows a working bookmarking implementation.\n\nSaving bookmarks\n----------------\n\nSave a bookmark when the `Activity` is paused. \n\n private double bookmarkTime;\n @Override\n public void onPause() {\n super.onPause();\n double streamTime = videoPlayer.getCurrentPosition() / 1000.0; // ms to s.\n bookmarkTime = streamManager.getContentTimeForStreamTime(streamTime);\n }\n\nLoading bookmarks\n-----------------\n\nLoad the bookmark when re-requesting a stream. It's part of implementing\nthe `VideoStreamPlayer` interface. \n\n public void loadUrl(String url, List\u003cHashMap\u003cString, String\u003e\u003e subtitles) {\n // Set video player's stream URL and subtitles, and play the stream.\n ...\n\n // Bookmarking.\n if (bookmarkTime \u003e 0) {\n double streamTime =\n streamManager.getStreamTimeForContentTime(bookmarkTime);\n videoPlayer.seek((long) (streamTime * 1000.0)); // s to ms.\n }\n }\n\nSample app\n----------\n\n[Download the Sample app](//github.com/googleads/googleads-ima-android-dai)\nto see a bookmarking implementation."]]