AMP
DE
English Français العربية Español Italiano Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt

So konfigurierst du die grundlegende Analyse für deine AMP Seiten

Important: this documentation is not applicable to your currently selected format email!

Analyseplattformen werden gewöhnlich über Inline JavaScript Snippets und Funktionsaufrufe in Websites integriert. Diese triggern Ereignisse, die an das Analysesystem zurückgesendet werden. AMP bietet eine flexible JSON Konfigurationssyntax, um diesen Prozess für mehrere Analysepartner zu replizieren.

TIP – Wenn du Google Analytics als Analyseanbieter verwendest, solltest du amp-analytics kennen.

Als Kontext: Analyse auf Nicht-AMP Seiten

Das folgende Beispiel zeigt das herkömmliche JavaScript-gesteuerte Google Analytics Tracking. Wir werden es in das amp-analytics JSON Format umschreiben, schauen uns aber zuerst die traditionellen Methode an:

<script>
  (function (i, s, o, g, r, a, m) {
    i['GoogleAnalyticsObject'] = r;
    (i[r] =
      i[r] ||
      function () {
        (i[r].q = i[r].q || []).push(arguments);
      }),
      (i[r].l = 1 * new Date());
    (a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);
    a.async = 1;
    a.src = g;
    m.parentNode.insertBefore(a, m);
  })(
    window,
    document,
    'script',
    '//www.google-analytics.com/analytics.js',
    'ga'
  );

  ga('create', 'UA-XXXXX-Y', 'auto');
  ga('send', 'pageview');
</script>

Dieses JavaScript ist recht einfach; es sendet eine Benachrichtigung, um das "pageview" Ereignis zu verfolgen.

Schritt 1: Nimm das amp-analytics Skript auf

Um diese Funktionalität in AMP zu replizieren, müssen wir zuerst die Komponente amp-analytics in den <head> unseres Dokuments aufnehmen:

<script
  async
  custom-element="amp-analytics"
  src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"
></script>

Schritt 2: Füge den Konfigurationscode hinzu

Dann fügen wir die Komponente amp-analytics am Ende des body unseres Dokuments hinzu:

<amp-analytics type="googleanalytics">
  <script type="application/json">
    {
      "vars": {
        "account": "UA-YYYY-Y"
      },
      "triggers": {
        "default pageview": {
          "on": "visible",
          "request": "pageview",
          "vars": {
            "title": "Name of the Article"
          }
        }
      }
    }
  </script>
</amp-analytics>

Genau wie beim JavaScript Beispiel oben auf dieser Seite sendet dieses amp-analytics Snippet eine Benachrichtigung an Google Analytics, die angibt, dass eine Seite angezeigt wurde.

Um dies anzugeben, haben wir den type auf googleanalytics gesetzt und dann im JSON einen Trigger erstellt, den wir "default pageview" genannt haben. Dieser Trigger wird ausgelöst, wenn die Seite sichtbar ist (aufgrund von "on": "visible"). Wenn er ausgelöst wird, senden wir an Google Analytics eine pageview Analyseanforderung mit dem von uns angegebenen vars.

Das für die Konfiguration von amp-analytics verwendete JSON ist ein sehr flexibles Format. Es beschreibt, welche Analysedaten wann gesendet werden sollen. amp-analytics enthält vollständige Details über das Format.

Schritt 3: Hinzufügen weiterer Trigger

Vom obigen Beispiel ausgehend können wir einen weiteren Trigger mit dem Namen "click on #header trigger" hinzufügen:

<amp-analytics type="googleanalytics">
  <script type="application/json">
    {
      "vars": {
        "account": "UA-YYYY-Y"
      },
      "triggers": {
        "default pageview": {
          "on": "visible",
          "request": "pageview",
          "vars": {
            "title": "Name of the Article"
          }
        },
        "click on #header trigger": {
          "on": "click",
          "selector": "#header",
          "request": "event",
          "vars": {
            "eventCategory": "examples",
            "eventAction": "clicked-header"
          }
        }
      }
    }
  </script>
</amp-analytics>

Wie der Name dieses neuen Triggers schon sagt, wird er ausgelöst, wenn das Element mit der ID "header" angeklickt wird (angegeben durch "on": "click" und "selector": "#header"). Wenn dieser Trigger ausgelöst wird, senden wir die Anfrage event an unseren Analyseanbieter, wobei wir bestimmte Variablen angeben, die in die Anfrage aufgenommen werden sollen.

Wenn du eine benutzerdefinierte Trackingplattform integrieren möchtest, kannst du weiterhin amp-analytics verwenden und deine eigenen personalisierten URL Endpoints definieren, an welche die Trackingdaten gesendet werden sollen. Weitere Informationen bietet die Referenzdokumentation für die Komponente amp-analytics.

HINWEIS: "UA-YYYY-Y" ist ein Beispielkonto für Google Analytics. Es muss durch den Google Analytics Trackingcode deiner eigenen Website ersetzt werden, falls du dieses Beispiel auf deiner Website verwendest.

TIPP: Wenn du ein einfacheres Trackingsystem bevorzugst, schau dir amp-pixel an. Wenn du nur Seitenaufrufe verfolgen musst, eignet sich amp-pixel besser als amp-analytics, da nur die Anforderungen von herkömmlichem Pixel Tracking dafür gelten. Weitere Informationen findest du unter Die Grundlagen von Analytics.