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 Ads Developer Key, get a Google OAuth Client config, and then configure Matomo. Here are the steps:

  1. Follow instructions in How to apply for a Google Ads Developer Key to get your Developer key.

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

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

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

  5. 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 apply for a Google Ads Developer Key

If you use Matomo Cloud-hosted solution, you can skip this step and don’t need to apply for the key.

Generally to be able to access any Google Ads accounts’ data and use the plugin, a developer key is required. To apply for a developer key please follow the instructions in the Google Adwords API Signup page. As of May 2020, the instructions from the Google page include:

  • You must have a Google Ads Manager Account to apply for access to the API.
  • Sign up for AdWords API access through your Manager Account. Sign in, then navigate to TOOLS & SETTINGS > SETUP > API Center. The API Center option will appear only for Google Ads Manager Accounts. All fields on the API Access form must be completed, and the Terms and Conditions accepted. Make sure your information is correct and your company’s website URL is functioning.
  • click the Apply for Basic Access link in the API Center, and complete the AdWords API Token Application form.

Reach out to us if you have any questions.

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