Configurações — Contas de anúncios

Em Contas de anúncios você informa de quais contas vêm o investimento, as impressões, os cliques e os resultados que aparecem no Dashboard. Para a Meta, o Google Ads e o Google Analytics 4, você conecta a plataforma e o próprio CRM busca a mídia, sem token. Para as outras, e para as contas que a Datta já tinha cadastrado, a automação da Datta lê as contas de hora em hora e traz a mídia.

No topo da tela, um bloco em destaque, Conexões com as plataformas de mídia, lembra que essas conexões trazem o investimento e os dados das plataformas (Meta, Google, LinkedIn, TikTok e GA4) para o Dashboard.

Abaixo das conexões, a tela tem uma seção por plataforma, com o logotipo dela e o botão de informação Onde encontrar. Passe o mouse (ou toque) no botão para ver o passo a passo de onde achar o ID e o token dessa plataforma.

Plataforma	O que você informa	Token
Meta Ads	ID da conta de anúncios (`act_…`) e filtro de campanhas (opcional)	Sim, o token da conta
Google Ads	ID da conta, ID da MCC (obrigatório) e filtro de campanhas (opcional)	Não: usa o acesso da agência
Google Analytics 4	ID da propriedade	Não: usa o acesso da agência
LinkedIn Ads	ID da conta de anúncios	Não: usa o acesso da agência
TikTok Ads	ID do anunciante e filtro de campanhas (opcional)	Sim, o token do anunciante

A propriedade do Google Analytics 4 alimenta a aba Páginas do Dashboard.

Conectar a Meta ou o Google

A conexão é o jeito mais simples de trazer a mídia: você entra na plataforma com a sua conta, escolhe as contas e o CRM passa a buscar os números sozinho. Não precisa copiar ID, MCC nem token.

No topo da tela, o bloco Conexões tem os botões Conectar Meta e Conectar Google. Um botão só aparece quando a Datta já deixou aquela plataforma configurada no CRM. Se você não vê o botão, fale com a Datta.

Em Configurações › Contas de anúncios, no bloco Conexões, clique em Conectar Meta ou em Conectar Google.
Entre na plataforma e aceite o acesso de leitura. A Meta pede ler os anúncios e o Gerenciador de Negócios. O Google pede ler o Google Ads e o Google Analytics. O CRM só lê: não cria nem altera anúncios.
Ao voltar para o CRM, abre a janela Escolher contas. Marque as contas que o CRM vai acompanhar e clique em Adicionar contas. As que já estavam cadastradas aparecem como Já adicionada.

Se você desmarcar permissões na tela da plataforma, a conexão pode ser recusada:

Meta: sem a leitura dos anúncios, o CRM não grava a conexão e avisa “A Meta não liberou a leitura dos anúncios. Confira se você marcou as contas de anúncio e autorizou todas as permissões.” Conecte de novo, marque as contas de anúncio e aceite todas as permissões.
Google: sem o Google Ads e sem o Google Analytics, o CRM não grava a conexão e avisa. Se faltar só um dos dois, a conexão é feita e a janela mostra só o que foi liberado.

A janela mostra um grupo para cada tipo de conta que a conexão alcança:

Meta Ads: as contas de anúncios.
Google Ads: as contas de anúncios. As contas administradoras (MCC) não aparecem na lista; aparecem as contas de anúncios ativas que ficam abaixo delas, em qualquer nível (inclusive as que ficam sob uma MCC dentro de outra MCC).
Google Analytics 4: as propriedades. A propriedade alimenta a aba Páginas.

Se a conexão não alcança nenhuma conta, a janela avisa Esta conexão não alcança nenhuma conta. Dê à pessoa que conectou acesso às contas na própria plataforma e tente de novo.

