Method: properties.runFunnelReport

Affiche un rapport personnalisé sur les entonnoirs de vos données d'événement Google Analytics. Les données renvoyées par l'API se présentent sous forme de tableau avec des colonnes pour les dimensions et métriques demandées.

L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes. Par exemple, comment les prospects deviennent-ils des clients potentiels, puis des acheteurs ? Comment les acheteurs ponctuels deviennent-ils des acheteurs fidèles ? À la lumière de ces informations, vous pouvez améliorer les parcours client inefficaces ou abandonnés. Pour en savoir plus, consultez Explorations de l'entonnoir GA4.

Cette méthode a été introduite en version alpha afin de recueillir des commentaires sur la syntaxe et les fonctionnalités avant le passage à la version bêta. Pour nous faire part de vos commentaires sur cette API, répondez aux commentaires sur les rapports sur les entonnoirs de conversion de l'API Google Analytics Data.

Requête HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
property

string

Facultatif. Un identifiant de propriété Google Analytics GA4 dont les événements sont suivis. Spécifié dans le chemin de l'URL et non dans le corps. Pour en savoir plus, découvrez où trouver votre ID de propriété. Dans une requête par lot, cette propriété ne doit pas être spécifiée ou correspondre à la propriété au niveau du lot.

Exemple: propriétés/1234

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Champs
dateRanges[]

object (DateRange)

Facultatif. Plages de dates correspondant aux données à lire. Si plusieurs plages de dates sont demandées, chaque ligne de réponse contiendra un index de plage de dates basé sur zéro. Si deux plages de dates se chevauchent, les données d'événement des jours concernés sont incluses dans les lignes de réponse pour les deux plages de dates.
funnel

object (Funnel)

Facultatif. Configuration de l'entonnoir de conversion de cette demande. Cette configuration d'entonnoir est obligatoire.
funnelBreakdown

object (FunnelBreakdown)

Facultatif. Si elle est spécifiée, cette répartition ajoute une dimension à la réponse du sous-rapport du tableau de l'entonnoir. Cette dimension étend chaque étape de l'entonnoir aux valeurs uniques de la dimension "Répartition". Par exemple, une répartition par dimension deviceCategory crée des lignes pour mobile, tablet et desktop, ainsi que pour le total.
funnelNextAction

object (FunnelNextAction)

Facultatif. Si elle est spécifiée, l'action suivante ajoute une dimension à la réponse du sous-rapport "Schéma de l'entonnoir". La dimension d'action suivante étend chaque étape de l'entonnoir aux valeurs uniques de l'action suivante. Par exemple, une action suivante de la dimension eventName créera des lignes pour plusieurs événements (par exemple, session_start et click) et pour le total.

L'action suivante n'est compatible qu'avec eventName et la plupart des dimensions de page / d'écran, comme pageTitle et pagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

Facultatif. Le type "Visualisation de l'entonnoir" contrôle les dimensions présentes dans la réponse du sous-rapport "Visualisation de l'entonnoir". Si aucune valeur n'est spécifiée, STANDARD_FUNNEL est utilisé.
segments[]

object (Segment)

Facultatif. Configurations des segments. Les segments sont des sous-ensembles de données d'une propriété. Dans un rapport sur les entonnoirs comportant des segments, l'entonnoir est évalué dans chaque segment.

Chaque segment spécifié dans cette demande produit une ligne distincte dans la réponse ; dans la réponse, chaque segment est identifié par son nom.

Le paramètre "segments" est facultatif. Les requêtes sont limitées à quatre segments.
limit

string (int64 format)

Facultatif. Nombre de lignes à afficher. Si aucune valeur n'est spécifiée, 10 000 lignes sont renvoyées. L'API renvoie un maximum de 250 000 lignes par requête, quel que soit le nombre demandé. limit doit être positif.

L'API peut également renvoyer moins de lignes que le limit demandé, s'il n'y a pas autant de valeurs de dimension que le limit.
dimensionFilter

object (FilterExpression)

Facultatif. Les filtres de dimensions vous permettent de ne demander que des valeurs de dimensions spécifiques dans le rapport. Pour en savoir plus et obtenir des exemples, consultez la page Créer un rapport: filtres de dimensions. Impossible d'utiliser des métriques dans ce filtre.
returnPropertyQuota

boolean

Facultatif. Indique si l'état actuel du quota de cette propriété Analytics doit être affiché. Le quota est renvoyé dans PropertyQuota.

Corps de la réponse

La réponse du rapport sur les entonnoirs contient deux sous-rapports. Les deux sous-rapports sont des combinaisons différentes de dimensions et de métriques.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Champs
funnelTable

object (FunnelSubReport)

Le tableau de l'entonnoir est un rapport avec l'étape de l'entonnoir, le segment, la dimension "Répartition", les utilisateurs actifs, le taux d'achèvement, le taux d'abandon et le taux d'abandon.

La dimension "Segment" n'est présente dans cette réponse que si un segment a été demandé. La dimension "Répartition" n'est présente dans cette réponse que si elle a été demandée.
funnelVisualization

object (FunnelSubReport)

La visualisation de l'entonnoir est un rapport avec l'étape de l'entonnoir, le segment, la date, la dimension "Action suivante" et les utilisateurs actifs.

La dimension "Segment" n'est présente dans cette réponse que si un segment a été demandé. La dimension "Date" n'est présente dans cette réponse que si elle a été demandée via le type d'entonnoir TRENDED_FUNNEL. La dimension d'action suivante n'est présente dans la réponse que si elle a été demandée.
propertyQuota

object (PropertyQuota)

État du quota de cette propriété Analytics, y compris cette demande.
kind

string

Identifie le type de ressource de ce message. Cet élément kind est toujours la chaîne fixe "analyticsData#runFunnelReport". Utile pour distinguer les types de réponses en JSON.

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

DateRange

Un ensemble de jours contigu: startDate, startDate + 1, ..., endDate. Jusqu'à quatre plages de dates sont autorisées pour les demandes.

Représentation JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Champs
startDate

string

Date de début (incluse) de la requête au format YYYY-MM-DD. Ne peut pas être postérieure au endDate. Le format NdaysAgo, yesterday ou today est également accepté. Dans ce cas, la date est déduite du fuseau horaire de la propriété pour les rapports.
endDate

string

Date de fin inclusive de la requête au format YYYY-MM-DD. Ne peut pas être antérieur au startDate. Le format NdaysAgo, yesterday ou today est également accepté. Dans ce cas, la date est déduite du fuseau horaire de la propriété pour les rapports.
name

string

Attribue un nom à cette plage de dates. La dimension dateRange est associée à ce nom dans une réponse de rapport. Si cette règle est définie, elle ne peut pas commencer par date_range_ ni RESERVED_. Si ce champ n'est pas spécifié, les plages de dates sont nommées par leur index basé sur zéro dans la requête: date_range_0, date_range_1, etc.

Entonnoir

Configure l'entonnoir dans une demande de rapport sur les entonnoirs. Un entonnoir génère des rapports sur les utilisateurs au cours d'une série d'étapes.

L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes. Par exemple, comment les prospects deviennent-ils des clients potentiels, puis des acheteurs ? Comment les acheteurs ponctuels deviennent-ils des acheteurs fidèles ? À la lumière de ces informations, vous pouvez améliorer les parcours client inefficaces ou abandonnés.

Représentation JSON 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Champs
isOpenFunnel

boolean

Dans un entonnoir ouvert, les utilisateurs peuvent y accéder à n'importe quelle étape. S'il est fermé, ils doivent y accéder à la première étape. Facultatif. S'il n'est pas spécifié, un entonnoir fermé est utilisé.
steps[]

object (FunnelStep)

Étapes séquentielles de cet entonnoir de conversion.

FunnelStep

Les étapes définissent le parcours utilisateur que vous souhaitez mesurer. Les étapes contiennent une ou plusieurs conditions que vos utilisateurs doivent remplir pour être inclus dans cette étape du parcours de l'entonnoir.

Représentation JSON 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Champs
name

string

Nom distinctif de cette étape. Si aucune valeur n'est spécifiée, les étapes seront nommées d'après un nom indexé basé sur 1 (par exemple, "0. ", "1. ", etc.). Ce nom définit la valeur de chaîne renvoyée par la dimension funnelStepName. Par exemple, si vous spécifiez name = Purchase dans la troisième étape de l'entonnoir de la requête, 3. Purchase sera généré dans la réponse du rapport sur les entonnoirs.
isDirectlyFollowedBy

boolean

Si la valeur est "true", cette étape doit directement faire suite à l'étape précédente. Si la valeur est "false", il peut y avoir des événements entre l'étape précédente et cette étape. S'il n'est pas spécifié, isDirectlyFollowedBy est considéré comme "false".
filterExpression

object (FunnelFilterExpression)

Condition à laquelle vos utilisateurs doivent remplir pour être inclus dans cette étape du parcours de l'entonnoir.
withinDurationFromPriorStep

string (Duration format)

Si elle est spécifiée, cette étape doit se terminer dans ce délai. withinDurationFromPriorStep inclut le point de terminaison à la microseconde près. Par exemple, une durée de 5 secondes peut être terminée à 4,9 ou 5 secondes, mais pas à 5 secondes et 1 microseconde.

withinDurationFromPriorStep est facultatif. S'il n'est pas spécifié, les étapes peuvent être séparées par une durée quelconque.

Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par "s". Exemple: "3.5s".

FunnelFilterExpression

Exprime les combinaisons de filtres d'entonnoir.

Représentation JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Champs
Champ d'union expr. Spécifiez un type de filtre pour FunnelFilterExpression. La expr ne peut être qu'un des éléments suivants :
andGroup

object (FunnelFilterExpressionList)

Les FunnelFilterExpression dans andGroup sont liés par une relation AND.
orGroup

object (FunnelFilterExpressionList)

Dans orGroup, il existe une relation OR pour les FunnelFilterExpressions.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression N'EST PAS notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Filtre d'entonnoir pour une dimension ou une métrique.
funnelEventFilter

object (FunnelEventFilter)

Crée un filtre qui correspond aux événements d'un seul nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom de l'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.

FunnelFilterExpressionList

Liste d'expressions de filtre d'entonnoir.

Représentation JSON 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Champs
expressions[]

object (FunnelFilterExpression)

Liste des expressions de filtre de l'entonnoir.

FunnelFieldFilter

Expression permettant de filtrer les valeurs des dimensions ou des métriques.

Représentation JSON 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Champs
fieldName

string

Nom de la dimension ou de la métrique.
Champ d'union one_filter. Spécifiez un type de filtre. one_filter ne peut être qu'un des éléments suivants :
stringFilter

object (StringFilter)

Filtre lié aux chaînes.
inListFilter

object (InListFilter)

Filtre pour les valeurs dans la liste.
numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou les dates.
betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

StringFilter

Filtre de chaîne

Représentation JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Champs
matchType

enum (MatchType)

Type de correspondance de ce filtre.
value

string

Valeur de chaîne utilisée pour la mise en correspondance.
caseSensitive

boolean

Si la valeur est "true", la valeur de la chaîne est sensible à la casse.

MatchType

Type de correspondance d'un filtre de chaîne

Enums
MATCH_TYPE_UNSPECIFIED Non spécifiée
EXACT Correspondance exacte de la valeur de la chaîne.
BEGINS_WITH Commence par la valeur de la chaîne.
ENDS_WITH Se termine par la valeur de la chaîne.
CONTAINS Contient la valeur de la chaîne.
FULL_REGEXP Correspondance complète pour l'expression régulière avec la valeur de la chaîne.
PARTIAL_REGEXP Correspondance partielle pour l'expression régulière avec la valeur de la chaîne.

InListFilter

Le résultat doit se trouver dans une liste de valeurs de chaîne.

Représentation JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Champs
values[]

string

Liste des valeurs de chaîne. Ce champ ne doit pas être vide.
caseSensitive

boolean

Si la valeur est "true", la valeur de la chaîne est sensible à la casse.

NumericFilter

Filtres pour les valeurs numériques ou les dates

Représentation JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Champs
operation

enum (Operation)

Type d'opération pour ce filtre.
value

object (NumericValue)

Valeur numérique ou date.

Opération

Opération appliquée à un filtre numérique

Enums
OPERATION_UNSPECIFIED URL indéterminée.
EQUAL Égal
LESS_THAN Moins de
LESS_THAN_OR_EQUAL Inférieur(e) ou égal(e) à
GREATER_THAN Supérieur(e) à
GREATER_THAN_OR_EQUAL Supérieur(e) ou égal(e) à

NumericValue

Représenter un nombre.

Représentation JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Champs
Champ d'union one_value. L'une des valeurs numériques one_value ne peut être qu'une seule des valeurs suivantes:
int64Value

string (int64 format)

Valeur entière
doubleValue

number

Valeur double

BetweenFilter

Pour exprimer que le résultat doit être compris entre deux nombres (inclus)

