{"section":"tutorials","requestedLocale":"pt","requestedSlug":"navegacao-data-pipeline-beta","locale":"pt","slug":"navegacao-data-pipeline-beta","path":"docs/pt/tutorials/beta/vtex-data-pipeline-beta/navegacao-data-pipeline-beta.md","branch":"main","content":"Um conjunto de dados de navegação contém o conjunto de ações de navegação que acontecem no site ou aplicativo móvel da loja (para aplicativos móveis e lojas headless, deve ter o SDK do Activity Flow instalado). É o registro de como os compradores se movem pela experiência: quais telas eles abrem, quais páginas visitam e como sua jornada se desenvolve da entrada até a saída.\n\n## Características dos dados\n\n| Característica                  | Descrição                                                                                                                                                                                                                                                                                                                        |\n| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Fonte de dados                  | Os dados deste conjunto vêm de um script que roda no frontend da loja e registra informações de sessão do usuário e atividade.                                                                                                                                                                                                   |\n| Disponibilidade                 | Esta métrica está disponível apenas através do Data Pipeline.                                                                                                                                                                                                                                                                    |\n| Histórico                       | Devido ao volume significativo deste Modelo de Dados, só podemos enviar pipelines incrementais, não dados históricos. Isso significa que assim que você adquirir o produto, começaremos a entregar seus dados a partir desse ponto. Diferente de outros Modelos de Dados, não podemos incluir dados históricos na carga inicial. |\n| Intervalo mínimo de atualização | Uma hora.                                                                                                                                                                                                                                                                                                                        |\n\n## Tabela: page_views\n\nOs campos da tabela são descritos abaixo:\n\n| Nome da coluna | Tipo da coluna | Descrição da coluna                                                                                                                          |\n| -------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| mac_id         | string         | ID único (UUID) para identificar usuários recorrentes. Dura 1 ano sendo atualizado enquanto o usuário muda de páginas.                       |\n| session_id     | string         | ID único da sessão, durando 30 minutos sendo atualizado enquanto o usuário muda de páginas.                                                  |\n| account_name   | string         | Conta VTEX da loja que está gerando esta sessão.                                                                                             |\n| url            | string         | URL completa da visualização de página.                                                                                                      |\n| ref            | string         | URL da página que referiu o comprador para esta página.                                                                                      |\n| workspace      | string         | Workspace que o usuário está visitando (ex: master). Relevante para AB Testing na Plataforma IO.                                             |\n| checkout_type  | string         | Esta coluna indica o tipo de checkout usado por essa respectiva loja nesse tipo de requisição.                                               |\n| storefront     | string         | O ambiente da VTEX usado para renderizar a página. Atualmente, temos três plataformas possíveis: `portal`, `store_framework` e `fast_store`. |\n| is_new_user    | boolean        | Especifica se esta é a primeira visualização de página do comprador nesta loja.                                                              |\n| is_first_event | boolean        | Especifica se esta é a primeira visualização de página do comprador em sua sessão atual.                                                     |\n| user_agent     | string         | String user-agent extraída do navegador do comprador.                                                                                        |\n| event_time     | timestamp      | Timestamp de quando este evento foi ingerido (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).               |\n\n## Tabela: session_order\n\nOs campos da tabela são descritos abaixo:\n\n| Nome da coluna    | Tipo da coluna | Descrição da coluna                                                                                                                                                                             |\n| ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| session_id        | string         | ID único da sessão, durando 30 minutos sendo atualizado enquanto o usuário muda de páginas.                                                                                                     |\n| account_name      | string         | Conta VTEX da loja que está gerando esta sessão.                                                                                                                                                |\n| order_group       | string         | Grupo de pedido ao qual este pedido pertence (que também pode ser encontrado no Modelo de Dados de Pedidos, para unir dados de Navegação com dados de Pedidos).                                 |\n| record_created_at | timestamp      | Quando este registro foi criado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                               |\n| record_updated_at | timestamp      | Quando este registro foi atualizado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                           |\n| batch_id          | timestamp      | Identificador usado quando os dados são carregados na tabela para controle de qualidade da ingestão de dados. (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX). |\n\n## Tabela: session_user_agent\n\nOs campos da tabela são descritos abaixo:\n\n| Nome da coluna           | Tipo da coluna | Descrição da coluna                                                                                                                                                                             |\n| ------------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| account_name             | string         | Conta VTEX da loja que está gerando esta sessão.                                                                                                                                                |\n| session_id               | string         | ID único da sessão, durando 30 minutos sendo atualizado enquanto o usuário muda de páginas.                                                                                                     |\n| browser_family           | string         | Família do navegador, extraída do user_agent.                                                                                                                                                   |\n| browser_version          | string         | Versão do navegador, extraída do user_agent.                                                                                                                                                    |\n| operating_system_family  | string         | Família do sistema operacional, extraída do user_agent.                                                                                                                                         |\n| operating_system_version | string         | Versão do sistema operacional, extraída do user_agent.                                                                                                                                          |\n| device_family            | string         | Família do dispositivo, extraída do user_agent.                                                                                                                                                 |\n| device_brand             | string         | Marca do dispositivo, extraída do user_agent.                                                                                                                                                   |\n| device_model             | string         | Modelo do dispositivo, extraído do user_agent.                                                                                                                                                  |\n| device_type              | string         | Tipo de dispositivo, extraído do user_agent.                                                                                                                                                    |\n| record_created_at        | timestamp      | Quando este registro foi criado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                               |\n| record_updated_at        | timestamp      | Quando este registro foi atualizado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                           |\n| batch_id                 | timestamp      | Identificador usado quando os dados são carregados na tabela para controle de qualidade da ingestão de dados. (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX). |\n\n## Tabela: url\n\nOs campos da tabela são descritos abaixo:\n\n| Nome da coluna    | Tipo da coluna | Descrição da coluna                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |\n| ----------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| account_name      | string         | Conta VTEX da loja que está gerando esta sessão.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |\n| url               | string         | URL completa da visualização de página.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |\n| request_type      | string         | O tipo de página que o usuário está visualizando. Pode ser um dos seguintes:<br /><b>- homeView</b>: `<domain>/`<br /><b>- productView</b>: `<domain>/<product-name>/p`<br /><b>- checkout</b>: `<domain>/checkout#/checkout`<br /><b>- cart</b>: `<domain>/checkout#/cart`<br /><b>- email</b>: `<domain>/checkout#/email`<br /><b>- login</b>: `<domain>/login?returnUrl=<checkout>`<br /><b>- profile</b>: `<domain>/checkout#/profile`<br /><b>- shipping</b>: `<domain>/checkout#/shipping`<br /><b>- payment</b>: `<domain>/checkout#/payment`<br /><b>- orderPlaced</b>: `<domain>/checkout#/orderPlaced` <br /><b>- otherView</b>: `<domain>/<other-path>` |\n| product_id        | bigint         | ID do produto exibido na página, usado para unir com o Modelo de Dados do Catálogo. Presente apenas se request_type for productView.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |\n| product_name      | string         | Nome do produto exibido na página, usado para unir com o Modelo de Dados do Catálogo. Presente apenas se request_type for productView.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |\n| category_id       | bigint         | ID da categoria exibida na página, usado para unir com o Modelo de Dados do Catálogo. Presente apenas se request_type for categoryView.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |\n| category_name     | string         | Nome da categoria exibida na página, usado para unir com o Modelo de Dados do Catálogo. Presente apenas se request_type for categoryView.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n| order_group       | string         | Grupo de pedido ao qual este pedido pertence (que também pode ser encontrado no Modelo de Dados de Pedidos, para unir dados de Navegação com dados de Pedidos).                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |\n| traffic_type      | string         | Define `Paid` ou `Organic` de acordo com o padrão da URL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n| url_utm_medium    | string         | UTM Medium, extraído da url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |\n| url_utm_source    | string         | UTM Source, extraído da url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |\n| url_utm_campaign  | string         | UTM Campaign, extraído da url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |\n| url_utm_content   | string         | UTM Content, extraído da url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |\n| url_utm_term      | string         | UTM Term, extraído da url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| url_gclid_found   | boolean        | Verdadeiro se um código gclid (ID do Google Ads) foi encontrado na url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |\n| url_fbcid_found   | boolean        | Verdadeiro se um código fbclid (ID do Facebook Ads) foi encontrado na url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| record_created_at | timestamp      | Quando este registro foi criado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |\n| record_updated_at | timestamp      | Quando este registro foi atualizado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |\n| batch_id          | timestamp      | Identificador usado quando os dados são carregados na tabela para controle de qualidade da ingestão de dados. (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                                                                                                                                                                                                                                                                                                                                                                                              |\n\n## Tabela: web_vitals\n\nOs campos da tabela são descritos abaixo:\n\n| Nome da coluna    | Tipo da coluna | Descrição da coluna                                                                                                                                                                             |\n| ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| mac_id            | string         | ID único (UUID) para identificar usuários recorrentes. Dura 1 ano sendo atualizado enquanto o usuário muda de páginas.                                                                          |\n| session_id        | string         | ID único da sessão, durando 30 minutos sendo atualizado enquanto o usuário muda de páginas.                                                                                                     |\n| metric_id         | string         | ID único para este evento de core web vital.                                                                                                                                                    |\n| account_name      | string         | Conta VTEX da loja que está gerando esta sessão.                                                                                                                                                |\n| url               | string         | URL completa da visualização de página.                                                                                                                                                         |\n| ref               | string         | URL da página que referiu o comprador para esta página.                                                                                                                                         |\n| workspace         | string         | Workspace que o usuário está visitando (ex: master). Relevante para AB Testing na Plataforma IO.                                                                                                |\n| checkout_type     | string         | Esta coluna indica o tipo de checkout usado por essa respectiva loja nesse tipo de requisição.                                                                                                  |\n| is_new_user       | boolean        | Especifica se esta é a primeira visualização de página do comprador nesta loja.                                                                                                                 |\n| is_first_event    | boolean        | Especifica se esta é a primeira visualização de página do comprador em sua sessão atual.                                                                                                        |\n| navigation_type   | string         | Tipo de navegação dado por este evento. Este campo aceita as seguintes opções: `navigate`, `reload`, `back-forward`, `back-forward-cache`, `prerender`, `restore`.                              |\n| ttfb_value        | float          | Time to First Byte (TTFB): Mede quanto tempo o navegador espera antes de receber o primeiro byte de dados do servidor.                                                                          |\n| cls_value         | float          | Cumulative Layout Shift (CLS): Avalia a estabilidade visual medindo mudanças inesperadas no layout.                                                                                             |\n| inp_value         | float          | Interaction to Next Paint (INP): Mede quão rapidamente a interface responde a qualquer interação do usuário, capturando a latência até a próxima atualização visual.                            |\n| lcp_value         | float          | Largest Contentful Paint (LCP): Mede o tempo de carregamento do maior elemento visível.                                                                                                         |\n| event_time        | timestamp      | Timestamp de quando este evento foi ingerido (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                  |\n| client_time       | timestamp      | Timestamp do evento do dispositivo do comprador (que pode ser inconsistente, já que compradores podem configurar seus próprios valores de data e hora).                                         |\n| record_created_at | timestamp      | Quando este registro foi criado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                               |\n| record_updated_at | timestamp      | Quando este registro foi atualizado (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX).                                                                           |\n| batch_id          | timestamp      | Identificador usado quando os dados são carregados na tabela para controle de qualidade da ingestão de dados. (Usado exclusivamente para propósitos de avaliação de qualidade interna da VTEX). |\n\n## Análises com navegação\n\nOs dados de navegação podem ser usados para as seguintes análises:\n\n- **Taxa de conversão geral:** Calcular a proporção de sessões que resultaram em uma compra em relação ao número total de sessões para avaliar a eficácia geral do site em converter visitantes em compradores.\n- **Análise do funil de conversão:** Agrupar visualizações de página por estágios do funil e contar quantas sessões passaram por cada estágio, identificando onde os usuários abandonaram sua jornada.\n- **Páginas mais visitadas:** Contar o número de visualizações de página para cada tipo de página (home, categoria, produto) para identificar as páginas que atraem mais atenção e otimizá-las para conversão.\n- **Rastreamento do caminho do usuário:** Seguir a sequência das visualizações de página para cada sessão para entender o caminho percorrido pelo usuário e descobrir padrões de navegação comuns.\n- **Fonte de tráfego:** Analisar a URL de referência de cada sessão para determinar a fonte de tráfego e obter insights sobre quais canais de marketing são mais eficazes.\n- **Taxa de rejeição por tipo de página:** Identificar sessões que terminam após uma única visualização de página e calcular a taxa de rejeição por tipo de página para melhorar o conteúdo ou design dessas páginas.\n\n## Correlações com outros dados\n\nOs dados de navegação da VTEX têm interações significativas com outros conjuntos de dados que enriquecem a análise do comportamento do usuário, por exemplo:\n\n- **Interação com dados de pedidos:** A análise comparativa entre navegação e conversões de pedidos revela o impacto das jornadas do usuário nas decisões de compra.\n- **Relacionamento com SKUs:** A interação do usuário com páginas de produtos e categorias oferece insights sobre a popularidade e eficácia da apresentação de produtos.\n- **Dados de marketing e campanhas:** A correlação entre navegação e campanhas de marketing ajuda a avaliar quão eficientes são as campanhas em atrair tráfego e gerar conversões."}