Sincronização parcial: como ler o log antes de o cliente achar um número furado
Nem toda falha de integração é um erro vermelho. Às vezes os dados principais entram e só uma conta fica de fora — e o relatório sai com um buraco silencioso. Como ler o log, identificar a causa e corrigir antes do envio.
Existe um tipo de erro de dados que não dá erro. A sincronização roda, a tela não fica vermelha, o painel abre normal — e o número de uma conta está menor do que deveria. Ninguém percebe no dia. Percebe no dia 5, quando o cliente compara com o Gerenciador e pergunta por que o investimento do relatório não bate com o que ele viu na própria conta.
Isso quase nunca é "a ferramenta errou a conta". É uma sincronização que terminou parcial: a maior parte dos dados entrou, uma parte não, e o relatório foi montado com o que havia. Se a sua integração não te conta isso de forma explícita, você está entregando relatório com buraco e descobrindo pela boca do cliente.
Vale conferir como a sua integração reporta cada execução. Em Conexões, por exemplo, uma execução pode terminar com status Parcial — os dados principais entraram, mas algo ficou de fora, e o log mostra exatamente o quê. É esse tipo de sinalização que transforma um problema invisível em uma tarefa de cinco minutos.
Por que uma sincronização fica pela metade
Uma integração de marketing não puxa "os dados". Ela faz dezenas de chamadas a APIs diferentes: contas de anúncio na Meta, campanhas no Google Ads, sessões e conversões no GA4, consultas no Search Console, publicações e métricas de perfil. Cada chamada pode falhar por conta própria, sem derrubar as outras.
As causas mais comuns, na prática:
Permissão removida em uma conta específica. O cliente fez uma limpeza de usuários no Gerenciador de Negócios e tirou um acesso "que ninguém usava". As outras cinco contas continuam funcionando.
Conta de anúncio desativada ou com pendência de pagamento. A API responde, mas não devolve métricas do período.
Limite de requisições atingido. Plataformas de anúncio e analytics têm cota por aplicativo e por conta. Em dia de muita sincronização, uma chamada volta vazia e precisa ser repetida depois.
Propriedade nova sem histórico. Um GA4 criado na semana passada não tem dado do mês inteiro — e isso não é erro, é ausência legítima.
Mudança de escopo no meio do caminho. A propriedade foi migrada, o site mudou de domínio no Search Console, a página foi vinculada a outro Business.
Atribuição em janela aberta. Conversões de ontem ainda vão mudar. Isso não é falha, mas aparece como diferença se você comparar números congelados.
Note que só as três primeiras são "problema". As outras são comportamento normal do dado — e confundir uma coisa com a outra faz a equipe correr atrás do que não precisa de correção.
A diferença entre dado faltando e dado que ainda vai mudar
Essa é a confusão mais caro de resolver no meio do mês.
Dado faltando é uma lacuna: a linha não existe, o investimento daquela conta aparece como zero ou o período fica truncado. Você resolve recuperando o acesso e reprocessando.
Dado que ainda vai mudar é diferente: o número existe, está correto para o momento em que foi lido, e vai subir nos próximos dias. Conversões atribuídas com janela de vários dias, leads que entram depois do clique, gasto que a plataforma ajusta por tráfego inválido — tudo isso faz o passado "se mover" um pouco.
É por isso que uma integração séria não lê o dado uma vez e arquiva. Em Conexões, cada sincronização reprocessa os últimos 28 dias — ou seja, o mês corrente é continuamente reescrito com a versão mais atual que a plataforma de origem tem a oferecer. Quem só busca "o dia de ontem" e nunca volta atrás carrega um erro acumulado que ninguém consegue explicar depois.
O teste rápido para distinguir os dois
Abra a conta de origem (Gerenciador de Anúncios, Google Ads, GA4) no mesmo período.
Se a origem mostra número e o seu painel mostra zero ou menos → é dado faltando.
Se a origem mostra um número ligeiramente diferente e maior, e o período é recente → é janela de atribuição.
Se a diferença está em um mês fechado há mais de 60 dias → é configuração: moeda, fuso, métrica diferente ou conta a mais/a menos na seleção.
Como ler um log de sincronização sem ser técnico
Você não precisa entender código. Precisa responder três perguntas na ordem.
1. O que ficou de fora? Não "deu erro", mas qual fonte, qual conta, qual período. Um log útil nomeia o objeto: "conta de anúncio X — sem permissão" é informação; "falha na requisição" não é.
2. Isso afeta o número que vai no relatório? Se faltou a métrica de alcance do perfil e o relatório daquele cliente é de leads pagos, a urgência é baixa. Se faltou o investimento de uma das três contas ativas, o relatório está errado agora.
3. Isso resolve sozinho ou precisa de uma ação minha? Limite de requisição se resolve na próxima execução. Permissão removida não se resolve nunca sem alguém pedir acesso de volta.
Com essas três respostas, a tarefa deixa de ser "investigar a integração" e passa a ser uma linha no checklist do dia: pedir acesso à conta X, ou esperar a próxima rodada.
Metade dos parciais nasce no dia em que você conectou
Um detalhe que passa batido: boa parte das sincronizações parciais vem de credenciais que enxergam coisas demais.
Quando você conecta usando um aplicativo compartilhado de terceiros, ou uma credencial que veio junto com o acesso amplo de um cliente, a integração tenta puxar tudo o que aquele acesso alcança — inclusive contas de anúncio arquivadas, propriedades de GA4 abandonadas e páginas de um cliente que saiu há dois anos. Cada uma dessas falha silenciosamente e enche o log de ruído. Quando um problema de verdade aparece, ninguém mais olha. É a fadiga de alerta aplicada à integração.
Duas decisões de configuração reduzem isso de forma permanente:
Credencial própria, em nome da agência. Na Meta, um usuário do sistema criado no seu Gerenciador de Negócios; no Google, uma conta de serviço e um acesso do seu próprio projeto. A credencial é sua — não depende do login de um funcionário nem de um app compartilhado com outras empresas. Em Conexões, essas credenciais são cifradas em AES-256 e ficam presas à agência, em modo somente leitura.
Seleção explícita do que entra. Depois de conectar, a tela lista tudo que a credencial enxerga — contas de anúncio, perfis, páginas, propriedades e sites — e só entra o que você marcar. Um log limpo é consequência de uma lista curta.
O ritual de cinco minutos antes de enviar o relatório
Não precisa de processo novo. Encaixe no que você já faz no fechamento:
Olhe o status da última sincronização de cada cliente do lote. Verde segue, parcial abre.
Para cada parcial, leia o objeto que ficou de fora e decida: afeta o número principal ou não.
Compare o investimento total com a origem. Investimento é a métrica mais fácil de conferir e a que o cliente mais checa.
Se faltou acesso, peça no mesmo dia — e registre quem pediu. Acesso perdido tem o hábito de voltar a se perder.
Se o dado é recente, escreva no relatório que o período está em janela aberta. Cliente avisado não reclama de número que subiu.
O objetivo não é ter zero sincronização parcial — nenhuma integração com seis fontes externas vive sem isso. O objetivo é que, quando acontecer, você saiba em dois minutos o que ficou de fora, se importa, e o que fazer. Isso é a diferença entre um relatório conferido e um relatório com sorte.
Se hoje você não consegue responder "qual conta ficou de fora na última rodada?", o problema não é o seu processo de conferência: é a integração que não te conta. Vale olhar como as Conexões funcionam, com credencial própria da agência, seleção do que entra e log que nomeia o que faltou.
