This feature is currently only available for the Cloud-hosted Matomo solution.

Viewing Advertising reports

Once your import has been configured, you can find your new reports within the Acquisition menu.

For each configured advertising provider you will find a new menu entry. If you have configured import for Google Ads, there will be a new menu entry Google Ads. Here you can find detailed reports for this provider, such as Impressions, Clicks, Cost, Conversions, Revenue, Click-Through-Rate, Average cost per click, and also a break down for each Campaign, Account, Device, Network, Keyword, Search Query, and Click.

Visits Log & Visitor Profile enrichment

Besides showing imported paid advertising data like campaigns, keywords, etc. the imported data will also be used to enrich your tracked visits with additional data where possible. To be able to use this feature, you need to ensure to enable appending the clickid (for example: gclid) to your landing page ads URLs.

Visits Log

Visits Log will show an additional icon if a visit was referred by an advertising campaign, and the tool-tip on hover will display the information.

Visitor Profile

Similarly, in the Visitor Profile you will be able to see the advertising information for each visit that clicked through a paid ads.

How to import data from Google Ads

Requirements

To run the import, your PHP environment will need the following extensions: soap. Usually this can be installed by installing a package called php-soap. You can check your system meets requirements by visiting the “Diagnostics” page in Matomo Administration (after activating the plugin).

Import data from Google Ads

To import Google Ads data in Matomo you will need to get a Google OAuth Client config, and then configure Matomo. Here are the steps:

  1. Follow instructions in How to set up Google OAuth Client config to get your OAuth config.

  2. In Matomo > Administration > Advertising, below Google Ads, click Setup Configuration.

  3. Below Connect Google Account(s), click Start oAuth process.

  4. Now you can configure your websites to import Advertising data for. Below Configure websites click the Add configuration.

Congratulations! You’re all set and your Google Ads campaigns will be imported in the new Matomo Advertising reports.

How to set up Google OAuth Client config

Follow these steps to get your OAuth Client Config and use the Matomo Google Ads Integration:

  1. Sign in to the Google API Console

  2. Click Select a project in the menu.

  3. To create a new project click the “New Project” button in the overaly:

  4. Give your new Project a useful name (for example Matomo Advertising Integration).

  5. After your project has been created, select it manually in the project list and click “open”.

  6. Now you will create the OAuth Client Credentials. Click on Credentials in the left menu. Then click Create credentials and choose the OAuth client ID option:

  7. You will now be advised to create a product name for the OAuth consent screen. Click on the link Configure consent screen. Under User Type, select the option called External:

  8. Enter a product name (for example Matomo Advertising Integration). As authorized domain you need to add the top level domain of your Matomo instance (for example matomo.cloud for a cloud hosted Matomo). You can leave the other fields blank. Click Save.

  9. Now you will create the credentials. Click again on Credentials in the left menu, then click Create Credentials and choose the OAuth client ID option. Under Application type, select the option called Web application.
    Now you need to fill in the following fields:

    • Name: we recommend to set it to your Matomo URL for example: https://example.matomo.cloud
    • Authorized JavaScript origins: set it to your Matomo URL domain for example: https://example.matomo.cloud
      Note: This needs to be a domain. If you have installed Matomo into a subdirectory, you need to enter the domain without the path. (so https://my-website.example in case of https://my-website.example/matomo/)
    • Authorized redirect URIs: needs to be set to your Matomo URL with this special URL/query /index.php?module=PaidAdvertisingPerformance&action=processAuthCode&provider=google added at the end. For example: https://example.matomo.cloud/index.php?module=PaidAdvertisingPerformance&action=processAuthCode&provider=google
      Note: the URLs above are HTTPS: we highly recommend you run your Matomo instance over SSL. If your Matomo doesn’t support https yet, you can replace the URL and use http.

  10. After saving the OAuth client credentials will be created. Please copy the client Id as well as the client key for later usage in Google Ads setup in Matomo. If the details are not directly shown after saving, you can view them by clicking the edit button.

Congratulations! You can now proceed to setting up the Google Ads import in Matomo

Note: this feature “Paid Advertising Performance” is not yet available for Matomo On-Premise due to technical limitations on the Google Ads API.