Configurar a detecção de bot para sequências de dados

O tráfego proveniente de entidades não humanas, como programas automatizados, web scrapers, spiders e scanners com script, pode dificultar a identificação de eventos que ocorrem de visitantes humanos. Esse tipo de tráfego pode afetar negativamente métricas comerciais importantes, resultando em relatórios de tráfego incorretos.

A detecção de bot permite identificar eventos gerados pelo SDK da Web, SDK Móvel e Server API como sendo gerados pelos spiders e bots conhecidos.

Ao configurar a detecção de bot para seus fluxos de dados, você pode identificar endereços IP, intervalos de IP e cabeçalhos de solicitação específicos que gostaria de classificar como eventos de bot.

A identificação do tráfego de bot pode fornecer uma medida mais precisa da atividade do usuário no seu site ou aplicativo móvel.

Quando uma solicitação para o Edge Network corresponde a qualquer uma das regras de detecção de bot, o esquema XDM é atualizado com uma pontuação de bot (sempre definida como 1), conforme mostrado abaixo.

{
  "botDetection": {
    "score": 1
  }
}

Essa pontuação de bot ajuda as soluções que recebem a solicitação a identificar corretamente o tráfego do bot.

IMPORTANT
A detecção de bot não elimina nenhuma solicitação de bot. Ela atualiza somente o esquema XDM com a pontuação de bot e encaminha o evento para o serviço de sequência de dados que você configurou.
As soluções de Adobe podem lidar com a pontuação de bot de maneiras diferentes. Por exemplo, o Adobe Analytics usa seu próprio serviço de filtragem de bot e não usa a pontuação definida pelo Edge Network. Os dois serviços usam a mesma lista de bot IAB, portanto, a pontuação do bot é idêntica.

As regras de detecção de bot podem levar até 15 minutos para se propagarem pelo Edge Network após serem criadas.

Pré-requisitos prerequisites

Para que a detecção de bot funcione na sequência de dados, é necessário adicionar o grupo de campos Informações de Detecção de Bot ao esquema. Consulte a documentação do esquema XDM para saber como adicionar grupos de campos a um esquema.

Configurar a detecção de bot para sequências de dados configure

Você pode configurar a detecção de bot após criar uma configuração de sequência de dados. Consulte a documentação sobre como criar e configurar uma sequência de dados e, em seguida, siga as instruções abaixo para adicionar recursos de detecção de bot à sua sequência de dados.

Vá para a lista de sequências de dados e selecione a sequência de dados à qual deseja adicionar a detecção de bot.

Interface do usuário de sequências de dados mostrando a lista de sequências de dados.

Na página de detalhes da sequência de dados, selecione a opção Detecção de bot no painel direito.

Opção de detecção de bot realçada na interface de usuário de fluxos de dados.

A página Regras de detecção de bot é exibida.

Configurações de detecção de bot na página de configurações da sequência de dados.

Na página Regras de detecção de bot, você pode configurar a detecção de bot usando as seguintes funcionalidades:

Usar a Lista Internacional de spiders e bots da IAB/ABC iab-list

A Lista Internacional de Aranhas e Bots do IAB/ABC é uma lista de spiders e bots da Internet padrão do setor de terceiros, que ajuda a identificar tráfego automatizado, como rastreadores de mecanismo de pesquisa, ferramentas de monitoramento e outro tráfego não humano que talvez você não queira exibir em suas contagens de análise.

Para configurar sua sequência de dados para usar o IAB/ABC International Spiders and Bots List, alterne a opção Usar Lista Internacional de spiders e bots IAB/ABC para detecção de bot nesta sequência de dados e selecione Salvar para aplicar as configurações de detecção de bot à sua sequência de dados.

Aranhas IAB e lista de bot habilitadas.

Criar regras de detecção de bot rules

Além de usar a Lista Internacional de spiders e bots do IAB/ABC, você pode definir suas próprias regras de detecção de bot para cada sequência de dados.

Você pode criar regras de detecção de bot com base em endereços IP e intervalos de endereço IP.

Se você precisar de regras de detecção de bot mais granulares, poderá combinar as condições de IP com as condições do cabeçalho da solicitação. As regras de detecção de bot podem usar os seguintes cabeçalhos:

