Welcome to gitbook-plugin-google-tongji-with-multiple-channel 👋

GitBook plugin that use Google Analytics to analyze website traffic, support for independent analysis of multiple channels, a source code deployed in multiple independent analysis.

Preview

Usage

{
    "plugins": [
        "google-tongji-with-multiple-channel"
    ],
    "pluginsConfig": {
        "google-tongji-with-multiple-channel": {
            "token": "UA-140787039-1"
        }
    }
}

Result

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-140787039-1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-140787039-1');
</script>

Usage

Step #1 - Update `book.json` file

In you gitbook's book.json file, add google-tongji-with-multiple-channel to plugins list.

Here is simplest example :

{
    "plugins": [
        "google-tongji-with-multiple-channel"
    ],
    "pluginsConfig": {
        "google-tongji-with-multiple-channel": {
            "token": "UA-XXXX-Y"
        }
    }
}

In addition, the supported configuration options are as follows :

"gitbook": {
    "properties": {
        "token": {
            "description": "Google Analytics token",
            "required": false,
            "type": "string"
        },
        "url": {
            "description": "Google Analytics Url",
            "default": "https://www.googletagmanager.com/gtag/js",
            "required": false,
            "type": "string"
        },
        "multipleChannelConfig": {
            "description": "Google Analytics Multi-channel Configuration",
            "required": false,
            "type": "object"
        }
    }
}

Step #2 - Run gitbook commands

Run gitbook install. It will automatically install google-tongji-with-multiple-channel gitbook plugin for your book. This is needed only once.

gitbook install

or you can run npm install gitbook-plugin-google-tongji-with-multiple-channel to install locally.

npm install gitbook-plugin-google-tongji-with-multiple-channel

Build your book (gitbook build) or serve (gitbook serve) as usual.

gitbook serve

Step #3 - Verify that Google analysis code is injected

After uploading to the website, visit the homepage of the website to check whether the Google analysis script file is automatically injected.

You can also check whether the configuration is successfully configured in the Google analysis background.

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-140787039-1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-140787039-1');
</script>

Apply

Visit the Google analysis website, register or log in the Google analysis account, click create media resources and fill in the relevant information of the website.

name	demo	remark
name	`github`	required
website	`https://snowdreams1006.github.io/`	required
categories	`other`	required
timezone	`GMT+08:00`	optional

Step #2- Get the Google analysis code

After adding media resources successfully, click next to get the integration code script as follows:

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-140787039-1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-140787039-1');
</script>

name	demo	remark
`Source address`	`https://www.googletagmanager.com/gtag/js?id=UA-140787039-1`	`async`
`url`	`https://www.googletagmanager.com/gtag/js`	`Each site has the same value`
`token`	`UA-140787039-1`	`Each site has a google-tongji-with-multiple-channelerent value`

Step #3- Fill in the Google analysis configuration

Copy the token and url just applied and fill in the book.json configuration file, and fill in the Google analysis configuration information according to the actual situation.

Single channel configuration only needs to fill in the value of token, the rest of the options are optional.

"google-tongji-with-multiple-channel": {
  "token": "UA-140787039-1"
}

In addition to filling in the value of token corresponding to the website domain name, multiple channels also need to fill in the Google analysis url

"google-tongji-with-multiple-channel": {
    "url": "https://www.googletagmanager.com/gtag/js",
    "multipleChannelConfig": {
         "snowdreams1006.gitbook.io":{
            "token": "UA-140787039-1"
        },
        "snowdreams1006.github.io":{
            "token": "UA-140787039-2"
        },
        "snowdreams1006.gitee.io":{
            "token": "UA-140787039-3"
        },
        "snowdreams1006.gitlab.io":{
            "token": "UA-140787039-4"
        },
        "snowdreams1006.tech":{
            "token": "UA-140787039-5"
        },
        "blog.snowdreams1006.cn":{
            "token": "UA-140787039-6"
        }
    }
}

Examples

Official documentation configuration file

https://github.com/snowdreams1006/gitbook-plugin-google-tongji-with-multiple-channel/blob/master/docs/book.json

{
    "plugins": ["google-tongji-with-multiple-channel"],
    "pluginsConfig": {
        "google-tongji-with-multiple-channel": {
            "multipleChannelConfig": {
                 "snowdreams1006.gitbook.io":{
                    "token": "UA-140787039-1"
                },
                "snowdreams1006.github.io":{
                    "token": "UA-140787039-2"
                },
                "snowdreams1006.gitee.io":{
                    "token": "UA-140787039-3"
                },
                "snowdreams1006.gitlab.io":{
                    "token": "UA-140787039-4"
                },
                "snowdreams1006.tech":{
                    "token": "UA-140787039-5"
                },
                "blog.snowdreams1006.cn":{
                    "token": "UA-140787039-6"
                }
            }
        }
    }
}

Official example configuration file

https://github.com/snowdreams1006/gitbook-plugin-google-tongji-with-multiple-channel/blob/master/example/book.json

{
    "plugins": ["google-tongji-with-multiple-channel"],
    "pluginsConfig": {
        "google-tongji-with-multiple-channel": {
            "token": "UA-140787039-1"
        }
    }
}

Note: Above snippet can be used as complete book.json file, if your book doesn't have one yet.

Thanks

GitBook plugin for analytics purpose : gitbook-plugin-analytics
Google Analytics tracking for your book : plugin-ga
A GitBook plug-in that supports multiple modules : gitbook-plugin-devops

Author

👤 snowdreams1006

Contributing

Contributions, issues and feature requests are welcome! Feel free to check issues page.

Show your support

Give a Star if this project helped you!

Copyright

This project is MIT licensed.

Author: snowdreams1006
Url: https://snowdreams1006.github.io/gitbook-plugin-google-tongji-with-multiple-channel/
Source: snowdreams1006.tech
This article was originally published in「snowdreams1006.tech」,Reproduced please indicate the source, thank you for cooperation!

插件官网

Welcome to gitbook-plugin-google-tongji-with-multiple-channel 👋

Preview

Usage

Step #1 - Update `book.json` file

Step #2 - Run gitbook commands

Step #3 - Verify that Google analysis code is injected

Apply

Step #2- Get the Google analysis code

Step #3- Fill in the Google analysis configuration

Examples

Thanks

Author

Contributing

Show your support

Copyright

results matching ""

No results matching ""

Welcome to gitbook-plugin-google-tongji-with-multiple-channel 👋

Preview

Usage

Step #1 - Update book.json file

Step #2 - Run gitbook commands

Step #3 - Verify that Google analysis code is injected

Apply

Step #1- Sign up for Google analytics

Step #2- Get the Google analysis code

Step #3- Fill in the Google analysis configuration

Examples

Thanks

Author

Contributing

Show your support

Copyright

results matching ""

No results matching ""

Step #1 - Update `book.json` file