Home
Integrations Library
Media Buying Integrations
Google Ads Integration
Google Ads Integration

SERIES:

Google Ads Integration

Complete guide to setting up Google Ads integration with Everflow, including step-by-step configuration, campaign mapping, iOS attribution setup, and troubleshooting common issues like missing GCLID and failed conversions.

Introduction

The Google Ads integration connects your Google Ads campaigns with Everflow.

This integration works in two directions: it captures detailed click data from Google Ads and sends conversion data back to Google for better campaign optimization.

Why This Integration Matters

Without this integration, you're flying blind. Google Ads doesn't know which clicks actually convert in your system. This integration closes that loop by:

  • Capturing Google Click IDs (GCLID), keywords, and campaign data on every click
  • Sending conversion data back to Google Ads so their algorithm can optimize Providing detailed attribution and reporting within Everflow
  • Eliminating manual conversion uploads and guesswork
Key Terms Important terms related to Google Ads integration. ➔ Google Click ID (GCLID): A unique identifier that Google Ads attaches to each click, allowing you to match conversions back to specific clicks, thus ads and keywords.
➔ Direct Linking: Traffic flows directly from ads to your landing page with tracking parameters appended to the URL, with no redirects that third-party media buying tools often dislike.
➔ Conversion Action: Google Ads' term for trackable events like purchases, leads, or signups. [More Details]
➔ Tracking Template: A URL template in Google Ads that automatically appends parameters to your destination URLs. [More Details]

Prerequisites

Before setting up the Google Ads integration, ensure you have:

  • A Google Ads account with appropriate permissions
  • Partners and offers created in Everflow
  • JavaScript SDK implemented (this integration requires direct linking)
  • A tracking template setup in Google Ads (cannot be empty)
Heads Up! This integration is fully dependent on Everflow's JavaScript SDK and requires direct linking to work properly.

Step-By-Step Guide

1 Configure Google Ads Before connecting to Everflow, you need to prepare your Google Ads account: Create Conversion Actions (If Needed) In Google Ads, click on Create on the top left Click Conversion Action Select Conversions offline (no data source required or select add data source later option) Choose a type of event you wish to track Select Edit Settings Configure your conversion action: Value: Set to Use different values for each conversion for dynamic value to pass, such as RPS/CPS, or choose fixed value option if the value of a conversion is static (same at all times). Count: Select Every if you'll be using wbraid/gbraid for iOS attribution instead of gclid Attribution Model: Use default settings Note Everflow won't modify your conversion action settings, so configure these correctly in Google Ads.

Set Up Tracking Templates (Optional)

Enabling Allow Google Ads Tracking Templates feature allows Tracking Template on Account or Campaign level of your Google Ads account to append necessary parameters for Everflow click and conversion tracking, such as oid and affid.

This is crucial - your tracking templates cannot be empty for the tracking template update feature of this integration to work.

If you wish to not use this feature or tracking template is already set, skip to the next step.

If you wish to use this feature and/or tracking template is empty, please see below.

Account Level Template: Go to Account Settings → Admin → Tracking → Tracking Template Add the following so configured parameters can be appended: {lpurl}?utm_medium=everflow The integration will automatically append additional parameters to this template Campaign Level Template (Optional): Go to Campaigns → Select Campaign → Campaign URL Options → Tracking Template Add campaign-specific tracking if needed after {lpurl} Campaign-level templates take priority over account-level templates Heads Up! If you have tracking templates at the ad group, ad, or keyword level, they will override account and campaign templates, ignoring the configuration.
How to Track Google Ads Campaigns with Matomo FAQ - General - Matomo  Analytics Platform
2 Connect Integration Navigate to Integrations → Media Buying → Google Ads Click Connect Integration Sign in with your Google account and authorize the integration Click Allow to grant necessary permissions Only one Google account can be connected per integration. If you need multiple Google accounts, create separate partner configurations.
3 Configuration Steps The configuration process has four main sections: General Settings Name: Enter a descriptive name for your integration Status: Set to Active Manager ID: Select from available Google Ads Manager accounts Customer ID: Choose the specific Google Ads account to integrate The Manager ID helps organize multiple client accounts, while Customer ID is the specific account where your campaigns run. Good To Know Manager ID is like a network user account that can manage multiple client accounts underneath it.

Account Settings

Allow Google Ads Tracking Templates

