Page Cache plug-in

Opencart extension Lightning, Nitro, Rocket, Jet Cache all similar extensions generate html pages and serve these instead of processing the PHP again and again. In order to get correct analytics specially where varible data like user email etc. is required to be sent to Analytics or other platform it is important that these are not coming from a Cache page.

You need to make sure that you exclude the follwoing in JS Combine and Miniy exclude section so the Javascript section of the extension is not combine and moved down use the follwoing in JS exclusion 

nitro-exclude 

You also need to exclude the URL for route calling tagmanager/gtm

Full path for the extension for various version of Opencart are as under

Opencart 1.5, 2.0

route=module/tagmanager/gtm

Opencart 2.1

route=analytics/tagmanager/gtm

Opencart 2.3, 3.0

route=extension/analytics/tagmanager/gtm

Opencart 4

route=extension/tagmanager/analytics/tagmanager/gtm

Simliar exceptions are in all kind of cache plugins 

Server Side Cache

For server side cache like Lightspeed, Cloudflare make sure you are doing the same exception atleast for tagmanager/gtm route which should be bypassed from any kind of cache.

Downlaod the extension files and extract them.

1. Locate the Opencart 1.5x folder
2. upload the content of the upload folder to your route of the website
3. vqmod is required so make sure that you have vqmod already installed
4. Login to Admin of your store
5. Add User Permission to User group for newly uploaded files
6. From the Extension section install the module

For complete installation guide view the video below

Firstly login to you Pixel Event dashboard and go to settings

Scroll down to Conversion section

If you have already setup the conversion parameters you can just Generate token or take the guided setup to setup Converison API and generate a token.

You then copy and paste the token to Extension settings

Once you have add the api token apply the settings, and move to main settings tab enable Debug API and apply the settings

Open you store and visit a product page, go back to Admin, and refresh the page once to reload the log files

Go to Logs secions if the log shows entries with response code 200 than the API has started working and everything is correct

2023-05-30 16:35:24 - Pixel API Response Code: 200

If the Response code is not 200 something is not right contact support.

Licence can be generated at https://licence.aits.xyz

Once the licence is generated and installed on a live domain it cannot be changed and you need to buy a new licence for a new domain. 

Subdomain are not counted as new domain dev.yourdomain.com, test.yourdomain.com will not require additional licence.

Multistore Licence the same licence key generated for parent domain can be used to enable extension for multi stores.

When generating a licence do not include https:// or http:// or www in the start of the domain or include / at the end of domain:

Subdomain for 2 letter tlds .gr .hk etc. for domain like test.gr if you are not able to generate a licence for dev.test.gr contact us. 

If case of any issue with licence or activation please contact us 

signin to your Google Ads account, from the Top menu Go to Conversion section

If you haven't created any conversion you can create a new one. 

If you already have a Conversion setup then you can click on that 

Once you are in you can scroll down and go to use Google Tag manager

Here you will find the Conversion ID and Label

You can copy the conversion id and conversion label in to extension settings.

Cookie Consent v3 by cookieconsent.orestbida.com is provided in the extension. 

The javascript is located in catalog/view/javascript/tagmanager folder.

The Cookie Consent section of the extension provide full control on how the consent look, text, theme colors etc.

Theme CSS is located in catalog/view/javascript/tagmanager/consent-themes.css which can be modified to fit as per your requirement

The new consent come with Main popup and Preference Popup. You can define the Layout and Position of both use the extension settings as shown in the image below:

Switching on Disable page interaction will disable the page until the user accept or reject the cookie consent.

You can also show a badge to call the cookie setting modal. Also you can add below code in any link, div, button, img tag to call preference window

data-cc='show-preferencesModal'

• Enable Cookie consent will show a popup that can be customize 
• Enable enforce mode to block all cookies from saving until the consent is granted, if the enforce mode is off, the banner will be displayed but all consent will be granted by default. Depending on your country you can use this for strict compliance.

Tip: Do not use ' or " in any text field. If you need to use ' or " put a \ before i.e. \' or \" 

Google Consent mode v2 

From version 10.6 Google Consent mode v2 is also implemented, two new configuration are passed to Google

ad_user_data

ad_personalization

depending on client selection they will be sent denied or granted for Google to allow collection of additional advertising data

gtag('consent', 'default', {
  'ad_storage': 'denied',
  'ad_user_data': 'denied',
  'ad_personalization': 'denied',
  'analytics_storage': 'denied'
});

url_passthrough

When cookie storage is denied for analytics or ads the url_passthrough parameter is set for gtag to pass GCLID or DCLID via URL parameters across pages. (implemented from version 10.6)

gtag('set', 'url_passthrough', true);

Redact ads data

If marketing cookies are denied ads_data_redaction is set to pass 

When ads_data_redaction is true and ad_storage is denied, ad click identifiers sent in network requests by Google Ads and Floodlight tags will be redacted. Network requests will also be sent through a cookieless domain. (implemented from version 10.6)

gtag('set', 'ads_data_redaction', true);

Disabling Consent Popup for selected countries using CloudFlare

Note: You website should be using Cloudflare DNS as the script use $_SERVER["HTTP_CF_IPCOUNTRY"] varaible to determine user location.

By adding 2 letter ISO country code you can completely bass pass Consent banner and grant consent by default for selected countires where Consent is not required by law.

<?php
/* Digital Marketing Tools v:12.1 22-SEP-2024*/
/* system/library/dmt/lib_customconfig.php */
/* Plug in code for adding Custom Purchase event to Meta Pixel you can add your custom codes in pixel_custom_event.php */
define('CUSTOM_COST_EVENT', false);
define('CUSTOM_COST_EVENT_NAME', 'shipping/payment');
/* shipping/payment for shipping method / payment method */


/* CUSTOM Tiktok events, making true you can add your custom tiktok codes in custom_tiktok_event.php */
define('CUSTOM_TIKTOK_EVENT', false);

/* CONSENT Bypass Based on Cloudflare $_SERVER["HTTP_CF_IPCOUNTRY"]*/
/* PROVIDE 2 letter country code saperated by comma */
define('CONSENT_BYPASS', true);
define('CONSENT_BYPASS_COUNTRY', 'US,CA,AU,PK');
?>

Here, US, CA, AU, PK country user will not see the popup banner.