Method: properties.runFunnelReport

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

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

Cette méthode a été introduite en version alpha afin de recueillir des commentaires sur la syntaxe et les fonctionnalités avant le passage à la version bêta. Pour nous faire part de vos commentaires sur cette API, veuillez remplir le formulaire Google Analytics Data API Funnel Reporting Feedback.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
property

string

Facultatif. Un identifiant de propriété GA4 Google Analytics dont les événements sont suivis. Il est spécifié dans le chemin de l'URL et non dans le corps. Pour en savoir plus, consultez Où trouver votre ID de propriété. Dans une requête par lot, cette propriété doit être soit non spécifiée, soit 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 (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Champs
dateRanges[]

object (DateRange)

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

Facultatif. Configuration de l'entonnoir de cette demande. Veuillez indiquer cette configuration d'entonnoir.

funnelBreakdown

object (FunnelBreakdown)

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

funnelNextAction

object (FunnelNextAction)

Facultatif. Si elle est spécifiée, l'action suivante ajoute une dimension à la réponse du sous-rapport "Visualisation de l'entonnoir". La dimension "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 (session_start et click, par exemple) et pour le total.

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

funnelVisualizationType

enum (FunnelVisualizationType)

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

segments[]

object (Segment)

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

Chaque segment spécifié dans cette requête produit une ligne distincte dans la réponse. dans la réponse, chaque segment identifié par son nom.

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

limit

string (int64 format)

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

L'API peut également renvoyer moins de lignes que la valeur limit demandée s'il n'y a pas autant de valeurs de dimension que limit.

dimensionFilter

object (FilterExpression)

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

returnPropertyQuota

boolean

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

Corps de la réponse

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

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 comportant l'étape de l'entonnoir, le segment, la dimension "Répartition", les utilisateurs actifs, le taux d'achèvement, le taux d'abandons et le taux d'abandons.

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

funnelVisualization

object (FunnelSubReport)

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

La dimension "Segment" n'est présente dans cette réponse que si un segment a été demandé. La dimension "Date" n'est présente dans cette réponse que si elle a été demandée via le type d'entonnoir TRENDED_FUNNEL. La dimension "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 (demande incluse).

kind

string

Identifie le type de ressource de ce message. Cet kind correspond toujours à la chaîne fixe "analyticsData#runFunnelReport". Utile pour distinguer 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

Entonnoir

Configure l'entonnoir dans une demande de rapport sur les entonnoirs. Un entonnoir de conversion présente les utilisateurs qui 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 (FunnelStep)
    }
  ]
}
Champs
isOpenFunnel

boolean

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. S'il n'est pas spécifié, un entonnoir fermé est utilisé.

steps[]

object (FunnelStep)

Les é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 que vos utilisateurs doivent remplir pour être inclus dans cette étape du parcours de l'entonnoir.

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

string

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

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 traité comme "false".

filterExpression

object (FunnelFilterExpression)

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

withinDurationFromPriorStep

string (Duration format)

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

withinDurationFromPriorStep est facultatif. Si aucune valeur n'est spécifiée, les étapes peuvent être séparées par une durée de votre choix.

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

FunnelFilterExpression

Exprime des combinaisons de filtres de l'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 valeurs FunnelFilterExpression dans andGroup ont une relation AND.

orGroup

object (FunnelFilterExpressionList)

Les valeurs FunnelFilterExpression dans orGroup ont une relation OR.

notExpression

object (FunnelFilterExpression)

FunnelFilterExpression n'est PAS de notExpression.

funnelFieldFilter

object (FunnelFieldFilter)

Filtre de l'entonnoir pour une dimension ou une métrique.

funnelEventFilter

object (FunnelEventFilter)

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

FunnelFilterExpressionList

Liste d'expressions de filtre d'entonnoir.

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

object (FunnelFilterExpression)

Liste des expressions de filtre de l'entonnoir.

FunnelFieldFilter

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

