Google Ads

# Campaigns (BudgetReferenceCount)

string

The number of campaigns actively using the budget.

dimension

% new sessions (PercentNewVisitors)

long

Percentage of first-time sessions (from people who had never visited your site before); formatted as

metric

Accent color (multi asset responsive display) (MultiAssetResponsiveDisplayAdAccentColor)

string

The accentColor setting for a MultiAssetResponsiveDisplayAd.

dimension

Accent color (responsive) (AccentColor)

string

The accent color for the responsive display ad.

dimension

Account (AccountDescriptiveName)

string

The descriptive name of the Customer account.

dimension

Active View avg. CPM (ActiveViewCpm)

currency

Average cost of viewable impressions (ActiveViewImpressions).

metric

Active View measurable cost (ActiveViewMeasurableCost)

currency

The cost of the impressions you received that were measurable by Active View.

metric

Active View measurable impr. (ActiveViewMeasurableImpressions)

long

The number of times your ads are appearing on placements in positions where they can be seen.

metric

Active View measurable impr. / impr. (ActiveViewMeasurability)

float

The ratio of impressions that could be measured by Active View over the number of served impressions.

metric

Active View viewable CTR (ActiveViewCtr)

percentage

How often people clicked your ad after it became viewable.

metric

Active View viewable impr. / measurable impr. (ActiveViewViewability)

float

The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).

metric

Active View viewable impressions (ActiveViewImpressions)

long

How often your ad has become viewable on a Display Network site.

metric

Ad (Headline)

string

The ad headline for a TextAd. For other ad types such as TemplateAds; this field will contain a string representation of the key attributes of the ad.

dimension

Ad Avg. CPC (AverageCpc)

currency

The total cost of all clicks divided by the total number of clicks received.

metric

Ad Avg. position (AveragePosition)

float

Your ad's position relative to those of other advertisers.

metric

Ad CTR (Ctr)

percentage

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as

metric

Ad Clicks (Clicks)

float

The number of clicks.

metric

Ad Groups (AdGroupCount)

long

The count of AdGroup objects using the bidding strategy.

metric

Ad ID (AdId)

string

ID of the main object of this row.

dimension

Ad ID (CreativeId)

string

ID of the ad.

dimension

Ad ID (ExtensionPlaceholderCreativeId)

string

ID of the ad where the extension appeared.

dimension

Ad ID (Id)

string

ID of the main object of this row.

dimension

Ad Impressions (Impressions)

float

Count of how often your ad has appeared on a search results page or website on the Google Network.

metric

Ad Schedule (Id)

string

ID of the main object of this row.

dimension

Ad Variation Control Trial Arm ID (AdVariationControlTrialArmId)

string

If the impression was part of an ad variation and in the control arm; this represents the ad variation control arm ID.

dimension

Ad Variation Treatment Trial Arm ID (AdVariationTreatmentTrialArmId)

string

If the impression was part of an ad variation and in the treatment arm; this represents the ad variation treatment arm ID.

dimension

Ad Variation Trial ID (AdVariationTrialId)

string

If the impression was part of an ad variation; this represents the ad variation trial ID.

dimension

Ad event type (ConversionAttributionEventType)

string

The event type to which the conversion was attributed.

dimension

Ad format preference (multi asset responsive display) (MultiAssetResponsiveDisplayAdFormatSetting)

string

The formatSetting setting for a MultiAssetResponsiveDisplayAd.

dimension

Ad format preference (responsive) (FormatSetting)

string

The format setting of the responsive display ad.

dimension

Ad group (AdGroupName)

string

The name of the AdGroup.

dimension

Ad group ID (AdGroupId)

string

The ID of the AdGroup.

dimension

Ad group creatives count (AdGroupCreativesCount)

float

The count of AdGroupAd objects using the label.

metric

Ad group criteria count (AdGroupCriteriaCount)

long

The count of AdGroupCriterion objects using the bidding strategy or label.

metric

Ad group state (AdGroupStatus)

string

Status of the ad group.

dimension

Ad group type (AdGroupType)

string

The type of ad group.

dimension

Ad groups count (AdGroupsCount)

float

The count of ad groups using the bidding strategy or label.

metric

Ad relevance (CreativeQualityScore)

string

The quality score of the ad.

dimension

Ad rotation mode (AdRotationMode)

string

How often the ads in the ad group will be served relative to one another.

dimension

Ad state (CreativeStatus)

string

Status of the ad.

dimension

Ad state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Ad strength (AdStrengthInfo)

string

The strength information of the ad.

dimension

Ad type (AdFormat)

string

The underlying media format of the ad.

dimension

Ad type (AdType)

string

The type of the Ad. If the ad's type is not supported in the report request's API version; this field will have the value

dimension

Added (IsBidOnPath)

string

Indicates if the placement was added as a criterion.

dimension

Added/Excluded (QueryTargetingStatus)

string

Indicates whether the search term is currently one of your targeted or excluded keywords.

dimension

Advertising Channel (AdvertisingChannelType)

string

Primary serving target for ads in the campaign.

dimension

Advertising Sub Channel (AdvertisingChannelSubType)

string

Optional refinement of the campaign's AdvertisingChannelType.

dimension

Age Range (Criteria)

string

Descriptive string for the Criterion.

dimension

Age Range state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

All conv. (AllConversions)

float

Best estimate of the total number of conversions that Google Ads drives. Includes website; cross-device; and phone call conversions. This field is formatted with dot (

metric

All conv. rate (AllConversionRate)

percentage

AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. Percentage returned as

metric

All conv. value (AllConversionValue)

currency

The total value of all of your conversions; including those that are estimated. This field is formatted with dot (

metric

Allow flexible color (multi asset responsive display) (MultiAssetResponsiveDisplayAdAllowFlexibleColor)

string

The allowFlexibleColor setting for a MultiAssetResponsiveDisplayAd.

dimension

Allow flexible color (responsive) (AllowFlexibleColor)

string

Whether the responsive display ad colors must be strictly used.

dimension

App final URL (CreativeFinalAppUrls)

string

List of final app URLs of the ad. List entries will start with one of: a)

dimension

App final URL (FinalAppUrls)

string

List of final app URLs of the main object of this row. List entries will start with one of: a)

dimension

Approval Status (ApprovalStatus)

string

Approval status of the criterion.

dimension

Approval Status (ValidationDetails)

string

Details about the validation state for the FeedItem.List elements are returned in JSON list format.

dimension

Approval status (CombinedApprovalStatus)

string

Approval status that combines review state and status.

dimension

Attribute Values (AttributeValues)

currency

The FeedItem's attribute values.List elements are returned in JSON list format.

dimension

Attribute Values (FeedItemAttributes)

currency

List of attribute values for the FeedItem.

dimension

Auto tagging enabled (IsAutoTaggingEnabled)

string

Indicates if auto tagging is enabled on the account.

dimension

Auto-applied ad suggestion (Automated)

string

Indicates if this ad is automatically created by Google Ads.

dimension

Avg. CPC (AverageCpc)

currency

The total cost of all clicks divided by the total number of clicks received.

metric

Avg. CPE (AverageCpe)

currency

The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.

metric

Avg. CPM (AverageCpm)

currency

Average Cost-per-thousand impressions (CPM).

metric

Avg. CPV (AverageCpv)

currency

The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.

metric

Avg. Cost (AverageCost)

currency

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.

metric

Avg. impr. freq. per cookie (AverageFrequency)

float

Average number of times a unique cookie was exposed to your ad over a given time period. Imported from Google Analytics.

metric

Avg. position (AveragePosition)

float

Your ad's position relative to those of other advertisers.

metric

Avg. session duration (seconds) (AverageTimeOnSite)

float

Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.

metric

Base Ad group ID (BaseAdGroupId)

string

The ID of base ad group of trial ad groups. For regular ad groups; this is equal to AdGroupId. For campaign-level user lists; this will always be 0.

dimension

Base Campaign ID (BaseCampaignId)

string

The ID of base campaign of trial campaigns. For regular campaigns; this is equal to CampaignId.

dimension

Benchmark CTR (BenchmarkCtr)

float

Indicates how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad end up clicking on it.

metric

Benchmark Max. CPC (BenchmarkAverageMaxCpc)

float

Indicates how other advertisers are bidding on similar products.Values can be one of: a) a money amount in micros; b)

metric

Bid Strategy ID (BiddingStrategyId)

string

