getPlaylistAnalytics

Statistiques d'une playlist sur la période donnée.

Arguments

Nom	Type	Description
`id`*	`ID!`	Identifiant du contenu.
`startDate`*	`DateTime!`	Début de la période, inclus.
`endDate`*	`DateTime!`	Fin de la période, incluse. L'écart avec `startDate` ne peut pas dépasser 24 mois.

Réponse

PlaylistAnalytics!

Nom	Type	Description
`impressions`	`Int!`	Nombre de visites sur la période. Le passage d'un item au suivant recharge le lecteur sans ouvrir de visite : la visite reste attachée à la playlist, et c'est `contents` qui compte les chargements item par item.
`plays`	`Int!`	Nombre de lectures démarrées sur la période.
`uniqueViewers`	`Int!`	Nombre de spectateurs distincts à l'origine de ces visites : le même comptage qu'`impressions`, dédoublonné par spectateur.
`referrers`	`[AnalyticsByReferrer!]!`	Répartition par site référent. Ne concerne que le mode `PUBLIC_PAGE` : le référent n'est renseigné qu'hors intégration.
`locations`	`[AnalyticsByLocation!]!`	Répartition géographique des spectateurs, résolue par GeoIP.
`browsers`	`[AnalyticsByBrowser!]!`	Répartition par navigateur.
`operatingSystems`	`[AnalyticsByOs!]!`	Répartition par système d'exploitation.
`deviceTypes`	`[AnalyticsByDevice!]!`	Répartition par catégorie d'appareil.
`resolutions`	`[AnalyticsByResolution!]!`	Répartition des spectateurs uniques par résolution de lecture dominante.
`timeseries`	`[AnalyticsSeries!]!`	Série temporelle d'une métrique, à tracer sous forme de graphe. Sans `splitBy`, une seule série agrégeant tout ; avec `splitBy`, une courbe par valeur de la dimension demandée.
`surfaces`	`[AnalyticsBySurface!]!`	Répartition par mode de diffusion — page publique ou lecteur intégré. Les lignes partitionnent le total.
`embedHosts`	`[AnalyticsByHost!]!`	Détail du mode `EMBED`, par domaine de la page hôte. Les lignes partitionnent ce mode : celles dont l'hôte n'a pas pu être lu forment le groupe `domain: null`.
`contents`	`[AnalyticsByContent!]!`	Détail des statistiques par contenu de la playlist. Les `impressions` y comptent chaque chargement du contenu, changement d'item compris : ces lignes ne somment pas au total de la playlist.

Dans les répartitions (navigateur, pays, appareil…), impressions et plays s'additionnent ligne à ligne et retombent sur le total. uniqueViewers, non : un spectateur qui a regardé depuis deux navigateurs est compté dans les deux lignes, donc les additionner surestime le nombre de spectateurs. Le chiffre exact est toujours celui de la racine de la réponse.

Erreurs

Erreurs communes

Code	Message	Description
`UNAUTHENTICATED`	`You are not authorized to perform this action`	Clé API manquante ou invalide
`INPUT_VALIDATION_ERROR`	`Validation failed: {field}: {message}`	Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[].
`INTERNAL_ERROR`	`Internal server error`	Erreur interne du serveur

Erreurs spécifiques

Code	Message	Description
`404`	`{label} '{id}' has not been found`	La playlist n'existe pas, ou l'appelant n'y a aucun accès — les deux cas renvoient la même erreur, pour ne pas révéler l'existence d'un contenu d'un autre compte.
`FORBIDDEN`	`You don't have the permission for this request`	La playlist existe dans le compte de l'appelant, mais celui-ci n'a pas le droit de le lire.

getPlaylistAnalytics

Arguments

getPlaylistAnalytics

Arguments

Utilisation

Réponse

Erreurs

Erreurs communes

Erreurs spécifiques

Rate Limiting

Sur cette page