This guide explains how to use Beehive Pro to bring Google Analytics reports right to your site’s dashboard and, if you want, to the dashboards of every site in your multisite network.

Once Beehive is installed and activated, refer to this guide for assistance with configuration. Use the index on the left to quickly access guidance on specific features.

If you haven’t installed Beehive yet, then you should visit the Beehive Pro page where you can explore the plugin’s many features and sign up for a free trial membership.

Privacy Policy Information

Upon activation or when certain features are configured, this plugin may add cookies to the user’s browser, store personal information in your database, or integrate with 3rd-party applications. You may need to disclose this information to your site visitors. For details, see Our Plugins in our privacy policy documentation.

Google Analytics Required

You need a Google Analytics account, which is free, to properly configure Beehive. If you need to create an account, the Get Google Analytics section of this guide will have you up to speed in minutes.

Different Analytics Tools

In a world where there are several great WordPress analytics tools on offer, it can be tricky to choose the right one or ones for your particular needs. For a quick guide to figuring out which tools suit your site, check out our blog on What Kind of Analytics Tools You Should Use.

Using the Complianz plugin?

You’ll be happy to know that Beehive integrates with Complianz out of the box when you configure that plugin.

Complianz integration with Beehive

The Welcome to Beehive Quick Setup modal appears the first time Beehive is activated, and we encourage novice users to follow it. It offers two simple ways to connect Beehive to Google Analytics.

  • Connect with Google – This is the simplest connection method that utilizes Google’s shared API to display tracking statistics in your site’s wp-admin.
  • Add Google Analytics Measurement ID – Adding only a Measurement ID allows data to be sent to a property within a Google Analytics account, but that data can only be viewed in Google Analytics and will not be available in the wp-admin of your site.

Beehive welcome modal

Connect With Google (Quick Setup)

The process of connecting with Google’s shared API in the Quick Setup is very similar to when connecting with that method from the Accounts screen in Beehive. But the Quick Setup will walk you through a few additional configurations to ensure everything is set up correctly.

When you click the Connect with Google button, you’ll be prompted to select the Google account you wish to use to connect Beehive to Google Analytics.

Select Google Account

Be sure to check the box to allow Beehive to See and download your Google Analytics data.

Choose the See and download your Google Analytics data option

Then click the Continue button at the bottom.

Click the continue button

You’ll then be prompted to select the Data Stream you wish to use for this site from the Choose your stream dropdown.

Check the box to Automatically detect the Measurement ID associated with that data stream so site data can be sent to your Analytics account.

You can also select additional user roles to Display analytics statistics to in your site admin. Users with the Administrator role have this capability by default so that role is not shown here.

Click the Continue button when you’re ready.

Choose your stream, check the box to detect the Measurement ID associated with that data stream Automatically, and select additional user roles to Display analytics statistics to in your site admin.

Finally, select whether you want to enable Admin Pages Tracking. Toggle on that option if you do.

Enable Admin Pages Tracking

And that’s it. Your Google Analytics 4 data stream is now connected to Beehive, and you should begin seeing analytics data in your site admin and in your Google Analytics account within the next 24 hours.

Finishing setup

Switching to Google Analytics 4?

If you’re using Universal Analytics and haven’t already switched over to the new GA4, you can check this article to learn more about GA4 and how it easily integrates with Beehive.

Add Google Analytics Measurement ID (Quick Setup)

You can use this method if you don’t need to see analytics data in your site admin, and just need to send data to your Google Analytics account.

When you click the Add Google Analytics Measurement ID link, you’ll be prompted to enter the Measurement ID of the data stream you want to use for your site, then click the Save Code button.

See the Measurement ID section in the Get Google Analytics chapter for help locating that info if needed.

Adding the measurement ID

You’ll then be prompted to choose whether you want to enable Admin Pages Tracking. Toggle on that option if you do.

Enable Admin Pages Tracking

And that’s it. Your Google Analytics 4 Measurement ID will be output in the head of every page of your site, and you should begin seeing data in your Google Analytics account within 24 hours.

Finishing setup

Additional Connection Info

In addition to the two connection methods offered in the Quick Setup here, you have the option to use your own Google API Project if you are an experienced user of Google tools. Just click the [X] at the top-right of the Quick Setup modal to skip it, and go to the Set up API Project section of this guide to see how to configure that.

You do of course need a Google Analytics account to use any of these connection methods. If you do not have an account already, see the Get Google Analytics section of this guide for help with that if needed.

