> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectando o Google Analytics ao seu app

> Mostre dados de tráfego, engajamento e campanhas do Google Analytics nos painéis e relatórios do seu app, usando uma conta compartilhada ou a conta de cada pessoa.

Conecte seu app ao Google Analytics para mostrar tendências de tráfego, engajamento e resultados de campanhas em painéis e relatórios. Use uma conta do Google compartilhada para todo o seu app ou deixe cada pessoa conectar a própria conta.

***

## O que você pode fazer

Traga seus dados do Google Analytics para o seu app.

> [card] Mostrar tendências de tráfego
>
> Mostre visitas, principais páginas e origens de tráfego ao longo do tempo em um painel dentro do seu app.

> [card] Analisar o comportamento dos usuários
>
> Veja o engajamento e os funis de conversão para descobrir onde os visitantes desistem.

> [card] Criar relatórios regulares
>
> Gere relatórios semanais com dados de tráfego e engajamento para sua equipe.

> [card] Acompanhar campanhas
>
> Compare o desempenho das suas campanhas de marketing usando seus dados do Analytics.

**Prompts de exemplo**

No chat de IA, descreva a propriedade, as métricas a mostrar e o período. Por exemplo:

```text wrap theme={null}
Mostre as tendências de tráfego do meu site e as páginas com melhor desempenho.
```

```text wrap theme={null}
Crie um painel com as principais métricas de analytics.
```

```text wrap theme={null}
Analise o comportamento dos usuários e os funis de conversão no Analytics.
```

```text wrap theme={null}
Gere relatórios semanais com dados de tráfego e engajamento.
```

```text wrap theme={null}
Acompanhe o desempenho das campanhas de marketing usando dados do Analytics.
```

***

## Conectando o Google Analytics

Escolha como as pessoas se conectam: uma conta compartilhada para todo o seu app ou a conta de cada pessoa.

