@ima/plugin-analytic-google
This is the Google analytic plugin for the IMA.js application. You can visit our site https://imajs.io.
The plugin currently implements GA4 analytics.
Installation
npm install @ima/plugin-analytic-google @ima/plugin-script-loader --save
var vendors = {
common: [
'@ima/plugin-analytic-google',
'@ima/plugin-analytic',
'@ima/plugin-script-loader'
]
};
prod: {
$Http: { ... },
$Cache: { ... },
$Page:{ ... },
plugin : {
analytic: {
google4: {
service: 'G-XXXXXXXXXX'
}
}
}
}
import { GoogleAnalytics4 } from '@ima/plugin-analytic-google';
import { RouterEvents } from '@ima/core';
var $window = oc.get('$Window');
var $dispatcher = oc.get('$Dispatcher');
var googleAnalytics4 = oc.get(GoogleAnalytics4);
if ($window.isClient()) {
const purposeConsents = getPurposeConsents();
googleAnalytics4.init(purposeConsents);
googleAnalytics4.load();
$dispatcher.listen(RouterEvents.AFTER_HANDLE_ROUTE, (pageData) => {
if (pageData &&
pageData.response &&
(pageData.response.status >= 200 &&
pageData.response.status < 300)) {
googleAnalytics4.hitPageView(pageData);
} else {
var label = pageData.params.error ? pageData.params.error.toString() : undefined;
var value = pageData.response.status ? pageData.response.status : undefined;
googleAnalytic.hit({
category: 'error',
action: 'render',
label,
value
});
}
});
}
Handling user's purpose consents in GA 4
By default, this plugin sets Google analytic that user didn't grant any purpose consent.
In Google Analytics 4 this leads to hidden all analytics data from GA user interface. Therefore, handling user's purpose consents in GA 4 is crucial.
You can set user's purpose consents in init method by passing object with Purpose Consents structure of TCModel, see: https://www.npmjs.com/package/@iabtcf/core#tcmodel.
Now it looks just for purpose 1, therefore the minimal purposeConsents
object with permission granted is { '1': true }
.
GA4 comes with possibility to change purpose consents at any time after initialisation by method updateConsent
.
Dependencies
If you are looking more details, you should
follow this links:
https://github.com/seznam/IMA.js-plugins/tree/master/packages/plugin-analytic,
https://github.com/seznam/IMA.js-plugins/tree/master/packages/plugin-script-loader