# Google Analytics

Conectar Google Analytics à operação da sua empresa. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.

Source: https://zild.ai/pt-BR/docs/apps/zild-admin/connector-google-analytics

Conectar Google Analytics à operação da sua empresa.

## Onde configurar

Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.

## Credenciais da sua empresa

O cliente deve obter e configurar suas próprias chaves de API ou a forma de autenticação exigida por este conector. A assinatura Zild é definida pelo tamanho da empresa; o consumo dos serviços externos é cobrado pelo respectivo provedor, separado da assinatura. Não é necessário configurar conectores que sua operação não utiliza.

## Campos necessários

Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.



<table class="api-params"><thead><tr><th>Campo</th><th>Requisito para o fluxo</th></tr></thead><tbody><tr><td><code>ApiKey</code></td><td>Token de acesso emitido pelo provedor.</td></tr><tr><td><code>Url</code></td><td>URL HTTPS da API da sua instância, com o prefixo da versão exigida.</td></tr><tr><td><code>CustomProperties.PropertyId</code></td><td>ID numérico da propriedade GA4, não o Measurement ID G-....</td></tr></tbody></table>



## Como obter as credenciais

- Habilite a Google Analytics Data API no projeto Google Cloud. Autorize uma conta com acesso à propriedade GA4 e obtenha um access token OAuth com escopo analytics.readonly.
- Autorize a conta e os escopos necessários; conclua o fluxo OAuth documentado pelo provedor para obter o access token.
- Cole somente o access token em ApiKey e configure a URL da API indicada para sua conta. Não cole o client secret nem o refresh token nesse campo.

## Como funciona na Zild

Este conector recebe um access token já emitido. O cliente deve obter e renovar o token fora da Zild e substituí-lo ao expirar; não há renovação OAuth automática neste fluxo.

## Como conferir a configuração

Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.

Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.

## Documentação oficial

- [Google Analytics: API quickstart](https://developers.google.com/analytics/devguides/reporting/data/v1/quickstart)

[Voltar a Conectores](/pt-BR/docs/apps/zild-admin/integration)