Method: properties.runFunnelReport

Affiche un rapport personnalisé sur les entonnoirs contenant 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 les 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, remplissez le formulaire de commentaires sur les rapports sur les entonnoirs de conversion dans 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

Identifiant de propriété GA4 Google Analytics dont les événements font l'objet d'un suivi. Spécifiée 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)

Plages de dates des 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)

Configuration de l'entonnoir de conversion associé à cette demande. Cette configuration de l'entonnoir est obligatoire.
funnelBreakdown

object (FunnelBreakdown)

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

object (FunnelNextAction)

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 telles que pageTitle et pagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

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

object (Segment)

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 génère 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 à 4 segments.
limit

string (int64 format)

Nombre de lignes à renvoyer. 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é. La valeur de limit doit être positive.

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)

Les filtres de dimensions vous permettent de demander uniquement des valeurs de dimensions spécifiques dans le rapport. Pour obtenir des exemples, consultez l'article Création d'un rapport: filtres de dimensions. Impossible d'utiliser des métriques dans ce filtre.
returnPropertyQuota

boolean

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 d'un 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 présentant l'étape, le segment, la dimension "Répartition", le nombre d'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)

Le schéma de l'entonnoir se présente sous la forme d'un rapport présentant l'étape, le segment, la date, la dimension "Action suivante" et les utilisateurs actifs de l'entonnoir.

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 requête.
kind

string

Identifie le type de ressource de ce message. Cet kind est toujours la chaîne fixe "analyticsData#runFunnelReport". Utile pour faire la distinction entre les types de réponses au format 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 contigus: startDate, startDate + 1, ..., endDate. Les demandes sont autorisées jusqu'à quatre plages de dates.

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érieur à endDate. Le format NdaysAgo, yesterday ou today est également accepté. Dans ce cas, la date est déduite du fuseau horaire des rapports de la propriété.
endDate

string

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

string

Attribue un nom à cette plage de dates. La dimension dateRange est associée à ce nom dans une réponse de rapport. S'il est défini, il ne peut pas commencer par date_range_ ni RESERVED_. Si elles ne sont pas définies, les plages de dates sont nommées d'après 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. Si aucune valeur n'est spécifiée, un entonnoir fermé est utilisé.
steps[]

object (FunnelStep)

Étapes séquentielles de cet entonnoir de conversion.

Étapede l'entonnoir

Les étapes définissent le parcours utilisateur que vous souhaitez mesurer. Les étapes contiennent une ou plusieurs conditions que les 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 conversion 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 suivre directement 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. Si aucune valeur n'est spécifiée, 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 le délai qui suit la progression de l'étape précédente. withinDurationFromPriorStep inclut le point de terminaison à la microseconde près. Par exemple, une durée de 5 secondes peut être achevée à 4,9 ou 5 secondes, mais pas en 5 secondes et 1 microseconde.

withinDurationFromPriorStep est facultatif et, si aucune valeur n'est spécifiée, 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 et se terminant par "s". Exemple: "3.5s".

EntonnoirFilterExpression

Exprime des 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)

Les FunnelFilterExpression dans orGroup sont liés par une relation OR.
notExpression

object (FunnelFilterExpression)

La FunnelFilterExpression n'est PAS de 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 associés à un nom d'événement unique. 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 d'expressions de filtre d'entonnoir.

FiltreChampEntonnoir

Expression permettant de filtrer les valeurs de dimension ou de métrique.

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 des valeurs numériques ou de date.
betweenFilter

object (BetweenFilter)

Un filtre pour choisir entre deux valeurs.

FiltreChaîne

Filtre de chaîne

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

enum (MatchType)

Type de correspondance pour ce filtre.
value

string

Valeur de chaîne utilisée pour la 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é
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 de l'expression régulière avec la valeur de la chaîne.
PARTIAL_REGEXP Correspondance partielle de 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.

Numérique

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 de 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

Pour 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 que l'une des valeurs suivantes:
int64Value

string (int64 format)

Valeur entière
doubleValue

number

Valeur double

BetweenFilter

Pour indiquer que le résultat doit être compris entre deux nombres (inclusifs).

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 associés à un nom d'événement unique. 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 recherche 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ètre, seuls les filtres de paramètres sont disponibles.

