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.
La Plataforma de Datos Avanzada Klaviyo no está incluida en la aplicación de marketing estándar de Klaviyo, y se requiere una suscripción para acceder a la funcionalidad asociada. Dirígete a nuestra guía de facturación para saber cómo contratar este plan.
Antes de empezar
Esta función solo está disponible para los clientes de la plataforma de datos avanzada de Klaviyo y solo se puede acceder a ella a través del Klaviyo objeto. Para obtener más información sobre el Klaviyo objeto JavaScript y lo que puede hacer, lea la introducción al objeto Klaviyo.
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 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
Vea nuestro vídeo de Klaviyo sobre el uso de la API de pertenencia a grupos.
Instale Klaviyo.js y cargue el objeto KlaviyoInstale Klaviyo.js y cargue el objeto Klaviyo
Primero deberá instalar Klaviyo.js, si aún no lo ha hecho. Klaviyo.js, también conocido como JavaScript activo en el sitio de Klaviyo, ayuda automáticamente al Klaviyo objeto. Si ha habilitado una integración con su cuenta de Klaviyo o ha instalado Klaviyo.js manualmente, podrá iniciar el Klaviyo objeto para escuchar las llamadas relevantes.
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:
- 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.
- Identifique a los usuarios de su sitio a través de un formulario de Klaviyo u otros medios.
- 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ódigoEjemplo 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 sitioImpacto 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.
ResultadoResultado
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 adicionalesRecursos adicionales
Introducción al objeto Klaviyo