Représentation JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Champs
fromValue

object (NumericValue)

Commence par ce nombre.
toValue

object (NumericValue)

Se termine par ce numéro.

FunnelEventFilter

Crée un filtre qui correspond aux événements d'un seul nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom de l'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.

Représentation JSON 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Champs
eventName

string

Ce filtre correspond aux événements associés à ce nom d'événement unique. Veuillez indiquer le nom de l'événement.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

S'il est spécifié, ce filtre met en correspondance les événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre des paramètres.

Dans l'expression de filtre de paramètres, seuls les filtres de paramètres sont disponibles.

FunnelParameterFilterExpression

Exprime les combinaisons de filtres d'entonnoir sur les paramètres.

Représentation JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Champs
Champ d'union expr. Spécifiez un type de filtre pour FunnelParameterFilterExpression. La expr ne peut être qu'un des éléments suivants :
andGroup

object (FunnelParameterFilterExpressionList)

Dans andGroup, il existe une relation AND dans FunnelParameterFilterExpression.
orGroup

object (FunnelParameterFilterExpressionList)

Dans orGroup, il existe une relation OR pour les FunnelParameterFilterExpression.
notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression N'EST PAS notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Filtre de paramètre d'entonnoir primitif.

FunnelParameterFilterExpressionList

Liste d'expressions de filtre pour les paramètres de l'entonnoir.

Représentation JSON 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Champs
expressions[]

object (FunnelParameterFilterExpression)

Liste des expressions de filtre des paramètres de l'entonnoir.

FunnelParameterFilter

Expression permettant de filtrer les valeurs de paramètre dans un entonnoir.

Représentation JSON 
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Champs
Champ d'union one_parameter. Champ filtré. one_parameter ne peut être qu'un des éléments suivants :
eventParameterName

string

Ce filtre sera évalué en fonction du paramètre d'événement spécifié. Les paramètres d'événement sont enregistrés en tant que paramètres de l'événement. Les paramètres d'événement incluent des champs tels que"firebase_screen" et "currency".

Les paramètres d'événement ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent être utilisés que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément.
itemParameterName

string

Ce filtre sera évalué en fonction du paramètre d'élément spécifié. Les paramètres d'article sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres de l'article incluent des champs tels que"item_name" et "item_category".

Les paramètres d'élément ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent l'être que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément.

Les paramètres d'article ne sont disponibles que dans les événements d'e-commerce. Pour en savoir plus sur les événements d'e-commerce, consultez le guide Mesurer l'e-commerce.
Champ d'union one_filter. Spécifiez un type de filtre. one_filter ne peut être qu'un des éléments suivants :
stringFilter

object (StringFilter)

Filtre lié aux chaînes.
inListFilter

object (InListFilter)

Filtre pour les valeurs dans la liste.
numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou les dates.
betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

FunnelBreakdown

Les répartitions ajoutent une dimension à la réponse du sous-rapport du tableau de l'entonnoir.

Représentation JSON 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Champs
breakdownDimension

object (Dimension)

Colonne de dimension ajoutée à la réponse du sous-rapport du tableau d'entonnoir. La dimension "Répartition" détaille chaque étape de l'entonnoir. Un breakdownDimension valide est requis si funnelBreakdown est spécifié.
limit

string (int64 format)

Nombre maximal de valeurs distinctes de la dimension "Répartition" à renvoyer dans la réponse. Si la limite n'est pas spécifiée, la valeur limit de 5 est utilisée. La limite doit être supérieure à zéro et ne peut pas dépasser 15.

Dimension

Les dimensions correspondent aux attributs de vos données. Par exemple, la dimension "ville" indique la ville d'origine d'un événement. Dans les réponses aux rapports, les valeurs des dimensions sont des chaînes. Par exemple, la ville peut être "Paris" ou "New York".

Représentation JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Champs
name

string

Nom de la dimension. Consultez les dimensions de l'API pour obtenir la liste des noms de dimensions acceptés par les principales méthodes de création de rapports, telles que runReport et batchRunReports. Consultez Dimensions en temps réel pour obtenir la liste des noms de dimensions compatibles avec la méthode runRealtimeReport. Consultez Dimensions de l'entonnoir pour obtenir la liste des noms de dimensions compatibles avec la méthode runFunnelReport.

Si dimensionExpression est spécifié, name peut être n'importe quelle chaîne de votre choix, comprise dans le jeu de caractères autorisé. Par exemple, si une dimension dimensionExpression concatène country et city, vous pouvez appeler cette dimension countryAndCity. Les noms de dimension que vous choisissez doivent correspondre à l'expression régulière ^[a-zA-Z0-9_]$.

Les dimensions sont référencées par name dans dimensionFilter, orderBys, dimensionExpression et pivots.
dimensionExpression

object (DimensionExpression)

Une dimension peut être le résultat de l'expression de plusieurs dimensions. Par exemple, dimension "pays, ville": concatenate(country, ", ", city).

DimensionExpression

Permet d'exprimer une dimension résultant d'une formule de plusieurs dimensions. Exemples d'utilisation: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

Représentation JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Champs
Champ d'union one_expression. Spécifiez un type d'expression de dimension pour DimensionExpression. La one_expression ne peut être qu'un des éléments suivants :
lowerCase

object (CaseExpression)

Permet de convertir une valeur de dimension en minuscules.
upperCase

object (CaseExpression)

Permet de convertir une valeur de dimension en majuscules.
concatenate

object (ConcatenateExpression)

Permet de combiner des valeurs de dimension en une seule. Par exemple, dimension "pays, ville": concatenate(country, ", ", city).

CaseExpression

Permet de convertir une valeur de dimension en une casse.

Représentation JSON 
{
  "dimensionName": string
}
Champs
dimensionName

string

Nom d'une dimension. Le nom doit faire référence à un nom indiqué dans le champ de dimensions de la requête.

ConcatenateExpression

Permet de combiner des valeurs de dimension en une seule.

Représentation JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Champs
dimensionNames[]

string

Noms des dimensions. Les noms doivent faire référence aux noms indiqués dans le champ de dimensions de la requête.
delimiter

string

Délimiteur placé entre les noms de dimension.

Les délimiteurs sont souvent des caractères uniques tels que "|" ou ", mais peuvent être des chaînes plus longues. Si une valeur de dimension contient le délimiteur, les deux seront présentes dans la réponse sans distinction. Par exemple, si la valeur de la dimension 1 = "US,FR", la dimension 2 = "JP" et le séparateur = ", la réponse contiendra "US,FR,JP".

