Agência multi-tenant: mídia e CRM consolidados por cliente

Uma agência não gerencia um negócio, gerencia dezenas ao mesmo tempo. Cada cliente tem sua conta de Meta Ads, sua conta de Google Ads e o seu CRM, cada um num painel diferente, com nomes de campo diferentes e login separado. O gestor de tráfego abre dez abas para montar um relatório, o dado nunca bate entre plataformas, e no fim do mês ninguém consegue responder rápido "como foi a semana do cliente X". Este playbook mostra o padrão que a Nekt usa para transformar essa colcha de retalhos numa base única, multi-tenant, com mídia e CRM consolidados por cliente, que serve relatório, painel interno e agente de IA a partir do mesmo modelo.

1. Contexto: N clientes, o mesmo desafio repetido

O que define a operação de uma agência é a escala horizontal: o mesmo trabalho, replicado para muitos clientes. Cada cliente costuma ter a mesma tríade de fontes, Meta Ads, Google Ads e um CRM, mas isolados uns dos outros. O desafio tem duas faces que precisam ser resolvidas juntas.

• Visão por cliente sem virar caos. A agência precisa olhar cada cliente de forma consolidada (quanto investiu, quantos leads gerou, qual canal rendeu mais) sem manter um relatório artesanal por cliente que ninguém consegue manter quando a carteira cresce de dez para cinquenta contas.
• Multi-tenant de verdade. Os dados de cada cliente precisam ficar isolados. O cliente A nunca pode ver o número do cliente B, e um relatório do cliente A nunca pode misturar, por acidente, uma campanha do cliente C. Isolamento não é detalhe estético, é contrato e confiança.

A boa notícia é que, por ser o mesmo padrão repetido, a solução também é replicável: você modela uma vez, com o cliente como uma dimensão de primeira classe, e cada nova conta entra no mesmo modelo em vez de virar mais um relatório solto. É esse padrão que os próximos passos detalham.

2. Fontes típicas de uma agência

As fontes se repetem de cliente para cliente, com pequenas variações. Cada uma marcada com o cliente a que pertence.

• Meta Ads. Campanhas, conjuntos de anúncios, gasto (o campo costuma se chamar spend) e resultados (leads, mensagens, compras). É a fonte de mídia paga mais comum na carteira de uma agência.
• Google Ads. Custo (aqui o campo costuma se chamar cost, não spend), impressões, cliques e conversões. Fala a mesma história que o Meta, mas com nomes e unidades diferentes.
• CRM do cliente (ex: HubSpot, RD Station, Pipedrive). O que acontece depois do clique: leads que entraram, deals abertos, valor fechado. É o que conecta o investimento em mídia ao resultado real de negócio do cliente.
• Planilhas de metas (às vezes). Metas de investimento, de leads ou de faturamento definidas no contrato com o cliente. Entram como uma fonte a mais para comparar o realizado com o combinado.

3. Modelagem recomendada: consolidação multi-fonte na Gold

O objetivo é chegar a uma tabela central na camada Gold: o consolidado de mídia, com uma linha por cliente, canal e dia. As fontes cruas de cada cliente entram na Bronze, cada fonte é limpa e tipada separadamente na Silver, e a união padronizada de todas elas vive na Gold. É o padrão de consolidação multi-fonte, aplicado à realidade multi-tenant de uma agência.

A chave comum: cliente, canal e dia

Toda consolidação depende de encontrar a chave que junta fontes diferentes. Aqui ela é a combinação cliente + canal + dia. O cliente diz de quem é o dado (a dimensão multi-tenant), o canal diz de qual plataforma veio (Meta, Google, e por aí vai), e o dia dá o grão temporal. Com essa chave, uma campanha do Meta e uma do Google no mesmo dia, para o mesmo cliente, viram duas linhas comparáveis da mesma tabela, em vez de dois relatórios separados.

A padronização entre plataformas

Antes de empilhar as fontes, os campos precisam falar a mesma língua. O spend do Meta e o cost do Google viram uma coluna única investimento. Os leads de um e as conversions do outro viram leads ou conversoes, conforme a definição da agência. As datas, que cada plataforma entrega num formato, viram uma coluna data de verdade. Essa tradução é o coração da modelagem de agência: sem ela, você não consegue somar investimento total nem comparar canais.

4. Multi-tenant: isolar sem duplicar trabalho

Multi-tenant é servir muitos clientes a partir de uma base compartilhada, mantendo cada um isolado. Há dois caminhos, e eles não são exclusivos.

• Coluna de cliente em tudo (recomendado). Uma única modelagem, com a coluna cliente presente em todas as tabelas, da Bronze à Gold. O isolamento vem na hora do consumo: todo relatório, painel ou consulta filtra por cliente. Uma modelagem, muitos clientes, manutenção num lugar só.
• Naming ou prefixo por cliente. Separar por nome, por exemplo um conjunto de tabelas ou um prefixo por cliente (silva_consolidado, norte_consolidado). Dá isolamento físico mais forte, mas multiplica a manutenção: cada mudança de modelo precisa ser replicada em cada cliente. Faz sentido quando há exigência contratual de separação total, não como padrão.

Na prática, a maioria das agências vai bem com a coluna de cliente e disciplina de filtro no consumo. O prefixo por cliente fica reservado para casos que realmente exigem separação física.

5. Use case: relatório, painel e agente sobre o mesmo modelo

Com o consolidado na Gold, três consumos nascem em cima do mesmo modelo, cada um servindo um público diferente.

Relatório automático por cliente. Em vez do gestor montar dez relatórios à mão, cada cliente ganha o seu, gerado a partir da mesma tabela, filtrado pela coluna cliente. Investimento, leads, receita e retorno por canal, atualizados sozinhos. Adicionar um cliente novo é apontar o relatório para mais um valor de cliente, não construir do zero.

Painel interno da agência. A visão que o gestor da agência não tinha: todos os clientes lado a lado, quem está performando, quem está queimando verba sem retorno, qual canal rende mais na carteira inteira. É a visão de portfólio que só existe porque os dados estão num modelo único em vez de espalhados por painéis isolados.

Um agente de IA, via MCP, responde perguntas em linguagem natural sobre o mesmo consolidado: "qual campanha rendeu mais essa semana para o cliente X", "quanto o cliente Y investiu no Google esse mês", "qual canal tem o melhor custo por lead na Loja Silva". Quem precisa da resposta pergunta e recebe o número na hora, sem esperar um analista abrir dez abas.

O que faz o agente ser confiável é a Camada Semântica descrevendo o consolidado: o que é cada coluna, que investimento já une spend e cost, que toda consulta é sempre por cliente, o que cada canal significa. Sem essa descrição, a IA adivinha e, pior num contexto multi-tenant, pode misturar clientes. Com ela, a IA responde com as mesmas regras que o relatório e o painel usam, e os três batem.

6. Checklist de implementação

O caminho end-to-end, na ordem em que costuma fazer sentido. Cada passo se apoia no anterior, então vale seguir de cima para baixo.