This setting determines whether Everflow automatically updates your Google Ads tracking templates.

  • Select "Allow": Everflow will automatically append necessary parameters to your tracking templates
  • Select "Deny": You'll need to manually add tracking parameters to your Google Ads templates

Most users should select "Allow" for automatic setup, unless you're an advanced user who prefers manual control.

Even with "Deny" selected, conversion data will still pass - you'll just need to manually add the parameters to your Google Ads ads.

Map Default Tracking Parameters

Configure which parameters to capture from Google Ads:

  • Google Click ID (GCLID): Mandatory for attribution - typically mapped to sub1 or sub2 or gclid parameter.
  • Keyword: Capture the search term that triggered your ad
  • Default Partner: Choose the partner for account-level tracking
  • Default Offer: Select the default offer for account-level tracking

The default partner and offer are used because media buying campaigns typically use direct linking, which requires OID and PID parameters for the click script to run properly.

Heads Up! YouTube ads don't work with auto-tagging. You'll need to manually add OID and PID parameters to your YouTube ad URLs.

Additional Tracking Parameters

For advanced tracking, you can capture additional Google Ads data:

  • Campaign ID: Track which campaign generated the click
  • Ad Group ID: More granular campaign tracking
  • Match Type: How the keyword matched the search query
  • Placement: Where the ad appeared

Always use sub1-sub5 parameters for these additional fields as they appear in Everflow reporting. Custom parameter names only appear in click details.

Good To Know You can use multiple macros in one parameter, like {keyword}_{matchtype}, but avoid double-booking parameters.

iOS Attribution Setup

For iOS traffic where GCLID isn't available, configure alternative identifiers:

  • wbraid: For web-to-app attribution
  • gbraid: For app-to-app attribution

Add these using Additional Tracking Parameters and map them to sub1-sub5 for reporting visibility.

Key Terms Important terms related to Google Ads attribution. ➔ wbraid: Web-to-app attribution identifier used when users click web ads but convert in mobile apps.
➔ gbraid: App-to-app attribution identifier used when both the click and conversion happen within mobile apps.
➔ iOS Attribution: Alternative tracking methods needed when Apple's privacy restrictions block traditional GCLID tracking.

Campaign Settings (Optional)

Use this section when you have multiple campaigns targeting different offers:

Campaign Mapping

Enable Campaign Mapping: Toggle to "Yes" Add Campaign Mappings: Google Ads Campaign: Select the campaign Offers: Choose the corresponding Everflow offer Partners: Select the appropriate partner

Campaign settings override account-level settings, allowing you to track different offers across different campaigns.

Quick Reminder Campaign-level mappings take priority over account-level defaults.
Why You Need Campaign Mapping

Without campaign mapping, all campaigns use the default offer from account settings. If you're running multiple offers, you need campaign mapping to ensure proper attribution.

Example: Campaign A promotes Offer 123, Campaign B promotes Offer 456. Without campaign mapping, both would attribute to your default offer.

Conversions

This section maps Everflow events to Google Ads conversion actions:

Conversion Action Mapping

Click Conversion Mapping Select Conversion Action: Choose from your Google Ads conversion actions Select Offer: Pick the Everflow offer Select Event: Choose which Everflow event triggers this conversion action Apply Traffic Rules (Optional): Add conditions for when to send conversions

You can map multiple Everflow events to different Google Ads conversion actions, but each mapping is independent.

You can map base conversions (not just events) and apply traffic rules like "only send conversions when sale_amount is above $0."

Understanding the Separation

Campaign settings affect clicks (what data you receive), while conversion mappings affect conversions (what data you send back). These are separate because:

  • Campaigns in Google Ads don't directly belong to conversion actions
  • Multiple campaigns can contribute to the same conversion action
  • One campaign might trigger multiple types of conversions

Think of it like this: Campaign settings tell Everflow "this click belongs to this offer," while conversion mappings tell Google "this conversion should be attributed to this conversion action."

Key Terms Definitions for common Google Ads integration terms. ➔ Conversion Action: Google Ads' trackable event (like "Purchase" or "Lead") that corresponds to an Offer + Event combination in Everflow.
➔ Campaign Mapping: Links specific Google Ads campaigns to specific Everflow offers and partners for accurate attribution.
➔ Conversion Mapping: Determines which Everflow events trigger which Google Ads conversion actions.
➔ Attribution: The process of connecting clicks to conversions to measure campaign effectiveness.

Matching Your Setup

