Philip Walton, engenheiro de programas para desenvolvedores do Google Analytics – março de 2014
Com o complemento de planilha do Google Analytics, os usuários do Google Analytics podem acessar, visualizar, compartilhar e manipular seus dados no Planilhas Google.
Introdução
O complemento de planilha do Google Analytics oferece a eficiência da Google Analytics API combinada à eficiência da manipulação de dados do Planilhas Google. Com ela, você pode:
- Consultar e gerar dados de relatórios de várias visualizações.
- Calcule e exiba cálculos personalizados.
- Crie visualizações e as incorpore em sites de terceiros.
- Programe a geração e a atualização automática dos relatórios.
- Controle quem pode ver seus dados e visualizações usando os recursos de compartilhamento e privacidade do Planilhas Google.
Tutoriais em vídeo
Os dois vídeos a seguir explicam como fazer o download e instalar o complemento, além de como criar um painel que é atualizado automaticamente e pode ser incorporado a um site de terceiros.
Apresentação do complemento de planilha do Google Analytics
Como criar um painel com o complemento de planilha do Google Analytics
Instalação do complemento
Para usar o complemento do Google Analytics, você precisa primeiro adicioná-lo à sua planilha. As instruções a seguir fornecem orientação detalhada sobre o processo:
- Crie uma nova Planilha Google (ou abra uma já existente).
- Na barra de menu, escolha: Complementos > Instalar complementos...
- Encontre o Complemento do Google Analytics na galeria de complementos e selecione-o.
- Na página de descrição do complemento, clique no "+", no canto superior direito, para adicionar esse complemento à sua planilha.
- Uma caixa de diálogo deve aparecer pedindo sua permissão para o complemento para acessar seus dados do Google Analytics. Clique em "Aceitar".
- O complemento está instalado. Um submenu "Google Analytics" deve aparecer no menu "Complementos".
Criação de relatórios
Os relatórios podem ser criados manualmente ou com a ajuda da Ferramenta de criação de relatórios do complemento. Para usar a ferramenta, selecione "Complementos" > "Google Analytics" > "Criar um novo relatório" na barra de menu. Isso exibe uma barra lateral à direita que lhe permite pesquisar facilmente as informações da sua conta do Google Analytics, bem como escolher quais dimensões e métricas consultar. Quando terminar, clique no botão "Criar relatório", e suas informações de relatório aparecerão em uma página chamada "Configuração do relatório". Se a página ainda não existir, ela será criada.
Para criar relatórios adicionais, basta repetir as etapas acima. Cada relatório adicional que você criar adiciona uma nova coluna de dados à direita do relatório anterior.
Se você observar os valores que a Ferramenta de criação de relatórios insere na página de configuração do relatório, perceberá que muitas das células são deixadas em branco. Isso é proposital. O objetivo da ferramenta é ajudar você a dar os primeiros passos e fornecer informações que talvez não saiba de cabeça. Os demais campos precisam ser preenchidos por você. Se tiver dúvidas sobre o que colocar em cada campo, consulte a referência, na parte inferior desta página.
Geração de relatórios
Para gerar todos os relatórios que você criou, selecione "Complementos" > "Google Analytics" > "Gerar relatórios" na barra de menu.
Exclusão de um relatório
Por padrão, o complemento gera todos os relatórios que têm um nome. Por isso, se você quiser ignorar temporariamente um relatório sem excluí-lo, poderá simplesmente remover todo o texto da célula que leva o valor do nome.
Escolha de uma página de saída
A geração dos relatórios resulta em uma solicitação para a Google Analytics API e registra os resultados em uma página de sua escolha. Ela pode ser uma página da planilha que você está utilizando atualmente ou uma de planilha diferente, desde que você tenha acesso para editá-la. Para registrar os resultados em uma planilha diferente, copie o URL da planilha e cole-o na célula à direita do parâmetro "spreadsheet-url".
Programação de relatórios para geração automática
Você pode ativar a geração automática dos seus relatórios selecionando "Complementos" > "Google Analytics" > "Programar relatórios" na barra de menu. Uma janela de programação de relatórios é exibida. Nela, você pode ativar ou desativar a programação e definir a frequência de geração do relatório.
Para ativar a programação, marque a caixa "Ativar geração automática de relatórios". Depois da ativação da programação, você pode usar a lista suspensa de seleção para controlar o tempo e a frequência. Os relatórios podem ser programados para geração a cada hora, dia, semana ou mês.
Para desativar a programação, desmarque a caixa "Ativar geração automática de relatórios".
Casos de uso comuns
Como consultar dados de várias visualizações
Por meio da interface da Web do Google Analytics, só é possível ver relatórios e dados de visualização de uma vista por vez. Com esse complemento, é possível gerar relatórios sobre qualquer número de visualizações e usar os dados gerados da maneira que você quiser. Por exemplo, se você tem uma vista da propriedade que acompanha seu tráfego do iOS e outra para acompanhar o tráfego do Android, é possível usar esse complemento para gerar relatórios de ambas as vistas da propriedade e comparar os resultados lado a lado facilmente, na mesma planilha.
Criação de cálculos personalizados com seus dados do Google Analytics
A Google Analytics API coleta muitos tipos diferentes de dados e oferece a você várias opções de como inserir esses dados em relatórios. No entanto, às vezes você precisa de um cálculo específico. Quando seus dados estão em uma Planilha Google, você pode aproveitar os recursos integrados de manipulação de dados da planilha.
Criação de painéis com visualizações de dados incorporados
Quando seus dados estão em uma Planilha Google, você pode aproveitar todas as ferramentas de visualização que o Google oferece prontamente. Além disso, os gráficos e diagramas do Planilhas Google podem ser incorporados em sites externos. Isso significa que você pode criar facilmente seus próprios painéis com visualizações dos seus dados do Google Analytics e hospedá-los onde quiser. Esses painéis serão atualizados automaticamente sempre que você gerar relatórios.
Controle fácil de quem pode ver seus dados do Google Analytics
O website do Google Analytics proporciona ótimas informações sobre seus dados em uma visão geral, mas às vezes você deseja compartilhar seus dados com as partes interessadas sem lhes conceder acesso à sua conta do Google Analytics.
Com o complemento de planilha do Google Analytics, você pode resolver esse problema facilmente, pois o Planilhas Google têm seu próprio sistema integrado de permissões. Tudo que você precisa fazer é criar uma nova planilha, conceder acesso a quem desejar e, depois, fazer com que seus relatórios registrem dados nessa planilha.
Atualização automática dos seus dados e visualizações
Depois de criar relatórios ou incorporar uma visualização a um site de terceiros, programe seus relatórios para geração automática para garantir que os dados estejam sempre atualizados.
Perguntas frequentes
Como posso saber quando será a próxima vez que meus relatórios programados serão gerados?
A primeira geração dos seus relatórios programados ocorre aleatoriamente durante o período que você especificou. As gerações subsequentes ocorrem previsivelmente no mesmo horário, após o intervalo que você escolheu. Por exemplo, se você programar seus relatórios para serem gerados diariamente entre 4h e 5h, e a primeira geração ocorrer às 4h12, todas as gerações subsequentes também serão às 4h12.
Meus relatórios programados não foram gerados quando deveriam. A programação não está funcionando?
Ao programar relatórios, verifique se há tempo suficiente entre o momento da criação da programação e a hora que o relatório deve ser geradocertifique-se há muito tempo entre o momento em que você criar o cronograma e quando a programação é suposto para ser executado. Se estiver muito perto da primeira ocorrência do horário programado, é possível que esses relatórios sejam adiados para a próxima ocorrência. É melhor deixar um buffer de pelo menos uma hora.
Posso definir programações diferentes para relatórios distintos?
A programação se aplica a todos os relatórios ou a nenhum relatório. Se você precisa programar relatórios diferentes em intervalos distintos, use várias planilhas.
Por que os dados do meu relatório estão no formato errado?
As APIs de relatórios do Google Analytics retornam todos os valores no formato dos EUA. Se a planilha estiver definida para uma localidade diferente, o Planilhas Google tentará fazer uma conversão para você, o que pode gerar resultados inesperados.
Para evitar esse problema, verifique se a localidade da planilha do relatório está definida como "Estados Unidos". Veja instruções para alterar a localidade da planilha na Ajuda dos Editores de arquivos Google. Para converter seus dados no formato da localidade de sua preferência, crie uma segunda planilha com a localidade de sua preferência e use a função
IMPORTRANGE para importar os dados do relatório para a nova planilha. O Planilhas Google converterá corretamente os formatos entre locais ao importar de uma planilha para outra.
Receber ajuda
Para fazer uma pergunta sobre o complemento ou informar um bug, poste uma mensagem no Grupo do Google google-analytics-spreadsheet-add-on. Pesquise o grupo antes de postar, porque sua pergunta pode já ter sido respondida.
Referência de parâmetro de configuração
As seções abaixo descrevem os parâmetros obrigatórios, opcionais e ocultos:
- Os parâmetros obrigatórios precisam estar presentes para cada relatório. Caso contrário, ocorrerá um erro.
- Parâmetros opcionais não são obrigatórios, mas podem ser especificados.
- Os parâmetros ocultos são opções avançadas que não são necessárias para a maioria dos relatórios e ficam ocultas por padrão. Você pode usar esses parâmetros reexibindo as linhas 14 a 16 na página "Configuração do relatório".
Parâmetros obrigatórios
| Nome | Descrição |
|---|---|
| Nome do relatório | É o nome do relatório. Também é o nome da página onde os dados de relatório são escritos. |
| Ver ID | O ID da sua vista do Google Analytics. Encontre esse valor usando a ferramenta de criação de relatórios ou acesse o administrador da conta do Google Analytics. |
| Data de início |
A data de início para buscar dados do Google Analytics. As solicitações podem especificar uma data de início no formato AAAA-MM-DD ou como uma data relativa (por exemplo, Também é possível usar as funções de data das Planilhas para especificar esse valor de maneira programática. Por exemplo, a seguinte expressão retorna o último dia do mês anterior: =EOMONTH(TODAY(), -1) |
| Data de término |
A data de término para buscar dados do Google Analytics. As solicitações podem especificar uma data de término no formato AAAA-MM-DD ou como uma data relativa (por exemplo, Também é possível usar as funções de data das Planilhas para especificar esse valor de maneira programática. Por exemplo, a seguinte expressão retorna o último dia do mês anterior: =EOMONTH(TODAY(), -1) |
| Métricas |
Uma lista de métricas para consulta. As métricas podem ser especificadas em um destes dois formatos:
Por exemplo, todos os valores a seguir são válidos para o parâmetro Metrics. ga:sessions,ga:bounces ga:sessions ga:bounces [{
"expression": "ga:sessions/ga:users",
"alias": "Sessions per User",
"formattingType": "FLOAT"
}, {
"expression": "ga:totalEvents/ga:pageviews",
"alias": "Events per Pageview",
"formattingType": "FLOAT"
}]
Na maioria dos casos de uso, uma lista de IDs de métricas é a maneira mais fácil de especificar o parâmetro de métricas. No entanto, se você quiser aproveitar os recursos avançados da API Reporting do Google Analytics, como as expressões de métrica no terceiro exemplo acima, especifique o valor como JSON. A lista completa de dimensões e métricas e as combinações válidas delas está disponível no Explorador de dimensões e métricas. |
Parâmetros opcionais
| Nome | Descrição |
|---|---|
| Dimensões |
Uma lista de dimensões para consulta. As dimensões podem ser especificadas em um destes dois formatos:
Por exemplo, todos os valores a seguir são válidos para o parâmetro Metrics. ga:source,ga:deviceCategory ga:source ga:deviceCategory [{
"name": "ga:source"
}, {
"name": "ga:deviceCategory"
}]
Para a maioria dos casos de uso, uma lista de IDs de dimensão é a maneira mais fácil de especificar o parâmetro de dimensões. A lista completa de dimensões e métricas e as combinações válidas delas está disponível no Explorador de dimensões e métricas. |
| Ordem |
A ordem de classificação dos resultados por coluna (ID de métrica ou dimensão) e direção (crescente ou decrescente). A ordem pode ser especificada em um de dois formatos:
Por exemplo, todos os valores a seguir são válidos para o parâmetro Order. -ga:sessions,ga:eventLabel -ga:sessions ga:eventLabel [{
"fieldName": "ga:sessions",
"sortOrder": "DESCENDING"
}, {
"fieldName": "ga:eventLabel",
"sortOrder": "ASCENDING",
"orderType": "DIMENSION_AS_INTEGER"
}]
Na maioria dos casos de uso, o formato legado é a maneira mais fácil de especificar o parâmetro "Order". No entanto, se você quiser usar o parâmetro |
| Filtros |
Condições que permitem restringir o conjunto de resultados retornados. Os filtros podem ser especificados em um destes dois formatos:
Por exemplo, qualquer um dos valores a seguir é válido para o parâmetro "Filters". ga:sessions>10;ga:country==United States {
"metricFilterClauses": [{
"filters": [
{
"metricName": "ga:totalEvents",
"operator": "GREATER_THAN",
"comparisonValue": "100"
}
]
}],
"dimensionFilterClauses": [{
"operator": "AND",
"filters": [
{
"dimensionName": "ga:eventCategory",
"operator": "EXACT",
"expressions": ["Outbound Link"]
}
],
"filters": [
{
"dimensionName": "ga:eventAction",
"operator": "EXACT",
"expressions": ["click"]
}
]
}]
}
Na maioria dos casos de uso, o formato legado é a maneira mais fácil de especificar o parâmetro "Filters". No entanto, se você precisar fazer uma filtragem avançada (por exemplo, usar operadores de comparação em dimensões), especifique o valor como JSON. |
| Segmentos |
Condições que permitem restringir o conjunto de sessões ou usuários aos quais a consulta se aplica. Os segmentos podem ser especificados em um destes dois formatos:
Por exemplo, qualquer um dos valores a seguir é válido para o parâmetro segments. gaid::-1,sessions::condition::ga:city==New York gaid::-1, sessions::condition::ga:city==New York [{
"dynamicSegment": {
"name": "New York Sessions",
"sessionSegment": {
"segmentFilters": [{
"simpleSegment": {
"orFiltersForSegment": [{
"segmentFilterClauses":[{
"dimensionFilter": {
"dimensionName": "ga:city",
"expressions": ["New York"]
}
}]
}]
}
}]
}
}
}, {
"dynamicSegment": {
"name": "Non-referral Sessions",
"sessionSegment": {
"segmentFilters": [{
"simpleSegment": {
"orFiltersForSegment": [{
"segmentFilterClauses": [{
"dimensionFilter": {
"dimensionName": "ga:medium",
"operator": "EXACT",
"expressions": [ "referral" ]
}
}]
}]
},
"not": "True"
}]
}
}
}]
Na maioria dos casos de uso, é mais fácil especificar IDs de segmento ou usar o formato de definição legado. No entanto, se você precisar fazer segmentação avançada (por exemplo, usar operadores de comparação em dimensões), especifique o valor como JSON. |
| Limite |
O número máximo de resultados que serão retornados para um relatório. Se esse parâmetro for deixado em branco, todos os resultados serão retornados. |
| URL da planilha | O URL de uma planilha externa para produzir o resultado. Por padrão, os resultados são enviados para uma página na planilha atual. É necessário ter permissões de edição na planilha para usar este recurso. |
| Pular relatório |
Quando Esse campo pode ser definido de maneira programática com uma fórmula. Por exemplo, a expressão a seguir ignorará o relatório se o valor da Data de término (célula "B5") estiver no passado: =IF(B5 < TODAY(), TRUE, FALSE) |
Parâmetros ocultos
| Nome | Resumo |
|---|---|
| Tipo de relatório |
Por padrão (ou quando deixado em branco), esse relatório consulta a API Reporting v4 do Google Analytics. Para consultar a API de relatórios de funis multicanal, defina o valor como "mcf". Ao usar a API MCF, você também precisa usar dimensões e métricas de MCF. Além disso, alguns dos outros recursos (por exemplo, segmentos) não estão disponíveis nos relatórios de MCF. |
| Nível de amostragem | O tamanho da amostra do relatório. Os valores possíveis são "DEFAULT" (o mesmo que deixá-lo em branco), "MENOR" ou "LARGE". |
| Usar cotas de recurso |
O sistema de cotas com base em recursos é novo e permite que determinadas contas do Google Analytics 360 tenham limites de amostragem mais altos ao usar a API Reporting do Google Analytics. Se você tiver acesso a esse recurso, ative-o definindo esse parâmetro como TRUE.
|
| Excluir linhas vazias |
Com esse parâmetro, é possível excluir linhas do relatório se todos os valores de métricas nelas forem zero. O comportamento padrão (ou, quando deixado em branco) é exibir todas as linhas (recomendado). Esse parâmetro corresponde ao parâmetro |