Anleitung: Google Analytics

In diesem Tutorial erfahren Sie, wie Sie mit Google Analytics die Nutzung Ihrer Erweiterung erfassen. Wenn Sie der Entwicklung einer Plattform-App erhalten Sie unter Analysen für Apps, da für Apps andere Einschränkungen gelten als Erweiterungen.

Voraussetzungen

Für diese Anleitung sollten Sie mit dem Schreiben von Erweiterungen für Google Chrome vertraut sein. Wenn Sie Wenn Sie Informationen zum Schreiben einer Erweiterung benötigen, lesen Sie die Anleitung für die ersten Schritte.

Außerdem muss ein Google Analytics-Konto eingerichtet sein, um die Erweiterung zu erfassen. Wenn Sie Einrichtung des Kontos können Sie einen beliebigen Wert im Feld "Website-URL" verwenden, da die Erweiterung keine eine eigene URL haben.

Die Analyseeinrichtung mit ausgefüllten Informationen zu einer Chrome-Erweiterung

Installieren des Tracking-Codes

Mit dem standardmäßigen Google Analytics-Tracking-Code-Snippet wird eine Datei mit dem Namen ga.js von einer SSL- geschützte URL, wenn die aktuelle Seite mit dem https://-Protokoll geladen wurde. Chrome-Erweiterungen und Anwendungen dürfen nur die SSL-geschützte Version von ga.js verwenden. ga.js wird über unsicher geladen HTTP ist gemäß der standardmäßigen Content Security Policy von Chrome nicht zugelassen. Diese und die Tatsache, dass Chrome Erweiterungen unter dem chrome-extension://-Schema gehostet, erfordert eine geringfügige Änderung am übliches Tracking-Snippet, um ga.js direkt aus https://ssl.google-analytics.com/ga.js abzurufen statt des standardmäßigen Speicherorts.

Im Folgenden sehen Sie ein modifiziertes Snippet für die asynchrone Tracking API (die geänderte Zeile ist fett gedruckt):

(function() {
  var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
  ga.src = 'https://ssl.google-analytics.com/ga.js';
  var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();

Sie müssen außerdem dafür sorgen, dass Ihre Erweiterung die Berechtigung hat, die Ressource zu laden, indem Sie die Standard-Content Security Policy. Die Richtliniendefinition in Ihrem manifest.json könnte so aussehen:

{
  ...,
  "content_security_policy": "script-src 'self' https://ssl.google-analytics.com; object-src 'self'",
  ...
}

Dies ist eine Pop-up-Seite (popup.html), die den asynchronen Tracking-Code über eine externe JavaScript-Datei (popup.js) und erfasst einen einzelnen Seitenaufruf:

<!DOCTYPE html>
<html>
 <head>
   ...
  <script src="popup.js"></script>
 </head>
 <body>
   ...
 </body>
</html>

var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-XXXXXXXX-X']);
_gaq.push(['_trackPageview']);

(function() {
  var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
  ga.src = 'https://ssl.google-analytics.com/ga.js';
  var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();

Der String UA-XXXXXXXX-X muss durch den String Ihrer eigenen Google Analytics-Property ersetzt werden. Kontonummer.

Seitenaufrufe erfassen

Mit dem Code _gaq.push(['_trackPageview']); wird ein einzelner Seitenaufruf erfasst. Dieser Code kann verwendet werden für: auf jeder Seite Ihrer Erweiterung. Wenn es auf einer Hintergrundseite platziert wird, zählt dies einmal pro Browsersitzung. In einem Pop-up wird eine Ansicht jedes Mal registriert, wenn das Pop-up aufgerufen wird. geöffnet.

Anhand der Daten zu den Seitenaufrufen für jede Seite in Ihrer Erweiterung können Sie erkennen, wie viele Wie oft Nutzer pro Browsersitzung mit der Erweiterung interagieren:

Analytics-Ansicht der beliebtesten Inhalte einer Website

Monitoring von Analyseanfragen

Um sicherzustellen, dass Tracking-Daten von Ihrer Erweiterung an Google Analytics gesendet werden, können Sie im Fenster der Entwicklertools auf die Seiten Ihrer Erweiterung. Weitere Informationen finden Sie in der Anleitung zur Fehlerbehebung. Informationen). Wie die folgende Abbildung zeigt, sollten Anfragen für eine Datei mit dem Namen __utm.gif, wenn alles korrekt eingerichtet ist.

Fenster der Entwicklertools mit der Anforderung __utm.gif

Tracking-Ereignisse

Durch Konfigurieren des Ereignis-Trackings können Sie ermitteln, mit welchen Teilen der Erweiterung Nutzer interagieren. mit den meisten Nutzern. Sie haben beispielsweise drei Schaltflächen, auf die Nutzer klicken können:

<button id='button1'>Button 1</button>
<button id='button2'>Button 2</button>
<button id='button3'>Button 3</button>

Schreiben Sie eine Funktion, die Klickereignisse an Google Analytics sendet:

function trackButton(e) {
  _gaq.push(['_trackEvent', e.target.id, 'clicked']);
};

Und verwenden Sie es als Event-Handler für den Klick auf die einzelnen Schaltflächen:

var buttons = document.querySelectorAll('button');
for (var i = 0; i < buttons.length; i++) {
  buttons[i].addEventListener('click', trackButtonClick);
}

Auf der Übersichtsseite zum Ereignis-Tracking in Google Analytics sehen Sie, wie oft jede einzelne Schaltfläche angeklickt wird:

Analytics-Datenansicht der Ereignis-Tracking-Daten für eine Website

Mit diesem Ansatz können Sie sehen, welche Teile Ihrer Erweiterung zu wenig oder zu stark ausgelastet sind. Dieses -Informationen können Entscheidungen über Neugestaltungen der Benutzeroberfläche oder zusätzliche Funktionen, die implementiert werden sollen, helfen.

Weitere Informationen zum Ereignis-Tracking finden Sie in der Google Analytics-Entwicklerdokumentation. Dokumentation.

Beispielcode

Eine Beispielerweiterung, die diese Techniken verwendet, finden Sie im Beispiel-Repository.