Passer au contenu principal
Suivez la manière dont les utilisateurs interagissent avec votre documentation en la connectant à des plateformes d’analytics tierces. Mintlify envoie des événements d’engagement à vos fournisseurs d’analytics configurés.

​
Fonctionnement des intégrations Analytics

Lorsque vous ajoutez des intégrations Analytics à votre site de documentation, Mintlify suit les interactions des utilisateurs comme les pages vues, les requêtes de recherche, les requêtes du bac à sable d’API et les envois de retours, puis les envoie à vos plateformes d’Analytics. Vous pouvez connecter autant de plateformes d’Analytics prises en charge que vous le souhaitez en ajoutant vos clés d’API au fichier docs.json. Les événements Analytics sont transmis à vos plateformes dès que vous les ajoutez à votre configuration, sans configuration supplémentaire requise.

​
Plateformes prises en charge

Amplitude

Mixpanel

Clarté

PostHog

Google Analytics 4

Google Tag Manager

Hightouch

Hotjar

LogRocket

Pirsch

Plausible

Fathom

Clearbit

Heap

Segment

​
Configuration

Ajoutez les identifiants de votre fournisseur d’Analytics à l’objet integrations dans docs.json. N’ajoutez que les plateformes que vous souhaitez utiliser.
docs.json
"integrations": {
    "amplitude": {
        "apiKey": "required"
    },
    "clarity": {
        "projectId": "required"
    },
    "clearbit": {
        "publicApiKey": "required"
    },
    "cookies": {
      "key": "required",
      "value": "required"
    },
    "fathom": {
        "siteId": "required"
    },
    "ga4": {
        "measurementId": "required"
    },
    "gtm": {
        "tagId": "required"
    },
    "hightouch": {
        "apiKey": "required",
        "apiHost": "optionnel"
    },
    "hotjar": {
        "hjid": "required",
        "hjsv": "required"
    },
    "logrocket": {
        "appId": "required"
    },
    "mixpanel": {
        "projectToken": "required"
    },
    "pirsch": {
        "id": "required"
    },
    "plausible": {
        "domain": "required"
    },
    "posthog": {
        "apiKey": "required",
        "apiHost": "optionnel"
    },
    "segment": {
      "key": "required"
    },
    "telemetry": {
      "enabled": "boolean"
    }
}

​
Exemple de configuration

docs.json
{
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "posthog": {
      "apiKey": "phc_xxxxxxxxxxxxx",
      "apiHost": "https://app.posthog.com"
    },
    "mixpanel": {
      "projectToken": "xxxxxxxxxxxxx"
    }
  }
}

​
Événements suivis

Tous ces événements utilisent le préfixe docs..

​
Navigation et vues de page

Nom de l’événementDescription
docs.content.viewLorsqu’un utilisateur consulte une page. Uniquement disponible pour les fournisseurs d’Analytics qui ne suivent pas les vues de page par défaut.
docs.navitem.clickLorsqu’un utilisateur clique sur un élément de navigation de l’en-tête.
docs.navitem.cta_clickLorsqu’un utilisateur clique sur un bouton d’appel à l’action.
docs.footer.powered_by_mintlify_clickLorsqu’un utilisateur clique sur le lien « Powered by Mintlify ».
Nom de l’événementDescription
docs.search.closeLorsqu’un utilisateur ferme la barre de recherche.
docs.search.result_clickLorsqu’un utilisateur clique sur un résultat de recherche.

​
Code et bac à sable d’API

Nom de l’événementDescription
docs.code_block.copyLorsqu’un utilisateur copie du code à partir d’un bloc de code.
docs.code_block.ask_aiLorsqu’un utilisateur demande à l’Assistant d’expliquer un bloc de code.
docs.api_playground.requestLorsqu’un utilisateur appelle une API dans le bac à sable d’API.

​
Composants interactifs

Nom de l’événementDescription
docs.accordion.openUn utilisateur ouvre un Accordion.
docs.accordion.closeUn utilisateur ferme un Accordion.
docs.expandable.openUn utilisateur ouvre une section extensible.
docs.expandable.closeUn utilisateur ferme une section extensible.

​
Assistant et agent

Nom de l’événementDescription
docs.assistant.enterLorsqu’un utilisateur démarre un chat.
docs.assistant.completedLorsqu’une session de chat est terminée.
docs.assistant.source_clickLorsqu’un utilisateur clique sur une citation dans un chat.
docs.assistant.suggestion_clickLorsqu’un utilisateur clique sur une suggestion dans un chat.
docs.assistant.ask_ai_on_text_selectionLorsqu’un utilisateur sélectionne du texte et clique sur « Ask AI » pour poser une question à propos de cette sélection.
docs.assistant.sharedLorsqu’un utilisateur partage une conversation de chat.
docs.assistant.thumbs_upLorsqu’un utilisateur clique sur le bouton d’avis positif sur une réponse de l’Assistant IA.
docs.assistant.thumbs_downLorsqu’un utilisateur clique sur le bouton d’avis négatif sur une réponse de l’Assistant IA.
docs.assistant.spam_detectedLorsque l’Assistant IA détecte du spam dans un message d’utilisateur.
docs.autopilot.suggestion.createdLorsque l’agent crée une suggestion de mise à jour de la documentation.
docs.autopilot.suggestion.no_suggestionLorsque l’agent détermine qu’aucune mise à jour de la documentation n’est nécessaire.
Nom de l’événementDescription
docs.context_menu.copy_pageLorsqu’un utilisateur copie la page actuelle en Markdown.
docs.context_menu.copy_mcp_linkLorsqu’un utilisateur copie le lien du serveur MCP hébergé.
docs.context_menu.ai_provider_clickLorsqu’un utilisateur clique sur un fournisseur d’IA et crée une conversation avec la page actuelle comme contexte.
docs.context_menu.install_mcp_serverLorsqu’un utilisateur installe le serveur MCP hébergé sur des éditeurs de code.