assistance Contacter le support | Étatétat du système du système
Contenu de la page

    Dimension : region

    Dans cette rubrique, vous découvrirez les Analytics API 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 pays

    Paramètres d'URL

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

    Paramètres d'URL
    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 publicitaire
    • ad_mode_complete - le nombre de fois où le joueur a terminé le mode publicitaire
    • engagement_score - le score d'engagement moyen d'une vidéo jouée dans un joueur
    • play_request - nombre total de fois que la lecture vidéo a été demandée
    • play_rate - le taux de lecture moyen (vues vidéo divisées par impressions) pour une vidéo
    • player_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 pays
    • region_name - le nom de la région, s'il est signalé ;
    • video_impression - le nombre total de vidéos chargées dans le lecteur
    • video_percent_viewed - la somme du pourcentage visionné des vidéos dans le lecteur
    • video_seconds_viewed - nombre total de secondes de vidéos vues dans le lecteur
    • video_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