FunnelNextAction

Les actions suivantes indiquent la valeur d'une dimension une fois que l'utilisateur a terminé une étape, mais avant que ce même utilisateur ne réalise l'étape suivante. Par exemple, si nextActionDimension est défini sur eventName, nextActionDimension dans la ligne ie étape de l'entonnoir renvoie le premier événement après celui qui a qualifié l'utilisateur à la ie étape de l'entonnoir, mais avant qu'il n'atteigne la i+1e étape de l'entonnoir.

Représentation JSON 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Champs
nextActionDimension

object (Dimension)

Colonne de dimension ajoutée à la réponse du sous-rapport "Visualisation de l'entonnoir". La dimension d'action suivante affiche la valeur de dimension suivante de cette dimension une fois que l'utilisateur a atteint la ie étape de l'entonnoir de conversion.

Pour le moment, nextActionDimension n'accepte que eventName et la plupart des dimensions de page / d'écran, comme pageTitle et pagePath. nextActionDimension ne peut pas être une expression de dimension.
limit

string (int64 format)

Nombre maximal de valeurs distinctes de la dimension "Répartition" à renvoyer dans la réponse. Si la limite n'est pas spécifiée, la valeur limit de 5 est utilisée. La limite doit être supérieure à zéro et ne peut pas dépasser 5.

FunnelVisualizationType

Contrôle les dimensions présentes dans la réponse du sous-rapport "Visualisation de l'entonnoir".

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Type non spécifié.
STANDARD_FUNNEL Un entonnoir standard (en escalier). Le sous-rapport "Schéma de l'entonnoir" de la réponse ne contiendra pas de date.
TRENDED_FUNNEL Entonnoir linéaire (graphique en courbes) Le sous-rapport "Schéma de l'entonnoir" de la réponse contiendra la dimension "Date".

Segment

Un segment correspond à un sous-ensemble de vos données Analytics. Par exemple, parmi l'ensemble de vos utilisateurs, un segment peut regrouper les utilisateurs d'un pays ou d'une ville spécifiques. Un autre segment peut être constitué des utilisateurs qui achètent une certaine gamme de produits, qui consultent une section spécifique de votre site ou qui déclenchent des événements donnés au sein de votre application.

Pour en savoir plus, consultez Outil de création de segments GA4.

Représentation JSON 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
Champs
name

string

Nom de ce segment. S'ils ne sont pas spécifiés, les segments sont nommés "Segment". Ce nom définit la valeur de chaîne renvoyée par la dimension segment. La dimension segment ajoute un préfixe aux noms de segment en fonction du numéro d'index en base 1 du segment dans la requête (par exemple, "1. Segmenter", "2. Segment", etc.).
Champ d'union one_segment_scope. Un segment est spécifié dans un champ d'application. one_segment_scope ne peut être qu'un des éléments suivants :
userSegment

object (UserSegment)

Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs qui ont interagi avec votre site ou votre application.
sessionSegment

object (SessionSegment)

Les segments de sessions sont des sous-ensembles des sessions qui ont eu lieu sur votre site ou dans votre application.
eventSegment

object (EventSegment)

Les segments d'événements sont des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application.

UserSegment

Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs qui ont interagi avec votre site ou votre application. Par exemple, les utilisateurs qui ont déjà effectué un achat ou ceux qui ont ajouté des articles à leur panier, mais n'ont pas effectué d'achat.

Représentation JSON 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Champs
userInclusionCriteria

object (UserSegmentCriteria)

Définit les utilisateurs inclus dans ce segment. Facultatif.
exclusion

object (UserSegmentExclusion)

Définit les utilisateurs à exclure de ce segment. Facultatif.

UserSegmentCriteria

Un utilisateur correspond à un critère si ses événements répondent aux conditions du critère.

Représentation JSON 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Champs
andConditionGroups[]

object (UserSegmentConditionGroup)

Un utilisateur correspond à ces critères s'il correspond à chacune de ces andConditionGroups et à chacune des andSequenceGroups. andConditionGroups peut être vide si andSequenceGroups sont spécifiés.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Un utilisateur correspond à ces critères s'il correspond à chacune de ces andSequenceGroups et à chacune des andConditionGroups. andSequenceGroups peut être vide si andConditionGroups sont spécifiés.

UserSegmentConditionGroup

En définissant des conditions, vous pouvez indiquer à Analytics les données à inclure ou à exclure au niveau du segment.

Représentation JSON 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Champs
conditionScoping

enum (UserCriteriaScoping)

Les données sont incluses ou exclues du segment selon qu'elles correspondent au groupe de conditions. Cette portée définit le nombre d'événements sur lesquels segmentFilterExpression est évalué avant que le groupe de conditions ne soit déterminé comme correspondant ou non. Par exemple, si la valeur est conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, l'expression est évaluée sur tous les événements d'une session, puis le groupe de conditions est déterminé comme correspondant ou non à cet utilisateur. Par exemple, si conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, l'expression est évaluée sur un seul événement, puis le groupe de conditions est déterminé comme correspondant ou non pour cet utilisateur.

Facultatif. Si aucune valeur n'est spécifiée, conditionScoping = ACROSS_ALL_SESSIONS est utilisé.
segmentFilterExpression

object (SegmentFilterExpression)

Les données sont incluses ou non dans le segment selon qu'elles correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres.

UserCriteriaScoping

La portée spécifie les événements pris en compte lors de l'évaluation d'un utilisateur répondant à un critère.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Portée des critères non spécifiés. Ne pas préciser.
USER_CRITERIA_WITHIN_SAME_EVENT Si les critères sont remplis au cours d'un événement, l'utilisateur correspond aux critères.
USER_CRITERIA_WITHIN_SAME_SESSION Si les critères sont remplis au cours d'une session, l'utilisateur correspond.
USER_CRITERIA_ACROSS_ALL_SESSIONS Si un événement de l'utilisateur répond aux critères, celui-ci correspond aux critères.

SegmentFilterExpression

Exprime les combinaisons de filtres de segment.

Représentation JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Champs
Champ d'union expr. Spécifiez un type de filtre pour SegmentFilterExpression. La expr ne peut être qu'un des éléments suivants :
andGroup

object (SegmentFilterExpressionList)

L'expression SegmentFilterExpression dans andGroup est associée à une relation AND.
orGroup

object (SegmentFilterExpressionList)

L'expression SegmentFilterExpression dans orGroup a une relation OR.
notExpression

object (SegmentFilterExpression)

SegmentFilterExpression N'EST PAS notExpression.
segmentFilter

