> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics mit deiner App verbinden

> Zeige Traffic-, Engagement- und Kampagnendaten aus Google Analytics in den Dashboards und Berichten deiner App, mit einem gemeinsamen Konto oder dem eigenen Konto jeder Person.

Verbinde deine App mit Google Analytics, um Traffic-Trends, Engagement und Kampagnenergebnisse in Dashboards und Berichten zu zeigen. Nutze ein gemeinsames Google-Konto für deine ganze App oder lass jede Person ihr eigenes verbinden.

***

## Was du tun kannst

Bring deine Google-Analytics-Daten in deine App.

> [card] Traffic-Trends zeigen
>
> Zeige Besuche, Top-Seiten und Traffic-Quellen im Zeitverlauf in einem Dashboard in deiner App.

> [card] Nutzerverhalten analysieren
>
> Sieh dir Engagement und Conversion-Funnels an, um zu erkennen, wo Besucher abspringen.

> [card] Regelmäßige Berichte erstellen
>
> Erstelle wöchentliche Berichte mit Traffic- und Engagement-Daten für dein Team.

> [card] Kampagnen verfolgen
>
> Vergleiche mit deinen Analytics-Daten, wie deine Marketingkampagnen abschneiden.

**Beispiel-Prompts**

Beschreibe im KI-Chat die Property, die anzuzeigenden Kennzahlen und den Zeitraum. Zum Beispiel:

```text wrap theme={null}
Zeige die Traffic-Trends meiner Website und die erfolgreichsten Seiten an.
```

```text wrap theme={null}
Erstelle ein Dashboard mit den wichtigsten Analytics-Kennzahlen.
```

```text wrap theme={null}
Analysiere Nutzerverhalten und Conversion-Funnels aus Analytics.
```

```text wrap theme={null}
Erstelle wöchentliche Berichte mit Traffic- und Engagement-Daten.
```

```text wrap theme={null}
Verfolge die Leistung von Marketingkampagnen anhand von Analytics-Daten.
```

***

## Google Analytics verbinden

Wähle, wie sich Personen verbinden: mit einem gemeinsamen Konto für deine ganze App oder jeweils mit ihrem eigenen Konto.

