[IMP] website: update doc about Google Analytics config

website/optimize.rst

@@ -7,6 +7,7 @@ Optimize
 
    optimize/seo
    optimize/google_analytics
+   optimize/google_analytics_dashboard
 
 
 

website/optimize/google_analytics.rst

@@ -1,54 +1,31 @@
-==================================================
-How to track your traffic through Google Analytics
-==================================================
+=======================================================
+How to track your website's traffic in Google Analytics
+=======================================================
 
-To setup the signin process with Google, first you have to perform the following steps:
+To follow your website's traffic with Google Analytics:
 
+- `Create a Google Analytics account <https://www.google.com/analytics/>`__ if 
+  you don't have any.
 
--   Connect on your google account and go to https://console.developers.google.com
+- Go through the creation form and accept the conditions to get the tracking ID.  
 
--   Click on **Create Project** and enter a project name
-
-    .. image:: media/GC_create_project.png
+    .. image:: media/google_analytics_account.png
         :align: center
 
-    .. image:: media/GC_new_project.png
+- Copy the tracking ID to insert it in Odoo.
+
+    .. image:: media/google_analytics_tracking_id.png
         :align: center
 
--   In the menu on left side, select the sub menu APIs (from menu APIs and auth) and
-    activate **"Analytics API"** by clicking on button "OFF". When it's done, check
-    that the button of **"Calendar API"** is well in green and with text "ON"
+- Go to the *Configuration* menu of your Odoo's Website app.
+  In the settings, turn on Google Analytics and paste the tracking ID.
+  Then save the page.
 
-    .. image:: media/GC_API.png
+      .. image:: media/google_analytics_settings.png
         :align: center
 
-    .. image:: media/GC_off_api.png
-        :align: center
+To make your first steps in Google Analytics, refer to `Google Documentation. <https://support.google.com/analytics/answer/1008015?hl=en/>`__
 
-    .. image:: media/GC_on_api.png
-        :align: center
+.. seealso::
 
--   In the menu on left side, select the sub menu **"Credentials"** (from menu APIs and
-    auth) and click on button **"Create New Client ID"**
-
-    .. image:: media/GC_credentials.png
-        :align: center
-
-    .. image:: media/GC_create_new_client_id.png
-        :align: center
-
--   Fill in the Name of application and check that the platform is well on **"Web Application"**.
-    You should now configure the allowed pages on which you will be redirected. To do
-    it, you need to complete the field **"Redirect RI"** and set as value (your own domain
-    followed by ``/google_account/authentication``) : You can now click on **"Create Client ID"**
-
-    .. image:: media/GC_client_id.png
-        :align: center
-
--   Once done, you will have the both informations (**Client ID** and **Client Secret**) that
-    you need to insert in the 2 fields below !
-
-    .. image:: media/GC_copy.png
-        :align: center
-
--   Click on **Apply**
+  * :doc:`google_analytics_dashboard`

website/optimize/google_analytics_dashboard.rst

@@ -0,0 +1,66 @@
+============================================================
+How to track your website's traffic from your Odoo Dashboard
+============================================================
+
+You can follow your traffic's statistics straight from your Odoo Website 
+Dashboard thanks to Google Analytics.
+
+- A preliminary step is creating a Google Analytics account and entering the 
+  tracking ID in your Website's settings (see :doc:`google_analytics`).
+
+- Go to `Google APIs platform <https://console.developers.google.com>`__ 
+  to generate Analytics API credentials. Log in with your Google account. 
+
+- Select Analytics API.
+
+    .. image:: media/google_analytics_api.png
+        :align: center
+
+- Create a new project and give it a name (e.g. Google Analytics in Odoo).
+
+    .. image:: media/google_analytics_create_project.png
+        :align: center
+
+- Enable the API.
+
+    .. image:: media/google_analytics_enable.png
+        :align: center
+
+- Create credentials to use in Odoo. Select *Web browser (Javascript)* 
+  as calling source and *User data* as kind of data.
+
+    .. image:: media/google_analytics_create_credentials.png
+        :align: center
+
+    .. image:: media/google_analytics_get_credentials.png
+        :align: center
+
+- Then enter the name of the application (e.g. Odoo) and the allowed pages on 
+  which you will be redirected. The *Authorized JavaScript origin* is your 
+  Odoo's instance URL. The *Authorized redirect URI* is your Odoo's instance 
+  URL followed by /google_account/authentication.
+
+    .. image:: media/google_analytics_authorization.png
+        :align: center
+
+
+- Go through the Consent Screen step by entering a product name 
+  (e.g. Google Analytics in Odoo). Feel free to check the customizations options 
+  but this is not mandatory. The Consent Screen will only show up when you enter 
+  the Client ID in Odoo for the first time.
+
+- Finally you are provided with your Client ID. Copy and paste it in Odoo.
+
+    .. image:: media/google_analytics_client_id.png
+        :align: center
+
+- Open your Website Dashboard in Odoo and link your Analytics account. 
+  to past your Client ID.
+
+    .. image:: media/google_analytics_start.png
+        :align: center
+
+- As a last step, authorize Odoo to access Google API.
+
+    .. image:: media/google_analytics_login.png
+        :align: center