The ID of the BiddingStrategyConfiguration.

dimension

Bid Strategy ID (Id)

string

ID of the main object of this row.

dimension

Bid Strategy Name (BiddingStrategyName)

string

The name of the BiddingStrategyConfiguration.

dimension

Bid Strategy Name (Name)

string

The name of the main object in this row. For example; in a Campaign Performance Report this will be the name of each row's Campaign. In an Ad Group Performance Report this will be the name of each row's AdGroup.

dimension

Bid Strategy Type (BiddingStrategyType)

string

The type of the BiddingStrategyConfiguration.

dimension

Bid Strategy Type (Type)

string

The type of the main object in this row. For example; in a Bid Goal Performance Report this will be the type of the BiddingStrategyConfiguration. In a Shared Set Report this will be the type of the SharedSet.

dimension

Bid adj. (BidModifier)

string

The bid modifier. To filter by this field; use values greater than 0 and less than or equal to 1. Percentage returned as

dimension

Bid adjustment (Target search page location) (PageOnePromotedBidModifier)

float

Bid multiplier defined on the PageOnePromotedBiddingScheme.

metric

Bid automation (Target Outranking Share) (TargetOutrankShareBidChangesForRaisesOnly)

boolean

Whether the TargetRoas strategy always follows bid estimate changes (false); or only increases (true).

dimension

Bid automation (Target search page location) (PageOnePromotedBidChangesForRaisesOnly)

string

Whether the PageOnePromoted strategy always follows bid estimate changes (false); or only increases (true).

dimension

Bid limit (Maximize clicks) (TargetSpendBidCeiling)

currency

The largest max CPC bid that can be set by the TargetSpend BiddingStrategyConfiguration.

metric

Bid limit (Target search page location) (PageOnePromotedBidCeiling)

currency

Maximum bid limit for the PageOnePromotedBiddingScheme.

metric

Bidding Strategy Source (BiddingStrategySource)

string

Indicates where the bidding strategy is associated i.e. campaign; ad group or ad group criterion.

dimension

Bounce rate (BounceRate)

percentage

Percentage of clicks where the user only visited a single page on your site; formatted as

metric

Brand (Brand)

string

The ProductBrand value of the product.

dimension

Budget (Amount)

currency

The daily budget. On the Campaign Performance Report this column reflects the entire shared budget if the campaign draws from a shared budget.

metric

Budget ID (BudgetId)

string

The ID of the Budget.

dimension

Budget Name (BudgetName)

string

The name of the Budget.

dimension

Budget explicitly shared (IsBudgetExplicitlyShared)

boolean

Indicates if the budget is a shared budget (true) or specific to the campaign (false).

dimension

Budget period (Period)

string

Period over which to spend the budget.

dimension

Budget state (BudgetStatus)

string

The status of the Budget.

dimension

Budget usage (BudgetCampaignAssociationStatus)

string

The status of the association between the Budget and the associated Campaign.

dimension

Business name (BusinessName)

string

The business name in a reponsive display ad.

dimension

Business name (multi asset responsive display) (MultiAssetResponsiveDisplayAdBusinessName)

string

The businessName setting for a MultiAssetResponsiveDisplayAd.

dimension

CTR (Ctr)

long

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as

metric

Call source (CallTrackingDisplayLocation)

string

Location (e.g.; ad or landing page) of the impression where the phone number was shown.

dimension

Call to action text (multi asset responsive display) (MultiAssetResponsiveDisplayAdCallToActionText)

string

The callToActionText setting for a MultiAssetResponsiveDisplayAd.

dimension

Call to action text (responsive) (CallToActionText)

string

The call-to-action text for the responsive display ad.

dimension

Call type (CallType)

string

The type of the call.

dimension

Call-only ad phone number (CallOnlyPhoneNumber)

string

The phone number of call-only ad.

dimension

Caller area code (CallerNationalDesignatedCode)

string

Area code of the caller.

dimension

Caller country code (CallerCountryCallingCode)

string

Country code of the caller.

dimension

Campaign (AssociatedCampaignName)

string

The name of a Campaign associated with the Budget.

dimension

Campaign (CampaignName)

string

The name of the Campaign.

dimension

Campaign Group ID (CampaignGroupId)

string

The ID of campaign group.

dimension

Campaign Group ID (Id)

string

ID of the main object of this row.

dimension

Campaign Group Name (Name)

string

The name of the main object in this row. For example; in a Campaign Performance Report this will be the name of each row's Campaign. In an Ad Group Performance Report this will be the name of each row's AdGroup.

dimension

