Como configurar a ID primária

O que você vai aprender

Saiba como configurar o First-Party ID para melhorar sua capacidade de identificar visitantes que retornam. O First-Party ID usa um cookie do lado do servidor para estender a identificação, ajudando você a reconhecer mais compradores que retornam, atribuir mais eventos no site e impulsionar automação de marketing mais direcionada

Como o First-Party ID funciona?

O rastreamento padrão da Klaviyo define um cookie chamado __kla_id no navegador do visitante usando JavaScript (leia mais aqui). Em navegadores como Safari e Firefox, as proteções de privacidade limitam por quanto tempo esse cookie permanece. Quando ele expira, a Klaviyo não consegue mais reconhecer o visitante como um perfil conhecido até que ocorra outro evento de identificação.

O First-Party ID resolve isso ao executar um worker do Cloudflare em um subdomínio do seu próprio domínio. Esse worker define um cookie de longa duração, definido pelo servidor, chamado __kle_id. Quando o seu __kla_id atual expira, a Klaviyo usa o __kle_id para renová-lo, identificando novamente o visitante e atribuindo a sessão ativa no site ao perfil conhecido correto. Se o worker ficar indisponível em algum momento, a Klaviyo volta automaticamente ao comportamento padrão do __kla_id (Klaviyo Javascript), para que nenhum dado seja perdido.

• Observação: o First-Party ID não identifica visitantes totalmente novos. Um cliente já precisa ter um perfil Klaviyo — criado por meio de uma inscrição, clique em e-mail rastreado ou outro evento de identificação — para que o First-Party ID possa identificá-lo novamente em uma visita de retorno.

Duração do tempo de vida do cookie

Quando um visitante é identificado, o cookie da Klaviyo (__kla_id) é definido para durar até 2 anos, mas a duração varia de acordo com as políticas de vida útil de cookies de cada navegador — o que depende de como o cookie é definido no navegador. O __kla_id geralmente é definido usando o Javascript da Klaviyo, que coloca o cookie no lado do cliente. Se o ID estendido ou o ID primário estiverem ativados, o cookie da Klaviyo será definido, respectivamente, no lado do cliente e no lado do servidor. Saiba mais sobre como ativar esses recursos da Klaviyo para ajudar a reidentificar usuários. Saiba como configurar a ID estendida.

A duração padrão do cookie __kla_id — por quanto tempo ele dura antes de a ID primária precisar atualizá-lo — varia conforme o navegador. Informações mais detalhadas podem ser encontradas neste CookieStatus.

• A duração do cookie varia conforme o navegador e depende se o cookie é definido no lado do cliente por JavaScript ou no lado do servidor. A tabela abaixo mostra as duas opções.

Como ativar a ID primária

O First-Party ID exige um subdomínio dedicado no seu domínio que aponte para a conta da Klaviyo no Cloudflare. A Klaviyo fornece os registros de DNS necessários.

• Clique no menu da conta no canto inferior esquerdo da sua conta Klaviyo.
• Selecione Configurações no menu.

• Navegue até a aba Dados
• Na seção de ID primário, clique em “Configurar”.
• Confirme se o domínio pré-preenchido está correto. Caso não esteja, insira o domínio raiz (ou seja, example.com) da sua loja e clique em “Próximo”.

• Para configurar seu subdomínio, você pode escolher usar a Entri para fornecer alguns detalhes e deixar que ela configure o subdomínio automaticamente para você. Como alternativa, você pode optar por configurar o subdomínio manualmente pelas configurações do seu provedor de DNS.

• Se selecionar Entri
  • Clique em Conectar com a Entri e em Continuar

• O Entri detectará automaticamente o provedor de DNS do seu domínio e solicitará algumas informações, incluindo os dados de login. Siga as instruções na tela e o Entri adicionará automaticamente o subdomínio aos seus registros de DNS.

• Se você selecionar manual
  • Copie e cole o registro CNAME exibido na sua tela no seu provedor de DNS.

• Clique em Verificar

