Broadsign POP Log

Broadsign Control peut envoyer des lots quotidiens de données, à partir de notre serveur, contenant des statistiques de preuve de diffusion (POP) et des informations sur le contenu. Nous récupérons les données de la veille de tous les lecteurs de votre réseau.

Un POP est considéré comme réussi lorsqu'une copie publicitaire a été lue pendant toute sa durée, avec une tolérance de 500 ms.

Note : Le nombre total d'impressions est cumulatif lorsque les lecteurs sont configurés avec les fichiers d'audience statistique par plage horaire ( Audience statistique Personnalisée). Ceci s’applique également aux tranches d’âge et de sexe.

Note : Broadsign POP Log est différent du POP en temps réel. Tandis que le POP en temps réel fournit des données quasi en temps réel, Broadsign POP Log exporte les journaux bruts de preuve de diffusion toutes les 24 heures. Voir API POP en temps réel.

Note : Avant d'utiliser Broadsign POP Log, Broadsign doit l'activer. Veuillez envoyer une demande d'activation à Broadsign Services.

Il est possible de configurer un accès Broadsign POP Log basé sur la structure des dossiers d'un lecteur. Vous devez fournir à Broadsign les identifiants de dossier, qui accordent des informations de connexion. Ces informations d’identification permettent à leur tour de récupérer les preuves de diffusion générées par les lecteurs.

Veuillez noter ce qui suit :

  • Lors de l'activation, nous vous enverrons un nom d'utilisateur et un mot de passe pour accéder à ces fichiers.
  • Les mises à jour ont lieu quotidiennement, entre minuit et 1 h, heure de l’Est.
  • Après 3 jours, nous allons compresser les fichiers Broadsign POP Log.
  • Broadsign stocke les fichiers gzip jusqu'à 60 jours.

Les fichiers de liste de ressources contiennent une exportation quotidienne de toutes les ressources de lecteur, copie publicitaire, cadre, campagne et d'unité d'affichage du domaine.

Suivant une convention de nommage quotidienne, l'URL de ce fichier ressemble à :

https://popstats.broadsign.com/[ACCOUNT]/resources-YYYY-MM-DD.txt

Les propriétés répertoriées sont les suivantes :

  • ID – Le numéro d'identification de la ressource trouvée dans Broadsign Control Administrator. Voir Aperçu - Ressources.
  • Name – Le nom de la ressource. Voir Aperçu - Ressources.
  • Active – Indique si la ressource est active ou inactive. Voir Aperçu - Ressources.
  • Type – Fournit le type de ressource dans le domaine :
    • host – lecteur
    • content – copie publicitaire
    • skin – cadre
    • reservation – campagne
    • display_unit – unité d'affichage
  • Paramètres des ressources – Fournit les variables de contenu dans le domaine pour les ressources suivantes :
    • host – variables de lecteur
    • content – variables de copie publicitaire
    • reservation / event – variables de campagne
    • display_unit – variables d'unité d'affichage

    Les valeurs sont codées en pourcentage. Les variables peuvent être des variables système automatiques disponibles ou des variables personnalisées.

Les fichiers Playlog contiennent des données sur chaque répétition de copie publicitaire, sur chaque lecteur, dans votre réseau. Connu sous le nom de preuve de diffusion « brute », vous ne devez utiliser les journaux de diffusion qu'à des fins d'audit interne.

Voici un exemple d'URL pour accéder aux journaux de lecture :

https://popstats.broadsign.com/[ACCOUNT]/playlog-YYYY_MM_DD.txt

Le journal de lecture se compose d'une série de lignes séparées par des tabulations. Par exemple:

Exemple de journal de lecture avec des valeurs POP personnalisées :

Copier 
5780162    2019-03-27 16:00:26.797    10    5780178    1    5780169    5780168    5780166    0    0        {"my_custom_pop":"Some values"}
5780162    2019-03-27 16:00:36.84     10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:00:46.885    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:00:56.928    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:06.973    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:17.013    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:27.06     10    5780178    1    5780169    5780168    5780166    0    0        {}

Exemple de journal de jeu avec contenu Broadsign Publish prévu :

Copier 
5780162    2019-03-27 16:00:26.797    10    5780178    1    5780169    5780168    5780166    0    0    http://creator-test.broadsign.com/domains/281543a6a50c4719b1c2ea5864b75cad/loops/82/message.html?mid=12    my_message.jpg    {"publish_message_id":"123545", "publish_message_name":"my_message", "publish_message_url":"http://creator-test.broadsign.com/281543a6a50c4719b1c2ea5864b75cad/media/my_message.jpg"}
5780162    2019-03-27 16:00:36.84     10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:00:46.885    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:00:56.928    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:06.973    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:17.013    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:27.06     10    5780178    1    5780169    5780168    5780166    0    0        {}

Exemple de journal de jeu avec contenu Broadsign Reach prévu :

Copier 
5780162    2019-03-27 16:00:26.797    10    5780178    1    5780169    5780168    5780166    0    0    serv_ssp    1559672406030    {"reach_file_name":"70cf9c2cf26b42ae939aaf68324ce296.jpg"}
5780162    2019-03-27 16:00:36.84     10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:00:46.885    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:00:56.928    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:06.973    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:17.013    10    5780178    1    5780169    5780168    5780166    0    0        {}
5780162    2019-03-27 16:01:27.06     10    5780178    1    5780169    5780168    5780166    0    0        {}

Vous pouvez importer le journal de jeu dans Microsoft Excel ou un tableur similaire.

Exemple de journal de lecture avec des valeurs POP personnalisées :

Exemple de journal de jeu avec Broadsign Publish contenu prévu :

Exemple de journal de jeu avec Broadsign Reach contenu prévu :

Voici les titres des colonnes de gauche à droite :

Colonne Nom Description
A ID du lecteur L'ID du lecteur sur lequel le contenu a été lu.
B Heure de fin Horodatage de la fin du contenu (heure locale du lecteur).

Note : À partir de Broadsign Control 13.0, les valeurs dans la colonne Heure de fin sont précises à la milliseconde près.
C Durée Temps de diffusion (en secondes).
D Identifiant de la copie publicitaire L'identifiant de la copie publicitaire qui a été diffusée (si un message d'urgence Broadsign Publish, affichera « 0 »).
E Nombre d'écrans Le nombre d'écrans actifs au moment de la lecture.
F Identifiant de campagne L'identifiant de la campagne ou de l'événement dans lequel il a joué (le cas échéant) (si un message d'urgence Broadsign Publish, affichera « 0 »).
G Identifiant du cadre L'identifiant du cadre dans lequel il a été joué (si un message d'urgence Broadsign Publish, affichera « 0 »).
H Identifiant de l'unité d'affichage L'identifiant de l'unité d'affichage du lecteur (si un message d'urgence Broadsign Publish, affichera « 0 »).
I Impressions Le nombre d'impressions pendant la lecture.
J Interactions Le nombre d'interactions pendant la lecture.
K Données supplémentaires Affiche l'un des éléments suivants :
  • Si un message Broadsign Publish : l'URL du message.
  • Si un message Broadsign Reach : serv_ssp .
  • Autre : chaîne vide.
L Identifiant de données supplémentaires Affiche l'un des éléments suivants :
  • Si un message Broadsign Publish : le nom du contenu du message, par exemple, movie_poster.gif.
  • Si un message Broadsign Reach : l'identifiant de publicité du message.
  • Autre : chaîne vide.
M Variables de données supplémentaires Affiche l'un des éléments suivants :
  • Si vous utilisez la fonctionnalité d'action à distance custom_pop : données du custom_field. Voir Action POP personnalisée.
  • Si un message Broadsign Reach : si vous utilisez à la fois Broadsign Control Player v13.2 ou supérieur et la dernière version du script XMLPOP (v7), vous verrez quelque chose comme ce qui suit :

    • {"ad_unit_uuid": "4413220a-e698-4cb4-9351-3816588b8f91", "reach_file_name": "2136d0ad-4e5c-4ade-90a1-ec37cad25d73.mp4"}

    • ad_unit_uuid est un identifiant d'unité d'annonce unique au niveau mondial généré par Broadsign Reach qui identifie de manière unique l'emplacement qui a été vendu.
    • reach_file_name est le nom de fichier du média servi par Broadsign Reach et joué par Broadsign Air ou Broadsign Control Player.
  • Si la campagne a un ID de contrat : l'ID de contrat. Voir L'onglet «Contract Info».
  • Autre : chaîne vide.

Notes

  • Si vous avez configuré l'action Custom POP, les colonnes K, L et M contiendront les détails de votre contenu dynamique, à savoir les informations external_value_1, external_value_2 et custom_field. Voir Action POP personnalisée.

  • Si vous avez des messages d'urgence Broadsign Publish programmés, les colonnes D, F, G et H afficheront « 0 ».
  • Pour les campagnes, la preuve de diffusion agrégée est disponible dans le rapport de performance de la campagne dans Broadsign Control Administrator. Voir Rapport sur les performances de la campagne.

Visualiser les données Broadsign POP Log peut représenter un défi lorsque vous avez un très grand nombre de lignes. Si vous voulez visualiser les données Broadsign POP Log, vous pouvez les intégrer manuellement à vos systèmes internes ou à des systèmes tiers. Il existe un certain nombre de systèmes tiers qui vous permettraient de traiter les données Broadsign POP Log. Par exemple, vous pouvez utiliser Power BI.

Par exemple :

Note : Broadsign ne prend pas en charge Power BI ou tout autre système tiers similaire.

Pour visualiser les données Broadsign POP Log :

L'exemple suivant utilise le logiciel PowerBI tiers, mais vous pouvez utiliser vos systèmes internes ou tout autre système tiers.

  1. Téléchargez les journaux pop dans un dossier local nommé Playlogs à partir de l'emplacement suivant :

    https://popstats.broadsign.com/[ACCOUNT]/ [Username/Password]

  2. Assurez-vous que les fichiers ne sont pas archivés.
  3. Dans PowerBi, ouvrez le template file et cliquez sur le bouton Get  Data.

  4. Accédez au dossier local Playlogs où les journaux POP sont stockés et importez la preuve de diffusion.

    5. Conseil : Si vous utilisez plusieurs fichiers, sélectionnez le dossier et utilisez Combine & Load.

  5. Dans l’éditeur de requêtes PowerBI, convertissez les éléments suivants :
    • Colonne 2 en Date/Time
    • Colonne 4 et Colonne 6 en Text

  6. Cliquez sur Apply.
  7. Remplacez et appliquez.

    8. Lors des répétitions de campagne par jour – Si les données ne sont pas visibles en raison du message « Visual has exceeded the available resources », dans la Date Hierarchy, désélectionnez une ou plusieurs des options suivantes, selon le cas : Year, Quarter, Month.