Cómo personalizar el contenido in situ con la API de pertenencia a grupos de Klaviyo

Qué aprenderás

Aprenda a utilizar el método getGroupMembership del objeto JavaScript klaviyo, que puede utilizarse para implementar la personalización in situ en su sitio web. Para ello es necesario cargar el objeto klaviyo y pasarle una matriz de listas o segmentos a comprobar, que devolverá un resultado que podrá aprovechar para la personalización in situ.

Antes de empezar

Cuando añade el rastreo in situ de Klaviyo a su sitio, sólo se rastrea la actividad de navegación de los navegadores conocidos de "" (es decir. navegadores que han visitado, se han enganchado y han sido identificados o "cookied"). El seguimiento in situ de Klaviyo no rastrea a los navegadores anónimos. Hay 3 formas clave en las que Klaviyo identificará a un visitante del sitio para el seguimiento in situ:

• Si alguien ha hecho clic a través de un correo electrónico Klaviyo a su sitio web.
• Si alguien se ha suscrito a través de un formulario de Klaviyo.
• Si alguien ha iniciado sesión en su sitio y usted tiene instalado el seguimiento.

Instale Klaviyo.js y cargue el objeto Klaviyo

Primero tendrá que instalar Klaviyo.js, si no lo ha hecho ya. Klaviyo.js, también conocido como JavaScript "activo en el sitio" de Klaviyo, admite automáticamente el objeto klaviyo. Si ha habilitado una integración con su cuenta de Klaviyo o ha instalado Klaviyo.js manualmente, podrá iniciar el objeto klaviyo para escuchar las llamadas pertinentes.

Para utilizar el objeto klaviyo inmediatamente al cargar la página, le recomendamos que instale manualmente el siguiente fragmento en su sitio (además de instalar Klaviyo.js como se ha mencionado anteriormente). El objeto klaviyo sólo necesita cargarse una vez por página.

Para cargar el objeto klaviyo:

Para utilizar el método getGroupMembership del objeto klaviyo JavaScript para la personalización in situ:

1. Dentro de su código, seleccione la lista o los identificadores de segmento para los que desea comprobar la afiliación. El límite es de 50 listas o segmentos.
2. Identifique a los usuarios de su sitio a través de un formulario de Klaviyo u otros medios.
3. Realice una llamada con el siguiente formato, con una matriz de los ID de lista o segmento para los que desea comprobar la afiliación:

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

La salida proporcionada será una matriz de los ID de lista/segmento a los que pertenece el usuario identificado, dado que esos ID estaban en la matriz de entrada. Si se devuelve una matriz vacía, significa que ha pasado demasiados ID, o que el usuario no pertenece a ninguna de las listas o segmentos que ha proporcionado.

Puede utilizar el segmento devuelto y los datos de pertenencia a la lista para personalizar su sitio con productos relevantes, contenido y más basado en segmentos de clientes de Klaviyo.

Ejemplo de código

He aquí un ejemplo que muestra cómo llamar a la API getGroupMembership con varios identificadores de segmento.

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

Impacto en el rendimiento del sitio

La API de pertenencia a grupos tiene un impacto mínimo en el rendimiento de su sitio. El archivo Javascript (es decir, web_personalization.js) que Klaviyo carga en su sitio sólo ocupa unos 1,2KB y la petición de paquete para este archivo no bloquea el hilo principal, por lo que no afecta a la usabilidad de ninguna página.

Los datos que se cargan para personalizar un sitio en función del perfil del cliente se almacenan en caché en el navegador después de ser solicitados por primera vez, por lo que las solicitudes adicionales no requieren llamadas a la API de backend.

Resultado

Ahora puede utilizar el objeto JavaScript klaviyo con herramientas de personalización web y para personalizar el contenido in situ en función de la pertenencia a un segmento o a una lista.

Recursos adicionales

Introducción al objeto Klaviyo

El modelo de datos de Klaviyo

Glosario de términos comunes de la API