Dashboard

Allow listing owners to view detailed traffic analytics for their listings.

Overview

Dashboard offers a beautiful interface for business listing owners giving them access to detailed historical traffic statistics for their individual listings.

JReviews Dashboard Add-on listing analytics

Dashboard relies on 3rd party analytics providers and their APIs to access your site's traffic data and includes out-of-the-box integrations for two providers:

  • Fathom Analytics, a privacy focused provider that offers an easy-to-use interface that any site owner can understand, without sacrificing functionality.
  • Google Analytics, a non-privacy focused, harder-than-necessary-to-setup provider that you most likely already use, so your listing owners get to see historical data from day one.

For our own web properties, we have already moved to Fathom Analytics. We like their simplicity and focus on privacy. This option might only makes sense to you if your business is generating revenue, so if that's the case, go check them out. When you use our affiliate link below, you get $10 off your first invoice.

👉 Go checkout Fathom Analytics

Requirements

You'll need to be using either Google Analytics or Fathom Analytics on your site to collect traffic data. You can use a plugin or your template/theme functionality to add their tracking code to your site.

Getting Started

The Add-on has a single front-end page where listing owners can view their listing analytics. After installing the Add-on, create the JReviews menu for the Dashboard Add-on.

Next, you need to setup the Add-on configuration for your provider of choice.

Setup with Fathom Analytics

When using Dashboard with Fathom Analytics, the setup process is extremely simple.

  1. Copy your API Token from your Fathom account to the Add-on configuration screen in JReviews. Save.
  2. Select Fathom Site account that corresponds to your website. Save.

Setup with Google Analytics

When using Dashboard with Google Analytics, the setup process requires quite a few steps to get two pieces of information to complete the setup:

  • Google server-side API authentication credentials
  • Google Analytics view ID

Brace yourself for a horrifying setup process!

  1. Go to the Google Cloud Platform APIs website. You'll need to select existing project or create a new one. If you are already using Google Maps on your site, then you most likely already have a project you can use.

    Google Cloud Platform APIs
    Google Cloud Platform APIs

  2. Add the necessary API to the project. In the sidebar click Library, search for Google Analytics Reporting, click to view the details and enable it.

    Enable Google Analytics Reporting API
    Enable Google Analytics Reporting API

    After enabling the API, go back to the project's API & Services page.

    Go back to the project's API & Services page
    Go back to the project's API & Services page

  3. Create a new Service Account to download the credentials. In the sidebar click Credentials, then at the top click + Create Credentials and select Service Account.

    Create a new Service Account
    Create a new Service Account

    Use any name and ID you want (google-api used below as an example):

    • Service account name: google-api
    • Service account id: google-api (or let it create one for you)
    • Description: JReviews Dashboard Add-on

    Click CREATE AND CONTINUE, then DONE. You can skip optional steps 2 and 3.

    Fill out the service account details
    Fill out the service account details

  4. Find the account you just created under "Service Accounts" on the same page (refresh the page if needed). Click the account link.

    Update the Service Account
    Update the Service Account

    Go to the Keys tab. Then click ADD KEY, and select Create new key. Leave the default "JSON key" type selected, and click CREATE to download the file.

    Create a new key for the Service Account
    Create a new key for the Service Account

    Download the Service Account key JSON file.

    Download the Service Account key JSON file
    Download the Service Account key JSON file

    Copy the contents of the file, as is, to the Google Service JSON setting in the Add-on configuration.

  5. Time to head over to your Google Analytics account, where you will grant authentication account you just created permission to access your Google Analytics property.

    Go to the Admin section of your Google Analytics Account. Click Account Access Management.

    Add Google Service Account as authorized user to your Google Analytics property
    Add Google Service Account as authorized user to your Google Analytics property

    Click the blue (+) icon on the top-right to add a new user. In the email address field, paste the client_email value found in the JSON file you downloaded before, then save.

  6. The final step is to get the View ID that you can find under View Settings in your Google Analytics property. Copy that value and paste it in the Dashboard Add-on configuration and save.

    Add Google Service Account as authorized user to your Google Analytics property
    Add Google Service Account as authorized user to your Google Analytics property

The Add-on automatically validates the credentials when you save them. If everything is ok, then you won't see any errors and you are ready to go.