content

Description

Point de terminaison content

Le point de terminaison content est utilisé pour pré-mettre en cache les créations publicitaires pour jusqu'à 48 heures dans Broadsign Air.

Le point de terminaison content contient également du contenu de remplissage dans la liste contents et dispose d'une liste de « remplissage » avec leurs attributs pertinents. Pour plus d'informations, voir Contenu de remplissage (Broadsign Air).

Point de terminaison

https://air.broadsign.com/playlist/v1/content

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

Note : Utilisez la même version du point de terminaison content que les autres points de terminaison. Par exemple, si vous utilisez generate v2, alors utilisez content v2.

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
duration

Durée, en secondes, couverte par la Playlist générée. La valeur par défaut est 1 heure (3 600 secondes). La valeur maximale prise en charge est de 48 heures (172 800 secondes).

Par exemple, si la durée est d'une heure, la playlist renvoyée couvrira l'heure suivante. La durée totale des articles retournés peut être plus courte que la durée couverte, par exemple s'il y a des moments où rien n'est prévu à jouer.

Voir api.proto pour une définition.

 google.protobuf.Duration F
exclude_programmatic_precaching_info

Active ou désactive la pré-mise en cache de Broadsign Reach.

Si défini sur True, ne renvoie aucune information sur le contenu Broadsign Reach.

Ne pas définir ce paramètre ou le définir sur False renverra toutes les créations publicitaires Broadsign Reach approuvées.

 bool F