Method: properties.runFunnelReport

Retorna um relatório de funil personalizado dos seus dados de eventos do Google Analytics. Os dados retornados pela API são uma tabela com colunas para as dimensões e métricas solicitadas.

Com a análise de funil, você vê as etapas que os usuários realizam até concluir uma tarefa e em quais delas eles permanecem no funil. Por exemplo, como os compradores em potencial começam uma compra e a finalizam? Como compradores únicos se tornam recorrentes? Com essas informações, você pode melhorar as jornadas do cliente evitando interrupções ou abandonos. Para saber mais, consulte Análises detalhadas de funil do GA4.

Esse método é introduzido na estabilidade Alfa com a intenção de coletar feedback sobre a sintaxe e os recursos antes de chegar à versão Beta. Para enviar seu feedback sobre essa API, preencha o Feedback de relatório do funil da API Data do Google Analytics.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
property

string

Opcional. Um identificador de propriedade do Google Analytics cujos eventos são acompanhados. Especificado no caminho do URL, e não no corpo. Para saber mais, consulte onde encontrar o ID da propriedade. Em uma solicitação em lote, essa propriedade precisa ser não especificada ou consistente com a propriedade no nível do lote.

Exemplo: properties/1234

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Campos
dateRanges[]

object (DateRange)

Opcional. Períodos de dados a serem lidos. Se vários períodos forem solicitados, cada linha de resposta vai conter um índice de período com base em zero. Se dois períodos se sobrepõem, os dados de eventos dos dias em que há sobreposição são incluídos nas linhas de resposta de ambos os períodos.
funnel

object (Funnel)

Opcional. A configuração do funil da solicitação. Essa configuração de funil é obrigatória.
funnelBreakdown

object (FunnelBreakdown)

Opcional. Se especificado, esse detalhamento adiciona uma dimensão à resposta do subrelatório da tabela de funil. Essa dimensão de detalhamento expande cada etapa do funil para os valores únicos da dimensão de detalhamento. Por exemplo, uma divisão pela dimensão deviceCategory cria linhas para mobile, tablet, desktop e o total.
funnelNextAction

object (FunnelNextAction)

Opcional. Se especificado, a próxima ação adiciona uma dimensão à resposta do subrelatório da visualização do funil. Essa dimensão expande cada etapa do funil para os valores exclusivos da próxima ação. Por exemplo, uma próxima ação da dimensão eventName cria linhas para vários eventos (por exemplo, session_start e click) e o total.

A próxima ação só aceita eventName e a maioria das dimensões de página / tela, como pageTitle e pagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

Opcional. O tipo de visualização de funil controla as dimensões presentes na resposta do subrelatório da visualização de funil. Se não for especificado, STANDARD_FUNNEL será usado.
segments[]

object (Segment)

Opcional. As configurações dos segmentos. Os segmentos são subconjuntos dos dados de uma propriedade. Em um relatório de funil com segmentos, o funil é avaliado em cada segmento.

Cada segmento especificado nesta solicitação gera uma linha separada na resposta. Na resposta, cada segmento é identificado pelo nome.

O parâmetro "segments" é opcional. As solicitações são limitadas a quatro segmentos.
limit

string (int64 format)

Opcional. O número de linhas que serão retornadas. Se não for especificado, 10.000 linhas serão retornadas. A API retorna um máximo de 250.000 linhas por solicitação, não importa quantas você solicitar. limit precisa ser positivo.

A API também pode retornar menos linhas do que o limit solicitado, se não houver tantos valores de dimensão quanto o limit.
dimensionFilter

object (FilterExpression)

Opcional. Com os filtros de dimensão, você pode solicitar apenas valores de dimensão específicos no relatório. Para saber mais, consulte Como criar um relatório: filtros de dimensão para conferir exemplos. Não é possível usar métricas neste filtro.
returnPropertyQuota

boolean

Opcional. Define se o estado atual da cota da propriedade do Google Analytics vai ser retornado. A cota é retornada em PropertyQuota.

Corpo da resposta

A resposta do Relatório de funil contém dois subrelatórios. Os dois subrelatórios são combinações diferentes de dimensões e métricas.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Campos
funnelTable

object (FunnelSubReport)

A tabela de funil é um relatório com a etapa do funil, o segmento, a dimensão de detalhamento, os usuários ativos, a taxa de conclusão, os abandonos e a taxa de abandono.

A dimensão do segmento só vai estar presente nessa resposta se um segmento tiver sido solicitado. A dimensão de detalhamento só vai estar presente nesta resposta se tiver sido solicitada.
funnelVisualization

object (FunnelSubReport)