Note that regardless of the connection method you choose, access to Beehive can be limited to specific users and user roles if you are concerned about which of them have access to a site’s statistics. See the Settings > Permissions chapter below for more info.

10.1.1 Upgrading to Version 3.4.0?

Link to chapter 1

If you already have Beehive configured and are upgrading from a version prior to 3.4.0, you’ll see a message pop up to inform you that Google will be discontinuing Universal Analytics as of July 2023. For more information, see this Google article.

Click the Set Up Analytics 4 button to go straight to the Google Analytics > Account screen where you can add your Analytics 4 stream to Beehive to continue tracking visits and receiving data without interruptions after that date.

10.2 Beehive Dashboard

Copy chapter anchor to clipboard

The Dashboard statistics become available after Beehive is connected to Google Analytics and consists of the Overview, the Statistics quick access panel, and the Google Tag Manager module. Admins, particularly those managing multiple sites, can use the Dashboard to get a quick big picture view of site activity over time.

Take Advantage of Beehive

Wanting to really take advantage of everything that Beehive has to offer? Check out our blog on how to Get The Most Out Of Beehive.

Use the View Documentation button to access Beehive usage documentation (this document).

beehive dashboard

Overview

The Overview panel provides a snapshot of a site’s traffic stats for a specified period of time. Overview elements include:

  • Time frame filter – This is located next to the View Documentation button. Use the filter to display traffic and activity stats for a day, for years or any time frame in between, using the custom range option. The selected time frame will modify the stats displayed in both the Overview and Statistics panels.
  • Pageviews – Displays the number of unique page views during the selected time frame, along with the percentage change during that same period.
  • New Users – The number of new users during the selected time frame, along with the percentage change during that same period.
  • Top Page – The most visited page during the selected time frame.
  • Top Search Engine – The search engine that generated the most traffic for a site during the selected time frame.
  • Top Medium – The path that generated the most traffic (direct, organic search, referrals, paid, etc.) during the selected time frame.

Tutorials

The tutorials module gives you easy access to all the relevant tutorial blogs. Click read more to navigate to the specific article or click View all to jump to the main Beehive tutorial page. You can also click the x icon to remove the tutorials module – the tutorials will always be available in the Tutorials tab.

dashboard-tutorial-widget

Statistics

This widget gives you a snapshot of your statistics and acts as a quick-access panel to view your full analytics report. Click the View Full Report button to learn more about all of your analytics.

Statistics dashboard widget

Analytics Configuration

This widget displays the status of your Google Analytics 4 and Universal Analytics configurations. Click the gear icon for either one to quickly access their respective settings.

Analytics Configuration

Google Tag Manager

This widget simply displays the current status of the Google Tag Manager integration, and how many variables you may have set up. Click the gear icons for either to quickly access their settings.

Google Tag Manager dashboard widget

10.3 Google Analytics

Copy chapter anchor to clipboard

This is where you’ll manage your Google Analytics account once you’ve authenticated it for use with Beehive, either during the Quick Setup or on the Accounts screen.

10.3.1 Statistics (Analytics)

Link to chapter 3

The statistics tab allows you to view all of your stats from one area.

Visitors

The Visitors panel displays traffic and activity data across multiple metrics, and using the available filters, will display comparative data over selected time frames.

Use the dropdown at the top-left to switch between the old Universal Analytics and the newer Google Analytics 4 data if you have both of them configured on your site.

Switching between the old Universal Analytics and the newer Google Analytics 4 data

The data for each metric during the currently selected time frame is displayed along the bottom of the panel. Click any metric to view a chart detailing that metric’s activity over time.

These metrics are defined as:

  • Sessions – The number of unique user sessions during the selected time frame. A session is defined as a group of user interactions with your website that takes place within a given time frame.
  • Users – The number of unique individual users who interacted with a site during the selected time frame.
  • Pageviews – The number of pages that were fully loaded into a browser at the request of users. A user who views five pages in one session will result in a single session and five pageviews.
  • Pages/Session – The average number of pages users viewed during a single session.
  • Average Time – The average amount of time users spent interacting with a site during a single session.
  • Bounce rate – A bounce occurs when a user leaves a site shortly after arriving without interacting with any elements on the page. The bounce rate is the number of these events as a percentage of all sessions during the selected time frame.

Time Frame Filter

Use the time frame filter to display data for a variety of periods, including custom data ranges.