Représentation JSON
{
  "fieldName": string,

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

string

Nom de la dimension ou de la métrique.

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

object (StringFilter)

Filtre lié aux chaînes.

inListFilter

object (InListFilter)

Filtre dans les valeurs de la liste.

numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou de date.

betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

FunnelEventFilter

Crée un filtre qui correspond aux événements d'un même nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom 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 (FunnelParameterFilterExpression)
  }
}
Champs
eventName

string

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

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

S'il est spécifié, ce filtre établit une correspondance avec 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 valeurs FunnelParameterFilterExpression dans andGroup ont une relation AND.

orGroup

object (FunnelParameterFilterExpressionList)

Les valeurs FunnelParameterFilterExpression dans orGroup ont une relation OR.

notExpression

object (FunnelParameterFilterExpression)

"FunnelParameterFilterExpression" n'est PAS de notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Filtre de paramètre de l'entonnoir primitif.

FunnelParameterFilterExpressionList

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

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

object (FunnelParameterFilterExpression)

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

FunnelParameterFilter

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

Représentation JSON
{

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

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

string

Ce filtre sera évalué en fonction du paramètre d'événement spécifié. Les paramètres d'événement sont consigné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 des segments et et ne peuvent être utilisés que dans un filtre de descendant d'un filtre d'événement. Dans un filtre de descendant d'un filtre EventFilter, vous devez utiliser des 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 des articles. Les paramètres d'élément incluent des champs tels que "item_name" et "item_category".

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

Les paramètres d'article ne sont disponibles que dans les événements d'e-commerce. Pour en savoir plus sur les événements d'e-commerce, consultez le guide Mesurer l'e-commerce.

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

object (StringFilter)

Filtre lié aux chaînes.

inListFilter

object (InListFilter)

Filtre dans les valeurs de la liste.

numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou de date.

betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

FunnelBreakdown

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

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

object (Dimension)

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

limit

string (int64 format)

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

FunnelNextAction

Les actions suivantes indiquent la valeur d'une dimension après que l'utilisateur a atteint une étape, mais avant qu'il ait atteint l'étape suivante. Par exemple, si nextActionDimension est défini sur eventName, nextActionDimension sur la ie ligne de l'étape de l'entonnoir renvoie le premier événement après celui qui a conduit l'utilisateur à la ie étape de l'entonnoir, mais avant qu'il n'atteigne la i+1e étape de l'entonnoir.

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

object (Dimension)

Colonne de dimension ajoutée à la réponse du sous-rapport "Schéma 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.

nextActionDimension n'est actuellement compatible qu'avec eventName et la plupart des dimensions de page / d'écran comme pageTitle et pagePath. nextActionDimension ne peut pas être une expression de dimension.

limit

string (int64 format)

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

FunnelVisualizationType

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

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Type non spécifié.
STANDARD_FUNNEL Entonnoir de conversion standard (en escalier). Le sous-rapport "Visualisation de l'entonnoir" dans la réponse ne contiendra aucune date.
TRENDED_FUNNEL Entonnoir de conversion linéaire (graphique en courbes). Le sous-rapport "Visualisation de l'entonnoir" dans 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'il n'est pas spécifié, les segments sont nommés "Segment". Ce nom définit la valeur de chaîne renvoyée par la dimension segment. La dimension segment préfixe les noms de segment en fonction du numéro d'index en base 1 du segment dans la requête (par exemple, "1. Segment", "2. "Segmenter", etc.).

Champ d'union one_segment_scope. Un segment est spécifié dans une portée. 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 ayant interagi avec votre site ou votre application.

sessionSegment

object (SessionSegment)

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

eventSegment

object (EventSegment)

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

UserSegment

Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs ayant interagi avec votre site ou votre application. Par exemple, les utilisateurs ayant déjà effectué un achat : Utilisateurs ayant ajouté des articles à leur panier sans finaliser l'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.

UserSegmentCriteria

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

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

object (UserSegmentConditionGroup)

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

andSequenceGroups[]

object (UserSegmentSequenceGroup)

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

UserSegmentConditionGroup

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

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

enum (UserCriteriaScoping)

Les données sont incluses ou exclues du segment si elles correspondent au groupe de conditions. Ce champ d'application définit le nombre d'événements sur lesquels segmentFilterExpression est évalué avant que le groupe de conditions ne soit déterminé comme correspondant ou non. Par exemple, si la valeur est conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, l'expression est évaluée sur tous les événements d'une session, puis le groupe de conditions est déterminé comme correspondant ou non à cet utilisateur. Par exemple, si 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 si elles correspondent à cette expression. Les expressions expriment des critères sur des dimensions, des métriques et/ou des paramètres.

UserCriteriaScoping

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

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Portée des critères non spécifiés. Ne pas spécifier.
USER_CRITERIA_WITHIN_SAME_EVENT Si les critères sont remplis dans un événement, l'utilisateur y correspond.
USER_CRITERIA_WITHIN_SAME_SESSION Si les critères sont remplis au cours d'une session, l'utilisateur y correspond.
USER_CRITERIA_ACROSS_ALL_SESSIONS Si des événements pour l'utilisateur remplissent les critères, ce dernier y correspond.

SegmentFilterExpression

Exprime des combinaisons de filtres de segment.

Représentation JSON
{

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

object (SegmentFilterExpressionList)

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

orGroup

object (SegmentFilterExpressionList)

Les SegmentFilterExpression dans orGroup ont 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 d'un même nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.

SegmentFilterExpressionList

Liste d'expressions de filtre de segment.

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

object (SegmentFilterExpression)

Liste des expressions de filtre de segment

SegmentFilter

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

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

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

string

Nom de la dimension ou de la métrique.

filterScoping

object (SegmentFilterScoping)

Spécifie la portée du filtre.

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

object (StringFilter)

Filtre lié aux chaînes.

inListFilter

object (InListFilter)

Filtre dans les valeurs de la liste.

numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou de date.

betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

SegmentFilterScoping

Les champs d'application 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 la valeur atAnyPointInTime est "true", ce filtre prend la valeur "true" pour tous les événements s'il prend la valeur "true" pour tous les événements compris dans la plage de dates de la requête.

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

Ce atAnyPointInTime ne peut être spécifié que si le champ d'application des critères est ACROSS_ALL_SESSIONS et ne peut pas être spécifié sous forme de séquences.

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

SegmentEventFilter

Crée un filtre qui correspond aux événements d'un même nom d'événement. Si une expression de filtre de paramètre est spécifiée, seul le sous-ensemble d'événements qui correspond à la fois au nom 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 (SegmentParameterFilterExpression)
  }
}
Champs
eventName