A visualização do funil é um relatório com a etapa do funil, o segmento, a data, a dimensão da próxima ação e os usuários ativos.

A dimensão do segmento só vai estar presente nessa resposta se um segmento tiver sido solicitado. A dimensão de data só vai estar presente nesta resposta se tiver sido solicitada pelo tipo de funil TRENDED_FUNNEL. A dimensão da próxima ação só vai estar presente na resposta se tiver sido solicitada.
propertyQuota

object (PropertyQuota)

O estado da cota dessa propriedade do Google Analytics, incluindo essa solicitação.
kind

string

Identifica o tipo de recurso da mensagem. Esse kind é sempre a string fixa "analyticsData#runFunnelReport". Útil para distinguir entre tipos de resposta em JSON.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

Funil

Configura o funil em uma solicitação de relatório de funil. Um funil informa sobre os usuários à medida que eles passam por uma sequência de etapas.

Com a análise de funil, você vê as etapas que os usuários realizam até concluir uma tarefa e em quais delas eles permanecem no funil. Por exemplo, como os compradores em potencial começam uma compra e a finalizam? Como compradores únicos se tornam recorrentes? Com essas informações, você pode melhorar as jornadas do cliente evitando interrupções ou abandonos.

Representação JSON 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Campos
isOpenFunnel

boolean

Em um funil aberto, os usuários podem entrar em qualquer etapa, e em um funil fechado, eles precisam entrar na primeira etapa. Opcional. Se não for especificado, um funil fechado será usado.
steps[]

object (FunnelStep)

As etapas sequenciais deste funil.

FunnelStep

As etapas definem a jornada do usuário que você quer mensurar. As etapas contêm uma ou mais condições que os usuários precisam atender para serem incluídos nessa etapa do funil.

Representação JSON 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Campos
name

string

O nome distinto dessa etapa. Se não for especificado, as etapas vão ser nomeadas com um nome indexado com base em 1 (por exemplo, "0. ", "1. ", etc.). Esse nome define o valor da string retornado pela dimensão funnelStepName. Por exemplo, especificar name = Purchase na terceira etapa do funil da solicitação vai produzir 3. Purchase na resposta do relatório de funil.
isDirectlyFollowedBy

boolean

Se for verdadeiro, essa etapa precisa seguir diretamente a anterior. Se for falso, pode haver eventos entre a etapa anterior e esta. Se não for especificado, isDirectlyFollowedBy será tratado como falso.
filterExpression

object (FunnelFilterExpression)

A condição que os usuários precisam atender para serem incluídos nessa etapa do funil.
withinDurationFromPriorStep

string (Duration format)

Se especificado, essa etapa precisa ser concluída dentro desse período após a conclusão da etapa anterior. withinDurationFromPriorStep inclui o endpoint na granularidade de microssegundos. Por exemplo, uma duração de 5 segundos pode ser concluída em 4,9 ou 5,0 segundos, mas não em 5 segundos e 1 microssegundo.

withinDurationFromPriorStep é opcional e, se não for especificado, as etapas podem ser separadas por qualquer duração.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

FunnelFilterExpression

Expressa combinações de filtros de funil.

Representação JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Campos
Campo de união expr. Especifique um tipo de filtro para FunnelFilterExpression. expr pode ser apenas de um dos tipos a seguir:
andGroup

object (FunnelFilterExpressionList)

A FunnelFilterExpression em andGroup tem uma relação AND.
orGroup

object (FunnelFilterExpressionList)

A FunnelFilterExpression em orGroup tem uma relação OR.
notExpression

object (FunnelFilterExpression)

A FunnelFilterExpression NÃO é notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Um filtro de funil para uma dimensão ou métrica.
funnelEventFilter

object (FunnelEventFilter)

Cria um filtro que corresponde a eventos de um único nome de evento. Se uma expressão de filtro de parâmetro for especificada, apenas o subconjunto de eventos que corresponderem ao nome do evento único e às expressões de filtro de parâmetro vai corresponder a esse filtro de evento.

FunnelFilterExpressionList

Uma lista de expressões de filtro de funil.

Representação JSON 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Campos
expressions[]

object (FunnelFilterExpression)

A lista de expressões de filtro de funil.

FunnelFieldFilter

Uma expressão para filtrar valores de dimensão ou métrica.

