The Google Ads data import into Matomo is triggered while archiving, but at least daily.
Google Ads provides the data with a delay of around 3 hours. As long as the data provided by Google is not final, reports will be reimported.
See this article about Google’s data freshness: https://support.google.com/google-ads/answer/2544985
Support for Facebook Ads will be added in later releases, but in order to be able to link older visits to later imported data, the
fbclid parameter will already be processed and stored as visitor detail.
Support for Bing Ads will be added in later releases, but in order to be able to link older visits to later imported data, the
msclkid parameter will already be processed and stored as visitor detail.
In order to receive a developer token for Google Ads, which is able to access any productive Google Ads accounts, it is required to apply for one. You can find a detailed instruction on the Google Ads documentation.
Once your apply was accepted from the Google Ads team, your token will be available through your AdWords API Center — accessible through the Account settings menu for the manager account from which you applied.
Unfortunately it is not possible to receive the exact costs for a single click on a Google Ad, as Goolge does not provide such data. The costs displayed within Matomo is the average cost for a click for the campaign the user came from. If possible, the system tries to refine this campaign costs using additional attributes like Ad Groups, Ad Networks or Device Types.
In order to be able to import data from Google Ads you need access to the account you want to import data from. In addition you need to create a OAuth Client config and s Google Ads Manager account to be able to apply for a Google Ads Developer Key.
If you have shell-access to the server running Matomo you can use these built-in commands:
For Google Ads
./console advertising:import-google --idsite=[idSite]
Normally the imports should be run automatically as Matomo tasks. If you experience some issues or the imports don’t run, you may try to trigger the imports manually to check if they are working at all.
If you get the error
An error occured while validating the account connection: AuthenticationError.CUSTOMER_NOT_FOUND after connecting your Google account in Matomo Paid Advertising Performance, this is probably because either:
- you are using a developer key that has not yet been approved by Google Ads team,
- or because your developer key is only able to access test accounts but the connected account is a production account.
To solve this issue, please apply for a Google Ads Developer Key and try again to connect your Google account.