Essas dimensões e métricas são suportadas nos Relatórios de funil da API Data do Google Analytics.
Dimensões
As dimensões a seguir podem ser solicitadas nos relatórios de funil de qualquer propriedade.
Especifique o "Nome da API" no campo name de um recurso
Dimension.
| Nome da API | Nome da interface | Disponível em segmentos | Descrição |
|---|---|---|---|
| achievementId | ID da conquista | Sim | O ID de conquistas em um jogo para um evento. Essa dimensão é preenchida pelo parâmetro de evento achievement_id. |
| adFormat | Formato do anúncio | Sim | Descreve a aparência dos anúncios e onde eles estavam localizados. Os formatos comuns incluem Interstitial, Banner, Rewarded e Native advanced. |
| adSourceName | Origem de anúncios | Não | Rede de origem que veiculou o anúncio. As origens típicas incluem AdMob Network, Liftoff, Facebook Audience Network e Mediated house ads. |
| adUnitName | Bloco de anúncios | Não | Nome que você escolheu para descrever este bloco de anúncios. Blocos de anúncios são contêineres que você inclui nos seus apps para mostrar anúncios aos usuários. |
| appVersion | Versão do app | Sim | O nome da versão (Android) ou versão abreviada do pacote (iOS) do aplicativo. |
| audienceId | ID do público-alvo | Não | O identificador numérico de um público-alvo. Os usuários são informados nos públicos-alvo a que pertenciam durante o período do relatório. O comportamento atual do usuário não afeta a participação do público-alvo histórico nos relatórios. |
| audienceName | Nome do público-alvo | Não | O nome de um público-alvo. Os usuários são informados nos públicos-alvo a que pertenciam durante o período do relatório. O comportamento atual do usuário não afeta a participação do público-alvo histórico nos relatórios. |
| brandingInterest | Meus interesses | Não | Interesses demonstrados por usuários que estão mais acima no funil de compra. Os usuários podem ser contabilizados em várias categorias de interesse. Por exemplo, Shoppers, Lifestyles & Hobbies/Pet Lovers ou Travel/Travel Buffs/Beachbound Travelers. |
| browser [navegador] | Navegador | Sim | Os navegadores usados para visualizar seu site. |
| campaignId | ID da campanha | Não | O identificador da campanha de marketing. usado apenas para eventos de conversão. |
| campaignName | Campanha | Não | Nome da campanha de marketing. usado apenas para eventos de conversão. |
| caractere | com caracteres | Sim | Personagem do jogador em um jogo de um evento. Essa dimensão é preenchida pelo parâmetro de evento character. |
| city | Cidade | Sim | A cidade em que a atividade do usuário teve origem. |
| cityId | ID da cidade | Sim | O ID geográfico da cidade de origem da atividade do usuário, derivado do endereço IP. |
| cohort | Coorte | Não | O nome da coorte na solicitação. Uma coorte é um conjunto de usuários que começaram a usar seu site ou app em qualquer grupo de dias consecutivo. Se um nome de coorte não for especificado na solicitação, elas serão nomeadas pelo índice de base zero delas, por exemplo: cohort_0, cohort_1. |
| cohortNthDay | Coorte diária | Não | Ajuste de dia em relação à firstSessionDate para os usuários na coorte. Por exemplo, se uma coorte for selecionada com as datas de início e término de 01/03/2020, para a data 02/03/2020, a coorte será 0001. |
| cohortNthMonth | Coorte mensal | Não | Ajuste de mês em relação à firstSessionDate para os usuários na coorte. Os limites dos meses se alinham aos limites dos meses. Por exemplo, se uma coorte for selecionada com as datas de início e término em março de 2020, o valor de "cohortNthMonth" será 0001 para qualquer data em abril de 2020. |
| cohortNthWeek | Coorte semanal | Não | Ajuste de semana em relação à firstSessionDate para os usuários na coorte. As semanas começam no domingo e terminam no sábado. Por exemplo, se uma coorte for selecionada com as datas de início e término no período de 2020-11-08 a 2020-11-14, para as datas no período de 2020-11-15 a 2020-11-21, a cohortNthWeek será 0001. |
| contentGroup | Grupo de conteúdo | Sim | Uma categoria que se aplica a itens de conteúdo publicado. Essa dimensão é preenchida pelo parâmetro de evento content_group. |
| contentId | Content ID | Sim | Identificador do conteúdo selecionado. Essa dimensão é preenchida pelo parâmetro de evento content_id. |
| contentType | Tipo de conteúdo | Sim | A categoria do conteúdo selecionado. Essa dimensão é preenchida pelo parâmetro de evento content_type. |
| country | País | Sim | O país em que a atividade do usuário teve origem. |
| countryId | ID do país | Sim | É o ID geográfico do país de origem da atividade do usuário, derivado do endereço IP. Formatado de acordo com o padrão ISO 3166-1 alfa-2. |
| date | Data | Sim | Data do evento no formato AAAAMMDD. |
| dateHour | Data e hora (AAAAMMDDHH) | Não | Os valores combinados de data e hora formatados como AAAAMMDDHH. |
| dateHourMinute | Data, hora e minuto | Não | Os valores combinados de data, hora e minuto formatados como AAAAMMDDHHMM. |
| dia | Day | Sim | Dia do mês composto por um número de dois dígitos (de 01 a 31). |
| dayOfWeek | Dia da semana | Sim | O dia da semana. Ela retorna valores no intervalo [0,6] com domingo como primeiro dia da semana. |
| defaultChannelGrouping | Agrupamento padrão de canais | Não | O agrupamento de canais padrão da conversão tem como base principalmente a origem e a mídia. Uma enumeração que inclui Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video e Display. |
| deviceCategory | Categoria do dispositivo | Sim | O tipo de dispositivo: computador, tablet ou smartphone. |
| deviceModel | Modelo do dispositivo | Sim | O modelo do dispositivo móvel (por exemplo: iPhone 10,6). |
| eventName | Nome do evento | Sim | O nome do evento. |
| fileExtension | Extensão de arquivo | Sim | A extensão do arquivo transferido por download (por exemplo, pdf ou txt). Preenchida automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento file_extension. |
| fileName | File name | Sim | O caminho da página do arquivo transferido por download (por exemplo, /menus/dinner-menu.pdf). Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento file_name. |
| firstSessionDate | Data da primeira sessão | Sim | A data em que ocorreu a primeira sessão do usuário, no formato AAAAMMDD. |
| firstUserCampaignId | ID da campanha do primeiro usuário | Não | Identificador da campanha de marketing que conquistou o usuário. Inclui campanhas do Google Ads. |
| firstUserCampaignName | Campanha do primeiro usuário | Sim | Nome da campanha de marketing que conquistou o usuário. Inclui campanhas manuais e do Google Ads. |
| firstUserDefaultChannelGrouping | Agrupamento padrão de canais do primeiro usuário | Sim | O agrupamento de canais padrão que conquistou o usuário. O agrupamento de canais padrão se baseia principalmente na origem e na mídia. Uma enumeração que inclui Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video e Display. |
| firstUserGoogleAdsAccountName | Nome da conta do Google Ads atribuída ao primeiro usuário | Não | O nome da conta do Google Ads que conquistou o usuário. |
| firstUserGoogleAdsAdGroupId | ID do grupo de anúncios do Google Ads atribuído ao primeiro usuário | Não | O ID do grupo de anúncios no Google Ads que conquistou o usuário. |
| firstUserGoogleAdsAdGroupName | Nome do grupo de anúncios do Google Ads atribuído ao primeiro usuário | Não | O nome do grupo de anúncios no Google Ads que conquistou o usuário. |
| firstUserGoogleAdsAdNetworkType | Tipo de rede de publicidade do Google Ads atribuída ao primeiro usuário | Sim | A rede de publicidade que conquistou o usuário. Uma enumeração que inclui Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social e (universal campaign). |
| firstUserGoogleAdsCampaignType | Tipo de campanha do Google Ads atribuído ao primeiro usuário | Não | O tipo da campanha do Google Ads que conquistou o usuário. Os tipos de campanha determinam onde os clientes veem seus anúncios, além das configurações e opções disponíveis no Google Ads. O tipo de campanha é uma enumeração que inclui: pesquisa, display, Shopping, vídeo, Discovery, app, inteligente, hotel, local e Performance Max. Para saber mais, consulte Escolher o tipo certo de campanha. |
| firstUserGoogleAdsCreativeId | ID do criativo do Google Ads do primeiro usuário | Não | O ID do criativo do Google Ads que conquistou o usuário pela primeira vez. Os IDs dos criativos identificam anúncios individuais. |
| firstUserGoogleAdsCustomerId | ID de cliente do Google Ads atribuído ao primeiro usuário | Não | O ID de cliente do Google Ads que conquistou o usuário. Os IDs de cliente no Google Ads identificam de forma exclusiva as contas do Google Ads. |
| firstUserGoogleAdsKeyword | Texto da palavra-chave do Google Ads atribuída ao primeiro usuário | Não | A palavra-chave correspondente que conquistou o usuário. Palavras-chave são palavras ou frases que descrevem seu produto ou serviço e que você escolhe para exibir seu anúncio aos clientes certos. Para saber mais sobre palavras-chave, consulte Palavras-chave: definição. |
| firstUserGoogleAdsQuery | Consulta do Google Ads atribuída ao primeiro usuário | Não | A consulta de pesquisa que conquistou o usuário pela primeira vez. |
| firstUserManualAdContent | Conteúdo do anúncio manual do primeiro usuário | Sim | O conteúdo do anúncio que conquistou o usuário. Essa dimensão é preenchida pelo parâmetro utm_content. |
| firstUserManualTerm | Termo manual do primeiro usuário | Sim | O termo que conquistou o usuário pela primeira vez. Essa dimensão é preenchida pelo parâmetro utm_term. |
| firstUserMedium | Mídia atribuída ao primeiro usuário | Sim | A mídia que conquistou o usuário pelo seu site ou app. |
| firstUserSource | Origem atribuída ao primeiro usuário | Sim | A origem que conquistou o usuário até seu site ou app. |
| firstUserSourceMedium | Origem do primeiro usuário/mídia | Não | Os valores combinados das dimensões firstUserSource e firstUserMedium. |
| firstUserSourcePlatform | Plataforma de origem do primeiro usuário | Não | A plataforma de origem que conquistou o usuário. Não dependa que esse campo retorne Manual para tráfego que usa UTMs. Esse campo será atualizado de Manual retornando para (not set) de retorno para o lançamento de um recurso futuro. |
| fullPageUrl | URL completo da página | Não | O nome do host, o caminho da página e a string de consulta das páginas da Web visitadas. Por exemplo, a parte fullPageUrl de https://www.example.com/store/contact-us?query_string=true é www.example.com/store/contact-us?query_string=true. |
| funnelStepName | Step | Não | O nome descritivo atribuído à etapa do funil. Por exemplo, especificar name = Purchase na terceira etapa do funil na solicitação produzirá 3. Purchase para essa dimensão funnelStepName na resposta do relatório de funil. |
| funnelStepNewVsContinuing | Nova x atual | Não | Um usuário está continuando nas etapas do funil se ele estava presente na etapa anterior do funil. Caso contrário, ele é um usuário novo. Essa dimensão só é significativa para funis abertos e retorna dois valores: new e continuing. |
| funnelStepNextAction | Próxima ação no funil | Não | A próxima ação é o próximo valor de dimensão alcançado pelo usuário após concluir a etapa atual, incluindo a conclusão da próxima. Por exemplo, se a dimensão da próxima ação solicitada for eventName, essa dimensão retornará o nome do próximo evento depois de atingir a i+1 etapa. A próxima ação é exclusiva do evento que atingiu a i+1'th etapa e inclui o evento que atingiu a i+1'th. |
| googleAdsAccountName | Nome da conta do Google Ads | Não | O nome da conta do Google Ads da campanha que levou ao evento de conversão. Corresponde a customer.descriptive_name na API Google Ads. |
| googleAdsAdGroupId | ID do grupo de anúncios do Google Ads | Não | O ID do grupo de anúncios atribuído ao evento de conversão. |
| googleAdsAdGroupName | Nome do grupo de anúncios do Google Ads | Não | O nome do grupo de anúncios atribuído ao evento de conversão. |
| googleAdsAdNetworkType | Tipo de rede de anúncios do Google Ads | Não | O tipo de rede de publicidade da conversão. Uma enumeração que inclui Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social e (universal campaign). |
| googleAdsCampaignType | Tipo de campanha do Google Ads | Não | O tipo de campanha do Google Ads atribuído ao evento de conversão. Os tipos de campanha determinam onde os clientes veem seus anúncios, além das configurações e opções disponíveis no Google Ads. O tipo de campanha é uma enumeração que inclui: pesquisa, display, Shopping, vídeo, Discovery, app, inteligente, hotel, local e Performance Max. Para saber mais, consulte Escolher o tipo certo de campanha. |
| googleAdsCreativeId | ID do criativo do Google Ads | Não | O ID do criativo do Google Ads atribuído ao evento de conversão. Os IDs dos criativos identificam anúncios individuais. |
| googleAdsCustomerId | ID de cliente do Google Ads | Não | O ID de cliente do Google Ads da campanha que levou ao evento de conversão. Os IDs de cliente no Google Ads identificam de forma exclusiva as contas do Google Ads. |
| googleAdsKeyword | Texto da palavra-chave do Google Ads | Não | Palavra-chave correspondente que levou ao evento de conversão. Palavras-chave são palavras ou frases que descrevem seu produto ou serviço e que você escolhe para exibir seu anúncio aos clientes certos. Para saber mais sobre palavras-chave, consulte Palavras-chave: definição. |
| googleAdsQuery | Consulta do Google Ads | Não | Consulta de pesquisa que levou ao evento de conversão. |
| groupId | ID do grupo | Sim | ID do grupo de jogadores em um jogo de um evento. Essa dimensão é preenchida pelo parâmetro de evento group_id. |
| hostName | Nome do host | Sim | Inclui os nomes de subdomínio e de domínio de um URL; por exemplo, o nome do host de www.example.com/contact.html é www.example.com. |
| hora | Hora | Sim | A hora do dia com dois dígitos em que o evento foi registrado. Essa dimensão varia de 0 a 23 e é informada no fuso horário da sua propriedade. |
| isConversionEvent | É um evento de conversão | Sim | String true se o evento for uma conversão. Os eventos são marcados como conversões no momento da coleta. As alterações na marcação de conversão de um evento serão aplicadas desse momento em diante. Você pode marcar qualquer evento como uma conversão no Google Analytics, e alguns deles (por exemplo, first_open, purchase) são marcados como conversões por padrão. Para saber mais, consulte o artigo Sobre as conversões. |
| itemAffiliation | Afiliação do item | Não | Nome ou código do afiliado (parceiro/fornecedor, se houver) associado a um item individual. Essa dimensão é preenchida pelo parâmetro do item affiliation. |
| itemBrand | Marca do item | Não | Nome da marca do item. |
| itemCategory | Categoria do item | Não | A categoria hierárquica em que o item é classificado. Por exemplo, em Vestuário/Masculino/Verão/Camisas/Camisetas, "Vestuário" é a categoria do item. |
| itemCategory2 | Categoria 2 do item | Não | A categoria hierárquica em que o item é classificado. Por exemplo, em Vestuário/Masculino/Verão/Camisas/Camisetas, "Masculino" é a categoria 2 do item. |
| itemCategory3 | Categoria 3 do item | Não | A categoria hierárquica em que o item é classificado. Por exemplo, em Vestuário/Masculino/Verão/Camisas/Camisetas, "Verão" é a categoria 3 do item. |
| itemCategory4 | Categoria 4 do item | Não | A categoria hierárquica em que o item é classificado. Por exemplo, em Vestuário/Masculino/Verão/Camisas/Camisetas, "Camisas" é a categoria 4 do item. |
| itemCategory5 | Categoria 5 do item | Não | A categoria hierárquica em que o item é classificado. Por exemplo, em Vestuário/Masculino/Verão/Camisas/Camisetas, "Camisetas" é a categoria 5 do item. |
| itemId | ID do item | Não | ID do item. |
| itemListId | ID da lista de itens | Não | ID da lista de itens. |
| itemListName | Nome da lista de itens | Não | Nome da lista de itens. |
| itemName | Nome do item | Não | Nome do item. |
| itemPromotionCreativeName | Nome do criativo da promoção do item | Não | Nome do criativo da promoção do item. |
| itemPromotionId | ID do item em promoção | Não | ID da promoção do item. |
| itemPromotionName | Nome da promoção do item | Não | Nome da promoção do item. |
| itemVariant | Variante do item | Não | A variação específica de um produto. Por exemplo, PP, P, M, G para o tamanho ou vermelho, azul, verde, preto para a cor. Essa dimensão é preenchida pelo parâmetro item_variant. |
| landingPage | Página de destino | Sim | Caminho da página + string de consulta associado à primeira visualização de página em uma sessão. |
| language | Idioma | Sim | A configuração de idioma do navegador ou dispositivo do usuário (por exemplo, inglês) |
| languageCode | Código do idioma | Sim | A configuração de idioma (ISO 639) do navegador ou dispositivo do usuário, por exemplo, en-us |
| level | Nível | Sim | A fase em que o jogador está em um jogo. Essa dimensão é preenchida pelo parâmetro de evento level. |
| linkClasses | Classes de links | Sim | O atributo de classe HTML de um link externo. Por exemplo, se um usuário clicar em um link <a class="center" href="www.youtube.com">, essa dimensão retornará center. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento link_classes. |
| linkDomain | Domínio do link | Sim | O domínio de destino do link externo. Por exemplo, se um usuário clicar em um link <a href="www.youtube.com">, essa dimensão retornará youtube.com. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento link_domain. |
| linkId | ID do link | Sim | O atributo de código HTML de um link externo ou download de arquivo. Por exemplo, se um usuário clicar em um link <a id="socialLinks" href="www.youtube.com">, essa dimensão retornará socialLinks. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento link_id. |
| linkText | Texto do link | Sim | O texto do link do download do arquivo. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento link_text. |
| linkUrl | URL do link | Sim | O URL completo de um link externo ou de download de um arquivo. Por exemplo, se um usuário clicar em um link <a href="https://www.youtube.com/results?search_query=analytics">, essa dimensão retornará https://www.youtube.com/results?search_query=analytics. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento link_url. |
| manualAdContent | Conteúdo do anúncio manual | Não | O conteúdo do anúncio atribuído ao evento de conversão. Essa dimensão é preenchida pelo parâmetro utm_content. |
| manualTerm | Termo manual | Não | Termo atribuído ao evento de conversão. Essa dimensão é preenchida pelo parâmetro utm_term. |
| medium | Média | Não | Mídia atribuída ao evento de conversão. |
| method | Método | Sim | Método que acionou um evento. Essa dimensão é preenchida pelo parâmetro de evento method. |
| minuto | Minuto | Não | O minuto com dois dígitos da hora em que o evento foi registrado. Essa dimensão varia de 0 a 59 e é informada no fuso horário da sua propriedade. |
| mobileDeviceBranding | Marca do dispositivo | Sim | Nome do fabricante ou da marca (exemplos: Samsung, HTC, Verizon, T-Mobile). |
| mobileDeviceMarketingName | Dispositivo | Sim | O nome do dispositivo da marca (exemplos: Galaxy S10 ou P30 Pro). |
| mobileDeviceModel | Modelo do dispositivo móvel | Sim | O nome do modelo do dispositivo móvel (exemplos: iPhone X ou SM-G950F). |
| mês | Mês | Sim | Mês do evento composto por um número inteiro de dois dígitos (de 01 a 12). |
| newVsReturning | Novo / recorrente | Sim | Os novos usuários têm 0 sessões anteriores, e os usuários recorrentes têm 1 ou mais sessões anteriores. Essa dimensão retorna dois valores: new ou returning. |
| nthDay | Número de dias | Não | Número de dias desde o início do período. |
| nthHour | Nª hora | Não | Número de horas desde o início do período. A hora de início é 0000. |
| nthMinute | No minuto | Não | Número de minutos desde o início do período. O minuto inicial é 0000. |
| nthMonth | Número de meses | Não | Número de meses desde o início de um período. O mês inicial é 0000. |
| nthWeek | Número de semanas | Não | Um número que representa o número de semanas desde o início de um período. |
| nthYear | Número de anos | Não | Número de anos desde o início do período. O ano de início é 0000. |
| operatingSystem | Sistema operacional | Sim | Os sistemas operacionais usados pelos visitantes do seu app ou site, Inclui sistemas operacionais para computadores e dispositivos móveis, como Windows e Android. |
| operatingSystemVersion | Versão do SO | Sim | As versões do sistema operacional usadas pelos visitantes do seu site ou app. Por exemplo, a versão do Android 10 é a 10 e a do iOS 13.5.1 é a 13.5.1. |
| operatingSystemWithVersion | Sistema operacional com a versão | Sim | Sistema operacional e versão. Por exemplo, Android 10 ou Windows 7. |
| orderCoupon | Cupom do pedido | Sim | O código do cupom no nível do pedido. |
| saída | Saída | Sim | Retornará true se o link do lead a um site não fizer parte do domínio da propriedade. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento outbound. |
| pageLocation | Local da página | Sim | O protocolo, o nome do host, o caminho da página e a string de consulta das páginas da Web visitadas. Por exemplo, a parte pageLocation de https://www.example.com/store/contact-us?query_string=true é https://www.example.com/store/contact-us?query_string=true. Essa dimensão é preenchida pelo parâmetro de evento page_location. |
| pagePath | Caminho da página | Não | A parte do URL entre o nome do host e a string de consulta das páginas da Web visitadas. Por exemplo, a parte "pagePath" de https://www.example.com/store/contact-us?query_string=true é /store/contact-us. |
| pagePathPlusQueryString | Caminho da página + string de consulta | Sim | A parte do URL após o nome do host das páginas da Web visitadas. Por exemplo, a parte pagePathPlusQueryString de https://www.example.com/store/contact-us?query_string=true é /store/contact-us?query_string=true. |
| pageReferrer | Referenciador da página | Sim | O URL de referência completo, incluindo o nome do host e o caminho. Esse URL de referência é o URL anterior do usuário e pode ser o domínio desse site ou outros domínios. Essa dimensão é preenchida pelo parâmetro de evento page_referrer. |
| pageTitle | Título da página | Sim | Os títulos das páginas da Web usados no seu site. |
| percentScrolled | Percentual de rolagem | Sim | Porcentagem da página que o usuário rolou para baixo (por exemplo, 90). Preenchida automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento percent_scrolled. |
| platform [plataforma] | Plataforma | Sim | A plataforma em que seu app ou site foi executado, por exemplo, Web, iOS ou Android. Para determinar o tipo de um stream em um relatório, use platform e streamId. |
| platformDeviceCategory | Categoria da plataforma / dispositivo | Sim | A plataforma e o tipo de dispositivo em que seu site ou app para dispositivos móveis foi executado. (exemplo: Android / dispositivo móvel) |
| região | Região | Sim | A região geográfica de origem da atividade do usuário, derivada do endereço IP. |
| screenResolution | Resolução da tela | Sim | A resolução de tela do monitor do usuário. Por exemplo, 1920 x 1080. |
| searchTerm | Termo de pesquisa | Sim | Termo pesquisado pelo usuário. Por exemplo, se o usuário visitar /some-page.html?q=some-term, essa dimensão retornará some-term. Preenchido automaticamente se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento search_term. |
| segmentar | Segmento | Não | Um segmento é um subconjunto de dados do Google Analytics. Por exemplo, de todo o conjunto de usuários, um segmento pode incluir pessoas de um determinado país ou cidade Para saber mais, consulte o Criador de segmentos. A dimensão do segmento retorna o nome atribuído ao segmento na solicitação com um prefixo baseado em 1 (ou seja, se o primeiro segmento tiver o nome Paid Traffic na solicitação, esse segmento será 1. Paid Traffic na resposta). Se os nomes dos segmentos não forem especificados na solicitação, os segmentos serão nomeados por nomes baseados em 1 (ou seja, 1. Segment, 2. Segment etc.). |
| sessionCampaignId | ID da campanha da sessão | Não | O ID da campanha de marketing de uma sessão. Inclui campanhas manuais e campanhas de vinculações de integração, como o Google Ads e o Search Ads 360. |
| sessionCampaignName | Campanha da sessão | Sim | O nome da campanha de marketing de uma sessão. Inclui campanhas manuais e campanhas de vinculações de integração, como o Google Ads e o Search Ads 360. |
| sessionDefaultChannelGrouping | Agrupamento de canais padrão da sessão | Sim | O agrupamento de canais padrão da sessão se baseia principalmente na origem e na mídia. Uma enumeração que inclui Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video e Display. |
| sessionGoogleAdsAccountName | Nome da conta do Google Ads atribuída a essa sessão | Não | O nome da conta do Google Ads que levou à sessão. Corresponde a customer.descriptive_name na API Google Ads. |
| sessionGoogleAdsAdGroupId | ID do grupo de anúncios do Google Ads atribuído a essa sessão | Não | O ID do grupo de anúncios no Google Ads para uma sessão. |
| sessionGoogleAdsAdGroupName | Nome do grupo de anúncios do Google Ads atribuído a essa sessão | Não | O nome do grupo de anúncios no Google Ads para uma sessão. |
| sessionGoogleAdsAdNetworkType | Tipo de rede de publicidade do Google Ads atribuída a essa sessão | Sim | A rede de publicidade que levou à sessão. Uma enumeração que inclui Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social e (universal campaign). |
| sessionGoogleAdsCampaignType | Tipo de campanha do Google Ads da sessão | Não | O tipo de campanha do Google Ads que levou a essa sessão. Os tipos de campanha determinam onde os clientes veem seus anúncios, além das configurações e opções disponíveis no Google Ads. O tipo de campanha é uma enumeração que inclui: pesquisa, display, Shopping, vídeo, Discovery, app, inteligente, hotel, local e Performance Max. Para saber mais, consulte Escolher o tipo certo de campanha. |
| sessionGoogleAdsCreativeId | ID do criativo do Google Ads da sessão | Não | O ID do criativo do Google Ads que leva a uma sessão no seu site ou app. Os IDs do criativo identificam anúncios individuais. |
| sessionGoogleAdsCustomerId | ID de cliente do Google Ads da sessão | Não | O ID de cliente do Google Ads que levou à sessão. Os IDs de cliente no Google Ads identificam de forma exclusiva as contas do Google Ads. |
| sessionGoogleAdsKeyword | Texto da palavra-chave do Google Ads atribuída a essa sessão | Não | A palavra-chave correspondente que levou à sessão. Palavras-chave são palavras ou frases que descrevem seu produto ou serviço e que você escolhe para exibir seu anúncio aos clientes certos. Para saber mais sobre palavras-chave, consulte Palavras-chave: definição. |
| sessionGoogleAdsQuery | Consulta do Google Ads atribuída a essa sessão | Não | A consulta de pesquisa que levou à sessão. |
| sessionManualAdContent | Conteúdo do anúncio manual da sessão | Sim | O conteúdo do anúncio que levou a uma sessão. Essa dimensão é preenchida pelo parâmetro utm_content. |
| sessionManualTerm | Termo manual da sessão | Sim | Termo que levou a uma sessão. Essa dimensão é preenchida pelo parâmetro utm_term. |
| sessionMedium | Mídia da sessão | Sim | A mídia que iniciou uma sessão no seu site ou app. |
| sessionSa360AdGroupName | Nome do grupo de anúncios do SA360 da sessão | Não | O nome do grupo de anúncios do Search Ads 360 que levou a essa sessão. |
| sessionSa360CampaignName | Campanha do SA360 da sessão | Não | O nome da campanha do Search Ads 360 que levou a essa sessão. |
| sessionSa360CreativeFormat | Formato do criativo do SA360 da sessão | Não | O tipo de criativo no Search Ads 360 que levou a essa sessão. Por exemplo, Responsive search ad ou Expanded text ad. Para saber mais, consulte Dimensões de origem do tráfego do GA4. |
| sessionSa360EngineAccountId | ID da conta do mecanismo do SA360 da sessão | Não | O ID da conta de mecanismo no SA360 que levou a essa sessão. |
| sessionSa360EngineAccountName | Nome da conta de mecanismo do SA360 da sessão | Não | O nome da conta de mecanismo no SA360 que levou a essa sessão. |
| sessionSa360EngineAccountType | Tipo da conta de mecanismo do SA360 da sessão | Não | O tipo de conta de mecanismo no Search Ads 360 que levou a essa sessão. Por exemplo, google ads, bing ou baidu. |
| sessionSa360Keyword | Texto da palavra-chave do SA360 da sessão | Não | A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a essa sessão. |
| sessionSa360Medium | Mídia do SA360 da sessão | Não | A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a essa sessão. Por exemplo, cpc. |
| sessionSa360Query | Consulta do SA360 da sessão | Não | A consulta de pesquisa do Search Ads 360 que levou a essa sessão. |
| sessionSa360Source | Origem do SA360 da sessão | Não | A origem do tráfego do Search Ads 360 que levou a essa sessão. Por exemplo, example.com ou google. |
| sessionSource | Origem da sessão | Sim | A origem que iniciou uma sessão no seu site ou app. |
| sessionSourceMedium | Origem / mídia da sessão | Não | Os valores combinados das dimensões sessionSource e sessionMedium. |
| sessionSourcePlatform | Plataforma de origem da sessão | Não | A plataforma de origem da campanha da sessão. Não dependa que esse campo retorne Manual para tráfego que usa UTMs. Esse campo será atualizado de Manual retornando para (not set) de retorno para o lançamento de um recurso futuro. |
| shippingTier | Tipo de frete | Não | O tipo de frete (por exemplo, terrestre, aéreo ou do dia seguinte) selecionado para a entrega do item comprado. Essa dimensão é preenchida pelo parâmetro de evento shipping_tier. |
| signedInWithUserId | Conectado com o ID do usuário | Sim | A string yes se o usuário tiver feito login com o recurso User-ID. Para saber mais sobre o User-ID, consulte Medir a atividade em várias plataformas com o User-ID. |
| source | Fonte | Não | Origem atribuída ao evento de conversão. |
| sourceMedium | Origem / mídia | Não | Os valores combinados das dimensões source e medium. |
| sourcePlatform | Plataforma de origem | Não | A plataforma de origem da campanha do evento de conversão. Não dependa que esse campo retorne Manual para tráfego que usa UTMs. Esse campo será atualizado de Manual retornando para (not set) de retorno para o lançamento de um recurso futuro. |
| streamId | ID do stream | Sim | É o identificador numérico de fluxo de dados do seu app ou site. |
| streamName | Nome do fluxo | Sim | O nome do fluxo de dados do seu app ou site. |
| testDataFilterName | Nome do filtro de dados do teste | Não | Nome dos filtros de dados em estado de teste. Use filtros de dados para incluir ou excluir dados de eventos dos seus relatórios com base nos respectivos valores de parâmetro. Para saber mais, consulte Filtros de dados. |
| transactionId | ID da transação | Sim | ID da Transação de comércio eletrônico. |
| unifiedPagePathScreen | Caminho da página e classe da tela | Sim | O caminho da página (Web) ou a classe da tela (app) em que o evento foi registrado. |
| unifiedPageScreen | Caminho da página + string de consulta e classe da tela | Sim | O caminho da página e a string de consulta (Web) ou a classe da tela (app) em que o evento foi registrado. |
| unifiedScreenClass | Título da página e classe da tela | Sim | O título da página (Web) ou a classe da tela (app) em que o evento foi registrado. |
| unifiedScreenName | Título da página e nome da tela | Sim | O título da página (Web) ou o nome da tela (app) em que o evento foi registrado. |
| userAgeBracket | Idade | Sim | Faixas etárias dos usuários. |
| userGender | Gênero | Sim | Sexo do usuário. |
| videoProvider | Provedor de vídeo | Sim | A origem do vídeo (por exemplo, youtube). Preenchido automaticamente para vídeos incorporados se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento video_provider. |
| videoTitle | O título do vídeo. | Sim | É o título do vídeo. Preenchido automaticamente para vídeos incorporados se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento video_title. |
| videoUrl | URL do vídeo | Sim | O URL do vídeo. Preenchido automaticamente para vídeos incorporados se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento video_url. |
| virtualCurrencyName | Nome da moeda virtual | Sim | O nome da moeda virtual com a qual o usuário está interagindo. Por exemplo, gastar ou comprar pedras preciosas em um jogo. Essa dimensão é preenchida pelo parâmetro de evento virtual_currency_name. |
| visível | Visible | Sim | Retornará true se o conteúdo estiver visível. Preenchido automaticamente para vídeos incorporados se a medição otimizada estiver ativada. Essa dimensão é preenchida pelo parâmetro de evento visible. |
| semana | Semana | Sim | Semana do evento composta por um número de dois dígitos (de 01 a 53). Toda semana começa no domingo. 1o de janeiro é sempre na semana 1. Na primeira e na última semana do ano, eles têm menos de sete dias na maioria dos anos. As semanas, exceto a primeira e a última do ano, sempre têm sete dias. Para anos em que 1o de janeiro é um domingo, a primeira semana desse ano e a última semana do ano anterior têm sete dias. |
| year | Ano | Sim | O ano com quatro dígitos do evento, por exemplo, 2020. |
Dimensões personalizadas
A API Data pode criar relatórios sobre dimensões personalizadas no escopo do evento e do usuário. Consulte Relatórios de métricas e dimensões personalizadas no escopo do evento e Propriedades do usuário personalizadas para saber mais. As dimensões personalizadas são especificadas em uma solicitação de relatório da API pelo escopo e nome do parâmetro da dimensão. Por exemplo, inclua "customEvent:achievement_id" em uma solicitação da API Data para criar um relatório para a dimensão personalizada no escopo do evento com o nome de parâmetro "achievement_id". Essa solicitação de API falhará se a propriedade não tiver registrado essa dimensão personalizada no escopo do evento.
Se uma dimensão personalizada no escopo do evento tiver sido registrada antes de outubro de 2020, ela precisará ser especificada em uma solicitação de API com o nome do evento. Por exemplo, inclua "customEvent:achievement_id\[level_up\]" para a dimensão personalizada no escopo do evento com os nomes de parâmetro "achievement_id" e "level_up". Em outubro de 2020, o Google Analytics substituiu os relatórios de parâmetros personalizados pelos relatórios de métricas e dimensões personalizadas no escopo do evento.
Veja a seguir a sintaxe geral para dimensões personalizadas. É possível consultar o método da API de metadados para listar todas as dimensões personalizadas de uma propriedade. Veja um exemplo de uso do método da API de metadados.
| Nome genérico da API | Disponível em segmentos | Descrição |
|---|---|---|
| customEvent:parameter_name | Sim | Dimensão personalizada no escopo do evento para "parameter_name" |
| customEvent:parameter_name[event_name] | Sim | Dimensão personalizada no escopo do evento para "parameter_name", se registrado antes de outubro de 2020 |
| customUser:nome_do_parâmetro | Sim | Dimensão personalizada no escopo do usuário para "parameter_name" |
Grupos de canais personalizados
A API Data pode criar relatórios sobre grupos de canais personalizados. Para saber mais sobre esses grupos, consulte Grupos de canais personalizados no GA4. Os grupos de canais personalizados são especificados em uma solicitação de relatório da API pelo escopo da dimensão e pelo ID do grupo de canais. Por exemplo, inclua "sessionCustomChannelGroup:9432931" em uma solicitação da API Data para criar um relatório para o canal personalizado no escopo da sessão com o ID 9432931. Essa solicitação de API falhará se a propriedade não tiver um canal personalizado com esse ID.
Veja a seguir a sintaxe geral para grupos de canais personalizados. Consulte o método da API de metadados para listar todos os grupos de canais personalizados de uma propriedade.
| Nome genérico da API | Descrição |
|---|---|
| sessionCustomChannelGroup:custom_channel_id | O canal personalizado que leva a essa sessão. |
| firstUserCustomChannelGroup:custom_channel_id | O canal personalizado que conquistou esse usuário. |
| customChannelGroup:custom_channel_id | O canal personalizado que levou ao evento de conversão. |
Métricas
As métricas a seguir podem estar nos relatórios de funil de qualquer propriedade.
| Nome da API | Nome da interface | Descrição |
|---|---|---|
| activeUsers | Usuários ativos | Número de usuários únicos que acessaram seu site ou app. |
| funnelStepAbandonmentRate | Taxa de abandono | A porcentagem de usuários que abandonam o funil nessa etapa. Essa métrica é retornada como uma fração. Por exemplo, 0,412 significa que 41,2% dos usuários abandonaram o funil nessa etapa. |
| funnelStepAbandonments | Abandonos | O número absoluto de usuários que abandonam o funil nessa etapa. |
| funnelStepCompletionRate | Taxa de conclusão | A porcentagem de usuários que concluíram essa etapa do funil. Essa métrica é retornada como uma fração. Por exemplo, 0,588 significa que 58,8% dos usuários concluíram essa etapa do funil. |