Personyze propose une API REST pour gérer votre compte par programmation, un langage de modèles pour écrire le HTML des actions, et un ensemble de SDK pour l’intégration mobile native et via gestionnaire de balises. Cette page est le point de départ — des présentations rapides et des liens vers la documentation de référence complète.
API REST
L’API REST de Personyze permet à des applications tierces de lire et de modifier les données de votre compte : gérer les utilisateurs et les listes d’utilisateurs, travailler avec les catalogues de produits et d’articles, contrôler les emplacements et les actions, effectuer des opérations en direct sur les utilisateurs en ligne, interroger les résumés de rapports quotidiens, et plus encore. Elle utilise le HTTP standard, accepte et renvoie du JSON, et prend en charge les quatre verbes standard (GET, POST, PUT, DELETE).
Exemple rapide
Récupérer l’utilisateur dont l’ID interne est 42:
curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/internal_id=42'La forme générale de chaque requête :
https://api:<API_KEY>@app.personyze.com/rest/<object>[/<modifier>/<value>...]Référence complète de l’API REST (4 articles)
id ou internal_id. Lire →curl, Python et JS. Lire →where / columns / order_by / limit avec tous les opérateurs, la composition AND/OR, et les règles des colonnes indexées. Lire →Langage de modèles
Les actions Personyze (bannières, popups, widgets de recommandation, e-mails) s’écrivent dans un langage de modèles qui est pour l’essentiel du HTML et du CSS ordinaires, avec des directives pour les paramètres modifiables, des boucles sur les tables Personyze (produits, articles), des conditions, et des noms de classes spéciaux qui transforment des éléments ordinaires en widgets reconnus par Personyze.
${args} , variables d’utilisateur et de session, fonctions, boucles de tables ${foreach} , conditions, classes spéciales préfixées par $($responsive, $btn, $popup, $cform, etc.), gestion des formulaires, et les directives ${menu} qui construisent l’éditeur visuel. Plus la bibliothèque GitHub de 12 exemples de modèles prêts à l’emploi. Lire →SDK et outils sur GitHub
Si l’API REST et le langage de modèles sont désormais entièrement documentés dans le wiki, tout le code open source de Personyze reste sur GitHub, à l’adresse github.com/personyze :
SDK mobiles natifs
Les deux SDK sont publiés sous licence MIT. Les applications de démo sont des références exécutables qui montrent tout le parcours, de la configuration à la personnalisation. Pour une procédure guidée, voir le guide d’intégration des recommandations de produits pour applications mobiles.
Outils web
Associez le modèle GTM au guide de configuration de Google Tag Manager pour le parcours d’intégration complet.
Guides liés
- Configuration par type de site — suivi, flux et intégrations — choisissez votre point de départ selon votre type de site.
- Suivi des événements d’interaction produit — les événements à déclencher sur les pages web.
- Configuration du flux de produits / de contenu — le côté catalogue des intégrations par API.
- Guide de l’action JavaScript — pour écrire des actions Personyze personnalisées en code.