DOXFX mit Application Insights Endbenutzer-Benutzeranalysen

Question

Wie können Sie Endbenutzer-Analysen für Endbenutzer von Application Insights zu DocFx hinzufügen, um die Verwendung jeder Dokumentationsseite zu verfolgen?

Die Application Insights-Dokumentation besagt, dass Sie das untenstehende JavaScript-Snippet unmittelbar vor dem schließenden Tag einfügen müssen. Ich bin mir jedoch nicht sicher, ob dies in DocFx oder dem besten Weg möglich ist.

Benötigen Sie einen Postprozessor oder könnten Sie eine benutzerdefinierte Vorlage verwenden?

<!-- 
To collect end-user usage analytics about your application, 
insert the following script into each page you want to track. 
Place this code immediately before the closing </head> tag, 
and before any other scripts. Your first data will appear 
automatically in just a few seconds. 
--> 
<script type="text/javascript"> 
    var appInsights=window.appInsights||function(config){ 
    function i(config){t[config]=function(){var 
i=arguments;t.queue.push(function(){t[config].apply(t,i)})}}var t={config:config},u=document,e=window,o="script",s="AuthenticatedUserContext",h="start",c="stop",l="Track",a=l+"Event",v=l+"Page",y=u.createElement(o),r,f;y.src=config.url||"https://az416426.vo.msecnd.net/scripts/a/ai.0.js";u.getElementsByTagName(o)[0].parentNode.appendChild(y);try{t.cookie=u.cookie}catch(p){}for(t.queue=[],t.version="1.0",r=["Event","Exception","Metric","PageView","Trace","Dependency"];r.length;)i("track"+r.pop());return i("set"+s),i("clear"+s),i(h+a),i(c+a),i(h+v),i(c+v),i("flush"),config.disableExceptionTracking||(r="onerror",i("_"+r),f=e[r],e[r]=function(config,i,u,e,o){var s=f&&f(config,i,u,e,o);return s!==!0&&t["_"+r](config,i,u,e,o),s}),t 
    }({ 
     instrumentationKey:"###-###-###-##" 
    }); 

    window.appInsights=appInsights; 
    appInsights.trackPageView(); 
</script> 

Answer 1

Kein Postprozessor wird benötigt. Sie können dies erreichen, indem Sie die Vorlage anpassen. Weitere Informationen finden Sie in official tutorial oder this question. Sie können Ihren Code in partials/head.tmpl.partial hinzufügen. Es wirkt sich auf alle generierten Seiten aus.