[IMP] website: update doc about Google Analytics config

2017-02-16 16:36:01 +01:00
parent a3edbe22fa
commit a0be0a9178
25 changed files with 85 additions and 41 deletions
@@ -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