Dimensões e métricas da API

Essas dimensões e métricas são compatíveis com os relatórios de funil da API Analytics Data.

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 código da realização 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. 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 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 consecutivos. Se o nome de uma coorte não for especificado na solicitação, elas serão nomeadas pelo índice baseado em zero, 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 a data de início e término 01/03/2020, para a data 02/03/2020, cohortNthDay será 0001.
cohortNthMonth Coorte mensal Não Deslocamento do mês em relação à firstSessionDate para os usuários na coorte. Os limites do mês se alinham aos do mês. Por exemplo, se uma coorte for selecionada com a data de início e término em março de 2020, para qualquer data em abril de 2020, cohortNthMonth será 0001.
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 a data de início e término no período de 2020-11-08 a 2020-11-14, então, para as datas no período 2020-11-15 a 2020-11-21, 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 O 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 é baseado 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.
deviceCategory Categoria do dispositivo Sim O tipo de dispositivo: computador, tablet ou smartphone.
deviceModel Modelo do dispositivo Sim O modelo do dispositivo móvel (exemplo: iPhone 10 ou 6).
eventName Nome do evento Sim O nome do evento.
fileExtension Extensão de arquivo Sim A extensão do arquivo transferido (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 da primeira sessão do usuário, formatada como AAAAMMDD.
firstUserCampaignId ID da campanha do primeiro usuário Não Identificador da campanha de marketing que conquistou o usuário pela primeira vez. Inclui as campanhas do Google Ads.
firstUserCampaignName Campanha do primeiro usuário Sim Nome da campanha de marketing que conquistou o usuário. Inclui o Google Ads e campanhas manuais.
firstUserDefaultChannelGrouping Agrupamento padrão de canais do primeiro usuário Sim O grupo de canais padrão que conquistou o usuário pela primeira vez. O agrupamento de canais padrã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.
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 pela primeira vez.
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 pela primeira vez.
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 pela primeira vez. 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 pela primeira vez. 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, para apps, 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 pela primeira vez. 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 pela primeira vez. Palavras-chave são palavras ou frases que descrevem seu produto ou serviço para os 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 pela primeira vez. Essa dimensão é preenchida pelo parâmetro utm_content.
firstUserManualTerm Termo manual do primeiro usuário Sim 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 para seu site ou app.
firstUserSource Origem atribuída ao primeiro usuário Sim A origem que conquistou o usuário para 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 pela primeira vez. Não dependa que esse campo retorne Manual para tráfego que usa UTMs. Esse campo vai ser atualizado de Manual para (not set) em um lançamento futuro de recurso.
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.
funnelStepNewVsContinuing Nova x atual Não Um usuário prossegue nas etapas do funil se estiver presente na etapa anterior. Caso contrário, esse 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 etapa. Por exemplo, se a dimensão solicitada da próxima ação for eventName, essa dimensão retornará o nome do próximo evento depois de atingir a i'a etapa. A ação seguinte é exclusiva do evento que atingiu a i'-ésima etapa e inclusive do evento que atingiu a etapa i+1.
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 da campanha do Google Ads atribuída 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, para apps, 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 para a 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 para os 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 A string true se o evento for uma conversão. Os eventos são marcados como conversões no momento da coleta. As mudanças na marcação de conversão de um evento serão aplicadas desse momento em diante. É possível marcar qualquer evento como uma conversão no Google Analytics, mas alguns deles, como first_open, purchase, são registrados dessa forma por padrão. Para saber mais, consulte o artigo Sobre as conversões.
itemAffiliation Afiliação do item Não É 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 associados à 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 para 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 ID 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 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 da marca do dispositivo (por exemplo, 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 não têm sessões anteriores, e os usuários recorrentes têm uma 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 Número que representa a quantidade 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 é 10 e a do iOS 13.5.1 é 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 para 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 tela que o usuário rolou para baixo (por exemplo, 90). Preenchido 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 fluxo 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 / 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: 1.920 x 1.080.
searchTerm Termo de pesquisa Sim Termo pesquisado pelo usuário. Por exemplo, se o usuário acessar /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 Criador de segmentos. A dimensão do segmento retorna o nome atribuído ao segmento na solicitação com um prefixo baseado em 1 (por exemplo, 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 com base em 1 (por exemplo, 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 Google Ads e 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 Google Ads e 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, para apps, 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 para os clientes certos. Para saber mais sobre palavras-chave, consulte [Palavras-chave: definição

](//support.google.com/google-ads/answer/6323). sessionGoogleAdsQuery | Consulta da sessão do Google Ads | Não | A consulta de pesquisa que levou à sessão. sessionManualAdContent | Conteúdo do anúncio manual da sessão | Sim | Conteúdo do anúncio que levou a uma sessão. Preenchido pelo parâmetro utm_content. sessionManualTerm | Termo manual da sessão | Sim | O termo que levou a uma sessão. Preenchido 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. sessionSa360GroupName | Nome do grupo de anúncios da sessão do SA360 | Não | O nome do grupo de anúncios do Search Ads 360 que levou a essa sessão. sessionSa360CampaignName | Formato da campanha do SA360 para esta sessão do criativo | Sessão do tipo de criativo SA360 | Sessão do Search Ads60 para este criativo do criativo. Por exemplo, Responsive search ad ou Expanded text ad. Para saber mais, consulte Dimensões da origem do tráfego do GA4. sessionSa360EngineAccountId | ID da conta de mecanismo do SA360 | Não | O ID da conta de mecanismo no SA360 que levou a essa sessão. sessionSa360EngineAccountName | Nome da conta de mecanismo da sessão | No | O nome da conta de mecanismo no SA360 do mecanismo no SA360 | Tipo da conta de mecanismo no SA360 que levou a essa sessão do mecanismo do SA360 | Tipo de mecanismo do SA360 que levou a essa sessão. Por exemplo, google ads, bing ou baidu. sessionSa360Keyword | Texto da palavra-chave da sessão do SA360 | Não | A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a esta sessão. sessionSa360Medium | Sessão da mídia do SA360 | Não | A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a esta sessão. Por exemplo: cpc. sessionSa360Query | Consulta da sessão do SA360 | Não | A consulta de pesquisa do Search Ads 360 que levou a esta sessão. sessionSa360Source | Origem da sessão do SA360 | Não | A origem do tráfego do Search Ads 360 que levou a esta 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 do retorno de Manual para o tráfego que usa UTMs. Ele será atualizado de Manual para (not set) para o lançamento de um recurso em breve. shippingTier | Nível de frete | Não | O tipo de frete (por exemplo, terrestre, aéreo, do dia seguinte) selecionado para a entrega do item comprado. Preenchido 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. Fonte | Origem | Não | A 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 desse campo que retorna Manual para tráfego que usa UTMs. Esse campo será atualizado de retornar Manual para retornar (not set) para o lançamento de um recurso futuro. streamId | ID do stream | Sim | O identificador de fluxo de dados numérico do seu app ou site. streamName | Nome do fluxo | Sim | O nome do fluxo de dados do app ou site. testDataFilterName | Nome do filtro de dados de teste | Não | 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 os filtros de dados. Simyoutube Essa dimensão é preenchida pelo parâmetro de evento video_provider. videoTitle | 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 de uma moeda virtual com a qual o usuário está interagindo. Por exemplo, gastar ou comprar pedras preciosas em um jogo. Preenchido pelo parâmetro de evento virtual_currency_name. visible | Visível | Sim | Retorna 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 | A semana do evento, um número de dois dígitos (de 01 a 53). Toda semana começa no domingo. 1o de janeiro é sempre na semana 01. A primeira e a última semana do ano têm menos de 7 dias na maioria dos anos. Além da primeira e da última semana do ano, as semanas sempre têm sete dias. Para anos em que 1o de janeiro é um domingo, a primeira semana do ano e a última semana do ano anterior têm sete dias. ano | 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 sobre elas. As dimensões personalizadas são especificadas em uma solicitação de relatório da API pelo nome e escopo do parâmetro da dimensão. Por exemplo, inclua "customEvent:achievement_id" em uma solicitação da API Data para criar um relatório da 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 foi registrada antes de outubro de 2020, ela precisa 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 o nome 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 com base no escopo do evento.

Confira a seguir a sintaxe geral das dimensões personalizadas. Você pode consultar o método da API de metadados para listar todas as dimensões personalizadas de uma propriedade. Este é um exemplo de uso do método da API de metadados.

Nome de API genérico 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 registrada 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 grupos de canais personalizados, 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 um ID 9432931. Essa solicitação de API falhará se a propriedade não tiver um canal personalizado com esse ID.

Confira a seguir a sintaxe geral dos grupos de canais personalizados. Consulte o método da API de metadados para listar todos os grupos de canais personalizados para uma propriedade.

Nome de API genérico 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 pela primeira vez.
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.