Cloudflare SQL API: confira os atributos dos seus relatórios
A mudança de introspection de 27 de outubro: ficha para desenvolvimento e dois exemplos para testar relatórios próprios com possibilidade de retorno.
Em 27 de outubro, a Cloudflare anunciou o parâmetro include_attributes e o campo de resposta attributes para introspection. Os nomes anteriores continuam funcionando, mas foram descontinuados como recomendação.
Quem precisa verificar
Publishers com relatório técnico próprio que descobre seu esquema pela Cloudflare SQL API e os desenvolvedores responsáveis. Se você apenas usa um painel pronto, pergunte primeiro se ele utiliza essa API. O anúncio não significa falha em todos os relatórios nem exige alterar campanhas de publicidade.
O que observar
A documentação identifica a SQL API como Beta. A descoberta de atributos considera os sete dias anteriores de dados da conta. Uma lista vazia não comprova que esses eventos nunca existiram.
Nossa proposta de teste
Localize include_custom_attributes e custom_attributes no cliente. Preserve a versão funcional. Em uma cópia de teste, altere tanto o parâmetro da solicitação quanto a leitura da resposta. Compare os dois leitores com uma resposta salva e anonimizada e confira um conjunto de dados disponível. Não inclua tokens de acesso na ficha nem no artigo.
Dois exemplos hipotéticos
Primeiro: um filtro fica vazio após a alteração da solicitação. Salve a resposta anonimizada e confira de onde o cliente lê a lista. Se ainda procura o campo antigo, corrija a cópia de teste antes de interpretar a interface vazia como perda de tráfego. Segundo: um atributo apareceu apenas em uma campanha antiga. Confira separadamente o período observado e os dados de origem. Não substitua um valor desconhecido por zero. São cenários de diagnóstico, não resultados de clientes.
Ficha para o desenvolvedor
Responsável pelo relatório; conta e conjunto de dados sem segredos; horário da verificação; campo anterior; campo novo; resposta anonimizada; filtro esperado; resultado observado; método de reversão; decisão e responsável.
Critérios de aceite
Aceite a mudança quando a resposta verificada aparecer corretamente, dados ausentes estiverem identificados e a versão anterior estiver preservada. Se houver divergência, interrompa a substituição e investigue. Um problema técnico isolado não deve mudar a avaliação de uma fonte de tráfego.
Rotina de afiliados
Você pode entrar na sua conta AffiliateCore para trabalhar em nossa plataforma. Dados técnicos da Cloudflare e a confirmação de um resultado de afiliado são verificações diferentes. Este artigo não anuncia uma integração.
Fontes e data da verificação
Cloudflare changelog — 2026-10-27; Cloudflare SQL API: Datasets. 2026-10-28.