> [tab] Gemeinsamer Connector
>
> Verbinde ein Google-Konto. Alle, die deine App nutzen, teilen es und seine Analytics-Daten.
>
> **So fügst du einen gemeinsamen Google-Analytics-Connector hinzu:**
>
> 1. Klicke in der Seitenleiste deines Workspaces auf **Konnektoren**.
>
> 2. Klicke auf **Connector hinzufügen**.
>
> 3. Suche nach **Google Analytics** und klicke darauf.
>
> 4. Wähle **Gemeinsamer Connector** aus und klicke dann auf **Weiter**.
>
> 5. Gib einen **Verbindungsname** ein.
>
> 6. Wähle unter **Wer hat Zugriff** **Apps und Super-Agent**, **Nur Apps** oder **Nur Super-Agent**. **Apps und Super-Agent** ist standardmäßig ausgewählt.
>
> 7. Wähle unter **Berechtigungen** die [Scopes](#scopes-and-permissions), die deine App braucht:
>
>    * **Nur Lesen:** Deine App kann deine Analytics-Daten und -Einstellungen ansehen. Das ist der Standard.
>    * **Lesen & schreiben:** Deine App kann außerdem die Einstellungen deines Analytics-Kontos und deiner Property ändern.
>    * **Benutzerdefiniert:** Wähle die optionalen Berechtigungen aus, die deine App braucht. Erforderliche Berechtigungen bleiben ausgewählt.
>
>    ![Einrichtung eines gemeinsamen Google-Analytics-Connectors mit Connection name, Who can access und ausgewählten Read-only-Berechtigungen](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-shared-setup.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=cd95db20bce0213e7874e1cb16c1eb6b)
>
>    Einen gemeinsamen Google-Analytics-Connector einrichten
>
> 8. Klicke auf **Connector hinzufügen**.
>
> 9. Melde dich mit dem Google-Konto an, das Zugriff auf deine Analytics-Properties hat.

> [tab] App-Nutzer-Connector
>
> Jede Person verbindet ihr eigenes Google-Konto. So kann deine App die Analytics-Properties zeigen, auf die sie Zugriff hat.
>
> > [!WARNING]
> >
> > Nur Workspace-Owner und -Admins können das einrichten.
>
> > [!TIP]
> >
> > **Bevor du einen App-Nutzer-Connector einrichtest:** Du brauchst einen OAuth-Client in Google Cloud mit seiner Client-ID und seinem Client-Secret. Aktiviere im selben Google-Cloud-Projekt die Google Analytics Data API. Aktiviere auch die Google Analytics Admin API, wenn deine App Properties auflistet oder Einstellungen ändert. Siehe [Deinen eigenen OAuth-Client verwenden](https://docs.base44.com/de/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **So fügst du einen App-Nutzer-Connector für Google Analytics hinzu:**
>
> 1. Klicke in der Seitenleiste deines Workspaces auf **Konnektoren**.
>
> 2. Klicke auf **Connector hinzufügen**.
>
> 3. Suche nach **Google Analytics** und klicke darauf.
>
> 4. Wähle **App-Benutzer-Connector** aus und klicke dann auf **Weiter**.
>
> 5. Kopiere die **Callback-URL**.
>
> 6. Füge die Callback-URL in deinem OAuth-Client in Google Cloud zu den autorisierten Redirect-URIs hinzu.
>
> 7. Gib im Formular **Add Google Analytics Connection** einen **Connector name** ein.
>
> 8. Gib deine **Client-ID** ein.
>
> 9. Gib dein **Client-Geheimnis** ein.
>
> 10. Wähle unter **Scopes** die [Scopes](#scopes-and-permissions), die deine App braucht.
>
>     ![Die Scope-Liste für Google Analytics mit gesperrtem email und analytics readonly und analytics edit zur Auswahl](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-app-user-scopes.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=7610bcb079782883d45daf160a69f252)
>
>     Scopes für einen App-Nutzer-Connector wählen
>
> 11. Klicke auf **Konnektor hinzufügen**.
>
> 12. Gehe zu deinem App-Editor.
>
> 13. Bitte den KI-Chat, eine Möglichkeit hinzuzufügen, mit der Personen ihr eigenes Google-Analytics-Konto verbinden können.

***

## Scopes und Berechtigungen

Scopes steuern, was deine App in Google Analytics tun kann. Du wählst sie, wenn du einen Connector einrichtest.

> [card]
>
> **1. Base44 fügt hinzu**
>
> Base44 nimmt diesen Scope immer auf. Du siehst ihn gesperrt unter **Benutzerdefiniert** bei einem gemeinsamen Connector oder unter **Scopes** bei einem App-Nutzer-Connector.
>
> * `email`: Das Google-Konto identifizieren, das sich verbindet
>
> **2. Du konfigurierst**
>
> Wähle bei einem gemeinsamen Connector eine Berechtigungsoption oder bei einem App-Nutzer-Connector die Scopes. Die Namen der Google-Analytics-Scopes beginnen mit `https://www.googleapis.com/auth/`:
>
> * `analytics.readonly`: Deine Analytics-Daten und -Einstellungen ansehen
> * `analytics.edit`: Die Einstellungen deines Analytics-Kontos und deiner Property bearbeiten
>
> **Zugriff:** Deine App sieht die Analytics-Konten und -Properties, auf die das verbundene Google-Konto zugreifen kann.

***

## Backend-Funktionen nutzen

Sobald Google Analytics verbunden ist, können deine Backend-Funktionen ein Zugriffstoken abrufen und die Google Analytics Data API direkt aufrufen. Base44 übernimmt die Anmeldung und hält das Token für dich aktuell.

* Für eine gemeinsame Verbindung nutze `getConnection()`, um das Token abzurufen.
* Für eine App-Nutzer-Verbindung nutze `getCurrentAppUserConnection()`, damit jede Anfrage das Token der angemeldeten Person verwendet.

Rufe die Google Analytics Data API unter `analyticsdata.googleapis.com` auf und übergib das Token im Header `Authorization`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("google_analytics");

const propertyId = "123456789"; // Your Google Analytics property ID

const response = await fetch(
  `https://analyticsdata.googleapis.com/v1beta/properties/${propertyId}:runReport`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
      dimensions: [{ name: "pagePath" }],
      metrics: [{ name: "screenPageViews" }],
    }),
  },
);
const report = await response.json();
```

> [card] [Gemeinsame Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/shared-connectors.md)
>
> Konfiguriere, deploye und rufe eine gemeinsame Verbindung aus einer Backend-Funktion auf.

> [card] [App-Nutzer-Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/app-user-connectors.md)
>
> Rufe ein Token pro Nutzer ab und rufe die API im Namen der angemeldeten Person auf.

***

## Fehlerbehebung

Prüfe die Verbindung, das Google-Konto und seine Scopes, wenn Google Analytics in deiner App nicht mehr funktioniert.

> [accordion] Die Verbindung muss neu verbunden werden
>
> Wenn der Zugriff auf Google Analytics verloren geht oder abläuft, zeigt die Verbindung einen Bereich **Diese Verbindung erneut verbinden**. Bei einem gemeinsamen Connector [verbindest du ihn neu](https://docs.base44.com/de/Integrations/Connectors.md#managing-your-connectors) und meldest dich mit demselben Google-Konto an. Jede App, die ihn nutzt, funktioniert dann wieder. Bei einem App-Nutzer-Connector verbindet jede Person ihr eigenes Konto in deiner App neu.

> [accordion] Meine Analytics-Daten erscheinen nicht
>
> Prüfe, ob das verbundene Google-Konto Zugriff auf die gewünschte Property hat und ob deine App die ID dieser Property nutzt. Eine neue Property braucht eventuell eine Weile, um Daten zu sammeln. Vergleiche daher denselben Zeitraum in Google Analytics.

> [accordion] Meine App kann Analytics-Einstellungen nicht ändern
>
> Deine App braucht den Scope `analytics.edit`, um Konto- und Property-Einstellungen zu ändern.
>
> * Bei einem gemeinsamen Connector werden die Berechtigungen beim Hinzufügen der Verbindung festgelegt. Klicke auf der Seite des Google-Analytics-Connectors auf **Weiteren Connector hinzufügen** und wähle **Lesen & schreiben** für die neue Verbindung.
> * Öffne einen App-Nutzer-Connector auf der Seite des Google-Analytics-Connectors, füge seinen Scopes `analytics.edit` hinzu und klicke auf **Änderungen speichern**. Personen, die sich bereits verbunden haben, behalten ihren bisherigen Zugriff, bis sie sich erneut verbinden.

> [accordion] Manche Personen können ihr eigenes Google-Konto nicht verbinden
>
> Dein OAuth-Client startet im Testmodus. Dort können sich nur genehmigte Testnutzer verbinden. Bevor du den Zugriff breiter öffnest, stelle deine OAuth-App auf Produktion um und schließe jede Verifizierung ab, die Google verlangt.

> [accordion] Das Verbinden schlägt mit einem Redirect-URI-Fehler fehl
>
> Kopiere die **Callback-URL** aus dem Formular **Add Google Analytics Connection**. Füge sie genau so zu den autorisierten Redirect-URIs in deinem OAuth-Client in Google Cloud hinzu.

***

## FAQs

> [accordion] Welche Google-Analytics-Rolle braucht das Konto?
>
> Verbinde ein Google-Konto, das mindestens die Rolle Viewer für die Properties hat, die du zeigen möchtest. Damit deine App Konto- oder Property-Einstellungen ändern kann, braucht das Konto die Rolle Editor.

> [accordion] Kann meine App mehr als eine Property nutzen?
>
> Ja. Wenn das verbundene Google-Konto Zugriff auf mehrere Properties hat, nenne im KI-Chat die gewünschte. Oder bitte um eine Möglichkeit, zwischen ihnen zu wechseln.

> [accordion] Kann ich Google Analytics und die Google Search Console zusammen nutzen?
>
> Ja. Füge jeden Connector separat hinzu. Bitte dann den KI-Chat, den Traffic aus Google Analytics mit der Suchleistung aus der [Google Search Console](https://docs.base44.com/de/Integrations/google-search-console-connector.md) in einem Dashboard zu kombinieren.

> [!NOTE]
>
> Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der [englischen Version](https://docs.base44.com/index.md).


## Related topics

- [Google Maps mit deiner App verbinden](https://docs.base44.com/de/Integrations/google-maps-connector.md)
- [Google Search Console mit deiner App verbinden](https://docs.base44.com/de/Integrations/google-search-console-connector.md)
- [Eine Domain mit deiner App verbinden](https://docs.base44.com/de/Setting-up-your-app/Setting-up-your-custom-domain.md)
- [Snowflake mit deiner App verbinden](https://docs.base44.com/de/Integrations/snowflake-connector.md)
- [Databricks mit deiner App verbinden](https://docs.base44.com/de/Integrations/databricks-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.