- 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
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segment
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- Essayer
Renvoie un rapport personnalisé sur l'entonnoir de vos données d'événements Google Analytics. Les données renvoyées par l'API sont sous forme de tableau avec des colonnes pour les dimensions et les métriques demandées.
L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes. Par exemple, comment les prospects deviennent-ils des clients potentiels, puis des acheteurs ? Comment les acheteurs ponctuels deviennent-ils des acheteurs fidèles ? À la lumière de ces informations, vous pouvez améliorer les parcours client inefficaces ou abandonnés. Pour en savoir plus, consultez Explorations de l'entonnoir GA4.
Cette méthode a été introduite en version alpha afin de recueillir des commentaires sur la syntaxe et les fonctionnalités avant le passage à la version bêta. Pour nous envoyer vos commentaires concernant cette API, remplissez le formulaire de commentaires sur les rapports sur les entonnoirs générés via l'API Google Analytics Data.
Requête HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
property |
Facultatif. Identifiant d'une propriété Google Analytics dont les événements sont suivis. Spécifié dans le chemin d'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 non spécifiée ou cohérente avec la propriété au niveau du lot. Exemple: properties/1234 |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "dateRanges": [ { object ( |
Champs | |
---|---|
date |
Facultatif. Plage de dates des données à lire. Si plusieurs périodes sont demandées, chaque ligne de réponse contient un indice de période basé sur zéro. Si deux plages de dates se chevauchent, les données d'événement pour les jours qui se chevauchent sont incluses dans les lignes de réponse pour les deux plages de dates. |
funnel |
Facultatif. Configuration de l'entonnoir de cette requête. Cette configuration d'entonnoir est obligatoire. |
funnel |
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" développe chaque étape de l'entonnoir en fonction des valeurs uniques de la dimension "Répartition". Par exemple, une répartition par dimension |
funnel |
Facultatif. Si elle est spécifiée, l'action suivante ajoute une dimension à la réponse du sous-rapport de visualisation de l'entonnoir. Cette dimension "Étape suivante" développe chaque étape de l'entonnoir en fonction des valeurs uniques de l'action suivante. Par exemple, une action suivante de la dimension L'action suivante n'est compatible qu'avec |
funnel |
Facultatif. Le type de visualisation de l'entonnoir contrôle les dimensions présentes dans la réponse du sous-rapport de visualisation de l'entonnoir. Si aucune valeur n'est spécifiée, |
segments[] |
Facultatif. Les configurations des segments. Les segments sont des sous-ensembles des données d'une propriété. Dans un rapport sur l'entonnoir avec des segments, l'entonnoir est évalué dans chaque segment. Chaque segment spécifié dans cette requête génère une ligne distincte dans la réponse. Dans la réponse, chaque segment est identifié par son nom. Le paramètre "segments" est facultatif. Les requêtes sont limitées à quatre segments. |
limit |
Facultatif. Nombre de lignes à renvoyer. Si ce paramètre n'est pas spécifié, 10 000 lignes sont renvoyées. L'API renvoie un maximum de 250 000 lignes par requête, quel que soit le nombre de lignes que vous demandez. L'API peut également renvoyer moins de lignes que l' |
dimension |
Facultatif. Les filtres de dimension vous permettent de demander uniquement des valeurs de dimension spécifiques dans le rapport. Pour en savoir plus, consultez Créer un rapport: Filtres de dimension pour obtenir des exemples. Vous ne pouvez pas utiliser de métriques dans ce filtre. |
return |
Facultatif. Indique si l'état actuel du quota de cette propriété Analytics doit être renvoyé. Le quota est renvoyé dans PropertyQuota. |
Corps de la réponse
La réponse du rapport sur l'entonnoir contient deux sous-rapports. Les deux sous-rapports correspondent à différentes combinaisons 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 | |
---|---|
funnel |
Le tableau de l'entonnoir est un rapport qui contient les étapes de l'entonnoir, le segment, la dimension de répartition, les utilisateurs actifs, le taux de finalisation, les abandons et le taux d'abandon. La dimension de segment n'est présente dans cette réponse que si un segment a été demandé. La dimension de répartition n'est présente dans cette réponse que si elle a été demandée. |
funnel |
La visualisation de l'entonnoir est un rapport qui contient l'étape de l'entonnoir, le segment, la date, la dimension "Étape suivante" et les utilisateurs actifs. La dimension de 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 |
property |
État du quota de cette propriété Analytics, y compris pour cette requête. |
kind |
Identifie le type de ressource de ce message. Cet |
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 requête de rapport sur les entonnoirs. Un entonnoir fournit des rapports sur les utilisateurs lorsqu'ils suivent une séquence d'étapes.
L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes. Par exemple, comment les prospects deviennent-ils des clients potentiels, puis des acheteurs ? Comment les acheteurs ponctuels deviennent-ils des acheteurs fidèles ? À la lumière de ces informations, vous pouvez améliorer les parcours client inefficaces ou abandonnés.
Représentation JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
Champs | |
---|---|
is |
Dans un entonnoir ouvert, les utilisateurs peuvent y accéder à n'importe quelle étape, tandis que dans un entonnoir fermé, ils doivent y accéder à la première étape. Facultatif. Si aucune valeur n'est spécifiée, un entonnoir fermé est utilisé. |
steps[] |
Étapes séquentielles de cet entonnoir. |
FunnelStep
Les étapes définissent le parcours utilisateur que vous souhaitez mesurer. Les étapes contiennent une ou plusieurs conditions que vos utilisateurs doivent remplir pour être inclus dans cette étape du parcours de l'entonnoir de conversion.
Représentation JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Champs | |
---|---|
name |
Nom distinctif de cette étape. Si aucun nom n'est spécifié, les étapes sont nommées à l'aide d'un nom indexé à partir de 1 (par exemple, "0. ", "1. ", etc.). Ce nom définit la valeur de chaîne renvoyée par la dimension |
is |
Si cette valeur est définie sur "True", cette étape doit directement suivre l'étape précédente. Si la valeur est "false", il peut y avoir des événements entre l'étape précédente et celle-ci. Si ce paramètre n'est pas spécifié, |
filter |
Condition à remplir par l'utilisateur pour être inclus dans cette étape du parcours de l'entonnoir de conversion. |
within |
Si cette valeur est spécifiée, cette étape doit être terminée dans la durée spécifiée après la fin de l'étape précédente.
Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
FunnelFilterExpression
Indique des 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 : |
|
and |
La fonction FunnelFilterExpression dans |
or |
L'expression FunnelFilterExpression dans |
not |
L'expression de filtre d'entonnoir n'est PAS de type |
funnel |
Filtre en entonnoir pour une dimension ou une métrique. |
funnel |
Crée un filtre correspondant 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 d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement. |
FunnelFilterExpressionList
Liste des expressions de filtre d'entonnoir.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
Champs | |
---|---|
expressions[] |
Liste des expressions de filtre d'entonnoir. |
FunnelFieldFilter
Expression permettant de filtrer les valeurs de dimension ou de métrique.
Représentation JSON |
---|
{ "fieldName": string, // Union field |
Champs | |
---|---|
field |
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 : |
|
string |
Filtre lié aux chaînes. |
in |
Filtre pour les valeurs de la liste. |
numeric |
Filtre pour les valeurs numériques ou de date. |
between |
Filtre entre deux valeurs. |
FunnelEventFilter
Crée un filtre correspondant 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 d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.
Représentation JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Champs | |
---|---|
event |
Ce filtre correspond aux événements portant ce nom d'événement unique. Vous devez indiquer le nom de l'événement. |
funnel |
Si spécifié, ce filtre correspond aux événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre de paramètre. Dans l'expression de filtre de paramètre, seuls les filtres de paramètre sont disponibles. |
FunnelParameterFilterExpression
Exprime des combinaisons de filtres d'entonnoir sur des 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 : |
|
and |
La fonction FunnelParameterFilterExpression dans |
or |
La fonction FunnelParameterFilterExpression dans |
not |
La valeur de FunnelParameterFilterExpression n'est PAS |
funnel |
Filtre de paramètre d'entonnoir primitif. |
FunnelParameterFilterExpressionList
Liste des expressions de filtre de paramètre d'entonnoir.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
Champs | |
---|---|
expressions[] |
Liste des expressions de filtre de paramètre d'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 : |
|
event |
Ce filtre sera évalué sur le paramètre d'événement spécifié. Les paramètres d'événement sont enregistrés en tant que paramètres de l'événement. Les paramètres d'événement incluent des champs tels que"firebase_screen" et "currency". Les paramètres d'événement ne peuvent être utilisés que dans les segments et les entonnoirs, et uniquement dans un filtre descendant d'un EventFilter. Dans un filtre descendant d'un EventFilter, vous devez utiliser des paramètres d'événement ou d'élément. |
item |
Ce filtre sera évalué sur le paramètre d'élément spécifié. Les paramètres des articles sont consignés en tant que paramètres dans le tableau des articles. Les paramètres d'article incluent des champs tels que"nom_article" et "catégorie_article". Les paramètres d'article ne peuvent être utilisés que dans les segments et les entonnoirs, et uniquement dans un filtre descendant d'un EventFilter. Dans un filtre descendant d'un 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 : |
|
string |
Filtre lié aux chaînes. |
in |
Filtre pour les valeurs de la liste. |
numeric |
Filtre pour les valeurs numériques ou de date. |
between |
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 | |
---|---|
breakdown |
Colonne de dimension ajoutée à la réponse du sous-rapport du tableau de l'entonnoir. La dimension "Répartition" décompose chaque étape de l'entonnoir. Un |
limit |
Nombre maximal de valeurs distinctes de la dimension "Répartition" à renvoyer dans la réponse. Si aucune limite n'est spécifiée, une |
FunnelNextAction
Les actions suivantes indiquent la valeur d'une dimension après qu'un utilisateur a terminé une étape, mais avant qu'il n'accomplisse l'étape suivante. Par exemple, si nextActionDimension
est eventName
, nextActionDimension
dans la ligne de la i
e étape de l'entonnoir affichera le premier événement après l'événement qui a qualifié l'utilisateur pour la i
e étape de l'entonnoir, mais avant que l'utilisateur n'atteigne la i+1
e étape de l'entonnoir.
Représentation JSON |
---|
{
"nextActionDimension": {
object ( |
Champs | |
---|---|
next |
Colonne de dimension ajoutée à la réponse du sous-rapport de visualisation de l'entonnoir. La dimension "Étape suivante" renvoie la valeur de dimension suivante de cette dimension une fois que l'utilisateur a atteint la
|
limit |
Nombre maximal de valeurs distinctes de la dimension "Répartition" à renvoyer dans la réponse. Si aucune limite n'est spécifiée, une |
FunnelVisualizationType
Contrôle les dimensions présentes dans la réponse du sous-rapport de visualisation de l'entonnoir.
Enums | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Type non spécifié. |
STANDARD_FUNNEL |
Un entonnoir standard (en escalier). Le sous-rapport de visualisation de l'entonnoir dans la réponse ne contient pas de date. |
TRENDED_FUNNEL |
Un entonnoir de conversion le plus utilisé actuellement (en courbes). Le sous-rapport de 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.
Représentation JSON |
---|
{ "name": string, // Union field |
Champs | |
---|---|
name |
Nom de ce segment. Si aucune valeur n'est spécifiée, les segments sont nommés "Segment". Ce nom définit la valeur de chaîne renvoyée par la dimension |
Champ d'union one_segment_scope . Un segment est spécifié dans un seul champ d'application. one_segment_scope ne peut être qu'un des éléments suivants : |
|
user |
Les segments d'utilisateurs sont des sous-ensembles d'utilisateurs ayant interagi avec votre site ou votre application. |
session |
Les segments de sessions correspondent à des sous-ensembles de sessions qui ont eu lieu sur votre site ou dans votre application. |
event |
Les segments d'événements correspondent à des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application. |
UserSegment
Les segments d'utilisateurs correspondent à des sous-ensembles d'utilisateurs qui ont interagi avec votre site ou votre application (par exemple, les utilisateurs qui ont déjà effectué un achat ou ceux qui ont ajouté des articles à leur panier, sans effectuer d'achat).
Représentation JSON |
---|
{ "userInclusionCriteria": { object ( |
Champs | |
---|---|
user |
Définit les utilisateurs inclus dans ce segment. Facultatif. |
exclusion |
Définit les utilisateurs exclus de ce segment. Facultatif. |
UserSegmentCriteria
Un utilisateur correspond à un critère si ses événements répondent aux conditions de ce critère.
Représentation JSON |
---|
{ "andConditionGroups": [ { object ( |
Champs | |
---|---|
and |
Un utilisateur remplit ces critères s'il correspond à chacun de ces |
and |
Un utilisateur remplit ces critères s'il correspond à chacun 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 | |
---|---|
condition |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non au groupe de conditions. Ce champ définit le nombre d'événements sur lesquels l' Facultatif. Si aucune valeur n'est spécifiée, |
segment |
Les données sont incluses ou exclues du segment en fonction de leur correspondance avec cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
UserCriteriaScoping
Le champ d'application spécifie les événements pris en compte pour déterminer si un utilisateur répond à un critère.
Enums | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Champ d'application des critères non spécifié. Ne spécifiez pas. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis dans un événement, l'utilisateur correspond aux critères. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Si les critères sont remplis au cours d'une session, l'utilisateur correspond aux critères. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Si les critères sont satisfaits par des événements de l'utilisateur, l'utilisateur correspond aux critères. |
SegmentFilterExpression
Indique des combinaisons de filtres de segment.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union expr . Spécifiez un type de filtre pour SegmentFilterExpression . La expr ne peut être qu'un des éléments suivants : |
|
and |
La valeur SegmentFilterExpression dans |
or |
La valeur SegmentFilterExpression dans |
not |
La valeur de SegmentFilterExpression n'est PAS |
segment |
Filtre de segment primitif. |
segment |
Crée un filtre correspondant 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 d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement. |
SegmentFilterExpressionList
Liste des expressions de filtre de segment.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
Champs | |
---|---|
expressions[] |
Liste des expressions de filtre de segment |
SegmentFilter
Expression permettant de filtrer les valeurs de dimension ou de métrique.
Représentation JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
Champs | |
---|---|
field |
Nom de la dimension ou de la métrique. |
filter |
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 : |
|
string |
Filtre lié aux chaînes. |
in |
Filtre pour les valeurs de la liste. |
numeric |
Filtre pour les valeurs numériques ou de date. |
between |
Filtre entre deux valeurs. |
SegmentFilterScoping
Les champs d'application spécifient comment les dimensions et les métriques de plusieurs événements doivent être prises en compte lors de l'évaluation d'un filtre de segment.
Représentation JSON |
---|
{ "atAnyPointInTime": boolean } |
Champs | |
---|---|
at |
Si Ce paramètre Ce Si le champ d'application des critères est |
SegmentEventFilter
Crée un filtre correspondant 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 d'événement unique et aux expressions de filtre de paramètre correspond à ce filtre d'événement.
Représentation JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Champs | |
---|---|
event |
Ce filtre correspond aux événements portant ce nom d'événement unique. Vous devez indiquer le nom de l'événement. |
segment |
Si spécifié, ce filtre correspond aux événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre de paramètre. Dans l'expression de filtre de paramètre, seuls les filtres de paramètre sont disponibles. |
SegmentParameterFilterExpression
Exprime des combinaisons de filtres de segment sur des 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 : |
|
and |
La fonction SegmentParameterFilterExpression dans |
or |
La valeur SegmentParameterFilterExpression dans |
not |
La valeur de SegmentParameterFilterExpression n'est PAS |
segment |
Filtre de paramètre de segment primitif. |
SegmentParameterFilterExpressionList
Liste des expressions de filtre de paramètre de segment.
Représentation JSON |
---|
{
"expressions": [
{
object ( |
Champs | |
---|---|
expressions[] |
Liste des expressions de filtre du paramètre de segment. |
SegmentParameterFilter
Expression permettant de filtrer les valeurs de paramètre dans un segment.
Représentation JSON |
---|
{ "filterScoping": { object ( |
Champs | |
---|---|
filter |
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 : |
|
event |
Ce filtre sera évalué sur le paramètre d'événement spécifié. Les paramètres d'événement sont enregistrés en tant que paramètres de l'événement. Les paramètres d'événement incluent des champs tels que"firebase_screen" et "currency". Les paramètres d'événement ne peuvent être utilisés que dans les segments et les entonnoirs, et uniquement dans un filtre descendant d'un EventFilter. Dans un filtre descendant d'un EventFilter, vous devez utiliser des paramètres d'événement ou d'élément. |
item |
Ce filtre sera évalué sur le paramètre d'élément spécifié. Les paramètres des articles sont consignés en tant que paramètres dans le tableau des articles. Les paramètres d'article incluent des champs tels que"nom_article" et "catégorie_article". Les paramètres d'article ne peuvent être utilisés que dans les segments et les entonnoirs, et uniquement dans un filtre descendant d'un EventFilter. Dans un filtre descendant d'un 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 : |
|
string |
Filtre lié aux chaînes. |
in |
Filtre pour les valeurs de la liste. |
numeric |
Filtre pour les valeurs numériques ou de date. |
between |
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 | |
---|---|
in |
Cumule le paramètre sur la période de jours spécifiée avant d'appliquer le filtre. N'est accepté que si le champ d'application des critères est Par exemple, si La plage de dates n'est pas étendue dans le but d'obtenir une période complète de N jours près du début de la plage de dates. Par exemple, si un rapport s'étend du 1er novembre 2021 au 10 novembre 2021 et que
|
UserSegmentSequenceGroup
Définissez les conditions qui doivent se produire dans un ordre spécifique pour que l'utilisateur fasse partie du segment.
Représentation JSON |
---|
{ "sequenceScoping": enum ( |
Champs | |
---|---|
sequence |
Toutes les étapes de la séquence doivent être remplies dans le champ d'application pour que l'utilisateur corresponde à la séquence. Par exemple, si la valeur est Facultatif. Si aucune valeur n'est spécifiée, |
sequence |
Définit la période au cours de laquelle toute la séquence doit se dérouler (par exemple, 30 minutes).
Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
user |
Séquence ordonnée d'étapes conditionnelles. Les événements d'un utilisateur doivent suivre chaque étape pour que l'utilisateur corresponde à l' |
UserSequenceStep
Condition qui doit se produire dans l'ordre des étapes spécifié pour que cet utilisateur corresponde à la séquence.
Représentation JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Champs | |
---|---|
is |
Si cette valeur est définie sur "true", l'événement qui satisfait cette étape doit être le tout premier événement qui suit l'événement qui satisfait 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 celle-ci. |
step |
Cette étape de séquence doit être remplie dans le champ d'application pour que l'utilisateur corresponde à la séquence. Par exemple, si la valeur est Facultatif. Si elle n'est pas spécifiée, |
segment |
Un utilisateur correspond à cette étape de séquence si ses événements correspondent à cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
UserSegmentExclusion
Indique les utilisateurs exclus de ce segment.
Représentation JSON |
---|
{ "userExclusionDuration": enum ( |
Champs | |
---|---|
user |
Indique la durée d'une exclusion si un utilisateur correspond à l' Facultatif. Si aucune valeur n'est spécifiée, |
user |
Si un utilisateur remplit cette condition, il est exclu du segment pour la période |
UserExclusionDuration
Énumère les options de durée d'une exclusion si un utilisateur correspond à l'userExclusionCriteria
.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Durée d'exclusion non spécifiée. Ne spécifiez pas. |
USER_EXCLUSION_TEMPORARY |
Excluez temporairement les utilisateurs du segment pendant les périodes où ils remplissent la condition userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Excluez définitivement les utilisateurs du segment s'ils remplissent la condition userExclusionCriteria . |
SessionSegment
Les segments de sessions correspondent à des sous-ensembles de sessions qui ont eu lieu sur votre site ou dans votre application (par exemple, toutes les sessions provenant d'une campagne publicitaire spécifique).
Représentation JSON |
---|
{ "sessionInclusionCriteria": { object ( |
Champs | |
---|---|
session |
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 les événements de la session répondent aux conditions de ce critère.
Représentation JSON |
---|
{
"andConditionGroups": [
{
object ( |
Champs | |
---|---|
and |
Une session répond à ce critère si elle correspond à chacun de ces |
SessionSegmentConditionGroup
En définissant des conditions, vous pouvez indiquer à Analytics les données à inclure ou à exclure au niveau du segment.
Représentation JSON |
---|
{ "conditionScoping": enum ( |
Champs | |
---|---|
condition |
Les données sont incluses ou exclues du segment selon qu'elles correspondent ou non au groupe de conditions. Ce champ définit le nombre d'événements sur lesquels l' Facultatif. Si aucune valeur n'est spécifiée, |
segment |
Les données sont incluses ou exclues du segment en fonction de leur correspondance avec cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
SessionCriteriaScoping
Le champ d'application spécifie les événements pris en compte pour déterminer si une session répond à un critère.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Champ d'application des critères non spécifié. Ne spécifiez pas. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis dans un événement, la session correspond aux critères. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Si les critères sont remplis au cours d'une session, la session correspond aux critères. |
SessionSegmentExclusion
Spécifie les sessions exclues de ce segment.
Représentation JSON |
---|
{ "sessionExclusionDuration": enum ( |
Champs | |
---|---|
session |
Indique la durée d'une exclusion si une session correspond à Facultatif. Si aucune valeur n'est spécifiée, |
session |
Si une session répond à cette condition, elle n'est pas membre du segment pour l' |
SessionExclusionDuration
Énumère les options de durée d'une exclusion si une session correspond à sessionExclusionCriteria
.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Durée d'exclusion non spécifiée. Ne spécifiez pas. |
SESSION_EXCLUSION_TEMPORARY |
Exclure temporairement les sessions du segment pendant les périodes où elles remplissent la condition sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Exclure définitivement les sessions du segment si elles remplissent la condition sessionExclusionCriteria . |
EventSegment
Les segments d'événements correspondent à des sous-ensembles d'événements qui ont été déclenchés sur votre site ou dans votre application (par exemple, tous les événements d'achat réalisés dans un lieu particulier ou les événements app_exception survenus sur un système d'exploitation spécifique).
Représentation JSON |
---|
{ "eventInclusionCriteria": { object ( |
Champs | |
---|---|
event |
Définit les événements inclus dans ce segment. Facultatif. |
exclusion |
Définit les événements à exclure de ce segment. Facultatif. |
EventSegmentCriteria
Un événement correspond à un critère s'il répond aux conditions de ce critère.
Représentation JSON |
---|
{
"andConditionGroups": [
{
object ( |
Champs | |
---|---|
and |
Un événement répond à 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 | |
---|---|
condition |
Facultatif. Si aucune valeur n'est spécifiée, |
segment |
Les données sont incluses ou exclues du segment en fonction de leur correspondance avec cette expression. Les expressions expriment des critères sur les dimensions, les métriques et/ou les paramètres. |
EventCriteriaScoping
Le champ d'application spécifie les événements pris en compte pour déterminer si un événement répond à un critère.
Enums | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Champ d'application des critères non spécifié. Ne spécifiez pas. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Si les critères sont remplis dans un événement, l'événement correspond aux critères. |
EventSegmentExclusion
Spécifie les événements exclus de ce segment.
Représentation JSON |
---|
{ "eventExclusionDuration": enum ( |
Champs | |
---|---|
event |
Facultatif. Si aucune valeur n'est spécifiée, une |
event |
Si un événement remplit cette condition, il n'est pas inclus dans le segment de l' |
EventExclusionDuration
Énumère les options de durée d'une exclusion si un événement correspond à l'eventExclusionCriteria
.
Enums | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Durée d'exclusion non spécifiée. Ne spécifiez pas. |
EVENT_EXCLUSION_PERMANENT |
Exclure définitivement les événements du segment s'ils remplissent la condition eventExclusionCriteria . |
FunnelSubReport
Les sous-rapports sur l'entonnoir 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 | |
---|---|
dimension |
Décrit les colonnes de dimension. Les rapports sur les entonnoirs incluent toujours la dimension "Étape de l'entonnoir" dans les réponses des sous-rapports. Des dimensions supplémentaires telles que les répartitions, les dates et les actions à suivre peuvent être présentes dans la réponse si vous le demandez. |
metric |
Décrit les colonnes de métriques. Les rapports sur les entonnoirs incluent toujours les utilisateurs actifs dans les réponses des sous-rapports. Le tableau de l'entonnoir inclut des métriques supplémentaires telles que le taux de finalisation, les abandons et le taux d'abandon. |
rows[] |
Lignes de combinaisons de valeurs de dimension et de valeurs de métrique dans le rapport. |
metadata |
Métadonnées du rapport sur l'entonnoir. |
FunnelResponseMetadata
Les métadonnées de réponse du rapport sur l'entonnoir contiennent des informations supplémentaires sur le rapport.
Représentation JSON |
---|
{
"samplingMetadatas": [
{
object ( |
Champs | |
---|---|
sampling |
Si les résultats du rapport sur les entonnoirs sont échantillonnés, cela indique le pourcentage d'événements utilisés dans ce rapport. Un Toutefois, si les résultats ne sont pas échantillonnés, ce champ ne sera pas défini. |