• A configuração agora está concluída, e o sistema da Klaviyo levará até 48 horas para verificar se o subdomínio está começando a receber tráfego corretamente. Você receberá um e-mail quando o subdomínio terminar de ser verificado e o First-Party ID estiver em execução!

Estados do status do subdomínio

O status do meu subdomínio mostra falha

O status Erro significa que a Cloudflare detectou um problema na configuração do seu subdomínio. Causas comuns:

• O registro CNAME está ausente ou apontando para o destino incorreto.
• O registro de DNS foi adicionado, mas não foi totalmente propagado (em casos raros, pode levar até 48 horas).
• O destino CNAME fornecido pela Klaviyo foi inserido incorretamente.

Para resolver: dependendo do problema, você receberá um e-mail com instruções relacionadas a esse problema. Em geral, você precisará verificar se seus registros de DNS correspondem exatamente ao que foi exibido no fluxo de configuração e, em seguida, clicar em Reconfigurar nas configurações do ID primário. Se o problema persistir, entre em contato com o suporte da Klaviyo.

Desativar a ID primária

Para desativar a ID primária:

1. Clique no menu da conta no canto inferior esquerdo da sua conta Klaviyo.
2. Selecione Configurações no menu.
3. Navegue até a aba Dados.
4. Na seção First-Party ID, clique no botão desativar.

Como medir o impacto da ID primária

Para ver o impacto do First-Party ID na capacidade da sua marca de identificar visitantes, você pode aproveitar o evento Com atividade no site.

1. Navegue até Analytics —> Métricas —> Active on Site.
   
2. Adicione o filtro By —> ssc_refresh.

Isso demonstra o número de eventos adicionais de com atividade no site que foram capturados devido ao First Party ID. Os eventos de First Party ID têm um valor de 1,0 (ou seja, verdadeiro), enquanto os eventos capturados com o rastreamento padrão de cookie da Klaviyo ou Extended ID têm um valor de 0,0 (ou seja, falso).

O ID primário está com atividade, mas não estou vendo a propriedade ssc_refresh em Com atividade no site

A flag ssc_refresh só é definida em eventos que foram capturados após uma reidratação do worker bem-sucedida. Se nenhum visitante tiver retornado ao seu site depois que o __kla_id expirou, ainda não ocorreu nenhum evento ssc_refresh.

Como funciona a atribuição da ID primária

A Klaviyo rastreia eventos no site "atribuídos" — sessões em que o First-Party ID conseguiu identificar novamente um comprador que retornou após o vencimento do __kla_id. Um evento atribuído significa:

• O visitante já tinha um perfil da Klaviyo (criado via cadastro, clique em e-mail, envio de formulário etc.).
• O cookie __kla_id dele expirou entre as visitas.
• Eles voltaram ao seu site e o worker retornou a identidade armazenada deles em __kle_id.
• A Klaviyo restaurou __kla_id e colocou tag na sessão com ssc_refresh = 1.0.
  • O sinalizador ssc_refresh é definido exatamente no momento em que o worker reidrata __kla_id com sucesso. É quando a atribuição é registrada.
• Todos os eventos onsite subsequentes nessa sessão (visualizações de página, adicionado ao carrinho etc.) são atribuídos ao perfil conhecido.

Perguntas comuns sobre como configurar o First-Party ID

Respostas para o que os clientes mais perguntam ao colocar o First-Party ID em funcionamento:

1. O First Party ID usa fingerprinting e pode reidentificar em vários dispositivos?
   1. O First-Party ID não usa fingerprinting, identificadores probabilísticos, endereços IP, dados do dispositivo, IDs de clique nem strings de user agent.
   2. A reidentificação em vários dispositivos ou navegadores não é compatível.
2. O First-Party ID se integra a CAPIs?
   1. O First-Party ID não se integra a APIs de conversão (CAPIs).