object (SegmentFilter)

Un filtre de segment primitif.
segmentEventFilter

object (SegmentEventFilter)

Crée un filtre qui correspond aux événements d'un seul nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom de l'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.

SegmentFilterExpressionList

Liste d'expressions de filtre de segment.

Représentation JSON 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Champs
expressions[]

object (SegmentFilterExpression)

La liste des expressions de filtre de segment

SegmentFilter

Expression permettant de filtrer les valeurs des dimensions ou des métriques.

Représentation JSON 
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Champs
fieldName

string

Nom de la dimension ou de la métrique.
filterScoping

object (SegmentFilterScoping)

Spécifie la portée du filtre.
Champ d'union one_filter. Spécifiez un type de filtre pour Filter. La one_filter ne peut être qu'un des éléments suivants :
stringFilter

object (StringFilter)

Filtre lié aux chaînes.
inListFilter

object (InListFilter)

Filtre pour les valeurs dans la liste.
numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou les dates.
betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

SegmentFilterScoping

Les portées indiquent comment les dimensions et métriques de plusieurs événements doivent être prises en compte lors de l'évaluation d'un filtre de segment.

Représentation JSON 
{
  "atAnyPointInTime": boolean
}
Champs
atAnyPointInTime

boolean

Si atAnyPointInTime est "true", ce filtre prend la valeur "true" pour tous les événements s'il prend la valeur "true" pour tout événement au cours de la période de la requête.

Ce paramètre atAnyPointInTime n'étend pas la plage de dates des événements du rapport. Si atAnyPointInTime est défini sur "true", seuls les événements compris dans la plage de dates du rapport sont pris en compte lors de l'évaluation de ce filtre.

Cette atAnyPointInTime ne peut être spécifiée que si la portée des critères est ACROSS_ALL_SESSIONS et qu'elle ne peut pas être spécifiée dans des séquences.

Si la portée des critères est ACROSS_ALL_SESSIONS, atAnyPointInTime = "false" est utilisé s'il n'est pas spécifié.

SegmentEventFilter

Crée un filtre qui correspond aux événements d'un seul nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom de l'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.

Représentation JSON 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Champs
eventName

string

Ce filtre correspond aux événements associés à ce nom d'événement unique. Veuillez indiquer le nom de l'événement.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

S'il est spécifié, ce filtre met en correspondance les événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre des paramètres.

Dans l'expression de filtre de paramètres, seuls les filtres de paramètres sont disponibles.

SegmentParameterFilterExpression

Exprime les combinaisons de filtres de segment sur les paramètres.

Représentation JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Champs
Champ d'union expr. Spécifiez un type de filtre pour SegmentParameterFilterExpression. La expr ne peut être qu'un des éléments suivants :
andGroup

object (SegmentParameterFilterExpressionList)

L'expression SegmentParameterFilterExpression dans andGroup est associée à une relation AND.
orGroup

object (SegmentParameterFilterExpressionList)

L'expression SegmentParameterFilterExpression dans orGroup est liée à une relation OR.
notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression N'EST PAS notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Un filtre de paramètre de segment primitif.

SegmentParameterFilterExpressionList

Liste d'expressions de filtre de paramètres de segment.

Représentation JSON 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Champs
expressions[]

object (SegmentParameterFilterExpression)

Liste des expressions de filtre des paramètres de segment.

SegmentParameterFilter

Expression permettant de filtrer les valeurs de paramètre dans un segment.

Représentation JSON 
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Champs
filterScoping

object (SegmentParameterFilterScoping)

Spécifie la portée du filtre.
Champ d'union one_parameter. Champ filtré. one_parameter ne peut être qu'un des éléments suivants :
eventParameterName

string

Ce filtre sera évalué en fonction du paramètre d'événement spécifié. Les paramètres d'événement sont enregistrés en tant que paramètres de l'événement. Les paramètres d'événement incluent des champs tels que"firebase_screen" et "currency".

Les paramètres d'événement ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent être utilisés que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément.
itemParameterName

string

Ce filtre sera évalué en fonction du paramètre d'élément spécifié. Les paramètres d'article sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres de l'article incluent des champs tels que"item_name" et "item_category".

Les paramètres d'élément ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent l'être que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément.

Les paramètres d'article ne sont disponibles que dans les événements d'e-commerce. Pour en savoir plus sur les événements d'e-commerce, consultez le guide Mesurer l'e-commerce.
Champ d'union one_filter. Spécifiez un type de filtre. one_filter ne peut être qu'un des éléments suivants :
stringFilter

object (StringFilter)

Filtre lié aux chaînes.
inListFilter

object (InListFilter)

Filtre pour les valeurs dans la liste.
numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou les dates.
betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

SegmentParameterFilterScoping

Les portées spécifient comment plusieurs événements doivent être pris en compte lors de l'évaluation d'un filtre de paramètre de segment.

Représentation JSON 
{
  "inAnyNDayPeriod": string
}
Champs
inAnyNDayPeriod

string (int64 format)

Accumule le paramètre sur la période de jours spécifiée avant d'appliquer le filtre. Uniquement disponible si la portée des critères est ACROSS_ALL_SESSIONS ou WITHIN_SAME_SESSION. Uniquement accepté si le paramètre est event_count.

Par exemple, si inAnyNDayPeriod est défini sur 3, que le paramètre eventName est "purchase", que le paramètre d'événement est "event_count" et que les critères du filtre sont supérieurs à 5, ce filtre accumulera le nombre d'événements d'achat sur une période de trois jours consécutifs au cours de la période du rapport. Un utilisateur transmet les critères de ce filtre à ce segment si le nombre d'événements d'achat dépasse 5 au cours d'une période de trois jours consécutifs. Par exemple, nous prenons en compte les périodes allant du 01/11/2021 au 03/11/2021, du 02/11/2021 au 04/11/2021, du 03/11/2021 au 05/11/2021, etc.

La période n'est pas étendue afin de couvrir N jours complets vers le début de la période. Par exemple, si un rapport porte sur la période du 01/11/2021 au 10/11/2021 et que la valeur de inAnyNDayPeriod est égale à 3, la période de deux premiers jours sera raccourcie, car aucune donnée d'événement située en dehors de la plage de dates du rapport ne sera lue. Par exemple, les quatre premières périodes seront en réalité du 01/11/2021 au 01/11/2021, du 01/11/2021 au 02/11/2021, du 01/11/2021 au 03/11/2021 et du 02/11/2021 au 01/11/2021.