Campaign Group Status (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Campaign ID (AssociatedCampaignId)

string

The ID of a Campaign associated with the Budget.

dimension

Campaign ID (CampaignId)

string

The ID of the Campaign.

dimension

Campaign Trial Type (CampaignTrialType)

string

The type of campaign. This shows if the campaign is a trial campaign or not.

dimension

Campaign location target (CampaignLocationTargetId)

string

Location ID of the matching campaign criterion.

dimension

Campaign serving status (ServingStatus)

string

Indicates if the Campaign is serving ads.

dimension

Campaign state (AssociatedCampaignStatus)

string

The status of a Campaign associated with the Budget.

dimension

Campaign state (CampaignStatus)

string

The status of the Campaign.

dimension

Campaigns (CampaignCount)

long

The count of Campaign objects using the bidding strategy.

metric

Campaigns count (CampaignsCount)

float

The count of Campaign objects using the label.

metric

Can manage clients (CanManageClients)

string

Indicates if the account is an MCC account (true) or a regular Google Ads account (false).

dimension

Categories (CategoryPaths)

string

The themes of the pages in your website domain derived from your website's structure.

dimension

Category (1st level) (CategoryL1)

string

The ProductBiddingCategory level 1 value of the product.

dimension

Category (2nd level) (CategoryL2)

string

The ProductBiddingCategory level 2 value of the product.

dimension

Category (3rd level) (CategoryL3)

string

The ProductBiddingCategory level 3 value of the product.

dimension

Category (4th level) (CategoryL4)

string

The ProductBiddingCategory level 4 value of the product.

dimension

Category (5th level) (CategoryL5)

string

The ProductBiddingCategory level 5 value of the product.

dimension

Channel (Channel)

string

Channel of the product.

dimension

Channel Exclusivity (ChannelExclusivity)

string

Channel exclusivity of the product.

dimension

City (CityCriteriaId)

string

ID of the city Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

City (Location of interest) (AoiCityCriteriaId)

string

ID of the city of the Location criterion matching the area of interest

dimension

City (Physical location) (LopCityCriteriaId)

string

ID of the city of the Location criterion matching the location of presence

dimension

Click Assisted Conv. (ClickAssistedConversions)

long

The total number of conversions for which this keyword; ad; ad group; or campaign contributed to one or more assisted clicks.

metric

Click Assisted Conv. / Last Click Conv. (ClickAssistedConversionsOverLastClickConversions)

long

The total number of conversions for which this keyword; ad; ad group; or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.

metric

Click Assisted Conv. Value (ClickAssistedConversionValue)

currency

The total value of all conversions for which this keyword; ad; ad group; or campaign triggered assisted clicks.

metric

Click share (SearchClickShare)

percentage

The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. A percentage returned as

metric

Click type (ClickType)

string

Indicates the click type for metric fields such as Impressions. Since ads that serve can be attributed to multiple click types; metric fields may be double-counted and thus totals may not be accurate; especially for Display network campaigns.

dimension

Clicks (Clicks)

long

The number of clicks.

metric

Client Customer Id

string

The Client Customer ID.

dimension

Client Customer Name

string

The name of the Client.

dimension

Client name (CustomerDescriptiveName)

string

The descriptive name of the Customer.

dimension

Combined Clicks (CombinedAdsOrganicClicks)

float

Clicks from ads or organic search results.

metric

Combined Clicks/Query (CombinedAdsOrganicClicksPerQuery)

float

CombinedAdsOrganicClicks divided by CombinedAdsOrganicQueries. This field is formatted with dot (

metric

Combined Queries (CombinedAdsOrganicQueries)

float

Total number of searches that returned pages from your site in the organic search results or triggered one of your ads.

metric

Competitor domain (Target Outranking Share) (TargetOutrankShareCompetitorDomain)

string

The competitor's visible domain URL for the TargetRoas strategy.

dimension

Condition (ProductCondition)

string

The ProductCanonicalCondition of the product.

dimension

Content Impr. share (ContentImpressionShare)

percentage

The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. A percentage returned as

metric

Content Lost IS (budget) (ContentBudgetLostImpressionShare)

percentage

The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. A percentage returned as

metric

Content Lost IS (rank) (ContentRankLostImpressionShare)

percentage

The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. A percentage returned as

metric

Content Network Bid Dimension (ContentBidCriterionTypeGroup)

string

The type of criteria the ad group uses for absolute bids on the Display Network.

dimension

Conv. rate (ConversionRate)

percentage

The number of conversions divided by total clicks that can be tracked to conversions. Percentage returned as

metric

Conv. value (current model) (CurrentModelAttributedConversionValue)

currency

Shows how your historic ConversionValue data would look under the attribution model you've currently selected. This field is formatted with dot (

metric

Conversion Tracker Id (ConversionTrackerId)

string

ID of the conversion tracker.

dimension

Conversion adjustment (ConversionAdjustment)

string

Whether the conversion was adjusted or the conversion is original one.

dimension

Conversion category (ConversionCategoryName)

string

A category that describes the action the user will take to complete a conversion. Prevents zero-conversion rows from being returned. Values:

dimension

Conversion name (ConversionTypeName)

string

The name of the conversion type. Prevents zero-conversion rows from being returned.

dimension

Conversion source (ExternalConversionSource)

string

The source of conversion such as website; import from calls.

dimension

Conversions (Conversions)

long

The number of conversions for all conversion actions that you have opted into optimization. This field is formatted with dot (

metric

Conversions (current model) (CurrentModelAttributedConversions)

long

Shows how your historic Conversions data would look under the attribution model you've currently selected. This field is formatted with dot (

metric

Cost (Cost)

currency

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.

metric

Cost / all conv. (CostPerAllConversion)

currency

Total cost divided by all conversions.

metric

Cost / conv. (CostPerConversion)

currency

The Cost attributable to conversion-tracked clicks divided by the number of conversions

metric

Cost / conv. (current model) (CostPerCurrentModelAttributedConversion)

currency

Shows how your historic CostPerConversion data would look under the attribution model you've currently selected. This field is formatted with dot (

metric

Country/Territory (CountryCriteriaId)

string

ID of the country Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Country/Territory (Location of interest) (AoiCountryCriteriaId)

string

ID of the country of the Location criterion matching the area of interest (AOI) associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Country/Territory (Physical location) (LopCountryCriteriaId)

string

ID of the country of the Location criterion matching the location of presence (LOP) associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Criteria Display Name (DisplayName)

string

Descriptive string for the Criterion.

dimension

Criteria Type (CriteriaType)

string

The type of the Criterion.

dimension

Criteria Type (CriterionType)

string

The type of criterion.

dimension

Criterion (Criteria)

string

Descriptive string for the Criterion.

dimension

Criterion ID (Id)

string

ID of the main object of this row.

dimension

Criterion serving status (SystemServingStatus)

string

Serving status of the criterion.

dimension

Cross-device conv. (CrossDeviceConversions)

float

Conversions from when a customer clicks on an ad on one device; then converts on a different device or browser. Cross-device conversions are already included in your AllConversions column. This field is formatted with dot (

metric

Currency (AccountCurrencyCode)

string

The currency of the Customer account.

dimension

Custom label 0 (CustomAttribute0)

string

The ProductCustomAttribute level 0 value of the product.

dimension

Custom label 1 (CustomAttribute1)

string

The ProductCustomAttribute level 1 value of the product.

dimension

Custom label 2 (CustomAttribute2)

string

The ProductCustomAttribute level 2 value of the product.

dimension

Custom label 3 (CustomAttribute3)

string

The ProductCustomAttribute level 3 value of the product.

dimension

Custom label 4 (CustomAttribute4)

string

The ProductCustomAttribute level 4 value of the product.

dimension

Custom parameter (CreativeUrlCustomParameters)

string

List of custom parameters of the ad. CustomParameters elements are returned in JSON map format.

dimension

Custom parameter (UrlCustomParameters)

string

Custom URL parameters of the main object of this row. CustomParameters elements are returned in JSON map format.

dimension

Customer ID (ExternalCustomerId)

string

The Customer ID.

dimension

Day (Date)

string

The date formatted as yyyy-MM-dd.

dimension

Day of week (DayOfWeek)

string

The name of the day of the week; e.g.;

dimension

Days to conversion (ConversionLagBucket)

string

Days between click and conversion.

dimension

Days to conversion or adjustment (ConversionAdjustmentLagBucket)

string

The number of days between the impression and the conversion or between the impression and adjustments to the conversion.

dimension

Default max. CPC (CpcBid)

string

Cost per click bid. Values can be one of: a) a money amount in micros; b)

dimension

Delivery method (DeliveryMethod)

string

Budget delivery method. Determines the rate at which the budget is spent.

dimension

Description (Description)

string

The descriptive text of an expanded text ad or responsive display ad.

dimension

Description line 1 (Description1)

string

Line 1 description of the Ad.

dimension

Description line 2 (Description2)

string

Line 2 description of the Ad.

dimension

Descriptions (multi asset responsive display) (MultiAssetResponsiveDisplayAdDescriptions)

string

The descriptions setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and TextAsset entities. List elements are returned in JSON list format.

dimension

Desktop bid adj. (AdGroupDesktopBidModifier)

string

Desktop bid modifier override at the ad group level.

dimension

Desktop bid adj. (CampaignDesktopBidModifier)

float

Desktop bid modifier override at the campaign level.

metric

Destination URL (CreativeDestinationUrl)

string

Destination URL of the ad.

dimension

Destination URL (CriteriaDestinationUrl)

string

Destination URL of the criterion that triggered ads.

dimension

Destination URL (DestinationUrl)

string

Destination URL for the impression.

dimension

Device (Device)

string

Device type where the impression was shown.

dimension

Device preference (DevicePreference)

long

Platform ID of the device preference. You can look up the corresponding name and other information in the Platforms reference.

metric

Disapproval reasons (DisapprovalShortNames)

string

List of reasons why the FeedItem is not approved.List elements are returned in JSON list format.

dimension

Display URL (DisplayUrl)

string

Display URL of the Ad.

dimension

Distance from location extensions (DistanceBucket)

string

Grouping of user distance from location extensions.

dimension

Domain (Domain)

string

The domain of the URL (placement) where the impression was shown.

dimension

Duration (seconds) (CallDuration)

string

The duration of the call; in seconds.

dimension

Dynamic ad target (Parameter)

string

The WebpageParameter criterion.

dimension

Dynamically generated Headline (Line1)

string

The dynamically generated headline of the Dynamic Search Ad.

dimension

End date (EndDate)

string

The end date of the campaign; formatted as yyyy-MM-dd.

dimension

End date (EndTime)

string

The end time in which the FeedItem is no longer effective and will stop serving

dimension

End date (FeedItemEndTime)

string

End time at which the FeedItem is no longer effective and will stop serving.

dimension

End time (CallEndTime)

string

The end date and time of the call.

dimension

Engagement rate (EngagementRate)

percentage

How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. Percentage returned as

metric

Engagements (Engagements)

float

The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also; in the future; other ad types may support engagement metrics.

metric

Enhanced CPC enabled (EnhancedCpcEnabled)

string

Indicates if enhanced CPC is enabled on the bidding strategy.

dimension

Est. add. clicks/wk (first position bid) (EstimatedAddClicksAtFirstPositionCpc)

string

Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.

dimension

Est. add. cost/wk (first position bid) (EstimatedAddCostAtFirstPositionCpc)

currency

Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.Values can be one of: a) a money amount in micros; b)

metric

Estimated change in weekly clicks at recommended Budget (RecommendedBudgetEstimatedChangeInWeeklyClicks)

float

The estimated change in weekly clicks if the recommended budget is applied.

metric

Estimated change in weekly cost at recommended Budget (RecommendedBudgetEstimatedChangeInWeeklyCost)

currency

The estimated change in weekly cost if the recommended budget is applied.Values can be one of: a) a money amount in micros; b)

metric

Estimated change in weekly interactions at recommended Budget (RecommendedBudgetEstimatedChangeInWeeklyInteractions)

float

The estimated change in weekly interactions if the recommended budget is applied.

metric

Estimated change in weekly views at recommended Budget (RecommendedBudgetEstimatedChangeInWeeklyViews)

float