Changing the time frame will refresh the data for every chart on the Statistics page, so all charts display data for the same period.

Drop-down-filter-red

Compare to last period

Select the Compare to last period option, and then click a metric to see a comparison of the current data for that period and the data for the time frame preceding the current time frame.

For example, the lighter-colored line in the image below shows a site’s pageview data for the last month, while the bolder line shows the same metric for the month immediately preceding the last month.

compare-to-last-period-2

Real-Time Visitors

View the real-time data of your site’s visitors, which is categorized by device. This panel displays the total number of current visitors, as well as a percentage breakdown by the following devices.

  • Desktop
  • Tablet
  • Mobile

Real time visitor data in Beehive analytics

Mediums, Search Engines, and Top pages

Beehive displays key Search Engine Optimization data in three circle charts directly below the Visitors data.

Beehive Statistics page circle charts

These charts show traffic data in the following categories:

  • Medium – The various sources for site traffic: organic, direct, referral, and so on.
  • Social Networks – Traffic that was referred to a site from a social network.
  • Search Engines – A ranking of search engines based on the amount of traffic derived from those sources.

Top Countries

The Top Countries chart uses color coding to show, geographically, where traffic is coming from to a site and the number of visitors from each country during the selected time frame.

Beehive Top Counties chart

Top Pages

A list of a site’s most visited pages and the number of visitors who viewed the pages during the selected time period, as well as the average amount of time users spent on that page and the percent change since the previous period.

Beehive Top Pages chart

The list contains links to the listed pages. Click any link to view that page.

10.3.2 Account (Analytics)

Link to chapter 3
IMPORTANT

Google has announced that they will be discontinuing Universal Analytics as of July 2023. Google Analytics 4 is the new API from Google that is now the default for all new properties created in your Google Analytics account. But you can also create a new GA4 property from an existing Universal Analytics property and they will be nicely integrated.

To learn all about it and how to set it up if you haven’t already, see the following Google articles:

You can configure both Google Analytics 4 and/or Universal Analytics options below if you wish, and toggle between the two when viewing the statistics in your site admin. See the Statistics (Analytics)chapter above.

You can create multiple views or data streams for each property (domain/site/network) in Google Analytics. This allows you to create more narrowly tailored reports, which has the added benefit of cleaning up the data as Google separates it from the rest.

Analytics 4 Profile

Once you have authenticated your Google Analytics account on the Accounts screen, click the Analytics 4 Profile dropdown menu and select the data stream you want to use for your site.

Then paste in the Measurement ID for that stream in the field provided to send data to your Google Analytics account.

Note that if you don’t need to view analytics data in your wp-admin, you can simply paste the Measurement ID for the stream you want to use in the field provided to send your site data to your Google Analytics account.

Analytics 4 profile

Universal Analytics Profile

Once you have authenticated your Google Analytics account on the Accounts screen, click the Universal Analytics Profile dropdown menu and select the view you want to use for your site.

If you have set up your own API project for this connection, check the Automatically detect Tracking ID checkbox to have Beehive automatically fetch that for you for the selected view, and add it where needed.

Universal analytics profile

If you need to use a different Tracking ID, or just want to send analytics data from your site to your Google Analytics account, be sure that box is unchecked. Then manually enter the tracking ID in the field below.

Tracking ID

10.3.3 Settings (Analytics)

Link to chapter 3

Admin pages tracking

By default, only the activity on the frontend pages of your site is tracked. However, by enabling this Admin Page Tracking feature, activity in the wp-admin is also tracked.

Beehive Settings enable admin tracking

IP Anonymization

Google does collect IP addresses in order to report geolocation data, but those addresses are never reported and are stored in an anonymous state. When enabled, IP Anonymization modifies collected IP addresses so they cannot be used by Google and allows you to ensure your audience that you are not leaving it up to Google to protect their data.

IP anonymization settings

Multisite Super Admins have an additional option that, when selected, forces all subsites to anonymize IP addresses, as well.

Display Advertising

When enabled, this feature adds Google advertising cookies to your site or network so you can do things like:

  • Create Remarketing Audiences based on specific behavior, demographic, and interest data, and share those lists with Google Ads.
  • Use demographic and interest data in your Analytics reports.
  • Create Segments based on demographic and interest data.

Keep in mind that you may need to update your privacy policy if you wish to enable this feature.

display advertising setting

Exclude Roles from Tracking

