=== EdenPersona - Connecteur & Analytics ===
Contributeurs: edenpersona
Tags: woocommerce, analytics, insights-clients, ia, personas
Nécessite au moins: 5.0
Testé jusqu'à: 6.8
Version stable: 1.5.0
Nécessite PHP: 7.4
Licence: GPLv2 ou ultérieure
URI de la licence: https://www.gnu.org/licenses/gpl-2.0.html

Synchronise les données de vente WooCommerce anonymisées avec EdenPersona pour des insights clients et des analyses alimentées par l'IA.

== Description ==

EdenPersona - Connecteur & Analytics est la solution d'analytics WooCommerce ultime, fournissant des insights client complets, un suivi de parcours avancé et des personas alimentés par l'IA pour vous aider à comprendre et développer votre base client.

**🎯 NOUVEAU en v1.2.0 : Analytics de Campagnes Personas (Premium)**
* **Suivi des Campagnes par Persona** : Surveillez les taux de conversion et la performance de chaque persona
* **Analytics des Campagnes UTM** : Suivez l'efficacité des campagnes marketing par persona
* **Analyse des Taux de Conversion** : Voyez quels personas convertissent le mieux et optimisez en conséquence
* **Revenus par Persona** : Analysez quels personas génèrent le plus de revenus
* **Insights ROI des Campagnes** : Mesurez le retour sur investissement des campagnes ciblées par persona

**🎯 NOUVEAU en v1.1.0 : Analytics de Parcours Client (Premium)**
* **Suivi Complet du Parcours Client** : Suivez chaque étape du parcours d'achat de vos clients
* **Analyse des Pages d'Entrée** : Découvrez quelles pages convertissent le mieux comme points d'entrée
* **Parcours Populaires** : Identifiez les modèles de navigation client les plus réussis
* **Insights d'Exploration de Catégories** : Voyez quelles catégories de produits génèrent le plus d'engagement
* **Visualisation Interactive du Parcours** : De beaux graphiques et analytics pour l'optimisation du parcours

**🆓 Fonctionnalités d'Analytics GRATUITES (Aucun abonnement requis) :**

* **Tableau de bord Analytics avancé** : Tendances de revenus complètes, meilleurs produits et insights clients  
* **Segmentation client intelligente** : Identifiez les clients VIP, les clients dormants et les modèles d'achat  
* **Intelligence client** : Analyse de la fréquence d'achat, métriques de rétention et distribution géographique  
* **Seuils de dormance configurables** : Définissez des délais personnalisés pour identifier les clients inactifs  
* **Export CSV** : Exportez les listes de clients pour les campagnes marketing  
* **Support multilingue** : Traduction française complète incluse
* **Synchronisation automatique des données** : Synchronisez vos données WooCommerce avec la plateforme IA d'EdenPersona
* **Analytics de Parcours Client** : Suivi complet du parcours et analyse des chemins
* **Analytics de Campagnes Personas** : Suivi des campagnes UTM et performance des personas  

Sur EdenPersona, vous trouverez :  
* **Personas clients alimentés par l'IA** : Générez des personas d'acheteurs détaillés basés sur le comportement d'achat réel  
* **Chat interactif avec les personas** : Conversez avec des personas clients alimentés par l'IA  
* **Conseils marketing stratégiques** : Recommandations guidées par l'IA pour la rétention client et la croissance  
* **Analyse contextuelle géographique** : Insights IA sur les différences de marchés régionaux  
* **Approche respectueuse de la vie privée** : Seules les données anonymisées (emails hachés) sont transmises  

**📊 Suite d'analytics complète (GRATUITE) :**

* Tendances de revenus et analyse de croissance  
* Produits, catégories et variations les plus vendus  
* Métriques de rétention et d'acquisition client  
* Distribution géographique des ventes  
* Analyse de la fréquence d'achat  
* Insights de sensibilité promotionnelle  
* Identification des opportunités de vente croisée  
* Identification des clients dormants et listes de réactivation  