FunnelParameterFilterExpression

Exprime des 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)

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

object (FunnelParameterFilterExpressionList)

Les FunnelParameterFilterExpression dans orGroup sont liés par une relation OR.
notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression n'est PAS de notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Filtre de paramètre d'entonnoir primitif.

FunnelParameterFilterExpressionList

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

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

object (FunnelParameterFilterExpression)

Liste d'expressions de filtre de paramètres d'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 l'être que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un 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 des articles sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres des articles 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 EventFilter, vous devez utiliser les paramètres d'événement ou d'élément.

Les paramètres des articles 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 des valeurs numériques ou de date.
betweenFilter

object (BetweenFilter)

Un filtre pour choisir entre deux valeurs.

Répartition de l'entonnoir

Les répartitions ajoutent une dimension à la réponse du sous-rapport du tableau d'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 élément breakdownDimension valide est requis si funnelBreakdown est spécifié.
limit

string (int64 format)

Nombre maximal de valeurs distinctes de la dimension "Répartition" à afficher dans la réponse. Si aucune limite n'est spécifiée, un limit de 5 est utilisé. 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'où provient un événement. Les valeurs des dimensions dans les réponses aux rapports 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. Reportez-vous à 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 que vous souhaitez 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, la 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, la dimension "pays, ville": concatenate(country, ", ", city).

ExpressionMajuscule

Permet de convertir une valeur de dimension en casse unique.

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

string

Nom d'une dimension. Le nom doit faire référence à un nom figurant dans le champ des 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 des 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 correspond à "US,FR", la valeur de dimension 2 sur "JP" et que le séparateur = ", la réponse contiendra "US,FR,JP".

ActionSuivantEntonnoir

Les actions suivantes indiquent la valeur d'une dimension une fois que l'utilisateur a terminé une étape, mais avant qu'il n'ait atteint l'étape suivante. Par exemple, si nextActionDimension est défini sur eventName, alors nextActionDimension dans la ligne de l'étape i de l'entonnoir renvoie le premier événement après l'événement qui a conduit l'utilisateur à la ie étape de l'entonnoir, mais avant qu'il n'ait atteint 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 de visualisation de l'entonnoir. La dimension d'action suivante renvoie la valeur de dimension suivante de cette dimension une fois que l'utilisateur a atteint la ie étape de l'entonnoir de conversion.

nextActionDimension n'accepte actuellement que eventName et la plupart des dimensions de page / d'écran telles que 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" à afficher dans la réponse. Si aucune limite n'est spécifiée, un limit de 5 est utilisé. La limite doit être supérieure à zéro et ne peut pas dépasser 5.

Type de visualisation de l'entonnoir

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

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Type non spécifié.
STANDARD_FUNNEL 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 le numéro d'index en base 1 du segment dans la requête (par exemple, "1. Segmenter", "2. Segmenter", 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 déclenchés sur votre site ou dans votre application.

Segment d'utilisateurs

Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs ayant 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 exclus de ce segment. Facultatif.

CritèresDeSegmentUtilisateur

Un utilisateur répond à un critère si ses événements remplissent les conditions définies.

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

object (UserSegmentConditionGroup)

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

object (UserSegmentSequenceGroup)

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

UtilisateurSegmentConditionGroup

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 ou non. Cette portée définit le nombre d'événements sur lesquels l'segmentFilterExpression est évaluée avant que le groupe de conditions soit identifié comme correspondant ou non. Par exemple, si la valeur est conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, l'expression est évaluée pour tous les événements d'une session, puis le groupe de conditions est déterminé comme correspondant ou non à cet utilisateur. Par exemple, si la valeur est 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 à 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 exclues du segment en fonction de leur correspondance avec cette expression. Les expressions expriment des critères sur des dimensions, des métriques et/ou des paramètres.

Critères utilisateur

La portée indique quels événements sont pris en compte pour déterminer si un utilisateur répond à 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 y répond.
USER_CRITERIA_WITHIN_SAME_SESSION Si les critères sont remplis au cours d'une session, l'utilisateur correspond aux critères.
USER_CRITERIA_ACROSS_ALL_SESSIONS Si un événement de l'utilisateur répond aux critères, celui-ci répond aux critères.

