231

Could be a simple question but I am full of doubts right now about adding Google Analytics Tracking ID to GitHub page.

I am using GitHub automatic page generator to create my GitHub page but it asks for "Google Analytics Tracking ID". I tried to sign up with Google Analytics but there on it asks for website URL.

Now what I am supposed to do?

One more ques: can we add Google Analytics Tracking ID later on after GitHub Page has been created?

4
  • Quite a few suggested approaches but I can't get/confirm any of them working yet. I'm hoping it will just start working in 24 hours or so. May 3, 2019 at 10:46
  • 2
    /Headdesk. I had my Brave browser blocking trackers on my sites. It was working the whole time. Also a confusing thing for me was the (semi) recent move from ga (google analytics) to gtag (google tag). Apparently you only need the gtag() stuff now, no longer the ga() stuff. Fun. These links helped me diagnose my problem: chrome.google.com/webstore/detail/tag-assistant-by-google/… and analyticsmania.com/post/google-tag-manager-vs-google-analytics May 3, 2019 at 13:20
  • @ChrisEmerson that's some useful update :)
    – exexzian
    May 20, 2019 at 18:52
  • 1
    I had similar issues of my visits not registering, turns out AdBlock was responsible for them.
    – Andrew Zaw
    Jan 6, 2020 at 19:35

12 Answers 12

185

Update: Added steps descriptions for others

Solved it:
had to include username.github.io (link that I want to track) in Google Analytics website section.

you can check GitHub help page here


enter image description here


After that I was provided with an Tracker ID.


Note: You can easily change or add more websites on Google Analytics page from your Google Analytics admin panel.


