Como personalizar o conteúdo no site com a API de associação de grupos da Klaviyo

O que você vai aprender

Saiba como usar o método getGroupMembership do objeto JavaScript do klaviyo, que pode ser usado para implementar a personalização no local em seu site. Para isso, é necessário carregar o objeto klaviyo e passar uma matriz de listas ou segmentos a serem verificados, o que retornará um resultado que pode ser aproveitado para a personalização no local.

Antes de começar

Quando o senhor adiciona o rastreamento no local da Klaviyo ao seu site, somente a atividade de navegação dos navegadores conhecidos "" é rastreada (ou seja, a atividade de navegação dos navegadores conhecidos é rastreada). navegadores que visitaram, se envolveram e foram identificados ou "cookied"). O rastreamento no site da Klaviyo não rastreia navegadores anônimos. Há três maneiras principais de a Klaviyo identificar um visitante do site para rastreamento no local:

• Se alguém clicou em um e-mail da Klaviyo para acessar seu site.
• Se alguém se inscreveu por meio de um formulário da Klaviyo.
• Se alguém tiver feito login no seu site e o senhor tiver instalado o rastreamento.

Instale o Klaviyo.js e carregue o objeto Klaviyo

Primeiro, o senhor precisará instalar o Klaviyo.js, caso ainda não o tenha feito. O Klaviyo.js, também conhecido como JavaScript "Active on Site" do Klaviyo, suporta automaticamente o objeto klaviyo. Se o senhor tiver ativado uma integração com sua conta Klaviyo ou instalado o Klaviyo.js manualmente, poderá iniciar o objeto klaviyo para ouvir as chamadas relevantes.

Para usar o objeto klaviyo imediatamente no carregamento da página, recomendamos instalar manualmente o snippet abaixo em seu site (além de instalar o Klaviyo.js, conforme mencionado acima). O objeto klaviyo só precisa ser carregado uma vez por página.

Para carregar o objeto klaviyo:

Para usar o método getGroupMembership do objeto JavaScript do klaviyo para personalização no site:

1. Em seu código, selecione a lista ou as IDs de segmento para as quais deseja verificar a associação. O limite é de 50 listas ou segmentos.
2. Identifique os usuários do seu site por meio de um formulário do Klaviyo ou por outros meios.
3. Faça uma chamada no formato a seguir, com uma matriz da lista ou IDs de segmento para os quais o senhor deseja verificar a associação:

klaviyo.getGroupMembership(['listID1', 'listID2', 'listID3'])

A saída fornecida será uma matriz de IDs de lista/segmento à qual o usuário identificado pertence, uma vez que esses IDs estavam na matriz de entrada. Se uma matriz vazia for retornada, isso significa que o usuário passou muitos IDs ou que o usuário não pertence a nenhuma das listas ou segmentos que o senhor forneceu.

O senhor pode usar o segmento retornado e os dados de associação à lista para personalizar seu site com produtos relevantes, conteúdo e muito mais com base nos segmentos de clientes da Klaviyo.

Exemplo de código

Aqui está um exemplo que mostra como chamar a API getGroupMembership com várias IDs de segmento.

const customerSegments = await Klaviyo.getGroupMembership([
  VIPSegmentID,
 UnEngagedSegmentID,
 DogLoversSegmentID
]);

Impacto no desempenho do site

A API de associação de grupos tem um impacto mínimo no desempenho do site. O arquivo Javascript (ou seja, web_personalization.js) que o Klaviyo carrega em seu site tem apenas cerca de 1,2 KB e a solicitação de pacote para esse arquivo não bloqueia o thread principal, portanto, não afeta a usabilidade de nenhuma página.

Os dados que são carregados para personalizar um site com base no perfil do cliente são armazenados em cache no navegador após a primeira solicitação, de modo que as solicitações adicionais não exigem chamadas de API de backend.

Resultado

Agora, o senhor pode usar o objeto JavaScript klaviyo com ferramentas de personalização da Web e personalizar o conteúdo no site com base no segmento ou na associação à lista.

Recursos adicionais

Introdução ao objeto Klaviyo

Modelo de dados da Klaviyo

Glossário de termos comuns de API