inAnyNDayPeriod est facultatif. S'il n'est pas spécifié, la valeur segmentParameterFilter est appliquée à chaque événement individuellement.

UserSegmentSequenceGroup

Définissez les conditions qui doivent se produire dans un ordre spécifique pour que l'utilisateur soit membre du segment.

Représentation JSON 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Champs
sequenceScoping

enum (UserCriteriaScoping)

Toutes les étapes de la séquence doivent être respectées dans la portée pour que l'utilisateur corresponde à la séquence. Par exemple, si la valeur est sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, toutes les étapes de la séquence doivent être effectuées dans une seule session pour que l'utilisateur corresponde à la séquence. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT n'est pas compatible.

Facultatif. Si aucune valeur n'est spécifiée, conditionScoping = ACROSS_ALL_SESSIONS est utilisé.
sequenceMaximumDuration

string (Duration format)

Définit la période au cours de laquelle toute la séquence doit se dérouler (par exemple, 30 minutes). sequenceMaximumDuration inclut le point de terminaison à la microseconde près. Par exemple, une séquence d'une durée maximale de 5 secondes peut être terminée à 4,9 ou 5 secondes, mais pas à 5 secondes et 1 microseconde.

sequenceMaximumDuration est facultatif. S'il n'est pas spécifié, les séquences peuvent être terminées à n'importe quelle durée.

Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par "s". Exemple: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

Séquence ordonnée d'étapes de la condition. Les événements d'un utilisateur doivent terminer chaque étape pour que l'utilisateur corresponde à UserSegmentSequenceGroup.

UserSequenceStep

Condition qui doit se produire dans l'ordre des étapes spécifié pour que l'utilisateur corresponde à la séquence.

Représentation JSON 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Champs
isDirectlyFollowedBy

boolean

Si la valeur est "true", l'événement correspondant à cette étape doit être le tout suivant après celui qui a atteint la dernière étape. Si la valeur est "false", cette étape suit indirectement l'étape précédente. Par exemple, il peut y avoir des événements entre l'étape précédente et cette étape. Pour la première étape, isDirectlyFollowedBy doit être "false".
stepScoping

enum (UserCriteriaScoping)

Cette étape de la séquence doit être respectée dans la portée pour que l'utilisateur corresponde à la séquence. Par exemple, si la valeur est sequenceScoping = WITHIN_SAME_SESSION, les étapes de cette séquence doivent être effectuées en une seule session pour que l'utilisateur corresponde à la séquence. stepScoping = ACROSS_ALL_SESSIONS n'est autorisé que si sequenceScoping = ACROSS_ALL_SESSIONS.

Facultatif. S'il n'est pas spécifié, stepScoping utilise le même UserCriteriaScoping que sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Un utilisateur correspond à cette étape de la séquence si ses événements correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres.

UserSegmentExclusion

Indique les utilisateurs à exclure de ce segment.

Représentation JSON 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Champs
userExclusionDuration

enum (UserExclusionDuration)

Spécifie la durée d'une exclusion si un utilisateur correspond à l'userExclusionCriteria.

Facultatif. Si aucune valeur n'est spécifiée, userExclusionDuration sur USER_EXCLUSION_TEMPORARY est utilisé.
userExclusionCriteria

object (UserSegmentCriteria)

Si un utilisateur remplit cette condition, il est exclu du segment pour userExclusionDuration.

UserExclusionDuration

Énumère les options de durée d'une exclusion si un utilisateur correspond à userExclusionCriteria.

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED Durée d'exclusion non spécifiée. Ne pas préciser.
USER_EXCLUSION_TEMPORARY Excluez temporairement des utilisateurs du segment lorsqu'ils remplissent la condition userExclusionCriteria.
USER_EXCLUSION_PERMANENT Exclure définitivement des utilisateurs du segment s'ils remplissent la condition userExclusionCriteria.

SessionSegment

