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