Skip to main content

Google ads

Prerequisites

Setting up the Google ads connector

Basic Setup

  1. Create a new data source

  2. Select Google Ads

  3. Fill in the Name and Short name

  4. Click on “Sign in with google” from the credentials dropdown and Authenticate your account.

  5. In another window, navigate to Google ads manager https://ads.google.com/ and sign in with your account.

  6. Select the ad account (no) you want to use as source.

    An image from the static

  7. In the top right corner, you will be able to see the ad account number. Copy it without hyphens and use it in customer_id field.

    An image from the static

  8. Enter the start date in the format 2017-01-25 (UTC).

  9. Click on Test connection and add the data source

  10. Add the new data source

info

It might take a couple of minutes to provision a new data source. Once the data source is added you will be able to query it using plain SQL

At this point, you will be able to browse the data structure of the newly added data source. Once the data source is successfully added, and you have verified it in the data browser -- you can use 3rd party tools like DBeaver to connect to the newly created data source. Refer to Using DBeaver

Detailed configuration Information

NoItemRequiredExampleNotes
1Google CredentialsYes
2Customer ID(s)Yes6783948572,5839201945Comma separated list of (client) customer IDs. Each customer ID must be specified as a 10-digit number without dashes. More instruction on how to find this value in our docs. Metrics streams like AdGroupAdReport cannot be requested for a manager account.
3Start DateYes2017-01-25UTC date and time in the format 2017-01-25. Any data before this date will not be replicated.
4Custom GAQL QueriesNo
5Login Customer ID for Managed AccountsNo7349206847If your access to the customer account is through a manager account, this field is required and must be set to the customer ID of the manager account (10-digit number without dashes). More information about this field you can see here
6Conversion WindowNo14A conversion window is the period of time after an ad interaction (such as an ad click or video view) during which a conversion, such as a purchase, is recorded in Google Ads. For more information, see Google's documentation.
7End DateNo2017-01-30UTC date and time in the format 2017-01-25. Any data after this date will not be replicated.

Tables in the Google ads connector

NoTable NameColumnsPrimary KeysRead ModeInc. Sync KeysAPI Info
1ad_groups28ad_group.id, segments.dateFull Refresh, Incrementalsegments.dateAPI Reference
2ad_group_labels4ad_group_label.resource_nameFull RefreshAPI Reference
3keyword_report14Full Refresh, Incrementalsegments.date
4ad_group_ad_report140Full Refresh, Incrementalsegments.dateAPI Reference
5shopping_performance_report59Full Refresh, Incrementalsegments.dateAPI Reference
6geographic_report5Full Refresh, Incrementalsegments.date
7click_view16click_view.gclid, segments.dateFull Refresh, Incrementalsegments.dateAPI Reference
8ad_group_ads135ad_group_ad.ad.id, segments.dateFull Refresh, Incrementalsegments.dateAPI Reference
9display_keyword_performance_report80Full Refresh, Incrementalsegments.date
10campaigns83campaign.id, segments.dateFull Refresh, Incrementalsegments.dateAPI Reference
11campaign_labels4campaign_label.resource_nameFull RefreshAPI Reference
12service_accounts20
13accounts21customer.id, segments.dateFull Refresh, Incrementalsegments.dateAPI Reference
14display_topics_performance_report79Full Refresh, Incrementalsegments.date
15account_performance_report57Full Refresh, Incrementalsegments.dateAPI Reference
16ad_group_ad_labels4ad_group_ad_label.resource_nameFull RefreshAPI Reference
17user_location_report45Full Refresh, Incrementalsegments.dateAPI Reference

Table: ad_groups

NoColumn NameTypeNotes
1ad_group.excluded_parent_asset_field_typesVARCHAR
2ad_group.typeVARCHAR
3ad_group.ad_rotation_modeVARCHAR
4ad_group.effective_target_cpa_microsINTEGER
5ad_group.campaignVARCHAR
6ad_group.optimized_targeting_enabledBOOLEAN
7ad_group.url_custom_parametersVARCHAR
8ad_group.nameVARCHAR
9ad_group.cpm_bid_microsINTEGER
10ad_group.resource_nameVARCHAR
11ad_group.statusVARCHAR
12ad_group.effective_target_roasDOUBLE
13ad_group.targeting_setting.target_restrictionsVARCHAR
14ad_group.target_roasDOUBLE
15ad_group.final_url_suffixVARCHAR
16ad_group.labelsVARCHAR
17ad_group.target_cpm_microsINTEGER
18ad_group.percent_cpc_bid_microsINTEGER
19ad_group.idINTEGERPrimary Key
20ad_group.effective_target_cpa_sourceVARCHAR
21ad_group.tracking_url_templateVARCHAR
22ad_group.cpc_bid_microsINTEGER
23ad_group.effective_target_roas_sourceVARCHAR
24ad_group.target_cpa_microsINTEGER
25ad_group.base_ad_groupVARCHAR
26ad_group.display_custom_bid_dimensionVARCHAR
27ad_group.cpv_bid_microsINTEGER
28segments.dateVARCHARIncremental sync key, Primary Key

Table: ad_group_labels

NoColumn NameTypeNotes
1ad_group_label.resource_nameVARCHARPrimary Key
2label.resource_nameVARCHAR
3ad_group.resource_nameVARCHAR
4label.nameVARCHAR

Table: keyword_report

NoColumn NameTypeNotes
1ad_group_criterion.negativeBOOLEAN
2ad_group_criterion.keyword.textVARCHAR
3ad_group_criterion.keyword.match_typeVARCHAR
4metrics.impressionsINTEGER
5ad_group.idINTEGER
6customer.descriptive_nameVARCHAR
7metrics.clicksINTEGER
8ad_group_criterion.criterion_idINTEGER
9metrics.historical_quality_scoreINTEGER
10ad_group_criterion.typeVARCHAR
11campaign.bidding_strategy_typeVARCHAR
12metrics.ctrDOUBLE
13metrics.cost_microsINTEGER
14segments.dateVARCHARIncremental sync key

Table: ad_group_ad_report