SegmentFilterExpression

Exprime des combinaisons de filtres de segments.

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'élément SegmentFilterExpression dans andGroup est associé à une relation AND.
orGroup

object (SegmentFilterExpressionList)

L'élément SegmentFilterExpression dans orGroup est associé à une relation OR.
notExpression

object (SegmentFilterExpression)

SegmentFilterExpression n'est PAS de notExpression.
segmentFilter

object (SegmentFilter)

Un filtre de segment primitif.
segmentEventFilter

object (SegmentEventFilter)

Crée un filtre qui correspond aux événements associés à un nom d'événement unique. 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

Une 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 de dimension ou de métrique.

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)

Indique 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 des valeurs numériques ou de date.
betweenFilter

object (BetweenFilter)

Un filtre pour choisir entre deux valeurs.

Champ d'application des filtres de segment

Les portées spécifient la manière dont les dimensions et les 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 compris dans la plage de dates de la requête.

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

Cet élément atAnyPointInTime ne peut être spécifié que si la portée des critères est ACROSS_ALL_SESSIONS et 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 associés à un nom d'événement unique. 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 recherche 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ètre, seuls les filtres de paramètres sont disponibles.

SegmentParameterFilterExpression

Exprime les combinaisons de filtres de segments au niveau des 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 associée à une relation OR.
notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression n'est PAS de notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

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 d'expressions de filtre de 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)

Indique 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 l'être que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un 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 des articles sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres des articles 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 EventFilter, vous devez utiliser les paramètres d'événement ou d'élément.

Les paramètres des articles 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 des valeurs numériques ou de date.
betweenFilter

object (BetweenFilter)

Un filtre pour choisir entre deux valeurs.

SegmentParameterFilterScoping

Les portées spécifient la manière dont 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 spécifiée, en jours, avant l'application du filtre. Uniquement disponible si la portée des critères est ACROSS_ALL_SESSIONS ou WITHIN_SAME_SESSION. Compatible uniquement 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 respectera les critères de ce filtre pour être inclus dans ce segment si son nombre d'événements d'achat est supérieur à 5 au cours d'une période de trois jours consécutifs. Par exemple, 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 d'avoir une fenêtre de N jours entiers 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 des deux premiers jours est raccourcie, car aucune donnée d'événement en dehors de la plage de dates du rapport ne sera lue. Par exemple, les quatre premières périodes seront les suivantes: 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 2021-11-02

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

UtilisateurSegmentSequenceGroup

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 se terminer en 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 en 5 secondes et 1 microseconde.

sequenceMaximumDuration est facultatif. Si aucune valeur n'est spécifiée, 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 et se terminant par "s". Exemple: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

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

Séquence de l'utilisateur

Condition qui doit se produire dans l'ordre des étapes spécifié pour que cet 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 l'événement correspondant à la dernière étape. Si la valeur est définie sur "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. isDirectlyFollowedBy doit avoir la valeur "false" pour la première étape.
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, cette étape de la séquence doit s'effectuer 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 sur des dimensions, des métriques et/ou des paramètres.

Exclusion du segment d'utilisateurs

Indique les utilisateurs à exclure de ce segment.

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

enum (UserExclusionDuration)

Indique la durée d'une exclusion si un utilisateur correspond à la 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.

Durée d'exclusion d'utilisateur

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

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED Durée de l'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 Excluez définitivement les utilisateurs du segment s'ils ont déjà rempli la condition userExclusionCriteria.

Segment de session

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 à inclure dans ce segment. Facultatif.
exclusion

object (SessionSegmentExclusion)

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

Critères de segments de session

Une session correspond à un critère si ses événements remplissent les conditions de 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 ou non. Cette portée définit le nombre d'événements sur lesquels l'segmentFilterExpression est évaluée avant que le groupe de conditions soit identifié 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 à cette session.

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

object (SegmentFilterExpression)

Les données sont incluses ou exclues du segment en fonction de leur correspondance avec cette expression. Les expressions expriment des critères sur des dimensions, des métriques et/ou des paramètres.

Critères de session

La portée indique les événements pris en compte lors de l'évaluation si une session répond à 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 correspond aux critères.
SESSION_CRITERIA_WITHIN_SAME_SESSION Si les critères sont remplis au cours d'une session, cette dernière correspond aux critères.