Se uma plataforma não consegue listar as contas naquele momento, o grupo dela mostra um aviso no lugar da lista e os outros grupos continuam disponíveis. Por exemplo, “O Google Ads recusou a leitura das contas: o projeto do Google Cloud ainda não tem acesso de produção.” aparece enquanto o acesso do CRM à API do Google Ads não foi liberado; nesse caso, fale com a Datta. Para os outros avisos, como “Não deu para listar as contas do Google Ads agora.”, tente de novo mais tarde.

Cada conexão aparece na lista com o nome da conta conectada, o número de contas e a situação:

Situação	O que significa
Conectada	A coleta está funcionando.
Reconecte	A plataforma recusou o acesso (senha trocada, permissão retirada, acesso vencido) ou a conexão da Meta está para vencer. A coleta daquela conexão para até você reconectar.
Desconectada	Você desconectou. As contas continuam cadastradas, mas não atualizam.

Os botões de cada conexão dependem da situação:

Escolher contas (para marcar contas novas depois) só aparece com a conexão Conectada.
Reconectar aparece quando a conexão não está conectada e a plataforma está configurada no CRM. Fora do plano, as conexões desconectadas não aparecem.
Desconectar some depois de desconectada. Uma conexão desconectada que não tem nenhuma conta sai da lista.
Fora do plano, só Desconectar fica disponível.

Só entram contas da mesma moeda do CRM (as propriedades do GA4 não têm moeda e ficam de fora dessa regra). O seletor recusa uma conta em outra moeda e, se a moeda mudar depois, a conta mostra Erro na última coleta e, embaixo, o aviso “A conta de anúncios usa X e o CRM usa Y”.

Como a coleta funciona

As contas escolhidas por uma conexão são coletadas pelo CRM, no horário de São Paulo:

Ao conectar: o CRM carrega os últimos 90 dias. Enquanto isso, a conta mostra Carregando os últimos 90 dias.
Todo dia, a partir da 0h45: relê os últimos 7 dias na Meta, 30 dias no Google Ads e 7 dias no GA4, para pegar o que a plataforma ajustou depois.
De hora em hora: atualiza ontem e hoje.
À 0h e ao meio-dia: fotografa a estrutura de campanhas, conjuntos e anúncios (Meta e Google Ads), para o Desempenho saber o que está no ar.

Se a plataforma limitar as chamadas ou errar, o CRM espera cerca de 15 minutos e tenta de novo. O dia que já foi lido não se perde.

O estado de cada conta

Cada conta da lista mostra uma linha pequena com o estado da coleta:

Texto	O que significa
Atualizado às 14:05 (ou Atualizado em 08/11 às 14:05)	Quando a última coleta deu certo.
Carregando os últimos 90 dias	A primeira carga ainda está em andamento.
Limite da Meta, tenta de novo em cerca de 15 minutos (ou Limite do Google)	A plataforma limitou as chamadas. O CRM tenta sozinho.
Reconecte a conta	O acesso caiu. Clique em Reconectar na conexão. O CRM também manda o aviso Reconexão necessária em Notificações.
Fora do plano	O plano da conta não inclui o painel de anúncios. A coleta está parada e o que já chegou fica guardado.
Erro na última coleta	A plataforma recusou ou falhou. Se repetir por mais de um dia, fale com a Datta.
Coletada pela Datta	A conta é lida pela automação da Datta, não pela conexão. Não precisa de token nem de nada aqui.

Validade da conexão da Meta

A conexão da Meta vale cerca de 60 dias. Quando faltam menos de 7 dias, o CRM a renova sozinho, sem você fazer nada. Se a Meta não deixar renovar e faltarem menos de 3 dias, a conexão passa para Reconecte com o aviso “A conexão da Meta vence em breve. Reconecte.” Clique em Reconectar e entre na Meta de novo. A conexão do Google não vence: o CRM renova o acesso sozinho enquanto ele não for retirado no Google.

Desconectar

Desconectar apaga o acesso guardado no CRM. As contas continuam cadastradas e a mídia que já chegou continua no Dashboard, mas cada conta passa a mostrar Reconecte a conta (ou Fora do plano, se a conta não tiver o painel de anúncios) e para de atualizar até você reconectar. Desconectar fica disponível mesmo fora do plano.

No Google, o CRM também revoga o acesso do lado do Google, a menos que o mesmo login do Google ainda esteja conectado em outra conta do CRM: aí o acesso fica, para a coleta da outra conta continuar. Na Meta, para tirar o acesso do lado da plataforma, remova o app nas configurações da sua conta.

Planos e limites

O painel de anúncios é dos planos Pro, Max e Agência. Quando a conta sai desses planos, a coleta para (Fora do plano), os dados ficam guardados e a leitura pela API é recusada. Ao assinar um plano de novo, a coleta volta sozinha. A mídia não conta no limite de leads e de vendas.

Cadastrar uma conta à mão

Use este caminho para o LinkedIn Ads e o TikTok Ads, que não têm conexão, e quando você quiser cadastrar uma conta da Meta ou do Google sem conectar (nesse caso, a leitura é feita pela automação da Datta). As contas cadastradas à mão aparecem como Coletada pela Datta. Uma conta que já chega por uma conexão não pode ser cadastrada à mão de novo: o CRM recusa, para a mesma conta não ser lida duas vezes.

No rodapé do menu lateral, clique em Configurações e depois na aba Contas de anúncios.
Na seção da plataforma, clique em Adicionar.
Preencha os campos:
- Nome: como a conta aparece na lista (por exemplo, Conta principal).
- ID da conta: o número que a plataforma mostra (veja Onde achar cada ID). Traços e prefixos podem ficar; o CRM ajusta.
- Token de acesso (Meta e TikTok): veja Gerar o token.
- ID da MCC (Google Ads, obrigatório): a conta administradora vinculada a esta conta. Na conta nova ele já vem preenchido com a MCC da Datta, porque os clientes da Datta estão ligados a ela. A MCC precisa ter o acesso à API do Google Ads configurado, senão os dados não chegam.
- Filtro de campanhas (Meta, Google e TikTok, opcional): só entram as campanhas que têm esse trecho no nome. Em branco, entram todas.
Clique em Salvar. Na Meta e no TikTok, o CRM testa a conexão na hora e mostra o nome da conta, ou o que deu errado.

Depois de salvo, o token não aparece de novo: a lista mostra só Token salvo · termina em XXXX (os 4 últimos caracteres), para você saber qual token está em uso.

Acesso da agência (Google Ads, GA4 e LinkedIn)

Essas três plataformas não pedem token: a automação entra com o acesso da Datta, que já está configurado. Para a mídia de uma conta chegar, o usuário da Datta precisa ter acesso a ela na própria plataforma:

Google Ads: a conta do cliente vinculada à MCC da Datta. A MCC precisa ter o acesso à API do Google Ads configurado para os dados chegarem.
Google Analytics 4: o usuário da Datta com acesso de Leitor na propriedade.
LinkedIn Ads: o usuário da Datta com acesso de Visualizador na conta do Campaign Manager.

Essas seções mostram Acesso da agência e não têm o botão Testar conexão.

Onde achar cada ID

O botão Onde encontrar de cada seção mostra estes mesmos passos dentro da tela.

Meta Ads: no Gerenciador de Anúncios, o número da conta no seletor do topo (ou em Configurações do negócio › Contas de anúncios).
Google Ads: o ID da conta são os 10 dígitos que aparecem no topo do Google Ads, ao lado do nome da conta. A MCC é a conta administradora à qual a conta do cliente está vinculada; para clientes da Datta, é a MCC da Datta, que já vem preenchida. Não precisa de token aqui.
Google Analytics 4: em Administrador › Detalhes da propriedade, o número no canto superior direito (só números).
LinkedIn Ads: no Campaign Manager, o número ao lado do nome da conta de anúncios.
TikTok Ads: no TikTok Ads Manager, o Advertiser ID no menu da conta, no canto superior direito.

Ajuda oficial de cada plataforma

Cada seção da tela mostra a linha Ajuda da plataforma com estes links, que abrem em outra aba.

Meta Ads: Achar o ID da conta · Usuários do sistema · Explorador da Graph API
Google Ads: Achar o ID do cliente · Vincular à MCC · Acesso à API
Google Analytics 4: Achar o ID da propriedade · Dar acesso a um usuário
LinkedIn Ads: Achar o ID da conta · Adicionar um usuário
TikTok Ads: Achar o ID do anunciante

Gerar o token

Meta Ads

O campo aceita o token do usuário do sistema (Business Manager) ou um token da Graph API, com a permissão ads_read. Prefira o do usuário do sistema: não expira. O token do Explorador da Graph API também serve, mas expira, e a mídia para de chegar quando isso acontece.

Para gerar o do usuário do sistema, quem faz precisa ser administrador do Business Manager dono da conta de anúncios.

Abra o Business Manager e vá em Usuários › Usuários do sistema. Se ainda não houver um, clique em Adicionar e crie um com a função Admin.
Com o usuário do sistema selecionado, clique em Atribuir ativos, escolha Contas de anúncios, marque a conta e dê ao menos a permissão de ver desempenho. Salve.
Clique em Gerar novo token. Escolha o app, a validade Nunca e marque a permissão ads_read.
Copie o token gerado e cole no campo Token de acesso do CRM.

TikTok Ads

O token é o access token do app da Datta no TikTok for Business, autorizado para o anunciante. Cole-o no campo Token de acesso da seção TikTok Ads.

Testar a conexão (Meta e TikTok)

Abra a conta na lista e clique em Testar conexão. O CRM fala com a plataforma e mostra:

Conectada, com o nome da conta (e um aviso se a plataforma marcar a conta como desativada, em análise ou com pagamento pendente);
ou o erro, por exemplo Token inválido ou expirado, A conta de anúncios não existe ou o token não tem acesso a ela ou O token não tem a permissão ads_read para esta conta de anúncios.

A lista mostra o resultado do último teste em cada conta.

A mesma conta com filtros diferentes

Você pode cadastrar a mesma conta mais de uma vez na mesma plataforma, cada uma com um filtro de campanhas diferente. Por exemplo: uma entrada para todas as campanhas e outra só para as que têm BLACK26 no nome. Na Meta e no TikTok, ao adicionar a segunda, o token já salvo dessa conta vale para ela: deixe o campo Token de acesso em branco. Quando você substitui o token de uma delas, o novo vale para todas as entradas com o mesmo ID.

Substituir, pausar ou remover

Substituir o token: abra a conta, clique em Substituir ao lado do token, cole o novo e clique em Salvar. O novo token passa a valer também para as outras entradas com o mesmo ID, e o CRM testa a conexão na hora.
Pausar: desligue a chave Ativa no topo da janela e salve. A conta para de ser lida até você religar.
Remover: clique em Remover. A mídia dessa conta para de chegar na próxima rodada (e o token, se houver, é apagado). O que já chegou ao Dashboard continua. Remover funciona também fora do plano.

O ID da conta não muda depois de salvo. Para usar outra conta, remova esta e cadastre a nova.

Segurança

Os tokens (Meta e TikTok) ficam guardados cifrados dentro do CRM e nunca voltam para a tela nem para o navegador: depois de salvos, só os 4 últimos caracteres aparecem. Nem a equipe da conta consegue lê-los de volta. Eles não ficam mais em planilhas, no painel antigo nem na automação.
O teste de conexão é feito pelo servidor do CRM; o token não passa pelo seu navegador nessa hora.
Uma mesma conta de anúncios não pode estar cadastrada em duas contas do CRM. Se o CRM avisar Esta conta de anúncios já está cadastrada em outra conta do CRM, fale com a Datta.
Qualquer pessoa da conta pode cadastrar, substituir e remover contas (veja Acesso sem níveis).