Skip to main content

Source Info

  • The Google Ads Source is an Object Cloud source. This means that it sends information (traits) about a thing that exists and persists over time, such as a person or company, and which can be updated over time. Data from this source can only be exported directly to a warehouse, but it can then be used for further analysis.
Google Ads is an online advertising service developed by Google. With Google Ads, you can take advantage of online advertising to improve your internet marketing effectiveness.

Google Ads Source API Upgrade

In April 2022, Innkeepr upgraded from using the Google AdWords API to the Google Ads API for the Innkeepr Google Ads source. As a result of this change, Innkeepr no longer supports “Include Zero Impressions.” Queries that contain segments (date, product, country, etc.) will no longer return data for rows that have zero metrics. Because all collections reported to Innkeepr contain date segments in their queries, Include Zero Impressions is no longer supported for any collection in the Google Ads source.
In addition, some properties in the following collections have different functionality:
  • Ad Performance Report
  • Campaign Performance Report
  • Click Performance Report
  • Search Performance Report
  • Keyword Performance Report

​
Getting Started

  1. From your workspace’s page, click Sources and then Browse.
  2. Choose Google Ads.
  3. Click Connect and then Connect to OAuth into Google.
  4. Select which accounts you would like to sync.
  5. Enter your Campaign ID(s).
  6. Click Save.

​
Permissions

When you set up your Google Ads Source, you may notice that all the Google Ads accounts your Google user can view aren’t listed. This is because the Google Ads API doesn’t expose a list of “managed” or sub-accounts to non-administrators using the API. That said, if you have read permissions to the account and would like to add it, please contact Support. For more information about finding your Google Ads Customer ID, see Google’s Find your Google Ads customer ID docs.

​
Sync Components

The Google Ads source contains a sync component. This enables Innkeepr to the Google Ads API on your behalf on a 24 hour interval to pull the latest data into Innkeepr. In the initial sync, Innkeepr retrieves the Google Ads objects (and corresponding properties) according to the Collections Table below.

​
Collections

Which Google Ads accounts can I connect?
Innkeepr supports connections to individual Google Ads accounts only—MCC (Manager) accounts cannot be connected directly. You can connect multiple individual accounts to Innkeepr if needed.

​
Collection Properties

API-Referenz:https://developers.google.com/google-ads/api/fields/v22/click_viewProperties (Auszug):
  • ad_group_ad
  • gclid
  • keyword
  • keyword_info.text
  • keyword_info.match_type
  • resource_name
  • user_list
API-Referenz:https://developers.google.com/google-ads/api/fields/v22/asset_groupProperties (Auszug):
  • id
  • name
  • resource_name
  • status
  • campaign.id
  • campaign.name
  • campaign.resource_name
  • campaign.advertising_channel_type
  • campaign.status
  • customer.id
  • asset_group_signal.asset_group
  • asset_group_signal.audience.audience
  • asset_group_signal.resource_name
API-Referenz:https://developers.google.com/google-ads/api/fields/v22/user_listProperties (Auszug):
  • id
  • description
  • crm_based_user_list.upload_key_type
  • logical_user_list.rules
  • name
  • resource_name
  • type
  • similar_user_list.seed_user_list
  • customer.id
  • customer.descriptive_name
  • size_for_display
  • size_for_search
  • match_rate_percentage
API-Referenz:https://developers.google.com/google-ads/api/fields/v22/custom_interestProperties (Auszug):
  • name
  • resource_name
API-Referenz:https://developers.google.com/google-ads/api/fields/v22/user_interestProperties (Auszug):
  • name
  • resource_name
API-Referenz:https://developers.google.com/google-ads/api/fields/v22/asset_group_signalProperties (Auszug):
  • asset_group
  • audience.audience
  • resource_name
  • asset_group.id
  • asset_group.name
  • asset_group.status
  • asset_group.primary_status
  • asset_group.resource_name
  • campaign.advertising_channel_type
  • campaign.name
  • campaign.status
API-Referenz:https://developers.google.com/google-ads/api/fields/v22/custom_audienceProperties (Auszug):
  • ad_group_ad
  • gclid
  • keyword
  • keyword_info.text
  • keyword_info.match_type
  • resource_name
  • user_list

​
Which Google Ads accounts can I connect?

Innkeepr supports connections to individual Google Ads accounts only—MCC (Manager) accounts cannot be connected directly. You can connect multiple individual accounts to Innkeepr if needed.

​
Ad Groups

Property NameDescription
adwords_customer_idThe 10-digit Google Ads Customer ID.
campaign_idID of the campaign with which this ad group is associated.
nameName of this ad group.
received_atThis timestamp is added to incoming messages as soon as they hit Innkeepr API.
statusStatus of this ad group.