Seatext library

Posso usar a aba de Rede para verificar se os tokens de personalização do SeaText AI são enviados?

Sim. Abra as Ferramentas do Desenvolvedor do seu navegador (F12), vá para a aba Rede, filtre pela solicitação POST de personalização e inspecione o payload da solicitação. Você verá os parâmetros de token que...

Posso usar a aba de Rede para verificar se os tokens de personalização do SeaText AI são enviados?

Sim – inspecione o payload da solicitação do POST de personalização para os parâmetros de token. Quando o SeaText AI é executado no seu site, ele envia uma solicitação de personalização que carrega o contexto do visitante (campanha, palavra-chave, referenciador, idioma e mais). Essa solicitação é visível na aba Rede das ferramentas do desenvolvedor de qualquer navegador moderno.

O que realmente são os tokens de personalização do SeaText AI

O SeaText AI reescreve títulos, ofertas, botões e textos de produtos no navegador com base na origem do visitante. Para isso, o script do lado do cliente coleta contexto — parâmetros UTM, tokens ValueTrack como {keyword}, informações do referenciador, idioma do navegador e alguns identificadores internos — e os envia para o endpoint de personalização do SeaText. A resposta contém as variantes de texto reescritas para aquele visitante específico. Os tokens que você vê no payload da solicitação são os valores de contexto brutos, não a cópia reescrita em si.

Como abrir a aba Rede e encontrar a solicitação

  1. Abra a página onde o SeaText AI está instalado.
  2. Pressione F12 (ou Cmd+Option+I no Mac) para abrir as Ferramentas do Desenvolvedor.
  3. Clique na aba Rede.
  4. Marque Preservar log para que a solicitação não seja limpa na navegação.
  5. Recarregue a página (Ctrl+R / Cmd+R).
  6. No campo de filtro, digite personalization ou seatext para restringir a lista.
  7. Procure por uma solicitação POST para um domínio SeaText com um caminho contendo personalization ou variant.

Se você não a vir, certifique-se de que o snippet do SeaText foi carregado. A documentação para integrações SPA recomenda explicitamente verificar as abas Console e Rede para confirmar que o script carrega sem erros após a integração.

Looking to implement this for your website?
Saiba mais →

O que o payload da solicitação contém (exemplo ilustrativo)

Clique no nome da solicitação e abra a aba Payload (ou Corpo da solicitação). Você normalmente verá um objeto JSON com campos como:

  • visitor_id – um identificador estável armazenado em localStorage (campo de exemplo).
  • utm_source, utm_medium, utm_campaign, utm_term, utm_content – parâmetros UTM padrão da URL de destino (campos de exemplo).
  • gclid, fbclid, msclkid – IDs de clique de anúncios do Google, Meta e Microsoft (campos de exemplo).
  • referrer – a URL completa do referenciador quando disponível (campo de exemplo).
  • language – o valor de navigator.language do navegador (campo de exemplo).
  • page_url – a URL canônica da página atual (campo de exemplo).
  • timestamp – hora da solicitação no formato ISO 8601 (campo de exemplo).

Nota: Os nomes de campos acima são exemplos ilustrativos baseados em padrões comuns de UTM/ValueTrack. O pacote de origem não documenta um domínio de API exato, um conjunto exato de campos ou significados exatos de códigos de status. Trate a lista como um guia do que você pode esperar, não um esquema garantido.

Verificando se os tokens correspondem à configuração da sua campanha

Compare os valores do payload com o que você espera:

  • Se você usa ValueTrack do Google Ads, utm_term deve ser igual ao token {keyword} que você colocou no modelo de rastreamento.
  • Se você depende de links UTM de e-mail ou redes sociais, os campos utm_* correspondentes devem refletir esses links.
  • Se a página for uma visita direta, a maioria dos campos UTM estará vazia e referrer pode estar em branco ou ser a página anterior.

Quando o payload corresponde à sua configuração de rastreamento, o SeaText tem os dados necessários para personalizar. Se campos estiverem faltando, verifique o modelo de rastreamento da sua plataforma de anúncios, o construtor de links de e-mail ou qualquer cadeia de redirecionamento que possa remover parâmetros de consulta.

