Skip to main content
Use a atribuição de aplicativos para separar o uso entre produtos, ambientes ou experiências voltadas ao cliente. Ela aparece nas análises de aplicativos e auditorias de solicitações sem alterar a resposta de inferência.

Adicionar cabeçalhos de atribuição

Envie um ID de aplicativo estável em cada solicitação. Adicione nome, URL e até três categorias para obter um agrupamento mais detalhado no painel.
Use o mesmo X-App-Id em todas as solicitações do mesmo aplicativo. O Phaseo o usa como identidade estável quando não há uma URL disponível.

Usar o SDK TypeScript

Cabeçalhos compatíveis

HTTP-Referer é um metadado de atribuição; não precisa corresponder ao cabeçalho Referer automático do navegador. Defina-o explicitamente em integrações no servidor se quiser usar uma única URL canônica para o aplicativo.

Categorias

Escolha até três valores:
  • chat
  • developer-tools
  • research
  • productivity
  • education
  • commerce
  • media
  • finance
  • other
Os valores não diferenciam maiúsculas de minúsculas. O Phaseo ignora valores desconhecidos, remove duplicatas e mantém as três primeiras categorias válidas. Categorias recebidas em solicitações posteriores são combinadas às já salvas para o aplicativo; elas não removem seleções feitas no painel. Você também pode editar categorias em Gateway → Configurações → Aplicativos. Use o painel quando a classificação for gerenciada centralmente, e não pelo código do aplicativo.

Diretrizes de atribuição

  • Mantenha os IDs estáveis entre implantações para que o uso continue agrupado.
  • Use IDs separados para aplicativos que precisam de relatórios de custo ou uso independentes.
  • Não inclua IDs de clientes, endereços de e-mail ou outros dados pessoais nos cabeçalhos de atribuição.
  • Considere a URL como metadado público quando o aplicativo puder aparecer em visualizações públicas ou compartilhadas.
Última modificação em 2 de outubro de 2026