Source d'audience de l'API d'audience en temps réel

La source d'audience de l'API d'audience en temps réel est utilisée pour configurer un lecteur afin qu'il se connecte à Broadsign Control API d'audience en temps réel. L'API d'audience en temps réel permet aux développeurs d'intégrer des données d'audience.

La source d'audience de l'API d'audience en temps réel vous permet de spécifier plusieurs URL d'audience, avec des critères de cadre optionnels. Si aucun critère de cadre n'est spécifié, l'URL d'audience est utilisée pour tous les cadres. Si un critère de cadre est spécifié, l'URL d'audience est utilisée pour la preuve de diffusion provenant des cadres avec le critère associé et les demandes d'enchères. Si une URL ne possède aucun critère, elle sert d'URL de repli par défaut, ce qui signifie qu'elle sera utilisée lorsqu'un critère de cadre ne correspond à aucune autre URL.

Note : Le même ordre s'applique lorsqu'un cadre possède plusieurs critères de cadre qui correspondent à une ou plusieurs URL.

L'API d'audience en temps réel est une fonctionnalité avancée de Broadsign Control Administrator.

Avant de configurer cette fonctionnalité, assurez-vous d’être familiarisé avec les éléments suivants :

L'API d'audience en temps réel comporte deux composantes de mesure :

  • Le composant "prédiction" – Broadsign Control Administrator demande à l'API de fournir, en amont du créneau, le nombre estimé ou attendu de spectateurs pour sa diffusion. Cette demande peut être faite jusqu'à 35 secondes à l'avance et est incluse dans les demandes publicitaires de Broadsign Reach.
  • Le composant "mesure" – Broadsign Control Administrator demande à l'API de mesurer, pendant la lecture d'un créneau, le nombre réel de spectateurs. La mesure commence au début de la séquence et s'arrête une fois la lecture terminée. Ces informations sont rapportées avec des POP.

Pour inclure les données d'audience dans vos rapports, vous devez configurer la source Audience dans un profil de configuration de votre lecteur et sélectionner la source Audience de l'API en temps réel.

Pour configurer la source de l'API d'audience en temps réel :

  1. Créer une configuration (voir Configurations).
  2. Créer un profil de configuration de lecteur (voir Profils de configuration - Lecteurs).
  3. Ouvrez les propriétés du profil de configuration et accédez à Integrations > Audience Source (voir L'onglet Audience).

  4. Configurez les paramètres de la source de l'API d'audience en temps réel :
    • Audience Source – Sélectionnez Use Real-Time Audience API.
    • URL – Associer des sources d'audience en temps réel à des cadres spécifiques à l'aide de critères. Ne pas spécifier de critère équivaut à cibler tous les cadres. Voir Option de configuration d'URL.
    • Send real-time audience data in Reach bid requests – Si cette option est activée, l'URL de l'audience est interrogée et soumise dans le cadre de la demande d'annonce Broadsign Reach. L'audience est calculée à l'aide de l'API d'audience en temps réel avec la durée d'affichage prévue du créneau (peut aller jusqu'à une boucle complète à l'avance).
    • Use real-time audience data in Broadsign Control Campaign and proof-of-play reports : si cette option est activée, l'URL de l'audience est interrogée et soumise dans le cadre des informations d'audience associées à chaque rapport de preuve de diffusion Broadsign Control. Si la source de données en temps réel ne fournit pas d'informations sur l'âge ou le sexe, seules les impressions sont enregistrées.
  5. Cliquez sur OK ou Apply.

Vous devez disposer d'un service HTTP opérationnel, soit sur un réseau, soit en local. L'URL pointe vers ce service HTTP, qui doit renvoyer un corps JSON. Pour plus d'informations sur l'API qui permet aux développeurs d'intégrer les données d'audience, consultez Broadsign Control API d'audience en temps réel.

Vous pouvez utiliser des variables qui changent dynamiquement dans l'URL. Par conséquent, vos données de lecture varieront en fonction des données d'audience que vous fournirez lors de la configuration.

L'URL doit inclure au minimum le type d'action ( pre, start, stop) et peut également transmettre les variables suivantes (voir Variables de contenu):

  • action_name
  • expected_play_time
  • frame_id
  • campaign_id
  • content_id
  • content_name
  • expected_duration
  • app_name
  • player_id
  • display_unit_id
  • external_id
  • location_code
  • latitude
  • longitude

Vous pouvez mettre à jour ces variables dans l'onglet URL de la fenêtre Ad Copy Properties (voir Onglet URLs)

Note : Les délimiteurs de vos variables sont « {{ » et « }} ».

Note : Le remplacement de variable peut se produire n'importe où dans l'URL, sauf dans le protocole. De plus, vous pouvez avoir plusieurs variables dans la même URL.

Pour utiliser les variables de contenu avec l'API d'audience en temps réel :

Dans cet exemple, nous allons définir les variables à l'aide de notre profil de configuration. Pour obtenir les mêmes résultats, vous pouvez également utiliser l'onglet URL dans les propriétés de la copie publicitaire (voir Onglet URLs).

  1. Sous « Associate real-time audience API URLs... », cliquez sur Add. La boîte de dialogue Select Resources s'ouvre.
  2. Sous l'onglet URL, saisissez l'URL.

    3. Par exemple, si l'URL distante est :

    http://localhost:10000/audience/{{action_name}}?frame_id={{frame_id}}&content_name={{content_name}}&player_id={{player_id}}

    et l'action interne actuelle est « start », l'identifiant du cadre est 33333, l'identifiant du lecteur est 555 et le nom du contenu est « video », l'URL demandée par le lecteur sera :

    http://localhost:10000/audience/start?frame_id=33333&content_name=video&player_id=555

  3. Sous Frame Criteria, sélectionnez le critère de cadre correspondant à cet écran. Dans notre exemple, nous utiliserons « F1 ».