Coloque a Personyze rodando em minutos.
Um recurso passo a passo para desenvolvedores e times técnicos — instale o código de rastreamento, defina placeholders de conteúdo, configure metas e conecte sua stack de dados.
Começar agora →1Instale a Personyze no seu site
Para habilitar a personalização, você precisa instalar o snippet de rastreamento em cada página do seu site. Escolha o método que se ajusta à sua plataforma.
Opção 1: Google Tag Manager (GTM)
Opção A: HTML personalizado (manual)
Crie uma tag “Custom HTML”, cole o snippet JS completo da Personyze e dispare em “All Pages”.
Opção B: integração com template (a mais fácil)
Busque na Community Gallery do GTM por “Personyze Tracking Code”. Adicione, insira seu Site ID e dispare em “All Pages”. Isso mantém seu container limpo.
Opção 2: HTML padrão
Cole o snippet diretamente na <head> tag do seu arquivo de template master. Garanta que ele esteja o mais alto possível, imediatamente após as meta tags charset e viewport.
Opção 3: instruções para CMS
theme.liquid. Cole o código antes de </head>.header.ftl template.2Definir placeholders (zonas)
Placeholders são áreas no seu site onde a Personyze injeta conteúdo. Usar placeholders em vez de popups faz com que a personalização pareça nativa.
Opção A: o seletor visual (no-code)
- Crie uma nova campanha e adicione uma ação “Banner”.
- Em Configurações de exibição, escolha “Show in placeholder”.
- Clique “Find on pages” para abrir o simulador.
- Navegue pelo seu site e simplesmente clique no elemento (p. ex., Hero Banner) que você quer transformar em uma zona.
Opção B: seletores CSS manuais
Insira manualmente IDs ou Classes como #home-hero ou .sidebar-widget.
Máximo de ações simultâneas: Permite empilhar vários banners verticalmente (p. ex., mostrar o Banner A E o Banner B).
3Metas de conversão e rastreamento de KPIs
Acompanhe o ROI definindo como é o sucesso. Você pode rastrear cliques simples ou dados complexos de receita.
1. Tipos de meta
- URL de destino: Disparada quando o usuário visita uma URL específica como
/thank-youou/order-confirmed. Melhor para geração de leads. - Rastreie a atividade: Acompanhe interações específicas como clicar em “Add to Cart”, passar o mouse sobre um menu ou assistir a um vídeo. Use o Seletor visual para escolher o elemento.
- Capturar dados (receita): Extraia valores dinâmicos (p. ex., “$150.00”) do HTML da página ou de um cookie. Essencial para calcular ROI e Receita.
- Eventos externos: Capture automaticamente eventos enviados ao Data Layer do GTM ou eventos do Google Analytics sem configuração extra.
2. Configurações avançadas
- Valor da meta: Configure um Valor fixo (p. ex., Lead = $10) ou um Valor dinâmico (capturado da página, como Total da compra).
- Frequência: Defina “Once per visit” para leads (para evitar contagens duplicadas no refresh) ou “No Limit” para compras (para rastrear cada transação).
3. Métricas de e-commerce
Se você habilitar o rastreamento de produto/receita, a Personyze calcula automaticamente Receita total, AOV (valor médio do pedido) e Taxa de contribuição (quanto da receita foi influenciado pela personalização).
4Extrair dados do site (variáveis)
Aperfeiçoe a segmentação “capturando” dados do navegador do visitante ou da sessão da página para construir um perfil de usuário rico.
Fontes de dados suportadas
Você pode criar uma “Variável de perfil de usuário” a partir de qualquer uma destas fontes:
- Elementos da página (HTML): Extraia texto visível na página (p. ex., “Olá, [Nome]” ou “Pontos: 500”). Use o Seletor visual.
- Cookies: Leia valores armazenados em cookies do navegador (p. ex.,
login_status,affiliate_id). - Variáveis JavaScript: Leia variáveis globais de JS (p. ex.,
window.userLeveloudataLayer[0].userId). - Meta tags: Leia meta tags de SEO para entender o contexto do conteúdo (p. ex.,
<meta name="author" content="John">). - Parâmetros de URL: Leia UTMs ou query strings (p. ex.,
?campaign=summer_sale).
5CRM interno e integração de dados
Conecte seus bancos de dados internos (CRM personalizado, SQL, ERP) com comportamento do site em tempo real.
Métodos de integração:
- Upload de CSV: Faça upload manual de listas de IDs de usuário + atributos (status VIP, setor, compras offline).
- Feed ao vivo: Sincronize via uma URL do Google Sheet ou um feed HTTP que atualiza automaticamente.
- API: Use a API da Personyze para enviar atualizações de usuário em tempo real do seu backend.
6Feed de produtos e conteúdo
Isso é necessário para executar Recomendações de produto E Recomendações de artigos/conteúdo.
1. Prepare seu feed
A Personyze aceita CSV, XML, JSON, RSS, Atom ou feeds do Google Merchant.
2. Mapeie suas colunas
Vá para Configurações > Dados e conteúdo > Feed de produtos. Você precisa mapear os campos do seu feed para os atributos da Personyze:
- ID interno: DEVE coincidir com o ID de produto/artigo encontrado na sua página ao vivo (SKU/ID) ou variável do GTM. Isso permite que a Personyze saiba qual item o usuário está vendo no momento.
- Título: O nome do produto ou artigo.
- URL da imagem: Para exibir nos widgets de recomendação.
- URL do link: Para onde o clique da recomendação leva.
- Preço / Categoria: Para filtragem e lógica.
Métodos alternativos
- Site Crawler: Se você não tem um feed, contate seu account manager para configurar um crawler que constrói o feed do seu site automaticamente.
- Upload por SFTP: Para catálogos enterprise grandes, peça ao seu account manager para habilitar o upload seguro via SFTP.
7Privacidade e opt-out
Garanta conformidade com GDPR/CCPA integrando com sua Consent Management Platform (CMP).
API JavaScript:
Use esses comandos dentro da lógica “Accept” ou “Decline” do seu banner de cookies:
_S_T.system.off(): Parar rastreamento. Chame isso se um usuário recusar cookies. Nenhum dado será enviado._S_T.system.on(): Iniciar rastreamento. Chame isso quando um usuário aceitar cookies._S_T.system.is_on(): Retornatrue/falsepara checar o status atual.
Modo estrito: Você pode configurar a Personyze para rodar em “Modo estrito”, onde ela não rastreia IPs ou PII por padrão até que o consentimento explícito seja dado via o comando acima.
8Integrações de terceiros
Integrações plug-and-play com as ferramentas que você já usa. Para acessar, vá em: Configurações > Integrações.
Analytics e dados
Envie dados de audiência e campanhas da Personyze para suas ferramentas de analytics para relatórios.CRM e marketing
Sincronização bidirecional de leads e atributos de usuário entre a Personyze e seu CRM.ABM e dados B2B
Enriqueça tráfego anônimo com dados de Nome da Empresa, Setor e Receita.Infraestrutura
Conecte sistemas backend, autenticação e automação de workflows.9Configuração do remetente de e-mail
Configure como a Personyze envia seus e-mails disparados e newsletters.
Opção A: remetente padrão (Amazon SES)
Por padrão, a Personyze usa Amazon SES. Você pode autorizar seu próprio endereço “From” (p. ex., info@seudominio.com).
- Adicione o e-mail desejado nas configurações da Personyze.
- Você receberá uma solicitação de verificação da AWS.
- Recomendação: Contate seu account manager para obter registros DKIM para subir no seu DNS e melhorar a entregabilidade.
Opção B: SMTP personalizado
Use seu próprio servidor de e-mail (SendGrid, Mailgun, Outlook, etc.) para controle total.
- Selecione “Mail provider (SMTP)”.
- Insira seu host, porta (p. ex., 465 ou 587), usuário e senha.
Opção C: webhook (HTTP POST)
Envie o payload de dados de e-mail para seu próprio endpoint ou ferramenta de automação (como o Zapier) para disparar o envio externamente.
10Configuração de notificações web push
Para habilitar notificações push do navegador, você precisa instalar um Service Worker.
1. Baixe o Service Worker
Baixe o arquivo padrão: sw.js
2. Instale no seu servidor
- Cenário A (sem Service Worker existente): Suba o arquivo `sw.js` para o diretório raiz do seu site (p. ex., `seusite.com/sw.js`).
- Cenário B (você já tem um Service Worker): NÃO sobrescreva seu arquivo. Em vez disso, peça ao seu desenvolvedor para mesclar o conteúdo do nosso `sw.js` no topo do seu arquivo service worker existente.
Nota: cada site só pode ter um arquivo Service Worker ativo.
11REST API da Personyze
Integre a Personyze de forma programática com seus sistemas backend para ler ou escrever dados.
Capacidades
- Dados de usuário: Envie dados de CRM ou atualize perfis de usuário.
- Conteúdo: Atualize seu catálogo de produtos ou conteúdo.
- Eventos: Reporte conversões offline ou eventos do backend.
12SDK mobile (iOS e Android)
Estenda a personalização para seus aplicativos mobile nativos.
Recursos
- Perfil unificado: Acompanhe usuários entre Web e App.
- Segmentação nativa: Use comportamentos específicos do app para segmentação.
- Notificações push: Dispare alertas personalizados.
13Single Sign-On (SSO)
Gerencie o acesso ao painel da Personyze usando seu provedor de identidade enterprise.
Gerenciamento centralizado de usuários, acesso com um clique para funcionários e conformidade de segurança aprimorada.
Provedores suportados
- Auth0
- Okta
- OneLogin
- Xecurify
Instruções de configuração
- Vá para Configurações > Integrações > Single Sign On no console da Personyze.
- Selecione seu provedor da lista.
- Insira a URL de Metadata ou os detalhes do Certificado requeridos do seu IdP.
- Salve e teste a conexão.
Perguntas de configuração, respondidas.
O que os times perguntam antes de ir ao ar. Para qualquer outra coisa, nossa equipe está a uma mensagem de distância.
O código de rastreamento vai deixar meu site mais lento?
Não. A tag da Personyze carrega de forma assíncrona, ou seja, roda em segundo plano e não bloqueia o renderizado do conteúdo principal da página. Isso garante impacto insignificante na velocidade do site ou nos Core Web Vitals.
Posso instalar via Google Tag Manager?
Sim. Esse é o método recomendado. Você pode usar nosso template oficial do GTM (busque “Personyze”) ou criar uma tag HTML personalizada. Apenas garanta que a tag dispare em “All Pages”.
A Personyze é compatível com GDPR?
Sim. Oferecemos ferramentas para ajudar você a cumprir, incluindo um “Modo estrito” que desabilita o rastreamento até que o consentimento seja dado. Você também pode disparar o rastreamento apenas depois que um usuário aceitar cookies via sua CMP (Consent Management Platform).
Como sincronizo meu catálogo de produtos?
Você pode subir um Product Feed (CSV, XML, JSON) ou sincronizar diretamente do Google Merchant Center. Se você não tem um feed, nosso Site Crawler pode extrair automaticamente dados de produto das suas páginas.
E se eu tiver uma Single Page Application (SPA)?
A Personyze suporta totalmente SPAs (React, Angular, Vue). Nosso tracker detecta automaticamente “virtual pageviews” quando a URL muda sem um reload completo, garantindo que o comportamento seja rastreado corretamente ao longo da sessão.
Posso rastrear usuários entre dispositivos?
Sim. Se um usuário fizer login no Desktop e no Mobile (ou clicar em um link de e-mail em ambos), a Personyze mescla os perfis dele usando um identificador único (como User ID ou Email Hash), dando uma visão unificada da jornada.
Preciso de um desenvolvedor para configurar metas?
Não necessariamente. Metas simples como “URL Visits” ou “Button Clicks” podem ser configuradas usando nossa interface visual. Metas mais complexas, como capturar valores dinâmicos de receita, podem exigir saber o seletor CSS ou o nome da variável JavaScript.
Como funciona a integração com o CRM?
Sincronizamos os dados de forma bidirecional. Você pode enviar comportamento do site (p. ex., “Visitou a página de preços”) para seu CRM, e trazer atributos do CRM (p. ex., “Cliente VIP”) para a Personyze para personalizar a experiência do site.
Posso usar meu próprio remetente de e-mail?
Sim. Embora forneçamos um remetente padrão via Amazon SES, você pode configurar seu próprio servidor SMTP (SendGrid, Mailgun, Outlook) nas configurações para garantir que os e-mails venham do seu próprio domínio com controle total de entregabilidade.
O que acontece se eu mudar o tema do meu site?
Se você muda a estrutura HTML (IDs ou Classes CSS), alguns placeholders ou regras “grab data” podem quebrar. Recomendamos verificar suas campanhas da Personyze após qualquer redesign importante do site para garantir que os seletores ainda sejam válidos.
Posso excluir tráfego interno?
Sim. Você pode filtrar tráfego de endereços IP específicos (como o IP do seu escritório) nas configurações da conta para que visitas de funcionários não distorçam seus dados de analytics.
O rastreamento funciona offline?
Para rastreamento web, é necessária uma conexão à internet. Porém, se você usa nosso SDK mobile, podemos armazenar eventos localmente no dispositivo e sincronizá-los quando o usuário voltar a ficar online.
Quão segura é a transferência de dados?
Todos os dados são transmitidos via criptografia HTTPS. Aderimos a protocolos de segurança rigorosos, incluindo conformidade com SOC 2, para garantir que os dados dos seus clientes permaneçam seguros.
Posso gerenciar vários domínios em uma única conta?
Sim. A Personyze suporta rastreamento multi-domínio. Você pode gerenciar sites separados em uma única conta ou vinculá-los para compartilhar dados de usuário entre domínios diferentes (Cross-Domain Tracking).
O que é um “Service Worker” para notificações push?
Um Service Worker é um script que roda em segundo plano no navegador. É necessário para receber mensagens push mesmo quando o usuário não está ativamente no seu site. Você precisa subir esse arquivo para o diretório raiz do seu servidor.
Coloque a personalização ao vivo no seu site.
Você tem o playbook completo de configuração — agora coloque-o em prática. Instale o tracker, defina seu primeiro placeholder e veja seu site se adaptar a cada visitante.