Cabeçalho HTTP
Descrição
user-agent
Um cabeçalho que permite que servidores e colegas de rede identifiquem o aplicativo, o sistema operacional, o fornecedor e/ou a versão do agente do usuário solicitante.
content-type
Indica o tipo de mídia original do recurso (antes de qualquer codificação de conteúdo aplicada para envio).
referer
Identifica o endereço da página da Web da qual o recurso foi solicitado.
sec-ch-ua
Fornece a marca e a versão significativa de cada marca associada ao navegador em uma lista separada por vírgulas.
sec-ch-ua-mobile
Indica se o navegador está em um dispositivo móvel. Ele também pode ser usado por um navegador de desktop para indicar uma preferência por uma experiência do usuário móvel.
sec-ch-ua-platform
Fornece a plataforma ou o sistema operacional em que o agente do usuário está sendo executado. Por exemplo: "Windows" ou "Android".
sec-ch-ua-platform-version
Fornece a versão do sistema operacional no qual o agente do usuário está sendo executado.
sec-ch-ua-arch
Fornece a arquitetura subjacente da CPU do agente do usuário, como ARM ou x86.
sec-ch-ua-model
Indica o modelo do dispositivo no qual o navegador está sendo executado.
sec-ch-ua-bitness
Fornece o "bit" da arquitetura subjacente da CPU do agente do usuário. Esse é o tamanho em bits de um número inteiro ou endereço de memória — normalmente 64 ou 32 bits.
sec-ch-ua-wow64
Indica se um binário do agente do usuário está sendo executado no modo de 32 bits no Windows de 64 bits.

Para criar uma regra de detecção de bot, siga as etapas abaixo:

  1. Selecione Adicionar Nova Regra.

    Tela de configurações de detecção de bot com o botão Adicionar nova regra realçado.

  2. Digite um nome para a regra no campo Nome da Regra.

    Tela de regra de detecção de bot com o nome de regra realçado.

  3. Selecione Adicionar nova condição de IP para adicionar uma nova regra baseada em IP. Você pode definir a regra por endereço IP ou por intervalo de endereços IP.

    Tela de regra de detecção de bot com o campo de endereço IP realçado.

    Tela de regra de detecção de bot com o campo de intervalo IP realçado.

    note tip
    TIP
    As condições de IP são baseadas em uma operação OR lógica. Uma solicitação é marcada como originária de um bot se corresponder a qualquer uma das condições de IP definidas.
  4. Se quiser adicionar condições de cabeçalho à regra, selecione Adicionar grupo de condições de cabeçalho e selecione os cabeçalhos que deseja que a regra use.

    Tela de regra de detecção de bot com as condições de cabeçalho realçadas.

    Em seguida, adicione as condições a serem usadas para o cabeçalho selecionado.

    Tela de regra de detecção de bot com as condições de cabeçalho realçadas.

  5. Depois de configurar as regras de detecção de bot desejadas, selecione Salvar para aplicar as regras à sua sequência de dados.

    Tela de regra de detecção de bot com as condições de cabeçalho realçadas.

Exemplos de regras de detecção de bot examples

Para ajudar você a começar a usar a detecção de bot, use os exemplos detalhados abaixo para criar regras de detecção de bot.

Detecção de bot com base em um endereço IP one-ip

Para marcar todas as solicitações originadas de um endereço IP específico como tráfego de bot, crie uma nova regra de detecção de bot que avalia um único endereço IP, conforme mostrado na imagem abaixo.

Regra de detecção de bot baseada em um endereço IP.

Detecção de bot com base em dois endereços IP two-ip

Para marcar todas as solicitações originadas de um dos dois endereços IP específicos como tráfego de bot, crie uma nova regra de detecção de bot que avalia dois endereços IP, conforme mostrado na imagem abaixo.

Regra de detecção de bot baseada em dois endereços IP.

Detecção de bot com base em um intervalo de endereços IP range

Para marcar todas as solicitações originadas de qualquer endereço IP em um intervalo específico como tráfego de bot, crie uma nova regra de detecção de bot que avalia um intervalo de endereços IP inteiro, como mostrado na imagem abaixo.

Regra de detecção de bot baseada no intervalo de IPs.

Detecção de bot com base em um endereço IP e um cabeçalho de solicitação ip-header

Para marcar todas as solicitações originadas de um endereço IP específico e que contenham um cabeçalho de solicitação específico como tráfego de bot, crie uma nova regra de detecção de bot, conforme mostrado na imagem abaixo.

Esta regra verifica se a solicitação se origina de um endereço IP específico e se o cabeçalho da solicitação referer começa com www.adobe.com.

Regra de detecção de bot baseada no endereço IP e no cabeçalho da solicitação.

Detecção de bot com base em várias condições multiple-conditions

Você pode criar regras de detecção de bot com base em:

  • Várias condições diferentes: condições diferentes são avaliadas como uma operação AND lógica, o que significa que as condições precisam ser atendidas simultaneamente para que a solicitação seja identificada como originária de um bot.
  • Várias condições do mesmo tipo: condições do mesmo tipo são avaliadas como uma operação OR lógica, o que significa que, se qualquer uma das condições for atendida, a solicitação será identificada como originária de um bot.

A regra mostrada na imagem abaixo identifica uma solicitação de origem de bot se as seguintes condições forem atendidas:

A solicitação se origina de um dos dois endereços IP, o cabeçalho referer começa com www.adobe.com e o cabeçalho sec-ch-ua-mobile identifica a solicitação como originada de um navegador de desktop.

Regra de detecção de bot baseada em várias condições.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac