- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Embudo
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segmentar
- 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ébalo
Devuelve un informe de embudo personalizado con tus datos de eventos de Google Analytics. Los datos que muestra la API son una 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 el artículo 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 sobre los informes del 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 URL, no en el cuerpo. Para obtener más información, consulta dónde encontrar tu ID de propiedad. En una solicitud por lotes, esta propiedad debe no estar especificada o ser coherente con la propiedad de 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 datos para leer. 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 esos días se incluirán 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 subinforme de la tabla de embudo. Esta dimensión de desglose expande cada paso del embudo a los valores únicos de la dimensión de desglose. Por ejemplo, un desglose por la dimensión |
funnelNextAction |
Opcional. Si se especifica, la acción siguiente agrega una dimensión a la respuesta del subinforme de la visualización del embudo de conversión. La siguiente dimensión de acción expande cada paso del embudo de conversión a los valores únicos de la siguiente acción. Por ejemplo, la siguiente acción de la dimensión La siguiente acción solo es compatible con |
funnelVisualizationType |
Opcional. El tipo de visualización del embudo controla las dimensiones presentes en la respuesta del subinforme de la 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. Número 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, independientemente de cuántas solicites. El valor de La API también puede mostrar menos filas que la |
dimensionFilter |
Opcional. Los filtros de dimensión te permiten solicitar solo valores de dimensión específicos en el informe. Para obtener más información, consulta Cómo crear un informe: Filtros de dimensión para ver ejemplos. No se pueden usar métricas en este filtro. |
returnPropertyQuota |
Opcional. Activa o desactiva la opción para que se muestre 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 subinformes 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 de embudo es un informe con el paso del embudo de conversión, el segmento, la dimensión de desglose, los usuarios activos, los porcentajes de respuesta, y los porcentajes de abandonos y abandonos. 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 de conversión, el segmento, la fecha, la dimensión de la siguiente acción y los usuarios activos. La dimensión del segmento solo está presente en esta respuesta si se solicitó un segmento. La dimensión de la 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, incluida esta solicitud. |
kind |
Identifica a qué tipo de recurso es este mensaje. Este |
Alcances de autorización
Se necesita uno de los siguientes permisos 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 a 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 |
En el caso de un embudo abierto, los usuarios pueden ingresar en cualquier paso y, en el caso de un embudo cerrado, los usuarios deben ingresar en el primer paso. Opcional. Si no se especifica, se utiliza un embudo cerrado. |
steps[] |
Son 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 de este paso. Si no se especifica, los pasos se nombrarán con un nombre indexado con un 1 (por ejemplo, "0. ", "1. ", etc.). 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 debe completarse dentro del plazo establecido a partir del paso anterior.
Una duración en segundos con hasta nueve dígitos decimales, que terminan 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 de |
orGroup |
La FunnelFilterExpression de |
notExpression |
La FunnelFilterExpression NO es de |
funnelFieldFilter |
Es un filtro de embudo para una dimensión o métrica. |
funnelEventFilter |
Crea un filtro que coincide 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 coinciden 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 |
Es el nombre de la dimensión o de 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 las cadenas. |
inListFilter |
Un filtro para los valores de lista. |
numericFilter |
Es un filtro para valores numéricos o de fecha. |
betweenFilter |
Un filtro entre dos valores. |
FunnelEventFilter
Crea un filtro que coincide 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 coinciden con este filtro de evento.
Representación JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Campos | |
---|---|
eventName |
Este filtro coincide con los eventos de este solo nombre de evento. 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 están disponibles los filtros de parámetros. |
FunnelParameterFilterExpression
Expresa combinaciones de filtros de embudo en 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 |
FunnelParameterFilterExpression NO es de |
funnelParameterFilter |
Un filtro básico de parámetros de embudo. |
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 los 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 el parámetro del evento especificado. Los parámetros del evento se registran como parámetros del evento. Los parámetros de evento 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 descendiente de un EventFilter. En un filtro subordinado de un EventFilter, se deben usar los parámetros de evento o elemento. |
itemParameterName |
Este filtro se evaluará en el parámetro del elemento especificado. Los parámetros de artículos se registran como parámetros en el array de artículos. Los parámetros de artículos 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 descendiente de un EventFilter. En un filtro subordinado de un EventFilter, se deben usar los parámetros de evento o elemento. Los parámetros de artículos 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 las cadenas. |
inListFilter |
Un filtro para los valores de lista. |
numericFilter |
Es un filtro para valores numéricos o de fecha. |
betweenFilter |
Un filtro 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 agrega a la respuesta del subinforme de la tabla de embudos. 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. Si no se especifica un límite, se usa un |
FunnelNextAction
Las acciones siguientes indican el valor de una dimensión después de que el usuario ha alcanzado un paso, pero antes de que el mismo usuario haya alcanzado el paso siguiente. Por ejemplo, si nextActionDimension
es eventName
, nextActionDimension
en la i
fila del paso del embudo de conversión mostrará el primer evento después del evento que calificó al usuario para el i
.o paso del embudo, pero antes de que este haya alcanzado el i+1
.
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 de conversión. La siguiente dimensión de acción muestra el siguiente valor de dimensión de esta dimensión 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. Si no se especifica un límite, se usa un |
FunnelVisualizationType
Controla las dimensiones presentes en la respuesta del subinforme de la visualización del embudo de conversión.
Enumeraciones | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Tipo no especificado |
STANDARD_FUNNEL |
Un embudo (escalonado) estándar. El subinforme de visualización del embudo en la respuesta no contendrá la fecha. |
TRENDED_FUNNEL |
Un embudo con tendencias a través del tiempo (gráfico de líneas) El subinforme 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 . Se especifica un segmento 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, los usuarios que realizaron compras anteriormente. usuarios 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 de 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 coincidirá con estos criterios si coincide con cada una de estas |
andSequenceGroups[] |
Un usuario coincidirá 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 |
Los datos se incluyen o excluyen del segmento según si coinciden con el grupo de condiciones. Este alcance define la cantidad de eventos en los que se evalúa Opcional. Si no se especifica, se usa |
segmentFilterExpression |
Los datos se incluyen en el segmento o se excluyen de él si coinciden con esta expresión. Las expresiones expresan criterios de una dimensión, métricas o parámetros. |
UserCriteriaScoping
La determinación del alcance especifica qué eventos se consideran al evaluar si un usuario cumple con un criterio.
Enumeraciones | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Alcance de criterios no especificados. No especifiques. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Si se cumplen los criterios dentro de un evento, el usuario coincide con los criterios. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Si se cumplen los criterios en una sesión, el usuario coincide con los criterios. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Si algún evento del usuario cumple los criterios, este coincide 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 |
SegmentFilterExpression NO es |
segmentFilter |
Un filtro de segmento primitivo. |
segmentEventFilter |
Crea un filtro que coincide 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 coinciden 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 |
Es el nombre de la dimensión o de 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 las cadenas. |
inListFilter |
Un filtro para los valores de lista. |
numericFilter |
Es un filtro para valores numéricos o de fecha. |
betweenFilter |
Un filtro entre dos valores. |
SegmentFilterScoping
Los permisos especifican cómo las dimensiones y las métricas de varios eventos deben considerarse cuando se evalúa un filtro de segmento.
Representación JSON |
---|
{ "atAnyPointInTime": boolean } |
Campos | |
---|---|
atAnyPointInTime |
Si Este parámetro Este Si el alcance de los criterios es |
SegmentEventFilter
Crea un filtro que coincide 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 coinciden con este filtro de evento.
Representación JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Campos | |
---|---|
eventName |
Este filtro coincide con los eventos de este solo nombre de evento. 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 están disponibles los filtros de parámetros. |
SegmentParameterFilterExpression
Expresa combinaciones de filtros 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 |
SegmentParameterFilterExpression NO es |
segmentParameterFilter |
Un filtro de parámetros de segmento primitivo. |
SegmentParameterFilterExpressionList
Una lista de expresiones de filtro de parámetros de segmento.
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 de los parámetros 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 el parámetro del evento especificado. Los parámetros del evento se registran como parámetros del evento. Los parámetros de evento 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 descendiente de un EventFilter. En un filtro subordinado de un EventFilter, se deben usar los parámetros de evento o elemento. |
itemParameterName |
Este filtro se evaluará en el parámetro del elemento especificado. Los parámetros de artículos se registran como parámetros en el array de artículos. Los parámetros de artículos 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 descendiente de un EventFilter. En un filtro subordinado de un EventFilter, se deben usar los parámetros de evento o elemento. Los parámetros de artículos 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 las cadenas. |
inListFilter |
Un filtro para los valores de lista. |
numericFilter |
Es un filtro para valores numéricos o de fecha. |
betweenFilter |
Un filtro entre dos valores. |
SegmentParameterFilterScoping
Los permisos especifican cómo se deben considerar varios eventos cuando se evalúa un filtro de parámetros del segmento.
Representación JSON |
---|
{ "inAnyNDayPeriod": string } |
Campos | |
---|---|
inAnyNDayPeriod |
Acumula el parámetro durante el período especificado de días antes de aplicar el filtro. Solo se admite si el alcance de los criterios es Por ejemplo, si El período no se extiende con el fin de tener una ventana completa de N días cerca del inicio del período. Por ejemplo, si un informe es del 1 al 10 de noviembre de 2021 y
|
UserSegmentSequenceGroup
Definir 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 terminan en “ |
userSequenceSteps[] |
Una secuencia ordenada de pasos de condición. Los eventos de un usuario deben completar cada paso para que este coincida con el |
UserSequenceStep
Es 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 satisface este paso debe ser el próximo evento después del evento que cumple con 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 de una dimensión, métricas o parámetros. |
UserSegmentExclusion
Especifica qué usuarios se excluyen de este segmento.
Representación JSON |
---|
{ "userExclusionDuration": enum ( |
Campos | |
---|---|
userExclusionDuration |
Especifica cuánto tiempo 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 excluirá de la membresía del segmento de |
UserExclusionDuration
Enumera las opciones de cuánto durará una exclusión si un usuario coincide con userExclusionCriteria
.
Enumeraciones | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Duración de exclusión no especificada. No especifiques. |
USER_EXCLUSION_TEMPORARY |
Excluye a los usuarios del segmento de forma temporal durante los períodos en los que cumplen la condición userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Excluye a los usuarios del segmento de forma permanente si alguna vez cumplen 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 de 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 coincidirá 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 |
Los datos se incluyen o excluyen del segmento según si coinciden con el grupo de condiciones. Este alcance define la cantidad de eventos en los que se evalúa Opcional. Si no se especifica, se usa un |
segmentFilterExpression |
Los datos se incluyen en el segmento o se excluyen de él si coinciden con esta expresión. Las expresiones expresan criterios de una dimensión, métricas o parámetros. |
SessionCriteriaScoping
La determinación de alcances especifica qué eventos se consideran cuando se evalúa si una sesión cumple con un criterio.
Enumeraciones | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Alcance de criterios no especificados. No especifiques. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Si se cumplen los criterios dentro de un evento, la sesión coincide con los criterios. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Si se cumplen los criterios en una sesión, esta coincide con los criterios. |
SessionSegmentExclusion
Especifica qué sesiones se excluyen de este segmento.
Representación JSON |
---|
{ "sessionExclusionDuration": enum ( |
Campos | |
---|---|
sessionExclusionDuration |
Especifica cuánto durará una exclusión si una sesión coincide con Opcional. Si no se especifica, se usa un |
sessionExclusionCriteria |
Si una sesión cumple con esta condición, se excluirá de la membresía del segmento para |
SessionExclusionDuration
Enumera las opciones de cuánto durará una exclusión si una sesión coincide con sessionExclusionCriteria
.
Enumeraciones | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Duración de exclusión no especificada. No especifiques. |
SESSION_EXCLUSION_TEMPORARY |
Excluye sesiones del segmento de forma temporal durante los períodos en los que la sesión cumpla con la condición sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Excluye sesiones del segmento de forma permanente 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. 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 de 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 coincide con cada uno de estos |
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 |
Los datos se incluyen en el segmento o se excluyen de él si coinciden con esta expresión. Las expresiones expresan criterios de una dimensión, métricas o parámetros. |
EventCriteriaScoping
El alcance especifica qué eventos se consideran cuando se evalúa si un evento cumple con un criterio.
Enumeraciones | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Alcance de criterios no especificados. No especifiques. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Si se cumplen los criterios dentro de un evento, el evento coincide con los criterios. |
EventSegmentExclusion
Especifica qué eventos se excluyen de 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 excluirá de la membresía del segmento en |
EventExclusionDuration
Enumera las opciones de cuánto durará una exclusión si un evento coincide con eventExclusionCriteria
.
Enumeraciones | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Duración de exclusión no especificada. No especifiques. |
EVENT_EXCLUSION_PERMANENT |
Excluye eventos del segmento de manera permanente si cumplen con la condición eventExclusionCriteria . |
FunnelSubReport
Los subinformes del embudo contienen los valores de datos de las dimensiones y las métricas. Por ejemplo, 12 usuarios alcanzaron el 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 de pasos del embudo de conversión en las respuestas de los subinformes. Si se solicita, es posible que en la respuesta se incluyan dimensiones adicionales, como desgloses, fechas y acciones siguientes. |
metricHeaders[] |
Describe las columnas de métricas. Los informes de embudos siempre incluyen a los usuarios activos en las respuestas de los subinformes. La tabla del embudo incluye métricas adicionales, como los porcentajes de respuesta, abandonos y porcentaje de abandonos. |
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 incluyen 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 el porcentaje de eventos que se usaron en este informe de embudo. Se propaga un 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 usaron 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 información significativa en el conjunto de datos más grande.
Representación JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Campos | |
---|---|
samplesReadCount |
Es la cantidad total de eventos leídos en este informe de muestra para un período. Este es el tamaño del subconjunto de datos de esta propiedad que se analizó en este informe de embudo. |
samplingSpaceSize |
Es la cantidad total de eventos presentes en los datos de esta propiedad que se podrían haber analizado en este informe de embudo durante un período. El muestreo descubre 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 alguna cuota para una propiedad, todas las solicitudes 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. 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 usar hasta 40,000 tokens por hora. Las propiedades de Analytics 360 pueden usar 400,000 tokens por hora. Una solicitud a la API consume un solo número de tokens, y ese número se deduce de todas las cuotas por hora, día y por proyecto. |
concurrentRequests |
Las propiedades estándares de Analytics pueden enviar hasta 10 solicitudes simultáneas. Las propiedades de Analytics 360 pueden usar hasta 50 solicitudes simultáneas. |
serverErrorsPerProjectPerHour |
Las propiedades de Analytics estándares y los pares de proyectos de la 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 que posiblemente estén limitadas. |
tokensPerProjectPerHour |
Las propiedades de Analytics pueden usar hasta el 35% de sus tokens por proyecto por hora. Esto equivale a las propiedades estándares de Analytics, que pueden usar hasta 14,000 tokens por proyecto por hora, y las propiedades de Analytics 360 pueden usar 140,000 tokens por proyecto por hora. Una solicitud a la API consume un solo número de tokens, y ese número se deduce de todas las cuotas por hora, 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. |