NoColumn NameTypeNotes
1ad_group_ad.ad_groupVARCHAR
2ad_group_ad.ad.responsive_search_ad.descriptionsVARCHAR
3segments.monthVARCHAR
4metrics.value_per_current_model_attributed_conversionDOUBLE
5customer.currency_codeVARCHAR
6metrics.engagementsINTEGER
7ad_group_ad.ad.responsive_display_ad.format_settingVARCHAR
8ad_group_ad.ad.responsive_display_ad.main_colorVARCHAR
9metrics.all_conversionsDOUBLE
10metrics.percent_new_visitorsDOUBLE
11ad_group_ad.ad.app_ad.headlinesVARCHAR
12metrics.gmail_forwardsINTEGER
13ad_group_ad.ad.responsive_display_ad.descriptionsVARCHAR
14ad_group_ad.ad.expanded_dynamic_search_ad.descriptionVARCHAR
15segments.day_of_weekVARCHAR
16ad_group_ad.ad.final_mobile_urlsVARCHAR
17metrics.ctrDOUBLE
18metrics.video_quartile_p25_rateDOUBLE
19ad_group_ad.ad.idINTEGER
20ad_group_ad.ad.legacy_responsive_display_ad.short_headlineVARCHAR
21ad_group_ad.ad.text_ad.headlineVARCHAR
22ad_group_ad.ad.display_urlVARCHAR
23ad_group_ad.ad.responsive_display_ad.promo_textVARCHAR
24metrics.view_through_conversionsINTEGER
25ad_group_ad.ad.responsive_display_ad.square_logo_imagesVARCHAR
26ad_group_ad.ad.system_managed_resource_sourceVARCHAR
27ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_colorBOOLEAN
28ad_group_ad.ad.image_ad.pixel_widthINTEGER
29campaign.statusVARCHAR
30metrics.current_model_attributed_conversions_valueDOUBLE
31metrics.top_impression_percentageDOUBLE
32metrics.active_view_ctrDOUBLE
33ad_group_ad.ad.responsive_search_ad.headlinesVARCHAR
34metrics.cross_device_conversionsDOUBLE
35ad_group.base_ad_groupVARCHAR
36ad_group_ad.ad.responsive_display_ad.marketing_imagesVARCHAR
37metrics.cost_microsINTEGER
38campaign.base_campaignVARCHAR
39ad_group_ad.ad.image_ad.mime_typeVARCHAR
40metrics.interaction_event_typesVARCHAR
41metrics.current_model_attributed_conversionsDOUBLE
42ad_group_ad.ad.legacy_responsive_display_ad.logo_imageVARCHAR
43metrics.average_time_on_siteDOUBLE
44metrics.active_view_impressionsINTEGER
45metrics.video_view_rateDOUBLE
46ad_group_ad.ad.responsive_display_ad.call_to_action_textVARCHAR
47metrics.all_conversions_from_interactions_rateDOUBLE
48ad_group_ad.ad.legacy_responsive_display_ad.format_settingVARCHAR
49ad_group.statusVARCHAR
50metrics.active_view_measurable_impressionsINTEGER
51metrics.cost_per_conversionDOUBLE
52ad_group_ad.ad.image_ad.pixel_heightINTEGER
53ad_group_ad.policy_summary.approval_statusVARCHAR
54metrics.bounce_rateDOUBLE
55ad_group_ad.ad_strengthVARCHAR
56metrics.conversions_valueDOUBLE
57ad_group_ad.ad.responsive_display_ad.logo_imagesVARCHAR
58metrics.average_costDOUBLE
59ad_group_ad.ad.text_ad.description2VARCHAR
60ad_group_ad.ad.text_ad.description1VARCHAR
61ad_group_ad.ad.app_ad.imagesVARCHAR
62ad_group_ad.ad.responsive_display_ad.price_prefixVARCHAR
63ad_group.idINTEGER
64metrics.active_view_viewabilityDOUBLE
65ad_group_ad.statusVARCHAR
66ad_group_ad.ad.responsive_display_ad.long_headlineVARCHAR
67metrics.all_conversions_valueDOUBLE
68ad_group_ad.ad.image_ad.nameVARCHAR
69campaign.nameVARCHAR
70customer.descriptive_nameVARCHAR
71ad_group_ad.ad.expanded_text_ad.descriptionVARCHAR
72customer.idINTEGER
73metrics.value_per_conversionDOUBLE
74ad_group_ad.ad.responsive_display_ad.business_nameVARCHAR
75metrics.active_view_measurable_cost_microsINTEGER
76ad_group_ad.ad.legacy_responsive_display_ad.price_prefixVARCHAR
77segments.dateVARCHARIncremental sync key
78ad_group_ad.ad.expanded_text_ad.description2VARCHAR
79metrics.conversionsDOUBLE
80ad_group_ad.ad.expanded_text_ad.headline_part2VARCHAR
81ad_group_ad.ad.device_preferenceVARCHAR
82ad_group_ad.ad.expanded_text_ad.headline_part1VARCHAR
83segments.yearINTEGER
84customer.time_zoneVARCHAR
85campaign.idINTEGER
86metrics.engagement_rateDOUBLE
87ad_group_ad.ad.expanded_text_ad.headline_part3VARCHAR
88ad_group_ad.ad.responsive_display_ad.square_marketing_imagesVARCHAR
89ad_group.nameVARCHAR
90ad_group_ad.ad.legacy_responsive_display_ad.square_logo_imageVARCHAR
91ad_group_ad.ad.tracking_url_templateVARCHAR
92segments.quarterVARCHAR
93metrics.cost_per_current_model_attributed_conversionDOUBLE
94ad_group_ad.ad.legacy_responsive_display_ad.long_headlineVARCHAR
95ad_group_ad.ad.responsive_display_ad.youtube_videosVARCHAR
96ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_textVARCHAR
97ad_group_ad.ad.final_urlsVARCHAR
98ad_group_ad.ad.responsive_display_ad.allow_flexible_colorBOOLEAN
99ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_imageVARCHAR
100metrics.average_page_viewsDOUBLE
101metrics.video_quartile_p50_rateDOUBLE
102ad_group_ad.ad.responsive_search_ad.path1VARCHAR
103metrics.interaction_rateDOUBLE
104metrics.impressionsINTEGER
105ad_group_ad.ad.responsive_search_ad.path2VARCHAR
106ad_group_ad.ad.app_ad.mandatory_ad_textVARCHAR
107ad_group_ad.ad.legacy_responsive_display_ad.business_nameVARCHAR
108metrics.video_viewsINTEGER
109metrics.gmail_secondary_clicksINTEGER
110metrics.active_view_cpmDOUBLE
111ad_group_ad.ad.responsive_display_ad.headlinesVARCHAR
112ad_group_ad.ad.image_ad.image_urlVARCHAR
113metrics.conversions_from_interactions_rateDOUBLE
114ad_group_ad.ad.added_by_google_adsBOOLEAN
115ad_group_ad.ad.expanded_text_ad.path1VARCHAR
116ad_group_ad.ad.expanded_text_ad.path2VARCHAR
117metrics.interactionsINTEGER
118metrics.average_cpmDOUBLE
119ad_group_ad.ad.legacy_responsive_display_ad.main_colorVARCHAR
120ad_group_ad.ad.responsive_display_ad.accent_colorVARCHAR
121ad_group_ad.ad.url_custom_parametersVARCHAR
122ad_group_ad.ad.app_ad.descriptionsVARCHAR
123metrics.average_cpvDOUBLE
124segments.weekVARCHAR
125ad_group_ad.ad.legacy_responsive_display_ad.accent_colorVARCHAR
126metrics.clicksINTEGER
127ad_group_ad.ad.legacy_responsive_display_ad.marketing_imageVARCHAR
128metrics.active_view_measurabilityDOUBLE
129metrics.average_cpcDOUBLE
130metrics.average_cpeDOUBLE
131ad_group_ad.ad.app_ad.html5_media_bundlesVARCHAR
132ad_group_ad.ad.app_ad.youtube_videosVARCHAR
133metrics.video_quartile_p75_rateDOUBLE
134ad_group_ad.ad.legacy_responsive_display_ad.promo_textVARCHAR
135segments.ad_network_typeVARCHAR
136metrics.value_per_all_conversionsDOUBLE
137metrics.video_quartile_p100_rateDOUBLE
138metrics.gmail_savesINTEGER
139ad_group_ad.ad.typeVARCHAR
140metrics.cost_per_all_conversionsDOUBLE

