RecursosPreçosBlogue

Plataforma de Inteligência de Tráfego

Produto

  • Recursos
  • Preços
  • Documentação

Empresa

  • Sobre
  • Blogue
  • Contato

Jurídico

  • Privacidade
  • Termos

© 2026 Magicgate. Todos os direitos reservados.

Produto10 de fevereiro de 20264 minutos de leitura

API Mode vs Direct Mode: Escolhendo a integração certa

Duas maneiras de integrar a filtragem de tráfego ao seu fluxo de trabalho. Descrevemos quando usar cada abordagem e as compensações envolvidas.

Ao configurar uma solução de filtragem de tráfego, uma das primeiras decisões que você tomará é como integrá-la ao seu fluxo de trabalho existente. A maioria das plataformas oferece duas abordagens: uma API que você chama a partir de seu próprio código ou um modo direto/redirecionado que trata tudo automaticamente. Cada um tem vantagens distintas.

API Mode: Controle total para desenvolvedores

API Mode funciona através de uma simples solicitação HTTP. Você envia uma solicitação POST com os atributos do visitante (endereço IP, agente do usuário, cabeçalhos, etc.) e recebe uma resposta JSON com o veredicto: “oferta” para tráfego legítimo ou “branco” para tráfego filtrado. A principal vantagem do API Mode é a flexibilidade. Você controla exatamente como o veredicto é usado: redireciona para páginas diferentes, fornece conteúdo diferente in-line, registra dados adicionais ou integra-se à sua lógica de back-end existente. API Mode é ideal para: - Páginas de destino personalizadas PHP, Node.js ou Python - Lógica de roteamento complexa com múltiplas variações de oferta - Integração com análises existentes ou plataformas de rastreamento - Renderização do lado do servidor onde você precisa do veredicto antes da geração da página

Direct Mode: Integração de código zero

Direct Mode elimina a necessidade de quaisquer alterações no código. Você aponta seu domínio para o serviço de filtragem, configura sua oferta e URLs de página em branco, e a plataforma cuida de tudo: avaliação de visitantes, decisões de roteamento e redirecionamento de tráfego. Direct Mode suporta vários métodos de roteamento: - Redirecionamento 302: o navegador do visitante é redirecionado para a oferta ou para o URL da página em branco. Simples e amplamente compatível. - Proxy reverso: o serviço de filtragem busca e veicula a oferta ou o conteúdo da página em branco em seu domínio. O visitante nunca vê o URL de destino real. - Iframe Embed: O conteúdo é carregado em um iframe no seu domínio. Útil quando você precisa manter um URL consistente. Direct Mode é perfeito para profissionais de marketing que desejam uma solução plug-and-play.

Comparação de desempenho

Ambos os modos podem atingir tempos de veredicto inferiores a 10 ms quando o mecanismo subjacente é rápido. A diferença está no ciclo de vida total da solicitação: - API Mode adiciona uma solicitação HTTP à lógica do lado do servidor. Se o seu servidor estiver próximo do serviço de filtragem, isso adicionará 5 a 20 ms. - Direct Mode exige que o visitante acesse primeiro o serviço de filtragem e depois seja redirecionado. Isso adiciona uma viagem de ida e volta completa, mas o redirecionamento em si é tratado no nível HTTP, portanto é rápido. Na prática, ambas as abordagens são imperceptíveis aos visitantes. A escolha deve ser baseada em seus requisitos técnicos e não em questões de desempenho.

Qual você deve escolher?

Escolha API Mode se você tiver recursos de desenvolvimento, precisar de lógica de roteamento personalizada ou quiser integrar a filtragem em uma base de código existente. Escolha Direct Mode se desejar a configuração mais rápida, não tiver código do lado do servidor ou preferir uma solução gerenciada onde a plataforma lide com todo o roteamento. Muitos usuários começam com Direct Mode por sua simplicidade e migram para API Mode mais tarde, quando precisam de mais controle. As melhores plataformas suportam ambos os modos com o mesmo mecanismo de filtro, para que você obtenha proteção idêntica, independentemente do seu método de integração.

Artigos relacionados

Guia

O que é cloaking e por que profissionais de marketing inteligentes o utilizam

A camuflagem de tráfego é uma técnica que mostra conteúdos diferentes para visitantes diferentes com base em seus atributos. Saiba como funciona e por que é importante para suas campanhas.

Dicas

5 filtros essenciais que toda campanha precisa para bloquear o tráfego de bots

Nem todos os filtros são criados iguais. Esses cinco tipos de filtro formam a base de qualquer configuração eficaz de filtragem de tráfego.