The estimated change in weekly views if the recommended budget is applied.

metric

Excluded (IsPathExcluded)

string

Indicates if the URL or placement is currently excluded.

dimension

Exclusion (Criteria)

string

Descriptive string for the Criterion.

dimension

Expanded Dynamic Search Ad Description 2 (ExpandedDynamicSearchCreativeDescription2)

string

The description 2 of the expanded dynamic search ad.

dimension

Expanded Text Ad Description 2 (ExpandedTextAdDescription2)

string

The description 2 of the expanded text ad.

dimension

Expanded Text Ad Headline 3 (ExpandedTextAdHeadlinePart3)

string

The headline part 3 of the expanded text ad.

dimension

Expanded landing page (ExpandedFinalUrlString)

string

The final URL with ValueTrack parameters replaced with their final rendered values.

dimension

Expected clickthrough rate (SearchPredictedCtr)

string

Clickthrough rate compared to that of other advertisers.

dimension

Explicitly shared (IsBudgetExplicitlyShared)

boolean

Indicates if the budget is a shared budget (true) or specific to the campaign (false).

dimension

Feed ID (FeedId)

string

The Feed ID.

dimension

Feed placeholder type (ExtensionPlaceholderType)

string

Placeholder type indicating the type of extension.

dimension

Feed placeholder type (PlaceholderType)

string

Placeholder type indicating the type of extension.

dimension

Final URL (CreativeFinalUrls)

string

List of final URLs of the ad. List elements are returned in JSON list format.

dimension

Final URL (EffectiveFinalUrl)

string

Effective final URL of the impressions.

dimension

Final URL (FinalUrl)

string

Final URL of the impressions.

dimension

Final URL (FinalUrls)

string

List of final URLs of the main object of this row.UrlList elements are returned in JSON list format.

dimension

Final URL suffix (CreativeFinalUrlSuffix)

string

The URL template for appending params to final URL of an ad.

dimension

Final URL suffix (FinalUrlSuffix)

string

URL template for appending params to final URL.

dimension

First level sub-categories (Category1)

string

First level theme category of the pages in your website domain.

dimension

First page CPC (FirstPageCpc)

string

Estimate of the CPC bid required in order to show your ad on the first page of search results.Usually a number in micros; but may be prefixed with

dimension

First position CPC (FirstPositionCpc)

string

Estimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.Usually a number in micros; but may be prefixed with

dimension

Free click rate (CreativeConversionRate)

percentage

The number of clicks that converted divided by your total clicks that can be tracked to a conversion. This is how often a click on your ad resulted in a conversion. Percentage returned as

metric

Free click type (ConversionTrackerId)

float

ID of the conversion tracker.

metric

Free clicks (CreativeConversions)

float

The number of clicks that converted within your chosen conversion window.

metric

Gender (Criteria)

string

Descriptive string for the Criterion. For more information on the format of criteria types in reports

dimension

Gender state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Gmail ad business name (GmailTeaserBusinessName)

string

The business name in the GmailAd teaser.

dimension

Gmail ad description (GmailTeaserDescription)

string

The description in the GmailAd teaser.

dimension

Gmail ad header image media id (GmailCreativeHeaderImageMediaId)

string

The ID of the header image in the GmailAd.

dimension

Gmail ad headline (GmailTeaserHeadline)

string

The headline in the GmailAd teaser.

dimension

Gmail ad logo image media id (GmailCreativeLogoImageMediaId)

string

The ID of the logo image in the GmailAd teaser.

dimension

Gmail ad marketing image call to action text (MarketingImageCallToActionText)

string

The call-to-action text for the GmailAd.

dimension

Gmail ad marketing image call to action text color (MarketingImageCallToActionTextColor)

string

The call-to-action text color for the GmailAd.

dimension

Gmail ad marketing image description (MarketingImageDescription)

string

The description of the marketing image in the GmailAd.

dimension

Gmail ad marketing image headline (MarketingImageHeadline)

string

The headline of the marketing image in the GmailAd.

dimension

Gmail ad marketing image media id (GmailCreativeMarketingImageMediaId)

string

The ID of the marketing image in the GmailAd.

dimension

Gmail clicks to website (GmailSecondaryClicks)

long

The number of clicks to your landing page on the expanded state of Gmail ads.

metric

Gmail forwards (GmailForwards)

long

The number of times your ad was forwarded to someone else as a message.

metric

Gmail saves (GmailSaves)

long

The number of times someone has saved your Gmail ad to their inbox as a message.

metric

Google Click ID (GclId)

string

The Google Click ID.

dimension

Has Quality Score (HasQualityScore)

string

Whether the QualityScore field of the criterion has value. Use this field in a report request predicate to include or exclude criteria with or without a value for the QualityScore field.

dimension

Has recommended Budget (HasRecommendedBudget)

string

Whether there is a recommended budget for this object.

dimension

Headline 1 (HeadlinePart1)

string

The first part of an expanded text ad headline.

dimension

Headline 2 (HeadlinePart2)

string

The second part of an expanded text ad headline.

dimension

Headlines (multi asset responsive display) (MultiAssetResponsiveDisplayAdHeadlines)

string

The headline setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and TextAsset entities. List elements are returned in JSON list format.

dimension

Hour of day (HourOfDay)

long

The hour of day as a number between 0 and 23; inclusive.

metric

Image Ad URL (ImageAdUrl)

string

Prefix this value with

dimension

Image Height (ImageCreativeImageHeight)

long

The height of the image ad. For other ad types; this will have no values.

metric

Image ID (responsive) (EnhancedDisplayCreativeMarketingImageMediaId)

string

The ID of the marketing image used in the ResponsiveDisplayAd.

dimension

Image Mime Type (ImageCreativeMimeType)

long

Image mime type. Only populated for image ads.

metric

Image Width (ImageCreativeImageWidth)

long

The width of the image ad. For other ad types; this will have no values.

metric

Image ad name (ImageCreativeName)

string

Name for the image ad.

dimension

Images (multi asset responsive display) (MultiAssetResponsiveDisplayAdMarketingImages)

string

The marketingImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

dimension

Impr. (Abs. Top) % (AbsoluteTopImpressionPercentage)

float

The percent of your ad impressions that are shown as the very first ad above the organic search results. See this Help Center article for details. A percentage returned as

metric

Impr. (Top) % (TopImpressionPercentage)

currency

The percent of your ad impressions that are shown anywhere above the organic search results. See this Help Center article for details. A percentage returned as

metric

Impr. Assisted Conv. (ImpressionAssistedConversions)

currency

Total number of conversions for which this object triggered assist impressions prior to the last click.

metric

Impr. Assisted Conv. / Last Click Conv. (ImpressionAssistedConversionsOverLastClickConversions)

long

Total number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.

metric

Impr. Assisted Conv. Value (ImpressionAssistedConversionValue)

currency

Total value of all conversions for which this object triggered assist impressions.

metric

Impressions (Impressions)

long

Count of how often your ad has appeared on a search results page or website on the Google Network.

metric

Interaction Rate (InteractionRate)

percentage

How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. Percentage returned as

metric

Interaction Types (InteractionTypes)

string

The types of interactions that are reflected in the Interactions; InteractionRate; and AverageCost columns.

dimension

Interactions (Interactions)

long

The number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads; views for video ads; and so on.

metric

Invalid click rate (InvalidClickRate)

percentage

The percentage (

metric

Invalid clicks (InvalidClicks)

long

Number of clicks Google considers illegitimate and doesn't charge you for.

metric

Is Targetable (IsTargetingLocation)

string

Indicates whether the row's location (among all of the locations associated with an impression) was the targeting location for the impressions in that row.

dimension

Is negative (IsNegative)

string

Indicates if the criterion for this row is a negative (exclusion) criterion.

dimension

Is restricting (IsRestrict)

string

A value of 'true' indicates that the criterion type is used for bidding and restricting targeting. A value of 'false' indicates that the criterion type is used only for bidding. This will have the opposite value from that of targetAll for the criteria's corresponding AdGroup.TargetingSettingDetail. For example; if the TargetingSettingDetail for criterionTypeGroup = PLACEMENT has targetAll = true; then the IsRestrict field will be false for Placement criteria.

dimension

Item ID (FeedItemId)

string

The FeedItem ID.

dimension

Item Id (OfferId)

string

Offer/item ID of the product.

dimension

Item state (FeedItemStatus)

string

Status of the FeedItem.

dimension

Item state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Keyword (Criteria)

string

Descriptive string for the Criterion. For more information on the format of criteria types in reports

dimension

Keyword (KeywordTextMatchingQuery)

string

Keyword that matched the query and triggered the ad.

dimension

Keyword / Placement (Criteria)

string

Descriptive string for the Criterion. For more information on the format of criteria types in reports; see the Criteria prefixes section of the reporting guide.

dimension

Keyword / Placement (CriteriaParameters)

string

Descriptive string for the Criterion. For more information on the format of criteria types in reports; see the Criteria prefixes section of the reporting guide.

dimension

Keyword ID (CriteriaId)

string

The Criterion ID.

dimension

Keyword ID (CriterionId)

string

The Criterion ID.

dimension

Keyword ID (Id)

string

ID of the main object of this row.

dimension

Keyword ID (KeywordId)

string

The ID of the Keyword that triggered the ad.

dimension

Keyword ID (KeywordTargetingId)

string

The ID of the feed item's keyword targeting.

dimension

Keyword state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Keyword/Placement destination URL (CriteriaDestinationUrl)

string

Destination URL of the criterion that triggered ads.

dimension

Keyword/Placement state (AdGroupCriterionStatus)

string

Status of the ad group criterion (keyword; placement; etc.).

dimension

Keyword/Placement state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Keywords (AdGroupCriteriaCount)

long

The count of AdGroupCriterion objects using the bidding strategy or label.

metric

Label ID (LabelId)

string

The ID of the Label.

dimension

Label IDs (LabelIds)

string

List of label IDs for the main object of this row. List elements are returned in JSON list format.

dimension

Label name (LabelName)

string

The name of the Label.

dimension

Labels (Labels)

string

List of label names for the main object of this row. List elements are returned in JSON list format.

dimension

Landing Page Title (Title)

string

Title of the landing page.

dimension

Landing page (UnexpandedFinalUrlString)

string

The final URL with ValueTrack parameter templates left in place.

dimension

Landing page experience (PostClickQualityScore)

string

The quality score of the landing page.

dimension

Landscape logo ID (responsive) (EnhancedDisplayCreativeLandscapeLogoImageMediaId)

string

The ID of the landscape logo image.

dimension

Landscape logos (multi asset responsive display) (MultiAssetResponsiveDisplayAdLandscapeLogoImages)

string

The landscapeLogoImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

dimension

Language (LanguageCriteriaId)

string

Language of the product information.

dimension

Limited budgets (Target search page location) (PageOnePromotedRaiseBidWhenBudgetConstrained)

string

Whether the PageOnePromoted strategy is allowed to raise bids if the campaign is

dimension

Location (Id)

string

ID of the main object of this row.

dimension

Location (Target search page location) (PageOnePromotedStrategyGoal)

string

Strategy goal of where impressions will show on search result pages.

dimension

Location type (LocationType)

string

The type of location. AREA_OF_INTEREST indicates a location that was searched for; or a location derived from viewed content. LOCATION_OF_PRESENCE is the actual physical location of the user.

dimension

Logo ID (responsive) (EnhancedDisplayCreativeLogoImageMediaId)

string

The ID of the logo image used in the ResponsiveDisplayAd.

dimension

Logos (multi asset responsive display) (MultiAssetResponsiveDisplayAdLogoImages)

string

The logoImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

dimension

Long headline (LongHeadline)

string

The long format of the headline in a responsive display ad.

dimension

Long headline (multi asset responsive display) (MultiAssetResponsiveDisplayAdLongHeadline)

string

The callToActionText setting for a MultiAssetResponsiveDisplayAd. AssetLink object is returned in JSON map format.

dimension

Low quality keywords (Target Outranking Share) (TargetOutrankShareRaiseBidWhenLowQualityScore)

string

Whether the TargetRoas strategy is allowed to raise bids on keywords with lower-range quality scores.

dimension

Low quality keywords (Target search page location) (PageOnePromotedRaiseBidWhenLowQualityScore)

string

Whether the PageOnePromoted strategy is allowed to raise bids on keywords with lower-range quality scores.

dimension

Lower Bid limit (Target CPA) (TargetCpaMaxCpcBidFloor)

currency

The minimum CPC bid limit for the Target CPA bidding strategy.

metric

Lower Bid limit (Target ROAS) (TargetRoasBidFloor)

currency

Minimum bid limit that applies to all keywords managed by the TargetRoas BiddingStrategyConfiguration.

metric

MC Id (MerchantId)

string

ID of the Google Merchant Center account associated with the products being advertised.

dimension

MCA Id (AggregatorId)

string

The multi-client account ID from Merchant Center.

dimension

Main color (multi asset responsive display) (MultiAssetResponsiveDisplayAdMainColor)

string

The mainColor setting for a MultiAssetResponsiveDisplayAd.

dimension

Main color (responsive) (MainColor)

string

The main color for the responsive display ad.

dimension

Match type (CriteriaTypeName)

string

The descriptive name of the CriteriaType.

dimension

Match type (KeywordMatchType)

string

The match type for the Keyword.

dimension

Match type (QueryMatchType)

string

Match type of the keyword that triggered the ad.

dimension

Match type (QueryMatchTypeWithVariant)

string

Match type of the keyword that triggered the ad; including variants. See https://support.google.com/google-ads/answer/2472708 for an explanation of close variants.

dimension

Max CPC source (CpcBidSource)

string

Source of the CPC bid.

dimension

Max CPM Source (CpmBidSource)

string

Source of the CPM bid.

dimension

Max CPV source (CpvBidSource)

string

The source of the cost per view bid.

dimension

Max. CPC (CpcBid)

string

Cost per click bid. Values can be one of: a) a money amount in micros; b)

dimension

Max. CPM (CpmBid)

string

CPM (cost per thousand impressions) bid.Values can be one of: a) a money amount in micros; b)

dimension

Max. CPV (CpvBid)

string

Cost per view bid.Values can be one of: a) a money amount in micros; b)

dimension

Member Count (MemberCount)

float

The number of entities in the shared set.

metric

Metro area (Location of interest) (AoiMetroCriteriaId)

string

ID of the metro area of the Location criterion matching the area of interest (AOI) associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Metro area (MetroCriteriaId)

string

ID of the metro area Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Metro area (Physical location) (LopMetroCriteriaId)

string

ID of the metro area of the Location criterion matching the location of presence (LOP) associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Mobile bid adj. (AdGroupMobileBidModifier)

string

Mobile bid modifier override at ad group level.

dimension

Mobile bid adj. (CampaignMobileBidModifier)

float

Mobile bid modifier of the campaign. To filter by this field; use values greater than 0 and less than or equal to 1. Percentage returned as

metric

Mobile final URL (CreativeFinalMobileUrls)

string

List of final mobile URLs of the ad. List elements are returned in JSON list format.

dimension

Mobile final URL (FinalMobileUrls)

string

List of final mobile URLs of the main object of this row.UrlList elements are returned in JSON list format.

dimension

Mobile speed score (SpeedScore)

float

A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10; 10 being fastest.

metric

Mobile-friendly click rate (PercentageMobileFriendlyClicks)

percentage

The percentage of mobile clicks that go to a mobile-friendly page.

metric

Month (Month)

string

The first day of the month; formatted as yyyy-MM-dd.

dimension

Month of Year (MonthOfYear)

string

The name of the month of the year; e.g.;

dimension

Most specific location (MostSpecificCriteriaId)

string

ID of the most specific Location criterion associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Most specific location target (Location of interest) (AoiMostSpecificTargetId)

string

The most specific location target (Location of interest).

dimension

Most specific location target (Physical location) (LopMostSpecificTargetId)

string

The most specific location target (Physical location).

dimension

Negative keyword (Criteria)

string

Descriptive string for the Criterion.

dimension

Network (AdNetworkType1)

string

First level network type.

dimension

Network (with search partners) (AdNetworkType2)

string

Second level network type (includes search partners).

dimension

Non-Removed Ad Groups (NonRemovedAdGroupCount)

float

The count of non-removed ad groups using the bidding strategy.

metric

Non-Removed Campaigns (NonRemovedCampaignCount)

float

The count of non-removed campaigns using the bidding strategy.

metric

Non-Removed Keywords (NonRemovedAdGroupCriteriaCount)

float

The count of non-removed ad group criteria using the bidding strategy.

metric