Table: shopping_performance_report

NoColumn NameTypeNotes
1metrics.conversionsDOUBLE
2segments.monthVARCHAR
3segments.yearINTEGER
4segments.product_channelVARCHAR
5campaign.idINTEGER
6segments.product_bidding_category_level1VARCHAR
7metrics.all_conversionsDOUBLE
8segments.product_bidding_category_level2VARCHAR
9segments.product_bidding_category_level3VARCHAR
10segments.product_bidding_category_level4VARCHAR
11segments.product_bidding_category_level5VARCHAR
12ad_group.nameVARCHAR
13segments.product_countryVARCHAR
14segments.day_of_weekVARCHAR
15segments.quarterVARCHAR
16metrics.ctrDOUBLE
17metrics.impressionsINTEGER
18segments.product_type_l5VARCHAR
19segments.product_type_l2VARCHAR
20segments.product_type_l1VARCHAR
21segments.product_type_l4VARCHAR
22campaign.statusVARCHAR
23segments.product_type_l3VARCHAR
24segments.product_brandVARCHAR
25metrics.cross_device_conversionsDOUBLE
26segments.product_merchant_idINTEGER
27metrics.conversions_from_interactions_rateDOUBLE
28metrics.cost_microsINTEGER
29segments.click_typeVARCHAR
30segments.deviceVARCHAR
31segments.weekVARCHAR
32segments.product_item_idVARCHAR
33metrics.clicksINTEGER
34metrics.all_conversions_from_interactions_rateDOUBLE
35segments.product_channel_exclusivityVARCHAR
36segments.product_custom_attribute4VARCHAR
37segments.product_conditionVARCHAR
38ad_group.statusVARCHAR
39segments.product_custom_attribute1VARCHAR
40segments.product_custom_attribute0VARCHAR
41metrics.cost_per_conversionDOUBLE
42segments.product_custom_attribute3VARCHAR
43segments.product_custom_attribute2VARCHAR
44metrics.average_cpcDOUBLE
45metrics.conversions_valueDOUBLE
46segments.ad_network_typeVARCHAR
47ad_group.idINTEGER
48segments.product_languageVARCHAR
49metrics.value_per_all_conversionsDOUBLE
50metrics.all_conversions_valueDOUBLE
51segments.product_titleVARCHAR
52campaign.nameVARCHAR
53customer.descriptive_nameVARCHAR
54customer.idINTEGER
55segments.product_aggregator_idINTEGER
56segments.product_store_idVARCHAR
57metrics.value_per_conversionDOUBLE
58metrics.cost_per_all_conversionsDOUBLE
59segments.dateVARCHARIncremental sync key

Table: geographic_report

NoColumn NameTypeNotes
1customer.descriptive_nameVARCHAR
2geographic_view.country_criterion_idINTEGER
3geographic_view.location_typeVARCHAR
4ad_group.idINTEGER
5segments.dateVARCHARIncremental sync key

Table: click_view

NoColumn NameTypeNotes
1campaign.network_settings.target_search_networkBOOLEAN
2click_view.gclidVARCHARPrimary Key
3click_view.keyword_info.textVARCHAR
4segments.ad_network_typeVARCHAR
5campaign.network_settings.target_google_searchBOOLEAN
6campaign.idINTEGER
7click_view.ad_group_adVARCHAR
8ad_group.idINTEGER
9click_view.keywordVARCHAR
10click_view.keyword_info.match_typeVARCHAR
11campaign.nameVARCHAR
12campaign.network_settings.target_content_networkBOOLEAN
13ad_group.nameVARCHAR
14customer.idINTEGER
15campaign.network_settings.target_partner_search_networkBOOLEAN
16segments.dateVARCHARIncremental sync key, Primary Key

Table: ad_group_ads

