> ## 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.

# Connettere Google Analytics alla tua app

> Mostra i dati di traffico, engagement e campagne di Google Analytics nelle dashboard e nei report della tua app, con un account condiviso o con l'account di ogni persona.

Connetti la tua app a Google Analytics per mostrare tendenze del traffico, engagement e risultati delle campagne in dashboard e report. Usa un unico account Google condiviso per tutta l'app, oppure lascia che ogni persona colleghi il proprio.

***

## Cosa puoi fare

Porta i tuoi dati di Google Analytics nella tua app.

> [card] Mostra le tendenze del traffico
>
> Mostra visite, pagine principali e sorgenti di traffico nel tempo in una dashboard all'interno della tua app.

> [card] Analizza il comportamento degli utenti
>
> Esamina l'engagement e i funnel di conversione per vedere dove i visitatori abbandonano.

> [card] Crea report periodici
>
> Genera report settimanali con i dati su traffico ed engagement per il tuo team.

> [card] Monitora le campagne
>
> Confronta il rendimento delle tue campagne di marketing usando i dati di Analytics.

**Prompt di esempio**

Nella chat AI, descrivi la proprietà, le metriche da mostrare e l'intervallo di date. Per esempio:

```text wrap theme={null}
Mostra le tendenze del traffico del mio sito web e le pagine con il rendimento migliore.
```

```text wrap theme={null}
Crea una dashboard che mostri le metriche di analytics principali.
```

```text wrap theme={null}
Analizza il comportamento degli utenti e i funnel di conversione da Analytics.
```

```text wrap theme={null}
Genera report settimanali con i dati su traffico ed engagement.
```

```text wrap theme={null}
Monitora il rendimento delle campagne di marketing usando i dati di Analytics.
```

***

## Connettere Google Analytics

Scegli come si collegano le persone: un unico account condiviso per tutta l'app, oppure l'account personale di ogni persona.

