kunoichi/ga-communicator

Communicate with Google Analytics API.

3.7.1 2024-10-08 07:46 UTC

README

Tags: google-analytics, api
Contributors: tarosky, Takahashi_Fumiki
Tested up to: 6.2
Requires at least: 5.9
Requires PHP: 7.2
Stable Tag: nightly
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.txt

Let your WordPress communicate with Google Analytics API.

Description

This plugin has custom functions to connect with Google Analytics.

NOTICE: Google will stop Universal Analytics(UA) at July 1st, 2023. Since then, you will be able to create only Google Analytics 4(GA4) accounts. API for UA is Core Reporting API, and one for GA4 is Google Analytics Data API. This API change is a breaking change. Please see our wiki to check what you should do for the migration.

Default Feature

  • Setting screen. You can check the connection and set up GA tags.
  • Popular posts widget.

Register Service Account and Setup

To communicate with Google Analytics, WordPress needs permission to do so.

Service Account works as permission.

Get the service account key at Google API Console(document).

A service account is like a bot with email and performs like a virtual Google account.

  1. Create a service account. You may be requested to create a new project, or else you can also use an existing project. The bot belongs to the project.
  2. Get private key in JSON format for the service account.
  3. Enable Analytics Reporting API and Google Analytics API for the project.
  4. Copy the service account's email address and add it to a member of your Google Analytics account, properties, or profiles. It depends on your Google Analytics permission policy.
  5. Go to your WordPress admin Setting > Google Analytics Setting and save the private key that you get in step 2.

NOTICE: Save whole credentials including empty line with +A and +C. Otherwise, your key will be considered invalid by Google's API.

If the service account is valid, you can see your Google Analytics Properties in your WordPress Admin screen.

Custom Use

If the setup is ready, you can communicate with Google Analytics through the function ga_communicator_get_report( $config ). It's a utility function to access batchGet API.

Please visit our Wiki to find many code examples.

Installation

From Plugin Repository

Click install and activate it.

Via Composer

You can install this plugin as a composer library. See our Wiki.

FAQ

Where can I get support?

Please create a new ticket on the support forum.

How can I contribute?

Create a new issue or send pull requests.

Changelog

3.7.1

  • Fix setting error on individual activation under network install.

3.0.0

2.0.0

  • Works as a single WordPress plugin.

1.0.0

  • First release as composer library.