ℹ️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).

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.

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).