documentation/content/applications/websites/website/optimize/google_analytics_dashboard.rst
Antoine Vandevenne (anv) 250bc3ab21 [MOV] content/*: move resource files into their related page's directory
Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2066
2022-05-20 14:48:37 +02:00

71 lines
2.4 KiB
ReStructuredText

==========================================================
How to track your website traffic from your Odoo Dashboard
==========================================================
You can follow your traffic 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:: google_analytics_dashboard/google_analytics_api.png
:align: center
- Create a new project and give it a name (e.g. Odoo).
This project is needed to store your API credentials.
.. image:: google_analytics_dashboard/google_analytics_create_project.png
:align: center
- Enable the API.
.. image:: google_analytics_dashboard/google_analytics_enable.png
:align: center
- Create credentials to use in Odoo.
.. image:: google_analytics_dashboard/google_analytics_create_credentials.png
:align: center
- Select *Web browser (Javascript)*
as calling source and *User data* as kind of data.
.. image:: google_analytics_dashboard/google_analytics_get_credentials.png
:align: center
- Then you can create a Client ID.
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:: google_analytics_dashboard/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:: google_analytics_dashboard/google_analytics_client_id.png
:align: center
- Open your Website Dashboard in Odoo and link your Analytics account to past
your Client ID.
.. image:: google_analytics_dashboard/google_analytics_start.png
:align: center
- As a last step, authorize Odoo to access Google API.
.. image:: google_analytics_dashboard/google_analytics_login.png
:align: center