Dimension: region

Dimension: region

Dans ce sujet, vous apprendrez à propos du Analytics API region dimension. le region dimension fournit des informations sur le navigateur dans lequel les vidéos ont été visionnées. Elle renvoie les codes de région ISO-3611-2 (exemple: US-WA). La définition des régions varie selon les pays

Paramètres d'URL

Analytics API les rapports prennent en charge les paramètres d'URL suivants.

Paramètres d'URL
Paramètre	Description	Requis	Valeurs	Défaut
`account`	Les comptes que vous souhaitez signaler	Oui	un ou plusieurs identifiants de compte sous forme de liste séparée par des virgules	aucun
`dimensions`	La ou les dimensions à rapporter	Oui	une ou plusieurs dimensions sous forme de liste séparée par des virgules (certaines combinaisons ne sont pas valides)	aucun
`where`	Utilisé pour spécifier des filtres pour les rapports	aucune	{dimension} == {valeur} - un ou plusieurs sous forme de liste délimitée par des points-virgules	aucun
`limit`	Nombre d'articles à retourner	aucune	entier positif	10
`offset`	Nombre d'éléments à ignorer	aucune	entier positif	0
`sort`	Champ pour trier les éléments sur	aucune	un champ valide pour la demande	video_view
`fields`	Champs à retourner	aucune	varie en fonction de la dimension que vous signalez	video_view
`format`	Format pour retourner les résultats en	aucune	json \| CSV \| xlxs	json
`reconciled`	Si inclus, limitera les résultats aux données historiques ou en temps réel	aucune	vrai \| faux	vrai
`from`	Le début de la plage de dates pour la demande	aucune	Une date ISO 8601 (AAAA-MM-JJ), le temps de l'époque en millisecondes, la chaîne à tout moment ou la date relative (-1 m); seules les dates des 32 derniers jours sont autorisées pour les points de terminaison d'engagement ou si rapprochement = faux.	30 jours avant maintenant
`to`	La fin de la plage de dates pour la demande	aucune	Une date ISO 8601 (AAAA-MM-JJ), l'heure de l'époque en millisecondes, la chaîne maintenant ou des données relatives (+ 7 j); seules les dates des 32 derniers jours sont autorisées pour les points de terminaison d'engagement ou si rapprochement = faux.	maintenant

Champs disponibles

Les champs suivants peuvent être retournés pour la dimension.

ad_mode_begin - le nombre de fois où player entré en mode annonce
ad_mode_complete - le nombre de fois où player mode d'annonce terminé
engagement_score - le score d'engagement moyen pour une vidéo lue dans un player
play_request - nombre total de demandes de lecture vidéo
play_rate - le taux de lecture moyen (vues vidéo divisées par impressions) d'une vidéo
player_load - le nombre de fois qu'un player a été chargé
region - Abréviation standard de région - ce qui compte comme "région" varie selon les pays
region_name - le nom de la région, si indiqué
video_impression - le nombre total de vidéos chargées dans le player
video_percent_viewed - la somme des pourcentages de vidéos vues sur le player
video_seconds_viewed - nombre total de secondes de vidéos vues dans le player
video_view - nombre total de fois où la lecture vidéo a commencé dans le player

Filtrer les valeurs

Utilisé comme un filtre, une dimension vous permet d'affiner les résultats.

Valeurs de filtre: liste séparée par des virgules du code de région ISO-3611-2 - par exemple, US-WA

Combinaison de dimensions

Pour voir à quelles dimensions cela peut être associé, et quels champs sont disponibles pour la combinaison, voir Dimension et champs.

Demander des exemples

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=region==US-MA

Réponse

    Response will appear here when you test a request