Requirements
Using this requires either PostHog Cloud with the data pipelines add-on, or a self-hosted PostHog instance running a recent version of the Docker image.
You'll also need access to the relevant Google Cloud, Google Ads and Google Ads Manager account.
Installation
Apply for a Google Ads developer token using these steps.
Enable the Google Ads API for your organization in your Google Cloud settings.
In Google Ads, go to Goals settings, enable enhanced conversions, set the method to
Google Ads API, and click Save.
In PostHog, click the Data pipeline tab in the left sidebar.
Click the Destinations tab.
Search for Google Ads Conversions and select the destination.
Connect your Google account at the configuration step.
Add your developer token and customer ID.
- Create a conversion action inside Google Ads
- Under Goals > Conversions > Summary, ou'll need to create a conversion goal
- Click New conversion action
- Select Website
- Enter your domain and scan your website
- Click Add a conversion action manually, fill in the details about the category name, and enable enhanced conversions (if not already)
- Press Done and Save and continue
- Click See the event snippet. It should show something like
gtag('event', 'conversion', {'send_to': 'AW-XXXXXXXXXXX/XXXXXXXXXXXXXXXXXX'}). You want the conversion action ID which is thesend_tovalue before the forward slash likeAW-XXXXXXXXXXX
Back in PostHog, add the conversion action ID to the destination configuration.
Set up your event and property filters to remove unnecessary events. You only want to send events that are conversions. Filter out unrelated events or ones missing data like
gclid.Press Create & enable, test your destination, and then watch your conversions get sent to Google Ads.
Configuration
| Option | Description |
|---|---|
Google Ads accountType: integration Required: True | |
Developer tokenType: string Required: True | This should be a 22-character long alphanumeric string. Check out this page on how to obtain such a token: https://developers.google.com/google-ads/api/docs/get-started/dev-token |
Customer IDType: string Required: True | ID of your Google Ads Account. This should be 10-digits and in XXX-XXX-XXXX format. |
Conversion action IDType: string Required: True | You will find this information in the event snippet for your conversion action, for example send_to: AW-CONVERSION_ID/AW-CONVERSION_LABEL. This should be in the AW-CONVERSION_ID format. |
Google Click ID (gclid)Type: string Required: True | The Google click ID (gclid) associated with this conversion. |
Conversion Date TimeType: string Required: True | The date time at which the conversion occurred. Must be after the click time. The timezone must be specified. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". |
Conversion valueType: string Required: False | The value of the conversion for the advertiser. |
Currency codeType: string Required: False | Currency associated with the conversion value. This is the ISO 4217 3-character currency code. For example: USD, EUR. |
FAQ
Is the source code for this destination available?
PostHog is open-source and so are all the destination on the platform. The source code is available on GitHub.
Who maintains this?
This is maintained by PostHog. If you have issues with it not functioning as intended, please let us know!
What if I have feedback on this destination?
We love feature requests and feedback. Please tell us what you think.
What if my question isn't answered above?
We love answering questions. Ask us anything via our community forum.