region
dimension. La region
dimension fournit des informations sur le navigateur dans lequel les vidéos ont été visualisées. Il renvoie les codes de région ISO-3611-2 (exemple : US-WA). La définition des régions varie selon les paysParamètres d'URL
Les rapports d'API Analytics prennent en charge les paramètres d'URL suivants.
Paramètre | Description | Obligatoire | Valeurs | Par défaut |
---|---|---|---|---|
account |
Les comptes sur lesquels vous souhaitez signaler | oui | un ou plusieurs identifiants de compte en tant que liste délimitée par des virgules | aucun |
dimensions |
La (les) dimension (s) à signaler | oui | une ou plusieurs dimensions en tant que liste délimitée par des virgules (certaines combinaisons ne sont pas valides) | aucun |
where |
Utilisé pour spécifier des filtres pour les rapports | non | {dimension} == {value} - une ou plusieurs en tant que liste délimitée par des points-virgules | aucun |
limit |
Nombre d'articles à retourner | non | entier positif | 10 |
offset |
Nombre d'éléments à ignorer | non | entier positif | 0 |
sort |
Champ pour trier les éléments sur | non | un champ valide pour la demande | video_view |
fields |
Champs à renvoyer | non | varie en fonction de la dimension sur laquelle vous signalez | video_view |
format |
Formater pour renvoyer les résultats dans | non | json | csv | xlxs | Jason |
reconciled |
S'ils sont inclus, limiteront les résultats aux données historiques ou en temps réel | non | vrai | faux | true |
from |
Début de la plage de dates pour la demande | non | Une date ISO 8601 (AAAA-MM-JJ), une heure d'époque en millisecondes, la chaîne alltime ou une date relative (-1m) ; seules les dates des 32 derniers jours sont autorisées pour les points de terminaison d'engagement ou si elles sont rapprochées = false. | 30 jours avant maintenant |
to |
Fin de la plage de dates de la demande | non | Une date ISO 8601 (AAAA-MM-JJ), une heure d'époque en millisecondes, la chaîne maintenant ou des données relatives (+7d) ; seules les dates au cours des 32 derniers jours sont autorisées pour les points de terminaison d'engagement ou si rapproché = false. | maintenant |
Champs disponibles
Les champs suivants peuvent être renvoyés pour la dimension.
ad_mode_begin
- le nombre de fois où le joueur est entré en mode publicitairead_mode_complete
- le nombre de fois où le joueur a terminé le mode publicitaireengagement_score
- le score d'engagement moyen d'une vidéo jouée dans un joueurplay_request
- nombre total de fois que la lecture vidéo a été demandéeplay_rate
- le taux de lecture moyen (vues vidéo divisées par impressions) pour une vidéoplayer_load
- le nombre de fois où un joueur a été chargéregion
- abréviation de région standard - ce qui compte comme « région » varie selon les paysregion_name
- le nom de la région, s'il est signalé ;video_impression
- le nombre total de vidéos chargées dans le lecteurvideo_percent_viewed
- la somme du pourcentage visionné des vidéos dans le lecteurvideo_seconds_viewed
- nombre total de secondes de vidéos vues dans le lecteurvideo_view
- nombre total de fois que la lecture vidéo a démarré dans le lecteur
Valeurs de filtre
Utilisée comme filtre, une cote permet de réduire les résultats.
Valeurs de filtre : liste délimitée par des virgules du code de région ISO-3611-2 - par exemple US-WA
Combinaison des
Pour voir quelles dimensions cette option peut être combinée et quels champs sont disponibles pour cette combinaison, reportez-vous à la section Dimension et champs.
Exemples de demande
Demande de dimension
https ://analytics.api.brightcove.com/v1/data ? accounts=1752604059001&dimensions=region
Demande de filtre
https ://analytics.api.brightcove.com/v1/data ? accounts=1752604059001&dimensions=Country&where=région==US-MA
Réponse
La réponse apparaîtra ici lorsque vous testez une demande