Representação JSON 
{
  "fieldName": string,

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

string

O nome da dimensão ou da métrica.
Campo de união one_filter. Especifique um tipo de filtro. one_filter pode ser apenas de um dos tipos a seguir:
stringFilter

object (StringFilter)

Filtro relacionado a strings.
inListFilter

object (InListFilter)

Um filtro para valores de lista.
numericFilter

object (NumericFilter)

Um filtro para valores numéricos ou de data.
betweenFilter

object (BetweenFilter)

Um filtro entre dois valores.

FunnelEventFilter

Cria um filtro que corresponde a eventos de um único nome de evento. Se uma expressão de filtro de parâmetro for especificada, apenas o subconjunto de eventos que corresponderem ao nome do evento único e às expressões de filtro de parâmetro vai corresponder a esse filtro de evento.

Representação JSON 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Campos
eventName

string

Esse filtro corresponde a eventos com esse nome. O nome do evento é obrigatório.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Se especificado, esse filtro corresponde a eventos que correspondem ao nome de um único evento e às expressões de filtro de parâmetro.

Dentro da expressão do filtro de parâmetro, apenas os filtros de parâmetro estão disponíveis.

FunnelParameterFilterExpression

Expressa combinações de filtros de funil em parâmetros.

Representação JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Campos
Campo de união expr. Especifique um tipo de filtro para FunnelParameterFilterExpression. expr pode ser apenas de um dos tipos a seguir:
andGroup

object (FunnelParameterFilterExpressionList)

A FunnelParameterFilterExpression em andGroup tem uma relação AND.
orGroup

object (FunnelParameterFilterExpressionList)

A FunnelParameterFilterExpression em orGroup tem uma relação OR.
notExpression

object (FunnelParameterFilterExpression)

A FunnelParameterFilterExpression NÃO é notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Um filtro de parâmetro de funil primitivo.

FunnelParameterFilterExpressionList

Uma lista de expressões de filtro de parâmetro do funil.

Representação JSON 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Campos
expressions[]

object (FunnelParameterFilterExpression)

A lista de expressões de filtro do parâmetro do funil.

FunnelParameterFilter

Uma expressão para filtrar valores de parâmetro em um funil.

Representação JSON 
{

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

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Campos
Campo de união one_parameter. O campo que está sendo filtrado. one_parameter pode ser apenas de um dos tipos a seguir:
eventParameterName

string

Esse filtro será avaliado no parâmetro de evento especificado. Os parâmetros de evento são registrados como parâmetros do evento. Os parâmetros de evento incluem campos como "firebase_screen" e "currency".

Os parâmetros de eventos só podem ser usados em segmentos e funis e em um filtro descendente de um EventFilter. Em um filtro descendente de um EventFilter, é preciso usar parâmetros de evento ou de item.
itemParameterName

string

Esse filtro será avaliado no parâmetro de item especificado. Os parâmetros do item são registrados como parâmetros na matriz de itens. Os parâmetros de item incluem campos como "item_name" e "item_category".

Os parâmetros de item só podem ser usados em segmentos e funis e em um filtro descendente de um EventFilter. Em um filtro descendente de um EventFilter, é preciso usar parâmetros de evento ou de item.

Os parâmetros de item estão disponíveis apenas em eventos de e-commerce. Para saber mais sobre os eventos de e-commerce, consulte o guia Medir o e-commerce.
Campo de união one_filter. Especifique um tipo de filtro. one_filter pode ser apenas de um dos tipos a seguir:
stringFilter

object (StringFilter)

Filtro relacionado a strings.
inListFilter

object (InListFilter)

Um filtro para valores de lista.
numericFilter

object (NumericFilter)

Um filtro para valores numéricos ou de data.
betweenFilter

object (BetweenFilter)

Um filtro entre dois valores.

FunnelBreakdown

As decomposições adicionam uma dimensão à resposta do subrelatório da tabela de funil.

Representação JSON 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Campos
breakdownDimension

object (Dimension)

A coluna de dimensão adicionada à resposta do subrelatório da tabela de funil. A dimensão de detalhamento detalha cada etapa do funil. Um breakdownDimension válido é necessário se funnelBreakdown for especificado.
limit

string (int64 format)

O número máximo de valores distintos da dimensão de detalhamento a serem retornados na resposta. Um limit de 5 será usado se o limite não for especificado. O limite precisa ser maior que zero e não pode exceder 15.

FunnelNextAction

As próximas ações indicam o valor de uma dimensão depois que o usuário concluiu uma etapa, mas antes de concluir a próxima. Por exemplo, se nextActionDimension for eventName, nextActionDimension na linha da iª etapa do funil vai retornar o primeiro evento após o evento que qualificou o usuário para a iª etapa do funil, mas antes de o usuário alcançar a i+1ª etapa do funil.

Representação JSON 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Campos
nextActionDimension

object (Dimension)

A coluna de dimensão adicionada à resposta do subrelatório da visualização de funil. A dimensão da próxima ação retorna o próximo valor da dimensão depois que o usuário alcança a iª etapa do funil.

No momento, o nextActionDimension só oferece suporte a eventName e à maioria das dimensões de página / tela, como pageTitle e pagePath. nextActionDimension não pode ser uma expressão de dimensão.
limit

string (int64 format)

O número máximo de valores distintos da dimensão de detalhamento a serem retornados na resposta. Um limit de 5 será usado se o limite não for especificado. O limite precisa ser maior que zero e não pode exceder 5.

FunnelVisualizationType

Controla as dimensões presentes na resposta do subrelatório de visualização do funil.

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Tipo não especificado.
STANDARD_FUNNEL Um funil padrão (em degraus). O subrelatório de visualização do funil na resposta não vai conter a data.
TRENDED_FUNNEL Um funil de tendência (gráfico de linhas). O subrelatório de visualização do funil na resposta vai conter a dimensão de data.

Segmento

Um segmento é um subconjunto de dados do Google Analytics. que, por exemplo, pode ser composto por usuários de um determinado país ou cidade ou que compram uma determinada linha de produtos, acessam uma parte específica do seu site ou acionam certos eventos no app.

Para saber mais, consulte Criador de segmentos.

Representação JSON 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
Campos
name

string

O nome do segmento. Se não for especificado, os segmentos serão nomeados como "Segmento". Esse nome define o valor da string retornado pela dimensão segment. A dimensão segment prefixa os nomes de segmentos pelo número de índice com base em 1 do segmento na solicitação (por exemplo, "1. Segmento", "2. Segmento", etc.).
Campo de união one_segment_scope. Um segmento é especificado em um escopo. one_segment_scope pode ser apenas de um dos tipos a seguir:
userSegment

object (UserSegment)

Os segmentos de usuários são subconjuntos de usuários que interagiram com seu site ou app.
sessionSegment

object (SessionSegment)

Os segmentos de sessões são subconjuntos das sessões que ocorreram no seu site ou app.
eventSegment

object (EventSegment)

Os segmentos de eventos são subconjuntos de eventos acionados no seu site ou app.

UserSegment

Os segmentos de usuários são subconjuntos de pessoas que interagiram com seu site ou app, por exemplo, que fizeram compras ou que adicionaram itens ao carrinho, mas não concluíram uma compra.

Representação JSON 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Campos
userInclusionCriteria

object (UserSegmentCriteria)

Define quais usuários são incluídos neste segmento. Opcional.
exclusion

object (UserSegmentExclusion)

Define quais usuários são excluídos neste segmento. Opcional.

UserSegmentCriteria

Um usuário corresponde a um critério se os eventos dele atendem às condições do critério.

Representação JSON 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Campos
andConditionGroups[]

object (UserSegmentConditionGroup)

Um usuário atende a esse critério se atender a cada um desses andConditionGroups e a cada um dos andSequenceGroups. andConditionGroups pode ficar vazio se andSequenceGroups for especificado.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Um usuário atende a esse critério se atender a cada um desses andSequenceGroups e a cada um dos andConditionGroups. andSequenceGroups pode ficar vazio se andConditionGroups for especificado.

UserSegmentConditionGroup

As condições informam ao Google Analytics quais dados incluir ou excluir do segmento.

Representação JSON 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campos
conditionScoping

enum (UserCriteriaScoping)

Os dados são incluídos ou excluídos do segmento com base na correspondência com o grupo de condições. Esse escopo define quantos eventos o segmentFilterExpression é avaliado antes que o grupo de condições seja determinado como correspondente ou não. Por exemplo, se conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, a expressão é avaliada em todos os eventos de uma sessão e, em seguida, o grupo de condições é determinado como correspondente ou não para esse usuário. Por exemplo, se conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, a expressão é avaliada em um único evento e, em seguida, o grupo de condições é determinado como correspondente ou não para esse usuário.

Opcional. Se não for especificado, conditionScoping = ACROSS_ALL_SESSIONS será usado.
segmentFilterExpression

object (SegmentFilterExpression)

Os dados são incluídos ou excluídos do segmento com base na correspondência com essa expressão. As expressões expressam critérios sobre dimensões, métricas e/ou parâmetros.

UserCriteriaScoping

O escopo especifica quais eventos são considerados ao avaliar se um usuário atende a um critério.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Escopo de critérios não especificado. Não especificar.
USER_CRITERIA_WITHIN_SAME_EVENT Se os critérios forem atendidos em um evento, o usuário vai corresponder aos critérios.
USER_CRITERIA_WITHIN_SAME_SESSION Se os critérios forem atendidos em uma sessão, o usuário vai corresponder aos critérios.
USER_CRITERIA_ACROSS_ALL_SESSIONS Se os critérios forem atendidos por qualquer evento do usuário, ele vai corresponder aos critérios.

SegmentFilterExpression

Expressa combinações de filtros de segmento.

Representação JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Campos
Campo de união expr. Especifique um tipo de filtro para SegmentFilterExpression. expr pode ser apenas de um dos tipos a seguir:
andGroup

object (SegmentFilterExpressionList)

A SegmentFilterExpression em andGroup tem uma relação AND.
orGroup

object (SegmentFilterExpressionList)

A SegmentFilterExpression em orGroup tem uma relação OR.
notExpression

object (SegmentFilterExpression)

A SegmentFilterExpression NÃO é notExpression.
segmentFilter

object (SegmentFilter)

Um filtro de segmento primitivo.
segmentEventFilter

object (SegmentEventFilter)

Cria um filtro que corresponde a eventos de um único nome de evento. Se uma expressão de filtro de parâmetro for especificada, apenas o subconjunto de eventos que corresponderem ao nome do evento único e às expressões de filtro de parâmetro vai corresponder a esse filtro de evento.

SegmentFilterExpressionList

Uma lista de expressões de filtro de segmento.

Representação JSON 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Campos
expressions[]

object (SegmentFilterExpression)

A lista de expressões de filtro de segmento

SegmentFilter

Uma expressão para filtrar valores de dimensão ou métrica.

Representação JSON 
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

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

string

O nome da dimensão ou da métrica.
filterScoping

object (SegmentFilterScoping)

Especifica o escopo do filtro.
Campo de união one_filter. Especifique um tipo de filtro para Filter. one_filter pode ser apenas de um dos tipos a seguir:
stringFilter

object (StringFilter)

Filtro relacionado a strings.
inListFilter

object (InListFilter)

Um filtro para valores de lista.
numericFilter

object (NumericFilter)

Um filtro para valores numéricos ou de data.
betweenFilter

object (BetweenFilter)

Um filtro entre dois valores.

SegmentFilterScoping

Os escopos especificam como as dimensões e métricas de vários eventos devem ser consideradas ao avaliar um filtro de segmento.

Representação JSON 
{
  "atAnyPointInTime": boolean
}
Campos
atAnyPointInTime

boolean

Se atAnyPointInTime for verdadeiro, esse filtro será avaliado como verdadeiro para todos os eventos se for avaliado como verdadeiro para qualquer evento no período da solicitação.

Esse parâmetro atAnyPointInTime não estende o período de eventos no relatório. Se atAnyPointInTime for verdadeiro, apenas os eventos dentro do período do relatório serão considerados ao avaliar esse filtro.

Esse atAnyPointInTime só pode ser especificado se o escopo de critérios for ACROSS_ALL_SESSIONS e não puder ser especificado em sequências.

Se o escopo dos critérios for ACROSS_ALL_SESSIONS, atAnyPointInTime = false será usado se não for especificado.

SegmentEventFilter

Cria um filtro que corresponde a eventos de um único nome de evento. Se uma expressão de filtro de parâmetro for especificada, apenas o subconjunto de eventos que corresponderem ao nome do evento único e às expressões de filtro de parâmetro vai corresponder a esse filtro de evento.

Representação JSON 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Campos
eventName

string

Esse filtro corresponde a eventos com esse nome. O nome do evento é obrigatório.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Se especificado, esse filtro corresponde a eventos que correspondem ao nome de um único evento e às expressões de filtro de parâmetro.

Dentro da expressão do filtro de parâmetro, apenas os filtros de parâmetro estão disponíveis.

SegmentParameterFilterExpression

Expressa combinações de filtro de segmento em parâmetros.

Representação JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Campos
Campo de união expr. Especifique um tipo de filtro para SegmentParameterFilterExpression. expr pode ser apenas de um dos tipos a seguir:
andGroup

object (SegmentParameterFilterExpressionList)

A SegmentParameterFilterExpression em andGroup tem uma relação AND.
orGroup

object (SegmentParameterFilterExpressionList)

A SegmentParameterFilterExpression em orGroup tem uma relação OR.
notExpression

object (SegmentParameterFilterExpression)

A SegmentParameterFilterExpression NÃO é notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Um filtro de parâmetro de segmento primitivo.

SegmentParameterFilterExpressionList

Uma lista de expressões de filtro de parâmetro de segmento.

Representação JSON 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Campos
expressions[]

object (SegmentParameterFilterExpression)

A lista de expressões de filtro de parâmetro de segmento.

SegmentParameterFilter

Uma expressão para filtrar valores de parâmetro em um segmento.

Representação JSON 
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

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

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

object (SegmentParameterFilterScoping)

Especifica o escopo do filtro.
Campo de união one_parameter. O campo que está sendo filtrado. one_parameter pode ser apenas de um dos tipos a seguir:
eventParameterName

string

Esse filtro será avaliado no parâmetro de evento especificado. Os parâmetros de evento são registrados como parâmetros do evento. Os parâmetros de evento incluem campos como "firebase_screen" e "currency".

Os parâmetros de eventos só podem ser usados em segmentos e funis e em um filtro descendente de um EventFilter. Em um filtro descendente de um EventFilter, é preciso usar parâmetros de evento ou de item.
itemParameterName

string

Esse filtro será avaliado no parâmetro de item especificado. Os parâmetros do item são registrados como parâmetros na matriz de itens. Os parâmetros de item incluem campos como "item_name" e "item_category".

Os parâmetros de item só podem ser usados em segmentos e funis e em um filtro descendente de um EventFilter. Em um filtro descendente de um EventFilter, é preciso usar parâmetros de evento ou de item.

Os parâmetros de item estão disponíveis apenas em eventos de e-commerce. Para saber mais sobre os eventos de e-commerce, consulte o guia Medir o e-commerce.
Campo de união one_filter. Especifique um tipo de filtro. one_filter pode ser apenas de um dos tipos a seguir:
stringFilter

object (StringFilter)

Filtro relacionado a strings.
inListFilter

object (InListFilter)

Um filtro para valores de lista.
numericFilter

object (NumericFilter)

Um filtro para valores numéricos ou de data.
betweenFilter

object (BetweenFilter)

Um filtro entre dois valores.

SegmentParameterFilterScoping

Os escopos especificam como vários eventos devem ser considerados ao avaliar um filtro de parâmetro de segmento.

Representação JSON 
{
  "inAnyNDayPeriod": string
}
Campos
inAnyNDayPeriod

string (int64 format)

Acumula o parâmetro durante o período especificado de dias antes de aplicar o filtro. Somente compatível se o escopo de critérios for ACROSS_ALL_SESSIONS ou WITHIN_SAME_SESSION. Somente compatível se o parâmetro for event_count.

Por exemplo, se inAnyNDayPeriod for 3, o nome do evento for "purchase", o parâmetro do evento for "event_count" e os critérios do filtro forem maiores que 5, esse filtro vai acumular a contagem de eventos de compra em cada período de três dias consecutivos no período do relatório. Um usuário vai passar nos critérios do filtro para ser incluído nesse segmento se a contagem de eventos de compra for maior que 5 em qualquer período de três dias consecutivos. Por exemplo, os períodos de 2021-11-01 a 2021-11-03, 2021-11-02 a 2021-11-04, 2021-11-03 a 2021-11-05 e assim por diante serão considerados.

O período não é estendido para ter uma janela de N dias completa perto do início do período. Por exemplo, se um relatório for de 01/11/2021 a 10/11/2021 e inAnyNDayPeriod = 3, o período dos dois primeiros dias será encurtado porque nenhum dado de evento fora do período do relatório será lido. Por exemplo, os quatro primeiros períodos serão: 2021-11-01 a 2021-11-01, 2021-11-01 a 2021-11-02, 2021-11-01 a 2021-11-03 e 2021-11-02 a 2021-11-04.

inAnyNDayPeriod é opcional. Se não for especificado, o segmentParameterFilter será aplicado a cada evento individualmente.

UserSegmentSequenceGroup

Defina condições que precisam ocorrer em uma ordem específica para que o usuário seja membro do segmento.

Representação JSON 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Campos
sequenceScoping

enum (UserCriteriaScoping)

Todas as etapas da sequência precisam ser atendidas no escopo para que o usuário corresponda à sequência. Por exemplo, se sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, todas as etapas da sequência precisam ser concluídas em uma sessão para que o usuário corresponda à sequência. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT não tem suporte.

Opcional. Se não for especificado, conditionScoping = ACROSS_ALL_SESSIONS será usado.
sequenceMaximumDuration

string (Duration format)

Define o período em que toda a sequência precisa ocorrer, por exemplo, 30 minutos. sequenceMaximumDuration inclui o endpoint na granularidade de microssegundos. Por exemplo, uma sequência com uma duração máxima de 5 segundos pode ser concluída em 4,9 ou 5,0 segundos, mas não em 5 segundos e 1 microssegundo.

sequenceMaximumDuration é opcional, e, se não for especificado, as sequências poderão ser concluídas em qualquer período.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

Uma sequência ordenada de etapas de condição. Os eventos de um usuário precisam concluir cada etapa para que ele corresponda ao UserSegmentSequenceGroup.

UserSequenceStep

Uma condição que precisa ocorrer na ordem de etapas especificada para que o usuário corresponda à sequência.

Representação JSON 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campos
isDirectlyFollowedBy

boolean

Se verdadeiro, o evento que atende a essa etapa precisa ser o próximo evento após o evento que atende à última etapa. Se for "false", essa etapa segue indiretamente a anterior. Por exemplo, pode haver eventos entre a etapa anterior e essa etapa. isDirectlyFollowedBy precisa ser falso para a primeira etapa.
stepScoping

enum (UserCriteriaScoping)

Essa etapa da sequência precisa ser atendida no escopo para que o usuário corresponda à sequência. Por exemplo, se sequenceScoping = WITHIN_SAME_SESSION, as etapas da sequência precisam ser concluídas em uma sessão para que o usuário corresponda à sequência. stepScoping = ACROSS_ALL_SESSIONS só é permitido se o sequenceScoping = ACROSS_ALL_SESSIONS.

Opcional. Se não for especificado, stepScoping vai usar o mesmo UserCriteriaScoping que sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Um usuário corresponde a esta etapa da sequência se os eventos dele corresponderem a esta expressão. As expressões expressam critérios sobre dimensões, métricas e/ou parâmetros.

UserSegmentExclusion

Especifica quais usuários são excluídos neste segmento.

Representação JSON 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Campos
userExclusionDuration

enum (UserExclusionDuration)

Especifica por quanto tempo uma exclusão vai durar se um usuário corresponder ao userExclusionCriteria.

Opcional. Se não for especificado, o userExclusionDuration de USER_EXCLUSION_TEMPORARY será usado.
userExclusionCriteria

object (UserSegmentCriteria)

Se um usuário atender a essa condição, ele será excluído do segmento do userExclusionDuration.

UserExclusionDuration

Enumera as opções de duração de uma exclusão se um usuário corresponder ao userExclusionCriteria.

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED Duração da exclusão não especificada. Não especificar.
USER_EXCLUSION_TEMPORARY Excluir usuários temporariamente do segmento nos períodos em que eles atendem à condição userExclusionCriteria.
USER_EXCLUSION_PERMANENT Excluir usuários permanentemente do segmento se eles atenderem à condição userExclusionCriteria.

SessionSegment

Os segmentos de sessões são subconjuntos das sessões que ocorreram no seu site ou app, por exemplo, todas as originadas de uma determinada campanha publicitária.

Representação JSON 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Campos
sessionInclusionCriteria

object (SessionSegmentCriteria)

Define quais sessões são incluídas neste segmento. Opcional.
exclusion

object (SessionSegmentExclusion)

Define quais sessões são excluídas neste segmento. Opcional.

SessionSegmentCriteria

Uma sessão corresponde a um critério se os eventos dela atendem às condições do critério.

Representação JSON 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Campos
andConditionGroups[]

object (SessionSegmentConditionGroup)

Uma sessão atende a esse critério se ela corresponder a cada um desses andConditionGroups.

SessionSegmentConditionGroup

As condições informam ao Google Analytics quais dados incluir ou excluir do segmento.

Representação JSON 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campos
conditionScoping

enum (SessionCriteriaScoping)

Os dados são incluídos ou excluídos do segmento com base na correspondência com o grupo de condições. Esse escopo define quantos eventos o segmentFilterExpression é avaliado antes que o grupo de condições seja determinado como correspondente ou não. Por exemplo, se conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, a expressão é avaliada em todos os eventos de uma sessão e, em seguida, o grupo de condições é determinado como correspondente ou não para essa sessão. Por exemplo, se conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, a expressão é avaliada em um único evento e, em seguida, o grupo de condições é determinado como correspondente ou não para essa sessão.

Opcional. Se não for especificado, um conditionScoping de WITHIN_SAME_SESSION será usado.
segmentFilterExpression

object (SegmentFilterExpression)

Os dados são incluídos ou excluídos do segmento com base na correspondência com essa expressão. As expressões expressam critérios sobre dimensões, métricas e/ou parâmetros.

SessionCriteriaScoping

O escopo especifica quais eventos são considerados ao avaliar se uma sessão atende a um critério.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Escopo de critérios não especificado. Não especificar.
SESSION_CRITERIA_WITHIN_SAME_EVENT Se os critérios forem atendidos em um evento, a sessão vai corresponder aos critérios.
SESSION_CRITERIA_WITHIN_SAME_SESSION Se o critério for atendido em uma sessão, ela vai corresponder ao critério.

SessionSegmentExclusion

Especifica quais sessões são excluídas neste segmento.

Representação JSON 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Campos
sessionExclusionDuration

enum (SessionExclusionDuration)

Especifica por quanto tempo uma exclusão vai durar se uma sessão corresponder ao sessionExclusionCriteria.

Opcional. Se não for especificado, um sessionExclusionDuration de SESSION_EXCLUSION_TEMPORARY será usado.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Se uma sessão atender a essa condição, ela será excluída da participação no segmento do sessionExclusionDuration.

SessionExclusionDuration

Enumera as opções de duração de uma exclusão se uma sessão corresponder ao sessionExclusionCriteria.

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED Duração da exclusão não especificada. Não especificar.
SESSION_EXCLUSION_TEMPORARY Exclua temporariamente sessões do segmento durante os períodos em que a sessão atende à condição sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Excluir permanentemente sessões do segmento se elas atenderem à condição sessionExclusionCriteria.

EventSegment

Os segmentos de eventos são subconjuntos de eventos acionados no seu site ou app. Por exemplo, todos os eventos de compra registrados em um determinado local ou eventos "app_exception" que ocorreram em um sistema operacional específico.

Representação JSON 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Campos
eventInclusionCriteria

object (EventSegmentCriteria)

Define quais eventos são incluídos neste segmento. Opcional.
exclusion

object (EventSegmentExclusion)

Define quais eventos são excluídos neste segmento. Opcional.

EventSegmentCriteria

Um evento corresponde a um critério se atende às condições dele.

Representação JSON 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Campos
andConditionGroups[]

object (EventSegmentConditionGroup)

Um evento corresponde a esse critério se corresponder a cada um desses andConditionGroups.

EventSegmentConditionGroup

As condições informam ao Google Analytics quais dados incluir ou excluir do segmento.

Representação JSON 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campos
conditionScoping

enum (EventCriteriaScoping)

conditionScoping sempre precisa ser EVENT_CRITERIA_WITHIN_SAME_EVENT.

Opcional. Se não for especificado, um conditionScoping de EVENT_CRITERIA_WITHIN_SAME_EVENT será usado.
segmentFilterExpression

object (SegmentFilterExpression)

Os dados são incluídos ou excluídos do segmento com base na correspondência com essa expressão. As expressões expressam critérios sobre dimensões, métricas e/ou parâmetros.

EventCriteriaScoping

O escopo especifica quais eventos são considerados ao avaliar se um evento atende a um critério.

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED Escopo de critérios não especificado. Não especificar.
EVENT_CRITERIA_WITHIN_SAME_EVENT Se os critérios forem atendidos em um evento, ele vai corresponder aos critérios.

EventSegmentExclusion

Especifica quais eventos são excluídos neste segmento.

Representação JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Campos
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration sempre precisa ser PERMANENTLY_EXCLUDE.

Opcional. Se não for especificado, um eventExclusionDuration de EVENT_EXCLUSION_PERMANENT será usado.
eventExclusionCriteria

object (EventSegmentCriteria)

Se um evento atender a essa condição, ele será excluído da participação no segmento do eventExclusionDuration.

EventExclusionDuration

Enumera as opções de duração de uma exclusão se um evento corresponder ao eventExclusionCriteria.

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Duração da exclusão não especificada. Não especificar.
EVENT_EXCLUSION_PERMANENT Excluir permanentemente eventos do segmento se eles atenderem à condição eventExclusionCriteria.

FunnelSubReport

Os subrelatórios do funil contêm os valores de dados de dimensão e métrica. Por exemplo, 12 usuários alcançaram a segunda etapa do funil.

Representação JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Campos
dimensionHeaders[]

object (DimensionHeader)

Descreve as colunas de dimensão. Os relatórios de funil sempre incluem a dimensão "Etapa do funil" nas respostas dos subrelatórios. Outras dimensões, como detalhamentos, datas e próximas ações, podem estar presentes na resposta, se solicitadas.
metricHeaders[]

object (MetricHeader)

Descreve as colunas de métricas. Os relatórios de funil sempre incluem usuários ativos nas respostas dos subrelatórios. A tabela de funil inclui outras métricas, como taxa de conclusão, desistências e taxa de desistências.
rows[]

object (Row)

Linhas de combinações de valores de dimensão e valores de métrica no relatório.
metadata

object (FunnelResponseMetadata)

Metadados do Relatório de funil.

FunnelResponseMetadata

Os metadados de resposta do relatório de funil contêm informações adicionais sobre ele.

Representação JSON 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Campos
samplingMetadatas[]

object (SamplingMetadata)

Se os resultados do relatório de funil forem amostrais, isso vai descrever qual porcentagem de eventos foi usada nesse relatório. Uma samplingMetadatas é preenchida para cada período. Cada samplingMetadatas corresponde a um período especificado na solicitação.

No entanto, se os resultados não forem amostrados, esse campo não será definido.