Personyze ofrece una API REST para gestionar su cuenta mediante programación, un lenguaje de plantillas para crear el HTML de las acciones y un conjunto de SDK para la integración con apps móviles nativas y gestores de etiquetas. Esta página es el punto de partida — resúmenes rápidos más enlaces a la documentación de referencia completa.
API REST
La API REST de Personyze permite a aplicaciones de terceros leer y modificar datos de su cuenta: gestionar usuarios y listas de usuarios, trabajar con los catálogos de productos y de artículos, controlar placeholders y acciones, realizar operaciones en vivo sobre usuarios conectados, consultar resúmenes diarios de informes y mucho más. Usa HTTP estándar, acepta y devuelve JSON, y admite los cuatro verbos estándar (GET, POST, PUT, DELETE).
Ejemplo rápido
Obtener el usuario con el ID interno 42:
curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/internal_id=42'La forma general de cada solicitud:
https://api:<API_KEY>@app.personyze.com/rest/<object>[/<modifier>/<value>...]Referencia completa de la API REST (4 artículos)
id frente a internal_id. Leer →curl, Python y JS. Leer →where / columns / order_by / limit con todos los operadores, composición AND/OR y reglas de columnas indexadas. Leer →Lenguaje de plantillas
Las acciones de Personyze (banners, popups, widgets de recomendación, emails) se crean en un lenguaje de plantillas que es sobre todo HTML y CSS normales, con directivas para parámetros editables, bucles sobre tablas de Personyze (productos, artículos), condicionales y nombres de clase especiales que convierten elementos normales en widgets de Personyze.
${args} , variables de usuario y de sesión, funciones, bucles de tabla ${foreach} , condicionales, clases especiales con el prefijo $(por ejemplo,$responsive, $btn, $popup, $cform), gestión de formularios y las directivas ${menu} que construyen el editor visual. Además, la biblioteca de GitHub con 12 plantillas de ejemplo listas para usar. Leer →SDK y herramientas en GitHub
Aunque la API REST y el lenguaje de plantillas ya están documentados por completo en la wiki, todo el código abierto de Personyze sigue en GitHub, en github.com/personyze:
SDK móviles nativos
Ambos SDK se publican con licencia MIT. Las apps de demostración son referencias ejecutables que muestran todo el flujo, de la configuración a la personalización. Para un recorrido guiado, consulte la Guía de integración de recomendaciones de productos en apps móviles.
Herramientas web
Combine la plantilla de GTM con la guía de configuración de Google Tag Manager para el flujo de integración completo.
Guías relacionadas
- Configuración por tipo de sitio — seguimiento, feeds e integraciones — elija su punto de partida según el tipo de sitio.
- Seguimiento de eventos de interacción con productos — los eventos que debe enviar desde las páginas web.
- Configuración del feed de productos/contenidos — la parte del catálogo en las integraciones por API.
- Guía de la acción JavaScript — para escribir acciones personalizadas de Personyze en código.