Organic Average Position (OrganicAveragePosition)

float

Average top position of your organic listing (or multiple listings) for each query. This field is formatted with dot (

metric

Organic Clicks (OrganicClicks)

float

Number of times someone clicked your site's listing in the unpaid results for a particular query.

metric

Organic Clicks/Query (OrganicClicksPerQuery)

float

Number of clicks you've received on your organic search listings divided by the total number of searches that returned pages from your site. This field is formatted with dot (

metric

Organic Listings (OrganicImpressions)

float

Number of organic search listing impressions.

metric

Organic Listings/Query (OrganicImpressionsPerQuery)

float

Average number of times a page from your site was listed per query. This field is formatted with dot (

metric

Organic Queries (OrganicQueries)

float

Total number of searches that returned organic search results for your site over the given period.

metric

PTR (OfflineInteractionRate)

percentage

Number of phone calls received (NumOfflineInteractions) divided by the number of times your phone number is shown (NumOfflineImpressions).

metric

Page (Page)

string

Page number in search results where the ad was shown.

dimension

Pages / session (AveragePageviews)

float

Average number of pages viewed per session. Imported from Google Analytics.

metric

Parent Criterion ID (ParentCriterionId)

string

Criterion ID of the product partition's parent.

dimension

Parental status (Criteria)

string

Descriptive string for the Criterion.

dimension

Parental status state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Partition Type (PartitionType)

string

The partition type of the ProductPartition criterion.

dimension

Path 1 (Path1)

string

The text that appears in the ad with the displayed URL for an expanded text ad.

dimension

Path 2 (Path2)

string

In addition to

dimension

Phone calls (NumOfflineInteractions)

currency

Number of offline phone calls.

metric

Phone impressions (NumOfflineImpressions)

currency

Number of offline phone impressions.

metric

Placement (Criteria)

string

Descriptive string for the Criterion.

dimension

Placement state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Policy (PolicySummary)

string

Policy information for an ad.

dimension

Price prefix (multi asset responsive display) (MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix)

string

The dynamicSettingsPricePrefix setting for a MultiAssetResponsiveDisplayAd.

dimension

Price prefix (responsive) (PricePrefix)

string

The prefix shown before prices.

dimension

Product Group (ProductGroup)

string

Path to the ProductPartition; including all of its parent partitions.

dimension

Product Title (ProductTitle)

string

The title of the product.

dimension

Product type (1st level) (ProductTypeL1)

string

The ProductType level 1 value of the product.

dimension

Product type (2nd level) (ProductTypeL2)

string

The ProductType level 2 value of the product.

dimension

Product type (3rd level) (ProductTypeL3)

string

The ProductType level 3 value of the product.

dimension

Product type (4th level) (ProductTypeL4)

string

The ProductType level 4 value of the product.

dimension

Product type (5th level) (ProductTypeL5)

string

The ProductType level 5 value of the product.

dimension

Promotion text (multi asset responsive display) (MultiAssetResponsiveDisplayAdDynamicSettingsPromoText)

string

The dynamicSettingsPromoText setting for a MultiAssetResponsiveDisplayAd.

dimension

Promotion text (responsive) (PromoText)

string

The promotion text for the responsive display ad.

dimension

Quality score (QualityScore)

string

The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). If quality score information is missing; then

dimension

Quarter (Quarter)

string

The first day of the quarter; formatted as yyyy-MM-dd. Uses the calendar year for quarters; e.g.; the second quarter of 2014 starts on 2014-04-01.

dimension

Query (SearchQuery)

string

Query that led to the impression.

dimension

Recommended Budget amount (RecommendedBudgetAmount)

currency

The recommended budget amount.

metric

Reference Count (ReferenceCount)

float

The number of campaigns that actively use the shared set.

metric

Region (Location of interest) (AoiRegionCriteriaId)

string

ID of the region of the Location criterion matching the area of interest (AOI) associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Region (Physical location) (LopRegionCriteriaId)

string

ID of the region of the Location criterion matching the location of presence (LOP) associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Region (RegionCriteriaId)

string

ID of the region Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

dimension

Relative CTR (RelativeCtr)

currency

Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites.

metric

Responsive Search Ad descriptions (ResponsiveSearchAdDescriptions)

string

A JSON string including details about all descriptive text for a responsive search ad; including the asset text; pinning; and performance label. List elements are returned in JSON list format.

dimension

Responsive Search Ad headlines (ResponsiveSearchAdHeadlines)

string

A JSON string including details about all headlines for a responsive search ad; including the asset text; pinning; and performance label. List elements are returned in JSON list format.

dimension

Responsive Search Ad path 1 (ResponsiveSearchAdPath1)

string

The text that appears in the ad with the displayed URL for a responsive search ad.

dimension

Responsive Search Ad path 2 (ResponsiveSearchAdPath2)

string

In addition to

dimension

Scheduling (Scheduling)

string

Schedule specifying when the FeedItem may serve.FeedItemScheduling elements are returned in JSON list format.

dimension

Search Exact match IS (SearchExactMatchImpressionShare)

percentage

The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword); regardless of your keyword match types. A percentage returned as

metric

Search Impr. share (SearchImpressionShare)

percentage

The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. A percentage returned as

metric

Search Lost IS (budget) (SearchBudgetLostImpressionShare)

percentage

The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. A percentage returned as

metric

Search Lost IS (rank) (SearchRankLostImpressionShare)

percentage

The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. A percentage returned as

metric

Search Result Type (SerpType)

string

The type of search result.

dimension

Search abs. top IS (SearchAbsoluteTopImpressionShare)

percentage

The impressions you've received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location. See this Help Center article for details. A percentage returned as

metric

Search lost abs. top IS (budget) (SearchBudgetLostAbsoluteTopImpressionShare)

percentage

The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. See this Help Center article for details. A percentage returned as

metric

Search lost abs. top IS (rank) (SearchRankLostAbsoluteTopImpressionShare)

percentage

The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. See this Help Center article for details. A percentage returned as

metric

Search lost top IS (budget) (SearchBudgetLostTopImpressionShare)

percentage

The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. See this Help Center article for details. A percentage returned as

metric

Search lost top IS (rank) (SearchRankLostTopImpressionShare)

percentage

The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. See this Help Center article for details. A percentage returned as

metric

Search term (Query)

string

If the string for this attribute is longer than 128 char bytes; the returned result will NOT be a single aggregated row.

dimension

Search top IS (SearchTopImpressionShare)

percentage

The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. See this Help Center article for details. A percentage returned as

metric

Second level sub-categories (Category2)

string

Second level theme category of the pages in your website domain.

dimension

Shared Set ID (SharedSetId)

string

The ID of the SharedSet.

dimension

Shared Set Name (Name)

string

The name of the main object in this row. For example; in a Campaign Performance Report this will be the name of each row's Campaign. In an Ad Group Performance Report this will be the name of each row's AdGroup.

dimension

Shared Set Name (SharedSetName)

string

The name of the SharedSet.

dimension

Shared Set Type (SharedSetType)

string

The type of the SharedSet.

dimension

Shared Set Type (Type)

string

The type of the main object in this row. For example; in a Bid Goal Performance Report this will be the type of the BiddingStrategyConfiguration. In a Shared Set Report this will be the type of the SharedSet.

dimension

Short headline (ShortHeadline)

string

The short format of the headline in a responsive display ad.

dimension

Square image ID (responsive) (EnhancedDisplayCreativeMarketingImageSquareMediaId)

string

The ID of the square marketing image.

dimension

Square images (multi asset responsive display) (MultiAssetResponsiveDisplayAdSquareMarketingImages)

string

The squareMarketingImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

dimension

Start date (FeedItemStartTime)

string

Start time when the FeedItem is effective and can begin serving.

dimension

Start date (StartDate)

string

The start date of the campaign; formatted as yyyy-MM-dd

dimension

Start date (StartTime)

string

The start time in which the FeedItem is effective and can begin serving.

dimension

Start time (CallStartTime)

string

The start date and time of the call.

dimension

State (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Status (CallStatus)

string

The status of the call.

dimension

Store Id (StoreId)

string

Store ID of the product.

dimension

System managed Entity Source (SystemManagedEntitySource)

string

Indicates the source of a system-generated entity.

dimension

Tablet bid adj. (AdGroupTabletBidModifier)

string

Tablet bid modifier override at the ad group level.

dimension

Tablet bid adj. (CampaignTabletBidModifier)

float

Tablet bid modifier override at the campaign level.

metric

Target CPA (TargetCpa)

float

The current target CPA set on the Target CPA bidding strategy.

metric

Target CPA source (TargetCpaBidSource)

string

The level at which the target CPA bid was set. This is applicable only at the ad group level.

dimension

Target ROAS (EffectiveTargetRoas)

string

The effective target ROAS; taking overrides into account.

dimension

Target ROAS (Maximize Conversion Value) (MaximizeConversionValueTargetRoas)

currency

The target ROAS that was set for maximizing revenue while averaging the target return on ad spend.

metric

Target ROAS (TargetRoas)

float

The desired revenue (based on conversion data) per unit of spend for the TargetRoas BiddingStrategyConfiguration.

metric

Target ROAS Source (EffectiveTargetRoasSource)

string

The source of the effective target ROAS; taking overrides into account.

dimension

Target ad group ID (TargetingAdGroupId)

string

Ad group ID of the feed item's adGroupTargeting.

dimension

Target campaign ID (TargetingCampaignId)

string

Campaign ID of the feed item's campaignTargeting.

dimension

Target keyword match type (KeywordMatchType)

string

The match type for the Keyword.

dimension

Target keyword match type (KeywordTargetingMatchType)

string

Match type of the feed item's keywordTargeting.

dimension

Target keyword text (Criteria)

string

Descriptive string for the Criterion.

dimension

Target keyword text (KeywordTargetingText)

string

Text of the feed item's keywordTargeting.

dimension

Target location (GeoTargetingCriterionId)

string

Location ID of the feed item's geoTargeting.

dimension

Target location restriction (GeoTargetingRestriction)

string

The type of location that can be used for targeting.

dimension

Target outranking share (TargetOutrankShare)

percentage

Target fraction of auctions where the advertiser should outrank the competitor.

metric

Target spend (Maximize clicks) (TargetSpendSpendTarget)

currency

The spend target under which to maximize clicks. Specified by the TargetSpend BiddingStrategyConfiguration.

metric

Targeting Mode (IsAutoOptimized)

string

Indicates if Display Campaign Optimizer is enabled for the ad group. Corresponds to the ad group's ExplorerAutoOptimizerSetting.

dimension

Test account (IsTestAccount)

string

Indicates if the account is a test account.

dimension

This extension vs. Other (IsSelfAction)

string

Indicates if the extension for the placeholder feed item of this row was clicked (true) or merely displayed (false).

dimension

Time zone (AccountTimeZone)

string

Name of the timezone selected for the Customer account. For example:

dimension

Top level categories (Category0)

string

Top level theme category of the pages in your website domain.

dimension

Top of page CPC (TopOfPageCpc)

string

Estimate of the CPC bid required in order to show your ad on the top of the first page of search results.Usually a number in micros; but may be prefixed with

dimension

Top vs. Other (Slot)

string

The position of the Ad.

dimension

Topic (Criteria)

string

Descriptive string for the Criterion. For more information on the format of criteria types in reports

dimension

Topic state (Status)

string

The status of the main object in this row. For example; in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

dimension

Total Budget amount (TotalAmount)

currency

The total budget amount; if you set a campaign's total budget in the Google Ads UI. Currently; campaign total budgets are only available for video campaigns with a specific start and end date. See this Help Center article to learn more about this option.

metric

Total conv. value (ConversionValue)

currency

The sum of conversion values for all conversions. This field is formatted with dot (

metric

Tracking template (CreativeTrackingUrlTemplate)

string

Tracking template of the ad.

dimension

Tracking template (EffectiveTrackingUrlTemplate)

string

Effective tracking URL of the impressions.

dimension

Tracking template (TrackingUrlTemplate)

string

Tracking template of the main object of this row.

dimension

URL (CriteriaParameters)

string

Descriptive string for the Criterion.

dimension

URL (Url)

string

The dynamically selected destination URL of the impression.

dimension

Unique cookies (ImpressionReach)

float

Number of unique cookies that were exposed to your ad over a given time period; or the special value

metric

Universal App Ad descriptions (UniversalAppAdDescriptions)

string

The list of descriptions of the Universal App ad. List elements are returned in JSON list format.

dimension

Universal App Ad headlines (UniversalAppAdHeadlines)

string

The list of headers of the Universal App ad. List elements are returned in JSON list format.

dimension

Universal App Ad html5 media bundles (UniversalAppAdHtml5MediaBundles)

string

The HTML5 media bundles attached to the ad. List elements are returned in JSON list format.

dimension

Universal App Ad images (UniversalAppAdImages)

string

The marketing images attached to the ad. List elements are returned in JSON list format.

dimension

Universal App Ad mandatory ad text (UniversalAppAdMandatoryAdText)

string

The ad text that must be displayed when the ad is served.

dimension

Universal App Ad youTube videos (UniversalAppAdYouTubeVideos)

string

The YouTube videos attached to the ad. List elements are returned in JSON list format.

dimension

Upper Bid limit (Target CPA) (TargetCpaMaxCpcBidCeiling)

currency

The maximum CPC bid limit for the Target CPA bidding strategy.

metric

Upper Bid limit (Target ROAS) (TargetRoasBidCeiling)

currency

Maximum bid limit that applies to all keywords managed by the TargetRoas BiddingStrategyConfiguration.

metric

Upper Max Cpc Bid limit (Target Outranking Share) (TargetOutrankShareMaxCpcBidCeiling)

percentage

The TargetRoas strategy's ceiling on max CPC bids.

metric

User List ID (UserListId)

string

The ID of the UserList (audience).

dimension

User lists count (UserListsCount)

float

The count of UserList objects using the label.

metric

Valid AMP click rate (PercentageValidAcceleratedMobilePagesClicks)

percentage

The percentage of ad clicks to AMP (accelerated mobile pages) landing pages that reach a valid AMP page.

metric

Value / all conv. (ValuePerAllConversion)

currency

The value; on average; of all conversions. This field is formatted with dot (

metric

Value / conv. (ValuePerConversion)

currency

The total value of your conversions divided by the total number of conversions. This field is formatted with dot (

metric

Value / conv. (current model) (ValuePerCurrentModelAttributedConversion)

currency

Shows how your historic ValuePerConversion data would look under the attribution model you've currently selected. This field is formatted with dot (

metric

Vertical ID (VerticalId)

string

The ID of vertical.

dimension

Video Channel Id (VideoChannelId)

string

The video channel ID.

dimension

Video Duration (VideoDuration)

float

The duration of the video in milliseconds.

metric

Video Id (VideoId)

string

The video ID.

dimension

Video Title (VideoTitle)

string

The video title.

dimension

Video played to 100% (VideoQuartile100Rate)

percentage

Percentage of impressions where the viewer watched all of your video. Percentage returned as

metric

Video played to 25% (VideoQuartile25Rate)

percentage

Percentage of impressions where the viewer watched 25% of your video. Percentage returned as

metric

Video played to 50% (VideoQuartile50Rate)

percentage

Percentage of impressions where the viewer watched 50% of your video. Percentage returned as

metric

Video played to 75% (VideoQuartile75Rate)

percentage

Percentage of impressions where the viewer watched 75% of your video. Percentage returned as

metric

View rate (VideoViewRate)

percentage

The number of views your TrueView video ad receives divided by its number of impressions; including thumbnail impressions for TrueView in-display ads. Percentage returned as

metric

View-through conv. (ViewThroughConversions)

float

The total number of view-through conversions. These happen when a customer sees a Display network ad; then later completes a conversion on your site without interacting with (e.g. clicking on) another ad.

metric

Views (VideoViews)

long

The number of times your video ads were viewed.

metric

Week (Week)

string

The date for the Monday of the week; formatted as yyyy-MM-dd.

dimension

Year (Year)

string

The year; formatted as yyyy.

dimension

Youtube videos (multi asset responsive display) (MultiAssetResponsiveDisplayAdYouTubeVideos)

string

YouTube video ID of the YouTube assets of multi-asset responsive display ad. List elements are returned in JSON list format.

dimension

id (id)

string

ID of the main object of this row.

dimension

Account Budget adjusted spending limit

account_budget.adjusted_spending_limit_micros

dimension

Account Budget adjusted spending limit type

account_budget.adjusted_spending_limit_type

dimension

Account Budget amount served

account_budget.amount_served_micros

dimension

Account Budget approved end date time

account_budget.approved_end_date_time

dimension

Account Budget approved end time type

account_budget.approved_end_time_type

dimension

Account Budget approved spending limit

account_budget.approved_spending_limit_micros

dimension

Account Budget approved spending limit type

account_budget.approved_spending_limit_type

dimension

Account Budget approved start date time

account_budget.approved_start_date_time

dimension

Account Budget billing setup

account_budget.billing_setup

dimension

Account Budget ID

account_budget.id

dimension

Account Budget name

account_budget.name

dimension

Account Budget notes

account_budget.notes

dimension

Account Budget proposed end date time

account_budget.proposed_end_date_time

dimension

Account Budget proposed end time type

account_budget.proposed_end_time_type

dimension

Account Budget proposed spending limit

account_budget.proposed_spending_limit_micros

dimension

Account Budget proposed spending limit type

account_budget.proposed_spending_limit_type

dimension

Account Budget proposed start date time

account_budget.proposed_start_date_time

dimension

Account Budget PO Number

account_budget.purchase_order_number

dimension

Account Budget resource name

account_budget.resource_name

dimension

Account Budget status

account_budget.status

dimension

Account Budget total adjustments

account_budget.total_adjustments_micros

dimension

Ad rotation mode

ad_group.ad_rotation_mode

dimension

Base ad group ID

ad_group.base_ad_group

dimension

Ad group Campaign ID

ad_group.campaign

dimension

Default max. CPC

ad_group.cpc_bid_micros

dimension

Maximum CPM

ad_group.cpm_bid_micros

dimension

Maximum CPV

ad_group.cpv_bid_micros

dimension

Content network bid dimension

ad_group.display_custom_bid_dimension

dimension

Target CPA (ad group)

ad_group.effective_target_cpa_micros

dimension

Target CPA source

ad_group.effective_target_cpa_source

dimension

Target ROAS (ad group)

ad_group.effective_target_roas

dimension

Target ROAS source

ad_group.effective_target_roas_source

dimension

Ad group optimizer

ad_group.explorer_auto_optimizer_setting.opt_in

dimension

Ad group final URL template

ad_group.final_url_suffix

dimension

Ad group ID

ad_group.id

dimension

Ad group labels

ad_group.labels

dimension

Ad group

ad_group.name

dimension

Ad group CPC bid amount (%)

ad_group.percent_cpc_bid_micros

dimension

Ad group resource name

ad_group.resource_name

dimension

Ad group state

ad_group.status

dimension

Ad group target CPA

ad_group.target_cpa_micros

dimension

Ad group target CPM

ad_group.target_cpm_micros

dimension

Ad group target ROAS

ad_group.target_roas

dimension

Is restricting

ad_group.targeting_setting.target_restrictions

dimension

Ad group tracking URL template

ad_group.tracking_url_template

dimension

Ad group type

ad_group.type

dimension

Ad group URL custom parameters

ad_group.url_custom_parameters

dimension

Auto-applied ad suggestion

ad_group_ad.ad.added_by_google_ads

dimension

Universal app ad descriptions

ad_group_ad.ad.app_ad.descriptions

dimension

Universal app ad headlines

ad_group_ad.ad.app_ad.headlines

dimension

Universal app ad HTML5 media bundles

ad_group_ad.ad.app_ad.html5_media_bundles

dimension

Universal app ad images

ad_group_ad.ad.app_ad.images

dimension

Universal app ad mandatory ad text

ad_group_ad.ad.app_ad.mandatory_ad_text

dimension

Universal app ad Youtube videos

ad_group_ad.ad.app_ad.youtube_videos

dimension

App engagement ad descriptions

ad_group_ad.ad.app_engagement_ad.descriptions

dimension

App engagement ad headlines

ad_group_ad.ad.app_engagement_ad.headlines

dimension

App engagement ad images

ad_group_ad.ad.app_engagement_ad.images

dimension

App engagement ad videos

ad_group_ad.ad.app_engagement_ad.videos

dimension

Call only ad business name

ad_group_ad.ad.call_ad.business_name

dimension

Call only ad call tracked

ad_group_ad.ad.call_ad.call_tracked

dimension

Call only ad conversion action

ad_group_ad.ad.call_ad.conversion_action

dimension

Call only ad conversion reporting state

ad_group_ad.ad.call_ad.conversion_reporting_state

dimension

Call only ad country code

ad_group_ad.ad.call_ad.country_code

dimension

Call only ad disable call conversion

ad_group_ad.ad.call_ad.disable_call_conversion

dimension

Call only ad headline 1

ad_group_ad.ad.call_ad.headline1

dimension

Call only ad headline 2

ad_group_ad.ad.call_ad.headline2

dimension

Call only ad path 1

ad_group_ad.ad.call_ad.path1

dimension

Call only ad path 2

ad_group_ad.ad.call_ad.path2

dimension

Call only ad phone number

ad_group_ad.ad.call_ad.phone_number

dimension

Call only ad phone number verification URL

ad_group_ad.ad.call_ad.phone_number_verification_url

dimension

Call only ad description 1

ad_group_ad.ad.call_ad_ad.description1

dimension

Call only ad description 2

ad_group_ad.ad.call_ad_ad.description2

dimension

Device preference

ad_group_ad.ad.device_preference

dimension

Ad product type

ad_group_ad.ad.display_upload_ad.display_upload_product_type

dimension

Media bundle

ad_group_ad.ad.display_upload_ad.media_bundle

dimension

Display URL

ad_group_ad.ad.display_url

dimension

Expanded dynamic search ad description

ad_group_ad.ad.expanded_dynamic_search_ad.description

dimension

Expanded dynamic search ad description 2

ad_group_ad.ad.expanded_dynamic_search_ad.description2

dimension

Description

ad_group_ad.ad.expanded_text_ad.description

dimension

Expanded text ad description 2

ad_group_ad.ad.expanded_text_ad.description2

dimension

Headline 1

ad_group_ad.ad.expanded_text_ad.headline_part1

dimension

Headline 2

ad_group_ad.ad.expanded_text_ad.headline_part2

dimension

Expanded text ad headline 3

ad_group_ad.ad.expanded_text_ad.headline_part3

dimension

Path 1

ad_group_ad.ad.expanded_text_ad.path1

dimension

Path 2

ad_group_ad.ad.expanded_text_ad.path2

dimension

Final app URLs

ad_group_ad.ad.final_app_urls

dimension

Mobile final URL

ad_group_ad.ad.final_mobile_urls

dimension

Final URL suffix

ad_group_ad.ad.final_url_suffix

dimension

Final URL

ad_group_ad.ad.final_urls

dimension

Gmail ad header image media ID

ad_group_ad.ad.gmail_ad.header_image

dimension

Gmail ad marketing image media ID

ad_group_ad.ad.gmail_ad.marketing_image

dimension

Gmail ad marketing image headline

ad_group_ad.ad.gmail_ad.marketing_image_description

dimension

Gmail ad marketing image call to action text

ad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.text

dimension

Gmail ad marketing image call to action text color

ad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.text_color

dimension

Gmail ad URL collection ID

ad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.url_collection_id

dimension

Gmail ad marketing image description

ad_group_ad.ad.gmail_ad.marketing_image_headline

dimension

Gmail ad product images

ad_group_ad.ad.gmail_ad.product_images

dimension

Gmail ad product videos

ad_group_ad.ad.gmail_ad.product_videos

dimension

Gmail ad business name

ad_group_ad.ad.gmail_ad.teaser.business_name

dimension

Gmail ad description

ad_group_ad.ad.gmail_ad.teaser.description

dimension

Gmail ad headline

ad_group_ad.ad.gmail_ad.teaser.headline

dimension

Gmail ad logo image media ID

ad_group_ad.ad.gmail_ad.teaser.logo_image

dimension

Hotel ad details

ad_group_ad.ad.hotel_ad

dimension

Ad ID

ad_group_ad.ad.id

dimension

Image ad URL

ad_group_ad.ad.image_ad.image_url

dimension

Image mime type

ad_group_ad.ad.image_ad.mime_type

dimension

Image ad name

ad_group_ad.ad.image_ad.name

dimension

Image height

ad_group_ad.ad.image_ad.pixel_height

dimension

Image width

ad_group_ad.ad.image_ad.pixel_width

dimension

Image ad preview image URL

ad_group_ad.ad.image_ad.preview_image_url

dimension