NoColumn NameTypeNotes
1ad_group_ad.ad_groupVARCHAR
2ad_group_ad.ad.responsive_search_ad.descriptionsVARCHAR
3ad_group_ad.ad.video_responsive_ad.descriptionsVARCHAR
4ad_group_ad.ad.local_ad.headlinesVARCHAR
5ad_group_ad.ad.responsive_display_ad.format_settingVARCHAR
6ad_group_ad.ad.responsive_display_ad.main_colorVARCHAR
7ad_group_ad.ad.app_ad.headlinesVARCHAR
8ad_group_ad.ad.responsive_display_ad.descriptionsVARCHAR
9ad_group_ad.ad.expanded_dynamic_search_ad.descriptionVARCHAR
10ad_group_ad.ad.shopping_product_adVARCHAR
11ad_group_ad.ad.final_mobile_urlsVARCHAR
12ad_group_ad.ad.local_ad.call_to_actionsVARCHAR
13ad_group_ad.ad.video_responsive_ad.call_to_actionsVARCHAR
14ad_group_ad.ad.call_ad.phone_numberVARCHAR
15ad_group_ad.ad.idINTEGERPrimary Key
16ad_group_ad.ad.legacy_responsive_display_ad.short_headlineVARCHAR
17ad_group_ad.ad.text_ad.headlineVARCHAR
18ad_group_ad.ad.display_urlVARCHAR
19ad_group_ad.ad.responsive_display_ad.promo_textVARCHAR
20ad_group_ad.ad.responsive_display_ad.square_logo_imagesVARCHAR
21ad_group_ad.ad.system_managed_resource_sourceVARCHAR
22ad_group_ad.ad.smart_campaign_ad.headlinesVARCHAR
23ad_group_ad.ad.image_ad.pixel_widthINTEGER
24ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_colorBOOLEAN
25ad_group_ad.ad.nameVARCHAR
26ad_group_ad.ad.responsive_search_ad.headlinesVARCHAR
27ad_group_ad.ad.url_collectionsVARCHAR
28ad_group_ad.ad.responsive_display_ad.marketing_imagesVARCHAR
29ad_group_ad.ad.call_ad.call_trackedBOOLEAN
30ad_group_ad.ad.expanded_dynamic_search_ad.description2VARCHAR
31ad_group_ad.ad.image_ad.preview_pixel_heightINTEGER
32ad_group_ad.ad.image_ad.mime_typeVARCHAR
33ad_group_ad.ad.call_ad.business_nameVARCHAR
34ad_group_ad.ad.legacy_responsive_display_ad.logo_imageVARCHAR
35ad_group_ad.ad.app_engagement_ad.videosVARCHAR
36ad_group_ad.ad.video_ad.in_stream.action_button_labelVARCHAR
37ad_group_ad.ad.local_ad.path1VARCHAR
38ad_group_ad.ad.local_ad.path2VARCHAR
39ad_group_ad.ad.responsive_display_ad.call_to_action_textVARCHAR
40ad_group_ad.ad.legacy_responsive_display_ad.format_settingVARCHAR
41ad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancementsBOOLEAN
42ad_group_ad.ad.image_ad.pixel_heightINTEGER
43ad_group_ad.policy_summary.approval_statusVARCHAR
44ad_group_ad.ad_strengthVARCHAR
45ad_group_ad.ad.legacy_app_install_adVARCHAR
46ad_group_ad.ad.responsive_display_ad.logo_imagesVARCHAR
47ad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_videoBOOLEAN
48ad_group_ad.ad.text_ad.description2VARCHAR
49ad_group_ad.ad.app_ad.imagesVARCHAR
50ad_group_ad.ad.app_engagement_ad.imagesVARCHAR
51ad_group_ad.ad.text_ad.description1VARCHAR
52ad_group_ad.ad.responsive_display_ad.price_prefixVARCHAR
53ad_group_ad.ad.smart_campaign_ad.descriptionsVARCHAR
54ad_group_ad.statusVARCHAR
55ad_group_ad.ad.responsive_display_ad.long_headlineVARCHAR
56ad_group_ad.ad.image_ad.nameVARCHAR
57ad_group_ad.ad.expanded_text_ad.descriptionVARCHAR
58ad_group_ad.ad.image_ad.preview_image_urlVARCHAR
59ad_group_ad.ad.responsive_display_ad.business_nameVARCHAR
60ad_group_ad.ad.legacy_responsive_display_ad.price_prefixVARCHAR
61ad_group_ad.labelsVARCHAR
62ad_group_ad.ad.expanded_text_ad.description2VARCHAR
63segments.dateVARCHARIncremental sync key, Primary Key
64ad_group_ad.ad.video_ad.in_feed.headlineVARCHAR
65ad_group_ad.ad.call_ad.disable_call_conversionBOOLEAN
66ad_group_ad.ad.expanded_text_ad.headline_part2VARCHAR
67ad_group_ad.policy_summary.review_statusVARCHAR
68ad_group_ad.ad.device_preferenceVARCHAR
69ad_group_ad.ad.expanded_text_ad.headline_part1VARCHAR
70ad_group_ad.ad.shopping_comparison_listing_ad.headlineVARCHAR
71ad_group_ad.ad.expanded_text_ad.headline_part3VARCHAR
72ad_group_ad.ad.call_ad.phone_number_verification_urlVARCHAR
73ad_group_ad.ad.local_ad.videosVARCHAR
74ad_group_ad.ad.responsive_display_ad.square_marketing_imagesVARCHAR
75ad_group_ad.ad.call_ad.headline1VARCHAR
76ad_group_ad.ad.legacy_responsive_display_ad.square_logo_imageVARCHAR
77ad_group_ad.ad.tracking_url_templateVARCHAR
78ad_group_ad.ad.call_ad.conversion_reporting_stateVARCHAR
79ad_group_ad.ad.legacy_responsive_display_ad.long_headlineVARCHAR
80ad_group_ad.ad.call_ad.headline2VARCHAR
81ad_group_ad.ad.responsive_display_ad.youtube_videosVARCHAR
82ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_textVARCHAR
83ad_group_ad.ad.video_responsive_ad.headlinesVARCHAR
84ad_group_ad.ad.final_urlsVARCHAR
85ad_group_ad.ad.responsive_display_ad.allow_flexible_colorBOOLEAN
86ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_imageVARCHAR
87ad_group_ad.ad.app_engagement_ad.headlinesVARCHAR
88ad_group_ad.ad.resource_nameVARCHAR
89ad_group_ad.ad.responsive_search_ad.path1VARCHAR
90ad_group_ad.policy_summary.policy_topic_entriesVARCHAR
91ad_group_ad.ad.final_url_suffixVARCHAR
92ad_group_ad.ad.responsive_search_ad.path2VARCHAR
93ad_group_ad.ad.legacy_responsive_display_ad.descriptionVARCHAR
94ad_group_ad.ad.app_ad.mandatory_ad_textVARCHAR
95ad_group_ad.ad.legacy_responsive_display_ad.business_nameVARCHAR
96ad_group_ad.ad.video_responsive_ad.long_headlinesVARCHAR
97ad_group_ad.resource_nameVARCHAR
98ad_group_ad.ad.hotel_adVARCHAR
99ad_group_ad.ad.responsive_display_ad.headlinesVARCHAR
100ad_group_ad.ad.image_ad.image_urlVARCHAR
101ad_group_ad.ad.video_responsive_ad.videosVARCHAR
102ad_group_ad.ad.added_by_google_adsBOOLEAN
103ad_group_ad.ad.expanded_text_ad.path1VARCHAR
104ad_group_ad.ad.expanded_text_ad.path2VARCHAR
105ad_group_ad.ad.legacy_responsive_display_ad.main_colorVARCHAR
106ad_group_ad.ad.responsive_display_ad.accent_colorVARCHAR
107ad_group_ad.ad.url_custom_parametersVARCHAR
108ad_group_ad.ad.app_ad.descriptionsVARCHAR
109ad_group_ad.ad.legacy_responsive_display_ad.accent_colorVARCHAR
110ad_group_ad.ad.legacy_responsive_display_ad.marketing_imageVARCHAR
111ad_group_ad.ad.video_ad.in_feed.description2VARCHAR
112ad_group_ad.ad.call_ad.country_codeVARCHAR
113ad_group_ad.ad.video_ad.in_feed.description1VARCHAR
114ad_group_ad.ad.display_upload_ad.display_upload_product_typeVARCHAR
115ad_group_ad.ad.local_ad.descriptionsVARCHAR
116ad_group_ad.ad.call_ad.conversion_actionVARCHAR
117ad_group_ad.ad.app_engagement_ad.descriptionsVARCHAR
118ad_group_ad.ad.call_ad.description2VARCHAR
119ad_group_ad.ad.app_ad.html5_media_bundlesVARCHAR
120ad_group_ad.ad.call_ad.description1VARCHAR
121ad_group_ad.ad.final_app_urlsVARCHAR
122ad_group_ad.ad.app_ad.youtube_videosVARCHAR
123ad_group_ad.ad.image_ad.preview_pixel_widthINTEGER
124ad_group_ad.ad.legacy_responsive_display_ad.promo_textVARCHAR
125ad_group_ad.ad.video_ad.out_stream.headlineVARCHAR
126ad_group_ad.ad.display_upload_ad.media_bundleVARCHAR
127ad_group_ad.ad.video_responsive_ad.companion_bannersVARCHAR
128ad_group_ad.ad.local_ad.marketing_imagesVARCHAR
129ad_group_ad.ad.call_ad.path1VARCHAR
130ad_group_ad.ad.call_ad.path2VARCHAR
131ad_group_ad.ad.typeVARCHAR
132ad_group_ad.ad.video_ad.out_stream.descriptionVARCHAR
133ad_group_ad.ad.shopping_smart_adVARCHAR
134ad_group_ad.ad.video_ad.in_stream.action_headlineVARCHAR
135ad_group_ad.ad.local_ad.logo_imagesVARCHAR

