Die Grundlagen von Analytics

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

Hier lernst du die Grundlagen von AMP Analytics kennen.

amp-pixel oder amp-analytics verwenden?

AMP bietet zwei Komponenten, die dich bei Analytics und Messungen unterstützen sollen: amp-pixel und amp-analytics. Beide Optionen senden Analysedaten an einen definierten Endpoint.

Wenn du eine einfache Funktion wie den Tracking Pixel wünschst, kannst du das grundlegende Tracking von Seitenaufrufen der Komponente amp-pixel nutzen. Die Daten der Seitenaufrufe werden an eine angegebene URL gesendet. Manche Integrationen von Anbietern erfordern möglicherweise diese Komponente. In einem solchen Fall geben sie den genauen URL Endpunkt an.

Du kannst amp-analytics für die meisten Analytics Lösungen verwenden. Auch das Tracking von Seitenaufrufen funktioniert mit amp-analytics. Damit kannst du aber auch das User Engagement mit jeder Art von Seiteninhalt verfolgen, einschließlich Klicks auf Links und Buttons.

Sieh dir den Abschnitt Vertiefung von AMP Analytics an.

Als Teil der Integration mit der AMP Plattform stellen Anbieter vordefinierte Konfigurationen für amp-analytics bereit. Diese machen es einfacher, Daten zu erfassen und an die Tracking Tools zu übergeben. Die Dokumentation zu verschiedenen Anbietern findest du auf der Liste Analytics Anbieter.

Du kannst sowohl amp-pixel als auch amp-analytics auf deinen Seiten verwenden: amp-pixel für das einfache Tracking von Seitenaufrufen und amp-analytics für alles andere. Du kannst außerdem mehrere Instanzen dieser Tags hinzufügen. Wenn du mehrere Analytics Anbieter verwendest, benötigst du ein Tag pro Lösung. Beachte: Je einfacher die AMP Seite, desto besser ist es für Benutzer. Wenn du die zusätzlichen Tags also nicht brauchst, lass sie weg.

Erstelle eine einfache Analytics Konfiguration

Hier lernst du, wie du eine einfache Konfiguration für amp-pixel und amp-analytics erstellst.

Einfache Konfiguration für `amp-pixel`

Füge Folgendes im Abschnitt "body" deiner AMP Seite ein, um eine einfache Konfiguration für amp-pixel zu erstellen:

<amp-pixel src="https://foo.com/pixel?RANDOM"></amp-pixel>

In diesem Beispiel werden die Daten zu Seitenaufrufen zusammen mit einer Zufallszahl an die angegebene URL gesendet. Die Variable RANDOM ist eine von vielen Substitutionsvariablen der AMP Plattform. Weitere Informationen zur Variablensubstitution findest du hier.

Da die Komponente amp-pixel integriert ist, musst du ihre Einbindung nicht deklarieren (darin unterscheidet sie sich von anderen erweiternden Komponenten von AMP, einschließlich amp-analytics). Das Tag amp-pixel solltest du aber möglichst am Anfang des Abschnittes <body> platzieren. Das Tracking Pixel wird nur ausgelöst, wenn das Tag selbst angezeigt wird. Wenn amp-pixel am unteren Rand der Seite platziert wird, wird es möglicherweise nicht ausgelöst.

Einfache Konfiguration für `amp-analytics`

Um eine einfache Konfiguration für amp-analytics zu erstellen, musst du zunächst diese Deklaration von custom-element im Abschnitt <head> des AMP Dokuments einbinden (siehe auch Deklaration zur Einbindung von Komponenten):

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

Das folgende Beispiel ähnelt dem Beispiel zu amp-pixel. Jedes Mal, wenn eine Seite sichtbar wird, wird das Trigger Event ausgelöst und die Daten zu Seitenaufrufen werden zusammen mit einer zufälligen ID an die angegebene URL gesendet:

<amp-analytics>
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://foo.com/pixel?RANDOM"
      },
      "triggers": {
        "trackPageview": {
          "on": "visible",
          "request": "pageview"
        }
      }
    }
  </script>
</amp-analytics>

Im obigen Beispiel haben wir eine Anforderung mit dem Namen "pageview" als https://foo.com/pixel?RANDOM definiert. Wie bereits erwähnt, wird RANDOM durch eine Zufallszahl ersetzt, sodass die Anforderung tatsächlich wie folgt aussieht: https://foo.com/pixel?0.23479283687235653498734.

Wenn die Seite sichtbar wird (wie durch das Trigger Schlüsselwort visible festgelegt), wird ein Event ausgelöst und die Anforderung pageview wird gesendet. Das Attribut des Triggers bestimmt, wann die Anforderung des Seitenaufrufs ausgelöst wird. Erfahre mehr über Anforderungen und Trigger.

Variablensubstitution

Sowohl die Komponente amp-pixel als auch amp-analytics ermöglicht alle standardmäßigen Variablensubstitutionen in URLs (siehe AMP HTML Variablensubstitutionen). Im folgenden Beispiel wird die Anforderung des Seitenaufrufs zusammen mit der kanonischen URL des aktuellen AMP Dokuments, seinem Titel und einer Client ID an die URL gesendet:

