Skip to main content

​
Acerca de Klaviyo

Iru lee los usuarios de la cuenta y sus permisos, las claves de API con sus ámbitos, los metadatos de listas y segmentos y las conexiones de integración desde la API de Klaviyo. La autenticación usa una clave de API privada creada en Configuración → Claves de API. Las claves privadas de Klaviyo se limitan al crearlas. Concede acceso de solo lectura a los objetos que abarcan tus controles. Iru lee solo metadatos. Se recopilan los nombres y la configuración de las listas y los segmentos; no se recopilan los perfiles que contienen.

​
Cómo funciona

Klaviyo usa un esquema de autorización personalizado: el valor del encabezado lleva el prefijo Klaviyo-API-Key, no Bearer. Cada solicitud también requiere un encabezado revision con una fecha ISO 8601 que fija la versión de la API. Klaviyo versiona su API mediante revisiones fechadas en lugar de un segmento de ruta, y se rechaza cualquier solicitud sin una revisión válida. Iru establece la revisión; tú solo proporcionas la clave. Las solicitudes se dirigen a https://a.klaviyo.com/api. No hay ningún subdominio ni host de cuenta que configurar. La clave de API pública (un ID de empresa corto que se usa en llamadas de suscripción del lado del cliente) es una credencial diferente y no sirve para autenticarse aquí. Referencias oficiales: Autenticar solicitudes a la API, Política de versiones y obsolescencia de la API.

​
Requisitos previos

  • Un rol de cuenta que pueda administrar claves de API en Klaviyo.
  • Decide qué entra en el alcance. Klaviyo te permite excluir la supervisión de listas y segmentos, y los objetos excluidos no generan evidencia.

​
Conectar Klaviyo a Iru

Completa esta pestaña antes de conectar la fuente en Compliance.
1

Inicia sesión en Klaviyo

Inicia sesión en Klaviyo con una cuenta que pueda administrar claves de API.
2

Abre Settings

Abre el menú de la cuenta en la esquina inferior izquierda y, a continuación, selecciona Configuración.
3

Abre Claves de API

Ve a Claves de API.
4

Crea una clave de API privada

Selecciona Create private API key.
5

Asigna un nombre y un alcance a la clave

Introduce una etiqueta como Iru Compliance para poder auditar la integración más adelante. Establece el acceso de la clave en solo lectura. Usa ámbitos personalizados y concede acceso de lectura solo a los objetos que abarca tu programa de cumplimiento. Accounts, Lists y Segments cubren la evidencia que recopila Iru. No concedas acceso completo ni ningún ámbito de escritura.
6

Crea y copia la clave

Crea la clave y copia el valor una sola vez mientras Klaviyo lo muestra.
Continúa en la pestaña Iru Compliance.

​
Solución de problemas

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
Confirma que creaste una clave privada, no una pública. La clave pública es un ID de empresa corto que se usa para llamadas del lado del cliente y no autentica una solicitud de servidor a servidor.
La clave privada se creó con ámbitos personalizados que los excluyen. Los ámbitos de Klaviyo se fijan al crear la clave. Crea una clave nueva con los ámbitos que necesitas.
O bien la clave no tiene acceso de lectura a ellos, o bien la supervisión de listas y segmentos está fuera del alcance de esta conexión.
Es lo esperado. Iru recopila los metadatos de listas y segmentos, no los perfiles que contienen.

​
Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Introducción a Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Sube, revisa y organiza la evidencia de fuentes y acciones.