Nesta página
Os canais
Cada canal aparece como um card, com o selo de status e o que a XBASE consegue fazer nele:
| Selo | O que quer dizer |
|---|---|
| Conectado | a conta está ligada e sincroniza |
| Erro | a plataforma recusou o acesso (senha trocada, permissão removida). Clique em Reconectar |
| Pendente | a autorização começou e não terminou. Clique em conectar de novo |
| Não conectado | pronto para conectar |
| Aguardando credenciais do app | a equipe da XBASE ainda está configurando as credenciais do app da plataforma, que todo canal novo precisa para conectar. Enquanto isso, importe o CSV |
As pílulas do card mostram a Leitura (verificada, quando foi provada numa conta real, ou teste) e a Escrita (liberada ou bloqueada). Hoje a escrita está liberada só no Meta Ads: nos outros canais a XBASE lê, compara e audita, e a mudança é feita no gerenciador da plataforma.
O YouTube Ads usa a conexão do Google Ads: as campanhas de Vídeo e Demand Gen da conta aparecem no card do YouTube, separadas das outras.
Como conectar
Dá para conectar de dois lugares, e é a mesma conexão:
- Anúncios → Canais, no menu lateral;
- Integrações, na seção Anúncios (o Meta Ads continua no card próprio, no topo da tela).
Para conectar:
- No card do canal, clique em Conectar (no YouTube, Conectar pelo Google Ads).
- Entre na conta da plataforma e autorize o acesso.
- Você volta para Anúncios → Canais com o aviso de canal conectado. O Meta Ads conectado pela tela Anúncios também volta para lá.
- Clique em Sincronizar no card para trazer os números agora. As contas aparecem em Contas de anúncios; no Meta Ads, elas aparecem depois da primeira sincronização. Depois, a XBASE sincroniza sozinha de hora em hora.
O Apple Search Ads não usa login: clique em Conectar com a chave da API e informe o ID da organização, o Client ID, o Team ID, o Key ID e a chave privada (PEM) que você gera na conta da Apple. A chave fica cifrada e não aparece de novo.
Se a XBASE ainda não estiver pronta para guardar as credenciais de um canal com segurança, a conexão não começa e a tela mostra o motivo.
Conectar, sincronizar e desconectar exige o cargo com Gerenciar integrações. Desconectar o Meta Ads exige ser administrador do workspace.
Contas e sincronização
- Em Contas de anúncios, a chave No sync decide quais contas entram na sincronização automática. No Meta, só a conta escolhida na conexão começa ligada.
- O Sincronizar do card traz só aquele canal. Se nenhuma conta do canal estiver no sync, o botão fica desligado e o card diz o que fazer. Sincronizar tudo, no topo da aba Canais, traz todas as contas ligadas.
- Se já houver uma sincronização do workspace em andamento, a XBASE avisa e não começa outra.
- A primeira sincronização traz os últimos 30 dias. Depois, a XBASE atualiza de hora em hora os números de ontem e de hoje e, quatro vezes por dia, refaz os últimos 7 dias, porque as plataformas atualizam conversões atrasadas.
- Cada conta mostra quando sincronizou pela última vez e o erro, se houve. Uma conta com erro não trava as outras.
- Desconectar para a sincronização do canal. O histórico já sincronizado continua na Visão geral e nas auditorias.
Importar CSV
Canal que ainda não tem a API liberada (ou que você prefere não conectar) pode entrar por CSV:
- No gerenciador da plataforma, exporte o relatório de campanhas com data, campanha, gasto, impressões, cliques e conversões.
- Em Anúncios → Canais, clique em Importar CSV, escolha o canal e o arquivo (até 10 MB e 50 mil linhas). Nome da conta, ID e moeda são opcionais.
- Os números entram na Visão geral e na Auditoria.
Arquivo maior que isso: exporte um período menor e importe em partes. Conta importada por CSV é só leitura: a auditoria pode sugerir mudanças, mas você as faz no gerenciador da plataforma.
Visão geral
A aba Visão geral mostra o que aconteceu com os seus anúncios no período e o que mudou em relação ao período anterior.
Período e comparação. Escolha Hoje, Ontem, 7 dias, 14 dias, 30 dias ou 90 dias. As datas seguem o horário de Brasília e os números de cada conta seguem o fuso e a moeda dela. Cada período é comparado com o anterior de mesmo tamanho: Hoje com ontem, 7 dias com os 7 dias antes deles. O período da comparação aparece logo abaixo dos botões.
Indicadores. Investimento, Leads (CRM), Custo por lead, Cliques, CTR e CPC, cada um com a variação contra o período anterior: verde quando melhorou (mais leads e cliques, CTR maior, custo por lead e CPC menores) e vermelho quando piorou. O investimento fica sem cor: gastar mais não é bom nem ruim por si só. Contas em moedas diferentes aparecem em blocos separados; os leads aparecem uma vez só, somados.
Leads do CRM e conversões da plataforma.
| Leads (CRM) | Conversões da plataforma | |
|---|---|---|
| Quem conta | a XBASE: cada conversa do CRM que chegou por um anúncio | cada plataforma, do seu jeito (janela de atribuição, modelo, o que vale como conversão) |
| Soma entre canais | sim | não |
| Onde aparece | indicadores, campanhas, por canal e por dia | campanhas e por canal, com CPA e ROAS da plataforma |
Somar conversões de plataformas diferentes daria um número que não existe: compare CPA e ROAS dentro de cada canal. Para comparar canais entre si, use os leads e o custo por lead. Conversas de anúncios de contas que não estão sincronizadas ficam fora do total, e a tela avisa quantas foram.
O que mudou. Uma lista curta com o que saiu do comum no período: campanha que trazia leads e quase parou, investimento sem nenhum lead, verba que mudou de campanha, CTR em queda, clique mais caro, gasto acima do orçamento, anúncios ativos sem entrega e o anúncio que mais trouxe leads. Cada item tem o selo Crítico, Atenção, Info ou Bom e, quando é de uma campanha, o botão Ver campanha, que abre a campanha na tabela abaixo. São só observações: nada muda nas contas. Sem nada fora do comum, a lista diz isso.
Campanhas. A tabela principal mostra cada campanha com o status (Ativa, Pausada ou Removida), o orçamento por dia, o investimento e os leads com a variação, o custo por lead, cliques, CTR, CPC e as conversões da plataforma. Clique no título de uma coluna para ordenar. Abra uma campanha para ver os conjuntos e, dentro de cada conjunto, os anúncios, com as mesmas colunas. Campanha ativa sem nenhum conjunto ativo ganha o aviso sem conjunto ativo: ela não consegue entregar (no Google Ads o aviso não aparece, porque a Performance Max não usa conjuntos). No celular, a tabela rola para o lado e o nome fica fixo à esquerda.
Rascunho a partir da tabela. Nas campanhas, conjuntos e anúncios de canal com escrita liberada (hoje, o Meta Ads), o botão ⋯ cria um rascunho para pausar, ativar ou mudar o orçamento diário. Você escreve o motivo, com pelo menos 10 caracteres, e, no orçamento, o valor novo. O rascunho vai para Aprovações: nada muda na conta até uma pessoa aprovar e aplicar.
Por canal e por dia. A tabela Por canal mostra investimento, leads, custo por lead, cliques e as conversões, o CPA e o ROAS da plataforma. O gráfico Investimento por dia mostra o gasto de cada dia; ao passar o mouse ou tocar numa barra, aparecem cada canal e os leads do dia.
Atualização. A XBASE atualiza os números de hora em hora. A linha Dados de diz quando foi a última atualização da conta mais atrasada e fica em amarelo quando alguma conta está há horas sem sincronizar. Quem tem Gerenciar integrações pode clicar em Atualizar agora: a tela acompanha a sincronização e recarrega os números quando ela termina. Se já houver uma sincronização em andamento, a XBASE avisa.
Quando o período tem linhas demais para mostrar, a tela avisa. Os totais continuam completos; para ver todos os dias no gráfico, escolha um período menor.
Criativos
A aba Criativos abre direto nos criativos. No topo fica uma só lista de contas de anúncios para todos os canais, agrupada por canal com o ícone de cada um. Escolha a conta e a tela mostra os criativos dela:
- Conta do Meta Ads: as sub-abas Desempenho, Indicadores, Ranking, Públicos e Gerenciador, com prévia, ranking, indicadores e o gerenciador de campanhas. Conectar, reconectar e desconectar o Meta Ads também ficam nessa lista.
- Conta de outro canal: os anúncios que chegaram pela sincronização ou pelo CSV, com investimento, impressões, cliques, CTR, conversões e CPA dos últimos 30 dias. Se ainda não há nenhum, a tela explica como trazer: conecte e sincronize o canal ou importe o CSV em Canais.
Cada criativo mostra os ícones dos canais:
| Ícone | O que quer dizer |
|---|---|
| Cheio | onde o criativo está publicado |
| Contornado e apagado | onde ele pode ser publicado, pelo formato e pela proporção |
Passando o mouse (ou com o leitor de tela) aparece o nome do canal. Vídeo vertical (9:16) pode ir para Reels e Stories do Instagram, Reels do Facebook, TikTok, YouTube Shorts e Pinterest; quadrado ou 4:5, para o Feed do Facebook e do Instagram, LinkedIn, Pinterest e X; vídeo horizontal (16:9), para YouTube, LinkedIn e X; carrossel, para Meta e LinkedIn. Quando a XBASE não consegue saber a proporção, aparece só onde o criativo já está publicado.
A tela guarda tudo no endereço: recarregar a página ou mandar o link para alguém abre a mesma conta, sub-aba, período, filtros e o criativo que estava aberto. O endereço antigo da tela Criativos continua funcionando e abre esta aba.
Segmentação e horário do conjunto (Meta)
Em Criativos → Gerenciador → Conjuntos de anúncios, cada conjunto tem o botão Segmentação e horário (ícone de ajustes). Ele abre um painel com o que está valendo agora na Meta:
| Parte | O que você escolhe |
|---|---|
| Dispositivos | Celular, Computador ou os dois |
| Sistema | Todos, iOS ou Android (vale para celulares) |
| Regiões | cidades, estados e países, pela busca com as abas Cidade, Estado e País. Cada cidade tem um raio de 10 a 80 km |
| Idade | mínima e máxima, de 18 a 65+ |
| Horários | Sempre ligado ou Só em horários: até 7 horários, cada um com os dias da semana, início e fim em hora cheia. Fim antes do início termina no dia seguinte (ex.: 22:00 às 02:00) |
Clique em Salvar na Meta. Só o que você mudou vai para a Meta, na hora, e a mudança fica registrada em Anúncios → Aprovações com quem fez. Mudar exige o cargo com Gerenciar integrações; sem ele, o painel é só leitura.
Como o horário funciona na Meta:
- Orçamento diário (o mais comum): a Meta não aceita programação de horários com orçamento diário, e o tipo de orçamento não muda depois que o conjunto é criado. A XBASE cria regras automáticas na sua conta da Meta que ligam o conjunto no início e desligam no fim de cada horário, no fuso da conta de anúncios. Elas aparecem na Meta com nomes que começam com
XB | Horário. Valem a partir do próximo horário de ligar ou desligar. Ao voltar para Sempre ligado, a XBASE apaga essas regras e religa o conjunto se ele estava desligado pela regra. - Orçamento vitalício: a XBASE usa a programação de horários da própria Meta.
Trocar as Regiões troca a lista inteira de locais do conjunto. Se o conjunto também tiver CEPs ou pontos no mapa, o painel avisa: eles saem quando você muda as regiões aqui. Públicos, posicionamentos e o resto da segmentação ficam como estão.
Os outros canais ainda não têm essa edição pela XBASE: faça no gerenciador da plataforma.
Auditoria
Na aba Auditoria, clique em Rodar auditoria. A XBASE lê os últimos 30 dias das contas ligadas e confere mensuração, estrutura, entrega, orçamento e criativos, com os controles do claude-ads, um método aberto de auditoria de anúncios. A auditoria só lê: nada muda nas contas.
O resultado tem:
- Nota de 0 a 100 por conta e do portfólio.
- Cobertura de evidência: quanto dos controles teve dados para avaliar.
| Classificação | Cobertura | O que quer dizer |
|---|---|---|
| Normal | 80% ou mais | a nota é confiável |
| Provisória | de 60% a 79% | a nota é uma indicação e pode mudar com mais dados |
| Evidência insuficiente | menos de 60% | sem nota: sincronize ou importe o CSV completo e rode de novo |
A nota do portfólio pesa cada conta pelo gasto no período. Quando as contas estão em moedas diferentes (ou sem moeda), ou o gasto não dá para comparar, cada conta pesa igual e a nota do portfólio fica Provisória, mesmo com cobertura completa. O que ficou fora da nota aparece em Observações sobre a nota.
Os achados de cada conta vêm em Problemas, Sem dados para avaliar, Em ordem e Não se aplica, cada um com o que foi visto e o que fazer. Quando o achado sugere uma mudança (por exemplo, pausar uma campanha que gastou sem converter), o botão Criar rascunho manda a sugestão para Aprovações. O botão só aparece em conta conectada pela API de um canal com escrita liberada; nos outros, a tela indica fazer a mudança no gerenciador da plataforma.
Aprovações
Toda mudança passa por três passos:
- Rascunho. Um agente de IA, alguém da equipe ou a auditoria sugere: pausar, ativar, mudar o orçamento diário ou renomear uma campanha, conjunto ou anúncio, ou mudar a segmentação e os horários de um conjunto. Só canal com escrita liberada aceita rascunho.
- Aprovação. Em Anúncios → Aprovações, uma pessoa com Gerenciar integrações vê o antes e o depois, o motivo e quem sugeriu, e clica em Aprovar ou Rejeitar. Rejeitar é definitivo. Agente de IA não aprova.
- Aplicação. Com a mudança aprovada, clique em Aplicar. A XBASE faz a mudança na plataforma; se a plataforma recusar, a mudança fica como Falhou, com o motivo.
Cada mudança mostra quem criou, quem aprovou ou rejeitou e quem aplicou, com a data. Nas mudanças de segmentação e horário, cada parte aparece com o antes e o depois (por exemplo, Dispositivos: Celular e computador → Só celular).
Regras:
- Aplicar só fica ativo em canal com escrita liberada. Nos outros, o botão aparece desligado e a mudança é feita no gerenciador da plataforma.
- O orçamento diário respeita o limite de variação de orçamento por mudança (padrão 50%), conferido já no rascunho. Para mudar mais, faça em etapas.
- Se a aplicação ficar sem resposta por mais de 15 minutos, a mudança passa para Falhou como interrompida. Confira no gerenciador da plataforma antes de tentar de novo.
- As mudanças não criam campanhas nem anúncios: só pausam, ativam, mudam o orçamento, renomeiam ou ajustam a segmentação e os horários do que já existe.
- O que você salva no painel Segmentação e horário já sai aplicado e aparece aqui como registro.
Agentes de IA e MCP
Os agentes de IA usam as mesmas regras pelo MCP da XBASE. As ferramentas de anúncios são:
| Ferramenta | O que faz |
|---|---|
ads_list_channels | lista os canais e o status de cada um |
ads_list_accounts | lista as contas de anúncios |
ads_get_performance | traz o desempenho e os leads do CRM por canal, conta, campanha, conjunto, anúncio ou dia, com comparação com o período anterior |
ads_get_insights | traz o "O que mudou" do período |
ads_list_entities | lista campanhas, conjuntos e anúncios com as métricas de 30 dias |
ads_get_entity_settings | mostra a segmentação e os horários atuais de um conjunto |
ads_search_locations | busca cidades, estados e países para a segmentação |
ads_run_audit e ads_get_audit | rodam e leem uma auditoria |
ads_get_playbook | traz o guia de auditoria e boas práticas de um canal |
ads_list_mutations | lista a fila de mudanças |
ads_draft_mutation | cria um rascunho de mudança, inclusive de segmentação e horários |
ads_apply_mutation | aplica uma mudança já aprovada por uma pessoa |
O agente lê, audita e só cria rascunhos. A aprovação é sempre de uma pessoa, em Anúncios → Aprovações.
Aplicar pelo MCP só vale para mudança já aprovada, quando quem criou o token tem Gerenciar integrações e quando o token foi criado listando a ferramenta ads_apply_mutation explicitamente. Token criado com todas as ferramentas não aplica mudanças.
Perguntas frequentes
Preciso conectar pela tela Anúncios ou pela tela Integrações?
Tanto faz. As duas usam a mesma conexão: o que você conecta numa aparece na outra.
Por que as conversões dos canais não aparecem somadas?
Cada plataforma conta conversão do seu jeito, com janelas e modelos de atribuição diferentes. Somar daria um número que não existe. Compare CPA e ROAS dentro de cada canal e, para comparar canais entre si, use os Leads (CRM), que a XBASE conta do mesmo jeito em todos.
O que conta como lead na Visão geral?
Uma conversa no CRM da XBASE que chegou por um anúncio de uma conta sincronizada, no dia em que a conversa começou. Como quem conta é a XBASE, os leads podem ser somados entre canais. Conversas de anúncios de contas que não estão sincronizadas ficam fora do total, e a tela avisa quantas foram.
De quanto em quanto tempo os números são atualizados?
De hora em hora. A Visão geral mostra quando foi a última atualização. Quem tem Gerenciar integrações pode clicar em Atualizar agora para sincronizar na hora.
O que significa Aguardando credenciais do app?
Todo canal novo precisa das credenciais do app da plataforma, que a equipe da XBASE configura. Enquanto isso, exporte o relatório de campanhas do gerenciador e use Importar CSV para ver os números e auditar.
Conectei o Meta Ads e não aparece nenhuma conta. E agora?
No Meta Ads, as contas aparecem depois da primeira sincronização. Clique em Sincronizar no card do Meta Ads, em Anúncios → Canais, e espere alguns minutos.
Um agente de IA pode mudar minhas campanhas sozinho?
Não. O agente só cria rascunhos. Uma pessoa com Gerenciar integrações precisa aprovar cada mudança em Anúncios → Aprovações antes de ela ser aplicada. Pelo MCP, só aplica o token criado listando a ferramenta ads_apply_mutation.
Por que a XBASE usa regras automáticas para os horários?
Porque a Meta só aceita programação de horários em conjuntos com orçamento vitalício, e o tipo de orçamento não muda depois de criado. Com orçamento diário, a XBASE cria regras automáticas na sua conta da Meta que ligam e desligam o conjunto nos horários escolhidos. Com orçamento vitalício, usa a programação da própria Meta.
Por que a auditoria ficou sem nota?
Menos de 60% dos controles tiveram dados para avaliar. Sincronize as contas ou importe o CSV completo do período e rode a auditoria de novo.
Por que a nota do portfólio é Provisória se a cobertura está alta?
Porque as contas estão em moedas diferentes (ou sem moeda) ou o gasto não dá para comparar. Aí cada conta pesa igual na nota, e ela fica provisória mesmo com cobertura completa.
Desconectar um canal apaga os dados?
Não. A sincronização para, mas o histórico já sincronizado continua na Visão geral e nas auditorias.
Onde fica a análise dos criativos do Meta?
Na aba Criativos da tela Anúncios. Escolha a conta do Meta Ads na lista do topo para ver prévia, ranking, indicadores, públicos e o gerenciador de campanhas.