- 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 (Type de métrique)
- MetricFilterClause
- MetricFilter
- Opérateur
- OrderBy
- OrderType (Type de commande)
- Ordre de tri
- Segment
- DynamicSegment
- Définition de segment
- SegmentFilter
- SimpleSegment
- OrFiltersForSegment
- ClauseFilterFilter
- SegmentDimensionFilter
- Opérateur
- SegmentMetricFilter
- Scope (Portée)
- Opérateur
- SéquenceSegment
- SegmentSéquenceStep
- MatchType
- Tableau croisé dynamique
- Groupe de cohortes
- Cohorte
- Type
- Rapport
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasrest
- 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 a une réponse distincte. Le nombre de requêtes est limité à 5. Toutes les requêtes doivent avoir les mêmes |
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 :
Classe de réponse principale qui contient les rapports de l'appel d'API batchGet
Reporting.
Représentation JSON | |
---|---|
{ "reports": [ { object( |
Champs | |
---|---|
reports[] |
Réponses correspondant à chaque requête. |
queryCost |
Quantité de jetons de quota de ressources déduits pour exécuter la requête. Inclut toutes les réponses. |
resourceQuotasRemaining |
Quantité de ressources restantes 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 principale de la requête 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 des données. Chaque ReportRequest d'une méthode |
dateRanges[] |
Plages de dates dans la requête. La demande ne peut pas comporter plus de deux plages de dates. La réponse contient 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 existe deux plages de dates, il y a deux ensembles de valeurs de métriques, une pour la plage de dates initiale et une pour la deuxième. Le champ |
samplingLevel |
Taille de l'échantillon de rapport souhaité. Si le champ |
dimensions[] |
Dimensions demandées. Les demandes peuvent inclure un total de neuf dimensions. |
dimensionFilterClauses[] |
Les 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 avoir un total de 10 métriques. |
metricFilterClauses[] |
Les clauses de filtre de métriques. Ils sont combinés de manière logique avec l'opérateur |
filtersExpression |
Filtres de dimensions ou de métriques qui restreignent les données renvoyées pour votre requête. Pour utiliser |
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 obtiennent le même ordre de ligne. |
segments[] |
Segmentez les données renvoyées pour la requête. Une définition de segment permet d'examiner un sous-ensemble de la demande de segment. Une demande peut contenir jusqu'à quatre segments. Chaque ReportRequest d'une méthode |
pivots[] |
Définitions de 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 contient un groupe de cohortes, la dimension |
pageToken |
Jeton de continuité pour obtenir la page de résultats suivante. Si vous l'ajoutez à la requête, les lignes sont renvoyées après "pageToken". pageToken doit être 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 >= 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 requête, quel que soit le nombre de lignes demandées. Elle peut également renvoyer moins de lignes que prévu si le nombre de segments de dimension ne correspond pas à vos attentes. Par exemple, il existe moins de 300 valeurs possibles pour |
includeEmptyRows |
Si la valeur est "false", la réponse n'inclut pas les 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 la valeur est définie sur "true", cette option masque le total de toutes les métriques pour toutes les lignes correspondantes, pour chaque plage de dates. La valeur par défaut, "false", renvoie les totaux. |
hideValueRanges |
Si la valeur est définie sur "true", les valeurs minimale et maximale sont masquées sur toutes les lignes correspondantes. La valeur par défaut est "false", et les plages de valeurs sont renvoyées. |
Échantillonnage
Valeurs du 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 un échantillon qui allie vitesse et précision. |
SMALL |
Il renvoie une réponse rapide avec une taille d'échantillonnage plus petite. |
LARGE |
Renvoie une réponse plus précise avec une taille d'échantillonnage élevée. 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 n'est pas le cas, nous insérons les valeurs des dimensions dans des buckets après la chaîne en "int64". Les valeurs de dimension qui ne représentent pas la chaîne d'une valeur entière seront converties en zéro. Les valeurs du bucket doivent être dans un ordre croissant. Chaque bucket est fermé sur la partie inférieure et ouvert sur la partie supérieure. Le "premier" segment inclut toutes les valeurs inférieures à la première limite, tandis que le "dernier" inclut toutes les valeurs jusqu'à l'infini. Les valeurs de dimension qui se trouvent dans un bucket sont transformées en une nouvelle valeur de dimension. Par exemple, si l'une d'entre elles donne une liste de "0, 1, 3, 4, 7", nous renvoyons les buckets suivants:
REMARQUE: Si vous appliquez une mutation d'histogramme sur n'importe quelle dimension et que vous l'utilisez pour le tri, vous devez utiliser le type de tri "50-120" <1001+ Et l'ordre "50-120" et "121-1000", 1001+ Le client doit demander explicitement |
Clause DimensionFilter
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 logiquement.
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 façon logique en fonction de l'opérateur spécifié. |
Opérateur de filtre de journal
Combinaison logique des filtres
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Opérateur non spécifié. Il est traité comme un OR . |
OR |
L'opérateur logique OR . |
AND |
L'opérateur logique AND . |
Filtre de dimension
Le filtre de dimension spécifie les options de filtrage d'une dimension.
Représentation JSON | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
Champs | |
---|---|
dimensionName |
Dimension sur laquelle filtrer. Un DimensionFilter doit contenir une dimension. |
not |
Opérateur logique |
operator |
Comment faire correspondre la dimension à l'expression ? La valeur par défaut est REGEXP. |
expressions[] |
Chaînes ou expression régulière à rechercher. 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 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 qui se terminent 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 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 d'une liste de valeurs sélectionnée. Cela permet d'éviter d'évaluer plusieurs filtres de dimensions de mots clés exacts qui sont OU par une seule ligne de réponse. Exemple :
Toute ligne de réponse dont la dimension a cette valeur est A, B ou C, correspond à ce DimensionFilter. |
Métrique
Les métriques sont les 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'un ou plusieurs chiffres et métriques. Les opérateurs acceptés sont les suivants: Plus (+), Moins (-), Négation (unaire -), Divisé par (/), Multiplié par (*), Parenthèse ; Nombres cardinaux positifs (0-9). Le nombre de chiffres après la virgule est limité à 1 024. Dans l'exemple |
alias |
Un alias de l'expression de métrique est un autre nom de l'expression. L'alias peut être utilisé pour le filtrage et le tri. Ce champ est facultatif et 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 ni le tri. L'alias est également utilisé dans l'en-tête de la colonne de réponse. |
formattingType |
Spécifie la mise en forme de l'expression 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 entière. |
FLOAT |
Métrique flottante. |
CURRENCY |
Métrique de devise. |
PERCENT |
Métrique en pourcentage. |
TIME |
Métrique temporelle au format HH:MM:SS . |
Clause MetricFilter
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 logiquement.
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 façon logique en fonction de l'opérateur spécifié. |
Filtre de métriques
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 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 logique |
operator |
Si la métrique |
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-elle être exactement identique à 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 compare pas la valeur value. |
OrderBy
Spécifie les options de tri.
Représentation JSON | |
---|---|
{ "fieldName": string, "orderType": enum( |
Champs | |
---|---|
fieldName |
Champ selon lequel effectuer le tri. L'ordre de tri par défaut est croissant. Exemple : |
orderType |
Type de commande. Le type de commande par défaut 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 |
Le type de commande non spécifié sera traité comme un tri basé sur la valeur. |
VALUE |
L'ordre de tri est basé sur la valeur de la colonne choisie. Il 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 un format "n/d", la valeur pondérée de ce ratio sera (n + totals.n)/(d + totals.d) utilisable uniquement pour les métriques qui représentent des ratios. |
HISTOGRAM_BUCKET |
Le type d'ordre des histogrammes ne s'applique qu'aux colonnes de dimensions comportant des buckets d'histogrammes non vides. |
DIMENSION_AS_INTEGER |
Si les dimensions correspondent à des nombres fixes de longueur fixe, le tri standard suffit. 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 croissant. Le champ est trié dans l'ordre croissant. |
DESCENDING |
Tri décroissant. Le champ est trié de façon décroissante. |
Segment
Définition du segment, si le rapport doit être segmenté. Un segment correspond à un sous-ensemble de données Analytics. Par exemple, parmi l'ensemble des utilisateurs, un segment peut inclure les utilisateurs d'un pays ou d'une ville spécifiques.
Représentation JSON | |
---|---|
{ // Union field |
Champs | ||
---|---|---|
Champ d'union dynamicOrById . Vous pouvez définir ce segment de façon dynamique à l'aide d'un segment dynamique ou en utilisant l'ID d'un segment intégré ou personnalisé. dynamicOrById ne peut être qu'un des éléments suivants : |
||
dynamicSegment |
Définition de segment dynamique dans la requête. |
|
segmentId |
ID d'un segment intégré ou personnalisé, par exemple |
Segment dynamique
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 utilisateur pour sélectionner les utilisateurs à inclure dans le segment. |
sessionSegment |
Segment de session pour sélectionner les sessions à inclure dans le segment. |
Définition du segment
SegmentDefinition définit le segment comme un ensemble de filtres qui sont combinés avec une opération logique AND
.
Représentation JSON | |
---|---|
{
"segmentFilters": [
{
object( |
Champs | |
---|---|
segmentFilters[] |
Un segment est défini par un ensemble de filtres de segments combinés à une opération logique |
Filtre de segments
SegmentFilter définit le segment comme 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. Une condition de segment de séquence permet de sélectionner des utilisateurs ou des sessions selon des conditions séquentielles.
Représentation JSON | |
---|---|
{ "not": boolean, // Union field |
Champs | ||
---|---|---|
not |
Si la valeur est "true", des annonces doivent être complémentaires du segment simple ou du segment de séquence. Par exemple, pour faire correspondre 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 de segment de séquence ? simpleOrSequence ne peut être qu'un des éléments suivants : |
||
simpleSegment |
Une condition de segment simple est composée d'une ou de plusieurs conditions de dimension/métrique pouvant être combinées |
|
sequenceSegment |
Les conditions de la séquence comportent une ou plusieurs étapes, chacune étant définie par une ou plusieurs conditions de dimension/métrique. Vous pouvez combiner plusieurs étapes avec des opérateurs de séquence spéciaux. |
Segment simple
Une condition de segment simple est composée d'une ou de plusieurs conditions de dimension/métrique pouvant être combinées.
Représentation JSON | |
---|---|
{
"orFiltersForSegment": [
{
object( |
Champs | |
---|---|
orFiltersForSegment[] |
Liste de groupes de filtres de segment combinés à l'opérateur logique |
FiltresPourSegment
Une liste de filtres de segment du groupe OR
est combinée avec l'opérateur logique "OU".
Représentation JSON | |
---|---|
{
"segmentFilterClauses": [
{
object( |
Champs | |
---|---|
segmentFilterClauses[] |
Liste des filtres de segment à combiner avec un opérateur |
Clause SegmentFilter
Clause de filtre à utiliser dans une définition de segment, pouvant être une métrique ou un filtre de dimension.
Représentation JSON | |
---|---|
{ "not": boolean, // Union field |
Champs | ||
---|---|---|
not |
Correspond au complément ( |
|
Champ d'union dimensionOrMetricFilter . Une dimension ou un filtre 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 du segment. |
Filtre de dimension de segment
Le filtre de dimension spécifie les options de filtrage d'une dimension.
Représentation JSON | |
---|---|
{
"dimensionName": string,
"operator": enum( |
Champs | |
---|---|
dimensionName |
Nom de la dimension pour laquelle le filtre est appliqué. |
operator |
Opérateur à utiliser pour faire correspondre la dimension avec les expressions. |
caseSensitive |
Si la correspondance est sensible à la casse, ignorée pour l'opérateur |
expressions[] |
Liste des 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 maximales de comparaison pour le type de correspondance |
Opérateur
Différents types de correspondance acceptés.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Si le type de correspondance n'est pas spécifié, il est considéré comme une expression REGEXP. |
REGEXP |
L'expression de correspondance est traitée comme une expression régulière. Tous les autres types de correspondance ne sont pas traités comme des expressions régulières. |
BEGINS_WITH |
Correspond aux valeurs qui commencent par l'expression de correspondance fournie. |
ENDS_WITH |
Correspond aux valeurs qui se terminent 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 d'une liste de valeurs sélectionnée. Cela permet d'éviter d'évaluer plusieurs filtres de dimensions de mots clés exacts qui sont OU par une seule ligne de réponse. Exemple :
Toute ligne de réponse dont la dimension a cette valeur est A, B ou C, correspond à ce DimensionFilter. |
NUMERIC_LESS_THAN |
Filtres de comparaison d'entiers. La sensibilité à la casse est ignorée 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 le minimum et le maximum de l'expression de correspondance (les limites sont exclues). |
Filtre de métrique de segment
Filtre de métrique à utiliser dans une clause de filtre de segment.
Représentation JSON | |
---|---|
{ "scope": enum( |
Champs | |
---|---|
scope |
La portée définie pour une métrique correspond au niveau auquel elle est définie. Le champ d'application de la métrique 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 |
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 |
Portée
La portée définie pour une métrique correspond au niveau auquel elle est définie (PRODUCT
, HIT
, SESSION
ou USER
). Les valeurs de métriques peuvent également être enregistrées à des niveaux d'accès supérieurs à son champ d'application principal. Par exemple, Les rapports ga:pageviews
et ga:transactions
peuvent être rapportés au niveau de SESSION
et du USER
en les additionnant pour chaque appel survenu au cours de ces sessions ou pour ces utilisateurs.
Enums | |
---|---|
UNSPECIFIED_SCOPE |
Si le champ d'application n'est pas spécifié, la portée est définie par défaut sur USER ou SESSION , selon que le segment tente de choisir des utilisateurs ou des sessions. |
PRODUCT |
Portée du produit. |
HIT |
Portée. |
SESSION |
Portée de la session. |
USER |
Portée définie au niveau de l'utilisateur. |
Opérateur
Différents types de comparaison
Enums | |
---|---|
UNSPECIFIED_OPERATOR |
L'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 |
Est égal à l'opérateur. |
BETWEEN |
Pour les deux opérateurs, les valeurs minimale et maximale sont exclusives. Nous allons comparer LT et GT . |
Segment de séquence
Les conditions de la séquence comportent une ou plusieurs étapes, chacune étant définie par une ou plusieurs conditions de dimension/métrique. Vous pouvez combiner plusieurs étapes avec des opérateurs de séquence spéciaux.
Représentation JSON | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
Champs | |
---|---|
segmentSequenceSteps[] |
Liste des étapes de la séquence. |
firstStepShouldMatchFirstHit |
Si elle est définie, la première condition de l'étape doit correspondre au premier appel du visiteur (dans la plage de dates). |
Étape de la séquence du segment
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"OU groupés"associés à l'opérateur |
matchType |
Indique si l'étape précède immédiatement ou peut être n'importe quel moment avant l'étape suivante. |
MatchType
Type de correspondance de la séquence.
Enums | |
---|---|
UNSPECIFIED_MATCH_TYPE |
Le 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. |
Tableau croisé dynamique
Le tableau croisé dynamique décrit la section correspondante de la requête. Le tableau croisé dynamique permet de réorganiser les informations de certains rapports du tableau en appliquant une seconde dimension à vos données.
Représentation JSON | |
---|---|
{ "dimensions": [ { object( |
Champs | |
---|---|
dimensions[] |
Liste de dimensions à afficher sous forme de colonnes croisées. Un tableau croisé dynamique ne peut pas contenir plus de quatre dimensions. Les dimensions de tableau croisé dynamique font partie de la restriction sur le nombre total de dimensions autorisées dans la requête. |
dimensionFilterClauses[] |
Les dimensions DimensionFilter sont combinées de façon logique avec un opérateur |
metrics[] |
Métriques croisées. Les métriques de tableau croisé dynamique font partie de la restriction sur le nombre total de métriques autorisées dans la requête. |
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. Exemple : si vous avez pivoté sur la dimension La liste suivante vous permet de choisir le groupe de k colonnes à inclure dans la réponse. |
maxGroupCount |
Indique le nombre maximal de groupes à afficher. La valeur par défaut est 10 et la valeur maximale 1 000. |
Groupe de cohortes
Définit un groupe de cohortes. 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 client. La LTV mesure la valeur vie des utilisateurs acquis via différents canaux. Veuillez consulter : Analyse des cohortes et Valeur vie Si la valeur vie est "false" :
Lorsque "lifeValue" est "true" :
|
Cohort
Définit une cohorte. Une cohorte est un groupe d'utilisateurs qui partagent une caractéristique commune. Par exemple, tous les utilisateurs ayant la même date d'acquisition forment une 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. Pour le moment, le seul type compatible est |
dateRange |
Cette valeur est utilisée pour la cohorte |
Type
Type de cohorte.
Enums | |
---|---|
UNSPECIFIED_COHORT_TYPE |
Si elle n'est pas 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. |
Rapport
Réponse de données correspondant à la requête.
Représentation JSON | |
---|---|
{ "columnHeader": { object( |
Champs | |
---|---|
columnHeader |
En-têtes de colonne. |
data |
Données de réponse. |
nextPageToken |
Jeton de page pour récupérer la page de résultats suivante dans la liste. |
En-tête de colonne
En-têtes de colonnes.
Représentation JSON | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
Champs | |
---|---|
dimensions[] |
Noms des dimensions dans la réponse. |
metricHeader |
En-têtes pour les métriques dans 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 la métrique, par exemple |
PivotHeader
En-têtes de chacune des sections pivots définies dans la requête.
Représentation JSON | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
Champs | |
---|---|
pivotHeaderEntries[] |
En-tête de section croisé dynamique. |
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 "Pivots" 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 métrique dans le tableau croisé dynamique. |
Données du rapport
Partie des données du rapport.
Représentation JSON | |
---|---|
{ "rows": [ { object( |
Champs | |
---|---|
rows[] |
Il existe une ligne ReportReport 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 d'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. Par exemple, &Total pour |
rowCount |
Nombre total de lignes correspondantes pour cette requête. |
minimums[] |
Valeurs minimale et maximale affichées sur toutes les lignes correspondantes. Elles sont toutes les deux vides lorsque |
maximums[] |
Valeurs minimale et maximale affichées sur toutes les lignes correspondantes. Elles sont toutes les deux vides lorsque |
samplesReadCounts[] |
Si les résultats sont échantillonnés, cette fonction renvoie le nombre total d'échantillons lus, soit 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 fonction renvoie le nombre total d'échantillons présents (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 requête est en or ou non. Les données sont dorées lorsque la même requête ne génère aucun nouveau résultat si vous la demandez plus tard. |
dataLastRefreshed |
Dernière actualisation des données du rapport. Tous les appels reçus avant cet horodatage sont inclus dans le calcul du rapport. Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : |
Ligne du rapport
Une ligne dans le 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. |
Valeurs de plage de dates
Utilisé pour 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 requête. |
pivotValueRegions[] |
Valeurs de chaque région pivot. |
PivotValueRegion
Valeurs de métriques dans la région pivot.
Représentation JSON | |
---|---|
{ "values": [ string ] } |
Champs | |
---|---|
values[] |
Valeurs des métriques dans chacune des régions pivots. |
Quotas de ressources restants
Jetons de quota de ressources restants pour la propriété une fois la requête terminée.
Représentation JSON | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
Champs | |
---|---|
dailyQuotaTokensRemaining |
Quota de ressources quotidiennes restantes. |
hourlyQuotaTokensRemaining |
Jetons de quota de ressources horaires restants. |