Table: display_keyword_performance_report

NoColumn NameTypeNotes
1metrics.conversionsDOUBLE
2segments.monthVARCHAR
3ad_group_criterion.statusVARCHAR
4customer.currency_codeVARCHAR
5segments.yearINTEGER
6customer.time_zoneVARCHAR
7metrics.engagementsINTEGER
8campaign.idINTEGER
9metrics.engagement_rateDOUBLE
10ad_group_criterion.final_urlsVARCHAR
11metrics.all_conversionsDOUBLE
12metrics.gmail_forwardsINTEGER
13ad_group.nameVARCHAR
14campaign.bidding_strategyVARCHAR
15ad_group_criterion.effective_cpv_bid_sourceVARCHAR
16segments.day_of_weekVARCHAR
17segments.quarterVARCHAR
18ad_group.targeting_setting.target_restrictionsVARCHAR
19campaign.bidding_strategy_typeVARCHAR
20metrics.ctrDOUBLE
21ad_group_criterion.tracking_url_templateVARCHAR
22ad_group_criterion.effective_cpc_bid_microsINTEGER
23ad_group_criterion.negativeBOOLEAN
24metrics.video_quartile_p25_rateDOUBLE
25metrics.video_quartile_p50_rateDOUBLE
26metrics.interaction_rateDOUBLE
27metrics.impressionsINTEGER
28metrics.view_through_conversionsINTEGER
29metrics.video_viewsINTEGER
30campaign.statusVARCHAR
31metrics.gmail_secondary_clicksINTEGER
32metrics.active_view_cpmDOUBLE
33metrics.active_view_ctrDOUBLE
34metrics.cross_device_conversionsDOUBLE
35ad_group.base_ad_groupVARCHAR
36metrics.conversions_from_interactions_rateDOUBLE
37metrics.cost_microsINTEGER
38campaign.base_campaignVARCHAR
39ad_group_criterion.effective_cpv_bid_microsINTEGER
40metrics.interactionsINTEGER
41metrics.average_cpmDOUBLE
42ad_group_criterion.keyword.textVARCHAR
43metrics.interaction_event_typesVARCHAR
44ad_group_criterion.keyword.match_typeVARCHAR
45metrics.average_cpvDOUBLE
46segments.deviceVARCHAR
47ad_group_criterion.final_mobile_urlsVARCHAR
48segments.weekVARCHAR
49metrics.active_view_impressionsINTEGER
50metrics.video_view_rateDOUBLE
51metrics.clicksINTEGER
52ad_group_criterion.effective_cpc_bid_sourceVARCHAR
53ad_group_criterion.criterion_idINTEGER
54metrics.all_conversions_from_interactions_rateDOUBLE
55ad_group.statusVARCHAR
56metrics.active_view_measurable_impressionsINTEGER
57ad_group_criterion.url_custom_parametersVARCHAR
58metrics.cost_per_conversionDOUBLE
59metrics.active_view_measurabilityDOUBLE
60metrics.average_cpcDOUBLE
61metrics.average_cpeDOUBLE
62metrics.conversions_valueDOUBLE
63metrics.average_costDOUBLE
64metrics.video_quartile_p75_rateDOUBLE
65segments.ad_network_typeVARCHAR
66metrics.active_view_viewabilityDOUBLE
67ad_group.idINTEGER
68metrics.value_per_all_conversionsDOUBLE
69metrics.video_quartile_p100_rateDOUBLE
70metrics.gmail_savesINTEGER
71metrics.all_conversions_valueDOUBLE
72campaign.nameVARCHAR
73customer.descriptive_nameVARCHAR
74customer.idINTEGER
75metrics.value_per_conversionDOUBLE
76ad_group_criterion.effective_cpm_bid_sourceVARCHAR
77metrics.active_view_measurable_cost_microsINTEGER
78ad_group_criterion.effective_cpm_bid_microsINTEGER
79metrics.cost_per_all_conversionsDOUBLE
80segments.dateVARCHARIncremental sync key

