- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Entonnoir de conversion
- 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
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- Essayer
Affiche un rapport personnalisé sur les entonnoirs de vos données d'événement Google Analytics. Les données renvoyées par l'API se présentent sous forme de tableau avec des colonnes pour les dimensions et métriques demandées.
L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes. Par exemple, comment les prospects deviennent-ils des clients potentiels, puis des acheteurs ? Comment les acheteurs ponctuels deviennent-ils des acheteurs fidèles ? À la lumière de ces informations, vous pouvez améliorer les parcours client inefficaces ou abandonnés. Pour en savoir plus, consultez Explorations de l'entonnoir GA4.
Cette méthode a été introduite en version alpha afin de recueillir des commentaires sur la syntaxe et les fonctionnalités avant le passage à la version bêta. Pour nous faire part de vos commentaires sur cette API, répondez aux commentaires sur les rapports sur les entonnoirs de conversion de l'API Google Analytics Data.
Requête HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
property |
Facultatif. Un identifiant de propriété Google Analytics GA4 dont les événements sont suivis. Spécifié dans le chemin de l'URL et non dans le corps. Pour en savoir plus, découvrez où trouver votre ID de propriété. Dans une requête par lot, cette propriété ne doit pas être spécifiée ou correspondre à la propriété au niveau du lot. Exemple: propriétés/1234 |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "dateRanges": [ { object ( |
Champs | |
---|---|
dateRanges[] |
Facultatif. Plages de dates correspondant aux données à lire. Si plusieurs plages de dates sont demandées, chaque ligne de réponse contiendra un index de plage de dates basé sur zéro. Si deux plages de dates se chevauchent, les données d'événement des jours concernés sont incluses dans les lignes de réponse pour les deux plages de dates. |
funnel |
Facultatif. Configuration de l'entonnoir de conversion de cette demande. Cette configuration d'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 étend chaque étape de l'entonnoir aux valeurs uniques de la dimension "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 "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 L'action suivante n'est compatible qu'avec |
funnelVisualizationType |
Facultatif. Le type "Visualisation de l'entonnoir" contrôle les dimensions présentes dans la réponse du sous-rapport "Visualisation de l'entonnoir". Si aucune valeur n'est spécifiée, |
segments[] |
Facultatif. Configurations des segments. Les segments sont des sous-ensembles de données d'une propriété. Dans un rapport sur les entonnoirs comportant des segments, l'entonnoir est évalué dans chaque segment. Chaque segment spécifié dans cette demande produit une ligne distincte dans la réponse ; dans la réponse, chaque segment est identifié par son nom. Le paramètre "segments" est facultatif. Les requêtes sont limitées à quatre segments. |
limit |
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é. L'API peut également renvoyer moins de lignes que le |
dimensionFilter |
Facultatif. Les filtres de dimensions vous permettent de ne demander que des valeurs de dimensions spécifiques dans le rapport. Pour en savoir plus et obtenir des exemples, consultez la page Créer un rapport: filtres de dimensions. Impossible d'utiliser des métriques dans ce filtre. |
returnPropertyQuota |
Facultatif. Indique si l'état actuel du quota de cette propriété Analytics doit être affiché. Le quota est renvoyé dans PropertyQuota. |
Corps de la réponse
La réponse du rapport sur les entonnoirs contient deux sous-rapports. Les deux sous-rapports sont des combinaisons différentes de dimensions et de métriques.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{ "funnelTable": { object ( |
Champs | |
---|---|
funnelTable |
Le tableau de l'entonnoir est un rapport avec l'étape de l'entonnoir, le segment, la dimension "Répartition", les utilisateurs actifs, le taux d'achèvement, le taux d'abandon et le taux d'abandon. La dimension "Segment" n'est présente dans cette réponse que si un segment a été demandé. La dimension "Répartition" n'est présente dans cette réponse que si elle a été demandée. |
funnelVisualization |
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 |
propertyQuota |
État du quota de cette propriété Analytics, y compris cette demande. |
kind |
Identifie le type de ressource de ce message. Cet élément |
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 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 ( |
Champs | |
---|---|
isOpenFunnel |
Dans un entonnoir ouvert, les utilisateurs peuvent y accéder à n'importe quelle étape. S'il est fermé, ils doivent y accéder à la première étape. Facultatif. S'il n'est pas spécifié, un entonnoir fermé est utilisé. |
steps[] |
Étapes séquentielles de cet entonnoir de conversion. |
FunnelStep
Les étapes définissent le parcours utilisateur que vous souhaitez mesurer. Les étapes contiennent une ou plusieurs conditions que vos utilisateurs doivent remplir pour être inclus dans cette étape du parcours de l'entonnoir.
Représentation JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Champs | |
---|---|
name |
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 |
isDirectlyFollowedBy |
Si la valeur est "true", cette étape doit directement faire suite à l'étape précédente. Si la valeur est "false", il peut y avoir des événements entre l'étape précédente et cette étape. S'il n'est pas spécifié, |
filterExpression |
Condition à laquelle vos utilisateurs doivent remplir pour être inclus dans cette étape du parcours de l'entonnoir. |
withinDurationFromPriorStep |
Si elle est spécifiée, cette étape doit se terminer dans ce délai.
Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
FunnelFilterExpression
Exprime les combinaisons de filtres d'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 |
Dans |
notExpression |
FunnelFilterExpression N'EST PAS |
funnelFieldFilter |
Filtre d'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 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 ( |
Champs | |
---|---|
expressions[] |
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 |
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 dans la liste. |
numericFilter |
Filtre pour les valeurs numériques ou les dates. |
betweenFilter |
Filtre entre deux 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 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 ( |
Champs | |
---|---|
eventName |
Ce filtre correspond aux événements associés à ce nom d'événement unique. Veuillez indiquer le nom de l'événement. |
funnelParameterFilterExpression |
S'il est spécifié, ce filtre met en correspondance les événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre des paramètres. Dans l'expression de filtre de paramètres, seuls les filtres de paramètres sont disponibles. |
FunnelParameterFilterExpression
Exprime les combinaisons de filtres d'entonnoir sur les paramètres.
Représentation JSON |
---|
{ // Union field |
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 |
Dans |
orGroup |
Dans |
notExpression |
FunnelParameterFilterExpression N'EST PAS |
funnelParameterFilter |
Filtre de paramètre d'entonnoir primitif. |
FunnelParameterFilterExpressionList
Liste d'expressions de filtre pour les paramètres de l'entonnoir.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
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é en fonction du paramètre d'événement spécifié. Les paramètres d'événement sont enregistrés en tant que paramètres de l'événement. Les paramètres d'événement incluent des champs tels que"firebase_screen" et "currency". Les paramètres d'événement ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent être utilisés que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément. |
itemParameterName |
Ce filtre sera évalué en fonction du paramètre d'élément spécifié. Les paramètres d'article sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres de l'article incluent des champs tels que"item_name" et "item_category". Les paramètres d'élément ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent l'être que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément. Les paramètres d'article ne sont disponibles que dans les événements d'e-commerce. Pour en savoir plus sur les événements d'e-commerce, consultez le guide Mesurer l'e-commerce. |
Champ d'union one_filter . Spécifiez un type de filtre. one_filter ne peut être qu'un des éléments suivants : |
|
stringFilter |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs dans la liste. |
numericFilter |
Filtre pour les valeurs numériques ou les dates. |
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 ( |
Champs | |
---|---|
breakdownDimension |
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 |
limit |
Nombre maximal de valeurs distinctes de la dimension "Répartition" à renvoyer dans la réponse. Si la limite n'est pas spécifiée, la valeur |
FunnelNextAction
Les actions suivantes indiquent la valeur d'une dimension une fois que l'utilisateur a terminé une étape, mais avant que ce même utilisateur ne réalise l'étape suivante. Par exemple, si nextActionDimension
est défini sur eventName
, nextActionDimension
dans la ligne i
e étape de l'entonnoir renvoie le premier événement après celui qui a qualifié l'utilisateur à la i
e étape de l'entonnoir, mais avant qu'il n'atteigne la i+1
e étape de l'entonnoir.
Représentation JSON |
---|
{
"nextActionDimension": {
object ( |
Champs | |
---|---|
nextActionDimension |
Colonne de dimension ajoutée à la réponse du sous-rapport "Visualisation de l'entonnoir". La dimension d'action suivante affiche la valeur de dimension suivante de cette dimension une fois que l'utilisateur a atteint la Pour le moment, |
limit |
Nombre maximal de valeurs distinctes de la dimension "Répartition" à renvoyer dans la réponse. Si la limite n'est pas spécifiée, la valeur |
FunnelVisualizationType
Contrôle les dimensions présentes dans la réponse du sous-rapport "Visualisation de l'entonnoir".
Enums | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Type non spécifié. |
STANDARD_FUNNEL |
Un entonnoir standard (en escalier). Le sous-rapport "Schéma de l'entonnoir" de la réponse ne contiendra pas de date. |
TRENDED_FUNNEL |
Entonnoir linéaire (graphique en courbes) Le sous-rapport "Schéma de l'entonnoir" de la réponse contiendra la dimension "Date". |
Segment
Un segment correspond à un sous-ensemble de vos données Analytics. Par exemple, parmi l'ensemble de vos utilisateurs, un segment peut regrouper les utilisateurs d'un pays ou d'une ville spécifiques. Un autre segment peut être constitué des utilisateurs qui achètent une certaine gamme de produits, qui consultent une section spécifique de votre site ou qui déclenchent des événements donnés au sein de votre application.
Pour en savoir plus, consultez Outil de création de segments GA4.
Représentation JSON |
---|
{ "name": string, // Union field |
Champs | |
---|---|
name |
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 |
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 |
Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs qui ont interagi avec votre site ou votre application. |
sessionSegment |
Les segments de sessions sont des sous-ensembles des sessions qui ont eu lieu sur votre site ou dans votre application. |
eventSegment |
Les segments d'événements sont des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application. |
UserSegment
Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs qui ont interagi avec votre site ou votre application. Par exemple, les utilisateurs qui ont déjà effectué un achat ou ceux qui ont ajouté des articles à leur panier, mais n'ont pas effectué d'achat.
Représentation JSON |
---|
{ "userInclusionCriteria": { object ( |
Champs | |
---|---|
userInclusionCriteria |
Définit les utilisateurs inclus dans ce segment. Facultatif. |
exclusion |
Définit les utilisateurs à exclure de ce segment. Facultatif. |
UserSegmentCriteria
Un utilisateur correspond à un critère si ses événements répondent aux conditions du critère.
Représentation JSON |
---|
{ "andConditionGroups": [ { object ( |
Champs | |
---|---|
andConditionGroups[] |
Un utilisateur correspond à ces critères s'il correspond à chacune de ces |
andSequenceGroups[] |
Un utilisateur correspond à ces critères s'il correspond à chacune de ces |
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 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 non dans le segment selon qu'elles correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres. |
UserCriteriaScoping
La portée spécifie les événements pris en compte lors de l'évaluation d'un utilisateur répondant à un critère.
Enums | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Portée des critères non spécifiés. Ne pas préciser. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis au cours d'un événement, l'utilisateur correspond aux critères. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Si les critères sont remplis au cours d'une session, l'utilisateur correspond. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Si un événement de l'utilisateur répond aux critères, celui-ci correspond aux critères. |
SegmentFilterExpression
Exprime les combinaisons de filtres de segment.
Représentation JSON |
---|
{ // Union field |
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 |
L'expression SegmentFilterExpression dans |
orGroup |
L'expression SegmentFilterExpression dans |
notExpression |
SegmentFilterExpression N'EST PAS |
segmentFilter |
Un 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 correspond à la fois au nom de l'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement. |
SegmentFilterExpressionList
Liste d'expressions de filtre de segment.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
Champs | |
---|---|
expressions[] |
La liste des expressions de filtre de segment |
SegmentFilter
Expression permettant de filtrer les valeurs des dimensions ou des métriques.
Représentation JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
Champs | |
---|---|
fieldName |
Nom de la dimension ou de la métrique. |
filterScoping |
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 |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs dans la liste. |
numericFilter |
Filtre pour les valeurs numériques ou les dates. |
betweenFilter |
Filtre entre deux valeurs. |
SegmentFilterScoping
Les portées indiquent comment les dimensions et métriques de plusieurs événements doivent être prises en compte lors de l'évaluation d'un filtre de segment.
Représentation JSON |
---|
{ "atAnyPointInTime": boolean } |
Champs | |
---|---|
atAnyPointInTime |
Si Ce paramètre Cette Si la portée 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 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 ( |
Champs | |
---|---|
eventName |
Ce filtre correspond aux événements associés à ce nom d'événement unique. Veuillez indiquer le nom de l'événement. |
segmentParameterFilterExpression |
S'il est spécifié, ce filtre met en correspondance les événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre des paramètres. Dans l'expression de filtre de paramètres, seuls les filtres de paramètres sont disponibles. |
SegmentParameterFilterExpression
Exprime les combinaisons de filtres de segment sur les paramètres.
Représentation JSON |
---|
{ // Union field |
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 |
L'expression SegmentParameterFilterExpression dans |
orGroup |
L'expression SegmentParameterFilterExpression dans |
notExpression |
SegmentParameterFilterExpression N'EST PAS |
segmentParameterFilter |
Un filtre de paramètre de segment primitif. |
SegmentParameterFilterExpressionList
Liste d'expressions de filtre de paramètres de segment.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
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 la portée 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é en fonction du paramètre d'événement spécifié. Les paramètres d'événement sont enregistrés en tant que paramètres de l'événement. Les paramètres d'événement incluent des champs tels que"firebase_screen" et "currency". Les paramètres d'événement ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent être utilisés que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément. |
itemParameterName |
Ce filtre sera évalué en fonction du paramètre d'élément spécifié. Les paramètres d'article sont enregistrés en tant que paramètres dans le tableau d'articles. Les paramètres de l'article incluent des champs tels que"item_name" et "item_category". Les paramètres d'élément ne peuvent être utilisés que dans les segments et les entonnoirs, et ne peuvent l'être que dans un filtre descendant à partir d'un EventFilter. Dans un filtre descendant d'un filtre EventFilter, vous devez utiliser les paramètres d'événement ou d'élément. Les paramètres d'article ne sont disponibles que dans les événements d'e-commerce. Pour en savoir plus sur les événements d'e-commerce, consultez le guide Mesurer l'e-commerce. |
Champ d'union one_filter . Spécifiez un type de filtre. one_filter ne peut être qu'un des éléments suivants : |
|
stringFilter |
Filtre lié aux chaînes. |
inListFilter |
Filtre pour les valeurs dans la liste. |
numericFilter |
Filtre pour les valeurs numériques ou les dates. |
betweenFilter |
Filtre entre deux valeurs. |
SegmentParameterFilterScoping
Les portées spécifient comment plusieurs événements doivent être pris en compte lors de l'évaluation d'un filtre de paramètre de segment.
Représentation JSON |
---|
{ "inAnyNDayPeriod": string } |
Champs | |
---|---|
inAnyNDayPeriod |
Accumule le paramètre sur la période de jours spécifiée avant d'appliquer le filtre. Uniquement disponible si la portée des critères est Par exemple, si La période n'est pas étendue afin de couvrir N jours complets vers le début de la période. Par exemple, si un rapport porte sur la période du 01/11/2021 au 10/11/2021 et que la valeur de
|
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 la portée 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 un maximum de neuf chiffres après la virgule, se terminant par " |
userSequenceSteps[] |
Séquence ordonnée d'étapes de la condition. Les événements d'un utilisateur doivent terminer chaque étape pour que l'utilisateur corresponde à |
UserSequenceStep
Condition qui doit se produire dans l'ordre des étapes spécifié pour que l'utilisateur corresponde à la séquence.
Représentation JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Champs | |
---|---|
isDirectlyFollowedBy |
Si la valeur est "true", l'événement correspondant à cette étape doit être le tout suivant après celui qui a atteint la dernière étape. Si la valeur est "false", cette étape suit indirectement l'étape précédente. Par exemple, il peut y avoir des événements entre l'étape précédente et cette étape. Pour la première étape, |
stepScoping |
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 Facultatif. S'il n'est pas spécifié, |
segmentFilterExpression |
Un utilisateur correspond à cette étape de la séquence si ses événements correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres. |
UserSegmentExclusion
Indique les utilisateurs à exclure de ce segment.
Représentation JSON |
---|
{ "userExclusionDuration": enum ( |
Champs | |
---|---|
userExclusionDuration |
Spécifie la durée d'une exclusion si un utilisateur correspond à l' Facultatif. Si aucune valeur n'est spécifiée, |
userExclusionCriteria |
Si un utilisateur remplit cette condition, il est exclu du segment pour |
UserExclusionDuration
Énumère les options de durée d'une exclusion si un utilisateur correspond à userExclusionCriteria
.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Durée d'exclusion non spécifiée. Ne pas préciser. |
USER_EXCLUSION_TEMPORARY |
Excluez temporairement des utilisateurs du segment lorsqu'ils remplissent la condition userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Exclure définitivement des utilisateurs du segment s'ils remplissent la condition userExclusionCriteria . |
SessionSegment
Les segments de sessions correspondent à des sous-ensembles de sessions qui ont eu lieu sur votre site ou dans votre application (par exemple, toutes les sessions provenant d'une campagne publicitaire spécifique).
Représentation JSON |
---|
{ "sessionInclusionCriteria": { object ( |
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 répondent aux conditions définies dans ces critères.
Représentation JSON |
---|
{
"andConditionGroups": [
{
object ( |
Champs | |
---|---|
andConditionGroups[] |
Une session répond à ces critères 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 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, la valeur |
segmentFilterExpression |
Les données sont incluses ou non dans le segment selon qu'elles correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres. |
SessionCriteriaScoping
La portée spécifie les événements pris en compte lors de l'évaluation d'une session répondant à un critère.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Portée des critères non spécifiés. Ne pas préciser. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis au cours d'un événement, la session les correspond. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Si les critères sont remplis au cours d'une session, cette dernière correspond aux critères. |
SessionSegmentExclusion
Indique les sessions exclues de ce segment.
Représentation JSON |
---|
{ "sessionExclusionDuration": enum ( |
Champs | |
---|---|
sessionExclusionDuration |
Spécifie la durée d'une exclusion si une session correspond à l' Facultatif. Si aucune valeur n'est spécifiée, la valeur |
sessionExclusionCriteria |
Si une session remplit cette condition, elle est exclue du segment pour |
SessionExclusionDuration
Énumère les options de durée d'une exclusion si une session correspond à l'sessionExclusionCriteria
.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Durée d'exclusion non spécifiée. Ne pas préciser. |
SESSION_EXCLUSION_TEMPORARY |
Excluez temporairement les sessions du segment lorsqu'elles remplissent la condition sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Excluez définitivement les sessions du segment si elles remplissent la condition sessionExclusionCriteria . |
EventSegment
Les segments d'événements sont des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application (par exemple, tous les événements d'achat effectués dans un lieu donné ou les événements app_exception qui se sont produits sur un système d'exploitation spécifique).
Représentation JSON |
---|
{ "eventInclusionCriteria": { object ( |
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 des critères.
Représentation JSON |
---|
{
"andConditionGroups": [
{
object ( |
Champs | |
---|---|
andConditionGroups[] |
Un événement correspond à ces critères 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, la valeur |
segmentFilterExpression |
Les données sont incluses ou non dans le segment selon qu'elles correspondent à cette expression. Les expressions expriment des critères basés sur des dimensions, des métriques et/ou des paramètres. |
EventCriteriaScoping
La portée spécifie les événements pris en compte lors de l'évaluation si un événement répond à un critère.
Enums | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Portée des critères non spécifiés. Ne pas préciser. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis dans un événement, celui-ci correspond aux critères. |
EventSegmentExclusion
Indique les événements exclus de ce segment.
Représentation JSON |
---|
{ "eventExclusionDuration": enum ( |
Champs | |
---|---|
eventExclusionDuration |
Facultatif. Si aucune valeur n'est spécifiée, la valeur |
eventExclusionCriteria |
Si un événement remplit cette condition, il est exclu du 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 pas préciser. |
EVENT_EXCLUSION_PERMANENT |
Exclure définitivement des événements du segment s'ils remplissent déjà 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 ( |
Champs | |
---|---|
dimensionHeaders[] |
Décrit les colonnes de dimension. Les rapports sur les entonnoirs incluent toujours la dimension "Étape de l'entonnoir" dans les réponses du sous-rapport. Des dimensions supplémentaires, telles que les répartitions, les dates et les prochaines actions, peuvent figurer dans la réponse si nécessaire. |
metricHeaders[] |
Décrit les colonnes de métriques. Les rapports sur les entonnoirs incluent toujours les utilisateurs actifs dans les réponses du sous-rapport. Le tableau de l'entonnoir comprend des métriques supplémentaires telles que le taux d'achèvement, et le taux d'abandon et le taux d'abandon. |
rows[] |
Lignes de combinaisons de valeurs de dimension et de valeurs de métriques dans le rapport. |
metadata |
Métadonnées du rapport sur les entonnoirs. |
FunnelResponseMetadata
Les métadonnées de réponse du rapport sur les entonnoirs contiennent des informations supplémentaires sur celui-ci.
Représentation JSON |
---|
{
"samplingMetadatas": [
{
object ( |
Champs | |
---|---|
samplingMetadatas[] |
Si les résultats du rapport sur les entonnoirs sont échantillonnés, cette métrique indique le pourcentage d'événements qui ont été utilisés dans ce rapport. Un champ Toutefois, si les résultats ne sont pas échantillonnés, ce champ ne sera pas défini. |
SamplingMetadata
Si les résultats du rapport sur les entonnoirs sont échantillonnés, ces métadonnées indiquent le pourcentage d'événements qui ont été utilisés dans ce rapport pendant une période donnée. L'échantillonnage consiste à analyser un sous-ensemble de données afin de découvrir des informations pertinentes dans un ensemble de données plus vaste.
Représentation JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Champs | |
---|---|
samplesReadCount |
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 |
Nombre total d'événements présents dans les données de cette propriété qui auraient pu être analysés dans ce rapport sur les entonnoirs pour une période donnée. L'échantillonnage permet d'obtenir des informations pertinentes sur le plus grand ensemble de données, c'est-à-dire la taille de l'ensemble de données plus important. Pour calculer le pourcentage de données disponibles qui a été utilisé dans ce rapport sur les entonnoirs, calculez |
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 ( |
Champs | |
---|---|
tokensPerDay |
Les propriétés Analytics standards peuvent utiliser jusqu'à 200 000 jetons par jour, tandis que les propriétés Analytics 360 peuvent en utiliser 2 000 000 par jour. La plupart des requêtes consomment moins de 10 jetons. |
tokensPerHour |
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 |
Les propriétés Analytics standards peuvent envoyer jusqu'à 10 demandes simultanées, tandis que les propriétés Analytics 360 peuvent en utiliser jusqu'à 50. |
serverErrorsPerProjectPerHour |
Les propriétés Analytics standards et les paires de projets cloud peuvent comporter jusqu'à 10 erreurs de serveur par heure, tandis que les propriétés Analytics 360 et les associations de projets cloud peuvent comporter jusqu'à 50 erreurs de serveur par heure. |
potentiallyThresholdedRequestsPerHour |
Les propriétés Analytics peuvent envoyer jusqu'à 120 demandes avec potentiellement un seuil de dimensions par heure. Dans une requête groupée, chaque demande de rapport est comptabilisée individuellement pour ce quota si la demande contient des dimensions potentiellement soumises à un seuil. |
tokensPerProjectPerHour |
Les propriétés Analytics peuvent utiliser jusqu'à 35% de leurs jetons par projet et par heure. Cela équivaut aux propriétés Analytics standards, qui peuvent utiliser jusqu'à 14 000 jetons par projet et par heure, tandis que les propriétés Analytics 360 peuvent utiliser 140 000 jetons par projet et par heure. Une requête API consomme un seul nombre de jetons, qui est déduit de tous les quotas horaires, quotidiens et horaires par projet. |
QuotaStatus
État actuel d'un groupe de quotas particulier.
Représentation JSON |
---|
{ "consumed": integer, "remaining": integer } |
Champs | |
---|---|
consumed |
Quota utilisé par cette requête. |
remaining |
Quota restant après cette demande. |