Recipe for adding Google Analytics

[laurieontech]

Summary

gatsby-plugin-google-analytics is a very popular plugin for Gatsby sites. It could use a recipe for setting it up and generating a tracking ID to use.

What problem(s) did you run into that caused you to request additional documentation? What questions do you think we should answer? What, if any, existing documenation relates to this proposal?

Some recommended topics to cover:

• Creating a domain
• Linking that domain to Google analytics admin
• Getting the analytics tracking id
• Using that id in the plugin

Motivation

Why should we document this and who will benefit from it?
This is a common use case and it would be helpful for new users to have a single place to figure out how to navigate the various steps.

Steps to resolve this issue

Draft the doc

• Write the doc, following the format listed in these resources:
  • Overview on contributing to documentation
  • Docs Templates
  • Example of a similar article
• Add the article to the docs sidebar in the "Recipes" section.

Open a pull request

• Open a pull request with your work including the words "closes Recipe for adding Google Analytics #20384" in the pull request description

[srs231198]

I would love to work on this... is it still available?

[laurieontech]

It is! Thanks @srs231198 :)

[marcysutton]

Hi @srs231198, checking up on this issue -- are you still interested in working on it? Let us know!

[github-actions]

Hiya!

This issue has gone quiet. Spooky quiet. 👻

We get a lot of issues, so we currently close issues after 30 days of inactivity. It’s been at least 20 days since the last update here.
If we missed this issue or if you want to keep it open, please reply here. You can also add the label "not stale" to keep this issue open!
As a friendly reminder: the best way to see this issue, or any other, fixed is to open a Pull Request. Check out gatsby.dev/contribute for more information about opening PRs, triaging issues, and contributing!

Thanks for being a part of the Gatsby community! 💪💜

[marcysutton]

This issue is still open, so I've added the help wanted label to it for now. If anyone would like to work on it let us know!

[jeffpascal]

Hello @marcysutton, i would like to work on this. I have already started.
I will go through:
Buying domain from AWS
Configuring Route 53
Adding the tracking id
Verifying the domain
Code

Is the issue still open, anyone working on it already?

[laurieontech]

Sounds great @jeffpascal! I've removed the help wanted label since you're working on it.

[marcysutton]

One suggestion I would make is to limit the recipe steps to what is essential and common to integrating Google Analytics into a Gatsby site, and make generous use of the Prerequisites section. E.g. there's multiple ways to set this up, and will someone be able to follow the recipe if they aren't using AWS or S3?

[jeffpascal]

@marcysutton I understand.

[jeffpascal]

Hello @marcysutton https://www.gatsbyjs.org/docs/adding-analytics/ already talks about the essentials to integrating google analytics.

I guess i should focus on the creation of the domain and verification?

[marcysutton]

Following up on this, my apologies for the delay! @jeffpascal this issue is about creating a recipe, while that doc is a Reference Guide. They are different formats, and a recipe is meant to be short and actionable (like a stripped-down tutorial with only the essentials). You can read more about the recipe format here: https://www.gatsbyjs.org/contributing/docs-templates/

[jeffpascal]

@marcysutton got it. Will be done soon.

[laurieontech]

This is handled in the recently merged PR! So going to close this issue.