Table: campaigns

NoColumn NameTypeNotes
1metrics.conversionsDOUBLE
2campaign.target_roas.cpc_bid_floor_microsINTEGER
3campaign.commission.commission_rate_microsINTEGER
4campaign.target_impression_share.cpc_bid_ceiling_microsINTEGER
5campaign.vanity_pharma.vanity_pharma_display_url_modeVARCHAR
6campaign.idINTEGERPrimary Key
7campaign.target_cpm.target_frequency_goal.time_unitVARCHAR
8campaign.ad_serving_optimization_statusVARCHAR
9campaign.geo_target_type_setting.positive_geo_target_typeVARCHAR
10campaign.target_cpa.target_cpa_microsINTEGER
11campaign.bidding_strategyVARCHAR
12campaign.percent_cpc.cpc_bid_ceiling_microsINTEGER
13campaign.percent_cpc.enhanced_cpc_enabledBOOLEAN
14campaign.excluded_parent_asset_field_typesVARCHAR
15campaign.final_url_suffixVARCHAR
16campaign.optimization_goal_setting.optimization_goal_typesVARCHAR
17campaign.app_campaign_setting.app_storeVARCHAR
18campaign.bidding_strategy_typeVARCHAR
19campaign.frequency_capsVARCHAR
20campaign.shopping_setting.campaign_priorityINTEGER
21campaign.target_impression_share.location_fraction_microsINTEGER
22metrics.ctrDOUBLE
23campaign.advertising_channel_sub_typeVARCHAR
24campaign.manual_cpmVARCHAR
25campaign.network_settings.target_search_networkBOOLEAN
26campaign.targeting_setting.target_restrictionsVARCHAR
27campaign.target_impression_share.locationVARCHAR
28campaign.network_settings.target_google_searchBOOLEAN
29campaign.optimization_scoreDOUBLE
30metrics.impressionsDOUBLE
31campaign.end_dateVARCHAR
32campaign.target_cpa.cpc_bid_ceiling_microsINTEGER
33campaign.manual_cpvVARCHAR
34metrics.video_viewsDOUBLE
35campaign.statusVARCHAR
36campaign.accessible_bidding_strategyVARCHAR
37campaign.dynamic_search_ads_setting.feedsVARCHAR
38segments.hourDOUBLE
39campaign.labelsVARCHAR
40campaign.target_spend.target_spend_microsINTEGER
41campaign.app_campaign_setting.bidding_strategy_goal_typeVARCHAR
42campaign.target_spend.cpc_bid_ceiling_microsINTEGER
43campaign.shopping_setting.sales_countryVARCHAR
44metrics.cost_microsINTEGER
45campaign.target_roas.cpc_bid_ceiling_microsINTEGER
46campaign.base_campaignVARCHAR
47campaign.vanity_pharma.vanity_pharma_textVARCHAR
48campaign.advertising_channel_typeVARCHAR
49campaign.maximize_conversions.target_cpa_microsINTEGER
50campaign.target_roas.target_roasDOUBLE
51campaign.start_dateVARCHAR
52campaign.geo_target_type_setting.negative_geo_target_typeVARCHAR
53campaign.dynamic_search_ads_setting.use_supplied_urls_onlyBOOLEAN
54campaign.tracking_setting.tracking_urlVARCHAR
55campaign.experiment_typeVARCHAR
56metrics.clicksINTEGER
57campaign.real_time_bidding_setting.opt_inBOOLEAN
58campaign.payment_modeVARCHAR
59campaign.maximize_conversion_value.target_roasDOUBLE
60campaign.dynamic_search_ads_setting.domain_nameVARCHAR
61campaign.manual_cpc.enhanced_cpc_enabledBOOLEAN
62metrics.conversions_valueDOUBLE
63campaign.dynamic_search_ads_setting.language_codeVARCHAR
64campaign.shopping_setting.enable_localBOOLEAN
65campaign.video_brand_safety_suitabilityVARCHAR
66campaign.selective_optimization.conversion_actionsVARCHAR
67campaign.campaign_budgetVARCHAR
68campaign.tracking_url_templateVARCHAR
69metrics.video_quartile_p100_rateDOUBLE
70campaign.target_cpa.cpc_bid_floor_microsINTEGER
71campaign.nameVARCHAR
72campaign.network_settings.target_content_networkBOOLEAN
73campaign.serving_statusVARCHAR
74campaign.target_cpm.target_frequency_goal.target_countINTEGER
75campaign.app_campaign_setting.app_idVARCHAR
76campaign_budget.amount_microsINTEGER
77campaign.network_settings.target_partner_search_networkBOOLEAN
78campaign.local_campaign_setting.location_source_typeVARCHAR
79campaign.resource_nameVARCHAR
80campaign.shopping_setting.merchant_idINTEGER
81campaign.hotel_setting.hotel_center_idINTEGER
82campaign.url_custom_parametersVARCHAR
83segments.dateVARCHARIncremental sync key, Primary Key

