Anúncios

O Koda Ads liga seus anúncios do Google e da Meta aos contatos e às vendas registradas no Koda. Assim, você acompanha não apenas cliques e conversões informadas pela plataforma, mas também contatos identificados e vendas confirmadas no CRM.

O complemento precisa ser habilitado para a empresa. A verba de mídia continua sendo paga diretamente ao Google ou à Meta; ela não é descontada dos créditos de IA do Koda.

Administradores sempre veem Anúncios no menu lateral, em Cadastros e vendas. Quando o complemento ainda não estiver ativo, a entrada aparece como Adicionar e leva à tela que explica a disponibilidade no plano. Depois da ativação, usuários com a permissão adequada usam a mesma entrada para operar o módulo.

Depois de uma atualização do Koda, pode ser necessário atualizar o banco de dados do sistema antes de usar Anúncios. Nesse caso, a tela mostra uma orientação para o administrador executar Atualizar esquema no painel administrativo; não tente conectar contas até essa atualização terminar.

Conectar uma plataforma

1. Abra Anúncios → Configurar Anúncios.
2. Escolha Conectar em Google Ads ou Meta Ads.
3. Autorize o acesso na própria plataforma.
4. Escolha as contas que o Koda poderá acompanhar.
5. Use Sincronizar agora.

Apenas administradores gerenciam conexões e contas. Se a autorização expirar, a tela mostrará que é necessário reconectar. Ao desconectar, novas ações e novos envios param, mas o histórico permanece disponível conforme a retenção da empresa.

Empresas com configuração própria podem cadastrar seu aplicativo OAuth pela administração da integração. Segredos e tokens ficam criptografados e nunca aparecem na tela.

Em uma instalação gerenciada, Google Ads pode reutilizar o mesmo Client ID e Client Secret já usados no Google Calendar. Cadastre no mesmo cliente OAuth os dois retornos: /api/google-calendar/callback e /api/ads/oauth/google/callback. A instalação também pode definir credenciais exclusivas para Ads quando precisar separar os acessos.

Medir contatos e vendas

Crie um link rastreável para a campanha e use esse link no anúncio. Em páginas e formulários preparados para o Koda, a referência acompanha o visitante até o contato. Em links do WhatsApp, o Koda inclui uma referência na primeira mensagem; se a pessoa apagar essa referência antes de enviar, a conversa ficará como origem não identificada.

Para receber formulários diretamente, um administrador pode criar um endpoint público e informar os endereços dos sites autorizados. O Koda entrega um token somente no momento da criação; guarde-o na configuração do formulário. O endpoint confere origem, token, tamanho dos dados, limite de requisições e um campo oculto contra robôs. Desative o formulário para revogar novos envios sem apagar o histórico.

Quando uma venda vinculada ao contato é confirmada, o Koda usa o último contato pago identificável nos 30 dias anteriores. O histórico completo permanece guardado. Vendas canceladas não contam nos resultados.

O painel separa:

• investimento, impressões, cliques e conversões informadas pela plataforma;
• contatos atribuídos pelo Koda;
• vendas confirmadas e receita registradas no CRM.

Esses números podem ser diferentes porque Google, Meta e Koda usam dados e janelas de atribuição diferentes.

Pesquisar e preparar campanhas

Você pode usar produtos e serviços ativos do catálogo como temas e pesquisar notícias pelo GDELT a partir de termos escolhidos pela empresa. Cada sinal entra como hipótese com fonte e data e precisa ser revisado; ele nunca vira anúncio automaticamente. Em Configurar Anúncios, você pode desligar cada fonte.

Para contas Google elegíveis, o Koda consulta o planejador oficial de palavras-chave. Ele exige acesso Basic ou Standard ao Google Ads API; o nível Exploração não libera esse serviço. Sem esse acesso, o Koda informa a indisponibilidade e não inventa volume ou previsão. O Google Trends API ainda está em acesso alpha restrito; a página mostra como solicitar acesso, sem fingir que já coleta tendências.

Abra Novo rascunho na página Anúncios para preencher a campanha em uma janela. Os rascunhos guardam objetivo, público, termos ou segmentação, textos, mídia escolhida, orçamento e justificativas. A primeira publicação sempre depende de aprovação e nasce pausada nas plataformas. O Google Search exige palavras-chave, títulos, descrições e URL final. A Meta exige Página, público e uma mídia já fornecida pela empresa.

Geração de rascunhos com IA

Um administrador pode ativar Propostas de rascunho por IA em Configurar Anúncios, desde que a instalação tenha um provedor de IA. A IA recebe apenas o briefing informado e sinais aprovados. Ela sugere textos no modal; o usuário revisa e completa URL, orçamento e mídia antes de salvar. A proposta não comprova volume de buscas e nunca publica a campanha sozinha. A franquia de IA de Anúncios é separada dos demais créditos.

Automação com limites

A automação começa desligada. Em Configurar Anúncios, o administrador define contas e campanhas, moeda, meta, teto total e ações permitidas. A API empresarial também aceita aprovadores específicos.

O Koda confere essas regras novamente antes de cada alteração. A automação não pode aumentar o teto total. Somente a pausa de uma campanha elegível pode ser pré-aprovada pela política; retomadas e mudanças de orçamento, lance, público ou texto dependem de uma pessoa autorizada. Nova campanha, primeira publicação e aumento de teto também sempre exigem aprovação. Cada mudança registra o estado anterior, o novo estado, o motivo e eventuais falhas.

O envio de vendas qualificadas de volta ao Google ou à Meta também começa desligado. Ele só funciona depois que o administrador habilita a opção e informa a ação de conversão ou o conjunto de dados correto.

Como interpretar o resultado

Compare custo por contato atribuído e custo por venda em períodos equivalentes. Confira também se houve mudanças de orçamento, oferta, região ou atendimento. O relatório descreve limitações e dados ausentes. O Koda demonstra o efeito observado com os dados disponíveis; não garante retorno financeiro.

Relatório semanal e Telegram

O painel mostra a última semana completa em cards e gráfico diário de contatos e vendas atribuídos, além do gasto separado por moeda. Você pode pedir Analisar semana com IA; esse clique envia somente números agregados ao provedor configurado e consome um crédito de IA de Anúncios. Na segunda-feira, o resumo do proprietário no Telegram inclui os números de Anúncios se o módulo estiver ativo. Em Configurar Anúncios, o proprietário pode aceitar uma análise breve de IA no Telegram; a opção começa desligada. Sem consentimento, o Telegram envia apenas o resumo numérico. Receita atribuída não é lucro, e contatos sem origem rastreável ficam fora da atribuição.