If you don’t want certain users’ activity to be tracked and added to your analytics, you can exclude them by roles. Search for the user role and select it to ensure that when any users with that role are logged into the site, their activity will not be tracked. You can add multiple roles if you wish.

google-analytics-settings-exclude-roles-from-tracking

Statistics in post types

This allows you to display the statistics meta box on custom post types. By default, posts and pages are already included but you can remove these by clicking the x icon next to the name. Simply type in the name of the post type and select it from the dropdown.

google-analytics-stats-in-post-types

10.4 Google Tag Manager

Copy chapter anchor to clipboard

This section enables you to integrate Google Tag manager with Beehive. To activate the integration, start by clicking the Activate button.

beehive-gtm

Note that if you have already integrated Google Analytics with your Google Tag Manager account, you do not need to connect Analytics to Beehive; the Tag Manager container you connect will handle that for you.

If you have not connected Analytics to Tag Manager yet and wish to do so, below are Google’s guides to help you get that done.

For older Universal Analytics accounts, see: Deploy Universal Analytics with Tag Manager
For newer Google Analytics 4 accounts, see: Google Analytics 4 tags

10.4.1 Account (Tag Manager)

Link to chapter 4

Add your Google Tag Manager container ID (GTM ID) in the field provided and click Save Changes. If you’re not sure where to find your GTM ID, see this Google help doc.

Google Tag Manager in Beehive

PRO TIP

If you are testing things on a staging site, you can create and use different Container IDs for your live and staging sites so your live GTM data doesn’t get “polluted” with staging data.

10.4.2 Settings (Tag Manager)

Link to chapter 4

In the Settings section are several built-in variables that you can enable, and you can define your own custom ones as well if needed.

You can use the data in your Google Tag Manager account as you see fit. If you need help with that, see this Google doc: https://support.google.com/tagmanager/answer/6164391

Default

Under the Default tab, you’ll find a number of post-related variables are built-in. Enable the ones you need by clicking the toggle on the left.

beehive-gtm-var-default

Visitors

Under the Visitors tab, you’ll find several variables related to the current visitor’s status. Enable the ones you need by clicking the toggle on the left.

beehive-gtm-var-visitors

Integrations

Under the Integrations tab, you’ll find variables related to currently supported plugins or services. At this time, WPMU DEV’s Forminator and Hustle plugins are supported. Note that if any plugin is not active, their options will appear greyed out here.

beehive gtm integrations

When any of the integration options are enabled for Forminator, and a form/poll/quiz is submitted successfully, Beehive will send a Data Layer event with form/quiz/poll data to GTM. The event names are:

  • beehive.forminatorFormSubmit (for Form)
  • beehive.forminatorPollSubmit (for Poll)
  • beehive.forminatorQuizSubmit (for Quiz)

When integration is enabled for Hustle Leads, and an optin module is successfully submitted, Beehive will send a Data Layer event with module data to GTM. The event name is:

  • beehive.hustleModuleSubmit (for all modules)

Custom

Under the Custom tab, you can define your own custom variables if needed. To add a variable, click the Add Variable button, then enter the Name and Value, and click Save Changes.

beehive-gtm-var-custom

Verifying data sent to GTM

You can see exactly which data is being sent to your connected GTM account by toggling on the Preview feature in your GTM workspace to open the TagAssistant. Then visit any page on your site and check the output under the Data Layer tab on the TagAssistant screen.

If you have enabled integration options with Forminator, submit a Forminator form/quiz/poll from your site, and you’ll see data similar to the below example, where you can also see all the form field variables along with the defaults and any custom ones you may have added.

Data sent to GTM from a Forminator form submission

If you have enabled the integration with Hustle, an optin module submitted from your site would send data similar to the below example, along with the default and custom variables as well.

Data sent to GTM from a Hustle optin submission

This is where you manage your authentication to different analytics services. However, currently only Google Analytics is supported.

Using Google Tag Manager?

If you have already integrated Google Analytics with your Google Tag Manager account, you do not need to connect Analytics to Beehive; the Tag Manager container you connect will handle that for you.

Google Account

To display your Google Analytics statistics in your site admin, you will need to connect with one of the two API methods:

  • Connect with Google – A shared API with multiple users.
  • Set up API project (Recommended) – Creates a custom API connection for a specific site or network of sites.

If you are unfamiliar with Google APIs, we recommend reviewing the To Share or Not to Share section before proceeding.

