Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In

Integrate Google Ads

This topic describes how to integrate Google Ads with Optimizely Web Experimentation, create Optimizely Audiences based on ad campaigns and ad groups from Google Ads, target experiments based on your Google Ads referral data, and create personalized landing pages for your ads.

Optimizely integrates with Google Ads to connect your customer acquisition funnel to your conversion rate optimization. Use it to create symmetric messaging between your Google Ads creative content and your landing page, test the experience, and optimize for your paid traffic.

This integration lets you define Optimizely Audiences based on your Google Ads referral data and deliver consistent experiences to customers from start to finish.



The Google Ads integration is available with select Optimizely Web Experimentation plans.

Enable Ads in Optimizely Web Experimentation

To enable the integration:

  1. Toggle the Google Ads integration to On.

  2. Click Connect to Google Ads to confirm.

  3. Sign in with the Google account you use to access Ads. Click Allow.

If your Google Ads account does not contain any campaigns, the integration will fail, and the text 'None' will be displayed on a blank webpage. Create at least one campaign in your Google Ads account before enabling the integration.

  1. If you signed in with an Ads Manager Account and manage multiple accounts, select the Ads account you want to leverage in Optimizely from a dropdown menu.

Optimizely Web Experimentation currently supports integrating with a singular Ads Account. Optimizely Integrations are at the Project level, so if you want to use multiple Ads accounts with Optimizely, you can create a new Project and set up the Ads integration with the other accounts.

You turned on the Ads integration in Optimizely. You are ready to finish setting up the integration in Ads.

Add the Optimizely tracking template to Ads

Complete your setup by adding the Optimizely tracking template text snippet to your Ads tracking template. If you plan to use your Ads integration to target multiple experiments or campaigns, add the tracking template text snippet to all your Ads campaigns, ad groups, or ads.

Example: the Optimizely tracking template text snippet:


To add it:

A few things to know:

  • Lower-level tracking templates have priority over higher-level tracking templates. For example, if a tracking template exists for an individual ad creative, it overrides the tracking template of its higher-level ad group.
  • The tracking template text snippet does not affect your Google Ads ads unless you already use the tracking template fields (opti_key, opti_ca, opti_ag, and opti_ad) in your tracking templates. If your tracking template matches the entire referral URL, it may affect your page analytics.
  • If you use tracking templates for redirects (with {lpurl1}, {lpurl2}, and so on) or if you use multiple Google Ads management services, you may encounter conflicts with your existing tracking templates. If this is the case, please ensure that the final URL that directs to your landing page includes the Optimizely tracking template text snippet.



These are instructions for adding the Optimizely tracking template in the Google Ads interface. If you use a third-party service to manage your ad campaigns, insert the text snippet at the end of your tracking templates through that provider.

  1. Log in to Google Ads and select Campaigns

  2. Add the Tracking template column and select Ad Groups. Click Columns and select Modify columns.

  3. Under Attributes, add the Tracking Template column.

    Repeat this step for all Ads and Campaigns.
    For Campaigns, the Tracking Template column is under the Settings tab in Google Ads, not the Campaigns tab. Modifying the tracking template of campaigns or ad groups will not trigger a re-approval process, but modifying the tracking template of ad creatives will.

  4. Identify the lowest level where you already have tracking templates.
    The hierarchy of levels in Ads is:
    Campaigns (highest level)
    Ad Groups
    Ad Creatives (lowest level)
    To figure out whether you have tracking templates implemented on a certain level, select the tab for that level. Then, click the Tracking template column. If the column re-orders to show existing templates, you already have tracking templates on this level.

  5. Open the tab of the lowest level where tracking is implemented. For example, if Ad Groups is the lowest level where you have a tracking template, open the Ads groups tab.

  6. Click the Tracking template column to reorder the rows.
    Select all rows that include a tracking template. Then, click Edit and select Change URL options from the menu.

  7. In the Action dropdown menu, select Append text.

  8. Paste the following tracking template text snippet into the Append text field:

  9. Click Make changes to confirm.

  10. Select rows that do not have a tracking template.

  11. Click Edit, then Change URL options.

  12. Paste the following text snippet into the field next to Set value

  1. Click Make changes.

Create an audience using Ads

After you turn on the integration, you can create audiences in Optimizely that target your Ads campaigns. You can also add Ads conditions to an existing audience.

  1. Go to the Audiences dashboard. Select an existing audience or click Create new audience.
  2. In the Audiences dialog, see a Google Ads drop-down.
  3. Drag and drop Ad Campaigns and Ad Groups to create new audiences in Optimizely.

Removed and disabled campaigns and ad groups will not appear in the dropdown menu.

Test your integration

How do I make sure the integration is working as expected?
Use Optimizely’s Preview Mode as you build an experiment to check that your variation looks the way you expect. Before you launch the experiment to visitors, verify that your tracking template is working by searching the URL for the terms used in the text snippet: opti_key, opti_ca, opti_ag, or opti_ad.

When you are ready to test your audience targeting in a live environment without showing it to visitors, use the test cookie method to verify that your Ads audience conditions let the right visitors in.

When you set the test and tracking template live for all visitors, perform one final check by clicking the ad. It should allow you to be bucketed into the right variation. 

How long will it take before I see the changes go live?
Your changes will go live when all of the following conditions are met:

  • Your targeted Ads campaigns or ad groups are enabled and approved by Google.
  • You have inserted the tracking template text snippet into the required tracking templates.
  • Your Optimizely campaign is live.

Troubleshoot issues

Why do I not see some of my campaigns, ad groups, or keywords listed in the Create new audience window?

Optimizely does not show disabled campaigns (and their corresponding ad groups) or disabled ad groups (and their corresponding keywords).

You can see only paused or enabled ad groups from paused or enabled campaigns, or keywords from eligible ad groups.