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

# Conectar o Google Ad Manager

> Dê à Stealth acesso para ler os relatórios das suas redes do Google Ad Manager, e veja o que esse acesso permite.

A Stealth não tem dados até você conectar uma conta Google com acesso às suas redes do Google Ad Manager. Esta página explica o que a Stealth pede ao Google, como conectar, como escolher as redes que a Stealth lê, o que aparece enquanto os dados carregam, como adicionar outra conta Google e como desconectar uma conta. Só o **Proprietário** ou um **Administrador** da organização pode conectar, adicionar ou desconectar uma conta.

## Como funciona

* A Stealth pede duas permissões ao Google: **Google Ad Manager** (`https://www.googleapis.com/auth/admanager`) e **e-mail** (o endereço da conta Google que faz a conexão).
* O Google descreve a primeira permissão como acesso ao Google Ad Manager em geral. A Stealth a usa só para listar as suas redes e gerar relatórios de desempenho. Ela nunca altera pedidos, line items, blocos, inventário ou configurações.
* Para ler os números, a Stealth cria relatórios salvos próprios em cada rede, com os nomes `stealth-monitor-hourly`, `stealth-monitor-daily`, `stealth-monitor-catalog` e `stealth-monitor-demand`.
* A Stealth lista todas as redes que a conta Google acessa, exceto as redes de teste, e lê só as redes que você escolher. Nada é lido antes de você confirmar a escolha.
* Numa rede com parceiros MCM (Multiple Customer Management), só a rede principal aparece na lista. Os parceiros são lidos por ela.
* Uma organização pode conectar mais de uma conta Google, por exemplo quando uma conta alcança algumas redes e outra conta alcança as demais. Veja [Adicionar outra conta Google](#adicionar-outra-conta-google).
* O acesso fica guardado com criptografia e só é usado quando a Stealth busca os relatórios.

## Passo a passo

**1. Confira o acesso à API no Google Ad Manager**

Em cada rede que você quer monitorar, abra **Administrador > Configurações globais > Configurações de rede** no Google Ad Manager e confira se o **Acesso à API** está ativado. Sem ele, a rede aparece como **Sem acesso nesta conta Google** na Stealth.

**2. Abra Integrações**

No menu da Stealth, abra **Integrações**. Encontre **Google Ad Manager** e escolha **Conectar**.

**3. Continue com o Google**

Leia o resumo do acesso e escolha **Continuar com Google**. Entre com a conta Google que tem acesso às suas redes e aceite as permissões.

**4. Escolha as redes**

A Stealth abre **Integrações > Google Ad Manager > Escolher redes**. Marque as redes que você quer monitorar e escolha **Monitorar N redes**. Veja [Escolher as redes](#escolher-as-redes).

**5. Acompanhe o carregamento**

A primeira verificação começa em até 5 minutos. Enquanto ela roda, o **Painel** mostra o progresso do carregamento. Cada rede passa então pelas etapas descritas em [As primeiras horas e dias](https://docs.usestealth.dev/pt-BR/getting-started/first-days.md).

> [!NOTE]
>
> Se você gerencia várias empresas que não podem ver os dados umas das outras, crie uma organização da Stealth para cada uma e conecte cada organização com a própria conta Google.

## O que você vê na tela

Em **Integrações**, a linha do Google Ad Manager mostra **Conectado**, uma linha para cada conta Google conectada e as ações:

* **Adicionar outra conta Google** conecta mais uma conta. Veja abaixo.
* **⋯ > Ver status** abre a **Central de Controle**, onde cada rede mostra a etapa em que está e o horário dos dados mais recentes.
* **⋯ > Escolher redes** abre a lista de todas as redes, para incluir ou tirar redes quando quiser.
* Cada linha de conta mostra o e-mail da conta e quantas redes ela lê. O menu **⋯** dela tem **Escolher redes** (só as redes dessa conta), **Reconectar** e **Desconectar**.
* Uma conta que o Google deixou de aceitar mostra **Acesso revogado** e o botão **Reconectar**.

> [!WARNING]
>
> Desconectar uma conta interrompe na hora o monitoramento das redes dela e remove do painel os clientes, os blocos e o histórico de incidentes dessas redes. Uma rede que outra conta conectada também alcança não é removida: a Stealth continua lendo a rede com essa outra conta. Ao conectar de novo, as redes removidas começam do zero.

### Escolher as redes

A lista mostra cada rede que a conta Google acessa, com nome, código, moeda e fuso horário.

* Quando a conta vê até 10 redes, todas já vêm marcadas. Acima de 10, nenhuma vem marcada, para a escolha ser feita com atenção.
* A partir de 8 redes, uma busca encontra a rede pelo nome ou pelo código, e **Selecionar todas** marca todas as redes da lista.
* As redes que a Stealth já monitora aparecem marcadas em **Já monitoradas**. Desmarcar uma faz a Stealth parar de lê-la. O histórico dela continua.
* Quando a lista mostra as redes de uma conta, as redes dessa conta que ela não vê mais aparecem em **Esta conta não acessa** e não podem ser marcadas.
* **Monitorar N redes** confirma a escolha. Uma rede que fica desmarcada não é lida e aparece em **Não monitoradas** na [Central de Controle](https://docs.usestealth.dev/pt-BR/screens/control-center.md).

### Enquanto os dados carregam

Até os primeiros dados chegarem, o **Painel**, **Clientes**, **Redes**, **Formatos** e **Incidentes** mostram o card **Carregando Seus Dados do GAM** no lugar dos dados:

* Quantas redes estão prontas do total, e o tempo desde que você confirmou a escolha.
* Quantos dos 28 dias de histórico já foram carregados.
* O tempo que falta, quando uma rede já carregou 2 dias de histórico. É uma estimativa pelo ritmo da própria rede, por isso aparece como "Cerca de 40 min restantes".
* **Conectar outra conta Google**, para adicionar uma conta que alcance mais redes, e **Ver detalhes**, que abre a **Central de Controle**.

Quando nenhuma rede foi escolhida ainda, essas telas mostram **Escolha as Redes a Monitorar**, com o botão **Escolher redes**.

O **Painel** abre com dados depois da primeira verificação da primeira rede: o tráfego de hoje e a receita de ontem. Uma faixa fina acima dele acompanha o histórico até os 28 dias carregarem. Você pode fechá-la até o fim da sessão.

Dois avisos chegam no sino para todos os membros: **Seu Painel está pronto**, quando a primeira rede termina a primeira verificação, e **Histórico completo**, quando não falta mais nada carregar. Os alertas ficam com a precisão completa quando os 28 dias de histórico estão carregados.

Se a primeira verificação de uma rede falha, a Stealth tenta de novo em 5 minutos, até 3 vezes, e depois na próxima verificação de hora em hora. Uma rede que a conta não consegue ler aparece como **Sem acesso nesta conta Google**, e as outras redes continuam carregando.

Desconectar uma conta também remove a permissão do lado do Google para essa conta Google. A permissão continua em dois casos: outra organização da Stealth ainda está conectada com a mesma conta Google, ou o Google não respondeu naquele momento. Para conferir, abra [myaccount.google.com/permissions](https://myaccount.google.com/permissions) com essa conta Google e remova a Stealth se ela ainda aparecer. Se você remover lá primeiro, as redes aparecem como **Conexão revogada** na **Central de Controle** e todos os membros são avisados.

## Adicionar outra conta Google

Use quando as suas redes estão divididas entre contas Google, ou quando outra conta tem acesso a redes que a primeira não vê. Nada é removido: as redes que você já monitora continuam como estão.

1. Em **Integrações**, escolha **Adicionar outra conta Google** na linha do Google Ad Manager.
2. No Google, escolha a outra conta e aceite as permissões.
3. Se a conta vê redes que a Stealth ainda não tem, a Stealth abre **Escolher redes** com as redes dessa conta. Marque as novas e confirme com **Monitorar N redes**. Elas carregam os últimos 28 dias de histórico, como numa primeira conexão.
4. Uma rede que as duas contas alcançam aparece uma vez só e é lida com uma das contas. Se essa conta perde o acesso à rede, ou é desconectada, a Stealth continua lendo a rede com a outra conta, sem buraco no histórico.

Para substituir uma conta, por exemplo quando a pessoa que a conectou vai sair da empresa, adicione a conta nova primeiro e depois desconecte a antiga. Entrar de novo com uma conta que já está conectada só renova o acesso dela.

## Perguntas frequentes

> [accordion] Qual conta Google devo usar?
>
> Uma que tenha acesso a todas as redes que você quer monitorar e que seja da empresa, não de uma pessoa que pode sair. A Stealth só lê com ela.

> [accordion] A Stealth pode alterar a minha configuração de anúncios?
>
> Não. A Stealth só lista redes e gera relatórios. Ela não tem nenhuma função que escreva no Google Ad Manager.

> [accordion] Posso escolher quais redes são monitoradas?
>
> Sim. A Stealth lê só as redes que você marca em **Integrações > Google Ad Manager > Escolher redes**, e você pode mudar essa lista quando quiser. Nas redes lidas, você liga ou desliga os alertas por rede e por cliente na [Central de Controle](https://docs.usestealth.dev/pt-BR/screens/control-center.md).

> [accordion] Por que uma rede aparece como Sem acesso nesta conta Google?
>
> A conta Google conectada não consegue ler essa rede: ou a conta não tem acesso a ela, ou o acesso à API está desativado na rede. Dê acesso à conta, ou ative o acesso à API no Google Ad Manager em **Admin > Configurações globais > Acesso à API**. A Stealth tenta de novo na próxima verificação de hora em hora.


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