Google Ads

    Jusang SongWritten by Jusang Song,

    Google Ads is an online RTB (Real-Time Bidding) based advertisement platform operated by Google. It allows marketers to display their web and app advertisements on multiple platforms such as search, display, Youtube, and other partnered platforms. 

    Once the below integration is completed, you may view and track the resulting data of Google Ads 'App Promotion' on the Airbridge dashboard. Moreover, you can enhance your campaign optimization after the integration by utilizing Google Ads conversion actions.

    For the WEB campaigns, conversion actions can be easily tracked by appending UTM parameters.


    Integration with Google Ads

    Airbridge supports integration with Google Ads. With the integration, you can view the attribution data of Google Ads campaigns in the Airbridge dashboard.


    Conversion Tracking for Web Campaign

    For Google Ads Web Campaign, you can track your web conversions by appending UTM parameters to the Google Ads Final URL. Airbridge Web SDK will automatically parse the UTM parameters and map them with the Airbridge Campaign Optimization Parameters allowing you to view the attribution results on the Airbridge Dashboard.

    * The tracking template feature previously provided by Airbridge is no longer available for conversion tracking due to the newly introduced parallel tracking method by Google Ads. 


    To track conversions of the web campaign, please follow the below instruction.

    1. Install the Airbridge WEB SDK on the web page that you want to set in the Final URL.

    2. Set the utmParsing: true option when calling the init function on the Airbridge Web SDK. (See Web SDK Guide for more detail)

    3. When setting up Google Ads Web Campaign, ensure to append UTM parameters in the Final URL.

    Below, you can find the mapping table for Airbridge parameters and UTM parameters. 

    * Please note that you must include 'utm_source' parameter into the Final URL, otherwise utmParsing will not properly work even though other UTM parameters are included.  

    Airbridge Parameter

    ‎‎UTM Parameter





    medium, sub_id







    In addition, if you wish to use 'Value Track' feature of Google Ads, you can track by dynamically importing the value of Google Ads and mapping it to the UTM parameters without directly setting UTM parameters for each Final URL.

    However, note that you can easily set up UTM parameters if you use the 'Value Track' feature, but most of the values Google Ads provides are in numerical ID format. This may cause you difficult to analyze attribution data on the Airbridge. Please read on to find out more detail about Value Track.



    Cost Integration 

    Connect your Google ads account to view and measure cost, click, and impression data from Google Ads within the Airbridge dashboard. Currently, only the Owner and In-house marketers can configure the cost integration, and the permitted Agencies can view the data.

    Once successfully connected, the below data is available at the campaign and ad group level.

    • Metric

      • Impressions (Channel)

      • Clicks (Channel)

      • Cost (Channel)

    • Groupby

      • Event Datetime fields

        • Event Date, Event Year, Event Month, Event Week, Event Day of the month, Event Day of the week

      • Campaign Parameters

        • Channel, Campaign,


          Ad Group, Campaign ID, Ad Group ID, Ad Account ID, Country

    The cost data for Google Performance Max is available in the Campaign level only.


    How to Setup

    1. Go to [ Integrated Ad Channels > Google Ads > Cost Integration ] and turn on the toggle. 

    2. Connect your Google account that currently running the Google Ads campaigns, and allow Airbridge to access your Google Ads campaigns.

    3. When prompted, select the Google ads account you'd like to connect. 


    4. After the setup, Airbridge shows the status of cost integration, and the last time Airbridge synced to pull matching cost data.

    When you change settings on the dashboard, the update date and the account information will be displayed respectively. You can also click the arrow icon to quickly jump to the Activity History page filtered by 'Google Ads' to see more details.

    Please be noted that the currently linked ad accounts are not displayed in the accessible ad account list.


    Stopping Google Cost Integration

    • Turning off 'Google Ads Cost Integration' toggle will stop pulling Google ads cost from all linked ad accounts. You may re-activate the toggle without an additional login.

    • The previously linked ad account will remain deactivated until it gets deleted.

    • Once the toggle is turned off, Airbridge stops getting the cost immediately. Stopping the sync does not have any impact on historical data. 


    Deleting the Google account connection

    If you wish to delete the linked account, click [Action > icon > Delete] on the right side of the table. 


    Adding an additional ad accounts

    You can add another Google Ads account for the same app by clicking 'Login with Google' button. The rest of the process is the same as the above.



    Cost Data Update Cycle

    • Data sync is not real-time supported but syncs every 4 hours. This may cause data discrepancies between Google Ads' dashboard and the Airbridge dashboard. 

    • Airbridge pulls the cost data 7 days retroactively including today's date.

    Cost Data Sync Status

    • Waiting: New ad account is added and is now waiting for the cost data to be updated. Cost data updates every 4 hours(12AM, 4AM, 8AM, 12PM, 4PM, and 8PM).

    • Active: The integration is up and running. The last time Airbridge successfully updated cost data is displayed.

    • Error: Cost data can't be updated if one of the following happens.

      • Invalid Credential: Login error. Login info changes such as password change may cause this type of error. To resolve this issue, delete the account and re-register it again.

      • Google Ads API is not responding: In the latest update, Google Ads API is not responding to Airbridge.

    • Warning: In the latest update, the API has not returned any cost data matching Airbridge campaign attribution data in the last seven days.

    • Expired: Cost data will not be updated if one of the following happens.

      • Google Ads Token is expired

      • The user deletes access to the Airbridge dashboard app within Google Ads.

      • The linked ad account is deactivated


    Cost Data in Reports

    To view your Google Ads cost data, add the below metrics in the Actuals report.

    • Touchpoint

      • Impression (Channel)

      • Clicks (Channel)

    • Cost

      • Cost (Channel)

    'Impressions' and 'Clicks' metrics are touchpoint data collected via Airbridge tracking link, and 'Impressions(Channel)' and 'Clicks(Channel)' metrics are touchpoint data directly received from ad-network(Google Ads).



    Please be aware of the below limitations when viewing Google Ads Cost data. 

    • Cost Data Discrepancy

      • Google Ads cost data updates every four hours, and indexing takes a couple of days for the cost and campaign parameters which may cause discrepancies compared with the data on the Google Ads dashboard. 

      • Google ads cost data may be changed over time. In other words, for instance, the cost data of Sep 8, 2021, which you viewed on Sep 9, 2021, may differ from when you viewed it on Sep 10, 2021. Airbridge pulls the most recent data.

    • Changing Campaign Parameters

      • Airbridge highly recommends you NOT to modify 'Campaign', 'Adgroup', and 'Ad'. 

      • It may cause an issue with the conversion data mapping if you change those names after integrating cost data.

    • Currency

      • It is recommended to set the same currency for Google Ads and Airbridge.

      • The Cost (Channel) metric shows the currency you set for Google Ads.

    • Available GroupBy for Cost Data

      • Cost data is available with Campaign and Adgroup groupby only. Please refer to the below examples.

        • Cost(Channel) data is available with Campaign ID

        • Cost(Channel) data is not available with Event Category

    If you'd never saved your ad account name, it will be displayed blank. 

    Optimize the Google Ads Campaign with Conversion Actions

    Importing Airbridge-tracked events to Google Ads' conversion action will enhance your campaign optimization. 


    Setting up 'Bidding' in 'App promotion'

    1. Go to Google Ads Dashboard.

    2. Click on New Campaign and App promotion.

    3. Choose App under campaign type, select your mobile app platform, and click on CONTINUE.  

    4. In the setting page, scroll down to 'Bidding' option and select 'Install volume' and 'Users likely to perform an in-app action'. Then choose an action that is most important to you.


    Or you can select 'In-app actions' and then choose actions that are most important to you.


    5. Click 'Save and Continue' to complete the rest of the set-up and launch your campaign. 


    Was this page helpful?

    Have any questions or suggestions?