Les segments de sessions correspondent à des sous-ensembles de sessions qui ont eu lieu sur votre site ou dans votre application (par exemple, toutes les sessions provenant d'une campagne publicitaire spécifique).

Représentation JSON 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Champs
sessionInclusionCriteria

object (SessionSegmentCriteria)

Définit les sessions incluses dans ce segment. Facultatif.
exclusion

object (SessionSegmentExclusion)

Définit les sessions exclues de ce segment. Facultatif.

SessionSegmentCriteria

Une session correspond à un critère si ses événements répondent aux conditions définies dans ces critères.

Représentation JSON 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Champs
andConditionGroups[]

object (SessionSegmentConditionGroup)

Une session répond à ces critères si elle correspond à chacun de ces andConditionGroups.

SessionSegmentConditionGroup

En définissant des conditions, vous pouvez indiquer à Analytics les données à inclure ou à exclure au niveau du segment.

Représentation JSON 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Champs
conditionScoping

enum (SessionCriteriaScoping)

Les données sont incluses ou exclues du segment selon qu'elles correspondent au groupe de conditions. Cette portée définit le nombre d'événements sur lesquels segmentFilterExpression est évalué avant que le groupe de conditions ne soit déterminé comme correspondant ou non. Par exemple, si la valeur est conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, l'expression est évaluée sur tous les événements d'une session, puis le groupe de conditions est déterminé comme correspondant ou non à cette session. Par exemple, si la valeur est conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, l'expression est évaluée sur un seul événement, puis le groupe de conditions est déterminé comme correspondant ou non pour cette session.

Facultatif. Si aucune valeur n'est spécifiée, la valeur conditionScoping de WITHIN_SAME_SESSION est utilisée.
segmentFilterExpression

object (SegmentFilterExpression)

Les données sont incluses ou non dans le segment selon qu'elles correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres.

SessionCriteriaScoping

La portée spécifie les événements pris en compte lors de l'évaluation d'une session répondant à un critère.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Portée des critères non spécifiés. Ne pas préciser.
SESSION_CRITERIA_WITHIN_SAME_EVENT Si les critères sont remplis au cours d'un événement, la session les correspond.
SESSION_CRITERIA_WITHIN_SAME_SESSION Si les critères sont remplis au cours d'une session, cette dernière correspond aux critères.

SessionSegmentExclusion

Indique les sessions exclues de ce segment.

Représentation JSON 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Champs
sessionExclusionDuration

enum (SessionExclusionDuration)

Spécifie la durée d'une exclusion si une session correspond à l'sessionExclusionCriteria.

Facultatif. Si aucune valeur n'est spécifiée, la valeur sessionExclusionDuration de SESSION_EXCLUSION_TEMPORARY est utilisée.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Si une session remplit cette condition, elle est exclue du segment pour sessionExclusionDuration.

SessionExclusionDuration

Énumère les options de durée d'une exclusion si une session correspond à l'sessionExclusionCriteria.

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED Durée d'exclusion non spécifiée. Ne pas préciser.
SESSION_EXCLUSION_TEMPORARY Excluez temporairement les sessions du segment lorsqu'elles remplissent la condition sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Excluez définitivement les sessions du segment si elles remplissent la condition sessionExclusionCriteria.

EventSegment

Les segments d'événements sont des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application (par exemple, tous les événements d'achat effectués dans un lieu donné ou les événements app_exception qui se sont produits sur un système d'exploitation spécifique).

Représentation JSON 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Champs
eventInclusionCriteria

object (EventSegmentCriteria)

Définit les événements inclus dans ce segment. Facultatif.
exclusion

object (EventSegmentExclusion)

Définit les événements exclus de ce segment. Facultatif.

EventSegmentCriteria

Un événement correspond à un critère s'il remplit les conditions des critères.

Représentation JSON 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Champs
andConditionGroups[]

object (EventSegmentConditionGroup)

Un événement correspond à ces critères s'il correspond à chacun de ces andConditionGroups.

EventSegmentConditionGroup

En définissant des conditions, vous pouvez indiquer à Analytics les données à inclure ou à exclure au niveau du segment.

Représentation JSON 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Champs
conditionScoping

enum (EventCriteriaScoping)

conditionScoping doit toujours être EVENT_CRITERIA_WITHIN_SAME_EVENT.

Facultatif. Si aucune valeur n'est spécifiée, la valeur conditionScoping de EVENT_CRITERIA_WITHIN_SAME_EVENT est utilisée.
segmentFilterExpression

object (SegmentFilterExpression)

Les données sont incluses ou non dans le segment selon qu'elles correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres.

EventCriteriaScoping

La portée spécifie les événements pris en compte lors de l'évaluation si un événement répond à un critère.

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED Portée des critères non spécifiés. Ne pas préciser.
EVENT_CRITERIA_WITHIN_SAME_EVENT Si les critères sont remplis dans un événement, celui-ci correspond aux critères.

EventSegmentExclusion

Indique les événements exclus de ce segment.

Représentation JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Champs
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration doit toujours être PERMANENTLY_EXCLUDE.

Facultatif. Si aucune valeur n'est spécifiée, la valeur EVENT_EXCLUSION_PERMANENT de eventExclusionDuration est utilisée.
eventExclusionCriteria

object (EventSegmentCriteria)

Si un événement remplit cette condition, il est exclu du segment pour eventExclusionDuration.

EventExclusionDuration

Énumère les options de durée d'une exclusion si un événement correspond à eventExclusionCriteria.

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Durée d'exclusion non spécifiée. Ne pas préciser.
EVENT_EXCLUSION_PERMANENT Exclure définitivement des événements du segment s'ils remplissent déjà la condition eventExclusionCriteria.

FilterExpression

Pour exprimer des filtres de dimensions ou de métriques. Les champs d'une même FilterExpression doivent être tous des dimensions ou toutes des métriques.

Représentation JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Champs
Champ d'union expr. Spécifiez un type d'expression de filtre pour FilterExpression. La expr ne peut être qu'un des éléments suivants :
andGroup

object (FilterExpressionList)

Les objets FilterExpressions dans andGroup ont une relation AND.
orGroup

object (FilterExpressionList)

Les FilterExpressions dans orGroup ont une relation OR.
notExpression

object (FilterExpression)

FilterExpression n'est PAS notExpression.
filter

object (Filter)

Un filtre primitif. Dans la même "FilterExpression", tous les noms de champs du filtre doivent correspondre à toutes les dimensions ou à toutes les métriques.

FilterExpressionList

Liste d'expressions de filtre.

Représentation JSON 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Champs
expressions[]

object (FilterExpression)

Liste d'expressions de filtre.

Filtre

Expression permettant de filtrer les valeurs des dimensions ou des métriques.

Représentation JSON 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Champs
fieldName

string

Nom de la dimension ou de la métrique. Vous devez définir un nom dans les dimensions ou les métriques.
Champ d'union one_filter. Spécifiez un type de filtre pour Filter. La one_filter ne peut être qu'un des éléments suivants :
stringFilter

object (StringFilter)

Filtre lié aux chaînes.
inListFilter

object (InListFilter)

Filtre pour les valeurs dans la liste.
numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou les dates.
betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

FunnelSubReport

Les sous-rapports sur les entonnoirs contiennent les valeurs des données de dimension et de métrique. Par exemple, 12 utilisateurs ont atteint la deuxième étape de l'entonnoir.

Représentation JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Champs
dimensionHeaders[]

object (DimensionHeader)

Décrit les colonnes de dimension. Les rapports sur les entonnoirs incluent toujours la dimension "Étape de l'entonnoir" dans les réponses du sous-rapport. Des dimensions supplémentaires, telles que les répartitions, les dates et les prochaines actions, peuvent figurer dans la réponse si nécessaire.
metricHeaders[]

object (MetricHeader)

Décrit les colonnes de métriques. Les rapports sur les entonnoirs incluent toujours les utilisateurs actifs dans les réponses du sous-rapport. Le tableau de l'entonnoir comprend des métriques supplémentaires telles que le taux d'achèvement, et le taux d'abandon et le taux d'abandon.
rows[]

object (Row)

Lignes de combinaisons de valeurs de dimension et de valeurs de métriques dans le rapport.
metadata

object (FunnelResponseMetadata)

Métadonnées du rapport sur les entonnoirs.

DimensionHeader

Décrit une colonne de dimension du rapport. Les dimensions demandées dans un rapport génèrent des entrées de colonne dans les lignes et les DimensionHeaders. Toutefois, les dimensions utilisées exclusivement dans les filtres ou les expressions ne génèrent pas de colonnes dans un rapport. Par conséquent, ces dimensions ne produisent pas d'en-têtes.

Représentation JSON 
{
  "name": string
}
Champs
name

string

Nom de la dimension.

MetricHeader

Décrit une colonne de métriques du rapport. Les métriques visibles demandées dans un rapport génèrent des entrées de colonne dans les lignes et les MetricHeaders. Toutefois, les statistiques utilisées exclusivement dans les filtres ou les expressions ne génèrent pas de colonnes dans un rapport. Par conséquent, ces statistiques ne produisent pas d'en-têtes.

Représentation JSON 
{
  "name": string,
  "type": enum (MetricType)
}
Champs
name

string

Nom de la métrique.
type

enum (MetricType)

Type de données de la métrique.

MetricType

Type de valeur d'une métrique.

Enums
METRIC_TYPE_UNSPECIFIED Type non spécifié.
TYPE_INTEGER Type entier.
TYPE_FLOAT Type à virgule flottante.
TYPE_SECONDS Durée en secondes ; type spécial à virgule flottante.
TYPE_MILLISECONDS Durée en millisecondes ; type spécial à virgule flottante.
TYPE_MINUTES Durée en minutes ; type spécial à virgule flottante.
TYPE_HOURS Durée en heures ; type spécial à virgule flottante.
TYPE_STANDARD Métrique personnalisée de type standard ; type spécial à virgule flottante.
TYPE_CURRENCY Montant, type à virgule flottante spécial.
TYPE_FEET Longueur en pieds ; type spécial à virgule flottante.
TYPE_MILES Longueur en miles ; type spécial à virgule flottante.
TYPE_METERS Longueur en mètres ; type spécial à virgule flottante.
TYPE_KILOMETERS Longueur en kilomètres ; type spécial à virgule flottante.

Row

Données du rapport pour chaque ligne. Par exemple, si RunReportRequest contient:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

Une ligne avec "in_app_purchase" comme eventName, "JP" comme countryId et 15 comme eventCount est la suivante:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
Représentation JSON 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Champs
dimensionValues[]

object (DimensionValue)

Liste des valeurs de dimension demandées. Dans un rapport croisé dynamique, les valeurs dimensionValues ne sont répertoriées que pour les dimensions incluses dans un tableau croisé dynamique.
metricValues[]

object (MetricValue)

Liste des valeurs de métriques visibles demandées.

DimensionValue

Valeur d'une dimension.

Représentation JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Champs
Champ d'union one_value. Un type de valeur de dimension (one_value) ne peut être que l'un des éléments suivants:
value

string

Valeur en tant que chaîne si le type de dimension est une chaîne.

MetricValue

Valeur d'une métrique.

Représentation JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Champs
Champ d'union one_value. La valeur de métrique one_value ne peut être qu'une seule des valeurs suivantes:
value

string

Valeur de mesure. Consultez MetricHeader pour le type.

FunnelResponseMetadata

Les métadonnées de réponse du rapport sur les entonnoirs contiennent des informations supplémentaires sur celui-ci.

Représentation JSON 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Champs
samplingMetadatas[]

object (SamplingMetadata)

Si les résultats du rapport sur les entonnoirs sont échantillonnés, cette métrique indique le pourcentage d'événements qui ont été utilisés dans ce rapport. Un champ samplingMetadatas est renseigné pour chaque plage de dates. Chaque samplingMetadatas correspond à une plage de dates dans l'ordre dans lequel les plages de dates ont été spécifiées dans la requête.

Toutefois, si les résultats ne sont pas échantillonnés, ce champ ne sera pas défini.

SamplingMetadata

Si les résultats du rapport sur les entonnoirs sont échantillonnés, ces métadonnées indiquent le pourcentage d'événements qui ont été utilisés dans ce rapport pendant une période donnée. L'échantillonnage consiste à analyser un sous-ensemble de données afin de découvrir des informations pertinentes dans un ensemble de données plus vaste.

Représentation JSON 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Champs
samplesReadCount

string (int64 format)

Nombre total d'événements lus dans ce rapport échantillonné pour une période donnée. Taille du sous-ensemble de données de cette propriété analysées dans ce rapport sur les entonnoirs.
samplingSpaceSize

string (int64 format)

Nombre total d'événements présents dans les données de cette propriété qui auraient pu être analysés dans ce rapport sur les entonnoirs pour une période donnée. L'échantillonnage permet d'obtenir des informations pertinentes sur le plus grand ensemble de données, c'est-à-dire la taille de l'ensemble de données plus important.

Pour calculer le pourcentage de données disponibles qui a été utilisé dans ce rapport sur les entonnoirs, calculez samplesReadCount/samplingSpaceSize.

PropertyQuota

État actuel de tous les quotas pour cette propriété Analytics. Si un quota est épuisé pour une propriété, toutes les requêtes adressées à cette propriété renvoient une erreur "Ressource épuisée".

Représentation JSON 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
Champs
tokensPerDay

object (QuotaStatus)

Les propriétés Analytics standards peuvent utiliser jusqu'à 200 000 jetons par jour, tandis que les propriétés Analytics 360 peuvent en utiliser 2 000 000 par jour. La plupart des requêtes consomment moins de 10 jetons.
tokensPerHour

object (QuotaStatus)

Les propriétés Analytics standards peuvent utiliser jusqu'à 40 000 jetons par heure, tandis que les propriétés Analytics 360 peuvent en utiliser 400 000. Une requête API consomme un seul nombre de jetons, qui est déduit de tous les quotas horaires, quotidiens et horaires par projet.
concurrentRequests

object (QuotaStatus)

Les propriétés Analytics standards peuvent envoyer jusqu'à 10 demandes simultanées, tandis que les propriétés Analytics 360 peuvent en utiliser jusqu'à 50.
serverErrorsPerProjectPerHour

object (QuotaStatus)

Les propriétés Analytics standards et les paires de projets cloud peuvent comporter jusqu'à 10 erreurs de serveur par heure, tandis que les propriétés Analytics 360 et les associations de projets cloud peuvent comporter jusqu'à 50 erreurs de serveur par heure.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Les propriétés Analytics peuvent envoyer jusqu'à 120 demandes avec potentiellement un seuil de dimensions par heure. Dans une requête groupée, chaque demande de rapport est comptabilisée individuellement pour ce quota si la demande contient des dimensions potentiellement soumises à un seuil.
tokensPerProjectPerHour

object (QuotaStatus)

Les propriétés Analytics peuvent utiliser jusqu'à 35% de leurs jetons par projet et par heure. Cela équivaut aux propriétés Analytics standards, qui peuvent utiliser jusqu'à 14 000 jetons par projet et par heure, tandis que les propriétés Analytics 360 peuvent utiliser 140 000 jetons par projet et par heure. Une requête API consomme un seul nombre de jetons, qui est déduit de tous les quotas horaires, quotidiens et horaires par projet.

QuotaStatus

État actuel d'un groupe de quotas particulier.

Représentation JSON 
{
  "consumed": integer,
  "remaining": integer
}
Champs
consumed

integer

Quota utilisé par cette requête.
remaining

integer

Quota restant après cette demande.