Update 2: - Adding Google Analytics Tracking ID to Already created Github pages (As requested by @avi-aryan )

  1. Browse to your github pages branch - which would be something like -
    ( https://github.com/YourUserName/YourRepository/tree/gh-pages )
  2. Then edit index.html from listed files
  3. Now in within HEAD tag of index.html - paste your Google Analytics Tracking ID Script ( if have already signed up for Google analytics then you can browse it under admin and then tracking info tab )
32
  • 2
    I have added them, however Google analytics say the Tracking is not installed. My page as specified in G-Analytics is http://avi-aryan.github.io
    – Avi
    Jul 15, 2013 at 12:33
  • 1
    @OhadR ohh sorry for that if it didn't helped u
    – exexzian
    Dec 14, 2013 at 13:46
  • 1
    FYI: I used the same logic for editing index.html for adding twitter's conversion tracking too. Thanks! Feb 25, 2015 at 1:42
  • 2
    @sc28 when did you put analytics on your page? google usually updates the dashboard after quite a while
    – exexzian
    Sep 6, 2017 at 15:56
  • 3
    @sc28 no it usually takes a day or two.. check after a day or two
    – exexzian
    Sep 6, 2017 at 16:06
94

For anyone interested, if you are using Jekyll with GitHub pages, I just wrote a post showing how to correctly add Google Analytics Tracking ID to Jekyll.

  1. You will find your Universal Analytics tracking code under Admin > Property > Tracking Info > Tracking Code.

  2. Create a new file called analytics.html in the _includes folder found in your Jekyll website’s directory.

  3. Add Google Analytics Tracking ID code to analytics.html.

  4. Finally, open _layouts/head.html, and add {% include analytics.html %} just before the end </head> tag. Google recommends this placement to track all of the pages on your website correctly.

4
  • 5
    Thank you, great post. It's worth noting that within GitHub Pages it is set jekyll.environment == 'production' automatically (github.com/jekyll/jekyll/issues/1219), while the Jekyll default environment is 'development'
    – Andrea
    Jun 4, 2016 at 8:28
  • 1
    I had _layouts/default.html, but it worked just fine (I'm not familiar with Jekyll) Mar 9, 2020 at 3:48
  • Alternatively, just copy it directly into head.html Oct 23, 2021 at 7:05
  • Is this out of date? Google Analytics now uses the 'Google tag' instead of the Global Site Tag.
    – Macaulay
    Jan 21 at 3:43
24

If you are using the minima template provide by Jekyll then -

  1. Add google_analytics: UA-xxxxxxxx-x to your _config.yml
  2. Create a file _includes/google-analytics.html and add the google analytics js code in it.

Replace

ga('create', 'UA-xxxxxxxx-x', 'auto');

with

ga('create', '{{ site.google_analytics }}', 'auto');

and you are set!

The google analytics code will now display if your site is built in production environment. For reference see the template's source code here - https://github.com/jekyll/minima

You can follow the same approach if you are using a different template by referencing the template's source code and replacing the corresponding files.

2
16

Is better to use GA-Beacon for that. GA-Beacon can track all your GitHub repo, even if the visited link isn't an html document.

Please check: https://github.com/igrigorik/ga-beacon

3
  • It works but all my real time data records it came from Ashburn VA. Even when i visit the page locally...very far from VA.
    – jtlindsey
    May 18, 2016 at 14:30
  • @jtlindsey - Is there any chance that your image/pixel is being cached at a CDN in Ashburn VA? Jun 27, 2016 at 17:41
  • @pulkitsinghal I'm not entirely sure, That post was almost a month ago and I had been using it for a few weeks and data was always Ashburn VA. Looking back at my data now, the data shows location not set for real-time but there are queries from all over the world in history so I'm not sure where the error is. I will likely remove it because the data isn't correct.
    – jtlindsey
    Jun 27, 2016 at 19:29
9

Adding analytics via _config.yml.

All GitHub themes (supported themes) natively support google analytics. You just have to provide a tracking code (UA-XXXXXXXXX-X).

Google analytics comes in two flavours - Google analytics 4 (GA4), and Universal analytics. You will have to use the latter for this. GA4 will not work #.

  1. Create a new Universal google analytics property (and not GA4 property). By default the tracking property you create will be of type GA4. You will have to select "Create a Universal Analytics property" for the property to be universal. Once a GA4 property is created it cannot be converted to Universal property. You can only do this while creating a new property.

Show advanced options

1.1 Turn Universal analytics on in the advanced options.

Create a Universal Analytics property

1.2 Configure Universal analytics options.

Universal analytics options

1.3 Copy the tracking ID for this newly created property.

Tracking ID

  1. Add this tracking ID to your gh-pages sites's _config.yml.

    google_analytics: UA-XXXXXXXXX-X

The following is from modernist's readme - the theme I was using for my site.

modernist theme readme

  1. Commit and Push the changes to github, and after few minutes navigate to your site's URL.

  2. Verify that everything went fine.

If you search the source code now for the tracing ID, you will be able to find it. Google analytics dashboard too will start showing activity.

Tracking code in site's source

The above steps show how to add google analytics to an existing gh-pages site. You can use the same code while creating a new gh-pages site too. Although it seems automatic page generator no longer exists - Can't locate "automatic page generator" button in Github

# Maybe there is a way to use GA4 natively by configuring _config.yml. I wasn't able to do that, and had to resort to universal analytics.

Reference(s)

https://www.analyticsmania.com/post/downgrade-from-google-analytics-4-to-universal-analytics/

2
  • In 1.2, is it okay to choose 'Create both a Google Analytics 4 and a Universal Analytics property' or should we create a Universal Analytics property only?
    – codesnerd
    Jul 6, 2021 at 13:08
  • 1
    @codesnerd I went for universal analytics only (although I just noticed that the pic I uploaded shows radio button for both selected). Both might work, as long as you get ID of the form UA-XXXXXXXXX-X. The GA4 ID has a different format. Jul 6, 2021 at 13:46
6

You can add Google Analytics to a Jekyll site the same way you would any other site.

First, after setting up your Google Analytics account, navigate to the admin tab.

navbar

Next, under the accounts panel, on the left, click: Create New Account.

add account

In Google Analytics, an account represents a set of pages that you would like to track. Set up the website's account as desired.

After your account has been created you will be sent to a page which tells you your Tracking ID and has a JavaScript snippet for you to put on the pages you would like to track. Simply put this snippet in all the pages you would like to track. Or, if you use a default layout put this snippet somewhere in it.

By the way, since you are hosting on GitHub Pages you don't need Google Analytics unless you want very detailed analytics. If all you care about is page views GitHub has this.

1
  • 4
    I'm pretty use that GitHub's tracking is only for traffic onto the GitHub repository itself (including source code). My GitHub Pages site repo only shows traffic to GitHub URLs. Sep 4, 2016 at 2:59
6

I use the README.md file as a source for my GitHub personal page. I also use one of the GitHub supported themes 'cayman'. No more files is required in the repository apart from _config.yml (unless you want to modify your supported theme).

To add Google Analytics, I just followed the advice in the 'cayman' repository (https://github.com/pages-themes/cayman):

Cayman will respect the following variables, if set in your site's _config.yml:

google_analytics: [Your Google Analytics tracking ID]

Full stop! Anything else! Everything works on the side of Google Analytics! It may be a viable option for those who look for a quick set up of GitHub Pages with Google Analytics.

5

If you're using an automatically generated github page from your github README.md I found this to be the easiest way: Just edit your _config.yml to look like this (with your own google analytics UA id):

theme: jekyll-theme-cayman
title: My Site
description: My site description
url: https://example.com
author: MyName
plugins:
  - jekyll-seo-tag
google_analytics: UA-xxx

Then add a new file to your repository root named Gemfile with this content:

source "https://rubygems.org”
gem "github-pages", group: :jekyll_plugins
gem 'jekyll-seo-tag'

Then wait a bit and refresh your github page and show page source code. Verify that the SEO plugin has inserted your analytics java script. More info here: https://github.com/jekyll/jekyll-seo-tag

From the installation instruction, I didn't have to add the {% seo %} in the html, luckily, because I have no html. Github seems to have thought of that.

2

With me, I was unable to configure Google Analytics 4 (prev Web+App) via adding google_analytics: UA-xxxxxxxx-x to your _config.yml as mentioned previously in one of the answers.

So I had to put the js recommended by the Google Analytics in the .md file.

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

  gtag('config', 'G-XXXXXXXXXXX');
</script>

Anything you put in the script tag in .md will not be rendered.

1
  • I downgraded from google analytics 4 to universal analytics for the same reason. Universal Analytics gives tracking code of the form UA-xxxxxxxxx-x, GA4 doesn't. analyticsmania.com/post/… May 21, 2021 at 14:56
1

Include a Global site tag in the html output <head>

Once you setup a Google Analytics account, detailed instructions are included under the "Data Streams" tab- select your data source, and then "Tagging instructions" for Global site tag(gtag.js)

Global site tag

the script will look something like this (with id replaced by XXXXXXXXXXX in my example):

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

  gtag('config', 'XXXXXXXXXXX');
</script>

Save the html script within a file in your Project directory (e.g. as "GA_script.html")

Add html file to the header

in the Rmarkdown YAML, add the reference to your specific script (see ref here):

output:
  html_document:
    includes: 
      in_header: GA_script.html
0

This appears to be a bug in Jekyll Minima. See these GitHub issues for reference:

0

Set google_analytics at _config.yml with tracing-id started with UA- rather than G-,tracing-id like G-xxxx is of Google Analytics 4. and Jekyll does not support Google Analytics 4.

Use

google_analytics: UA-xxxxxx-x

Do not use

google_analytics: G-xxxxxx

However,Google Analytics(Universal Analytics) is no longer supported by Google until 2023.7.1.

0

Not the answer you're looking for? Browse other questions tagged or ask your own question.