Action de capture de données
L'action Capture de données capture les données définissables par l'utilisateur à partir d'applications de signes/kiosque interactives.
Par exemple, vous pouvez associer des noms, des adresses, des numéros de téléphone ou des adresses e-mail à la campagne diffusant le contenu interactif.
Note : Dans tous les exemples inclus sur cette page, le champ de données est une série de paires clé-valeur définissables par l'utilisateur. Le format est codé en pourcentage.
En utilisant remote_action, les paires sont séparées par une esperluette (« & »); en utilisant XML ou JSON, les paires sont séparées par l'entité HTML d'une esperluette (« & »).
Les clés et les valeurs sont séparées par un signe égal (« = »).
Avec cette action, les bornes interactives auront la capacité de fournir une interface via du contenu dynamique tel que HTML5 pour demander la saisie de données aux utilisateurs finaux. Toutes les données sont ensuite transmises localement à Broadsign Control Player via l'action de capture de données et associée à la campagne correspondante. Les données collectées sont transmises à Broadsign Server afin que chaque campagne interactive puisse signaler ses données capturées dans le rapport de données de campagne.
Avec cette action, les bornes interactives auront la capacité de fournir une interface via du contenu dynamique tel que HTML5 pour demander la saisie de données aux utilisateurs finaux. Toutes les données sont ensuite transmises localement à Broadsign Control Player via l'action de capture de données et associée à la campagne correspondante. Les données collectées sont transmises à Broadsign Server afin que chaque campagne interactive puisse signaler ses données capturées dans le rapport de données de campagne.
Appelez l’action de capture de données en utilisant l’une des options suivantes :
Serveur WebSocket :
-
JSON – Vous pouvez transmettre des paramètres depuis votre fichier HTML5 à l’aide de JSON.
Note : Assurez-vous de sélectionner Enable Remote Control dans l’onglet Remote Control du profil de configuration. Voir L'onglet «Remote Control».
Note : Si vous utilisez JSON via le serveur WebSocket, tout pare-feu présent sur Broadsign Control Player doit être configuré pour accéder directement au port 2326 pour utilisation.
Port 2324 :
- remote_action – Une application fournie avec Broadsign Control Player qui utilise la ligne de commande.
- XML – Si vous souhaitez développer vos propres applications, vous pouvez communiquer directement avec Broadsign Control Player API en utilisant XML.
Note : Assurez-vous de sélectionner Enable Remote Control dans l’onglet Remote Control du profil de configuration. Voir L'onglet «Remote Control».
Note : Tout pare-feu présent sur Broadsign Control Player doit être configuré pour permettre à bsp.exe d'ouvrir des ports, ou pour configurer directement le port 2324 ou le port 2326 pour l'utiliser.
Note : L'action Déclencheurs est la seule exception à cette règle. Elle utilise le port 2325. Voir Action Triggers.
Vous pouvez appeler cette action sur Windows et Ubuntu Linux, et la trouver via les chemins suivants :
- Windows (64 bits) :
- Ubuntu Linux :
/opt/broadsign/suite/bsp/bin/
C:\Program Files\BroadSign\bsp\bin
Avec l'outil de ligne de commande remote_action, le nom d'action data_capture doit être utilisé. L'exécutable peut être trouvé dans le répertoire d'installation bin de Broadsign Control Player. Par exemple, pour soumettre un numéro de téléphone, un nom et une adresse e-mail associés à l'identifiant de campagne 12345, la commande doit être la suivante :
remote_action data_capture -c 12345 -D "name=Brent&phone=5143991184&email=brent@broadsign.com"
Les options supplémentaires pour l'action data_capture incluent l'identifiant de campagne auquel les données sont associées :
-c, --campaign_id
Les données de la campagne :
-D, --data
Afficher les données de campagne associées à la variable campaign_id :
-O, --show_data
Effacer toutes les données de campagne associées à la variable campaign_id :
-C, --clear
Votre application interactive peut soumettre des données XML à Broadsign Control Player en envoyant un message XML au port monitor_remote (2324) :
<rc version="1" id="1" action="data_capture" campaign_id="12345" data="name=John+Smith&&email=test@test.com"/>\r\n\r\n
Note : Vous devez terminer la requête avec \r\n\r\n.
Le lecteur répondra avec le document suivant :
<rc id="1" version="1" action="data_capture" status="1"/>
Un résultat status de « 1 » indique que l'action a réussi.
Note : Chaque commande envoyée nécessite un identifiant unique (id). L'application peut utiliser ici une valeur d'incrémentation simple.
Capture de données - Paramètres XML
Note : Tout pare-feu présent sur Broadsign Control Player doit être configuré pour permettre à bsp.exe d'ouvrir des ports, ou pour configurer directement le port 2324 ou le port 2326 pour l'utiliser.
| Paramètre | Description |
|---|---|
| version | La version est toujours « 1 ». |
| id | Contient l'identifiant de la requête. |
| action | Le type d'action à entreprendre; toujours data_capture. |
| campaign_id | L'identifiant de la campagne diffusant du contenu interactif, auquel adhéreront les données définissables par l'utilisateur. |
| status | Confirme l'état de la capture des données. Toujours « 1 » (actif) ou « 0 » (inactif). |
| data | Une série de paires clé-valeur définissables par l'utilisateur. Le format est codé en pourcentage. Les paires sont séparées par l'entité HTML d'une esperluette (« & »). Les clés et les valeurs sont séparées par un signe égal (« = »). |
| show_data | Affiche les données associées à une campagne (via la variable campaign_id). |
| clear | Efface toutes les données associées à une campagne (via la variable campaign_id). |
Votre application interactive peut soumettre des données JSON au lecteur via le serveur WebSocket de monitor_remote (port 2326). Vous devrez activer le serveur WebSocket. Pour plus d'informations, voir L'onglet «Remote Control».
{
"rc": {
"version": "1",
"id": "1",
"action": "data_capture",
"campaign_id": "12345",
"data": "name=John+Smith&email=test@test.com"
}
}
Note : Chaque commande envoyée nécessite un identifiant unique (id). L'application peut utiliser ici une valeur d'incrémentation simple.
Le lecteur affichera le document JSON suivant :
{
"rc": {
"action": "data_capture",
"id": "1",
"status": "1",
"version": "1"
}
}
Un résultat status de « 1 » indique que l'action a réussi.
Action de capture de données - Paramètres JSON
Note : Si vous utilisez JSON via le serveur WebSocket, tout pare-feu présent sur Broadsign Control Player doit être configuré pour accéder directement au port 2326 pour utilisation.
| Paramètre | Description |
|---|---|
| version | La version est toujours « 1 ». |
| id | Contient l'identifiant de la requête. |
| action | Le type d'action à entreprendre; toujours data_capture. |
| campaign_id | L'identifiant de la campagne diffusant du contenu interactif, auquel adhéreront les données définissables par l'utilisateur. |
| data | Une série de paires clé-valeur définissables par l'utilisateur. Le format est codé en pourcentage. Les paires sont séparées par l'entité HTML d'une esperluette (« & »). Les clés et les valeurs sont séparées par un signe égal (« = »). |
| status | Confirme l'état de la capture des données. Toujours « 1 » (actif) ou « 0 » (inactif). |
| show_data | Affiche les données associées à une campagne (via la variable campaign_id). |
| clear | Efface toutes les données associées à une campagne (via la variable campaign_id). |
Broadsign stockera les données fournies par le lecteur et les associera à l'identifiant de campagne.
Vous pouvez récupérer les données de deux manières :
Les paires de valeurs sont définissables par l'utilisateur; les en-têtes de colonne du rapport sont générés dynamiquement. Pour toutes les données capturées pour une campagne donnée, chaque ensemble unique de clés sera présenté dans un tableau distinct. Cela permet de capturer et d'analyser séparément plusieurs types de données différents, sans avoir à définir une structure de rapport spécifique.
Le rapport de données de campagne affiche le résumé des détails de la campagne, puis une colonne pour chaque entrée des informations de paire clé-valeur saisies par l'application interactive. Le rapport peut être exporté au format HTML, CSV ou PDF.

