generate_long

Description

Point de terminaison generate_long

Le point de terminaison generate_long permet aux lecteurs de récupérer des listes de lecture hors ligne disponibles jusqu'à 14 jours, contre 48 heures pour le point de terminaison generate. Ceci est utile au cas où un lecteur subit une panne prolongée.

Une fois la liste de lecture generate_long expirée, elle reviendra au contenu de remplissage.

Note : Tous les horodatages inclus dans les listes de lecture utiliseront le fuseau horaire configuré dans Broadsign Control Administrator pour les unités d'affichage associées. Il est essentiel de s'assurer que le bon fuseau horaire est configuré. Si aucun fuseau horaire n'est configuré, le serveur utilisera par défaut GMT+0 pour la date de début et de fin des campagnes, des horaires et des heures d'ouverture sous cette unité d'affichage. Différentes unités d'affichage peuvent être configurées sur des fuseaux horaires différents si nécessaire. Pour plus d'informations, consultez Timezone.

Fonctionnalités

  • Récupération de listes de lecture hors ligne : les lecteurs peuvent récupérer des listes de lecture hors ligne disponibles jusqu'à 14 jours. La valeur par défaut pour les domaines est de 14 jours, mais elle peut être réduite pour gérer l'espace disque en contactant Broadsign Services.
  • Lecture synchronisée : les lecteurs avec plusieurs écrans doivent récupérer les mêmes playlists. Si plusieurs lecteurs souhaitent utiliser la même playlist, ils doivent la récupérer avec le même player_id, mais avec un screen_id différent.
  • Prise en charge des cadres : le point de terminaison prend en charge jusqu'à 3 cadres pour l'affichage du contenu. Pour configurer plus d'un cadre, contactez Broadsign Services.
  • Conditions planifiées : le point de terminaison vous permet de définir quand une condition doit être activée ou désactivée sur toutes les unités d'affichage associées. Voir L'onglet «Condition Schedule».

Limites

  • Contenu programmatique : le contenu programmatique ne peut pas être récupéré à partir de listes de lecture hors ligne. N'importe quel créneau Broadsign Reach sera remplacé directement par du contenu préemptif, s'il est disponible. Utilisez les appels generate en ligne pour obtenir du contenu programmatique.
  • Synchronisation non garantie : la synchronisation entre les lecteurs n'est pas garantie entre les listes de lecture régulières et hors ligne. Lorsqu'un seul lecteur dispose de plusieurs écrans, il est recommandé de mettre en œuvre un mécanisme de synchronisation pour garantir la transition simultanée des listes de lecture normales vers les listes de lecture hors ligne. Le non-respect de cette consigne peut entraîner un enregistrement incomplet de la preuve de diffusion, en fonction du seuil.
  • Modifications de partie de la journée : le point de terminaison ne prend pas en charge les listes de lecture avec des éléments qui doivent être lus lors d'un changement de partie de la journée si la disposition du cadre est différente dans chaque partie de la journée.
  • Synchronisation entre lecteurs : le point de terminaison ne prend pas en charge la synchronisation entre lecteurs.

Voir aussi :

Point de terminaison

https://air.broadsign.com/playlist/v2/generate_long

Méthode HTTP

POST

Paramètres du corps de la requête

Paramètre Description Type Obligatoire (O) ou facultatif (F)
player_identifier

Un identifiant Custom Unique ID défini par l'utilisateur au sein du système Broadsign Control Player. Il est destiné à représenter de manière unique un seul emplacement physique ou lieu où le lecteur est déployé.

 string O
screen_identifier

Identifie de manière unique les écrans individuels d'un lieu qui sont connectés au même Broadsign Control Player. C'est une valeur opaque fournie par le client.

Le screen_identifier permet de suivre avec précision le nombre d'écrans qui ont confirmé la lecture du contenu, ce qui est crucial pour fournir une preuve de lecture précise dans Broadsign Air.

Conseil : L'utilisation d'identifiants d'écran clairs et cohérents est essentielle pour générer des rapports de preuve de diffusion précis dans Broadsign Air.

Le même screen_identifier (par exemple, « screen-00 », « screen-01 ») peut être utilisé dans plusieurs lieux, c'est-à-dire qu'il peut être réutilisé dans différents player_identifiers.

Ce champ n'est pas obligatoire mais est fortement recommandé pour un suivi précis de la lecture.

Pour plus d'informations, voir Signaler les POP des lecteurs avec Broadsign Air.

 string F
date

Date pour laquelle la playlist est demandée. Le format est:

"date": { "year": "[year]", "month": "[month]", "day": "[day]" }

Par exemple: "date": { "year": "2024", "month": "10", "day": "20" }

 JSON O
force

L'activation de cette option entraînera les effets suivants :

  • Broadsign Air fera immédiatement une interrogation, peu importe quand la dernière interrogation a eu lieu.
  • Broadsign Air supprime la playlist stockée et force une régénération.

Lorsque cette option est activée, vous pouvez interroger jusqu'à 6 fois par heure. Après cela, Broadsign Air envoie un message d'erreur 429 Too Many Requests.

Note : Ce paramètre est conçu à des fins de développement ou de débogage. Il ne doit pas être activé dans un environnement de production en direct.

 boolean F

Réponse

Se référer à Réponse pour des informations complètes sur les paramètres de Réponse de Broadsign Air.