Pré-requisitos Início rápido MonetizationConfig estrutura Redes de pagamento suportadas Modo de teste Próximas etapas

Introdução à monetização do tráfego de IA

Pré-requisitos

Um pacote AWS WAF de proteção (web ACL) associado a uma distribuição da Amazon CloudFront
Um endereço de carteira USDC na Base, Solana ou em ambas para receber pagamentos.
(Recomendado) Controle de AWS WAF bots ativado para classificar o tráfego de bots de IA por identidade

Início rápido

Ativar controle de bots — se ainda não estiver ativado, adicione o grupo de regras gerenciadas do controle de AWS WAF bots à sua ACL da web.
Crie um pacote de proteção (WebACL) — No AWS WAF console, navegue até Pacotes de proteção (WebACL) na região Cloudfront (Global) e crie um novo pacote com seus preços, políticas de bots e agentes e configuração de pagamento. Associe a uma CloudFront distribuição.
Configurar MonetizationConfig — Para usar a monetização do tráfego de IA, você configura uma ACL MonetizationConfig na web. Essa configuração define as redes de pagamento que você aceita e o preço base para solicitações monetizadas.

O MonetizationConfig contém:

CurrencyMode— REAL para pagamentos de produção ou TEST para pagamentos de rede de teste.
CryptoConfig— Configuração da rede de pagamento, incluindo cadeias, endereços de carteira e preços.

MonetizationConfig estrutura


{
  "MonetizationConfig": {
    "CryptoConfig": {
      "PaymentNetworks": [
        {
          "Chain": "BASE",
          "WalletAddress": "0x1234567890abcdef1234567890abcdef12345678",
          "Prices": [
            {
              "Amount": "0.001",
              "Currency": "USDC"
            }
          ]
        },
        {
          "Chain": "SOLANA",
          "WalletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
          "Prices": [
            {
              "Amount": "0.001",
              "Currency": "USDC"
            }
          ]
        }
      ]
    }
  }
}

Importante

O Amount é especificado em USDC como uma sequência decimal com até 3 casas decimais (por exemplo, "0.001" = 0,001 USDC por solicitação).

Redes de pagamento suportadas

Chain	Rede	Moeda	Caso de uso
BASE	Rede principal básica (EVM L2)	USDC	Pagamentos de produção
SOLANA	Rede principal de Solana	USDC	Pagamentos de produção
BASE_SEPOLIA	Base Sepolia testnet	USDC	Modo de teste
SOLANA_DEVNET	Solana Devnet	USDC	Modo de teste

Modo de teste

O modo de teste (CurrencyMode: TEST) permite que você valide sua configuração de monetização usando redes blockchain de teste antes de entrar em operação com pagamentos reais. Essa configuração é aplicada a todo o pacote de proteção (Web ACL) (Web ACL).

Importante

Para implementar suas políticas de monetização de tráfego de IA, usamos várias técnicas de detecção, como sinais comportamentais e sistemas baseados em riscos, para inspecionar e categorizar o tráfego de entrada. Embora esses métodos tenham sido projetados para fornecer uma classificação de alta confiança, eles são probabilísticos e podem não identificar ou categorizar corretamente todo o tráfego de bots em todos os casos. Testamos e atualizamos continuamente nossos métodos de análise para aumentar a precisão. Recomendamos usar o modo de teste para validar se suas políticas produzem os resultados esperados antes de ativar a monetização ao vivo.

Ativando o modo de teste

CurrencyModeDefina como TEST em suas cadeias de rede de teste MonetizationConfig e configure.

Comportamento do modo de teste

No modo de teste:

Os pagamentos usam redes de teste: Base Sepolia e Solana Devnet
Você usa fundos de teste como o Testnet Faucet (disponível em torneiras públicas) em vez do USDC real
O fluxo de pagamento completo é executado de forma idêntica à produção — verificação, origem, busca e liquidação ocorrem no blockchain de teste.
Todos os eventos são registrados com CurrencyMode: TEST
A análise de receita pode ser consultada com o filtro CurrencyMode: ["TEST"]

Importante

Use o modo de teste somente em tráfego que não seja de produção para validação interna antes de aplicar políticas de monetização na produção.

Validando a configuração

Use o modo de teste para verificar:

Preços corretos para diferentes regras e caminhos de conteúdo
Fluxo de pagamento de ponta a ponta (402 → autorização de pagamento → verificação → liquidação)
Correção do endereço da carteira (os fundos chegam na carteira de teste)
Os campos de análise e registro são preenchidos corretamente

Quando estiver satisfeito, CurrencyMode: REAL atualize e configure suas MonetizationConfig cadeias de produção (BASE, SOLANA) para começar a processar pagamentos reais.

Você pode começar com o CurrencyMode: TEST teste inicial ou começar a monetizar diretamente usando. CurrencyMode: REAL
Adicione regras de monetização — Crie regras com a ação Monetizar. Use instruções de correspondência para direcionar caminhos específicos, rótulos do Bot Control ou outras características da solicitação.
Teste — Envie solicitações de teste para sua CloudFront distribuição. Solicitações que correspondam às suas regras de geração de receita receberão Desafios de Pagamento Obrigatório (402 respostas). Use um cliente de pagamento compatível para concluir o fluxo.
CurrencyModeEntrar em operação — Atualize REAL e configure redes de pagamento de produção (BASE, SOLANA). Financie uma carteira de teste e verifique de ponta a ponta antes de abrir o tráfego de produção.

Próximas etapas

Revise o painel de análise de tráfego de IA para entender seu tráfego atual de bots antes de definir preços.
Configure preços diferenciados com base no nível do agente e no caminho do conteúdo.
Configure a análise de receita para monitorar os ganhos.

Convenções do documento

Como funciona a monetização do tráfego de IA

Configuração de preços