# Introdução

## Campos de contexto para todos os eventos

Os campos de contexto estão contidos em todos os eventos, conhecidos como contextFields, dão contexto ao evento capturado como insights geográficos, de dispositivos, de comportamento de uso e navegação, itens apresentados na telas, e transacionais. Segue um descritivo desses campos:

1. **created**: Tipo `number`. Representa o tempo de criação do evento em segundos desde a época Unix. Essencial para determinar o momento exato da ocorrência de um evento.
2. **event\_name**: Tipo `string`. Nome predefinido do evento por AgnosticData ou um nome customizado pelo cliente, utilizado para categorizar e identificar a ação que está sendo rastreada.
3. **eid**: Tipo `Nullable<string>`. Identificador opcional do evento, geralmente utilizado em sistemas de mensagens como Kafka para rastreamento e log de eventos.
4. **event\_type**: Tipo `Nullable<string>`. Indica o tipo de evento em relação ao provedor de anúncios ou à ferramenta de destino, auxiliando na diferenciação e análise específica por tipo.
5. **event\_name\_from\_type**: Tipo `Nullable<string>`. Descrição ou correlação descritiva do evento com o tipo de provedor, fornecendo detalhes adicionais sobre a origem específica do evento.
6. **scope**: Tipo `Nullable<string>`. Define o escopo predefinido para cada cliente, como 'customer:123456', utilizado para segmentar e organizar eventos por entidade ou domínio.
7. **event\_provider**: Tipo `Nullable<string>`. Identifica o fornecedor ou a origem do evento, útil para integrar e gerenciar dados em um marketplace futuro.
8. **app\_info\_version**: Tipo `string`. Versão do aplicativo ou site onde o evento ocorreu, como 'web-4.0.1', importante para rastrear a compatibilidade e o desempenho do evento conforme as versões evoluem.
9. **app\_package\_name**: Tipo `Nullable<string>`. Nome do pacote do aplicativo ou URL do site, fornecendo um identificador único para a plataforma de origem do evento.
10. **relative\_view**: Tipo `Nullable<string>`. Utilizado para análises intuitivas, este campo descreve a visão relativa da URL, como 'domain.com/relativeURL', crucial para entender o contexto da navegação do usuário.
11. **action\_source**: Tipo `ActionSourceType`. Fonte de ação conforme necessário por serviços externos, essencial para adequação e conformidade em campanhas de marketing digital.
12. **carrier**: Tipo `Nullable<string>`. Nome da operadora de telefonia móvel do usuário, utilizado para análises demográficas e de acessibilidade.
13. **session\_id**: Tipo `Nullable<string>`. Identificador de sessão única para o usuário durante sua visita, importante para rastrear a jornada do usuário através de sessões contínuas.
14. **user\_id**: Tipo `Nullable<string>`. Identificador único do usuário dentro do sistema do cliente, permitindo a personalização e o rastreamento detalhado de interações individuais.
15. **user\_pseudo\_id**: Tipo `Nullable<string>`. Identificador pseudo do usuário para processos de anonimização, garantindo a privacidade e a conformidade com regulamentações de dados.
16. **visitor\_id**: Tipo `Nullable<string>`. ID de visitante, usado para rastrear usuários antes de serem identificados como usuários registrados.
17. **user\_phone**: Tipo `Nullable<string>`. Número de telefone do usuário, usado para comunicações diretas ou campanhas de marketing.
18. **userToken**: Tipo `Nullable<string>`. Token de autenticação do usuário, importante para processos de verificação e segurança.
19. **is\_promo**: Tipo `Nullable<boolean>`. Indica se o evento está relacionado a uma promoção, essencial para análises de marketing e eficácia promocional.
20. **device\_id**: Tipo `Nullable<string>`. Identificador único do dispositivo usado pelo usuário, crucial para rastreamento de dispositivos e análise de uso.
21. **device\_brand**: Tipo `Nullable<string>`. Marca do dispositivo usado pelo usuário, útil para análises de segmentação e tendências de consumo.
22. **device\_resolution**: Tipo `Nullable<string>`. Resolução da tela do dispositivo, importante para otimizar a experiência do usuário e adequar conteúdos visuais.
23. **device\_screen\_density**: Tipo `Nullable<number>`. Densidade da tela do dispositivo multiplicada por 10, crucial para ajustar interfaces de usuário conforme a qualidade de exibição.
24. **device\_so**: Tipo `Nullable<string>`. Sistema operacional do dispositivo, relevante para segmentação de campanhas e compatibilidade de aplicativos.
25. **device\_so\_version**: Tipo `Nullable<string>`. Versão do sistema operacional do dispositivo, importante para entender a compatibilidade e realizar testes de software específicos.
26. **device\_language**: Tipo `Nullable<string>`. Idioma configurado no dispositivo, vital para localização de conteúdo e marketing internacional.
27. **device\_model\_name**: Tipo `Nullable<string>`. Modelo exato do dispositivo, como "iPhone 11", útil para análises detalhadas de desempenho e preferências de usuário.
28. **device\_web\_browser**: Tipo `Nullable<string>`. Navegador web utilizado no dispositivo, essencial para entender comportamentos de navegação e otimizar experiências web.
29. **device\_ipaddress**: Tipo `Nullable<string>`. Endereço IP do dispositivo, usado para análises geográficas e de segurança.
30. **device\_geohash**: Tipo `Nullable<string>`. Código geohash que representa a localização geográfica do dispositivo, importante para análises geográficas detalhadas.
31. **device\_timezone**: Tipo `Nullable<string>`. Fuso horário do dispositivo, por exemplo, 'America/Sao\_Paulo

    ', crucial para agendar notificações e eventos em tempo real.