Table: campaign_labels

NoColumn NameTypeNotes
1campaign_label.resource_nameVARCHARPrimary Key
2label.resource_nameVARCHAR
3campaign.resource_nameVARCHAR
4label.nameVARCHAR

Table: service_accounts

NoColumn NameTypeNotes
1customer.call_reporting_setting.call_conversion_actionVARCHAR
2customer.tracking_url_templateVARCHAR
3customer.currency_codeVARCHAR
4customer.call_reporting_setting.call_reporting_enabledBOOLEAN
5customer.conversion_tracking_setting.cross_account_conversion_tracking_idINTEGER
6customer.time_zoneVARCHAR
7customer.optimization_scoreDOUBLE
8customer.final_url_suffixVARCHAR
9customer.pay_per_conversion_eligibility_failure_reasonsVARCHAR
10customer.auto_tagging_enabledBOOLEAN
11customer.test_accountBOOLEAN
12customer.descriptive_nameVARCHAR
13customer.remarketing_setting.google_global_site_tagVARCHAR
14customer.idINTEGER
15customer.managerBOOLEAN
16customer.resource_nameVARCHAR
17customer.call_reporting_setting.call_conversion_reporting_enabledBOOLEAN
18customer.optimization_score_weightDOUBLE
19customer.conversion_tracking_setting.conversion_tracking_idINTEGER
20customer.has_partners_badgeBOOLEAN

Table: accounts

NoColumn NameTypeNotes
1customer.call_reporting_setting.call_conversion_actionVARCHAR
2customer.tracking_url_templateVARCHAR
3customer.currency_codeVARCHAR
4customer.call_reporting_setting.call_reporting_enabledBOOLEAN
5customer.conversion_tracking_setting.cross_account_conversion_tracking_idINTEGER
6customer.time_zoneVARCHAR
7customer.optimization_scoreDOUBLE
8customer.final_url_suffixVARCHAR
9customer.pay_per_conversion_eligibility_failure_reasonsVARCHAR
10customer.auto_tagging_enabledBOOLEAN
11customer.test_accountBOOLEAN
12customer.descriptive_nameVARCHAR
13customer.remarketing_setting.google_global_site_tagVARCHAR
14customer.idINTEGERPrimary Key
15customer.managerBOOLEAN
16customer.resource_nameVARCHAR
17customer.call_reporting_setting.call_conversion_reporting_enabledBOOLEAN
18customer.optimization_score_weightDOUBLE
19customer.conversion_tracking_setting.conversion_tracking_idINTEGER
20customer.has_partners_badgeBOOLEAN
21segments.dateVARCHARIncremental sync key, Primary Key

Table: display_topics_performance_report

NoColumn NameTypeNotes
1metrics.conversionsDOUBLE
2segments.monthVARCHAR
3ad_group_criterion.statusVARCHAR
4customer.currency_codeVARCHAR
5segments.yearINTEGER
6customer.time_zoneVARCHAR
7metrics.engagementsINTEGER
8campaign.idINTEGER
9metrics.engagement_rateDOUBLE
10ad_group_criterion.final_urlsVARCHAR
11metrics.all_conversionsDOUBLE
12ad_group_criterion.topic.pathVARCHAR
13metrics.gmail_forwardsINTEGER
14ad_group.nameVARCHAR
15campaign.bidding_strategyVARCHAR
16segments.day_of_weekVARCHAR
17segments.quarterVARCHAR
18ad_group.targeting_setting.target_restrictionsVARCHAR
19campaign.bidding_strategy_typeVARCHAR
20metrics.ctrDOUBLE
21ad_group_criterion.tracking_url_templateVARCHAR
22ad_group_criterion.effective_cpc_bid_microsINTEGER
23ad_group_criterion.negativeBOOLEAN
24metrics.video_quartile_p25_rateDOUBLE
25metrics.video_quartile_p50_rateDOUBLE
26metrics.interaction_rateDOUBLE
27metrics.impressionsINTEGER
28metrics.view_through_conversionsINTEGER
29metrics.video_viewsINTEGER
30campaign.statusVARCHAR
31metrics.gmail_secondary_clicksINTEGER
32metrics.active_view_cpmDOUBLE
33metrics.active_view_ctrDOUBLE
34metrics.cross_device_conversionsDOUBLE
35ad_group.base_ad_groupVARCHAR
36metrics.conversions_from_interactions_rateDOUBLE
37metrics.cost_microsINTEGER
38campaign.base_campaignVARCHAR
39metrics.interactionsINTEGER
40metrics.average_cpmDOUBLE
41metrics.interaction_event_typesVARCHAR
42metrics.average_cpvDOUBLE
43segments.deviceVARCHAR
44ad_group_criterion.final_mobile_urlsVARCHAR
45segments.weekVARCHAR
46metrics.active_view_impressionsINTEGER
47metrics.video_view_rateDOUBLE
48metrics.clicksINTEGER
49ad_group_criterion.effective_cpc_bid_sourceVARCHAR
50ad_group_criterion.criterion_idINTEGER
51metrics.all_conversions_from_interactions_rateDOUBLE
52ad_group.statusVARCHAR
53metrics.active_view_measurable_impressionsINTEGER
54ad_group_criterion.url_custom_parametersVARCHAR
55metrics.cost_per_conversionDOUBLE
56metrics.active_view_measurabilityDOUBLE
57metrics.average_cpcDOUBLE
58metrics.average_cpeDOUBLE
59metrics.conversions_valueDOUBLE
60metrics.average_costDOUBLE
61ad_group_criterion.topic.topic_constantVARCHAR
62metrics.video_quartile_p75_rateDOUBLE
63ad_group_criterion.bid_modifierDOUBLE
64segments.ad_network_typeVARCHAR
65metrics.active_view_viewabilityDOUBLE
66ad_group.idINTEGER
67metrics.value_per_all_conversionsDOUBLE
68metrics.video_quartile_p100_rateDOUBLE
69metrics.gmail_savesINTEGER
70metrics.all_conversions_valueDOUBLE
71campaign.nameVARCHAR
72customer.descriptive_nameVARCHAR
73customer.idINTEGER
74metrics.value_per_conversionDOUBLE
75ad_group_criterion.effective_cpm_bid_sourceVARCHAR
76metrics.active_view_measurable_cost_microsINTEGER
77ad_group_criterion.effective_cpm_bid_microsINTEGER
78metrics.cost_per_all_conversionsDOUBLE
79segments.dateVARCHARIncremental sync key