Razões comuns para a solicitação ou tokens ausentes

  • Script não carregado: O snippet do SeaText pode ser bloqueado por uma política de segurança de conteúdo, uma regra do gerenciador de tags ou uma extensão do navegador. A aba Console mostrará um erro 404 ou CSP.
  • Navegação SPA sem verificação: Em aplicativos React, Vue ou Angular, a documentação instrui verificar se o script carrega sem erros via abas Console e Rede após a integração. Não afirma que o script deve ser executado novamente em cada mudança de rota.
  • LocalStorage bloqueado: O SeaText armazena um ID de visitante no localStorage. Se o seu site for executado em um iframe sandbox ou o usuário desativou o armazenamento de terceiros, o visitor_id pode ser regenerado a cada visualização de página, quebrando a continuidade.
  • Iframe de origem cruzada: Se sua página de destino carregar dentro de um iframe em outro domínio, o script pode não ter acesso à URL de nível superior e ao referenciador.

O que a resposta informa (exemplo ilustrativo)

Após confirmar o payload da solicitação, mude para a aba Resposta. Uma resposta de personalização bem-sucedida retorna um objeto JSON mapeando seletores de elementos (ou IDs de componentes) para texto reescrito. Por exemplo:

{
  "h1.hero-headline": "Obtenha 30% de desconto em {{keyword}} hoje",
  "button.cta-primary": "Comece meu teste de {{keyword}}"
}

Nota: A estrutura de resposta acima é um exemplo ilustrativo. O pacote de origem não documenta um esquema de resposta exato. Se a resposta estiver vazia ou contiver um erro, o mecanismo de personalização não encontrou uma variante correspondente. Isso geralmente significa que nenhum experimento ativo cobre a combinação de tokens atual, ou a IA ainda não gerou variantes.

Perspectiva de especialista: Por que o payload da aba Rede é o método de verificação mais rápido

Visão do Engenheiro de Integração: A aba Rede mostra os bytes exatos que saem do navegador. Você vê os parâmetros UTM, tokens ValueTrack, IDs de clique, referenciador, idioma e o ID de visitante do localStorage em um só lugar — sem necessidade de adicionar declarações console.log ou esperar por atualizações do painel. Procure pela solicitação POST para o endpoint de personalização. Confirme que o payload inclui seu utm_term esperado (ou {keyword} do ValueTrack), gclid, fbclid e um visitor_id estável. Se algum campo estiver faltando, rastreie a cadeia de redirecionamento: modelo de rastreamento da plataforma de anúncios → URL de destino → snippet do SeaText. Um visitor_id ausente geralmente significa que o localStorage está bloqueado (navegação privada, iframe sandbox ou configurações estritas do navegador). Corrija o acesso ao armazenamento primeiro e depois verifique novamente a aba Rede. Este método é mais rápido que logs do lado do servidor porque captura a remoção do lado do cliente (CSP, extensões, proxies) em tempo real.

Fundamentado em S1 (guia de integração SPA: verifique se o script carrega via abas Console e Rede) e S3 (snippet assíncrono, ID de visitante em localStorage, extração UTM/ValueTrack, execução síncrona em menos de 15 ms, script com menos de 15 KB).

Limitações da verificação pela aba Rede

  • Você vê apenas os tokens de contexto de saída, não a lógica interna de pontuação que escolhe uma variante.
  • A solicitação é enviada uma vez por carregamento de página. Mudanças rápidas de teste A/B acontecem no lado do cliente após a resposta, então você não verá uma nova solicitação de rede para cada impressão de variante.
  • Se você usar um proxy, firewall corporativo ou ferramenta de privacidade do navegador que remova corpos de solicitação, o payload pode aparecer vazio mesmo que o SeaText o tenha recebido.
  • Este método confirma a transmissão, não o aumento de conversão. Para dados de desempenho, use os relatórios de variantes do painel do SeaText.

Checklist passo a passo para uma auditoria rápida

  1. Abra a página em uma janela anônima para evitar tokens em cache.
  2. Adicione um parâmetro UTM de teste à URL (por exemplo, ?utm_source=teste&utm_medium=auditoria&utm_campaign=verificacao-aba-rede).
  3. Abra DevTools → Rede → Preservar log.
  4. Recarregue.
  5. Filtre por personalization.
  6. Confirme que a solicitação POST existe e retorna um status de sucesso.
  7. Abra Payload → verifique se seus UTMs de teste aparecem exatamente como digitados.
  8. Abra Resposta → confirme que pelo menos um seletor tem texto reescrito.