<amp-pixel
  src="https://example.com/analytics?url=${canonicalUrl}&title=${title}&clientId=${clientId(site-user-id)}"
></amp-pixel>

Aufgrund seiner einfachen Struktur kann das Tag amp-pixel nur Variablen enthalten, die von der Plattform definiert wurden oder welche die AMP Runtime von der AMP Seite aus parsen kann. Im obigen Beispiel legt die Plattform sowohl die Werte für canonicalURL als auch für clientId(site-user-id) fest. Das Tag amp-analytics kann die gleichen Variablen wie amp-pixel sowie eindeutig definierte Variablen innerhalb der Tag Konfiguration enthalten.

Verwende in der Zeichenfolge der Anforderung für eine Seite oder eine plattformdefinierte Variable das Format ${varName}. Zum Zeitpunkt der Erstellung der Analytics Anforderung ersetzt das Tag amp-analytics das Template durch den tatsächlichen Wert (siehe auch Von amp-analytics unterstützte Variablen).

Im folgenden Beispiel für amp-analytics wird die Anforderung des Seitenaufrufs an die URL gesendet, wobei zusätzliche Daten aus Variablensubstitutionen extrahiert werden, von denen einige von der Plattform bereitgestellt und andere inline innerhalb der Konfiguration für amp-analytics definiert werden:

<amp-analytics>
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}&clientId=${clientId(site-user-id)}"
      },
      "vars": {
        "account": "ABC123"
      },
      "triggers": {
        "someEvent": {
          "on": "visible",
          "request": "pageview",
          "vars": {
            "title": "My homepage"
          }
        }
      }
    }
  </script>
</amp-analytics>

Im obigen Beispiel werden die Variablen account und title in der Konfiguration für amp-analytics definiert. Da die Variablen canonicalUrl und clientId nicht in der Konfiguration definiert sind, werden ihre Werte durch die Plattform ersetzt.

WICHTIG: Die Substitution von Variablen ist flexibel. Du kannst dieselben Variablen an verschiedenen Positionen definieren. Die AMP Runtime analysiert die Werte in dieser Rangfolge (siehe Reihenfolge der Variablensubstitution).

Benutzeridentifikation

Websites verwenden Cookies, um benutzerspezifische Informationen im Browser zu speichern. Mithilfe von Cookies kann ermittelt werden, ob Benutzer eine Website bereits besucht haben. In AMP können Seiten entweder von der Website des Publishers oder von einem Cache (wie dem Google AMP Cache) bereitgestellt werden. Die Website des Publishers und der Cache haben höchstwahrscheinlich unterschiedliche Domänen. Aus Sicherheitsgründen schränken Browser manchmal den Zugriff auf Cookies anderer Domänen ein (siehe auch Tracking von Benutzern über mehrere Quellen hinweg).

Standardmäßig verwaltet AMP die Bereitstellung einer Client ID, unabhängig davon, ob auf die Seite von der ursprünglichen Publisher Website oder über einen Cache zugegriffen wird. Die AMP generierte Client ID hat den Wert "amp-" gefolgt von einer zufälligen, mit base64 codierten Zeichenfolge, und sie bleibt für einen Benutzer gleich, der die Website erneut aufruft.

AMP verwaltet in allen Fällen das Lesen und Schreiben der Client ID. Das wird insbesondere dann deutlich, wenn eine Seite über einen Cache bereitgestellt oder auf andere Weise außerhalb des Anzeigekontexts der ursprünglichen Publisher Website angezeigt wird. In diesem Fall ist der Zugriff auf die Cookies der Publisher Website nicht verfügbar.

Wenn eine AMP Seite von einer Publisher Website bereitgestellt wird, kann das von AMP verwendete Client ID Framework darüber informiert werden, dass ein Fallback Cookie gesucht und verwendet werden soll. In diesem Fall wird das Argument cid-scope-cookie-fallback-name der Variablen clientId als Cookie Name interpretiert. Als Formatierung ist entweder CLIENT_ID(cid-scope-cookie-fallback-name) oder ${clientId(cid-scope-cookie-fallback-name)} möglich.

Zum Beispiel:

<amp-pixel
  src="https://foo.com/pixel?cid=CLIENT_ID(site-user-id-cookie-fallback-name)"
></amp-pixel>

Wenn AMP feststellt, dass dieses Cookie angelegt wurde, gibt die Client ID Substitution den Wert des Cookies zurück. Wenn AMP feststellt, dass dieses Cookie nicht angelegt wurde, generiert AMP einen Wert im Format amp- gefolgt von einer zufälligen, in base64 codierten Zeichenfolge.

Weitere Informationen zur Client ID Substitution und dazu, wie du eine optionale ID für Benutzerbenachrichtigungen hinzufügst, findest du unter Von amp-analytics unterstützte Variablen.

Weitere Informationen: Erfahre mehr über Analytics in Vertiefung von AMP Analytics und Use Cases.