Table: account_performance_report

NoColumn NameTypeNotes
1metrics.conversionsDOUBLE
2segments.monthVARCHAR
3customer.currency_codeVARCHAR
4segments.yearINTEGER
5customer.time_zoneVARCHAR
6metrics.engagementsINTEGER
7metrics.engagement_rateDOUBLE
8metrics.all_conversionsDOUBLE
9customer.test_accountBOOLEAN
10segments.day_of_weekVARCHAR
11segments.quarterVARCHAR
12metrics.search_budget_lost_impression_shareDOUBLE
13metrics.content_impression_shareDOUBLE
14metrics.ctrDOUBLE
15metrics.search_rank_lost_impression_shareDOUBLE
16metrics.interaction_rateDOUBLE
17metrics.impressionsINTEGER
18metrics.view_through_conversionsINTEGER
19metrics.video_viewsINTEGER
20metrics.content_budget_lost_impression_shareDOUBLE
21metrics.active_view_cpmDOUBLE
22metrics.active_view_ctrDOUBLE
23metrics.cross_device_conversionsDOUBLE
24metrics.conversions_from_interactions_rateDOUBLE
25metrics.cost_microsINTEGER
26metrics.interactionsINTEGER
27metrics.average_cpmDOUBLE
28metrics.content_rank_lost_impression_shareDOUBLE
29metrics.interaction_event_typesVARCHAR
30metrics.average_cpvDOUBLE
31segments.deviceVARCHAR
32segments.weekVARCHAR
33metrics.active_view_impressionsINTEGER
34metrics.video_view_rateDOUBLE
35metrics.clicksINTEGER
36customer.managerBOOLEAN
37metrics.all_conversions_from_interactions_rateDOUBLE
38metrics.search_exact_match_impression_shareDOUBLE
39metrics.active_view_measurable_impressionsINTEGER
40metrics.cost_per_conversionDOUBLE
41metrics.active_view_measurabilityDOUBLE
42metrics.average_cpcDOUBLE
43metrics.average_cpeDOUBLE
44metrics.conversions_valueDOUBLE
45metrics.average_costDOUBLE
46segments.ad_network_typeVARCHAR
47metrics.active_view_viewabilityDOUBLE
48metrics.value_per_all_conversionsDOUBLE
49metrics.all_conversions_valueDOUBLE
50customer.auto_tagging_enabledBOOLEAN
51customer.descriptive_nameVARCHAR
52customer.idINTEGER
53metrics.search_impression_shareDOUBLE
54metrics.value_per_conversionDOUBLE
55metrics.active_view_measurable_cost_microsINTEGER
56metrics.cost_per_all_conversionsDOUBLE
57segments.dateVARCHARIncremental sync key

Table: ad_group_ad_labels

NoColumn NameTypeNotes
1ad_group_ad_label.resource_nameVARCHARPrimary Key
2ad_group_ad.ad.resource_nameVARCHAR
3label.resource_nameVARCHAR
4label.nameVARCHAR

Table: user_location_report

NoColumn NameTypeNotes
1campaign.base_campaignVARCHAR
2metrics.conversionsDOUBLE
3segments.monthVARCHAR
4metrics.interactionsDOUBLE
5segments.yearINTEGER
6customer.currency_codeVARCHAR
7metrics.average_cpmDOUBLE
8customer.time_zoneVARCHAR
9metrics.interaction_event_typesVARCHAR
10metrics.average_cpvDOUBLE
11campaign.idINTEGER
12metrics.all_conversionsDOUBLE
13segments.weekVARCHAR
14ad_group.nameVARCHAR
15metrics.video_view_rateDOUBLE
16metrics.clicksDOUBLE
17metrics.all_conversions_from_interactions_rateDOUBLE
18user_location_view.country_criterion_idINTEGER
19user_location_view.resource_nameVARCHAR
20ad_group.statusVARCHAR
21segments.day_of_weekVARCHAR
22segments.quarterVARCHAR
23metrics.cost_per_conversionDOUBLE
24metrics.average_cpcDOUBLE
25metrics.ctrDOUBLE
26metrics.conversions_valueDOUBLE
27metrics.average_costDOUBLE
28segments.ad_network_typeVARCHAR
29metrics.interaction_rateDOUBLE
30metrics.impressionsDOUBLE
31metrics.value_per_all_conversionsDOUBLE
32metrics.view_through_conversionsDOUBLE
33metrics.all_conversions_valueDOUBLE
34campaign.nameVARCHAR
35metrics.video_viewsDOUBLE
36customer.descriptive_nameVARCHAR
37campaign.statusVARCHAR
38customer.idINTEGER
39metrics.value_per_conversionDOUBLE
40metrics.cross_device_conversionsDOUBLE
41ad_group.base_ad_groupVARCHAR
42metrics.conversions_from_interactions_rateDOUBLE
43metrics.cost_microsDOUBLE
44segments.dateVARCHARIncremental sync key
45metrics.cost_per_all_conversionsDOUBLE

External Resources

Zipstack Cloud features a powerful SQL querying engine on top of many types of connectors, including those from Trino, some custom connectors and connectors from the open source Airbyte project. Some Zipstack cloud connectors are designed to utilize and expand upon Airbyte's connector protocol, but they do not use Airbyte's EL core. Additionally, some parts of the documentation for these connectors have been adapted from the connector documentation found in Airbyte's open source project.