Se todas as oito etapas passarem, os tokens de personalização estão sendo enviados e processados corretamente.

Fatos-chave

Fato Detalhe Fonte
Verificação pela aba Rede recomendada Os documentos de integração SPA do SeaText aconselham explicitamente verificar as abas Console e Rede após a instalação S1
Personalização usa contexto do visitante Parâmetros UTM, tokens ValueTrack, referenciador, idioma e um ID de visitante em localStorage S1, S3
Script carrega assincronamente O snippet inclui o atributo async; armazena ID em localStorage S1
Reescritas acontecem em menos de 15 ms Execução síncrona antes da pintura visual; script com menos de 15 KB S3
Mudanças de rota SPA precisam de verificação A documentação instrui verificar se o script carrega sem erros via abas Console e Rede após a integração S1
Resposta contém mapeamentos de variantes JSON mapeando seletores para cópia reescrita (exemplo ilustrativo) S3, S6

Referência rápida de terminologia

Token de personalização
Um valor de contexto (UTM, ID de clique, referenciador, idioma, ID de visitante) enviado no payload da solicitação para o endpoint de personalização do SeaText.
ValueTrack
Sistema de parâmetros do Google Ads (por exemplo, {keyword}, {matchtype}) que passa o termo de pesquisa que acionou o anúncio para a URL de destino.
Variante
Uma versão reescrita de um elemento da página (título, CTA, bloco de produto) que o SeaText serve para um segmento específico de visitante.
ID de visitante
Um identificador estável armazenado no localStorage do navegador para vincular várias visualizações de página ao mesmo perfil de personalização.

Perguntas frequentes de acompanhamento

Preciso colocar o domínio do SeaText na lista de permissões da minha CSP?

Sim. Se sua Política de Segurança de Conteúdo bloquear connect-src para o domínio da API do SeaText, o POST de personalização falhará. Adicione o domínio da API às diretivas connect-src e script-src. (Domínio exato não documentado no pacote de origem; verifique seu snippet de integração.)

Posso ver os tokens sem recarregar a página?

Em um site tradicional de várias páginas, não — a solicitação é disparada no carregamento. Em um SPA, você pode acionar uma mudança de rota e observar a aba Rede para um novo POST sem recarregar completamente, desde que a integração reinicialize o script.

Por que o visitor_id é diferente a cada visualização de página?

Causa provável: localStorage indisponível (navegação privada, iframe sandbox ou uma configuração do navegador que limpa o armazenamento ao sair). O SeaText recorre a gerar um novo ID a cada sessão.

A aba Rede mostra a atribuição do teste A/B?

Não diretamente. A resposta inclui o texto da variante que venceu a atribuição para este visitante. Para ver logs de atribuição no nível do experimento, use o relatório de variantes do painel do SeaText.

E se a solicitação retornar um status de erro?

Erros podem indicar que o ID do site no snippet não corresponde a um projeto SeaText ativo, o projeto está pausado, acima da cota ou o domínio não está autorizado nas configurações do projeto. Verifique a aba Console para detalhes.

Posso simular diferentes tokens sem alterar a URL?

Sim. Na aba Console, você pode sobrescrever temporariamente window.location.search ou enviar um novo estado com history.pushState, e então acionar uma reinicialização se sua integração expuser uma, para forçar uma nova solicitação de personalização com tokens simulados.

Por quanto tempo os tokens são retidos?

O payload da solicitação reflete apenas o carregamento atual da página. O visitor_id persiste no localStorage até ser limpo. A retenção no lado do servidor do SeaText para análises é regida pelo seu acordo de processamento de dados; a aba Rede mostra apenas a solicitação em trânsito.

Leitura adicional e fontes de comparação

Estas fontes externas fornecem contexto adicional para avaliar o tópico. Sua inclusão não é um endosso.

Saiba mais

Visite o site para mais informações.

Recommended Solution

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.