https://github.com/scriptex/localga
Save a local copy of your Google Analytics script
https://github.com/scriptex/localga
google-analytics offline-analytics
Last synced: 10 months ago
JSON representation
Save a local copy of your Google Analytics script
- Host: GitHub
- URL: https://github.com/scriptex/localga
- Owner: scriptex
- License: mit
- Created: 2018-05-31T06:57:04.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-28T05:31:20.000Z (over 1 year ago)
- Last Synced: 2024-05-02T06:13:51.942Z (over 1 year ago)
- Topics: google-analytics, offline-analytics
- Language: JavaScript
- Homepage: https://atanas.info/portfolio/open-source/localga
- Size: 362 KB
- Stars: 5
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.com/scriptex/localga)
[](https://github.com/scriptex/localga/actions?query=workflow%3ABuild)
[](https://www.codacy.com/gh/scriptex/localga/dashboard?utm_source=github.com&utm_medium=referral&utm_content=scriptex/localga&utm_campaign=Badge_Grade)
[](https://codebeat.co/projects/github-com-scriptex-localga-master)
[](https://www.codefactor.io/repository/github/scriptex/localga)
[](https://deepscan.io/dashboard#view=project&tid=3574&pid=5257&bid=40799)
[](https://github.com/scriptex/localga/)
# Local GA
> Save a local version of your Google Analytics script
## Visitor stats
## Code stats
## About
Google Page Speed Insights complains about the expiry date set for the Google Analytics (or Google Tag Manager) script.
One way to work around this issue is to self host this script.
This however is not so good idea because this way the script will no longer be updated/bug-fixed.
This is where `localga` steps in.
`localga` automates the task of updating the Google Analytics (or Google Tag Manager) script.
You can also use this package if you need (or want to) self host the analytics files because you offer offline experience for your users.
The actual analytics tracking should be done by you and is not part of this package.
## Install
**This module requires NodeJS v18 or higher.**
```sh
npm i localga --save-dev
```
or
```sh
yarn add localga --dev
```
## Usage
1. As a package.json script:
```javascript
"scripts": {
"ga": "localga --id UA-XXXXXXXX-Y --folder ./your/js/folder --name google-analytics-local.js"
}
```
2. From command line (Install the module globally first):
```sh
localga --id UA-XXXXXXXX-Y --folder ./your/js/folder --name google-analytics-local.js
```
The `localga` module will generate two new script files called `google-analytics-local.js` and `analytics.js` placed in the folder you provided.
If no `--folder` is specified, the files will be placed in the root of your project.
After the files are generated, you should `require` the `google-analytics-local.js` file in your bundle (or include it in your HTML file(s)).
Then you should enable the analytics script. Something like the following:
```javascript
window.dataLayer = window.dataLayer || [];
function gtag() {
dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'UA-XXXXXXXX-Y');
```
**UA-XXXXXXXX-Y is your Google Analytics ID**
## LICENSE
MIT
---
Connect with me:
---
Support and sponsor my work:
