Merge Google Analytics content into Traffic Analytics

Author: astrojuanlu

docs/advertising/advertising-details.rst

@@ -119,13 +119,13 @@ our own goals.
 
 We have taken steps to address some of the privacy concerns surrounding GA.
 These steps apply both to analytics collected by Read the Docs and when
-:doc:`authors enable analytics on their docs </google-analytics>`.
+:ref:`authors enable analytics on their docs <analytics:Enabling Google Analytics on your Project>`.
 
 * Users can opt-out of analytics by using the Do Not Track feature of their browser.
 * Read the Docs instructs Google to anonymize IP addresses sent to them.
 * The cookies set by GA expire in 30 days rather than the default 2 years.
 * Project maintainers can completely disable analytics on their own projects.
-  Follow the steps in :ref:`google-analytics:Disabling Google Analytics on your project`.
+  Follow the steps in :ref:`analytics:Disabling Google Analytics on your project`.
 
 
 Why we use analytics

docs/analytics.rst

@@ -1,7 +1,7 @@
-Analytics
----------
+Traffic Analytics
+=================
 
-Analytics lets you see *which* documents your users are reading.
+Traffic Analytics lets you see *which* documents your users are reading.
 This allows you to understand how your documentation is being used,
 so you can focus on expanding and updating parts people are reading most.
 
@@ -18,7 +18,36 @@ and then click on :guilabel:`Traffic Analytics`.
 
 You can also access to analytics data from :ref:`search results <server-side-search:analytics>`.
 
+Enabling Google Analytics on your Project
+-----------------------------------------
+
+Read the Docs has native support for Google Analytics.
+You can enable it by:
+
+* Going to :guilabel:`Admin` > :guilabel:`Advanced Settings` in your project.
+* Fill in the **Analytics code** heading with your Google Tracking ID (example `UA-123456674-1`)
+
+Once your documentation rebuilds it will include your Analytics tracking code and start sending data.
+Google Analytics usually takes 60 minutes,
+and sometimes can take up to a day before it starts reporting data.
+
 .. note::
 
-   If you require more information about page views,
-   you can use a solution like :doc:`Google Analytics </google-analytics>`.
+   Read the Docs takes some extra precautions with analytics to protect user privacy.
+   As a result, users with Do Not Track enabled will not be counted
+   for the purpose of analytics.
+
+   For more details, see the
+   :ref:`Do Not Track section <privacy-policy:Do Not Track>`
+   of our privacy policy.
+
+Disabling Google Analytics on your project
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Google Analytics can be completely disabled on your own projects.
+To disable Google Analytics:
+
+* Going to :guilabel:`Admin` > :guilabel:`Advanced Settings` in your project.
+* Check the box **Disable Analytics**.
+
+Your documentation will need to be rebuilt for this change to take effect.

docs/google-analytics.rst

@@ -266,7 +266,7 @@ Some of the most valuable feedback these provide include:
 Analytics tools
 ~~~~~~~~~~~~~~~
 
-A tool like :doc:`Google Analytics </google-analytics>`
+A tool like :ref:`Google Analytics <analytics:Enabling Google Analytics on your Project>`
 can give you feedback about the search terms people use to find your docs,
 your most popular pages, and lots of other useful data.
 

docs/guides/technical-docs-seo-guide.rst

@@ -82,7 +82,6 @@ and some of the core features of Read the Docs.
   :doc:`/hosting` |
   :doc:`/server-side-search` |
   :doc:`/analytics` |
-  :doc:`/google-analytics` |
   :doc:`/pull-requests` |
   :doc:`/build-notifications` |
   :doc:`/user-defined-redirects`
@@ -114,7 +113,6 @@ and some of the core features of Read the Docs.
    /hosting
    /server-side-search
    /analytics
-   /google-analytics
    /pull-requests
    /build-notifications