Regardless of the option selected to connect to Google Analytics, you can reset the connection by clicking the gear icon once connected, then clicking the Logout option. You can then connect to a different account. Or if you connect once again to the same account, the same data will appear as before.

beehive-logout

10.5.1 Connect with Google

Link to chapter 5

If you do not have a custom API project set up, you can use Google’s shared API instead. Click the Connect with Google button to get started. Note that this is the same process if you click the same button in the Quick Setup modal.

Connect with Google

Choose the Google account you wish to use to connect Beehive to Google Analytics.

Select Google Account

Check the box to allow Beehive to See and download your Google Analytics data.

Choose the See and download your Google Analytics data option

Then click the Continue button at the bottom.

Click the continue button

Beehive is now connected to your Google Analytics account. You can configure the Universal Analytics view and/or Google Analytics 4 data stream you wish to use for this connection under the Google Analytics > Account tab.

10.5.2 Google API Project

Link to chapter 5

To connect Beehive to Google Analytics using a custom API project you created in the Google Developers Console, click Set up API project and enter the Client ID and Client Secret into the fields provided. Then click Authorize.

beehive google account api project

NOTE

If you have not yet created an API project or don’t have the required credentials, see the detailed instructions in the Set up API project section of this guide.

When you click Authorize, you will be asked to log in to the API project and grant permission for Google Analytics to collect data from this site. Log in with the Google account used to create the project.

beehive-api-login

Click Allow in the pop up to confirm the connection between Beehive and Google Analytics.

beehive-api-grant

At this point, you have created an API project and given permission for Beehive to pass data to that project. You can configure the view (profile) you wish to use for this connection under the Google Analytics tab.

PRO TIP

You can create multiple Views for each property (domain/site/network) in Google Analytics. Multiple Views allow you to create more narrowly tailored reports, which has the added benefit of cleaning up the data as Google separates it from the rest.

The Settings area is where site admins can modify Beehive’s configuration to manage plugin data, enable various users and/or user roles to view statistics and adjust plugin settings.

10.6.1 General

Link to chapter 6

Manage your general Beehive settings here.

Statistics Tab

If this is enabled, a top-level statistics tab will appear in the WP Admin sidebar which displays your Google Analytics. Click the toggle to enable/disable this feature and replace the name in the available field to rename the tab that will appear in the sidebar.

settings-general-statistics-tab

10.6.2 Data & Settings

Link to chapter 6

Manage your plugin data settings by configuring the Uninstallation and Reste Settings modules.

Uninstallation

When Beehive is uninstalled, the settings that you have made within the plugin can either be kept by selecting Preserve or be discarded by choosing the Reset option.

data and settings uninstallation

Reset Settings

If you are wanting to start on a clean slate, you can click on the Reset button to instantly revert all the settings back to their default state. Just keep in mind that this will also remove your Google authentication and your statistics report.

data and settings reset settings

10.6.3 Permissions

Link to chapter 6

Here you can determine who can see the data and reports compiled by your analytics account.

Statistics

Select either the user roles or the capability required to view your statistics in the WordPress Dashboard area.

User Roles

To adjust this per user role, click on the Roles tab, then toggle on the ones who you want to be able to view the stats.

statistics roles

  • On single sites, the Administrator role will appear at the top, and is enabled by default.
  • On multisite networks, the Network Administrator role will appear at the top, and is enabled by default.
  • On multisite networks, the roles enabled will apply to every site in the network unless the Allow site admins to overwrite this setting box is checked.

You can fine-tune exactly what you wish selected user roles to be able to view by clicking on the role once toggled, and drilling into the dropdowns to select the specific elements you want.

beehive-permissions-stats-details

Capabilities

To adjust this according to a minimum required capability, click on the Capabilities tab. Then enter the capability required to view stats in the admin area. Note there is no fine-tuning available as above for this option.

beehive-permissions-stats-caps

  • On multisite networks, the capability set here will apply to every site in the network unless the Allow site admins to overwrite this setting box is checked.

Settings

This section enables you to specify the user roles or users who can access and adjust the plugin settings.

User Roles

To adjust this per role, click the User Role tab, and select the roles you need.

beehive-permissions-settings-roles

  • On single sites, the Administrator role will be enabled by default.
  • On multisite networks, the Network Administrator role will also appear there and be enabled by default.
  • On multisite networks, the roles enabled here will apply to every site in the network unless the Allow site admins to overwrite this setting box is checked.

Custom Users

