- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Embudo
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segmento
- 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
- Pruébala
Muestra un informe de embudo personalizado de tus datos de eventos de Google Analytics. Los datos que muestra la API están en forma de tabla con columnas para las dimensiones y métricas solicitadas.
La exploración de embudo permite visualizar los pasos que siguen los usuarios para completar una tarea y ver rápidamente si tienen éxito o no en cada paso. Por ejemplo, ¿de qué manera los clientes potenciales se convierten en visitantes y, finalmente, en compradores?, ¿de qué manera los usuarios que hacen una única compra se convierten en compradores frecuentes? Con esta información, puedes mejorar los recorridos del cliente ineficientes o que suelen abandonarse. Para obtener más información, consulta Exploraciones de embudo de GA4.
Este método se introduce durante el período de estabilidad de la versión alfa con la intención de reunir comentarios sobre la sintaxis y las funciones antes de proceder a la versión beta. Para enviar tus comentarios sobre esta API, completa los comentarios del informe sobre el embudo de la API de datos de Google Analytics.
Solicitud HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
property |
Opcional. Es un identificador de la propiedad GA4 de Google Analytics de cuyos eventos se hace un seguimiento. Se especifica en la ruta de la URL y no en el cuerpo. Para obtener más información, consulta dónde encontrar tu ID de propiedad. Dentro de una solicitud por lotes, esta propiedad debe no estar especificada o ser coherente con la propiedad a nivel de lote. Ejemplo: properties/1234 |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "dateRanges": [ { object ( |
Campos | |
---|---|
dateRanges[] |
Opcional. Períodos de los datos que se leerán. Si se solicitan varios períodos, cada fila de respuesta contendrá un índice de período basado en cero. Si dos períodos se superponen, los datos de eventos de los días superpuestos se incluyen en las filas de respuesta de ambos períodos. |
funnel |
Opcional. La configuración del embudo de esta solicitud. Esta configuración del embudo es obligatoria. |
funnelBreakdown |
Opcional. Si se especifica, este desglose agrega una dimensión a la respuesta del informe secundario de la tabla de embudo. Esta dimensión de desglose expande cada paso del embudo de conversión a los valores únicos de la dimensión de desglose. Por ejemplo, un desglose de la dimensión |
funnelNextAction |
Opcional. Si se especifica, la acción siguiente agrega una dimensión a la respuesta del informe secundario de visualización del embudo. Esta dimensión de acción siguiente expande cada paso del embudo de conversión a los valores únicos de la siguiente acción. Por ejemplo, una próxima acción de la dimensión La siguiente acción solo admite |
funnelVisualizationType |
Opcional. El tipo de visualización del embudo controla las dimensiones presentes en la respuesta del informe secundario de visualización del embudo. Si no se especifica, se usa |
segments[] |
Opcional. Las configuraciones de los segmentos. Los segmentos son subconjuntos de los datos de una propiedad. En un informe de embudo con segmentos, el embudo se evalúa en cada segmento. Cada segmento especificado en esta solicitud produce una fila separada en la respuesta; en la respuesta, cada segmento identificado por su nombre. El parámetro de segmentos es opcional. Las solicitudes se limitan a 4 segmentos. |
limit |
Opcional. Cantidad de filas que se mostrarán. Si no se especifica, se muestran 10,000 filas. La API devuelve un máximo de 250,000 filas por solicitud, sin importar cuántas tengas. La API también puede mostrar menos filas que la |
dimensionFilter |
Opcional. Los filtros de dimensiones te permiten solicitar solo valores de dimensión específicos en el informe. Si deseas obtener más información al respecto, consulta el artículo Cómo crear un informe: Filtros de dimensiones para ver ejemplos. No se pueden usar métricas en este filtro. |
returnPropertyQuota |
Opcional. Activa o desactiva si se muestra el estado actual de la cuota de esta propiedad de Analytics. La cuota se muestra en PropertyQuota. |
Cuerpo de la respuesta
La respuesta del informe de embudo contiene dos informes secundarios. Los dos informes secundarios son combinaciones diferentes de dimensiones y métricas.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "funnelTable": { object ( |
Campos | |
---|---|
funnelTable |
La tabla del embudo de conversión es un informe con el paso del embudo, el segmento, la dimensión de desglose, los usuarios activos, el porcentaje de respuesta, los abandonos y el porcentaje de abandono. La dimensión del segmento solo está presente en esta respuesta si se solicitó un segmento. La dimensión de desglose solo está presente en esta respuesta si se solicitó. |
funnelVisualization |
La visualización del embudo es un informe con el paso del embudo, el segmento, la fecha, la dimensión de la acción siguiente y los usuarios activos. La dimensión del segmento solo está presente en esta respuesta si se solicitó un segmento. La dimensión de fecha solo está presente en esta respuesta si se solicitó a través del tipo de embudo |
propertyQuota |
Estado de cuota de esta propiedad de Analytics que incluye esta solicitud. |
kind |
Identifica el tipo de recurso que representa este mensaje. Este |
Alcances de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Embudo
Configura el embudo en una solicitud de informe de embudo. Un embudo informa sobre los usuarios a medida que pasan por una secuencia de pasos.
La exploración de embudo permite visualizar los pasos que siguen los usuarios para completar una tarea y ver rápidamente si tienen éxito o no en cada paso. Por ejemplo, ¿de qué manera los clientes potenciales se convierten en visitantes y, finalmente, en compradores?, ¿de qué manera los usuarios que hacen una única compra se convierten en compradores frecuentes? Con esta información, puedes mejorar los recorridos del cliente ineficientes o que suelen abandonarse.
Representación JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
Campos | |
---|---|
isOpenFunnel |
Si se trata de un embudo abierto, los usuarios pueden ingresar en cualquier paso y, si se trata de un embudo cerrado, deben ingresar en el primer paso. Opcional. Si no se especifica, se utiliza un embudo cerrado. |
steps[] |
Los pasos secuenciales de este embudo. |
FunnelStep
Los pasos definen el recorrido del usuario que deseas medir. Los pasos contienen una o más condiciones que tus usuarios deben cumplir para que se los incluya en ese paso del recorrido del embudo.
Representación JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Campos | |
---|---|
name |
El nombre distintivo para este paso. Si no se especifica, los pasos se nombrarán con un nombre indexado basado en 1 (por ejemplo, "0. ", "1. ", etcétera). Este nombre define el valor de cadena que muestra la dimensión |
isDirectlyFollowedBy |
Si es verdadero, este paso debe seguir directamente al paso anterior. Si es falso, puede haber eventos entre el paso anterior y este. Si no se especifica, |
filterExpression |
Es la condición que deben cumplir tus usuarios para que se los incluya en este paso del recorrido del embudo. |
withinDurationFromPriorStep |
Si se especifica, este paso se debe completar dentro del plazo de la finalización del paso anterior.
Una duración en segundos con hasta nueve dígitos decimales que terminen en " |
FunnelFilterExpression
Expresa combinaciones de filtros de embudo.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión expr . Especifica un tipo de filtro para FunnelFilterExpression . expr puede ser solo uno de los siguientes: |
|
andGroup |
La FunnelFilterExpression en |
orGroup |
La FunnelFilterExpression en |
notExpression |
La FunnelFilterExpression NO es de |
funnelFieldFilter |
Un filtro de embudo para una dimensión o métrica. |
funnelEventFilter |
Crea un filtro que coincida con los eventos de un solo nombre de evento. Si se especifica una expresión de filtro de parámetros, solo el subconjunto de eventos que coincide con el nombre del evento único y las expresiones de filtro de parámetros coincide con este filtro de evento. |
FunnelFilterExpressionList
Una lista de expresiones de filtro de embudo.
Representación JSON |
---|
{
"expressions": [
{
object ( |
Campos | |
---|---|
expressions[] |
La lista de expresiones de filtro de embudo. |
FunnelFieldFilter
Una expresión para filtrar valores de dimensión o métrica.
Representación JSON |
---|
{ "fieldName": string, // Union field |
Campos | |
---|---|
fieldName |
El nombre de la dimensión o la métrica. |
Campo de unión one_filter . Especifica un tipo de filtro. Las direcciones (one_filter ) solo pueden ser una de las siguientes opciones: |
|
stringFilter |
Filtro relacionado con strings. |
inListFilter |
Un filtro para los valores en la lista. |
numericFilter |
Un filtro para valores numéricos o de fecha. |
betweenFilter |
Es un filtro para entre dos valores. |
FunnelEventFilter
Crea un filtro que coincida con los eventos de un solo nombre de evento. Si se especifica una expresión de filtro de parámetros, solo el subconjunto de eventos que coincide con el nombre del evento único y las expresiones de filtro de parámetros coincide con este filtro de evento.
Representación JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Campos | |
---|---|
eventName |
Este filtro coincide con los eventos de este nombre de evento único. El nombre del evento es obligatorio. |
funnelParameterFilterExpression |
Si se especifica, este filtro coincide con los eventos que coinciden con el nombre del evento único y las expresiones de filtro de parámetros. Dentro de la expresión de filtro de parámetros, solo los filtros de parámetros están disponibles. |
FunnelParameterFilterExpression
Expresa combinaciones de filtros de embudo sobre los parámetros.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión expr . Especifica un tipo de filtro para FunnelParameterFilterExpression . expr puede ser solo uno de los siguientes: |
|
andGroup |
La FunnelParameterFilterExpression en |
orGroup |
La FunnelParameterFilterExpression en |
notExpression |
La FunnelParameterFilterExpression NO es de |
funnelParameterFilter |
Un filtro de parámetros de embudo primitivo. |
FunnelParameterFilterExpressionList
Una lista de expresiones de filtro de parámetros del embudo.
Representación JSON |
---|
{
"expressions": [
{
object ( |
Campos | |
---|---|
expressions[] |
La lista de expresiones de filtro de parámetros del embudo. |
FunnelParameterFilter
Una expresión para filtrar los valores de parámetros en un embudo.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión one_parameter . El campo que se filtra. Las direcciones (one_parameter ) solo pueden ser una de las siguientes opciones: |
|
eventParameterName |
Este filtro se evaluará en función del parámetro de evento especificado. Los parámetros de evento se registran como parámetros del evento. Los parámetros de eventos incluyen campos como "firebase_screen" y "currency". Los parámetros de eventos solo se pueden usar en segmentos y embudos, y solo se pueden usar en un filtro descendente de un EventFilter. En un filtro descendente de un EventFilter, se deben usar los parámetros del evento o del elemento. |
itemParameterName |
Este filtro se evaluará según el parámetro del elemento especificado. Los parámetros del artículo se registran como parámetros en el array de artículos. Los parámetros del artículo incluyen campos como "item_name" y "item_category". Los parámetros de artículos solo se pueden usar en segmentos y embudos, y solo se pueden usar en un filtro descendente de un EventFilter. En un filtro descendente de un EventFilter, se deben usar los parámetros del evento o del elemento. Los parámetros del artículo solo están disponibles en los eventos de comercio electrónico. Para obtener más información sobre los eventos de comercio electrónico, consulta la guía Cómo medir el comercio electrónico. |
Campo de unión one_filter . Especifica un tipo de filtro. Las direcciones (one_filter ) solo pueden ser una de las siguientes opciones: |
|
stringFilter |
Filtro relacionado con strings. |
inListFilter |
Un filtro para los valores en la lista. |
numericFilter |
Un filtro para valores numéricos o de fecha. |
betweenFilter |
Es un filtro para entre dos valores. |
FunnelBreakdown
Los desgloses agregan una dimensión a la respuesta del informe secundario de la tabla de embudo.
Representación JSON |
---|
{
"breakdownDimension": {
object ( |
Campos | |
---|---|
breakdownDimension |
Es la columna de dimensiones que se agregó a la respuesta del informe secundario de la tabla de embudo. La dimensión de desglose desglosa cada paso del embudo de conversión. Se requiere un |
limit |
Es la cantidad máxima de valores distintos de la dimensión de desglose que se mostrarán en la respuesta. Se usa un |
FunnelNextAction
Las acciones siguientes indican el valor de una dimensión después de que el usuario haya completado un paso, pero antes de que el mismo usuario haya completado el paso siguiente. Por ejemplo, si nextActionDimension
es eventName
, entonces nextActionDimension
en la fila del i
paso del embudo mostrará el primer evento después del evento que calificó al usuario para el i
paso del embudo, pero antes de que este haya completado el i+1
o paso del embudo.
Representación JSON |
---|
{
"nextActionDimension": {
object ( |
Campos | |
---|---|
nextActionDimension |
Es la columna de dimensiones que se agregó a la respuesta del informe secundario de visualización del embudo. La dimensión de acción siguiente muestra el valor de la dimensión siguiente después de que el usuario alcanzó el Actualmente, |
limit |
Es la cantidad máxima de valores distintos de la dimensión de desglose que se mostrarán en la respuesta. Se usa un |
FunnelVisualizationType
Controla las dimensiones presentes en la respuesta del informe secundario de visualización del embudo.
Enumeradores | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Tipo no especificado |
STANDARD_FUNNEL |
Un embudo estándar (escalonado). El informe secundario de visualización del embudo en la respuesta no contendrá fecha. |
TRENDED_FUNNEL |
Un embudo con tendencias a través del tiempo (gráfico de líneas). El informe secundario de visualización del embudo en la respuesta contendrá la dimensión de fecha. |
Segmento
Un segmento es un subconjunto de sus datos de Analytics. Por ejemplo, un segmento dentro de todo su conjunto de usuarios podría estar formado por las personas de un país o una ciudad en particular. Otro, por los usuarios que compran una línea particular de productos o que visitan una parte específica de su sitio o activan ciertos eventos en su aplicación.
Para obtener más información, consulta el Creador de segmentos de GA4.
Representación JSON |
---|
{ "name": string, // Union field |
Campos | |
---|---|
name |
Es el nombre de este segmento. Si no se especifica, los segmentos se denominan "Segmento". Este nombre define el valor de cadena que muestra la dimensión |
Campo de unión one_segment_scope . Un segmento se especifica en un alcance. Las direcciones (one_segment_scope ) solo pueden ser una de las siguientes opciones: |
|
userSegment |
Los segmentos de usuarios son subconjuntos de usuarios que interactuaron con tu sitio o aplicación. |
sessionSegment |
Los segmentos de sesiones son subconjuntos de las sesiones que ocurrieron en tu sitio o aplicación. |
eventSegment |
Los segmentos de eventos son subconjuntos de eventos que se activaron en tu sitio o aplicación. |
UserSegment
Los segmentos de usuarios son subconjuntos de usuarios que interactuaron con tu sitio o aplicación. Por ejemplo, usuarios que compraron anteriormente o que agregaron artículos a sus carritos de compras, pero no completaron una compra.
Representación JSON |
---|
{ "userInclusionCriteria": { object ( |
Campos | |
---|---|
userInclusionCriteria |
Define qué usuarios se incluyen en este segmento. Opcional. |
exclusion |
Define qué usuarios se excluyen en este segmento. Opcional. |
UserSegmentCriteria
Un usuario coincide con un criterio si sus eventos cumplen las condiciones de los criterios.
Representación JSON |
---|
{ "andConditionGroups": [ { object ( |
Campos | |
---|---|
andConditionGroups[] |
Un usuario coincide con estos criterios si coincide con cada una de estas |
andSequenceGroups[] |
Un usuario coincide con estos criterios si coincide con cada una de estas |
UserSegmentConditionGroup
Las condiciones le indican a Analytics qué datos deben incluirse en el segmento o excluirse de él.
Representación JSON |
---|
{ "conditionScoping": enum ( |
Campos | |
---|---|
conditionScoping |
Se incluyen o excluyen datos del segmento en función de si coinciden con el grupo de condiciones. Este alcance define cuántos eventos se evalúa Opcional. Si no se especifica, se usa |
segmentFilterExpression |
Se incluyen o excluyen datos del segmento en función de si coinciden con esta expresión. Las expresiones expresan criterios sobre dimensiones, métricas o parámetros. |
UserCriteriaScoping
Los permisos especifican qué eventos se tienen en cuenta cuando se evalúa si un usuario cumple con un criterio.
Enumeradores | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Determinación del alcance de los criterios. No lo especifiques. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Si los criterios se cumplen en un evento, el usuario coincidirá con los criterios. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Si los criterios se cumplen en una sesión, el usuario coincidirá con los criterios. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Si algún evento cumple con los criterios del usuario, este coincidirá con los criterios. |
SegmentFilterExpression
Expresa combinaciones de filtros de segmentos.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión expr . Especifica un tipo de filtro para SegmentFilterExpression . expr puede ser solo uno de los siguientes: |
|
andGroup |
La SegmentFilterExpression en |
orGroup |
La SegmentFilterExpression en |
notExpression |
La SegmentFilterExpression NO es de |
segmentFilter |
Un filtro de segmento primitivo |
segmentEventFilter |
Crea un filtro que coincida con los eventos de un solo nombre de evento. Si se especifica una expresión de filtro de parámetros, solo el subconjunto de eventos que coincide con el nombre del evento único y las expresiones de filtro de parámetros coincide con este filtro de evento. |
SegmentFilterExpressionList
Una lista de expresiones de filtro de segmentos.
Representación JSON |
---|
{
"expressions": [
{
object ( |
Campos | |
---|---|
expressions[] |
La lista de expresiones de filtro de segmentos |
SegmentFilter
Una expresión para filtrar valores de dimensión o métrica.
Representación JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
Campos | |
---|---|
fieldName |
El nombre de la dimensión o la métrica. |
filterScoping |
Especifica el alcance del filtro. |
Campo de unión one_filter . Especifica un tipo de filtro para Filter . one_filter puede ser solo uno de los siguientes: |
|
stringFilter |
Filtro relacionado con strings. |
inListFilter |
Un filtro para los valores en la lista. |
numericFilter |
Un filtro para valores numéricos o de fecha. |
betweenFilter |
Es un filtro para entre dos valores. |
SegmentFilterScoping
Los alcances especifican cómo se deben considerar las dimensiones y métricas de varios eventos al evaluar un filtro de segmentos.
Representación JSON |
---|
{ "atAnyPointInTime": boolean } |
Campos | |
---|---|
atAnyPointInTime |
Si el valor de Este parámetro Este Si el alcance de los criterios es |
SegmentEventFilter
Crea un filtro que coincida con los eventos de un solo nombre de evento. Si se especifica una expresión de filtro de parámetros, solo el subconjunto de eventos que coincide con el nombre del evento único y las expresiones de filtro de parámetros coincide con este filtro de evento.
Representación JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Campos | |
---|---|
eventName |
Este filtro coincide con los eventos de este nombre de evento único. El nombre del evento es obligatorio. |
segmentParameterFilterExpression |
Si se especifica, este filtro coincide con los eventos que coinciden con el nombre del evento único y las expresiones de filtro de parámetros. Dentro de la expresión de filtro de parámetros, solo los filtros de parámetros están disponibles. |
SegmentParameterFilterExpression
Expresa las combinaciones de filtro de segmentos en los parámetros.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión expr . Especifica un tipo de filtro para SegmentParameterFilterExpression . expr puede ser solo uno de los siguientes: |
|
andGroup |
La SegmentParameterFilterExpression en |
orGroup |
La SegmentParameterFilterExpression en |
notExpression |
La SegmentParameterFilterExpression NO es de |
segmentParameterFilter |
Un filtro de parámetro de segmento primitivo |
SegmentParameterFilterExpressionList
Una lista de expresiones de filtro de parámetros de segmentos.
Representación JSON |
---|
{
"expressions": [
{
object ( |
Campos | |
---|---|
expressions[] |
La lista de expresiones de filtro de parámetros de segmento. |
SegmentParameterFilter
Una expresión para filtrar los valores del parámetro en un segmento.
Representación JSON |
---|
{ "filterScoping": { object ( |
Campos | |
---|---|
filterScoping |
Especifica el alcance del filtro. |
Campo de unión one_parameter . El campo que se filtra. Las direcciones (one_parameter ) solo pueden ser una de las siguientes opciones: |
|
eventParameterName |
Este filtro se evaluará en función del parámetro de evento especificado. Los parámetros de evento se registran como parámetros del evento. Los parámetros de eventos incluyen campos como "firebase_screen" y "currency". Los parámetros de eventos solo se pueden usar en segmentos y embudos, y solo se pueden usar en un filtro descendente de un EventFilter. En un filtro descendente de un EventFilter, se deben usar los parámetros del evento o del elemento. |
itemParameterName |
Este filtro se evaluará según el parámetro del elemento especificado. Los parámetros del artículo se registran como parámetros en el array de artículos. Los parámetros del artículo incluyen campos como "item_name" y "item_category". Los parámetros de artículos solo se pueden usar en segmentos y embudos, y solo se pueden usar en un filtro descendente de un EventFilter. En un filtro descendente de un EventFilter, se deben usar los parámetros del evento o del elemento. Los parámetros del artículo solo están disponibles en los eventos de comercio electrónico. Para obtener más información sobre los eventos de comercio electrónico, consulta la guía Cómo medir el comercio electrónico. |
Campo de unión one_filter . Especifica un tipo de filtro. Las direcciones (one_filter ) solo pueden ser una de las siguientes opciones: |
|
stringFilter |
Filtro relacionado con cadenas. |
inListFilter |
Un filtro para los valores en la lista. |
numericFilter |
Un filtro para valores numéricos o de fecha. |
betweenFilter |
Es un filtro para entre dos valores. |
SegmentParameterFilterScoping
Los alcances especifican cómo se deben considerar varios eventos al evaluar un filtro de parámetro de segmento.
Representación JSON |
---|
{ "inAnyNDayPeriod": string } |
Campos | |
---|---|
inAnyNDayPeriod |
Acumula el parámetro durante el período de días especificado antes de aplicar el filtro. Solo se admite si el alcance de los criterios es Por ejemplo, si El período no se extiende para ofrecer un período completo de N días cerca del inicio del período. Por ejemplo, si un informe corresponde al 1/11/2021 al 10/11/2021 y
|
UserSegmentSequenceGroup
Define las condiciones que deben ocurrir en un orden específico para que el usuario sea miembro del segmento.
Representación JSON |
---|
{ "sequenceScoping": enum ( |
Campos | |
---|---|
sequenceScoping |
Se deben cumplir todos los pasos de la secuencia en el alcance para que el usuario coincida con la secuencia. Por ejemplo, si es Opcional. Si no se especifica, se usa |
sequenceMaximumDuration |
Define el período en el que debe ocurrir toda la secuencia; por ejemplo, 30 minutos.
Una duración en segundos con hasta nueve dígitos decimales que terminen en " |
userSequenceSteps[] |
Una secuencia ordenada de pasos de la condición. Los eventos de un usuario deben completar cada paso para que este coincida con la |
UserSequenceStep
Una condición que debe ocurrir en el orden de pasos especificado para que este usuario coincida con la secuencia.
Representación JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Campos | |
---|---|
isDirectlyFollowedBy |
Si es verdadero, el evento que completa este paso debe ser el siguiente después del evento que cumple el último paso. Si es falso, este paso sigue indirectamente al paso anterior; por ejemplo, puede haber eventos entre el paso anterior y este. |
stepScoping |
Este paso de la secuencia debe cumplirse en el alcance para que el usuario coincida con la secuencia. Por ejemplo, si es Opcional. Si no se especifica, |
segmentFilterExpression |
Un usuario coincide con este paso de la secuencia si sus eventos coinciden con esta expresión. Las expresiones expresan criterios sobre dimensiones, métricas o parámetros. |
UserSegmentExclusion
Especifica qué usuarios se excluyen en este segmento.
Representación JSON |
---|
{ "userExclusionDuration": enum ( |
Campos | |
---|---|
userExclusionDuration |
Especifica cuánto durará una exclusión si un usuario coincide con Opcional. Si no se especifica, se usa |
userExclusionCriteria |
Si un usuario cumple con esta condición, se lo excluye de la membresía en el segmento para |
UserExclusionDuration
Enumera las opciones sobre cuánto tiempo durará una exclusión si un usuario coincide con userExclusionCriteria
.
Enumeradores | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Duración de exclusión sin especificar. No lo especifiques. |
USER_EXCLUSION_TEMPORARY |
Excluye temporalmente a los usuarios del segmento durante los períodos en los que estos cumplen con la condición userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Excluye usuarios del segmento de forma permanente si estos cumplen con la condición userExclusionCriteria . |
SessionSegment
Los segmentos de sesiones son subconjuntos de las sesiones que ocurrieron en su sitio o aplicación: por ejemplo, todas las sesiones que se generaron a partir de una campaña publicitaria particular.
Representación JSON |
---|
{ "sessionInclusionCriteria": { object ( |
Campos | |
---|---|
sessionInclusionCriteria |
Define qué sesiones se incluyen en este segmento. Opcional. |
exclusion |
Define qué sesiones se excluyen en este segmento. Opcional. |
SessionSegmentCriteria
Una sesión coincide con un criterio si sus eventos cumplen las condiciones de los criterios.
Representación JSON |
---|
{
"andConditionGroups": [
{
object ( |
Campos | |
---|---|
andConditionGroups[] |
Una sesión coincide con estos criterios si coincide con cada uno de estos |
SessionSegmentConditionGroup
Las condiciones le indican a Analytics qué datos deben incluirse en el segmento o excluirse de él.
Representación JSON |
---|
{ "conditionScoping": enum ( |
Campos | |
---|---|
conditionScoping |
Se incluyen o excluyen datos del segmento en función de si coinciden con el grupo de condiciones. Este alcance define cuántos eventos se evalúa Opcional. Si no se especifica, se usa un |
segmentFilterExpression |
Se incluyen o excluyen datos del segmento en función de si coinciden con esta expresión. Las expresiones expresan criterios sobre dimensiones, métricas o parámetros. |
SessionCriteriaScoping
Los permisos especifican qué eventos se tienen en cuenta a la hora de evaluar si una sesión cumple con algún criterio.
Enumeradores | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Determinación del alcance de los criterios. No lo especifiques. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Si los criterios se cumplen en un evento, la sesión coincide con los criterios. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Si los criterios se cumplen en una sesión, esta coincidirá con los criterios. |
SessionSegmentExclusion
Especifica qué sesiones se excluyen en este segmento.
Representación JSON |
---|
{ "sessionExclusionDuration": enum ( |
Campos | |
---|---|
sessionExclusionDuration |
Especifica cuánto tiempo durará una exclusión si una sesión coincide con la Opcional. Si no se especifica, se usa un |
sessionExclusionCriteria |
Si una sesión cumple con esta condición, se excluye de la membresía en el segmento para |
SessionExclusionDuration
Enumera las opciones sobre cuánto tiempo durará una exclusión si una sesión coincide con sessionExclusionCriteria
.
Enumeradores | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Duración de exclusión sin especificar. No lo especifiques. |
SESSION_EXCLUSION_TEMPORARY |
Excluye temporalmente sesiones del segmento durante los períodos en los que la sesión cumple con la condición sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Excluye de forma permanente las sesiones del segmento si estas cumplen con la condición sessionExclusionCriteria . |
EventSegment
Los segmentos de eventos son subconjuntos de eventos que se activaron en tu sitio o aplicación. Por ejemplo, todos los eventos de compra realizados en una ubicación en particular o los eventos app_exception que ocurrieron en un sistema operativo específico.
Representación JSON |
---|
{ "eventInclusionCriteria": { object ( |
Campos | |
---|---|
eventInclusionCriteria |
Define qué eventos se incluyen en este segmento. Opcional. |
exclusion |
Define qué eventos se excluyen en este segmento. Opcional. |
EventSegmentCriteria
Un evento coincide con un criterio si cumple con las condiciones de los criterios.
Representación JSON |
---|
{
"andConditionGroups": [
{
object ( |
Campos | |
---|---|
andConditionGroups[] |
Un evento coincide con estos criterios si con cada una de estas |
EventSegmentConditionGroup
Las condiciones le indican a Analytics qué datos deben incluirse en el segmento o excluirse de él.
Representación JSON |
---|
{ "conditionScoping": enum ( |
Campos | |
---|---|
conditionScoping |
Opcional. Si no se especifica, se usa un |
segmentFilterExpression |
Se incluyen o excluyen datos del segmento en función de si coinciden con esta expresión. Las expresiones expresan criterios sobre dimensiones, métricas o parámetros. |
EventCriteriaScoping
El alcance especifica qué eventos se tienen en cuenta cuando se evalúa si un evento cumple con un criterio.
Enumeradores | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Determinación del alcance de los criterios. No lo especifiques. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Si los criterios se cumplen en un evento, el evento coincidirá con los criterios. |
EventSegmentExclusion
Especifica qué eventos se excluyen en este segmento.
Representación JSON |
---|
{ "eventExclusionDuration": enum ( |
Campos | |
---|---|
eventExclusionDuration |
Opcional. Si no se especifica, se usa un |
eventExclusionCriteria |
Si un evento cumple con esta condición, se excluye de la membresía en el segmento para |
EventExclusionDuration
Enumera las opciones sobre cuánto durará una exclusión si un evento coincide con eventExclusionCriteria
.
Enumeradores | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Duración de exclusión sin especificar. No lo especifiques. |
EVENT_EXCLUSION_PERMANENT |
Excluye eventos del segmento de forma permanente si estos cumplen con la condición eventExclusionCriteria . |
FunnelSubReport
Los informes secundarios de embudo contienen los valores de los datos de la dimensión y la métrica. Por ejemplo, 12 usuarios llegaron al segundo paso del embudo.
Representación JSON |
---|
{ "dimensionHeaders": [ { object ( |
Campos | |
---|---|
dimensionHeaders[] |
Describe las columnas de dimensiones. Los informes de embudo siempre incluyen la dimensión del paso del embudo en las respuestas de los informes secundarios. Si se solicita, la respuesta puede incluir dimensiones adicionales, como desgloses, fechas y próximas acciones. |
metricHeaders[] |
Describe columnas de métricas. Los informes de embudo siempre incluyen a los usuarios activos en las respuestas del informe secundario. La tabla del embudo incluye métricas adicionales, como el porcentaje de respuesta, los abandonos y el porcentaje de abandono. |
rows[] |
Filas de combinaciones de valores de dimensiones y valores de métricas del informe. |
metadata |
Metadatos del informe de embudo. |
FunnelResponseMetadata
Los metadatos de respuesta del informe de embudo contienen información adicional sobre el informe de embudo.
Representación JSON |
---|
{
"samplingMetadatas": [
{
object ( |
Campos | |
---|---|
samplingMetadatas[] |
Si los resultados del informe de embudo se muestrean, esto describe qué porcentaje de eventos se usó en ese informe de embudo. Se propaga un valor Sin embargo, si los resultados no se muestrean, este campo no se definirá. |
SamplingMetadata
Si los resultados del informe de embudo se muestrean, estos metadatos describen qué porcentaje de eventos se utilizó en este informe de embudo para un período determinado. El muestreo es la práctica de analizar un subconjunto de todos los datos para descubrir la información significativa de un conjunto de datos más grande.
Representación JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Campos | |
---|---|
samplesReadCount |
La cantidad total de eventos leídos en este informe de muestra para un período determinado. Es el tamaño del subconjunto de datos de esta propiedad que se analizaron en este informe de embudo. |
samplingSpaceSize |
Es la cantidad total de eventos presentes en los datos de esta propiedad que podrían haberse analizado en este informe de embudo durante un período. El muestreo revela la información significativa sobre el conjunto de datos más grande, que es el tamaño del conjunto de datos más grande. Para calcular el porcentaje de datos disponibles que se usaron en este informe de embudo, calcula |
PropertyQuota
Estado actual de todas las cuotas de esta propiedad de Analytics. Si se agota la cuota de una propiedad, todas las solicitudes que se hagan a esa propiedad mostrarán errores de recursos agotados.
Representación JSON |
---|
{ "tokensPerDay": { object ( |
Campos | |
---|---|
tokensPerDay |
Las propiedades de Analytics estándares pueden usar hasta 200,000 tokens por día, mientras que las propiedades de Analytics 360 pueden usar 2,000,000 de tokens por día. La mayoría de las solicitudes consumen menos de 10 tokens. |
tokensPerHour |
Las propiedades de Analytics estándares pueden utilizar hasta 40,000 tokens por hora, mientras que las propiedades de Analytics 360 pueden utilizar 400,000 tokens por hora. Una solicitud a la API consume una sola cantidad de tokens, y esa cantidad se deduce de todas las cuotas por hora, por día y por proyecto. |
concurrentRequests |
Las propiedades de Analytics estándares pueden enviar hasta 10 solicitudes simultáneas, mientras que las propiedades de Analytics 360 pueden usar hasta 50 solicitudes simultáneas. |
serverErrorsPerProjectPerHour |
Las propiedades de estadísticas estándares y los pares de proyectos de nube pueden tener hasta 10 errores de servidor por hora. Las propiedades de Analytics 360 y los pares de proyectos de la nube pueden tener hasta 50 errores de servidor por hora. |
potentiallyThresholdedRequestsPerHour |
Las propiedades de Analytics pueden enviar hasta 120 solicitudes con dimensiones potencialmente limitadas por hora. En una solicitud por lotes, cada solicitud de informe se cuenta de forma individual para esta cuota si la solicitud contiene dimensiones potencialmente limitadas. |
tokensPerProjectPerHour |
Las propiedades de Analytics pueden utilizar hasta un 35% de sus tokens por proyecto y por hora. Esto equivale a las propiedades de Analytics estándares que pueden usar hasta 14,000 tokens por proyecto y por hora, mientras que las propiedades de Analytics 360 pueden utilizar 140,000 tokens por proyecto por hora. Una solicitud a la API consume una sola cantidad de tokens, y esa cantidad se deduce de todas las cuotas por hora, por día y por proyecto. |
QuotaStatus
El estado actual de un grupo de cuotas en particular.
Representación JSON |
---|
{ "consumed": integer, "remaining": integer } |
Campos | |
---|---|
consumed |
Cuota consumida por esta solicitud. |
remaining |
Cuota restante después de esta solicitud. |