{
  "version": "5.1-FAQ-UPDATED",
  "lastUpdated": "2025-01-14",
  "basedOn": "Real issues and solutions from unified API documentation",
  "categories": {
    "installation_sdk_v5_1": {
      "questions": [
        {
          "q": "Comment installer le SDK v5.1 DÉDUPLICATION ?",
          "r": "Utilisez l'URL officielle : https://lqppxmjtytwvsosfizdm.supabase.co/functions/v1/leadtracker-unified-sdk avec validation automatique intégrée. Code complet disponible dans la documentation API unifiée.",
          "code": "<script src=\"https://lqppxmjtytwvsosfizdm.supabase.co/functions/v1/leadtracker-unified-sdk\"></script>",
          "validation": "Vérification automatique dans la console avec diagnostic intégré"
        },
        {
          "q": "Le SDK v5.1 ne se charge pas, que faire ?",
          "r": "1) Vérifiez la console pour erreurs, 2) Testez l'URL alternative /leadtracker-unified-sdk.js, 3) Vérifiez les bloqueurs de pub, 4) Utilisez l'outil diagnostic intégré dans l'interface.",
          "diagnostic": "Composant DiagnosticTab disponible pour test automatique"
        },
        {
          "q": "Comment vérifier que l'installation v5.1 fonctionne ?",
          "r": "Utilisez le diagnostic automatique : setTimeout(() => { const diag = leadTracker.diagnostic(); console.log('Diagnostic v5.1:', diag); }, 1000);",
          "outil": "Interface de diagnostic complète dans l'onglet Diagnostic"
        }
      ]
    },
    "deduplication_v5_1": {
      "questions": [
        {
          "q": "Comment fonctionne la déduplication v5.1 ?",
          "r": "Algorithmes avancés : session-based, browser fingerprinting, cookie sync, IP tracking. Déduplication automatique sans configuration.",
          "techniques": ["Session deduplication", "Browser fingerprinting", "Cookie synchronization", "IP-based tracking"]
        },
        {
          "q": "Les conversions sont-elles dédupliquées automatiquement ?",
          "r": "Oui, le SDK v5.1 inclut la déduplication automatique pour tous les types de conversions (leads et ventes) avec validation temps réel.",
          "automatique": true
        },
        {
          "q": "Comment configurer la déduplication avancée ?",
          "r": "La déduplication v5.1 est automatique. Pour configuration avancée, consultez le guide technique spécialisé déduplication dans la documentation.",
          "guide": "directaffi-deduplication-advanced-v5.json"
        }
      ]
    },
    "cors_headers_resolution": {
      "questions": [
        {
          "q": "J'ai des erreurs CORS 403, comment les résoudre ?",
          "r": "Le SDK v5.1 résout automatiquement les erreurs CORS avec headers Supabase obligatoires (apikey, Authorization). Plus d'erreurs 403 avec la nouvelle version.",
          "solution": "Headers ajoutés automatiquement par le SDK v5.1",
          "headers": ["apikey", "Authorization", "Content-Type", "x-client-info"]
        },
        {
          "q": "Le SDK v5.1 corrige-t-il définitivement les problèmes CORS ?",
          "r": "Oui, la v5.1 CORS-FIX inclut tous les headers Supabase obligatoires automatiquement. Fini les erreurs 403 et les blocages de requêtes.",
          "definitif": true
        }
      ]
    },
    "patterns_detection": {
      "questions": [
        {
          "q": "Quels patterns le SDK v5.1 détecte-t-il automatiquement ?",
          "r": "Leads: /contact, /about, /services, /pricing, /blog, /faq. Conversions: /checkout/success, /subscription/success, /welcome. Routage automatique vers les bons endpoints.",
          "leads_patterns": ["/contact", "/about", "/services", "/pricing", "/blog", "/faq"],
          "conversions_patterns": ["/checkout/success", "/subscription/success", "/welcome"]
        },
        {
          "q": "Comment personnaliser les patterns de détection ?",
          "r": "Le SDK v5.1 inclut les patterns les plus courants. Pour personnalisation avancée, utilisez l'enregistrement manuel avec leadTracker.recordLead() ou leadTracker.recordConversion().",
          "manuel": "leadTracker.recordLead({leadType: 'custom', metadata: {source: 'custom_pattern'}})"
        }
      ]
    },
    "diagnostic_troubleshooting": {
      "questions": [
        {
          "q": "Comment utiliser l'outil de diagnostic v5.1 ?",
          "r": "Accédez à l'onglet Diagnostic dans la documentation API unifiée. Tests automatiques : SDK chargé, CORS headers, connectivité endpoints, cookies sync.",
          "composant": "DiagnosticTab avec interface complète",
          "tests": ["SDK loaded", "CORS headers", "Endpoint connectivity", "Cookie synchronization"]
        },
        {
          "q": "Le diagnostic indique un problème, que faire ?",
          "r": "Le diagnostic v5.1 propose des solutions automatiques. Suivez les recommandations affichées ou contactez le support avec les détails du diagnostic.",
          "solutions_auto": true
        }
      ]
    },
    "exemples_code_reel": {
      "questions": [
        {
          "q": "Où trouver des exemples de code v5.1 fonctionnels ?",
          "r": "Documentation API unifiée, onglets Tutorial et Installation. Exemples e-commerce et SaaS complets extraits du code de production validé.",
          "source": "codeExamples.ts - Code réel testé en production"
        },
        {
          "q": "Comment implémenter le tracking e-commerce v5.1 ?",
          "r": "Exemple complet disponible : détection automatique /checkout/success, extraction montant commande, enregistrement conversion avec métadonnées.",
          "exemple": "Code complet dans codeExamples.ts ecommerceExample"
        }
      ]
    },
    "migration_v4_v5": {
      "questions": [
        {
          "q": "Comment migrer de v4.0 vers v5.1 ?",
          "r": "1) Remplacer URL script, 2) Vider cache, 3) Tester avec ?ref=test123, 4) Vérifier diagnostic, 5) Confirmer absence erreurs CORS. Guide complet dans la documentation.",
          "etapes": 5,
          "guide": "Migration détaillée dans directaffi-integration-guide-v5.json"
        }
      ]
    }
  },
  "support_technique": {
    "diagnostic_automatique": "Interface DiagnosticTab pour résolution automatique",
    "documentation_complete": "API unifiée avec exemples réels",
    "code_production": "Exemples validés extraits du code réel"
  }
}