32. **opened\_from\_type**: Tipo `Nullable<string>`. Tipo de origem que levou o usuário a abrir o aplicativo ou página, como 'external\_link', vital para rastrear a eficácia de diferentes canais de marketing.
33. **opened\_from\_content**: Tipo `Nullable<string>`. Conteúdo específico da origem que levou à abertura, como um título de notificação push, útil para analisar o impacto de conteúdos específicos.
34. **last\_origin**: Tipo `Nullable<string>`. Última origem de navegação antes do evento, importante para rastrear jornadas de usuário através de múltiplas sessões.
35. **last\_origin\_ts**: Tipo `Nullable<number>`. Timestamp da última origem, proporcionando uma linha do tempo detalhada das ações do usuário.
36. **target\_data**: Tipo `Array<ITargetData>`. Coleção de dados alvo para integração com terceiros, como pixels de rastreamento ou IDs de campanha, permitindo ações de marketing direcionadas.
37. **event\_data**: Tipo `Array<CustomEvents<SignupEvent | ViewContentEvent | AddOpportunity | Message | Hook>>`. Dados específicos de cada evento individual, cada um com sua própria estrutura de dados conforme o tipo de evento. (explicaremos mais adiante).&#x20;
38. **utm\_case**: Tipo `Nullable<any>`. Aplica configurações de UTM a todos os eventos, ajudando a padronizar o rastreamento de campanhas em todas as plataformas. IMPORTANTE: Todas as UTM serão persistidas até uma das variáveis determinantes serem modificadas na chamada da URL. Veja mais em [Atribuição e Determinantes](https://docs.agnosticdata.ai/agnosticdata.ai-or-documentation/fundamentals/preparando-se-para-comecar/estrategias-de-atribuicao#atribuicao-e-determinantes).
39. **items**: Tipo `Nullable<Array<Item>>`. Lista de itens associados ao evento, como produtos visualizados ou adicionados ao carrinho, crucial para análises de e-commerce e inventário.
40. **sdk**: Tipo `Nullable<string>`. Versão do SDK usado para registrar o evento, como 'web-' ou 'flutter-', essencial para suporte técnico e atualizações de software.
41. **ati**: Tipo `IAti`. Identificador de rastreamento de anúncios, integrando IDs específicos de plataformas como Google Ads ou Facebook Ads, fundamental para otimizar o ROI de campanhas publicitárias.
42. **extra\_data**: extra\_data é uma string JSON que contém dados adicionais para o evento exemplo: {"key":"value"} or {"key":"value","key2":"value2"}.  Dado um evento qualquer, os eventos comuns e padronizados, o cliente AgnosticData pode enviar informações extras para complementar o evento. (Veja também o evento `custom_event`).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agnosticdata.ai/agnosticdata.ai-or-documentation/fundamentals/introducao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.