3. É possível usar mais de um domínio em uma conta da Klaviyo com ID primário?
   1. Cada domínio só pode ser atribuído ao First-Party ID em uma conta do Klaviyo. Se a mesma URL for compartilhada em várias contas de portfólio (por exemplo, uma vitrine dos EUA e outra do Canadá no mesmo domínio), você só poderá ativar o First-Party ID em uma delas.
4. Quanto tempo demora a configuração de DNS?
   1. Normalmente leva apenas alguns minutos depois que o registro CNAME é adicionado, mas pode levar até 48 horas, dependendo do seu provedor de DNS. Se você ficar em DNS pendente por mais de 60 minutos, confirme a propagação com uma ferramenta como dnschecker.org.
5. Posso usar o mesmo domínio em mais de uma conta da Klaviyo?
   1. Não. Um domínio só pode ser atribuído ao First-Party ID em uma única conta da Klaviyo e não pode ser reutilizado em outras contas do portfólio — mesmo que duas contas compartilhem o mesmo URL (por exemplo, uma vitrine dos EUA e do Canadá no mesmo domínio).
6. Preciso atualizar minha Política de Privacidade antes de ativar o First-Party ID?
   1. Se você optar por ativar a ID primária, é altamente recomendável reenviar seus avisos de cookies aos clientes e revisar seus Termos de Serviço e/ou Aviso de Privacidade para garantir que seus clientes sejam notificados sobre processos de reidentificação. O cookie da Klaviyo vai expirar, mas o First-Party ID oferece reidentificação por meio de um recurso de cookie do lado do servidor que permite atualizar o cookie da Klaviyo diretamente do seu próprio domínio.
   2. Leia mais sobre o Aviso de Privacidade,Aviso de cookies e Consentimento no artigo Como entender os cookies na Klaviyo .
7. Ainda preciso da ID estendida se eu configurar a ID primária?
   1. Os dois funcionam juntos, em vez de um substituir o outro. Quando ambos estão ativados, o First-Party ID tem prioridade, e o Extended ID continua capturando visitantes que o First-Party ID ainda não alcançou.
8. Isso vai prejudicar meu rastreamento se algo der errado durante a configuração?
   1. Não. Se o worker ficar indisponível a qualquer momento, o Klaviyo volta automaticamente ao comportamento padrão de __kla_id. Nenhum dado é perdido.
9. Quanto tempo depois de ativar vou ver eventos atribuídos ao First-Party ID?
   1. Isso depende da combinação de navegadores do seu tráfego. O First-Party ID só pode atualizar __kla_id quando um cookie existente expira e o visitante retorna. Então, verifique novamente em 3 semanas para um sinal inicial e, depois, novamente em cerca de 2 meses para um impacto mais consolidado.
10. Acabei de habilitar a ID primária. Por que ainda não estou vendo nenhum evento atribuído?
    1. Isso é esperado. O First-Party ID só pode atualizar __kla_id quando o __kla_id existente de um visitante expirar e ele voltar ao seu site. O cronograma depende do navegador. Volte em 3 semanas para ter um sinal inicial, principalmente do tráfego do Safari. A atribuição é construída gradualmente à medida que os cookies existentes expiram e os compradores retornam.
11. Tenho a ID estendida ativada e ativei a ID primária. Por que os eventos atribuídos à ID primária são menores do que os eventos atribuídos à ID estendida?
    1. Isso é esperado, especialmente nas primeiras semanas. O Extended ID pode ter atualizado recentemente o __kla_id para muitos compradores, o que significa que esses cookies ainda têm tempo restante no TTL antes que o First-Party ID possa assumir.
    2. O pipeline para obter uma atribuição de First-Party ID exige três coisas em sequência: evento de identificação → expiração do __kla_id → visita de retorno. Ainda estamos esperando essas expirações serem processadas.
    3. Com o tempo, a atribuição deve mudar: eventos atribuídos à ID estendida tendem a cair à medida que a ID primária cresce. O principal sinal a observar: eventos atribuídos à ID primária devem crescer mais do que a queda de eventos atribuídos à ID estendida — isso confirma identificação líquida nova, não apenas deslocamento.

Recursos adicionais