Extension WordPress de personnalisation Personyze

L’extension Personyze System Integration fait le lien entre un site WordPress et un compte Personyze. Elle fait quatre choses :

1. Elle installe le tracker sur chaque page, sans modifier le thème.
2. Elle alimente le catalogue — articles, pages et produits WooCommerce — pour que les recommandations, l’agent de chat IA et la recherche IA aient de quoi travailler.
3. Elle signale ce que lit le visiteur, par identifiant d’article plutôt que par URL.
4. Elle héberge l’agent IA de Personyze dans wp-admin, pour créer des campagnes sans quitter WordPress.

Les campagnes, recommandations, tests A/B et designs se créent toujours dans Personyze. L’extension relie les deux et place l’agent là où se trouve le contenu.

Nécessite WordPress 5.6 ou plus récent et PHP 7.0 ou plus récent. Testée jusqu’à WordPress 7.0.3. Téléchargez-la depuis le répertoire des extensions WordPress.

La connexion, en un clic

L’extension passe désormais en premier. Il n’y a aucun numéro de compte à recopier, aucun code de suivi à coller, aucune clé API, et aucun mot de passe d’application à créer à la main.

1. Extensions → Ajouter une extension, recherchez Personyze, installez et activez.
2. Personyze → Settings, puis Connect to Personyze.
3. Approuvez sur l’écran WordPress, puis confirmez le compte sur l’écran Personyze.

WordPress émet lui-même le mot de passe d’application lors de l’approbation et le transmet à Personyze. Vous devez être connecté à Personyze pour l’étape de confirmation.

Ce qui se passe en coulisses

Utile si vous examinez l’intégration :

• L’extension vous envoie vers la page WordPress authorize-application.php avec un identifiant d’application stable et un state à usage unique, conservé trente minutes et vérifié quand Personyze renvoie le compte — pour qu’un tiers ne puisse pas lier votre site à son propre compte.
• WordPress redirige vers Personyze avec l’URL du site, l’identifiant de l’utilisateur et le nouveau mot de passe dans la chaîne de requête. Personyze les déplace immédiatement dans un cookie HttpOnly de courte durée et redirige vers une URL propre : le mot de passe ne reste ni dans la barre d’adresse ni dans l’historique du navigateur.
• La connexion n’est jamais établie sur cette seule redirection. Personyze affiche ce qui s’apprête à être connecté — le site, l’utilisateur WordPress, le compte Personyze — et attend un clic de confirmation.

Sites en HTTP

La connexion en un clic nécessite HTTPS. Si votre site est encore en HTTP, passez-le en HTTPS pour faire apparaître le bouton, ou contactez le support Personyze pour vous aider à le connecter.

Où se trouve l’extension

Un menu « Personyze » de premier niveau dans la barre latérale de l’administration WordPress, avec deux écrans. Les deux nécessitent la capacité manage_options : ils sont donc réservés aux administrateurs.

L’agent IA dans WordPress

Le même agent que dans le panneau Personyze, sur le même compte — pas une version allégée. Il apparaît à trois endroits :

• Personyze → AI Agent — un écran en pleine largeur.
• Un lanceur dans le coin inférieur droit de chaque écran de wp-admin.
• Un lanceur sur la partie publique de votre propre site, quand vous êtes connecté en tant qu’administrateur — accessible aussi depuis la barre d’outils WordPress sous le nom Personyze AI.

Le compteur d’actions IA

Sous la zone de saisie, comme dans le panneau. Il compte des actions IA — jamais des jetons, jamais des montants — et a cinq états :

• Normal : « 42 actions IA restantes ce mois-ci · renouvellement le 1er sept. ».
• Moins d’un quart restant : orange.
• Épuisé avec une formule payante : « Allocation IA mensuelle utilisée — l’IA supplémentaire est ajoutée à votre facture. »
• Épuisé avec une formule gratuite : rouge, avec un lien Add AI credits.
• Aucune allocation configurée : le compteur se masque entièrement.

Son comportement

• La conversation est construite à la première ouverture, pas au chargement de la page — elle peut se trouver sur une page publique, et la plupart des pages vues ne l’ouvrent jamais.
• L’état ouvert ou fermé est mémorisé. Échap la ferme ; Entrée envoie et Maj+Entrée crée une nouvelle ligne.
• Les réponses en plusieurs étapes montrent ce qui est consulté pendant qu’elles se construisent, plutôt qu’une attente vide.
• Il n’est jamais visible pour les visiteurs. Il ne s’affiche que pour les utilisateurs connectés disposant de
  manage_options.

