GA-4 Analytics [Support Thread]

Re-creating the support thread, since the original one "went missing".

The GA-4 Analytics plugin (available at https://www.zen-cart.com/downloads.php?do=file&id=2368) can be used on Zen Cart sites using 1.5.6b through 1.5.8 without issue. For 1.5.6b installations (or non-standard/older templates), be sure to read the readme since there are a couple of notifications that must be added to template files for the GA-4 Analytics' observer class to do its thing.

Other than that, no core file overwrites, just a couple of configuration settings in your admin.

Small problem on account history info page; issue created in Github wi/log.

Users of older GA plugins may wish to delete the entry under Admin > Configuration for Universal Analytics. For Simple GA it can be done by removing

admin/includes/extra_datafiles/google_analytics_database_names.php

swguy:

Users of older GA plugins may wish to delete the entry under Admin > Configuration for Universal Analytics. For Simple GA it can be done by removing

admin/includes/extra_datafiles/google_analytics_database_names.php
Thanks, @swguy. I'll add this to the plugin's documentation.

Hi,

I have just yesterday installed ZC 1.5.8a and GA4.
I have found many DEBUG files in log directory.

All errors are this form:
[29-Mar-2023 16:22:41 UTC] Request URI: /index.php?main_page=product_reviews_write&products_id=11, IP address: 65.108.2.171, Language id CZK
#0 /pub/amforawa/vialux.cz/web/www/includes/classes/observers/class.ga4_analytics.php(79): zen_debug_error_handler()
#1 /pub/amforawa/vialux.cz/web/www/includes/autoload_func.php(47): ga4_analytics->__construct()
#2 /pub/amforawa/vialux.cz/web/www/includes/application_top.php(237): require('...')
#3 /pub/amforawa/vialux.cz/web/www/index.php(25): require('...')
--> PHP Warning: Undefined array key "currency" in /pub/amforawa/vialux.cz/web/www/includes/classes/observers/class.ga4_analytics.php on line 79.

on the row 79 in the ga4_analytics.php is this code:

$this->currency_decimal_places = $currencies->currencies[$_SESSION['currency']]['decimal_places'];

I find this code right, but understand what is wrong.
$_SESSION['currency'] is "CZK" and the decimal_places is ind the DB set to 2.
when I change the row 79 to this, it will works

$this->currency_decimal_places = 2;

so the problem is in the class Currencies, but I don't understav why.

can you help me?
than k you Dalibor

I have also seen this on one site (but not others). My workaround was to force-set that variable.

Borek:

Hi,

I have just yesterday installed ZC 1.5.8a and GA4.
I have found many DEBUG files in log directory.

All errors are this form:
[29-Mar-2023 16:22:41 UTC] Request URI: /index.php?main_page=product_reviews_write&products_id=11, IP address: 65.108.2.171, Language id CZK
#0 /pub/amforawa/vialux.cz/web/www/includes/classes/observers/class.ga4_analytics.php(79): zen_debug_error_handler()
#1 /pub/amforawa/vialux.cz/web/www/includes/autoload_func.php(47): ga4_analytics->__construct()
#2 /pub/amforawa/vialux.cz/web/www/includes/application_top.php(237): require('...')
#3 /pub/amforawa/vialux.cz/web/www/index.php(25): require('...')
--> PHP Warning: Undefined array key "currency" in /pub/amforawa/vialux.cz/web/www/includes/classes/observers/class.ga4_analytics.php on line 79.

on the row 79 in the ga4_analytics.php is this code:

$this->currency_decimal_places = $currencies->currencies[$_SESSION['currency']]['decimal_places'];

I find this code right, but understand what is wrong.
$_SESSION['currency'] is "CZK" and the decimal_places is ind the DB set to 2.
when I change the row 79 to this, it will works

$this->currency_decimal_places = 2;

so the problem is in the class Currencies, but I don't understav why.

can you help me?
than k you Dalibor

i disagree. i think the problem is with your $_SESSION['currency'] var. the error is saying that array value is not set.

if one looks at when the currencies get set, it is at load point 120.

the ga-4 analytics code gets set at load point 90.

the ga-4 analytics needs to be loaded AFTER the currencies get loaded in order that the currency value of the SESSION array is available.

best.

Agreed, @carlwhat, GitHub issue opened: https://github.com/lat9/ga4-analytics/issues/13

The issue can be corrected via edit to /includes/auto_loaders/config.ga4_analytics.php, changing this section

$autoLoadConfig[90][] = [
    'autoType' => 'class',
    'loadFile' => 'observers/class.ga4_analytics.php'
];
$autoLoadConfig[90][] = [
    'autoType' => 'classInstantiate',
    'className' => 'ga4_analytics',
    'objectName' => 'ga4_analytics'
];

to read

$autoLoadConfig[[B]120[/B]][] = [
    'autoType' => 'class',
    'loadFile' => 'observers/class.ga4_analytics.php'
];
$autoLoadConfig[[B]120[/B]][] = [
    'autoType' => 'classInstantiate',
    'className' => 'ga4_analytics',
    'objectName' => 'ga4_analytics'
];

Nicely done @carlwhat!

Yes, thanks.

There I don't search the problem.
I have set the index as the last one that I have in my config.core.php

have a nice day
Borek

GA4 Analytics v1.2.0 is now available: https://www.zen-cart.com/downloads.php?do=file&id=2368

This release contains corrections for the following GitHub issues:

#11: Correct determination of products' information pages.
#12: Don't include a view_item event for invalid products.
#13: Need to load after currencies are instantiated, corrects PHP warning.
#14: Enable analytics to use either GA4 (gtag.js) or GTM (gtm.js) reporting.
#15: Don't log a PHP Warning if the required notification is missing.
#16: Include user_id for GTM reporting and enable site-specific customizations.
#17: Correct misspelling of item_name parameter for shopping-cart based items.

GA-4 Analytics v1.2.1 is now available for download.

This release contains changes associated with the following GitHub issues:

#18: Correct MySQL error (products_all) when Bootstrap template is in use.

Sorry for the churn, but v1.2.2 is now available for download.

This version corrects unwanted PHP warnings on the featured_products page.

lat9:

Re-creating the support thread, since the original one "went missing".

The GA-4 Analytics plugin (available at https://www.zen-cart.com/downloads.php?do=file&id=2368) can be used on Zen Cart sites using 1.5.6b through 1.5.8 without issue. For 1.5.6b installations (or non-standard/older templates), be sure to read the readme since there are a couple of notifications that must be added to template files for the GA-4 Analytics' observer class to do its thing.

Other than that, no core file overwrites, just a couple of configuration settings in your admin.
I reviewed the readme.html but it doesn't mention older versions. How does one install this on 1.5.5f?

Techiant:

I reviewed the readme.html but it doesn't mention older versions. How does one install this on 1.5.5f?
One doesn't! The plugin supports zc156 and later.

Is there another plug in that can handle GA4? Or a manual way to insert code in a header file?

The phrase "The plugin supports zc156 and later" means the plugin relies on internal Zen Cart code changes (often but not exclusively notifiers) that are only present in a specific release or higher.

1.5.5 is quite old and only runs on long-deprecated versions of PHP that are vulnerable to attack. You need to upgrade.

https://docs.zen-cart.com/user/upgrading/

I have installed the GA-4 Analytics update to Zen Cart 1.5.6c however I get an error in the log and Web site doesn't load

PHP Parse error: syntax error, unexpected '?' in /includes/classes/observers/class.ga4_analytics.php on line 309

case FILENAME_SPECIALS:
global $specials, $listing;

                        $products = $listing ?? $specials ?? [];                    <<line 309
                        if (empty($products)) {
                            break;
                        }
                        $_SESSION['ga4_analytics'][] = [
                            'event' => 'view_item_list',
                            'parameters' => [
                                'item_list_name' => GA4_ANALYTICS_SPECIALS,
                                'items' => $this->getListingItems($products),
                            ]
                        ];
                        break;

I have put the G- code in the GA4 Analytic admin field.

Any ideas?

You need to update the site to PHP 7.0 at a minimum. The null-coalesce operator (??) wasn't available until that PHP version.

Thought it might be something like that, but don't like updating PHP unless instructed.

Thank you

Updated Php version on server to 7 however I though I would see the change appear on the web site admin under the version menu?

But it still has PHP Version 5.6.40

Does it take a while to filter through?