Interfaz JavaScript de programación de aplicaciones (API)
La siguiente guía te guiará a través de la configuración y el uso de la interfaz de programación de aplicaciones (API) de JavaScript. Si estás planeando una integración completa en ecommerce, consulta esta guía.
Nota
Para utilizar los fragmentos de Klaviyo que se proporcionan a continuación, tendrás que actualizar el marcador de posición de API_KEY con tu clave pública de API, que puedes encontrar aquí.
Añadir el fragmento Klaviyo
Para empezar a hacer un seguimiento de las personas, añade el siguiente fragmento a la derecha en la plantilla principal de tu sitio web para que se añada automáticamente a todas las páginas de tu sitio web. Si tienes un desarrollador que añada este script a tu sitio web, puedes enviarle un enlace a esta guía.
Tienes que hacer un cambio en el fragmento. Si eres una empresa de comercio electrónico, elimina las cuatro líneas con la llamada "identify". Si eres un sitio web o una aplicación web en la que la gente se conecta, sustituye el {{ email }} marcador de posición correo electrónico por la etiqueta de plantilla adecuada que tenga la dirección de correo electrónico del usuario de iniciar sesión.
Te sugerimos que pongas el código Klaviyo en la parte inferior de la plantilla de tu sitio o cerca de ella. Si utilizas el análisis de Google u otros servicios de terceros, puedes colocar el código Klaviyo directamente encima o debajo.
Puede que te preguntes: "¿Cómo afecta el uso de Klaviyo al rendimiento de mi sitio?" La respuesta es que Klaviyo no afecta en absoluto al rendimiento de tu sitio web. Nuestro código sólo se carga cuando el resto de tu sitio web ha terminado de cargarse. Además, Klaviyo indica a los navegadores que guarden en caché nuestro JavaScript, por lo que a menudo tus visitantes ni siquiera necesitan descargar nuestro JavaScript cada vez que cambian de página.
Comprueba tu guión
Una vez que hayas añadido el JavaScript a tu sitio web, puedes comprobar que está configurado correctamente introduciendo la URL de tu sitio web a la derecha.
Una vez que el script esté en tu web, Klaviyo iniciará el seguimiento de visitas y sesiones en tu web en tiempo real.
Interfaz de programación de aplicaciones (API) Conceptos básicos
Para realizar llamadas a la Klaviyo interfaz de programación de aplicaciones (API) y tienda, comercio información sobre personas, utilizarás el objeto _learnq que añade automáticamente el script Klaviyo.
Para realizar una llamada a la interfaz de programación de aplicaciones (API), Klaviyo utiliza una sintaxis especial que permite que tus llamadas a la interfaz de programación de aplicaciones (API) funcionen incluso cuando nuestro script aún no se ha cargado en la página. Crearás una matriz en la que el primer valor es el nombre del método que quieres llamar y los valores siguientes son argumentos que pasarás a ese método.
Identificar a las personas
El método identificar te permite identificar y establecer propiedades en un individuo. Este método acepta un diccionario o hash de propiedades. Cuando identificas a alguien, debes incluir su dirección de correo electrónico, con la clave $correo electrónico, o un identificador único como su ID de usuario, con la clave $id.
Una vez que hayas incluido al menos uno de esos identificadores, eres libre de añadir las propiedades personalizadas que quieras. Las propiedades personalizadas son útiles para el seguimiento de datos sobre individuos. En Klaviyo, puedes crear segmentos de personas en función de esas propiedades. Por ejemplo, puede que quieras hacer un seguimiento del tipo de plan o de la fecha de registro de un individuo. Klaviyo también entenderá los distintos tipos de datos que utilices, así que siéntete 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 rastreas, Klaviyo determinará automáticamente desde qué sitio web se remitió primero 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 tu sitio web.
Código de ejemplo:
seguimiento Eventos y Acciones
El método de seguimiento te permite registrar los eventos y acciones que realizan las personas en tu sitio web. Este método acepta una cadena que es el nombre que le das a ese evento. Este método también acepta un diccionario o hash opcional de propiedades asociadas a ese evento.
Por ejemplo, podrías hacer un seguimiento de cuándo alguien compra un artículo e incluir información sobre el precio de compra y qué artículos compró. Si tienes una aplicación en la que la gente tiene perfil, podrías hacer un seguimiento de cuándo alguien rellena su perfil. Si estás planeando una integración completa en ecommerce, consulta esta guía.
Klaviyode seguimiento y análisis de eventos son muy flexibles, por lo que puedes personalizarlos para hacer un seguimiento de lo que es importante para tu negocio. Nuestro método de seguimiento también entiende distintos tipos de datos, por lo que puedes utilizar números, booleanos y fechas, y crearemos tablas y gráficos inteligentes basados en los datos que envíes.
Código de ejemplo: