- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- Entonnoir
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segment
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- Essayer
Renvoie un rapport personnalisé sur l'entonnoir de vos données d'événements Google Analytics. Les données renvoyées par l'API se présentent sous la forme d'un tableau dont les colonnes correspondent aux dimensions et aux 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 générés via 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 |
Facultatif. Identifiant de propriété Google Analytics dont les événements sont suivis. Spécifié dans le chemin de l'URL et non dans le corps. Pour en savoir plus, consultez Où trouver l'ID de votre propriété. Dans une requête par lot, cette propriété ne doit pas être spécifiée ou doit être cohérente avec la propriété au niveau du lot. Exemple : properties/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 ( |
| Champs | |
|---|---|
dateRanges[] |
Facultatif. 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 pour les jours concernés sont incluses dans les lignes de réponse pour les deux plages de dates. |
funnel |
Facultatif. Configuration de l'entonnoir de cette requête. Cette configuration de l'entonnoir est obligatoire. |
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 de répartition développe chaque étape de l'entonnoir en valeurs uniques de la dimension de répartition. Par exemple, une répartition par dimension |
funnelNextAction |
Facultatif. Si elle est spécifiée, l'action suivante ajoute une dimension à la réponse du sous-rapport de visualisation de l'entonnoir. Cette dimension d'action suivante développe chaque étape de l'entonnoir en valeurs uniques de l'action suivante. Par exemple, une action suivante de la dimension L'action suivante n'est compatible qu'avec |
funnelVisualizationType |
Facultatif. Le type de visualisation de l'entonnoir contrôle les dimensions présentes dans la réponse du sous-rapport de visualisation de l'entonnoir. Si aucune valeur n'est spécifiée, |
segments[] |
Facultatif. Configurations des segments. Les segments sont des sous-ensembles de données d'une propriété. Dans un rapport sur l'entonnoir avec des segments, l'entonnoir est évalué dans chaque segment. Chaque segment spécifié dans cette requête 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 à quatre segments. |
limit |
Facultatif. 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é. L'API peut également renvoyer moins de lignes que le |
dimensionFilter |
Facultatif. Les filtres de dimensions vous permettent de demander uniquement des valeurs de dimension spécifiques dans le rapport. Pour en savoir plus, consultez Créer un rapport : filtres de dimension pour obtenir des exemples. Les métriques ne peuvent pas être utilisées dans ce filtre. |
returnPropertyQuota |
Facultatif. Indique s'il faut renvoyer l'état actuel du quota de cette propriété Analytics. Le quota est renvoyé dans PropertyQuota. |
Corps de la réponse
La réponse du rapport sur l'entonnoir contient deux sous-rapports. Ces 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 ( |
| Champs | |
|---|---|
funnelTable |
Le tableau de l'entonnoir est un rapport qui indique l'étape de l'entonnoir, le segment, la dimension de répartition, les utilisateurs actifs, le taux de finalisation, les abandons 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 de répartition n'est présente dans cette réponse que si elle a été demandée. |
funnelVisualization |
La visualisation de l'entonnoir est un rapport qui inclut 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 |
propertyQuota |
État du quota de cette propriété Analytics, y compris cette requête. |
kind |
Identifie le type de ressource de ce message. Cette valeur |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
Entonnoir
Configure l'entonnoir dans une demande de rapport sur les entonnoirs. Un entonnoir fournit des informations sur les utilisateurs à mesure qu'ils passent par une séquence 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 ( |
| Champs | |
|---|---|
isOpenFunnel |
Dans un entonnoir ouvert, les utilisateurs peuvent y accéder à n'importe quelle étape. Dans un entonnoir 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[] |
Étapes séquentielles de cet entonnoir. |
FunnelStep
Les étapes définissent le parcours utilisateur que vous souhaitez mesurer. Les étapes contiennent une ou plusieurs conditions à remplir par l'utilisateur pour être inclus dans cette étape du parcours de l'entonnoir de conversion.
| Représentation JSON |
|---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
| Champs | |
|---|---|
name |
Nom distinctif de cette étape. Si aucun nom n'est spécifié, les étapes sont nommées à l'aide d'un index basé sur 1 (par exemple, "0. ", "1. ", etc.). Ce nom définit la valeur de chaîne renvoyée par la dimension |
isDirectlyFollowedBy |
Si la valeur est "true", cette étape doit suivre directement l'étape précédente. Si la valeur est "false", des événements peuvent se produire entre l'étape précédente et celle-ci. Si aucune valeur n'est spécifiée, |
filterExpression |
Condition à remplir par vos utilisateurs pour être inclus dans cette étape du parcours de l'entonnoir de conversion. |
withinDurationFromPriorStep |
Si elle est spécifiée, cette étape doit être effectuée dans ce délai après la fin de l'étape précédente.
Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
FunnelFilterExpression
Exprime les combinaisons de filtres de l'entonnoir.
| Représentation JSON |
|---|
{ // Union field |
| 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 |
Les FunnelFilterExpression dans |
orGroup |
Les FunnelFilterExpression dans |
notExpression |
FunnelFilterExpression n'est PAS de type |
funnelFieldFilter |
Filtre de l'entonnoir pour une dimension ou une métrique. |
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 correspondent à la fois au nom d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement. |
FunnelFilterExpressionList
Liste des expressions de filtre de l'entonnoir.
| Représentation JSON |
|---|
{
"expressions": [
{
object ( |
| Champs | |
|---|---|
expressions[] |
Liste des expressions de filtre de l'entonnoir. |
FunnelFieldFilter
Expression permettant de filtrer les valeurs de dimension ou de métrique.
| Représentation JSON |
|---|
{ "fieldName": string, // Union field |
| Champs | |
|---|---|
fieldName |
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 |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs de la liste. |
numericFilter |
Filtre pour les valeurs numériques ou de date. |
betweenFilter |
Filtre pour une plage de valeurs. |
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 correspondent à la fois au nom d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.
| Représentation JSON |
|---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
| Champs | |
|---|---|
eventName |
Ce filtre correspond aux événements portant ce nom. Vous devez indiquer le nom de l'événement. |
funnelParameterFilterExpression |
Si ce filtre est spécifié, il correspond aux événements qui correspondent à la fois au nom d'événement unique et aux expressions de filtre de paramètres. Dans l'expression de filtre de paramètre, seuls les filtres de paramètre sont disponibles. |
FunnelParameterFilterExpression
Exprime des combinaisons de filtres d'entonnoir sur les paramètres.
| Représentation JSON |
|---|
{ // Union field |
| 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 |
Les FunnelParameterFilterExpression dans |
orGroup |
Les FunnelParameterFilterExpression dans |
notExpression |
FunnelParameterFilterExpression n'est PAS de type |
funnelParameterFilter |
Filtre de paramètre d'entonnoir primitif. |
FunnelParameterFilterExpressionList
Liste des expressions de filtre des paramètres de l'entonnoir.
| Représentation JSON |
|---|
{
"expressions": [
{
object ( |
| Champs | |
|---|---|
expressions[] |
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 |
| Champs | |
|---|---|
Champ d'union one_parameter. Champ filtré. one_parameter ne peut être qu'un des éléments suivants : |
|
eventParameterName |
Ce filtre sera évalué sur le 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 uniquement dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un EventFilter, des paramètres d'événement ou d'élément doivent être utilisés. |
itemParameterName |
Ce filtre sera évalué sur le paramètre d'article spécifié. Les paramètres d'article sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres d'article incluent des champs tels que"item_name" et "item_category". Les paramètres d'article ne peuvent être utilisés que dans les segments et les entonnoirs, et uniquement dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un EventFilter, des paramètres d'événement ou d'élément doivent être utilisés. 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 |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs de la liste. |
numericFilter |
Filtre pour les valeurs numériques ou de date. |
betweenFilter |
Filtre pour une plage de valeurs. |
FunnelBreakdown
Les répartitions ajoutent une dimension à la réponse du sous-rapport du tableau de l'entonnoir.
| Représentation JSON |
|---|
{
"breakdownDimension": {
object ( |
| Champs | |
|---|---|
breakdownDimension |
Colonne de dimension ajoutée à la réponse du sous-rapport du tableau de l'entonnoir. La dimension de répartition décompose chaque étape de l'entonnoir. Une valeur |
limit |
Nombre maximal de valeurs distinctes de la dimension de répartition à renvoyer dans la réponse. Une |
FunnelNextAction
Les actions suivantes indiquent la valeur d'une dimension après qu'un utilisateur a effectué une étape, mais avant qu'il n'ait effectué l'étape suivante. Par exemple, si nextActionDimension est eventName, alors nextActionDimension dans la ligne de la ie étape de l'entonnoir renverra le premier événement après l'événement qui a qualifié l'utilisateur pour la ie étape de l'entonnoir, mais avant que l'utilisateur ait atteint la i+1e étape de l'entonnoir.
| Représentation JSON |
|---|
{
"nextActionDimension": {
object ( |
| Champs | |
|---|---|
nextActionDimension |
Colonne de dimension ajoutée à la réponse du sous-rapport de visualisation de l'entonnoir. La dimension "Action suivante" renvoie la valeur de dimension suivante après que l'utilisateur a atteint la
|
limit |
Nombre maximal de valeurs distinctes de la dimension de répartition à renvoyer dans la réponse. Une |
FunnelVisualizationType
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 (par étapes). Le sous-rapport de visualisation de l'entonnoir dans la réponse ne contiendra pas de date. |
TRENDED_FUNNEL |
Un entonnoir de conversion avec tendance (graphique en courbes). Le sous-rapport de visualisation de l'entonnoir dans la réponse contiendra la dimension de 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.
| Représentation JSON |
|---|
{ "name": string, // Union field |
| Champs | |
|---|---|
name |
Nom de ce segment. Si aucun nom n'est spécifié, les segments sont nommés "Segment". Ce nom définit la valeur de chaîne renvoyée par la dimension |
Champ d'union one_segment_scope. Un segment est spécifié dans un seul champ d'application. one_segment_scope ne peut être qu'un des éléments suivants : |
|
userSegment |
Les segments d'utilisateurs sont des sous-ensembles d'utilisateurs ayant interagi avec votre site ou votre application. |
sessionSegment |
Les segments de sessions correspondent à des sous-ensembles de sessions qui ont eu lieu sur votre site ou dans votre application. |
eventSegment |
Les segments d'événements correspondent à 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, sans effectuer d'achat).
| Représentation JSON |
|---|
{ "userInclusionCriteria": { object ( |
| Champs | |
|---|---|
userInclusionCriteria |
Définit les utilisateurs inclus dans ce segment. Facultatif. |
exclusion |
Définit les utilisateurs exclus de ce segment. Facultatif. |
UserSegmentCriteria
Un utilisateur correspond à un critère si ses événements remplissent les conditions de ce critère.
| Représentation JSON |
|---|
{ "andConditionGroups": [ { object ( |
| Champs | |
|---|---|
andConditionGroups[] |
Un utilisateur correspond à ce critère s'il correspond à chacun des |
andSequenceGroups[] |
Un utilisateur correspond à ce critère s'il correspond à chacun des |
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 ( |
| Champs | |
|---|---|
conditionScoping |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non au groupe de conditions. Cette portée définit le nombre d'événements sur lesquels Facultatif. Si aucune valeur n'est spécifiée, |
segmentFilterExpression |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non à cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
UserCriteriaScoping
Le champ "Portée" indique les événements à prendre en compte pour déterminer si un utilisateur remplit un critère.
| Enums | |
|---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Critères non spécifiés. Ne spécifiez pas. |
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 aux critères. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Si un utilisateur déclenche un événement qui correspond aux critères, il est considéré comme correspondant aux critères. |
SegmentFilterExpression
Exprime des combinaisons de filtres de segment.
| Représentation JSON |
|---|
{ // Union field |
| 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 |
Les SegmentFilterExpression dans |
orGroup |
Les SegmentFilterExpression dans |
notExpression |
SegmentFilterExpression n'est PAS de |
segmentFilter |
Filtre de segment primitif. |
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 correspondent à la fois au nom d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement. |
SegmentFilterExpressionList
Liste des expressions de filtre de segment.
| Représentation JSON |
|---|
{
"expressions": [
{
object ( |
| Champs | |
|---|---|
expressions[] |
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 ( |
| Champs | |
|---|---|
fieldName |
Nom de la dimension ou de la métrique. |
filterScoping |
Spécifie le champ d'application 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 |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs de la liste. |
numericFilter |
Filtre pour les valeurs numériques ou de date. |
betweenFilter |
Filtre pour une plage de valeurs. |
SegmentFilterScoping
Les portées spécifient comment 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 |
Si Ce paramètre Ce Si le champ d'application des critères est |
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 correspondent à la fois au nom d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.
| Représentation JSON |
|---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
| Champs | |
|---|---|
eventName |
Ce filtre correspond aux événements portant ce nom. Vous devez indiquer le nom de l'événement. |
segmentParameterFilterExpression |
Si ce filtre est spécifié, il correspond aux événements qui correspondent à la fois au nom d'événement unique et aux expressions de filtre de paramètres. Dans l'expression de filtre de paramètre, seuls les filtres de paramètre sont disponibles. |
SegmentParameterFilterExpression
Exprime des combinaisons de filtres de segment sur les paramètres.
| Représentation JSON |
|---|
{ // Union field |
| 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 |
Les SegmentParameterFilterExpression dans |
orGroup |
Les SegmentParameterFilterExpression dans |
notExpression |
SegmentParameterFilterExpression n'est PAS de type |
segmentParameterFilter |
Filtre de paramètre de segment primitif. |
SegmentParameterFilterExpressionList
Liste des expressions de filtre de paramètre de segment.
| Représentation JSON |
|---|
{
"expressions": [
{
object ( |
| Champs | |
|---|---|
expressions[] |
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 ( |
| Champs | |
|---|---|
filterScoping |
Spécifie le champ d'application du filtre. |
Champ d'union one_parameter. Champ filtré. one_parameter ne peut être qu'un des éléments suivants : |
|
eventParameterName |
Ce filtre sera évalué sur le 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 uniquement dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un EventFilter, des paramètres d'événement ou d'élément doivent être utilisés. |
itemParameterName |
Ce filtre sera évalué sur le paramètre d'article spécifié. Les paramètres d'article sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres d'article incluent des champs tels que"item_name" et "item_category". Les paramètres d'article ne peuvent être utilisés que dans les segments et les entonnoirs, et uniquement dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un EventFilter, des paramètres d'événement ou d'élément doivent être utilisés. 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 |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs de la liste. |
numericFilter |
Filtre pour les valeurs numériques ou de date. |
betweenFilter |
Filtre pour une plage de valeurs. |
SegmentParameterFilterScoping
Les portées spécifient la façon 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 |
Accumule le paramètre sur la période spécifiée en jours avant d'appliquer le filtre. Uniquement compatible si le champ d'application des critères est Par exemple, si La plage de dates n'est pas étendue pour avoir une fenêtre complète de N jours au début de la plage de dates. Par exemple, si un rapport porte sur la période du 1er au 10 novembre 2021 et que
|
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 ( |
| Champs | |
|---|---|
sequenceScoping |
Toutes les étapes de la séquence doivent être respectées dans le champ d'application pour que l'utilisateur corresponde à la séquence. Par exemple, si la valeur est Facultatif. Si aucune valeur n'est spécifiée, |
sequenceMaximumDuration |
Définit la période au cours de laquelle toute la séquence doit se dérouler (par exemple, 30 minutes).
Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
userSequenceSteps[] |
Séquence ordonnée d'étapes de condition. Pour qu'un utilisateur corresponde à |
UserSequenceStep
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 ( |
| Champs | |
|---|---|
isDirectlyFollowedBy |
Si la valeur est "true", l'événement correspondant à cette étape doit être l'événement suivant immédiatement après celui correspondant à l'étape précédente. 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 celle-ci. |
stepScoping |
Cette étape de la séquence doit être respectée dans le champ d'application pour que l'utilisateur corresponde à la séquence. Par exemple, si la séquence est Facultatif. Si aucune valeur n'est spécifiée, |
segmentFilterExpression |
Un utilisateur correspond à cette étape de la séquence si ses événements correspondent à cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
UserSegmentExclusion
Spécifie les utilisateurs exclus de ce segment.
| Représentation JSON |
|---|
{ "userExclusionDuration": enum ( |
| Champs | |
|---|---|
userExclusionDuration |
Indique la durée d'une exclusion si un utilisateur correspond à Facultatif. Si aucune valeur n'est spécifiée, |
userExclusionCriteria |
Si un utilisateur remplit cette condition, il est exclu du segment pendant |
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 spécifiez pas. |
USER_EXCLUSION_TEMPORARY |
Excluez temporairement les utilisateurs du segment lorsqu'ils remplissent la condition userExclusionCriteria. |
USER_EXCLUSION_PERMANENT |
Excluez définitivement les 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 ( |
| Champs | |
|---|---|
sessionInclusionCriteria |
Définit les sessions incluses dans ce segment. Facultatif. |
exclusion |
Définit les sessions exclues de ce segment. Facultatif. |
SessionSegmentCriteria
Une session correspond à un critère si ses événements remplissent les conditions du critère.
| Représentation JSON |
|---|
{
"andConditionGroups": [
{
object ( |
| Champs | |
|---|---|
andConditionGroups[] |
Une session correspond à ce critère si elle correspond à chacun de ces |
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 ( |
| Champs | |
|---|---|
conditionScoping |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non au groupe de conditions. Cette portée définit le nombre d'événements sur lesquels Facultatif. Si aucune valeur n'est spécifiée, une |
segmentFilterExpression |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non à cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
SessionCriteriaScoping
La portée indique les événements pris en compte pour déterminer si une session répond à un critère.
| Enums | |
|---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Critères non spécifiés. Ne spécifiez pas. |
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, celle-ci y correspond. |
SessionSegmentExclusion
Spécifie les sessions exclues de ce segment.
| Représentation JSON |
|---|
{ "sessionExclusionDuration": enum ( |
| Champs | |
|---|---|
sessionExclusionDuration |
Indique la durée d'une exclusion si une session correspond à Facultatif. Si aucune valeur n'est spécifiée, une |
sessionExclusionCriteria |
Si une session remplit cette condition, elle est exclue de l'appartenance au segment pour |
SessionExclusionDuration
Énumère les options de durée d'une exclusion si une session correspond à sessionExclusionCriteria.
| Enums | |
|---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Durée d'exclusion non spécifiée. Ne spécifiez pas. |
SESSION_EXCLUSION_TEMPORARY |
Excluez temporairement les sessions du segment pendant les périodes où 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 correspondent à 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 réalisés dans un lieu particulier ou les événements app_exception survenus sur un système d'exploitation spécifique).
| Représentation JSON |
|---|
{ "eventInclusionCriteria": { object ( |
| Champs | |
|---|---|
eventInclusionCriteria |
Définit les événements inclus dans ce segment. Facultatif. |
exclusion |
Définit les événements exclus de ce segment. Facultatif. |
EventSegmentCriteria
Un événement correspond à un critère s'il remplit les conditions de ce critère.
| Représentation JSON |
|---|
{
"andConditionGroups": [
{
object ( |
| Champs | |
|---|---|
andConditionGroups[] |
Un événement correspond à ce critère s'il correspond à chacun de ces |
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 ( |
| Champs | |
|---|---|
conditionScoping |
Facultatif. Si aucune valeur n'est spécifiée, une |
segmentFilterExpression |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non à cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
EventCriteriaScoping
La portée indique les événements pris en compte pour déterminer si un événement répond à un critère.
| Enums | |
|---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Critères non spécifiés. Ne spécifiez pas. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis dans un événement, celui-ci correspond aux critères. |
EventSegmentExclusion
Spécifie les événements exclus de ce segment.
| Représentation JSON |
|---|
{ "eventExclusionDuration": enum ( |
| Champs | |
|---|---|
eventExclusionDuration |
Facultatif. Si aucune valeur n'est spécifiée, une |
eventExclusionCriteria |
Si un événement remplit cette condition, il est exclu de l'appartenance au segment pour |
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 spécifiez pas. |
EVENT_EXCLUSION_PERMANENT |
Excluez définitivement les événements du segment si l'événement remplit la condition eventExclusionCriteria. |
FunnelSubReport
Les sous-rapports sur l'entonnoir contiennent les valeurs de 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 ( |
| Champs | |
|---|---|
dimensionHeaders[] |
Décrit les colonnes de dimensions. Les rapports sur l'entonnoir incluent toujours la dimension "Étape de l'entonnoir" dans les réponses des sous-rapports. Des dimensions supplémentaires telles que les répartitions, les dates et les prochaines actions peuvent être présentes dans la réponse si elles sont demandées. |
metricHeaders[] |
Décrit les colonnes de métriques. Les rapports sur l'entonnoir incluent toujours les utilisateurs actifs dans les réponses des sous-rapports. Le tableau de l'entonnoir inclut des métriques supplémentaires telles que le taux de finalisation, les abandons et le taux d'abandon. |
rows[] |
Lignes de combinaisons de valeurs de dimension et de valeurs de métrique dans le rapport. |
metadata |
Métadonnées du rapport sur l'entonnoir. |
FunnelResponseMetadata
Les métadonnées de réponse du rapport sur l'entonnoir contiennent des informations supplémentaires sur ce rapport.
| Représentation JSON |
|---|
{
"samplingMetadatas": [
{
object ( |
| Champs | |
|---|---|
samplingMetadatas[] |
Si les résultats du rapport sur l'entonnoir sont échantillonnés, cela indique le pourcentage d'événements utilisés dans ce rapport. Un Toutefois, si les résultats ne sont pas échantillonnés, ce champ ne sera pas défini. |