- Requête HTTP
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- ReportRequest
- Échantillonnage
- Dimension
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter
- Opérateur
- Métrique
- MetricType
- MetricFilterClause
- MetricFilter
- Opérateur
- OrderBy
- OrderType
- SortOrder
- Segment
- DynamicSegment
- SegmentDefinition
- SegmentFilter
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- Opérateur
- SegmentMetricFilter
- Portée
- Opérateur
- SequenceSegment
- SegmentSequenceStep
- MatchType
- Tableau croisé dynamique
- CohortGroup
- Cohorte
- Type
- Rapport
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- Essayer
Affiche les données Analytics.
Requête HTTP
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON | |
---|---|
{
"reportRequests": [
{
object( |
Champs | |
---|---|
reportRequests[] |
Requêtes, chaque requête aura une réponse distincte. Le nombre de requêtes est limité à 5. Toutes les requêtes doivent avoir les mêmes paramètres |
useResourceQuotas |
Active les quotas basés sur les ressources ( |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
La classe de réponse principale qui contient les rapports de l'appel batchGet
de l'API Reporting.
Représentation JSON | |
---|---|
{ "reports": [ { object( |
Champs | |
---|---|
reports[] |
Réponses correspondant à chacune des requêtes. |
queryCost |
La quantité de jetons de quota de ressources déduits pour exécuter la requête. Inclut toutes les réponses. |
resourceQuotasRemaining |
Quota de ressources restant pour la propriété. |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ReportRequest
Classe de requête principale qui spécifie la requête de l'API Reporting.
Représentation JSON | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
Champs | |
---|---|
viewId |
ID de la vue Analytics à partir de laquelle récupérer les données. Chaque demande ReportRequest dans une méthode |
dateRanges[] |
Plages de dates de la requête. La demande peut être associée à deux plages de dates au maximum. La réponse contiendra un ensemble de valeurs de métriques pour chaque combinaison de dimensions pour chaque plage de dates de la demande. Par conséquent, s'il y a deux plages de dates, il y aura deux jeux de valeurs de statistiques : l'un pour la plage de dates d'origine et l'autre pour la seconde. Le champ |
samplingLevel |
La taille d'échantillon de rapport souhaitée. Si le champ |
dimensions[] |
Dimensions demandées. Les requêtes peuvent comporter au total neuf dimensions. |
dimensionFilterClauses[] |
Clauses de filtre de dimension pour filtrer les valeurs de dimension. Ils sont combinés de manière logique avec l'opérateur |
metrics[] |
Métriques demandées. Les requêtes doivent spécifier au moins une métrique. Les requêtes peuvent comporter 10 métriques au total. |
metricFilterClauses[] |
Les clauses de filtre de métrique. Ils sont combinés de manière logique avec l'opérateur |
filtersExpression |
Filtres de dimensions ou de métriques qui limitent les données renvoyées pour votre requête. Pour utiliser l' |
orderBys[] |
Ordre de tri sur les lignes de sortie. Pour comparer deux lignes, les éléments suivants sont appliqués dans l'ordre jusqu'à ce qu'une différence soit trouvée. Toutes les plages de dates du résultat présentent le même ordre des lignes. |
segments[] |
Segmentez les données renvoyées pour la requête. La définition d'un segment permet d'examiner un sous-ensemble de la demande de segment. Une requête peut contenir jusqu'à quatre segments. Chaque demande ReportRequest dans une méthode |
pivots[] |
Les définitions des tableaux croisés dynamiques. Les requêtes ne peuvent pas comporter plus de deux tableaux croisés dynamiques. |
cohortGroup |
Groupe de cohorte associé à cette demande. Si la requête comporte un groupe de cohorte, la dimension |
pageToken |
Un jeton de continuation pour obtenir la page de résultats suivante. Si vous l'ajoutez à la requête, les lignes situées après "pageToken" seront renvoyées. "pageToken" doit correspondre à la valeur renvoyée dans le paramètre "nextPageToken" dans la réponse à la requête reports.batchGet. |
pageSize |
La taille de la page est destinée à la pagination et spécifie le nombre maximal de lignes renvoyées. La taille de la page doit être supérieure ou égale à 0. Une requête renvoie la valeur par défaut de 1 000 lignes. L'API Core Reporting d'Analytics renvoie un maximum de 100 000 lignes par demande, quel que soit le nombre demandé. Il peut également renvoyer moins de lignes que demandé, s'il n'y a pas autant de segments de dimensions que prévu. Par exemple, il y a moins de 300 valeurs possibles pour |
includeEmptyRows |
Si la valeur est "false", la réponse n'inclut pas de lignes si toutes les métriques récupérées sont égales à zéro. La valeur par défaut est "false", ce qui exclut ces lignes. |
hideTotals |
Si cette règle est définie sur "True", elle masque le total de toutes les métriques pour toutes les lignes correspondantes et pour chaque plage de dates. La valeur par défaut "false" et renvoie les totaux. |
hideValueRanges |
Si la valeur est "true", masque les valeurs minimale et maximale pour toutes les lignes correspondantes. La valeur par défaut est "false" et les plages de valeurs sont renvoyées. |
Échantillonnage
Valeurs pour le niveau d'échantillonnage.
Enums | |
---|---|
SAMPLING_UNSPECIFIED |
Si le champ samplingLevel n'est pas spécifié, le niveau d'échantillonnage DEFAULT est utilisé. |
DEFAULT |
Renvoie une réponse avec une taille d'échantillon qui équilibre la vitesse et la précision. |
SMALL |
Elle renvoie une réponse rapide avec une taille d'échantillon plus petite. |
LARGE |
Renvoie une réponse plus précise en utilisant une taille d'échantillon importante. Toutefois, cela peut ralentir la réponse. |
Dimension
Les dimensions sont des attributs de vos données. Par exemple, la dimension ga:city
indique la ville (par exemple, "Paris" ou "New York") d'où provient une session.
Représentation JSON | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
Champs | |
---|---|
name |
Nom de la dimension à récupérer, par exemple |
histogramBuckets[] |
Si ce champ n'est pas vide, les valeurs des dimensions sont placées dans des buckets après la chaîne, puis en int64. Les valeurs de dimension qui ne correspondent pas à la représentation sous forme de chaîne d'une valeur intégrale seront converties en zéro. Les valeurs du bucket doivent être dans un ordre croissant. Chaque bucket est fermé en bas et ouvert en haut. Le "premier" bucket inclut toutes les valeurs inférieures à la première limite, et le "dernier" bucket inclut toutes les valeurs jusqu'à l'infini. Les valeurs des dimensions appartenant à un bucket sont transformées en une nouvelle valeur de dimension. Par exemple, si l'on donne une liste de "0, 1, 3, 4, 7", nous renvoyons les buckets suivants:
REMARQUE: Si vous appliquez une mutation d'histogramme à n'importe quelle dimension et que vous utilisez cette dimension pour trier, nous vous conseillons d'utiliser le type de tri "<50", "1001 et +", "121-1000", "50-120" Et l'ordre croissant des "<50", "50-120", "121-1000", "1001 et plus" Le client doit demander explicitement à |
DimensionFilterClause
Groupe de filtres de dimensions. Définissez la valeur de l'opérateur pour spécifier la manière dont les filtres sont combinés de manière logique.
Représentation JSON | |
---|---|
{ "operator": enum( |
Champs | |
---|---|
operator |
Opérateur permettant de combiner plusieurs filtres de dimensions. S'il n'est pas spécifié, il est traité comme un |
filters[] |
Ensemble répété de filtres. Ils sont combinés de manière logique en fonction de l'opérateur spécifié. |
FilterLogicalOperator
Comment les filtres sont combinés de manière logique.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Opérateur non spécifié. Il est traité comme un OR . |
OR |
Opérateur logique OR . |
AND |
Opérateur logique AND . |
DimensionFilter
Le filtre de dimension spécifie les options de filtrage appliquées à une dimension.
Représentation JSON | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
Champs | |
---|---|
dimensionName |
Dimension à utiliser pour le filtrage. Un DimensionFilter doit contenir une dimension. |
not |
Opérateur |
operator |
Comment faire correspondre la dimension à l'expression. La valeur par défaut est REGEXP. |
expressions[] |
Chaînes ou expression régulière à mettre en correspondance. Seule la première valeur de la liste est utilisée pour la comparaison, sauf si l'opérateur est |
caseSensitive |
La correspondance doit-elle être sensible à la casse ? La valeur par défaut est "false". |
Opérateur
Différents types de correspondance sont acceptés.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Si le type de correspondance n'est pas spécifié, il est traité comme un REGEXP . |
REGEXP |
L'expression de correspondance est traitée comme une expression régulière. Tous les types de correspondance ne sont pas traités comme des expressions régulières. |
BEGINS_WITH |
Correspond à la valeur commençant par l'expression de correspondance fournie. |
ENDS_WITH |
Correspond aux valeurs se terminant par l'expression de correspondance fournie. |
PARTIAL |
Correspondance de sous-chaîne. |
EXACT |
La valeur doit correspondre entièrement à l'expression de correspondance. |
NUMERIC_EQUAL |
Filtres de comparaison d'entiers. La sensibilité à la casse est ignorée pour ces filtres, et l'expression est considérée comme une chaîne représentant un entier. Conditions d'échec:
|
NUMERIC_GREATER_THAN |
Vérifie si la dimension est numériquement supérieure à l'expression de correspondance. Lisez la description de NUMERIC_EQUALS pour connaître les restrictions. |
NUMERIC_LESS_THAN |
Vérifie si la dimension est numériquement inférieure à l'expression de correspondance. Lisez la description de NUMERIC_EQUALS pour connaître les restrictions. |
IN_LIST |
Cette option permet de spécifier un filtre de dimension dont l'expression peut utiliser n'importe quelle valeur dans une liste sélectionnée de valeurs. Cela permet d'éviter d'évaluer plusieurs filtres de dimensions de correspondance exacte associés à l'opérateur OU pour chaque ligne de réponse. Exemple :
Toute ligne de réponse dont la dimension comporte la valeur A, B ou C correspond à ce DimensionFilter. |
Métrique
Les métriques sont des mesures quantitatives. Par exemple, la métrique ga:users
indique le nombre total d'utilisateurs pour la période demandée.
Représentation JSON | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
Champs | |
---|---|
expression |
Expression de métrique dans la requête. Une expression est construite à partir d'une ou de plusieurs métriques et nombres. Les opérateurs acceptés incluent: Plus (+), Moins (-), Négation (Unaire -), Divisé par (/), Multiplié par (*), Parenthèse, Nombres cardinaux positifs (0-9). Ils peuvent inclure des nombres décimaux et sont limités à 1 024 caractères. Par exemple, |
alias |
L'alias de l'expression de métrique est un nom alternatif de l'expression. L'alias peut être utilisé pour le filtrage et le tri. Ce champ est facultatif et est utile si l'expression n'est pas une métrique unique, mais une expression complexe qui ne peut pas être utilisée pour le filtrage et le tri. L'alias est également utilisé dans l'en-tête de la colonne de réponse. |
formattingType |
Spécifie le format de l'expression de métrique (par exemple, |
MetricType
Types de métriques.
Enums | |
---|---|
METRIC_TYPE_UNSPECIFIED |
Le type de métrique n'est pas spécifié. |
INTEGER |
Métrique de nombre entier. |
FLOAT |
Métrique flottante. |
CURRENCY |
Métrique de devise. |
PERCENT |
Métrique en pourcentage. |
TIME |
Métrique temporelle au format HH:MM:SS . |
MetricFilterClause
Représente un groupe de filtres de métriques. Définissez la valeur de l'opérateur pour spécifier la manière dont les filtres sont combinés de manière logique.
Représentation JSON | |
---|---|
{ "operator": enum( |
Champs | |
---|---|
operator |
Opérateur permettant de combiner plusieurs filtres de métriques. S'il n'est pas spécifié, il est traité comme un |
filters[] |
Ensemble répété de filtres. Ils sont combinés de manière logique en fonction de l'opérateur spécifié. |
MetricFilter
"MetricFilter" spécifie le filtre sur une métrique.
Représentation JSON | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
Champs | |
---|---|
metricName |
Métrique qui sera filtrée. Un paramètre metricFilter doit contenir un nom de métrique. Un nom de métrique peut être un alias défini précédemment en tant que métrique ou une expression de métrique. |
not |
Opérateur |
operator |
Si la métrique est |
comparisonValue |
Valeur à comparer. |
Opérateur
Différents types de comparaison.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Si l'opérateur n'est pas spécifié, il est traité comme EQUAL . |
EQUAL |
La valeur de la métrique doit être exactement égale à la valeur de comparaison. |
LESS_THAN |
La valeur de la métrique doit être inférieure à la valeur de comparaison. |
GREATER_THAN |
La valeur de la métrique doit être supérieure à la valeur de comparaison. |
IS_MISSING |
Vérifie si la métrique est manquante. Ne prend pas en compte comparaisonValue. |
OrderBy
Spécifie les options de tri.
Représentation JSON | |
---|---|
{ "fieldName": string, "orderType": enum( |
Champs | |
---|---|
fieldName |
Champ par lequel effectuer le tri. Par défaut, l'ordre de tri est croissant. Exemple : |
orderType |
Type de commande. La valeur par défaut "orderType" est |
sortOrder |
Ordre de tri du champ. |
OrderType
OrderType contrôle la manière dont l'ordre de tri est déterminé.
Enums | |
---|---|
ORDER_TYPE_UNSPECIFIED |
Un type de commande non spécifié sera traité comme un tri en fonction de la valeur. |
VALUE |
L'ordre de tri est basé sur la valeur de la colonne choisie. Ne prend en compte que la première plage de dates. |
DELTA |
L'ordre de tri est basé sur la différence des valeurs de la colonne choisie entre les deux premières plages de dates. Utilisable uniquement s'il existe exactement deux plages de dates. |
SMART |
L'ordre de tri est basé sur la valeur pondérée de la colonne choisie. Si la colonne a le format "n/d", la valeur pondérée de ce ratio sera (n + totals.n)/(d + totals.d) . Elle ne sera utilisable que pour les métriques qui représentent des ratios. |
HISTOGRAM_BUCKET |
Le type d'ordre d'histogramme ne s'applique qu'aux colonnes de dimension comportant des buckets d'histogramme non vides. |
DIMENSION_AS_INTEGER |
Si les dimensions sont des nombres de longueur fixe, le tri ordinaire fonctionne parfaitement. Vous pouvez utiliser DIMENSION_AS_INTEGER si les dimensions sont des nombres de longueur variable. |
SortOrder
Ordre de tri du tri.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED |
Si l'ordre de tri n'est pas spécifié, la valeur par défaut est croissante. |
ASCENDING |
Tri par ordre croissant. Le champ sera trié par ordre croissant. |
DESCENDING |
Tri par ordre décroissant. Le champ sera trié par ordre décroissant. |
Segment
La définition du segment, si le rapport doit être segmenté Un segment est un sous-ensemble des données Analytics. Par exemple, un segment peut regrouper les utilisateurs d'un pays ou d'une ville spécifique.
Représentation JSON | |
---|---|
{ // Union field |
Champs | ||
---|---|---|
Champ d'union dynamicOrById . Le segment peut être défini dynamiquement à l'aide de DynamicSegment ou à l'aide de l'ID d'un segment intégré ou personnalisé. dynamicOrById ne peut être qu'un des éléments suivants : |
||
dynamicSegment |
Une définition de segment dynamique dans la requête. |
|
segmentId |
ID d'un segment intégré ou personnalisé (par exemple, |
DynamicSegment
Définition de segment dynamique pour définir le segment dans la requête. Un segment peut sélectionner des utilisateurs, des sessions ou les deux.
Représentation JSON | |
---|---|
{ "name": string, "userSegment": { object( |
Champs | |
---|---|
name |
Nom du segment dynamique. |
userSegment |
Segment d'utilisateurs pour sélectionner les utilisateurs à inclure dans le segment. |
sessionSegment |
Segment de sessions pour sélectionner les sessions à inclure dans le segment. |
SegmentDefinition
SegmentDefinition définit le segment comme un ensemble de SegmentFilters associés à une opération AND
logique.
Représentation JSON | |
---|---|
{
"segmentFilters": [
{
object( |
Champs | |
---|---|
segmentFilters[] |
Un segment est défini par un ensemble de filtres de segment associés à une opération logique |
SegmentFilter
SegmentFilter définit ce segment comme étant un segment simple ou un segment de séquence. Une condition de segment simple contient des conditions de dimension et de métrique permettant de sélectionner les sessions ou les utilisateurs. Vous pouvez utiliser une condition de segment de séquence pour sélectionner des utilisateurs ou des sessions en fonction de conditions séquentielles.
Représentation JSON | |
---|---|
{ "not": boolean, // Union field |
Champs | ||
---|---|---|
not |
Si la valeur est "true", correspond au complément d'un segment simple ou de séquence. Par exemple, pour prendre en compte toutes les visites ne provenant pas de "New York", nous pouvons définir le segment comme suit:
|
|
Champ d'union simpleOrSequence . S'agit-il d'un segment simple ou d'une définition d'un segment de séquence ? simpleOrSequence ne peut être qu'un des éléments suivants : |
||
simpleSegment |
Les conditions d'un segment simple sont constituées d'une ou de plusieurs conditions de dimension/statistique qui peuvent être combinées |
|
sequenceSegment |
Les conditions de séquence sont composées d'une ou de plusieurs étapes, où chaque étape est définie par une ou plusieurs conditions de dimension/métrique. Plusieurs étapes peuvent être associées à des opérateurs séquentiels spéciaux. |
SimpleSegment
Les conditions d'un segment simple sont constituées d'une ou de plusieurs conditions de dimension/statistique qui peuvent être combinées.
Représentation JSON | |
---|---|
{
"orFiltersForSegment": [
{
object( |
Champs | |
---|---|
orFiltersForSegment[] |
Liste de groupes de filtres de segment associés à l'opérateur logique |
OrFiltersForSegment
Une liste de filtres de segments dans le groupe OR
est combinée à l'opérateur logique OR.
Représentation JSON | |
---|---|
{
"segmentFilterClauses": [
{
object( |
Champs | |
---|---|
segmentFilterClauses[] |
Liste des filtres de segment à combiner avec un opérateur |
SegmentFilterClause
Clause de filtre à utiliser dans une définition de segment, peut être associée à un filtre de métrique ou de dimension.
Représentation JSON | |
---|---|
{ "not": boolean, // Union field |
Champs | ||
---|---|---|
not |
Correspond au complément ( |
|
Champ d'union dimensionOrMetricFilter . Filtre de dimension ou de métrique. dimensionOrMetricFilter ne peut être qu'un des éléments suivants : |
||
dimensionFilter |
Filtre de dimension pour la définition du segment. |
|
metricFilter |
Filtre de métriques pour la définition de segment. |
SegmentDimensionFilter
Le filtre de dimension spécifie les options de filtrage appliquées à une dimension.
Représentation JSON | |
---|---|
{
"dimensionName": string,
"operator": enum( |
Champs | |
---|---|
dimensionName |
Nom de la dimension à laquelle le filtre est appliqué. |
operator |
Opérateur à utiliser pour faire correspondre la dimension aux expressions. |
caseSensitive |
Si la correspondance est sensible à la casse, ignorée pour l'opérateur |
expressions[] |
Liste d'expressions, seul le premier élément est utilisé pour tous les opérateurs |
minComparisonValue |
Valeurs de comparaison minimales pour le type de correspondance |
maxComparisonValue |
Valeurs de comparaison maximales pour le type de correspondance |
Opérateur
Différents types de correspondance sont acceptés.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Si le type de correspondance n'est pas spécifié, il est considéré comme du type REGEXP. |
REGEXP |
L'expression de correspondance est traitée comme une expression régulière. Les autres types de correspondance ne sont pas traités comme des expressions régulières. |
BEGINS_WITH |
Correspond aux valeurs commençant par l'expression de correspondance fournie. |
ENDS_WITH |
Correspond aux valeurs se terminant par l'expression de correspondance fournie. |
PARTIAL |
Correspondance de sous-chaîne. |
EXACT |
La valeur doit correspondre entièrement à l'expression de correspondance. |
IN_LIST |
Cette option permet de spécifier un filtre de dimension dont l'expression peut utiliser n'importe quelle valeur dans une liste sélectionnée de valeurs. Cela permet d'éviter d'évaluer plusieurs filtres de dimensions de correspondance exacte associés à l'opérateur OU pour chaque ligne de réponse. Exemple :
Toute ligne de réponse dont la dimension comporte la valeur A, B ou C correspond à ce DimensionFilter. |
NUMERIC_LESS_THAN |
Filtres de comparaison d'entiers. La sensibilité à la casse est ignorée pour ces filtres, et l'expression est considérée comme une chaîne représentant un entier. Conditions d'échec:
Vérifie si la dimension est numériquement inférieure à l'expression de correspondance. |
NUMERIC_GREATER_THAN |
Vérifie si la dimension est numériquement supérieure à l'expression de correspondance. |
NUMERIC_BETWEEN |
Vérifie si la dimension est numériquement comprise entre les valeurs minimale et maximale de l'expression de correspondance, limites exclues. |
SegmentMetricFilter
Filtre de métrique à utiliser dans une clause de filtre de segment.
Représentation JSON | |
---|---|
{ "scope": enum( |
Champs | |
---|---|
scope |
La portée d'une métrique définit son niveau. Le champ d'application des métriques spécifié doit être supérieur ou égal à son champ d'application principal tel que défini dans le modèle de données. Le champ d'application principal est défini selon que le segment sélectionne des utilisateurs ou des sessions. |
metricName |
Métrique qui sera filtrée. Un élément |
operator |
Spécifie l'opération à effectuer pour comparer la métrique. La valeur par défaut est |
comparisonValue |
Valeur à comparer. Si l'opérateur est |
maxComparisonValue |
La valeur de comparaison maximale n'est utilisée que pour l'opérateur |
Champ d'application
Le champ d'application d'une métrique définit le niveau auquel elle est définie (PRODUCT
, HIT
, SESSION
ou USER
). Les valeurs des métriques peuvent également être enregistrées à des niveaux d'accès supérieurs à leur champ d'application principal. Exemple : ga:pageviews
et ga:transactions
peuvent être enregistrés au niveau des SESSION
et USER
en les additionnant simplement pour chaque appel enregistré au cours de ces sessions ou pour ces utilisateurs.
Enums | |
---|---|
UNSPECIFIED_SCOPE |
Si le champ d'application n'est pas spécifié, il est défini par défaut sur le champ d'application de la condition, USER ou SESSION , selon que le segment tente de choisir des utilisateurs ou des sessions. |
PRODUCT |
Portée du produit. |
HIT |
Champ d'application de l'appel. |
SESSION |
Portée de la session. |
USER |
Champ d'application de l'utilisateur. |
Opérateur
Différents types de comparaison.
Enums | |
---|---|
UNSPECIFIED_OPERATOR |
Un opérateur non spécifié est traité comme un opérateur LESS_THAN . |
LESS_THAN |
Vérifie si la valeur de la métrique est inférieure à la valeur de comparaison. |
GREATER_THAN |
Vérifie si la valeur de la métrique est supérieure à la valeur de comparaison. |
EQUAL |
Opérateur est égal à. |
BETWEEN |
Pour l'opérateur AND, les valeurs minimale et maximale sont exclusives. Nous utiliserons LT et GT à des fins de comparaison. |
SequenceSegment
Les conditions de séquence sont composées d'une ou de plusieurs étapes, où chaque étape est définie par une ou plusieurs conditions de dimension/métrique. Plusieurs étapes peuvent être associées à des opérateurs séquentiels spéciaux.
Représentation JSON | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
Champs | |
---|---|
segmentSequenceSteps[] |
Liste des étapes de la séquence. |
firstStepShouldMatchFirstHit |
Si la condition de la première étape est définie, elle doit correspondre au premier appel effectué par le visiteur (au cours de la période). |
SegmentSequenceStep
Une définition d'une séquence de segment.
Représentation JSON | |
---|---|
{ "orFiltersForSegment": [ { object( |
Champs | |
---|---|
orFiltersForSegment[] |
Une séquence est spécifiée avec une liste de filtres groupés "OU" qui sont associés à l'opérateur |
matchType |
Indique si l'étape précède immédiatement ou peut être n'importe quand avant la prochaine étape. |
MatchType
Type de correspondance de la séquence.
Enums | |
---|---|
UNSPECIFIED_MATCH_TYPE |
Un type de correspondance non spécifié est traité comme des précédents. |
PRECEDES |
L'opérateur indique que l'étape précédente précède l'étape suivante. |
IMMEDIATELY_PRECEDES |
L'opérateur indique que l'étape précédente précède immédiatement l'étape suivante. |
Ajouter un tableau croisé dynamique
Le tableau croisé dynamique décrit la section correspondante de la demande. Le tableau croisé dynamique permet de réorganiser les informations du tableau de certains rapports en appliquant une seconde dimension à vos données.
Représentation JSON | |
---|---|
{ "dimensions": [ { object( |
Champs | |
---|---|
dimensions[] |
Liste de dimensions à afficher sous forme de colonnes de tableau croisé dynamique. Un tableau croisé dynamique ne peut pas comporter plus de quatre dimensions. Les dimensions pivot font partie de la restriction sur le nombre total de dimensions autorisées dans la demande. |
dimensionFilterClauses[] |
Les DimensionFilterClauses sont combinées de manière logique avec un opérateur |
metrics[] |
Les métriques croisées Les métriques croisées font partie de la restriction sur le nombre total de métriques autorisées dans la demande. |
startGroup |
Si k métriques ont été demandées, la réponse contiendra un multiple de k colonnes dépendant des données du rapport. Par exemple, si vous utilisez la dimension La commande suivante vous permet de choisir quels groupes de k colonnes sont inclus dans la réponse. |
maxGroupCount |
Spécifie le nombre maximal de groupes à renvoyer. La valeur par défaut est 10, et la valeur maximale est 1 000. |
CohortGroup
Définit un groupe de cohorte. Exemple :
"cohortGroup": {
"cohorts": [{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
},{
"name": "cohort 2"
"type": "FIRST_VISIT_DATE"
"dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
}]
}
Représentation JSON | |
---|---|
{
"cohorts": [
{
object( |
Champs | |
---|---|
cohorts[] |
Définition de la cohorte. |
lifetimeValue |
Activez la valeur vie (LTV). La LTV mesure la valeur vie des utilisateurs acquis via différents canaux. Veuillez consulter les sections Analyse des cohortes et Valeur vie. Si la valeur de "lifeValue" est "false", procédez comme suit :
Lorsque la valeur "lifeValue" est définie sur "true" :
|
Cohort
Définit une cohorte. Une cohorte est un groupe d'utilisateurs qui partagent une caractéristique commune. Par exemple, tous les utilisateurs avec la même date d'acquisition appartiennent à la même cohorte.
Représentation JSON | |
---|---|
{ "name": string, "type": enum( |
Champs | |
---|---|
name |
Nom unique de la cohorte. S'il n'est pas défini, le nom sera généré automatiquement avec les valeurs cohort_[1234...]. |
type |
Type de cohorte. À l'heure actuelle, le seul type accepté est |
dateRange |
Utilisé pour la cohorte |
Type
Type de cohorte.
Enums | |
---|---|
UNSPECIFIED_COHORT_TYPE |
Si aucune valeur n'est spécifiée, elle est traitée comme FIRST_VISIT_DATE . |
FIRST_VISIT_DATE |
Cohortes sélectionnées en fonction de la date de la première visite. |
Incitez-le à faire un signalement
Réponse de données correspondant à la requête.
Représentation JSON | |
---|---|
{ "columnHeader": { object( |
Champs | |
---|---|
columnHeader |
En-têtes de colonne |
data |
Données des réponses. |
nextPageToken |
Jeton de page permettant de récupérer la page de résultats suivante dans la liste. |
ColumnHeader
En-têtes de colonne
Représentation JSON | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
Champs | |
---|---|
dimensions[] |
Noms des dimensions dans la réponse. |
metricHeader |
En-têtes de métriques des métriques de la réponse. |
MetricHeader
En-têtes des métriques.
Représentation JSON | |
---|---|
{ "metricHeaderEntries": [ { object( |
Champs | |
---|---|
metricHeaderEntries[] |
En-têtes des métriques dans la réponse. |
pivotHeaders[] |
En-têtes des tableaux croisés dynamiques dans la réponse. |
MetricHeaderEntry
En-tête des métriques.
Représentation JSON | |
---|---|
{
"name": string,
"type": enum( |
Champs | |
---|---|
name |
Nom de l'en-tête. |
type |
Type de métrique (par exemple, |
PivotHeader
En-têtes de chacune des sections de tableaux croisés dynamiques définies dans la demande.
Représentation JSON | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
Champs | |
---|---|
pivotHeaderEntries[] |
Un en-tête de section de tableau croisé dynamique unique. |
totalPivotGroupsCount |
Nombre total de groupes pour ce tableau croisé dynamique. |
PivotHeaderEntry
En-têtes de chaque colonne de métrique correspondant aux métriques demandées dans la section de tableaux croisés dynamiques de la réponse.
Représentation JSON | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
Champs | |
---|---|
dimensionNames[] |
Nom des dimensions dans la réponse du tableau croisé dynamique. |
dimensionValues[] |
Valeurs des dimensions du tableau croisé dynamique. |
metric |
En-tête de la métrique du tableau croisé dynamique. |
ReportData
Partie "Données" du rapport.
Représentation JSON | |
---|---|
{ "rows": [ { object( |
Champs | |
---|---|
rows[] |
Il existe un élément ReportRow pour chaque combinaison unique de dimensions. |
totals[] |
Pour chaque plage de dates demandée, pour l'ensemble des lignes correspondant à la requête, chaque format de valeur demandé obtient un total. Le total pour un format de valeur est calculé en additionnant d'abord les métriques mentionnées dans le format de valeur, puis en évaluant le format de valeur en tant qu'expression scalaire. Exemple : Les "totaux" de |
rowCount |
Nombre total de lignes correspondantes pour cette requête. |
minimums[] |
Valeurs minimale et maximale visibles sur toutes les lignes correspondantes. Ils sont tous les deux vides si la valeur de |
maximums[] |
Valeurs minimale et maximale visibles sur toutes les lignes correspondantes. Ils sont tous les deux vides si la valeur de |
samplesReadCounts[] |
Si les résultats sont échantillonnés, la fonction renvoie le nombre total d'échantillons lus, à raison d'une entrée par plage de dates. Si les résultats ne sont pas échantillonnés, ce champ ne sera pas défini. Pour en savoir plus, consultez le guide du développeur. |
samplingSpaceSizes[] |
Si les résultats sont échantillonnés, cette option affiche le nombre total d'échantillons présents, à raison d'une entrée par plage de dates. Si les résultats ne sont pas échantillonnés, ce champ ne sera pas défini. Pour en savoir plus, consultez le guide du développeur. |
isDataGolden |
Indique si la réponse à cette demande est correcte ou non. Les données sont essentielles lorsque la même demande ne produira pas de nouveaux résultats si vous la demandez ultérieurement. |
dataLastRefreshed |
Date et heure de la dernière actualisation des données du rapport. Tous les appels reçus avant ce code temporel sont inclus dans le calcul du rapport. Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : |
ReportRow
Une ligne du rapport.
Représentation JSON | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
Champs | |
---|---|
dimensions[] |
Liste des dimensions demandées. |
metrics[] |
Liste des métriques pour chaque plage de dates demandée. |
DateRangeValues
Permet de renvoyer une liste de métriques pour une seule combinaison DateRange / dimension
Représentation JSON | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
Champs | |
---|---|
values[] |
Chaque valeur correspond à chaque métrique de la demande. |
pivotValueRegions[] |
Valeurs de chaque région pivot. |
PivotValueRegion
Valeurs des métriques dans la région pivot.
Représentation JSON | |
---|---|
{ "values": [ string ] } |
Champs | |
---|---|
values[] |
Valeurs des métriques dans chacune des régions pivots. |
ResourceQuotasRemaining
Jetons de quota de ressources restants pour la propriété une fois la requête traitée.
Représentation JSON | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
Champs | |
---|---|
dailyQuotaTokensRemaining |
Quota de ressources quotidien restant. |
hourlyQuotaTokensRemaining |
Jetons de quota horaires restants. |