Update module documentation about 4.0.0 usage and new features

Created on 21 June 2023, about 1 year ago
Updated 11 July 2023, 12 months ago

Problem/Motivation

The current module documentation at https://www.drupal.org/docs/contributed-modules/google-analytics-counter β†’ is written for the 8.x-3.0 version with Universal Analytics setup.
July 1st, 2023 UA will no longer collect data, so we need a proper guide for the GA4 setup. Existing documentation should be left there, we need to add new pages to the guide:

  • how to set up the 4.0.0 version for a new site, including
    • step by step tutorial for Google Cloud Console setup to get credentials JSON-file,
    • how to set permission for service account on a Google Analytics 4 property
    • what dimension and metric should be used
    • how to adjust the amount of node to process, as thousands or millions of node viewcount update would use a lot of resources
    • how to add a counter field to the node types
    • URL Alias result processor
    • NID result processor, and how to submit custom Node ID dimension to GA4 with GTM to use this
  • how does the module fetch data - about the cron process and queues
  • how to display the view count
  • how can someone extend module functionality:
    • for altering GA4 request query: google_analytics_counter.query_alter event subscribing
    • for altering how the GA4 data is processed: GoogleAnalyticsCounterResultProcessor plugins
    • for altering cron job: overriding google_analytics_counter.cron service

Steps to reproduce

Proposed resolution

Remaining tasks

User interface changes

API changes

Data model changes

πŸ“Œ Task
Status

Fixed

Version

4.0

Component

Documentation

Created by

πŸ‡ΈπŸ‡°Slovakia kaszarobert

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Production build 0.69.0 2024