Cómo personalizar el contenido in situ con la pertenencia a grupos de Klaviyointerfaz de programación de aplicaciones (API)

Objetivos de aprendizaje

Aprende a utilizar el método Klaviyo método getGroupMembership del objeto JavaScript, que puede utilizarse para implementar la personalización in situ en tu sitio web. Esto requiere cargar el objeto Klaviyo y pasar un array de lista o segmento para comprobar, que devolverá una salida que puedes aprovechar para la personalización in situ.

Antes de empezar

Cuando añades el seguimiento in situ de Klaviyo a tu sitio web, sólo se rastrea la actividad de navegación de los navegadores conocidos de "" (es decir. navegadores que han visitado, con interacciones, y han sido identificados o "cookied"). Klaviyo's onsite seguimiento no rastrea a los navegadores anónimos. Hay 3 formas principales en las que Klaviyo identificará a un visitante del sitio para el seguimiento in situ:

• Si alguien ha hecho clic en un correo electrónico de Klaviyo para acceder 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 tiene instalado el seguimiento

Consulta nuestro Klaviyo vídeo de sobre el uso de la interfaz de programación de aplicaciones (API) de pertenencia a grupos.

Instala Klaviyo.js y carga el objeto Klaviyo

Primero deberá instalar Klaviyo.js, si aún no lo ha hecho. Klaviyo.js, también conocido como Active on Site JavaScript de Klaviyo, es compatible automáticamente con 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 relevantes.

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

Para cargar el Klaviyo objeto:

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

1. Dentro de tu código, selecciona la lista o los identificadores de segmento para los que quieras comprobar la afiliación. El límite es 50 lista o segmento.
2. Identifica a los usuarios de tu sitio mediante un formulario Klaviyo u otros medios.
3. Haz una llamada con el siguiente formato, con una matriz de los ID de lista o segmento para los que quieras 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 has introducido demasiados ID, o que el usuario no pertenece a ninguna de las listas o segmentos que has proporcionado.

Puedes utilizar el segmento devuelto y los datos de afiliación de la lista para personalizar tu sitio con productos relevantes, contenido y mucho más basándote en el segmento de clientes de Klaviyo.

Ejemplo de código

Aquí tienes un ejemplo que muestra cómo llamar a la interfaz de programación de aplicaciones (API) getGroupMembership con varios ID de segmento.

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

Impacto en el rendimiento del sitio

La interfaz de programación de aplicaciones (API) de pertenencia a grupos tiene un impacto mínimo en el rendimiento de tu sitio. El archivo Javascript (es decir, web_personalization.js) que Klaviyo carga en tu sitio sólo ocupa unos 1,2 KB 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 tras ser solicitados por primera vez, de modo que las solicitudes adicionales no requieren llamadas a la interfaz de programación de aplicaciones (API) del backend.

Resultado

Ahora puedes utilizar el objeto Klaviyo objeto JavaScript con herramientas de personalización web y para personalizar el contenido del sitio en función de la pertenencia a un segmento o lista.

Recursos adicionales

Introducción al objeto Klaviyo

Modelo de datos de Klaviyo

Glosario de términos comunes de la interfaz de programación de aplicaciones (API)

Utiliza Klaviyo's group membership interfaz de programación de aplicaciones (API)