Ce qu’il peut faire, et ce qu’il ne peut pas faire

Il peut créer une campagne à partir d’une description et la styliser à votre marque, compiler un ciblage à partir de mots simples et vous le relire, suggérer des améliorations d’après votre propre trafic, répondre à des questions de performance avec de vrais chiffres, gérer les campagnes existantes et ouvrir un ticket de support. Les nouvelles campagnes sont créées en staging, visibles uniquement des visiteurs arrivant depuis une adresse IP de staging — la publication reste votre décision.

Les flux

Les deux sont activés par défaut, et le flux de produits n’apparaît que là où WooCommerce est actif. Ils se contrôlent depuis Personyze → Settings → Feeds dans WordPress, et non depuis le panneau Personyze — c’est ce que dit WordPress qui l’emporte, et Personyze s’y conforme.

Ils sont relus une fois par jour, chaque compte à sa propre heure : les articles que vous publiez ou modifiez arrivent dans les recommandations sans que personne n’ait à appuyer sur quoi que ce soit. Basculer un interrupteur prévient Personyze immédiatement au lieu d’attendre le passage suivant ; si Personyze est injoignable à ce moment-là, le réglage est quand même enregistré, pris en compte au passage suivant, et l’écran l’indique.

Ce que contient chaque flux

Contenus — articles et pages publiés, hors contenus protégés par mot de passe :

id (l’identifiant d’article WordPress) · title · description (l’extrait) · publish_date (dernière modification, GMT) · name (slug) · author
· type · comment_count · categories ·
interests (étiquettes) · content_url (le permalien) · thumbnail (l’image mise en avant)

Produits — produits publiés, avec les mêmes champs plus price (normal) ·
sale_price · is_in_stock · inventory (quantité en stock).

Voir ce que lit Personyze

L’écran des réglages affiche les deux URL des flux. En ouvrir une est le moyen le plus rapide de répondre à « est-ce qu’il récupère mes articles ? », et vous pouvez faire pointer un autre système vers le même catalogue.

https://SITE/?rest_route=/personyze/v1/sitemap     content
https://SITE/?rest_route=/personyze/v1/products    products

Ajoutez &limit=20 pour voir les premières lignes. La pagination se fait avec id-from et
limit, 100 lignes à la fois.

Savoir ce que lit le visiteur

C’est la partie que la plupart des outils de personnalisation vous font configurer, et ici il n’y a rien à configurer. Sur un article, une page ou un produit, l’extension transmet directement à Personyze l’identifiant d’article WordPress :

personyze.push(['Article Viewed', 123]);   // or ['Product Viewed', 55]

Le flux exporte ce même identifiant : la clé du catalogue et l’événement de vue correspondent donc exactement. Pas de groupes de pages, pas de modèles d’URL, et pas de conteneur qui extrait la barre d’adresse.

Elle reste volontairement muette partout ailleurs : archives de catégories et d’étiquettes, index des articles, résultats de recherche, et types de contenu qu’aucun flux n’exporte. Désactiver un flux arrête aussi le signalement des vues correspondantes.

WooCommerce

• Synchronisation des produits — activée par défaut partout où WooCommerce est actif.
• Suivi des ajouts au panier — les changements de panier sont signalés comme Product Added to cart avec la quantité, et Products Removed from cart quand le panier est vidé.
• Suivi des achats — sur la page de commande reçue, chaque ligne devient Product Purchased avec sa quantité.
• Ajout au panier depuis une campagne Personyze — un widget de recommandation ou une popup peut ajouter un produit au vrai panier WooCommerce, via un point de terminaison que l’extension expose à cet effet.

Contrairement aux deux flux, le suivi des ajouts au panier et des achats s’active dans le panneau Personyze.

Vos propres gabarits, via les shortcodes

Personyze peut demander à votre site d’afficher un shortcode WordPress et utiliser le résultat dans une campagne. Les blocs personnalisés peuvent donc utiliser vos propres gabarits et le rendu de votre constructeur de pages, et correspondre exactement au thème, au lieu d’être reconstruits dans Personyze.

C’est aussi ainsi que la connexion se teste elle-même : après la connexion, Personyze envoie un jeton par la route des shortcodes et vérifie qu’il revient — « connecté » signifie donc que tout le chemin fonctionne, et pas seulement que des identifiants ont été enregistrés.

Changer de compte, et se déconnecter

Personyze → Settings → « Connect to a different account, or disconnect ». La déconnexion :

• Révoque le mot de passe d’application qu’utilisait Personyze : l’ancien compte ne peut plus lire le site. Seuls les mots de passe créés par cette extension sont concernés — ceux d’une autre intégration ne sont pas touchés.
• Arrête la diffusion de la balise Personyze.
• Efface le compte, les flux et la clé enregistrés.
• Laisse intact tout ce qui a été créé dans Personyze. Elle délie les deux, rien de plus.

Extensions de cache : excluez Personyze

Nous recommandons d’exclure Personyze de toutes les extensions de cache et d’optimisation que vous utilisez. La bibliothèque de personnalisation doit se charger et décider avant que le visiteur ne voie la page. Une extension qui la retarde, la minifie dans un bundle ou sert une copie en cache de son résultat transforme la personnalisation en quelque chose qui arrive tard — ou qui n’arrive pas du tout.

WP Rocket

File Optimization → Delay JavaScript Execution → Excluded JavaScript Files, une entrée par ligne :

_S_T
stat-track-lib
counter.personyze.com

Tant que vous y êtes

• Excluded from Minify/Combine — si la minification JavaScript est activée, ajoutez
  counter.personyze.com là aussi. Combiner un tracker tiers dans un bundle est un moyen courant de le casser sans bruit.
• N’ajoutez pas ces entrées à Lazy Load ni à Remove Unused CSS. Elles n’y ont aucun effet et ne font qu’ajouter du bruit.

Vérifier que ça a fonctionné

Ouvrez la page dans un nouvel onglet et, sans rien toucher, exécutez ceci dans la console du navigateur :

window._S_T && _S_T.uid

Les autres extensions de cache nomment ces réglages différemment — cherchez « delay JavaScript », « defer », « combine » ou « minify » et excluez les trois mêmes chaînes. Les mêmes consignes pour toutes les plateformes se trouvent dans Activer Personyze.

Quand quelque chose semble cassé

• L’agent affiche un lien vers l’extérieur au lieu du chat. Un site connecté avant la 0.27 n’a pas de clé API jusqu’au prochain passage de configuration de Personyze. Cliquer sur Test dans le widget WordPress du panneau règle le problème immédiatement.
• Un nouvel article n’est pas encore dans les recommandations. Les flux sont relus chaque jour, pas instantanément — normalement en ligne sous 24 heures. Sync sitemap dans le panneau force la mise à jour tout de suite.
• Le lanceur de l’agent ne fait rien. Un cache pleine page qui met en cache les pages des administrateurs connectés rend obsolète le nonce de sécurité intégré à la page. La plupart des caches ignorent les utilisateurs connectés et ne sont pas concernés.
• Rien ne se personnalise tant que le visiteur ne bouge pas la souris. Une extension de cache retarde la bibliothèque — voir Extensions de cache plus haut.
• Le bouton en un clic est absent. Le site est en HTTP ; voir « Sites en HTTP » plus haut.
• Pas de flux de produits ni d’interrupteur. WooCommerce n’est pas actif.

Référence

Routes REST, sous personyze/v1

/config et /content exigent en plus que l’appelant se résolve en
personyze.com, car elles modifient des réglages et exécutent des shortcodes. Les flux en lecture seule ne dépendent que de la capacité, ce qui rend leurs URL utilisables par vous et par d’autres systèmes.

Options enregistrées dans WordPress

personyze_account_id · personyze_tracking_domains ·
personyze_api_key · personyze_sync_articles ·
personyze_sync_products · personyze_track_add_to_cart ·
personyze_track_purchase

Staging

Le filtre personyze_connect_url remplace l’adresse à laquelle la connexion en un clic envoie ses identifiants, pour les environnements hors production.

Ce que vous pouvez créer sur un site WordPress

Tout ce que Personyze peut placer sur une page fonctionne ici, avec le catalogue que l’extension lui fournit. Quatre des cas les plus courants :

Modifier la page que vous avez déjà

Une popup ou une bannière à partir d’un modèle

Des recommandations tirées de vos propres articles

Ou construire le design vous-même

Le Canvas Builder assemble une popup, une bannière ou un bloc intégré à partir d’éléments — titre, image, compte à rebours, formulaire, bandeau de recommandations — quand aucun modèle ne s’en approche assez.

Voir aussi

• Commencer ici — les autres façons d’installer Personyze.
• Flux de produits / de contenus — ce que fait Personyze de ce que l’extension envoie.
• Agent de chat IA et recherche IA — ils répondent à partir de ces flux, sans étape d’indexation séparée.
• Agent IA de Personyze — le même agent, dans le panneau et depuis Claude ou ChatGPT.