Exclusion du segment de session

Indique les sessions à exclure de ce segment.

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

enum (SessionExclusionDuration)

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

Facultatif. Si aucune valeur n'est spécifiée, une 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 de l'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 un jour la condition sessionExclusionCriteria.

Segment d'événements

Les segments d'événements sont des sous-ensembles d'événements 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.

CritèresduSegmentÉvénement

Un événement répond à un critère s'il remplit les conditions de ces critères.

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

object (EventSegmentConditionGroup)

Un événement correspond à ces critères s'il correspond à chacune 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, une conditionScoping de EVENT_CRITERIA_WITHIN_SAME_EVENT est utilisée.
segmentFilterExpression

object (SegmentFilterExpression)

Les données sont incluses ou exclues du segment en fonction de leur correspondance avec cette expression. Les expressions expriment des critères sur des dimensions, des métriques et/ou des paramètres.

Champ d'application des critères d'événement

La portée spécifie les événements pris en compte lors de l'évaluation de la satisfaction d'un événement à 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 au sein d'un événement, celui-ci correspond aux critères.

Exclusion du segment d'événements

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, une eventExclusionDuration de EVENT_EXCLUSION_PERMANENT 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 à la eventExclusionCriteria.

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Durée de l'exclusion non spécifiée. Ne pas préciser.
EVENT_EXCLUSION_PERMANENT Exclure définitivement des événements du segment s'ils remplissent un jour 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 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 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)

Filtre primitif. Dans la même FilterExpression, tous les noms de champs du filtre doivent être tous des dimensions ou toutes les métriques.

FilterExpressionList

Une liste d'expressions de filtre.

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

object (FilterExpression)

Une liste d'expressions de filtre.

Filtre

Expression permettant de filtrer les valeurs de dimension ou de métrique.

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 indiquer un nom défini 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 des valeurs numériques ou de date.
betweenFilter

object (BetweenFilter)

Un filtre pour choisir entre deux valeurs.

Sous-rapport sur les entonnoirs

Les sous-rapports sur les entonnoirs contiennent les valeurs des données de dimensions et de métriques. 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 vous en faites la demande.
metricHeaders[]

object (MetricHeader)

Décrit les colonnes de métriques. Les rapports sur les entonnoirs incluent toujours les utilisateurs actifs dans les réponses des sous-rapports. 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 valeurs de métriques dans le rapport.
metadata

object (FunnelResponseMetadata)

Métadonnées pour le 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. Cependant, les dimensions utilisées exclusivement dans les filtres ou les expressions ne génèrent pas de colonnes dans un rapport. De ce fait, 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étrique dans le 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 métriques utilisées exclusivement dans les filtres ou les expressions ne génèrent pas de colonnes dans un rapport. De même, ces métriques 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 d'argent ; type spécial à virgule flottante.
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" pour eventName, "JP" pour countryId et 15 pour eventCount, serait:

"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 PivotReport, les dimensionsValues 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 sous forme de 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. L'une des valeurs de métrique one_value ne peut être que l'une des valeurs suivantes:
value

string

Valeur de mesure. Reportez-vous à MetricHeader pour le type.

FunnelResponseMetadata

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

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. Une valeur samplingMetadatas est renseignée pour chaque plage de dates. Chaque samplingMetadatas correspond à une plage de dates dans l'ordre dans lequel des 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.

Métadonnées d'échantillonnage

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

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 plage de dates donnée. L'échantillonnage permet de découvrir des informations significatives sur un ensemble de données plus vaste. Il s'agit de la taille d'un ensemble de données plus vaste.

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. 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. 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 présenter jusqu'à 10 erreurs de serveur par heure. Les propriétés Analytics 360 et les paires de projets cloud peuvent présenter jusqu'à 50 erreurs de serveur par heure.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Les propriétés Analytics peuvent envoyer jusqu'à 120 demandes avec des dimensions potentiellement soumises à un seuil par heure. Dans une demande 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 peuvent utiliser jusqu'à 14 000 jetons par projet et par heure, et 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 consommé par cette requête.
remaining

integer

Quota restant après cette requête.