To adjust this per user, click the Custom Users tab. Then select either Exclude or Include and click Add User to add the ones you want to exclude or include from the User Role settings.

beehive permissions custom users

  • Here again, on multisite networks, the users included/excluded here will apply to every site in the network unless the Allow site admins to overwrite this setting box is checked.

This is where you can find quick-access links to the tutorial blogs for Beehive. Click on any blog or read more to open the article. You can also click the diagonal arrow icon in the top-right hand corner to open the main Beehive tutorial page.

beehive-tutorials-tab

Once Beehive is connected using one of the two API connection methods, your Google Analytics statistics will be available in two locations:

  • Statistics page – A customizable, detailed report of the site or network data over time found in your Google Analytics tab in the plugin. For more information on that statistics page, see the Statistics (Analytics) section of this documentation.
  • Statistics widget – Beehive places a widget on the dashboard of each connected site to display a detailed summary of Google Analytics statistics.

Statistics are not displayed on sites or networks that are connected to Google Analytics using a Tracking ID only. If you wish to upgrade your connection to an API, see the To Share or Not to Share section of this guide for more information.

10.8.1 Statistics Widget

Link to chapter 8

The Beehive Statistics widget provides access to site traffic statistics directly from the dashboard of any site with Beehive activated and connected to Google Analytics.

DB-widget-with-stats

For sites that are not connected to Google Analytics, Beehive will display a notification to that effect. Click the link provided or go to the Accounts module to connect Beehive to Google Analytics.

DB-widget-no-stats

Widget Tools and Tabs

Use the tools and tabs at the top of the widget to access the desired statistical data or view.

widget-filters

The tools include:

  • See all stats – Click to open the Statistics page where a detailed report of site traffic data can be found.
  • Refresh data – Click to pull in fresh data from Google Analytics.
  • Time frame filter – Click the drop-down menu to apply a custom time frame and display data for the selected period only. The selected time frame will apply to all metrics viewed until the time frame is changed.

The tabs include:

  • General stats – Each panel within the General Stats tab can be clicked to see a more detailed display of that data.
  • Audience – The Audience tab displays data related to users’ behavior while on a site: numbers of unique users, sessions, page views, and page per session.
  • Top Pages and Views – A list of a site’s most visited pages, along with the number of visitors, the average time users spend on those pages, and whether the pages are trending up or down.
  • Traffic – This tab displays the leading sources of a site’s traffic geographically, by search engine, medium, and social network.

10.9 Set up API Project

Copy chapter anchor to clipboard

This chapter will guide you through the process of creating a Google API project for Beehive.

Google API projects are created in the Google Cloud Console and involve configuring one or more Google APIs to service websites and other applications. For your analytics needs in Beehive, you’ll be combining several APIs from the Google API library into a single, robust data collection and reporting profile.

Begin by signing into a Google or G-Suite account you wish to associate with the site on which Beehive is being configured, then navigate to the APIs & Services Dashboard in your Google Cloud Console. If this is your first time accessing the console, agree to the Terms and Service to proceed.

Click Create Project to initiate a new project.

Create a new project or select an existing project

If you don’t see the Create Project link, it may be that an API project was created with this account at some point in the past, possibly unrelated to Beehive.

In this case, click the Select a project drop-down and then click New Project. This is the screen you will come to if you ever wish to modify your Beehive API project or any other Google API projects you may initiate.

Create a new project

Enter any name you like for the Project name. If you are using a G-Suite account, select the Organization and/or Location you want to associate with it, then click Create.

Add new project details

10.9.1 Enabling APIs

Link to chapter 9

There are 5 APIs that you will need to enable, as follows:

  • Google Analytics API – this API enables those with established credentials to configure the data collection and the reporting profile for a specific property.
  • Google Analytics Reporting API – this API enables authorized users to build custom dashboards in Google Analytics, automate complex reporting tasks, and integrate with applications like Beehive.
  • Google Analytics Data API – this API allows for programmatic access to the report data of the connected account so your Google Analytics 4 data can be displayed in your site admin.
  • Google Analytics Admin API – this API allows for programmatic access to the configuration data of the connected account to fetch the list of GA4 properties associated with that account.
  • Google People API – this API collects user profile and contact information for consenting users and shares that data with Google Analytics.

To get started, click the + Enable APIs and Services link to access the Google library of APIs.

Enable APIs and Services

For each of the 5 APIs listed above, use the search tool to locate it.

Click on the corresponding result. For example, you would see this when searching for the Google Analytics API:
Google Analytics API

