diff --git a/content/applications/websites/website/configuration/google_search_console.rst b/content/applications/websites/website/configuration/google_search_console.rst index 2354f3803..b6ca17fbc 100644 --- a/content/applications/websites/website/configuration/google_search_console.rst +++ b/content/applications/websites/website/configuration/google_search_console.rst @@ -7,26 +7,93 @@ monitor, maintain, and troubleshoot their site's presence in Google Search resul valuable insights into how Google views and interacts with your site, helping you optimize its performance. -To enable GSC, go to `Google Search Console `_, -enter your domain or URL prefix, follow the instructions, and copy the code from Google. +To enable Google Search Console for your website, go to `Google Search Console +`_. Then, select the property type +:ref:`GSC-Domain` or :ref:`GSC-URL prefix`. .. image:: google_search_console/add-domain-or-url-prefix.png :alt: Google Search Console domain or URL prefix -.. image:: google_search_console/verify.png - :alt: Verify domain or URL prefix +.. _GSC-Domain: -Then, access your Odoo database, go to :menuselection:`Website --> Configuration --> Settings`, and -enable :guilabel:`Google Search Console` in the :guilabel:`SEO` section. Paste the code in the -dedicated field. +Domain property +=============== -.. image:: google_search_console/paste-gsc-code-settings.png - :alt: Website Settings pasting GSC code +A domain property in Search Console tracks all versions of your website, including subdomains and +protocols (http/https). This comprehensive view allows you to analyze your overall website's search +performance and make informed decisions to optimize its visibility. Enter the domain, e.g., +`example.com` and click :guilabel:`Continue`. -.. important:: - To prevent Google from indexing both your custom domain name `www.example.com` and your original - Odoo database URL `www.example.odoo.com`, :ref:`map your domain name with your Odoo website - `. +.. note:: + - The domain property type can only be verified via + `DNS record `_. + - Google suggests creating at least one domain property to represent your site, as it is the most + complete view of your website information. + +.. _GSC-URL prefix: + +URL prefix property +=================== + +This type of verification is usually simpler as you have multiple verification methods, such as +using your existing Google Analytics or Tag Manager account. It also makes sense to view a section +of your website separately. For example, if you work with a consultant on a specific part of your +website, you might want to verify this part separately to limit access to your data. Enter the URL, +e.g., `https://www.example.odoo.com` and click :guilabel:`Continue`. + + +Site ownership verification +=========================== + +Before using Google Search Console for your website, you must verify your site ownership. This +verification process is a security measure that protects both you and Google. It ensures that only +authorized users have access to sensitive data and that you have control over how your website is +treated in Google Search. + +Five methods are available to do this: + +.. _website/google-search-console: + +#. :ref:`GSC-HTML-file-upload` +#. `DNS record `_ +#. `HTML tag `_ +#. `Google Analytics tracking code `_ +#. `Google Tag Manager container snippet `_ + +.. note:: + The best method for you depends on your comfort level and technical expertise. For beginners, + using a file upload or HTML tag might be easiest. Those options are convenient if you already use + Google Analytics or Tag Manager. You need to access your domain registrar's settings for domain + verification. + +.. _GSC-HTML-file-upload: + +HTML file upload +---------------- + +This method involves uploading an HTML file provided by Google containing the verification code you +have to put in your Odoo's Website Settings. Google verifies ownership by checking for this code. + +#. Once you added your website URL under the URL prefix option and clicked :guilabel:`continue`, + expand the HTML file section where you find a download :icon:`fa-download` button. + + .. image:: google_search_console/html-file-download.png + :alt: HTML file download + +#. Download your HTML verification file and copy the verification code (e.g., `google123abc.html`). + + .. image:: google_search_console/open-copy-html-file.png + :alt: Open and copy html file + +#. In your Odoo database, go to :menuselection:`Website --> Configuration --> Settings`, + and enable :guilabel:`Google Search Console` in the :guilabel:`SEO` section. Paste the + verification code (e.g., `google123abc.html`) in the dedicated field. + + .. image:: google_search_console/paste-html-code-settings.png + :alt: Paste html code in Odoo + +#. In Google Search Console, click :guilabel:`Verify`. If you perform the steps above correctly, + verification should be done immediately. .. seealso:: :doc:`domain_names` diff --git a/content/applications/websites/website/configuration/google_search_console/add-domain-or-url-prefix.png b/content/applications/websites/website/configuration/google_search_console/add-domain-or-url-prefix.png index 49cf2f7e6..42d2891a0 100644 Binary files a/content/applications/websites/website/configuration/google_search_console/add-domain-or-url-prefix.png and b/content/applications/websites/website/configuration/google_search_console/add-domain-or-url-prefix.png differ diff --git a/content/applications/websites/website/configuration/google_search_console/html-file-download.png b/content/applications/websites/website/configuration/google_search_console/html-file-download.png new file mode 100644 index 000000000..d706f453d Binary files /dev/null and b/content/applications/websites/website/configuration/google_search_console/html-file-download.png differ diff --git a/content/applications/websites/website/configuration/google_search_console/open-copy-html-file.png b/content/applications/websites/website/configuration/google_search_console/open-copy-html-file.png new file mode 100644 index 000000000..18ce4f21c Binary files /dev/null and b/content/applications/websites/website/configuration/google_search_console/open-copy-html-file.png differ diff --git a/content/applications/websites/website/configuration/google_search_console/paste-gsc-code-settings.png b/content/applications/websites/website/configuration/google_search_console/paste-gsc-code-settings.png index fa48018e1..cfc13df90 100644 Binary files a/content/applications/websites/website/configuration/google_search_console/paste-gsc-code-settings.png and b/content/applications/websites/website/configuration/google_search_console/paste-gsc-code-settings.png differ diff --git a/content/applications/websites/website/configuration/google_search_console/paste-html-code-settings.png b/content/applications/websites/website/configuration/google_search_console/paste-html-code-settings.png new file mode 100644 index 000000000..b7b53ed23 Binary files /dev/null and b/content/applications/websites/website/configuration/google_search_console/paste-html-code-settings.png differ diff --git a/content/applications/websites/website/configuration/google_search_console/verify.png b/content/applications/websites/website/configuration/google_search_console/verify.png deleted file mode 100644 index 33a90cbf5..000000000 Binary files a/content/applications/websites/website/configuration/google_search_console/verify.png and /dev/null differ