For proper attribution, ensure your conversion mappings match your campaign settings. If Campaign A sends traffic to Offer 123, make sure your conversion mapping includes Offer 123 events.

Heads Up! Mismatched offers between campaign settings and conversion mappings will cause attribution issues and failed conversions.
4 Testing and Validation Verify Click Tracking Run a test click from your Google Ads (it will need to come from a live traffic as GCLID will only generate then) Check Everflow click details for GCLID and other parameters Verify the click is attributed to the correct offer and partner Test Conversion Tracking Generate a test conversion in Everflow with the click with GCLID value passed Check the Google Ads Integration Log for successful postback Verify the conversion appears in Google Ads (may take up to 4 hours) Good To Know While Everflow sends conversions in real-time, Google Ads may take up to 4 hours to process and display them.

Integration Logs

Monitor your integration performance:

Go to Integrations -> Media Buying -> Google Ads -> Logs (if integration is done on the partner level, this will only be visible on the Partner UI) Look for "Success" status on conversion postbacks Check for any error messages or failed attempts by filtering the status to All, Error, or Pending.

The logs show conversion ID, transaction ID, Google Click ID, and postback status. If using wbraid/gbraid, you'll see them in parentheses.

Quick Reminder You can use the request ID from error logs to inquire with Google directly about specific issues.

Troubleshooting Common Issues

Conversions Not Appearing in Google Ads

Check these in order:

  1. GCLID Present: Verify GCLID is captured in Everflow click details
  2. Parameter Mapping: Ensure GCLID parameter matches your integration configuration
  3. Conversion Rules: Check if any traffic rules are blocking the conversion
  4. Google Ads Reporting: Conversions may be marked as "Secondary" and hidden in reports
  5. Processing Delay: Google Ads can take up to 4 hours to show conversions
Offer-level postback settings don't affect Google Ads integration postbacks.

GCLID Not Passing to Everflow

Common causes:

  1. Empty Tracking Template: Your Google Ads tracking template cannot be empty
  2. Higher Priority Templates: Ad group, ad, or keyword templates override account/campaign templates
  3. Auto-tagging Disabled: Ensure auto-tagging is enabled in Google Ads
  4. Incorrect Final URL Setup: Verify you're using Everflow's direct linking URL
Heads Up! If your landing page URL ( {lpurl} ) is empty, there's nothing to append parameters to, causing template updates to fail.

Multiple Google Accounts

If you need to connect multiple Google accounts:

  1. Create separate partner configurations for each account
  2. Each configuration can only connect to one Google account
  3. Use different partner IDs to keep traffic separated
Good To Know This is the same limitation across all Everflow integrations - one OAuth connection per integration.

Best Practices

Parameter Recommendations

  • GCLID: Always map to sub1 or sub2 for easy access
  • Keywords: Map to sub3 for keyword-level reporting
  • Campaign Data: Use sub4-sub5 for campaign ID and ad group tracking

Conversion Value Setup

For e-commerce tracking, pass dynamic values:

  • Revenue: Automatically passed when integration is done at network level
  • Payout: Automatically passed when integration is done at partner level
  • Custom Values: Use the "Override Linked Event Value" setting

Conversion Action should be set with "Use different values for each conversion" Value in Google Ads to pass dynamic values.

Good To Know Ensure &amount=AMOUNT is included in your advertiser postback if you want to use dynamic revenue like RPS/CPS.

Reporting and Optimization

Create custom metrics for better insights:

  • True Margin: (Revenue + Event Revenue) - (Payout + Media Buying Cost)
  • ROAS: Revenue / Media Buying Cost
  • Cost Per Acquisition: Media Buying Cost / Conversions

Use Partner Reports filtered by your Google Ads partner to track performance.

Quick Reminder Pass cost information to get true margin calculations and better optimization insights.

Advanced Features

Traffic Rules

Apply conditions to control when conversions are sent to Google Ads:

  • Only send conversions above a certain value
  • Exclude specific email domains
  • Filter by geographic location

Multiple Conversion Actions

You can now map multiple events to different conversion actions in a single integration, eliminating the need for separate integrations per conversion type.

MCC Account Management

For Manager accounts (MCC), ensure you have proper permissions and select the correct customer ID for each sub-account. Please reach out to support@everflow.io if you’d like to connect an MCC Account with Google Ads integration.

The connected Google account must have appropriate permissions to modify tracking templates across all managed accounts.