**Parfait pour :**

* **Les propriétaires de boutiques e-commerce** souhaitant des analyses professionnelles sans frais mensuels  
* **Les équipes marketing** recherchant des insights clients basés sur les données, le suivi des campagnes UTM et l'analytics des personas  
* **Les gestionnaires de boutique** voulant optimiser leur offre de produits et la rétention client  
* **Les propriétaires d'entreprise** cherchant des analyses WooCommerce complètes avec une mise à niveau IA optionnelle
* **Les designers UX** ayant besoin de comprendre les modèles de navigation client et l'optimisation du parcours
* **Les growth hackers** voulant identifier les goulots d'étranglement de conversion et les opportunités d'optimisation

**🎥 Voir en action :**
[![Démo EdenPersona](https://img.youtube.com/vi/Ea0jEVs4aV8/0.jpg)](https://youtu.be/Ea0jEVs4aV8)

**Sécurité et confidentialité :**

* Toutes les données client sont anonymisées en utilisant un hachage sécurisé  
* Aucune information personnelle (noms, adresses, etc.) n'est transmise  
* Gestion des données conforme RGPD et respectueuse de la vie privée  
* Authentification sécurisée par jeton API  

**💎 Intégration plateforme EdenPersona (PREMIUM) :**

Avec un abonnement EdenPersona, ce plugin se connecte à la plateforme EdenPersona où vous pouvez :  
* Créer des personas basés sur les données pour identifier et segmenter vos clients  
* Chatter avec des personas clients alimentés par l'IA basés sur vos données réelles  
* Obtenir des conseils marketing stratégiques et une analyse des barrières client  
* Analyser les différences de marchés géographiques avec le contexte IA  
* Créer des campagnes marketing ciblées avec des insights guidés par l'IA (bientôt)

**Tarification** : Les abonnements EdenPersona commencent à 26€/mois.  
Plus d'infos : [https://www.edenpersona.com](https://www.edenpersona.com)

== Closed-loop personas ==

EdenPersona peut recevoir des mises à jour de segmentation personas générées côté SaaS et les appliquer sous forme de tags `edp_persona_tag` sur les utilisateurs WooCommerce. Le plugin résout les identités hachées (`email_hash -> wp_user_id`) puis applique les transitions d'état (`active`, `moved`, `removed`) pour maintenir un état de tagging cohérent.

Pré-requis : EdenPersona Connector `v1.5.0+`, un workspace EdenPersona actif, et un secret HMAC copié depuis le SaaS EdenPersona. Les appels `POST /wp-json/edenpersona/v1/sync-persona-map`, `GET /wp-json/edenpersona/v1/health` et `POST /wp-json/edenpersona/v1/export-persona-csv` sont signés via `X-EdenPersona-Signature` et scoped avec `X-EdenPersona-Workspace`.

Activation : dans l'admin WordPress, ouvrir `WooCommerce -> EdenPersona -> Closed-loop`, cocher l'activation closed-loop, puis coller le secret HMAC fourni par EdenPersona SaaS. Exécuter ensuite les actions de maintenance (rehash + reconstruction du hash mapping) avant la première sync de production.

== Installation ==

**🆓 Pour les Analytics GRATUITES (utilisation immédiate) :**
1. Téléchargez les fichiers du plugin dans le répertoire `/wp-content/plugins/wp-edenpersona`, ou installez le plugin directement via l'écran des plugins WordPress.  
2. Activez le plugin via l'écran 'Plugins' dans WordPress.  
3. Naviguez vers WooCommerce > EdenPersona pour accéder à votre tableau de bord analytics.  
4. Configurez votre seuil de dormance client si nécessaire.  
5. Commencez à analyser vos données client immédiatement !

**🚀 Pour les fonctionnalités IA PREMIUM (optionnel) :**
1. Créez un compte sur [https://www.edenpersona.com](https://www.edenpersona.com).  
2. Obtenez votre jeton API depuis votre tableau de bord EdenPersona.  
3. Saisissez votre jeton API dans les paramètres du plugin.  
4. Cliquez sur "Démarrer la synchronisation initiale" pour synchroniser vos commandes historiques.  
5. Accédez aux personas et insights alimentés par l'IA sur la plateforme EdenPersona.

== Questions fréquemment posées ==

= Ai-je besoin d'un compte EdenPersona pour utiliser ce plugin ? =  
Non ! Le plugin fournit des analyses complètes et des insights clients GRATUITEMENT sans aucun compte.  

= Quelles données sont envoyées à EdenPersona ? =  
**Pour les analytics GRATUITES** : Aucune donnée n'est envoyée nulle part - tout reste sur votre serveur WordPress.  
**Pour les fonctionnalités IA PREMIUM** : Seules les données de commande anonymisées incluant :  
- Totaux et dates de commande  
- Produits et catégories
- Emails clients hachés (pas les emails réels)  
- Données géographiques (ville/pays) mais pas l'adresse réelle ou l'IP. 

= Mes données client sont-elles sécurisées ? =  
Absolument. Nous utilisons un hachage sécurisé pour tous les identifiants client et ne transmettons aucune information personnelle. Le plugin est conforme RGPD.

= Puis-je personnaliser le seuil de dormance client ? =  
Oui, vous pouvez définir des périodes de dormance personnalisées (30 jours à 1 an) ou utiliser notre détection automatique intelligente basée sur votre type d'entreprise.

= Qu'arrive-t-il à mes données si je désactive le plugin ? =  
Le plugin arrête immédiatement d'envoyer de nouvelles données. Vos données historiques sur EdenPersona restent disponibles dans votre compte. Vous pouvez demander à l'administrateur de les supprimer, en respect du RGPD.

= Cela fonctionne-t-il avec les variations WooCommerce ? =  
Oui, le plugin supporte entièrement les variations de produits et fournit des analyses détaillées au niveau des variations.

= Puis-je exporter des listes de clients pour le marketing ? =  
Oui ! La version GRATUITE inclut une fonctionnalité d'export CSV complète pour les meilleurs clients et les campagnes de réactivation de clients dormants - aucun abonnement requis.

== Captures d'écran ==

1. Insights clients GRATUITS montrant l'analyse des clients dormants et de la diversité d'achat
2. Tableau de bord Analytics GRATUIT avec les tendances de revenus et les produits les plus vendus  
3. Insights clients GRATUITS montrant les meilleurs clients et l'analyse de sensibilité promotionnelle  
4. Connexion et synchronisation vers EdenPersona pour créer des personas basés sur les données  

== Journal des modifications ==

= 1.5.0 =
* **NOUVEAU** : Closed-loop personas (`/sync-persona-map`, `/health`, `/export-persona-csv`) avec authentification HMAC, idempotence et rate limiting.
* **NOUVEAU** : Tables hash mapping et customer-persona mapping pour la résolution hash et le suivi des états persona.
* **NOUVEAU** : `EDENPERSONA_Error_Buffer` + remontée `recent_errors` via `/health` pour l'observabilité côté SaaS.
* **NOUVEAU** : Cron quotidien `edenpersona_gc_persona_tags` pour nettoyer les tags personas orphelins.
* **NOUVEAU** : Actions de maintenance closed-loop dans l'admin (rehash + reconstruction mapping).

= 1.4.3 =
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.4.2 =
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.4.1 = 
* **NOUVEAU** : Amélioration de la gestion des cookies.

= 1.4.0 = 
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.3.9 = 
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.3.8 = 
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.3.7 = 
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.3.6 = 
* **NOUVEAU** : Corrections mineures et améliorations.

= 1.3.5 = 
* **NOUVEAU** : Gestion du nouveau système de notifications de friction client et d'évolution client dans EdenPersona

= 1.3.4 = 
* **NOUVEAU** : Analyse du comportement des abandons de panier et des hésitations de checkout

= 1.3.3 = 
* **MISE À JOUR** : Amélioration de l'accessibilité
* **MISE À JOUR** : Amélioration de l'UX et de la vitesse
* **CORRECTIF** : Amélioration de la sécurité
* **CORRECTIF** : Corrections mineures et améliorations

= 1.3.2 =
Amélioration de l'UX et de la sécurité.

= 1.3.1 =
Amélioration de la sécurité.

= 1.3.0 =
Amélioration de la gestion des pages d'entrée.

= 1.2.8 =
Amélioration du suivi du parcours client avec FunnelKit.

= 1.2.7 =
Amélioration du suivi du parcours client.

= 1.2.6 =
Ajout des métriques de souscription pour l'analyse des campagnes par persona.

= 1.2.5 =
Affichage des visites des personas suivies par jour. Corrections et améliorations

= 1.2.4 =
* Correctifs mineurs et améliorations

= 1.2.3 =
* **CORRECTIF** : Bug de visite corrigé
* **CORRECTIF** : Correction de la timezone

= 1.2.2 =
* **CORRECTIF** : Bug de parcours corrigé

= 1.2.0 =
* **NOUVEAU** : Analytics de Campagnes Personas (fonctionnalité Premium)
  * Suivi des campagnes par persona avec monitoring des paramètres UTM
  * Analyse des taux de conversion par persona pour l'optimisation des campagnes
  * Suivi des revenus par persona pour identifier les cibles à haute valeur
  * Graphiques interactifs montrant les métriques de performance des personas
  * Insights ROI des campagnes pour des décisions marketing basées sur les données
* **NOUVEAU** : Système de suivi UTM amélioré
  * Capture automatique des paramètres utm_persona, utm_source, utm_campaign
  * Comptage des visites basé sur les sessions pour des taux de conversion précis
  * Statistiques de visites quotidiennes avec nettoyage automatique des anciennes données
  * Persistance sécurisée des données persona dans les commandes WooCommerce
* **AMÉLIORÉ** : Meilleure performance et sécurité
  * Améliorations de conformité aux standards de codage WordPress
  * Système de cache amélioré pour les données analytics
  * Meilleure gestion des erreurs et retour utilisateur
  * Meilleures mesures de vérification des nonces et de sécurité

= 1.1.9 =
* **CORRIGÉ**: Meilleure gestion des catégories pour le parcours client

= 1.1.8 =
* **OPTIMISÉ**: Pourcentage de clients lisant des articles du blog

= 1.1.7 =
* **CORRIGÉ**: Parcours non enregistré pour les paiements retardés

= 1.1.6 =
* **OPTIMISÉ** : Code plus propre et maintenable

= 1.1.5 =
* **CORRIGÉ** : Le parcours client n'est maintenant sauvegardé que pour les commandes terminées

= 1.1.4 =
* **NOUVEAU** : Intégration améliorée de FunnelKit pour le suivi des parcours clients
* **NOUVEAU** : Détection automatique des produits FunnelKit sur les pages
* **NOUVEAU** : Intégration des produits FunnelKit dans l'analyse d'influence des catégories
* **AMÉLIORÉ** : Meilleur suivi des pages d'offres, checkout et landing FunnelKit

= 1.1.3 =
* **CORRECTIF**: Duplication de certains parcours client

= 1.1.2 =
* **NOUVEAU** : Compatibilité avec FunnelKit ajoutée (y compris upsell et order bump)
* **NOUVEAU** : Compatibilité avec les types personnalisés ajoutée pour le parcours client

= 1.1.1 =
* **AMÉLIORÉ** : Meilleure couverture de traduction française pour la section Analytics de Parcours Client
* **CORRIGÉ** : Corrections mineures et améliorations de traductions

= 1.1.0 =
* **NOUVEAU** : Analytics de Parcours Client (fonctionnalité Premium)
  * Suivi complet du parcours client de l'entrée à l'achat
  * Analyse des pages d'entrée pour identifier les meilleurs points de conversion
  * Visualisation des parcours populaires avec taux de conversion
  * Insights d'exploration de catégories avec graphiques interactifs
  * Filtrage du parcours par type de contenu (produits, articles, pages, archives)
* **NOUVEAU** : Outils de Conformité RGPD
  * Modèles de politique de confidentialité intégrés pour l'intégration EdenPersona
  * Guide de classification des cookies (nécessaires vs analytics)
  * Conseils d'implémentation pour la conformité à la vie privée
* **AMÉLIORÉ** : Tableau de bord analytics amélioré avec de meilleures performances
* **AMÉLIORÉ** : Meilleure gestion des erreurs et retour utilisateur
* **CORRIGÉ** : Diverses améliorations UI/UX et corrections de bugs

= 1.0.0 =
* Version initiale  
* **Fonctionnalités GRATUITES** : Tableau de bord d'analyses client complet  
* **Fonctionnalités GRATUITES** : Analyse des tendances de revenus et produits  
* **Fonctionnalités GRATUITES** : Segmentation client et analyse de fréquence  
* **Fonctionnalités GRATUITES** : Analyse de distribution géographique des ventes  
* **Fonctionnalités GRATUITES** : Fonctionnalité d'export CSV pour le marketing  
* **Fonctionnalités GRATUITES** : Seuils de dormance configurables  
* **Fonctionnalités GRATUITES** : Support multilingue (français inclus)  
* **Fonctionnalités PREMIUM** : Intégration EdenPersona pour des insights alimentés par l'IA  
* **Fonctionnalités PREMIUM** : Synchronisation automatique des données  
* Gestion des données conforme à la vie privée pour toutes les fonctionnalités

== Politique de confidentialité ==

**Analytics GRATUITES** : Tout le traitement des données se fait localement sur votre serveur WordPress. Aucune donnée n'est transmise vers des services externes.

**Fonctionnalités IA PREMIUM** : Si vous choisissez d'utiliser les fonctionnalités IA d'EdenPersona, le plugin transmet uniquement des données de commande anonymisées :

**Données transmises à EdenPersona :**  
- Totaux et dates de commande  
- IDs de produits et catégories  
- Adresses email client hachées (irréversibles)  
- Informations géographiques (ville/pays)  

**Données JAMAIS transmises :**  
- Noms de clients ou informations personnelles  
- Adresses email (seulement les versions hachées)  
- Adresses de facturation/livraison  

Toute transmission de données utilise des connexions HTTPS sécurisées et une authentification par jeton API. Vous pouvez révoquer l'accès à tout moment en supprimant votre jeton API des paramètres du plugin.  

Pour la politique de confidentialité complète d'EdenPersona, visitez : [https://www.edenpersona.com/privacy](https://www.edenpersona.com/privacy)

== Services externes ==

**Service externe OPTIONNEL (fonctionnalités PREMIUM uniquement) :**

Ce plugin peut optionnellement se connecter au service API d'EdenPersona pour les fonctionnalités alimentées par l'IA :  
- URL du service : [https://www.edenpersona.com](https://www.edenpersona.com)  
- Point de terminaison API : API sécurisée pour transmettre les données de commande WooCommerce anonymisées
- Objectif : Personas clients alimentés par l'IA et insights stratégiques  
- Données envoyées : Données de commande anonymisées uniquement (avec consentement utilisateur)  
- Activation : Seulement quand l'utilisateur fournit un jeton API de son abonnement EdenPersona  
- Politique de confidentialité : [https://www.edenpersona.com/privacy](https://www.edenpersona.com/privacy)  
- Conditions d'utilisation : [https://www.edenpersona.com/terms](https://www.edenpersona.com/terms)  

**Le plugin fonctionne entièrement sans aucun service externe – toutes les analyses sont disponibles localement.** 
