API de JavaScript
La siguiente guía le guiará a través de la configuración y el uso de la API JavaScript. Si está planeando una integración completa de comercio electrónico, consulte esta guía.
Nota
Para utilizar los fragmentos de Klaviyo que se proporcionan a continuación, deberá actualizar el marcador de posición de API_KEY con su clave pública de API, que puede encontrar aquí.
Añadir el fragmento Klaviyo
Para empezar a realizar un seguimiento de las personas, añada el siguiente fragmento a la derecha en la plantilla principal de su sitio web para que se añada automáticamente a todas las páginas de su sitio web. Si tiene un desarrollador que añada este script a su sitio web, puede enviarle un enlace a esta guía.
Necesita hacer un cambio en el fragmento. Si se dedica al comercio electrónico, elimine las cuatro líneas con la llamada "identify". Si se trata de un sitio web o una aplicación web en la que la gente inicia sesión, sustituya el marcador de posición de correo electrónico {{ email }} por la variable de plantilla adecuada que tenga la dirección de correo electrónico del usuario que ha iniciado sesión.
Sugerimos poner el código Klaviyo en o cerca de la parte inferior de la plantilla de su sitio. Si utiliza Google Analytics u otros servicios de terceros, puede colocar el código de Klaviyo directamente encima o debajo.
Puede que se pregunte, "¿Cómo afecta el uso de Klaviyo al rendimiento de mi sitio?" La respuesta es que Klaviyo no afecta en absoluto al rendimiento de su sitio web. Nuestro código sólo se carga una vez que el resto de su sitio web ha terminado de cargarse. Además, Klaviyo indica a los navegadores que guarden en caché nuestro JavaScript, por lo que sus visitantes a menudo ni siquiera necesitan descargar nuestro JavaScript cada vez que cambian de página.
Compruebe su guión
Una vez que haya añadido el JavaScript a su sitio web, puede comprobar que está configurado correctamente introduciendo la URL de su sitio web a la derecha.
Una vez que el script esté en su sitio web, Klaviyo comenzará a rastrear las visitas y la sesión en su sitio web en tiempo real.
Conceptos básicos de la API
Para realizar llamadas a la API de Klaviyo y almacenar información sobre las personas, utilizará el objeto _learnq que añade automáticamente el script de Klaviyo.
Para realizar una llamada a la API, Klaviyo utiliza una sintaxis especial que permite que sus llamadas a la API funcionen incluso cuando nuestro script aún no se ha cargado en la página. Creará un array en el que el primer valor será el nombre del método al que desea llamar y los valores siguientes serán los argumentos a pasar a ese método.
Identificar a las personas
El método identificar le permite identificar y establecer propiedades en un individuo. Este método acepta un diccionario o hash de propiedades. Cuando identifique a alguien, debe incluir su dirección de correo electrónico, con la clave $email, o un identificador único como su ID de usuario, con la clave $id.
Una vez que haya incluido al menos uno de esos identificadores, podrá añadir las propiedades personalizadas que desee. Las propiedades personalizadas son útiles para rastrear datos sobre individuos. En Klaviyo, puede entonces crear segmentos de personas basados en esas propiedades. Por ejemplo, puede que desee hacer un seguimiento del tipo de plan de un individuo o de su fecha de inscripción. Klaviyo también entenderá los diferentes tipos de datos que utilice, así que siéntase libre de utilizar números, booleanos y fechas.
Klaviyo tiene algunas propiedades especiales que se utilizan para mostrar información sobre las personas. Estos son: $nombre, $apellido, $número de teléfono, $título y $organización.
Además de las propiedades que rastree, Klaviyo determinará automáticamente desde qué sitio web se remitió por primera vez a cada persona para el seguimiento de la atribución y la ubicación de una persona en función de dónde accede a su sitio web.
Código de ejemplo:
Seguimiento de eventos y acciones
El método de seguimiento le permite registrar los eventos y acciones que la gente realiza en su sitio web. Este método acepta una cadena que es el nombre que se le da a ese evento. Este método también acepta un diccionario o hash opcional de propiedades asociadas a ese evento.
Por ejemplo, podría realizar un seguimiento cuando alguien compra un artículo e incluir información sobre el precio de compra y qué artículos compró. Si tiene una aplicación en la que la gente tiene perfiles, podría hacer un seguimiento de cuándo alguien rellena su perfil. Si está planeando una integración completa de comercio electrónico, consulte esta guía.
El seguimiento de eventos y los análisis de Klaviyo son muy flexibles, por lo que puede personalizarlos para realizar un seguimiento de lo que es importante para su negocio. Nuestro método de seguimiento también entiende diferentes tipos de datos, por lo que puede utilizar números, booleanos y fechas, y nosotros crearemos cuadros y gráficos inteligentes basados en los datos que nos envíe.
Código de ejemplo: