Google Search Console integration
Needed permissions: owner or manage
Google Search Console is a free tool from Google that helps you check how your website appears in Google search results. It’s a must-have tool for any website owner since it gives you cues on how to modify your content and site structure.
When integrated with Piwik PRO, data from Google Search Console become a part of your analytic reports and can be combined with other metrics. This way, you can have information about Google search queries and clicked search results in Piwik PRO and understand better how visitors who came through the Google search channel behave on your site.
In this article, we’ll show you how to set up the integration and how the report for Google Search Console looks like. The process is a bit complex, but follow our guidelines and you’ll be all set with the integration.
Before you start
Here are some things to know before you begin setting up the integration:
- To do the integration you need to have an owner account or a user account with manage permissions in Piwik PRO.
- For integration, you will need to access the Google Search Console and Google API Console. If you don’t use these tools, you might need help from your webmaster.
- Data from Google Search Console is not personal data or personally identifiable data. This data is aggregated and can’t be combined with individual visitors tracked by Piwik PRO. You can use this data safely as it complies with applicable data protection laws.
Add a website property to Google Search Console
To start off, you need to add a website property to your Google Search Console. If you don’t have a Google Search Console account yet, you’ll need to create it first and then add a property.
To add a new website property to Google Search Console, follow these steps:
- Log in to Google Search Console.
- Click the drop-down property picker and click + Add property.
- Choose the type of website property to add: domain or URL prefix. To learn more about website property types, read the Google’s article “Add a website property.”
- Verify your website property. For more instruction on this subject, read the Google’s article “Verify your site ownership.”
- Google starts collecting data as soon as you add the property, even before verification. But the data will appear in Google Search Console in a few days.
Enable an API for Google Search Console
Once you have your website property in Google Search Console ready, you can move to the next step — enabling an API. Piwik PRO needs to access an API to connect with Google Search Console and pull out the data.
To enable an API for Google Search Console, follow these steps:
- Log in to Google API Console.
- From the projects list, select a project or create a new one.
- On the left, click Library.
- Use the search field to find the API for Google Search Console and click the API.
- Click Enable.
Set up the oAuth 2.0 client in Google API Console
Okay, we’ll halfway there. Now as you have your API ready, you need to set up the oAuth 2.0 client. The oAuth 2.0 is a protocol that will grant Piwik PRO access to the information from Google Search Console.
To set up the oAuth 2.0 client for Google Search Console API, follow these steps:
- Log in to Google API Console.
- From the projects list, select a project.
- On the left, click Credentials.
- Click + Create credentials, then pick OAuth client ID.
- If this is your first time creating a client ID, Google will ask you to add a product name, support email address, and authorized domain in the OAuth consent screen page. For example, add:
- Product name: Piwik PRO
- Email address: an email address of your support
- Authorized domain: piwik.pro
Connect your website in Piwik PRO with a website property in Google Search Console
Now, as you have the oAuth 2.0 client for Google Search Console API ready, you can continue setting up the integration in Piwik PRO. With just a few more clicks you will be all set with the task.
To make the final stride to connect your website in Piwik PRO with a website property in Google Search Console, follow these steps:
- Go back to Piwik PRO and navigate back to the setup screen for integration with Google Search Console (Menu > Analytics (new) > Settings > Integrations > Google Search Console).
- Click Next.
- Click Add file, upload the JSON file that you downloaded in the step 15, with the oAuth 2.0 client ID, and click Next.
- Follow confirmation screens from Google and click Allow.
- If you have more than one website property in Google Search Console, choose the property that you want to connect with the website in Piwik PRO. Be mindful to choose the right property, otherwise, your data will be inaccurate.
- Click Finish.
Now, you’re done. The integration is all set and Piwik PRO will download the data from Google Search Console from up to the last 16 months. After that, Piwik PRO will update data once a day. Only keep in mind that Google Search Console provides data with a 3-day delay so the data you see in reports are slightly late.
Google Search Console report
With the integration ready, you can start viewing data about Google search queries and clicked search results in the Google Search Console report in Piwik PRO.
To see data for Google Search Console report, follow these steps:
- Log in to Piwik PRO.
- Go to Menu > Analytics (new).
- Navigate to Reports.
- On the left, click Google Search Console.
The Google Search Console report will show you landing pages for your website, keywords that people typed in the Google search and, as a result, reached your website, devices they used to search in Google and countries they came from. In the report, you will see this information combined with the number of sessions, bounce rate, average time on page, and goal conversion rate. Having the data all piled up this way, you can analyze how users of the Google search behave on your site and draw conclusions on how to optimize your site for them. For more information about this report, read our article “Google Search Console report.”