> [tab] Conector compartilhado
>
> Conecte uma conta do Google, e todos que usam seu app compartilham essa conta e os dados do Analytics dela.
>
> **Para adicionar um conector compartilhado do Google Analytics:**
>
> 1. Clique em **Conectores** na barra lateral do seu workspace.
>
> 2. Clique em **Adicionar conector**.
>
> 3. Pesquise **Google Analytics** e clique no resultado.
>
> 4. Selecione **Conector compartilhado** e clique em **Avançar**.
>
> 5. Insira um **Nome da conexão**.
>
> 6. Em **Quem pode acessar**, escolha **Apps e Super agent**, **Apenas apps** ou **Apenas Super agent**. **Apps e Super agent** vem selecionado por padrão.
>
> 7. Escolha os [escopos](#scopes-and-permissions) de que seu app precisa em **Permissões**:
>
>    * **Somente leitura:** Seu app pode ver seus dados e configurações do Analytics. Este é o padrão.
>    * **Leitura e escrita:** Seu app também pode alterar as configurações da sua conta e da sua propriedade do Analytics.
>    * **Personalizado:** Selecione as permissões opcionais de que seu app precisa. As permissões obrigatórias continuam selecionadas.
>
>    ![Configuração do conector compartilhado do Google Analytics com Connection name, Who can access e as permissões Read-only selecionadas](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-shared-setup.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=cd95db20bce0213e7874e1cb16c1eb6b)
>
>    Configurando um conector compartilhado do Google Analytics
>
> 8. Clique em **Adicionar conector**.
>
> 9. Entre com a conta do Google que tem acesso às suas propriedades do Analytics.

> [tab] Conector de usuário do app
>
> Cada pessoa conecta a própria conta do Google, para que seu app possa mostrar as propriedades do Analytics que ela pode acessar.
>
> > [!WARNING]
> >
> > Somente proprietários e admins do workspace podem configurar isso.
>
> > [!TIP]
> >
> > **Antes de configurar um conector de usuário do app:** Você precisa de um cliente OAuth do Google Cloud com o Client ID e o Client Secret dele. No mesmo projeto do Google Cloud, ative a Google Analytics Data API e também a Google Analytics Admin API, se seu app lista propriedades ou altera configurações. Veja [Usando seu próprio cliente OAuth](https://docs.base44.com/pt-BR/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Para adicionar um conector de usuário do app do Google Analytics:**
>
> 1. Clique em **Conectores** na barra lateral do seu workspace.
>
> 2. Clique em **Adicionar conector**.
>
> 3. Pesquise **Google Analytics** e clique no resultado.
>
> 4. Selecione **Conector de usuário do app** e clique em **Avançar**.
>
> 5. Copie a **URL de callback**.
>
> 6. No seu cliente OAuth do Google Cloud, adicione a URL de callback às redirect URIs autorizadas.
>
> 7. De volta ao formulário **Add Google Analytics Connection**, insira um **Nome do conector**.
>
> 8. Insira seu **ID do cliente**.
>
> 9. Insira seu **Segredo do cliente**.
>
> 10. Selecione os [escopos](#scopes-and-permissions) de que seu app precisa em **Escopos**.
>
>     ![Lista Scopes do Google Analytics com email bloqueado, e analytics readonly e analytics edit para escolher](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-app-user-scopes.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=7610bcb079782883d45daf160a69f252)
>
>     Escolhendo escopos para um conector de usuário do app
>
> 11. Clique em **Adicionar conector**.
>
> 12. Acesse o editor do seu app.
>
> 13. Peça ao chat de IA para adicionar uma forma de as pessoas conectarem a própria conta do Google Analytics.

***

## Escopos e permissões

Os escopos controlam o que seu app pode fazer no Google Analytics. Você os escolhe quando configura um conector.

> [card]
>
> **1. A Base44 adiciona**
>
> A Base44 sempre inclui este escopo. Você o vê bloqueado em **Personalizado** em um conector compartilhado, ou em **Escopos** em um conector de usuário do app.
>
> * `email`: Identificar a conta do Google que se conecta
>
> **2. Você configura**
>
> Escolha uma opção de permissão em um conector compartilhado, ou selecione escopos em um conector de usuário do app. Os nomes dos escopos do Google Analytics começam com `https://www.googleapis.com/auth/`:
>
> * `analytics.readonly`: Ver seus dados e configurações do Analytics
> * `analytics.edit`: Editar as configurações da sua conta e da sua propriedade do Analytics
>
> **Acesso:** Seu app vê as contas e propriedades do Analytics que a conta do Google conectada pode acessar.

***

## Usando funções de backend

Depois que o Google Analytics está conectado, suas funções de backend podem obter um token de acesso e chamar a Google Analytics Data API diretamente. A Base44 cuida do login e mantém o token atualizado para você.

* Em uma conexão compartilhada, use `getConnection()` para obter o token.
* Em uma conexão de usuário do app, use `getCurrentAppUserConnection()` para que cada requisição use o token da pessoa conectada.

Chame a Google Analytics Data API em `analyticsdata.googleapis.com` e passe o token no cabeçalho `Authorization`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("google_analytics");

const propertyId = "123456789"; // Your Google Analytics property ID

const response = await fetch(
  `https://analyticsdata.googleapis.com/v1beta/properties/${propertyId}:runReport`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
      dimensions: [{ name: "pagePath" }],
      metrics: [{ name: "screenPageViews" }],
    }),
  },
);
const report = await response.json();
```

> [card] [Conectores compartilhados](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/shared-connectors.md)
>
> Configure, implante e chame uma conexão compartilhada a partir de uma função de backend.

> [card] [Conectores de usuário do app](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/app-user-connectors.md)
>
> Obtenha um token por usuário e chame a API como a pessoa conectada.

***

## Solução de problemas

Verifique a conexão, a conta do Google e os escopos dela se o Google Analytics parar de funcionar no seu app.

> [accordion] A conexão precisa ser reconectada
>
> Se o acesso ao Google Analytics for perdido ou expirar, a conexão mostra uma seção **Reconectar esta conexão**. Em um conector compartilhado, [reconecte-o](https://docs.base44.com/pt-BR/Integrations/Connectors.md#managing-your-connectors) e entre com a mesma conta do Google. Todos os apps que o usam voltam a funcionar. Em um conector de usuário do app, cada pessoa reconecta a própria conta dentro do seu app.

> [accordion] Meus dados do Analytics não aparecem
>
> Confira se a conta do Google que você conectou tem acesso à propriedade que você quer e se seu app usa o ID dessa propriedade. Uma propriedade nova pode levar um tempo para coletar dados, então compare o mesmo período no Google Analytics.

> [accordion] Meu app não consegue alterar as configurações do Analytics
>
> Seu app precisa do escopo `analytics.edit` para alterar as configurações da conta e da propriedade.
>
> * Em um conector compartilhado, as permissões são definidas quando você adiciona a conexão. Clique em **Adicionar outro conector** na página do conector do Google Analytics e escolha **Leitura e escrita** para a nova conexão.
> * Em um conector de usuário do app, abra-o na página do conector do Google Analytics, adicione `analytics.edit` aos escopos dele e clique em **Salvar alterações**. As pessoas que já se conectaram mantêm o acesso anterior até se conectarem de novo.

> [accordion] Algumas pessoas não conseguem conectar a própria conta do Google
>
> Seu cliente OAuth começa no modo de teste, em que só usuários de teste aprovados podem se conectar. Antes de abrir o acesso para mais pessoas, mova seu app OAuth para produção e conclua qualquer verificação que o Google exigir.

> [accordion] A conexão falha com um erro de redirect URI
>
> Copie a **URL de callback** do formulário **Add Google Analytics Connection** e adicione-a exatamente igual às redirect URIs autorizadas do seu cliente OAuth do Google Cloud.

***

## Perguntas frequentes

> [accordion] Qual função do Google Analytics a conta precisa ter?
>
> Conecte uma conta do Google com pelo menos a função Viewer nas propriedades que você quer mostrar. Para permitir que seu app altere as configurações da conta ou da propriedade, a conta precisa da função Editor.

> [accordion] Meu app pode usar mais de uma propriedade?
>
> Sim. Se a conta do Google conectada tem acesso a várias propriedades, diga no chat de IA qual você quer, ou peça uma forma de alternar entre elas.

> [accordion] Posso usar o Google Analytics e o Google Search Console juntos?
>
> Sim. Adicione cada conector separadamente. Depois, peça ao chat de IA para combinar o tráfego do Google Analytics com o desempenho na pesquisa do [Google Search Console](https://docs.base44.com/pt-BR/Integrations/google-search-console-connector.md) em um único painel.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


## Related topics

- [Conectando o Google Maps ao seu app](https://docs.base44.com/pt-BR/Integrations/google-maps-connector.md)
- [Conectando o Google Search Console ao seu app](https://docs.base44.com/pt-BR/Integrations/google-search-console-connector.md)
- [Conectando um domínio ao seu app](https://docs.base44.com/pt-BR/Setting-up-your-app/Setting-up-your-custom-domain.md)
- [Conectando o Snowflake ao seu app](https://docs.base44.com/pt-BR/Integrations/snowflake-connector.md)
- [Conectando o Databricks ao seu app](https://docs.base44.com/pt-BR/Integrations/databricks-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.