Google Analytics App Installation Guide

Google Analytics is a powerful web analytics tool which helps you gain meaningful insights of your website. Using Contentstack Marketplace you can easily install the Google Analytics app and use it within your stack.

This step-by-step guide explains how to install and configure the Google Analytics app in Contentstack Marketplace. With this, editors can see a graph of the page views for the URL corresponding to the current entry.

Voraussetzungen

• Google Analytics account
• Contentstack -Konto
• Access to the Contentstack Organization/ Stack as the Owner/ Admin

Schritte zur Ausführung

1. Fetch View ID, Property ID and Service Account Details
2. Install and Configure the Google Analytics App
3. Use the Google Analytics Dashboard Widget
4. Use the Google Analytics Sidebar Widget

1. Fetch View ID, Property ID and Service Account Details

   To get your configuration details for Google Analytics, follow the steps given below:

   Creating a Service Account JSON File for Google Analytics Integration

   Follow the steps to generate and download a Service Account JSON file for integrating Google Analytics with your project:

   1. Create a Project: Go to the Google Cloud Console und klicken CREATE PROJECT to create a new project.
      You can also select your existing project by clicking the SELECT PROJECT button or the Select a project drop-down or directly clicking the project.
   2. Generate Service Account Key: Follow the steps to generate the service account JSON file:
      1. Navigate to Service Accounts and select your project.
      2. To create a new service account, click the + CREATE SERVICE ACCOUNT Taste.
         
      3. Fill out the service account details, click the CREATE AND CONTINUE button, and then click DONE.
         
      4. Click the three dots corresponding to the service account details and select the Manage keys Möglichkeit.
         
      5. To add a new key, click the ADD KEY drop-down and select the Create new key Möglichkeit.
         
      6. Wählen JSON als die Key type und klicken ERSTELLEN.
         
      7. A JSON file gets downloaded automatically. Save it properly to use in Step 2.
   3. Enable API Access: Follow the Create and delete service account keys documentation to enable the API access for your project.
      

   Aktivieren Sie die Google Analysen Reporting API

   To enable the Google Analytics API, follow the steps:

   1. Go to the APIs & Service dashboard in the Google Cloud Platform.
   2. Drücke den + ENABLE APIS AND SERVICES button on the top header.
      
   3. In the search bar of the API Library page, type and select Google Analytics Reporting API.
   4. Click the ENABLE button to enable the Google Analytics Reporting API.
   5. Go back to the API Library page, type and search for Google Analytics Data API and select it.
   6. Click the ENABLE button to enable the Google Analytics Data API.

   Add Service Account to Google Analytics

   Follow the steps to add a service account to Google Analytics:

   1. Open the downloaded JSON file and copy the client_email value.
   2. Now, go to your Google Analytics account.
   3. Klicken Sie im linken Navigationsbereich auf Admin. Go to the Account Settings section and click Konto to add users.
      
   4. Click the plus icon on the top-left corner of the screen and select the Benutzer Hinzufügen Möglichkeit.
      
   5. Im Hinzufügen Rollen und Datenbeschränkungen hinzu modal, geben Sie die ein client_email (retrieved from the JSON file) in the Email addresses text field, select Viewer unter dem Direct roles and data restrictions section, and click the Hinzufügen button to add users to your analytics account.
      

   Get the Property ID

   To get the Property ID for the Google Analytics 4 version, follow the steps:

   1. Go to your Google Analytics account.
   2. Klicken Sie im linken Navigationsbereich auf Admin. Go to the Property Settings section and click Property details to get the property ID.
      
   3. In the top-right corner, you can view the PROPERTY ID. Copy it to the clipboard to use in Schritt 2.
      

   Get the View ID

   To get the View ID for the Google Universal Analytics version, follow the steps:

   1. Go to your Google Analytics account.
   2. Navigieren Sie zu Admin page. Under the View Abschnitt, klicken Sie View Settings.
      
   3. Im View Settings section, copy the View ID to the clipboard to use in Schritt 2.
      

2. Install and Configure the Google Analytics App

   Follow the steps below to install the application in Contentstack.

   1. Melden Sie sich bei Ihrem Contentstack Konto an .
   2. Klicken Sie in der primären Navigation auf der linken Seite auf Marktplatz Symbol, um zum Marktplatz zu gelangen.
      
   3. Klicken Sie im linken Bereich auf Apps .
   4. Within the Marketplace, you can see all the apps available. Hover over the Google Analytics App und klicken Sie Installieren.
      
   5. In the popup window, select the stack where you want to install the Google Analytics app, accept the terms of service and click the Installieren Taste.
      
   6. You can choose to use Google Universal Analytics or Google Analytics 4 with the latest Marketplace app version.
   7. Auf der Configuration screen, choose the Google Analytics solution you prefer:
      1. Universal Analytics: To access the universal analytics, enter the following details:
         View ID: Enter the View ID abgerufen in Schritt 1.
         
      2. Google Analytics 4: Contentstack now supports Google Analytics 4 in the latest app update as an advanced feature. To configure Google Analytics 4 into your stack, enter the following details:
         Eigentum ID: Geben Sie die ein Property ID abgerufen in Schritt 1.
         
      3. Import Service Account Details: Upload the service account details (service_account.json file) retrieved in Schritt 1.

         Note: The project_id, client_email, and private_key are mandatory fields in JSON file which cannot be edited.

   8. After adding the configuration details, click the Save button.
   9. Auf der UI- Standorte Auf der Registerkarte können Sie die vordefinierten App-Speicherorte sehen. Sie können die Umschalttaste für jeden UI-Standort verwenden, um ihn je nach Ihren Anforderungen zu aktivieren oder zu deaktivieren.
      
   10. Wenn der Webhook für Ihre App aktiviert ist, können Sie die Webhook-Protokolle unter dem Webhook Tab.

       Zusätzliche Ressource: Weitere Informationen zum UI-Standort und zu Webhooks finden Sie im Leitfaden „Installierte Apps“ .

   11. Click the Open Stack button to start using the Google Analytics application.

3. Use the Google Analytics Dashboard Widget

   1. Go to stack Dashboard to view the Google account analytics. By default, it displays the data for 30 days.
   2. You can select the number of days for which data should be displayed.
      

4. Use the Google Analytics Sidebar Widget

   To use the Google Analytics app within an entry of your stack, follow the steps given below:

   1. Los zu Ihrem Stapel, klicken Sie im linken Navigationsbereich auf das Symbol „Inhalt “ und dann auf die Schaltfläche „+ Neu Inhalt “ .
   2. Erstellen einen Inhaltstyp, indem Sie relevante Details hinzufügen, wie unten angezeigt:
      
   3. Im Content Type Builder page, add a URL field in your content type by clicking the Fügen Sie ein Feld ein Link dargestellt durch a + Zeichen.
      
   4. After adding the fields, click Save or Save and Close to save your changes.
   5. To use the Google Analytics app in the sidebar widget, create an entry for this content type.
   6. Im Titel field, enter a suitable title for your entry. In the URL field, enter the URL of the page for which you want to take the Google Analytics data, and then Speichern the entry.
      
   7. Klicken Sie im rechten Navigationsbereich auf Widgets und wählen Sie die aus Google Analytics app to view the analytics.
      

      Note: This displays the Google Analytics data for the specific page.

   8. You can select the number of days for which data should be displayed for the specific page.