On the next screen, click the Enable button to enable the API.

Enable Google Analytics API

If you are prompted to create credentials, ignore the request, and exit the prompt. Google requires OAuth 2.0 credentials for API connections, but it is better to add all the required APIs before creating those credentials.

Once all 5 required APIs are added to the project, it’s time to create the OAuth Client ID.

10.10 To Share or Not to Share

Copy chapter anchor to clipboard

Google requires the use of an API to collect user data because APIs provide better protection for that data. Beehive users have the option to use a shared API (Connect with Google) or to create a custom API project (Set up API project) specifically for their sites.

We strongly recommend creating a custom API project using the instructions provided in this guide.

It must be said that the Connect with Google method, typically, is very quick and easy to set up. However, it’s so simple because it uses an existing, hard-coded API that is shared by multiple users. Google limits the maximum number of requests a single API can make per hour and per day. A shared API significantly increases the chances of hitting this limit and distorting your stats.

Creating a custom API project, on the other hand, creates an exclusive connection just for your site or network. This custom connection ensures your stats will be as accurate as they can be, and it is extremely rare for a single user or even a single multisite network to reach the Google Analytics API limit. See Limits and Quotas on API Requests for more information on the limits of shared APIs.

However, it is important to note that Google does have a hard limit of 50 “refresh tokens” per account. That means that you can connect up to 50 domains using the same account. So if you do have lots of sites, or a multisite with lots of domain-mapped subsites, you might indeed hit that limit, and random sites will start displaying “unknown error occurred” messages. See Refresh token expiration for more information on that limit.

Workarounds for the above situation could be to have only 45-50 sites on one account and create a different account for additional sites. Or add an additional user to your account to be able to add more sites to that account as that additional user.

10.11 Connecting a Multisite Network

Copy chapter anchor to clipboard

Each subsite in a multisite network must be connected individually. However, if Beehive is installed, network activated, and connected in Network Admin using the Google Analytics API, we will use that custom connection for the entire network. This allows subsites to connect with the fast and easy Connect with Google method but still reap the benefits of a custom API connection.

NOTE:

If you are unsure why we recommend creating a custom connection, see To Share or Not to Share.

The steps for connecting Beehive to Google Analytics for a multisite network are essentially the same as connecting a single site, although multisites have a couple of unique options after the connection is complete. Take a moment to familiarize yourself with them now, or return to this section when you are ready to configure these options.

When you’re ready, go to Quick Setup to begin configuring Beehive, and remember to configure the plugin from Network Admin before connecting any subsites.

Granting Permission Authority

After connecting Beehive to Google Analytics in your Network Admin, you can visit Beehive > Settings in your network admin and enable options to allow subsite admins to override your network settings and configure things on their own subsites.

You can allow them to override your permissions for either statistics or access to settings, or both. See the Permissions chapter above for information on that.

10.11.1 Connecting Network Subsites

Link to chapter 11

If you followed our advice and connected the network using the Google Analytics API and did so from Network Admin, every subsite can now connect using the simple Connect with Google method.

When you visit Beehive > Accounts in any subsite admin, you’ll see a notification that Beehive is connected at the network level, but the subsite admin can connect to their own account should they wish to by using the simple Connect with Google method.

Click Connect with Google, then follow the directions in the Connect with Google chapter above.

Connecting network subsites in Beehive

10.12 Get Google Analytics

Copy chapter anchor to clipboard
GOOGLE ANALYTICS 4

This chapter will guide you in setting up a Property and a Data Stream in Google Analytics 4, which is now the default API for all new properties. If you need help setting up an older Universal Analytics property instead, see the 2nd part in this Google doc.

Note that the following instructions can also be found – without screenshots – in Google’s official help doc here: Add an account, property, or data stream

If you don’t yet have an Analytics account and are perhaps not sure how things work there, here’s the short version: Google Analytics, using javascript, tracks what users do on your site – what links they click, what pages they view and for how long, and many other data points as well.

Google can do this because users – that’s you – insert custom code into the code for every page they want to be tracked (Beehive makes that part easy). This code tells Google who owns the data collected from a given page – you – so it can be associated with the right account in Analytics. The data is then categorized based on a myriad of variables – many of which can be customized in Beehive – and displayed as reports on site dashboards that admins can use to plan and achieve site or network goals.

It may be helpful to also understand how a Google Analytics account is structured. There’s the Account, of course, and within each account there are Properties and within each property, there are Data Streams.

