Pular para o conteúdo principal

Introdução

Registre o que seus usuários e convidados fazem e transforme isso em experiências personalizadas.

Mais informações sobre a interface do usuário do módulo https://doc.oneentry.cloud/docs/category/useractivity

🎯 O que este módulo faz?​

O módulo UserActivity permite que você monitore eventos de atividade para o usuário ou convidado atual - visualizações de produtos, visualizações de páginas, pesquisas, ações no carrinho e na lista de desejos, compras e avaliações.

Pense nisso como o sinal de análise por trás da personalização - os eventos que você envia alimentam o motor de recomendação do OneEntry, que impulsiona blocos como recomendações pessoais, recentemente visualizados, compra repetida e tendências.

📖 Explicação Simples​

Toda vez que um visitante faz algo significativo, você registra um evento:

  • 👀 Visualização de produto - o visitante abriu uma página de produto
  • 📄 Visualização de página / categoria - o visitante navegou por uma página ou categoria
  • 🔎 Pesquisa - o visitante pesquisou algo
  • 🛒 Ações no carrinho / lista de desejos - itens adicionados ou removidos
  • 💰 Compra - o visitante comprou um produto
  • ⭐ Avaliação - o visitante avaliou um produto

O OneEntry usa esse fluxo de eventos para entender cada visitante e personalizar o que eles veem.

✨ Conceitos Chave​

Funciona para usuários e convidados​

A atividade está ligada ao contexto atual: um usuário autorizado (via o módulo AuthProvider) ou um convidado. Para convidados, o SDK envia um cabeçalho x-guest-id para que os eventos sejam atribuídos ao visitante anônimo correto. Veja Modo convidado para mais detalhes.

Tipos de eventos​

O tipo do evento é um dos valores de um conjunto fixo: product_view, page_view, category_view, search, product_add_to_cart, product_remove_from_cart, product_add_to_wishlist, product_remove_from_wishlist, product_purchase, product_rating.

📋 O que você precisa saber​

  • Envie o evento que corresponde à ação: inclua productId para eventos de produto, pageId para visualizações de página/categoria e query para pesquisas.
  • O campo meta aceita dados arbitrários (bloco de origem, variante A/B, profundidade de rolagem) para suas próprias análises.
  • trackUserActivity() resolve para true em caso de sucesso - é um método de disparo e esquecimento e não deve bloquear a interface do usuário.

📊 Tabela de Referência Rápida​

MétodoDescrição
trackUserActivity()Registre um evento de atividade de usuário ou convidado

❓ Perguntas Comuns (FAQ)​

Preciso autorizar o usuário para rastrear a atividade?​

Não. A atividade é registrada para o contexto atual - um usuário autorizado ou um convidado. No navegador, o SDK gera e persiste um id de convidado automaticamente; no servidor, passe um guestId por visitante.

Para que serve o campo meta?​

meta é um objeto de formato livre para qualquer informação extra que você queira anexar a um evento, como o bloco de origem, uma variante de teste A/B ou profundidade de rolagem.

🎓 Melhores Práticas​

  • Rastreie eventos à medida que acontecem, mas não bloqueie a renderização na chamada de rede.
  • Envie productId / pageId / query que correspondam ao tipo do evento.
  • Mantenha os ids de convidados estáveis para que a atividade de um convidado seja consistente entre as requisições.

Definição do módulo UserActivity​


const { UserActivity } = defineOneEntry(
  "sua-url-do-projeto", {
    "token": "seu-token-de-aplicativo"
  }
);

🔗 Documentação Relacionada​