> [tab] Connettore condiviso
>
> Collega un account Google, e tutti quelli che usano la tua app condividono l'account e i suoi dati di Analytics.
>
> **Per aggiungere un connettore Google Analytics condiviso:**
>
> 1. Clicca **Connectors** nella barra laterale del workspace.
>
> 2. Clicca **Add connector**.
>
> 3. Cerca **Google Analytics** e cliccaci sopra.
>
> 4. Seleziona **Shared connector**, poi clicca **Next**.
>
> 5. Inserisci un **Connection name**.
>
> 6. In **Who can access**, scegli **Apps and Super agent**, **Apps only** o **Super agent only**. **Apps and Super agent** è selezionato per impostazione predefinita.
>
> 7. Scegli gli [scope](#scopes-and-permissions) che servono alla tua app in **Permissions**:
>
>    * **Read-only:** la tua app può visualizzare i tuoi dati e le tue impostazioni di Analytics. È l'opzione predefinita.
>    * **Read & write:** la tua app può anche modificare le impostazioni dell'account e della proprietà Analytics.
>    * **Custom:** seleziona i permessi facoltativi che servono alla tua app. I permessi obbligatori restano selezionati.
>
>    ![Configurazione del connettore Google Analytics condiviso con Connection name, Who can access e i permessi Read-only selezionati](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)
>
>    Configurare un connettore Google Analytics condiviso
>
> 8. Clicca **Add connector**.
>
> 9. Accedi con l'account Google che ha accesso alle tue proprietà Analytics.

> [tab] Connettore per utenti dell'app
>
> Ogni persona collega il proprio account Google, così la tua app può mostrare le proprietà Analytics a cui ha accesso.
>
> > [!WARNING]
> >
> > Solo proprietari e admin del workspace possono configurarlo.
>
> > [!TIP]
> >
> > **Prima di configurare un connettore per utenti dell'app:** ti serve un client OAuth di Google Cloud con il suo Client ID e il suo Client Secret. Nello stesso progetto Google Cloud, attiva la Google Analytics Data API. Attiva anche la Google Analytics Admin API se la tua app elenca le proprietà o modifica le impostazioni. Consulta [Usare il tuo client OAuth](https://docs.base44.com/it/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Per aggiungere un connettore Google Analytics per utenti dell'app:**
>
> 1. Clicca **Connectors** nella barra laterale del workspace.
>
> 2. Clicca **Add connector**.
>
> 3. Cerca **Google Analytics** e cliccaci sopra.
>
> 4. Seleziona **App user connector**, poi clicca **Next**.
>
> 5. Copia il **Callback URL**.
>
> 6. Nel tuo client OAuth di Google Cloud, aggiungi il Callback URL agli URI di reindirizzamento autorizzati.
>
> 7. Tornato al modulo **Add Google Analytics Connection**, inserisci un **Connector name**.
>
> 8. Inserisci il tuo **Client ID**.
>
> 9. Inserisci il tuo **Client Secret**.
>
> 10. Seleziona gli [scope](#scopes-and-permissions) che servono alla tua app in **Scopes**.
>
>     ![Elenco Scopes di Google Analytics con email bloccato e analytics readonly e analytics edit tra cui scegliere](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)
>
>     Scegliere gli scope per un connettore per utenti dell'app
>
> 11. Clicca **Add Connector**.
>
> 12. Vai all'editor della tua app.
>
> 13. Chiedi alla chat AI di aggiungere un modo per permettere alle persone di collegare il proprio account Google Analytics.

***

## Scope e permessi

Gli scope controllano cosa può fare la tua app in Google Analytics. Li scegli quando configuri un connettore.

> [card]
>
> **1. Base44 aggiunge**
>
> Base44 include sempre questo scope. Lo vedi bloccato in **Custom** per un connettore condiviso, o in **Scopes** per un connettore per utenti dell'app.
>
> * `email`: identifica l'account Google che si collega
>
> **2. Tu configuri**
>
> Scegli un'opzione di permesso per un connettore condiviso, oppure seleziona gli scope per un connettore per utenti dell'app. I nomi degli scope di Google Analytics iniziano con `https://www.googleapis.com/auth/`:
>
> * `analytics.readonly`: visualizza i tuoi dati e le tue impostazioni di Analytics
> * `analytics.edit`: modifica le impostazioni dell'account e della proprietà Analytics
>
> **Accesso:** la tua app vede gli account e le proprietà Analytics a cui ha accesso l'account Google collegato.

***

## Usare le funzioni backend

Una volta collegato Google Analytics, le tue funzioni backend possono recuperare un token di accesso e chiamare direttamente la Google Analytics Data API. Base44 gestisce l'accesso e mantiene il token aggiornato per te.

* Per una connessione condivisa, usa `getConnection()` per recuperare il token.
* Per una connessione per utenti dell'app, usa `getCurrentAppUserConnection()`, così ogni richiesta usa il token della persona che ha effettuato l'accesso.

Chiama la Google Analytics Data API su `analyticsdata.googleapis.com` e passa il token nell'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] [Connettori condivisi](https://docs.base44.com/it/developers/backend/resources/connectors/shared-connectors.md)
>
> Configura, distribuisci e chiama una connessione condivisa da una funzione backend.

> [card] [Connettori per utenti dell'app](https://docs.base44.com/it/developers/backend/resources/connectors/app-user-connectors.md)
>
> Recupera un token per utente e chiama l'API come la persona che ha effettuato l'accesso.

***

## Risoluzione dei problemi

Se Google Analytics smette di funzionare nella tua app, controlla la connessione, l'account Google e i suoi scope.

> [accordion] La connessione deve essere ricollegata
>
> Se l'accesso a Google Analytics viene perso o scade, la connessione mostra una sezione **Reconnect this connection**. Per un connettore condiviso, [ricollegalo](https://docs.base44.com/it/Integrations/Connectors.md#managing-your-connectors) e accedi con lo stesso account Google. Ogni app che lo usa torna a funzionare. Per un connettore per utenti dell'app, ogni persona ricollega il proprio account dall'interno della tua app.

> [accordion] I miei dati di Analytics non compaiono
>
> Controlla che l'account Google collegato abbia accesso alla proprietà che vuoi e che la tua app usi l'ID di quella proprietà. Una nuova proprietà può impiegare un po' a raccogliere dati. Confronta quindi lo stesso intervallo di date in Google Analytics.

> [accordion] La mia app non riesce a modificare le impostazioni di Analytics
>
> La tua app ha bisogno dello scope `analytics.edit` per modificare le impostazioni dell'account e della proprietà.
>
> * Per un connettore condiviso, i permessi si impostano quando aggiungi la connessione. Clicca **Add another connector** nella pagina del connettore Google Analytics e scegli **Read & write** per la nuova connessione.
> * Per un connettore per utenti dell'app, aprilo nella pagina del connettore Google Analytics, aggiungi `analytics.edit` ai suoi scope e clicca **Save Changes**. Le persone che si sono già collegate mantengono l'accesso precedente finché non si collegano di nuovo.

> [accordion] Alcune persone non riescono a collegare il proprio account Google
>
> Il tuo client OAuth parte in modalità di test, in cui solo gli utenti di test approvati possono collegarsi. Prima di aprire l'accesso a più persone, porta la tua app OAuth in produzione e completa le verifiche richieste da Google.

> [accordion] La connessione non riesce con un errore dell'URI di reindirizzamento
>
> Copia il **Callback URL** dal modulo **Add Google Analytics Connection** e aggiungilo esattamente agli URI di reindirizzamento autorizzati nel tuo client OAuth di Google Cloud.

***

## FAQ

> [accordion] Quale ruolo di Google Analytics deve avere l'account?
>
> Collega un account Google con almeno il ruolo Viewer sulle proprietà che vuoi mostrare. Per permettere alla tua app di modificare le impostazioni dell'account o della proprietà, l'account deve avere il ruolo Editor.

> [accordion] La mia app può usare più di una proprietà?
>
> Sì. Se l'account Google collegato ha accesso a più proprietà, indica quella che vuoi nella chat AI, oppure chiedi un modo per passare da una all'altra.

> [accordion] Posso usare insieme Google Analytics e Google Search Console?
>
> Sì. Aggiungi ciascun connettore separatamente, poi chiedi alla chat AI di combinare in una sola dashboard il traffico di Google Analytics con le prestazioni di ricerca di [Google Search Console](https://docs.base44.com/it/Integrations/google-search-console-connector.md).

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


## Related topics

- [Catalogo connettori](https://docs.base44.com/it/Integrations/connectors-catalog.md)
- [Connettere Google Maps alla tua app](https://docs.base44.com/it/Integrations/google-maps-connector.md)
- [Connettere Google Search Console alla tua app](https://docs.base44.com/it/Integrations/google-search-console-connector.md)
- [Connettere Slack alla tua app](https://docs.base44.com/it/Integrations/slack-connectors.md)
- [Connettere Snowflake alla tua app](https://docs.base44.com/it/Integrations/snowflake-connector.md)


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