Google Ads#
Connect Google Ads with Google OAuth plus a customer id and optional manager id. The source writes 42 fixed tables under titan.google_ads.
select
id,
descriptive_name,
currency_code
from titan.google_ads.customer
limit 10Connect Google Ads#
Open Apps, choose Connect app, and select Google Ads.
Enter Google OAuth plus a customer id and optional manager id.
Review the tables, then save the source.
Watch Sync history until the first run completes.
Credentials are stored as secrets. They never become lake columns or appear in query results.
Sync behavior#
Entity and performance tables share the connected account scope. Account selection happens during setup.
A new source syncs when you connect it and then follows its schedule. The default recurring interval is 4 hours. An interrupted run keeps its completed progress and retries safely.
Every lake table also has the system columns _synced_at and _deleted; the column reference below lists source columns only.
Table reference#
customer#
titan.google_ads.customer has 10 source columns.
Source field id.
Source field descriptiveName.
Source field currencyCode.
Source field timeZone.
Source field status.
Source field autoTaggingEnabled.
Source field manager.
Source field testAccount.
Source field optimizationScore.
Source field hasPartnersBadge.
campaign#
titan.google_ads.campaign has 27 source columns.
Source field id.
Source field name.
Source field status.
Source field advertisingChannelType.
Source field advertisingChannelSubType.
Source field biddingStrategyType.
Source field budgetId.
Source field biddingStrategyId.
Source field startDateTime.
Source field endDateTime.
Source field servingStatus.
Source field paymentMode.
Source field optimizationScore.
Source field targetGoogleSearch.
Source field targetSearchNetwork.
Source field targetContentNetwork.
Source field targetPartnerSearchNetwork.
Source field shoppingMerchantId.
Source field shoppingFeedLabel.
Source field shoppingCampaignPriority.
Source field shoppingEnableLocal.
Source field baseCampaignId.
Source field labels.
Source field dsaDomainName.
Source field dsaLanguageCode.
Source field appId.
Source field appStore.
campaign_budget#
titan.google_ads.campaign_budget has 12 source columns.
Source field id.
Source field name.
Source field amountMicros.
Source field totalAmountMicros.
Source field status.
Source field period.
Source field type.
Source field referenceCount.
Source field hasRecommendedBudget.
Source field recommendedBudgetAmountMicros.
Source field alignedBiddingStrategyId.
ad_group#
titan.google_ads.ad_group has 22 source columns.
Source field id.
Source field name.
Source field status.
Source field type.
Source field campaignId.
Source field cpcBidMicros.
Source field effectiveCpcBidMicros.
Source field cpmBidMicros.
Source field targetCpaMicros.
Source field targetRoas.
Source field cpvBidMicros.
Source field targetCpmMicros.
Source field targetCpvMicros.
Source field targetCpcMicros.
Source field percentCpcBidMicros.
Source field fixedCpmMicros.
Source field effectiveTargetCpaMicros.
Source field effectiveTargetRoas.
Source field effectiveTargetCpc.
Source field optimizedTargetingEnabled.
Source field labels.
Source field baseAdGroupId.
ad_group_ad#
titan.google_ads.ad_group_ad has 14 source columns.
Source field adId.
Source field adGroupId.
Source field campaignId.
Source field status.
Source field adType.
Source field adStrength.
Source field name.
Source field finalUrls.
Source field finalMobileUrls.
Source field displayUrl.
Source field addedByGoogleAds.
Source field path1.
Source field path2.
Source field labels.
ad_group_criterion#
titan.google_ads.ad_group_criterion has 19 source columns.
Source field criterionId.
Source field adGroupId.
Source field campaignId.
Source field type.
Source field status.
Source field displayName.
Source field negative.
Source field keywordText.
Source field keywordMatchType.
Source field qualityScore.
Source field creativeQualityScore.
Source field postClickQualityScore.
Source field searchPredictedCtr.
Source field bidModifier.
Source field cpcBidMicros.
Source field effectiveCpcBidMicros.
Source field finalUrls.
Source field labels.
Source field baseCampaignId.
campaign_criterion#
titan.google_ads.campaign_criterion has 34 source columns.
Source field criterionId.
Source field campaignId.
Source field type.
Source field status.
Source field displayName.
Source field negative.
Source field bidModifier.
Source field geoTargetConstantId.
Source field languageConstantId.
Source field languageCode.
Source field languageName.
Source field keywordText.
Source field keywordMatchType.
Source field deviceType.
Source field ageRangeType.
Source field genderType.
Source field incomeRangeType.
Source field parentalStatusType.
Source field userInterestId.
Source field userListId.
Source field placementUrl.
Source field topicConstantId.
Source field youtubeChannelId.
Source field youtubeVideoId.
Source field carrierCountryCode.
Source field carrierName.
Source field mobileDeviceId.
Source field operatingSystemVersionId.
Source field contentLabelType.
Source field ipBlockIpAddress.
Source field mobileAppCategoryId.
Source field mobileApplicationAppId.
Source field mobileApplicationName.
Source field mobileAppCategoryName.
conversion_action#
titan.google_ads.conversion_action has 19 source columns.
Source field id.
Source field name.
Source field status.
Source field type.
Source field category.
Source field origin.
Source field primaryForGoal.
Source field ownerCustomerId.
Source field includeInConversionsMetric.
Source field countingType.
Source field clickThroughLookbackWindowDays.
Source field viewThroughLookbackWindowDays.
Source field phoneCallDurationSeconds.
Source field appId.
Source field defaultValue.
Source field defaultCurrencyCode.
Source field alwaysUseDefaultValue.
Source field attributionModel.
Source field dataDrivenModelStatus.
bidding_strategy#
titan.google_ads.bidding_strategy has 15 source columns.
Source field id.
Source field name.
Source field status.
Source field type.
Source field currencyCode.
Source field effectiveCurrencyCode.
Source field alignedCampaignBudgetId.
Source field campaignCount.
Source field nonRemovedCampaignCount.
Source field targetCpaMicros.
Source field targetRoas.
Source field cpcBidCeilingMicros.
Source field cpcBidFloorMicros.
label#
titan.google_ads.label has 5 source columns.
Source field id.
Source field name.
Source field status.
Source field backgroundColor.
Source field description.
audience#
titan.google_ads.audience has 6 source columns.
Source field id.
Source field name.
Source field status.
Source field description.
Source field scope.
Source field dimensions.
user_interest#
titan.google_ads.user_interest has 5 source columns.
Source field id.
Source field name.
Source field taxonomyType.
Source field parentId.
Source field launchedToAll.
asset_group#
titan.google_ads.asset_group has 11 source columns.
Source field id.
Source field campaignId.
Source field name.
Source field status.
Source field primaryStatus.
Source field adStrength.
Source field path1.
Source field path2.
Source field finalUrls.
Source field finalMobileUrls.
Source field primaryStatusReasons.
asset_group_asset#
titan.google_ads.asset_group_asset has 5 source columns.
Source field assetGroupId.
Source field assetId.
Source field fieldType.
Source field status.
Source field source.
asset#
titan.google_ads.asset has 38 source columns.
Source field id.
Source field name.
Source field type.
Source field source.
Source field finalUrls.
Source field finalMobileUrls.
Source field trackingUrlTemplate.
Source field finalUrlSuffix.
Source field textAssetText.
Source field imageUrl.
Source field imageFileSize.
Source field imageMimeType.
Source field youtubeVideoId.
Source field youtubeVideoTitle.
Source field sitelinkLinkText.
Source field sitelinkDescription1.
Source field sitelinkDescription2.
Source field calloutText.
Source field structuredSnippetHeader.
Source field structuredSnippetValues.
Source field callCountryCode.
Source field callPhoneNumber.
Source field callConversionAction.
Source field promotionTarget.
Source field promotionDiscountModifier.
Source field promotionRedemptionStartDate.
Source field promotionRedemptionEndDate.
Source field promotionOccasion.
Source field promotionLanguageCode.
Source field promotionPercentOff.
Source field promotionMoneyAmountOffMicros.
Source field leadFormBusinessName.
Source field leadFormCallToAction.
Source field leadFormDescription.
Source field leadFormHeadline.
Source field priceType.
Source field pricePriceQualifier.
Source field pageFeedPageUrl.
asset_group_listing_group_filter#
titan.google_ads.asset_group_listing_group_filter has 13 source columns.
Source field id.
Source field assetGroupId.
Source field parentId.
Source field type.
Source field path.
Source field productBrandValue.
Source field productItemIdValue.
Source field productCategoryLevel.
Source field productCategoryId.
Source field productChannelChannel.
Source field productConditionCondition.
Source field productCustomAttributeIndex.
Source field productCustomAttributeValue.
asset_group_signal#
titan.google_ads.asset_group_signal has 5 source columns.
Source field resourceName.
Source field assetGroupId.
Source field searchThemeText.
Source field audienceSignal.
Source field disapprovalReasons.
campaign_label#
titan.google_ads.campaign_label has 2 source columns.
Source field campaignId.
Source field labelId.
ad_group_label#
titan.google_ads.ad_group_label has 2 source columns.
Source field adGroupId.
Source field labelId.
ad_group_ad_label#
titan.google_ads.ad_group_ad_label has 3 source columns.
Source field adGroupId.
Source field adId.
Source field labelId.
ad_group_criterion_label#
titan.google_ads.ad_group_criterion_label has 3 source columns.
Source field adGroupId.
Source field criterionId.
Source field labelId.
account_metrics#
titan.google_ads.account_metrics has 24 source columns.
Source field date.
Source field device.
Source field adNetworkType.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
campaign_metrics#
titan.google_ads.campaign_metrics has 25 source columns.
Source field campaignId.
Source field date.
Source field device.
Source field adNetworkType.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
ad_group_metrics#
titan.google_ads.ad_group_metrics has 26 source columns.
Source field adGroupId.
Source field campaignId.
Source field date.
Source field device.
Source field adNetworkType.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
ad_metrics#
titan.google_ads.ad_metrics has 28 source columns.
Source field adGroupId.
Source field adId.
Source field campaignId.
Source field date.
Source field device.
Source field adNetworkType.
Source field keywordCriterionId.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
keyword_metrics#
titan.google_ads.keyword_metrics has 25 source columns.
Source field adGroupId.
Source field criterionId.
Source field campaignId.
Source field date.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
search_term_metrics#
titan.google_ads.search_term_metrics has 29 source columns.
Source field campaignId.
Source field adGroupId.
Source field searchTerm.
Source field date.
Source field status.
Source field keywordCriterionId.
Source field searchTermMatchType.
Source field keywordText.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
asset_group_metrics#
titan.google_ads.asset_group_metrics has 24 source columns.
Source field assetGroupId.
Source field campaignId.
Source field date.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
geographic_view#
titan.google_ads.geographic_view has 28 source columns.
Source field campaignId.
Source field date.
Source field geoTargetConstantId.
Source field locationType.
Source field countryCriterionId.
Source field countryName.
Source field geoTargetName.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
user_location_view#
titan.google_ads.user_location_view has 28 source columns.
Source field campaignId.
Source field date.
Source field geoTargetConstantId.
Source field countryCriterionId.
Source field countryName.
Source field geoTargetName.
Source field targetingLocation.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
age_range_view#
titan.google_ads.age_range_view has 26 source columns.
Source field campaignId.
Source field adGroupId.
Source field date.
Source field ageRangeType.
Source field criterionId.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
gender_view#
titan.google_ads.gender_view has 26 source columns.
Source field campaignId.
Source field adGroupId.
Source field date.
Source field genderType.
Source field criterionId.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
income_range_view#
titan.google_ads.income_range_view has 26 source columns.
Source field campaignId.
Source field adGroupId.
Source field date.
Source field incomeRangeType.
Source field criterionId.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
parental_status_view#
titan.google_ads.parental_status_view has 26 source columns.
Source field campaignId.
Source field adGroupId.
Source field date.
Source field parentalStatusType.
Source field criterionId.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
landing_page_view#
titan.google_ads.landing_page_view has 26 source columns.
Source field campaignId.
Source field adGroupId.
Source field date.
Source field expandedFinalUrl.
Source field unexpandedFinalUrl.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
ad_group_audience_view#
titan.google_ads.ad_group_audience_view has 26 source columns.
Source field campaignId.
Source field adGroupId.
Source field criterionId.
Source field date.
Source field displayName.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
ad_schedule_view#
titan.google_ads.ad_schedule_view has 30 source columns.
Source field campaignId.
Source field criterionId.
Source field date.
Source field dayOfWeek.
Source field startHour.
Source field endHour.
Source field startMinute.
Source field endMinute.
Source field bidModifier.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
shopping_performance_view#
titan.google_ads.shopping_performance_view has 48 source columns.
Source field campaignId.
Source field adGroupId.
Source field date.
Source field productItemId.
Source field productBrand.
Source field productCategoryL1.
Source field productCategoryL2.
Source field productCategoryL3.
Source field productCategoryL4.
Source field productCategoryL5.
Source field productChannel.
Source field productChannelExclusivity.
Source field productCondition.
Source field productCustomAttribute0.
Source field productCustomAttribute1.
Source field productCustomAttribute2.
Source field productCustomAttribute3.
Source field productCustomAttribute4.
Source field productLanguage.
Source field productMerchantId.
Source field productStoreId.
Source field productTitle.
Source field productTypeL1.
Source field productTypeL2.
Source field productTypeL3.
Source field productTypeL4.
Source field productTypeL5.
Source field impressions.
Source field clicks.
Source field interactions.
Source field videoViews.
Source field viewThroughConversions.
Source field costMicros.
Source field averageCpc.
Source field averageCpm.
Source field averageCost.
Source field costPerConversion.
Source field conversions.
Source field allConversions.
Source field conversionsValue.
Source field allConversionsValue.
Source field ctr.
Source field interactionRate.
Source field conversionsFromInteractionsRate.
Source field videoViewRate.
Source field absoluteTopImpressionPercentage.
Source field conversionsFromInteractionsValuePerInteraction.
click_view#
titan.google_ads.click_view has 12 source columns.
Source field gclid.
Source field date.
Source field campaignId.
Source field adGroupId.
Source field adId.
Source field keywordCriterionId.
Source field keywordText.
Source field keywordMatchType.
Source field pageNumber.
Source field areaOfInterestId.
Source field locationOfPresenceId.
Source field userListId.
change_event#
titan.google_ads.change_event has 11 source columns.
Source field resourceName.
Source field changeDateTime.
Source field changeResourceType.
Source field changeResourceName.
Source field clientType.
Source field userEmail.
Source field campaignId.
Source field adGroupId.
Source field changedFields.
Source field oldResource.
Source field newResource.
geo_target_constant#
titan.google_ads.geo_target_constant has 7 source columns.
Source field id.
Source field name.
Source field canonicalName.
Source field countryCode.
Source field targetType.
Source field status.
Source field parentGeoTargetId.
language_constant#
titan.google_ads.language_constant has 4 source columns.
Source field id.
Source field name.
Source field code.
Source field targetable.
Deletes and history#
Rows are merged by their source key. When the source can prove that a row was deleted, Supernova keeps the row and sets _deleted so queries can choose whether to include history. Filter current-state queries with where not _deleted.