string

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

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

S'il est spécifié, ce filtre établit une correspondance avec 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 des combinaisons de filtres de segment sur les paramètres.

Représentation JSON
{

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

object (SegmentParameterFilterExpressionList)

Les éléments SegmentParameterFilterExpression dans andGroup sont liés par une relation AND.

orGroup

object (SegmentParameterFilterExpressionList)

Les éléments SegmentParameterFilterExpression dans orGroup sont liés par 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ètre de segment.

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

object (SegmentParameterFilterExpression)

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

SegmentParameterFilter

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

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

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

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

object (SegmentParameterFilterScoping)

Spécifie la portée du filtre.

Champ d'union one_parameter. Champ filtré. one_parameter ne peut être qu'un des éléments suivants :
eventParameterName

string

Ce filtre sera évalué en fonction du paramètre d'événement spécifié. Les paramètres d'événement sont consigné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 des segments et et ne peuvent être utilisés que dans un filtre de descendant d'un filtre d'événement. Dans un filtre de descendant d'un filtre EventFilter, vous devez utiliser des 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 des articles. Les paramètres d'élément incluent des champs tels que "item_name" et "item_category".

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

Les paramètres d'article ne sont disponibles que dans les événements d'e-commerce. Pour en savoir plus sur les événements d'e-commerce, consultez le guide Mesurer l'e-commerce.

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

object (StringFilter)

Filtre lié aux chaînes.

inListFilter

object (InListFilter)

Filtre dans les valeurs de la liste.

numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou de date.

betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

SegmentParameterFilterScoping

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

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

string (int64 format)

Cumule le paramètre sur la période de jours spécifiée avant l'application du filtre. Uniquement disponible si le champ d'application des critères est ACROSS_ALL_SESSIONS ou WITHIN_SAME_SESSION. Compatible uniquement si le paramètre est event_count.

Par exemple, si inAnyNDayPeriod correspond à 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 cumule le nombre d'événements d'achat sur chaque période de trois jours consécutifs de la plage de dates du rapport. un utilisateur remplira les critères de ce filtre pour être inclus dans ce segment si son nombre d'événements d'achat dépasse 5 sur une période de trois jours consécutifs. Par exemple, les périodes 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. sont prises en compte.

La plage de dates n'est pas étendue pour qu'une fenêtre complète de N jours soit définie à proximité du début de la plage de dates. Par exemple, si un rapport dure du 01/11/2021 au 10/11/2021 et que inAnyNDayPeriod est égal à 3, la période de deux premiers jours sera 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: 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 01/11/2021 au 01/10/2021

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

UserSegmentSequenceGroup

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

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

enum (UserCriteriaScoping)

Toutes les étapes de la séquence doivent être satisfaites dans le champ d'application 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 au cours d'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 produire. 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 se terminer en 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 à tout moment.

Durée en secondes avec neuf chiffres au maximum 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 cet utilisateur corresponde à l'UserSegmentSequenceGroup.

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 (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Champs
isDirectlyFollowedBy

boolean

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

stepScoping

enum (UserCriteriaScoping)

Cette étape de séquence doit être respectée dans le champ d'application pour que l'utilisateur corresponde à la séquence. Par exemple, si la valeur est sequenceScoping = WITHIN_SAME_SESSION, ces étapes de la séquence doivent se terminer dans une session pour que l'utilisateur corresponde à la séquence. stepScoping = ACROSS_ALL_SESSIONS n'est autorisé que si sequenceScoping = ACROSS_ALL_SESSIONS.

Facultatif. Si aucune valeur n'est spécifiée, 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.

UserSegmentExclusion

Indique les utilisateurs exclus de ce segment.

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

enum (UserExclusionDuration)

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

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

userExclusionCriteria

object (UserSegmentCriteria)

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

UserExclusionDuration

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

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

SessionSegment

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

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

object (SessionSegmentCriteria)

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

exclusion

object (SessionSegmentExclusion)

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

SessionSegmentCriteria

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

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

object (SessionSegmentConditionGroup)

Une session correspond à 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 si elles correspondent au groupe de conditions. Ce champ d'application définit le nombre d'événements sur lesquels segmentFilterExpression est évalué avant que le groupe de conditions ne soit déterminé comme correspondant ou non. Par exemple, si la valeur est conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, l'expression est évaluée sur tous les événements d'une session, puis le groupe de conditions est déterminé comme correspondant ou non à cette session. Par exemple, si la valeur est conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, l'expression est évaluée sur un seul événement, puis le groupe de conditions est déterminé comme correspondant ou non à 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 si elles correspondent à cette expression. Les expressions expriment des critères sur des dimensions, des métriques et/ou des paramètres.

SessionCriteriaScoping

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

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Portée des critères non spécifiés. Ne pas spécifier.
SESSION_CRITERIA_WITHIN_SAME_EVENT Si les critères sont remplis dans un événement, la session y correspond.
SESSION_CRITERIA_WITHIN_SAME_SESSION Si les critères sont remplis au cours d'une session, la session y correspond.

SessionSegmentExclusion

Spécifie les sessions à exclure dans ce segment.

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

enum (SessionExclusionDuration)

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

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

sessionExclusionCriteria

object (SessionSegmentCriteria)

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

SessionExclusionDuration

Énumère la durée d'une exclusion si une session correspond à sessionExclusionCriteria.

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

EventSegment

Les segments d'événements sont des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application. par exemple, tous les événements d'achat effectués dans un lieu donné. 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 à exclure dans ce segment. Facultatif.

EventSegmentCriteria

Un événement correspond à 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 à chacun de ces andConditionGroups.

EventSegmentConditionGroup

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

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

enum (EventCriteriaScoping)

conditionScoping doit toujours être EVENT_CRITERIA_WITHIN_SAME_EVENT.

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

segmentFilterExpression

object (SegmentFilterExpression)

Les données sont incluses ou exclues du segment si elles correspondent à cette expression. Les expressions expriment des critères sur des dimensions, des métriques et/ou des paramètres.

EventCriteriaScoping

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

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED Portée des critères non spécifiés. Ne pas spécifier.
EVENT_CRITERIA_WITHIN_SAME_EVENT Si les critères sont remplis dans un événement, l'événement y correspond.

EventSegmentExclusion

Spécifie les événements à exclure dans 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 de l'appartenance au segment pour eventExclusionDuration.

EventExclusionDuration

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

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Durée d'exclusion non spécifiée. Ne pas spécifier.
EVENT_EXCLUSION_PERMANENT Excluez définitivement les événements du segment s'ils remplissent la condition eventExclusionCriteria.

FunnelSubReport

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

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

object (DimensionHeader)

Décrit les colonnes de dimensions. Les rapports sur les entonnoirs incluent toujours la dimension "Étape de l'entonnoir" dans les réponses des sous-rapports. D'autres dimensions telles que les répartitions, les dates et les actions suivantes peuvent figurer dans la réponse, si vous y êtes invité.

metricHeaders[]

object (MetricHeader)

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

rows[]

object (Row)

Lignes des combinaisons de valeurs des dimensions et des valeurs des métriques dans le rapport

metadata

object (FunnelResponseMetadata)

Métadonnées pour le rapport sur les entonnoirs.

FunnelResponseMetadata

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

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

object (SamplingMetadata)

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

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

SamplingMetadata

Si les résultats du rapport sur les entonnoirs sont échantillonnés, cette métadonnée décrit le pourcentage d'événements utilisés dans ce rapport pour une plage de dates. L'échantillonnage est la pratique qui consiste à analyser un sous-ensemble de toutes les données afin de découvrir les informations significatives dans un ensemble de données plus vaste.

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

string (int64 format)

Nombre total d'événements lus dans cet échantillon de rapport pour une période donnée. Il s'agit de la taille du sous-ensemble de données de cette propriété qui a été analysé dans ce rapport sur les entonnoirs.

samplingSpaceSize

string (int64 format)

Nombre total d'événements présents dans les données de cette propriété qui auraient pu être analysés dans ce rapport sur les entonnoirs pour une période donnée. L'échantillonnage permet de découvrir les informations pertinentes sur le jeu de données plus vaste, et il s'agit de la taille de l'ensemble de données plus vaste.

Pour calculer le pourcentage de données disponibles 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 pour une propriété est épuisé, toutes les requêtes adressées à cette propriété renvoient des erreurs "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. Les propriétés Analytics 360 peuvent utiliser 2 000 000 de jetons par jour. La plupart des requêtes consomment moins de 10 jetons.

tokensPerHour

object (QuotaStatus)

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

concurrentRequests

object (QuotaStatus)

Les propriétés Analytics standards peuvent envoyer jusqu'à 10 requêtes simultanées. Les propriétés Analytics 360 peuvent utiliser jusqu'à 50 requêtes simultanées.

serverErrorsPerProjectPerHour

object (QuotaStatus)

Les propriétés Analytics standards et les paires de projets cloud peuvent générer jusqu'à 10 erreurs de serveur par heure. Les propriétés Analytics 360 et les associations de projets cloud peuvent générer jusqu'à 50 erreurs de serveur par heure.

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Les propriétés Analytics peuvent envoyer jusqu'à 120 requêtes par heure, avec des dimensions potentiellement soumises à un seuil. Dans une requête groupée, chaque demande de rapport est comptabilisée individuellement pour ce quota si elle 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. Ainsi, les propriétés Analytics standards peuvent utiliser jusqu'à 14 000 jetons par projet et par heure, tandis que les propriétés Analytics 360 peuvent utiliser 140 000 jetons par projet et par heure. Une requête API utilise un seul nombre de jetons, et ce nombre est déduit de tous les quotas horaires, quotidiens et 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 demande.