Utiliser des éléments dynamiques dans les superpositions interactives

Sommaire de l'article :

• Introduction aux Éléments dynamiques
• Se lancer avec les éléments dynamiques
• Lier votre API aux éléments de votre superposition
• Conseils et astuces pour utiliser des éléments dynamiques

Introduction aux Éléments dynamiques

Éléments dynamiques est une fonctionnalité disponible dans le panneau des superpositions interactives qui permet d'extraire du contenu de n'importe quelle API ouverte et de l'intégrer dans la superposition. Les éléments dynamiques peuvent également être liés à des URL cliquables dans les actions des éléments.

Tous les éléments permettront aux utilisateurs d'ajouter leur propre contenu et de le mélanger avec du contenu/des actions provenant de l'API. Vous pouvez intégrer un point de terminaison API ouvert et attribuer immédiatement des valeurs à différents éléments de superposition dans votre superposition.

L'utilisation des éléments dynamiques présente certains avantages :

• L'intégration de contenu dynamique dans vos superpositions vous permet de vous intégrer plus profondément et de vous connecter plus complètement à vos systèmes existants qui gèrent vos données, vos produits, vos informations, etc. 
• Mettre en place une ressource vidéo plus connectée
• Toujours présenter à votre public les données et informations les plus précises et les plus récentes disponibles
• Ajouter à vos superpositions des données pertinentes en temps réel provenant d'une série de sources
• Faire évoluer votre production de vidéos interactives et gagner un temps fou par rapport à une mise à jour manuelle de vos données et de votre contenu.

Se lancer avec les éléments dynamiques

Pour utiliser les éléments dynamiques, vous avez besoin de deux choses :

1. Une API REST ouverte renvoyant du JSON
2. Une vidéo interactive qui utilise des superpositions

Une fois que vous les avez, accédez à l'éditeur de superposition. Le bouton Éléments dynamiques se trouve en haut de la page.

En cliquant dessus, vous ouvrirez le gestionnaire d'API où vous pourrez ajouter, modifier et supprimer les API associées à votre vidéo interactive. 

Pour ajouter une API :

1. Cliquez sur le bouton Éléments dynamiques. La fenêtre modale suivante s'ouvre :
   
   
2. Donnez un nom à votre API
3. Saisissez l'URL de votre API dans le champ URL de l'API
4. Cliquez sur le bouton + Ajouter une API pour ajouter l'API à votre vidéo. 

Vous pouvez ajouter plusieurs API à votre vidéo ou, si votre API le prend en charge, filtrer les réponses de l'API en ajoutant des URL d'API filtrées.

Lier votre API aux éléments de votre superposition

Pour connecter un élément de superposition à des données dynamiques provenant de votre API :

1. Ajoutez un nouvel élément ou sélectionnez un élément existant de votre design de superposition. Dans l'exemple ci-dessous, un élément de texte a été sélectionné.
2. Dans le menu de droite, sous la section « Élément dynamique », activez l'option Lien vers l'API pour afficher les paramètres de l'élément dynamique pour cet élément.
3. Sélectionnez l'API avec laquelle vous souhaitez associer votre élément dans le menu déroulant de l'API.
4. Une fois que vous avez sélectionné une API, cliquez sur + Ajouter des données dynamiques.
   
   
5. Cette opération ouvrira la fenêtre modale « Sélectionner une réponse ». Vous pouvez voir ici la réponse complète de l'API appelée à partir de l'URL que vous avez saisie. Utilisez les flèches pour afficher les valeurs de chacun des éléments.
   
   
6. Sélectionnez la réponse de la sortie API en cliquant sur le champ requis directement dans la réponse, puis cliquez sur Confirmer. 
7. Dans le cas de la fonctionnalité Élément dynamique pour le texte, vous verrez le raccourci de code généré dans le conteneur de texte en mode édition. Remarque : Sur les éléments qui sont associés à une API, vous verrez le symbole des éléments dynamiques affiché à côté de la boîte de sélection.
   
   
8. Dès que vous quittez le mode d'édition de l'élément de texte, la réponse s'enrichit des données actuelles de la valeur API sélectionnée.

Conseils et astuces pour utiliser des éléments dynamiques

• Si vous n'avez pas d'API ou si vous avez besoin d'une API pour une tâche spécifique que votre API actuelle ne prend pas en charge, tournez-vous vers des outils tels que Sheetlabs, qui peuvent transformer n'importe quelle feuille de calcul en API.
• La fonctionnalité de paramétrage personnalisé des éléments dynamiques est utile pour personnaliser les requêtes API. Actuellement, les éléments dynamiques ne prennent en charge que les API publiques. Pour des raisons de sécurité, veuillez éviter d'utiliser la fonctionnalité de paramètres personnalisés pour ajouter des clés d'API.