beehive-ga4-account-structure

Here’s how Google defines each:

Account: Think of it as the top-level folder that you access using your login details. If you are managing a single website, then one account is sufficient. If you’re managing multiple websites that aren’t directly related, then these should be stored in separate accounts. Google allows users to create up to 100 Analytics accounts within the same Google account.

Property: A “property” is simply Google-speak for a website or network of sites that have been added to a Google Analytics account. When Beehive connects, it connects to a specific property. Each Analytics account can have up to 100 properties.

Data Stream: Data Streams tell Google Analytics what reports should be created for a given property. In simplest terms, each stream is a separate report and can, among other things, display data in realtime on the Realtime screen in your Analytics account. Users can create up to 50 Data Streams per property, each targeting a unique traffic factor or group of factors, as defined by you.

Sign Up

If you already have a Google Analytics account set up and want to use that one, you can skip down to the Creating a new Property section below.

If you don’t already have a Google Analytics account set up, go to the Google Analytics Setup page, and Sign In with the Google account you want to use to connect Beehive on your site.

google-signin

Create Account & Property

Create your Analytics account by simply giving the account a Name and then choosing what, if any, of your collected Data you want to share. Click Next to proceed.

beehive-ga4-account

In the next step, give your Property a Name, and select your desired reporting Time Zone and Currency.

beehive-ga4-account-property

Note that by default, new properties will be created as v4 properties. If you want to create a Universal Analytics property (v3), click on Show advanced options. If you want to create a v4 property, you can skip this step, click Next, and jump straight to filling in your Business information.

show advanced options

This will reveal a module with extra settings options, which is where you can click the toggle to Create a Universal Analytics property.

create a universal analytics property

Click Next to proceed.

Then fill in your Business information, and click Create.

beehive-ga4-account-business

Finally, check the boxes to accept Google’s Terms, and click I Accept.

beehive-ga4-account-terms

Creating a new Property

If you already have a Google Analytics account set up, or want to create a new property at any time after your account has been created, click the Admin button located in the bottom left corner of any Google Analytics screen.

Beehive ga4 account admin

If you have multiple accounts, ensure you’re in the correct one by selecting it from the dropdown in the left-hand column. Then click the Create Property button in the right-hand column, and follow the same steps as above when you created the account.

beehive-ga4-account-property-new

Create a Data Stream

Data Streams in Google Analytics 4 are what replace Views in the old API. To create a Data Stream for your Analytics account, click on the Admin link in the bottom-left corner. Then in the Property column, be sure you’re viewing the Property you want, and click on Data Streams.

beehive-ga4-data-stream

On the next screen, select the Web option, which would look like this if this is the first Data Stream you’re creating for this account:

beehive-ga4-data-stream-web

If you already have one or more Data Streams created for this account, the above option would look like this instead:

beehive-ga4-data-stream-new

Then, on the Set Up screen that slides into view, ensure the correct protocol is selected (http/https) and enter your site’s domain name in the Website URL field, and enter a unique Stream Name for this stream. Enable the Enhanced Measurement option to get the most out of GA4, and click Create stream.

beehive-ga4-data-stream-options

Once your Data Stream has been created, you’ll see it appear there in the Data Streams section, although the message there will of course say it hasn’t received any data yet.

beehive-ga4-data-stream-created

Measurement ID

To locate the Measurement ID you need for your GA4 integration in Beehive, click on the Data Stream you want to use from your list.

beehive-ga4-data-stream-id

Then, on the Web Stream Details screen that slides into view, you’ll see the Measurement ID at the top-right. Copy that and paste it in the corresponding field in your Beehive > Google Analytics > Account settings.

beehive-ga4-data-stream-id-copy

10.13 Scopes and Verification

Copy chapter anchor to clipboard

We do not recommend adding scopes to your Beehive API project. OAuth 2.0 verification is sufficient for the three scopes employed by Beehive and results in essentially immediate approval of your application by Google.

Scopes for Google APIs

The data collected by Beehive requires three scopes:

userinfo.profile – Collects publicly available personal information.
userinfo.email – Collects users’ email addresses.
analytics.readonly – Shares analytics data with a client service which in this case is Beehive.

Adding scopes to your Beehive API project can broaden the type of data collected, but doing so may also trigger a higher verification standard that prevents immediate creation of the required credentials or places limits on Beehive until the verification process is complete. The verification process for highly sensitive scopes can take weeks.