ADO.NET Provider for Google Ads

Build 26.0.9655

Campaign

A campaign.

View-Specific Information

Select

Google Ads does not allow every column to be selected in a single query, as some data conflicts if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes are returned. In general, these defaults are the same fields that are exposed through the Ads console. To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause using the following supported operators: =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, NOT IN . Note that all filters must be joined by AND, as OR is not supported by the Ads API.

Columns

Name Type Behavior Description
CampaignAccessibleBiddingStrategy String ATTRIBUTE Output only. Resource name of AccessibleBiddingStrategy, a read-only view
CampaignAdServingOptimizationStatus String ATTRIBUTE The ad serving optimization status of the campaign.

The allowed values are CONVERSION_OPTIMIZE, OPTIMIZE, ROTATE, ROTATE_INDEFINITELY, UNAVAILABLE, UNKNOWN.

CampaignAdvertisingChannelSubType String ATTRIBUTE Immutable. Optional refinement to advertising_channel_type.

The allowed values are APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT, APP_CAMPAIGN_FOR_PRE_REGISTRATION, DISPLAY_EXPRESS, DISPLAY_GMAIL_AD, DISPLAY_MOBILE_APP, DISPLAY_SMART_CAMPAIGN, LOCAL_CAMPAIGN, SEARCH_EXPRESS, SEARCH_MOBILE_APP, SHOPPING_COMPARISON_LISTING_ADS, SHOPPING_SMART_ADS, SMART_CAMPAIGN, TRAVEL_ACTIVITIES, UNKNOWN, VIDEO_ACTION, VIDEO_NON_SKIPPABLE, VIDEO_REACH_TARGET_FREQUENCY, VIDEO_SEQUENCE, YOUTUBE_AUDIO.

CampaignAdvertisingChannelType String ATTRIBUTE Immutable. The primary serving target for ads within the campaign.

The allowed values are DEMAND_GEN, DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, TRAVEL, UNKNOWN, VIDEO.

CampaignAiMaxSettingBundlingRequired String ATTRIBUTE Output only. Indicates whether a search campaign has adopted AI Max before, and is required to have AI Max enabled to adopt campaign-level text asset automation and brand list targeting in all API versions.

The allowed values are NOT_REQUIRED, REQUIRED, UNKNOWN.

CampaignAiMaxSettingEnableAiMax Bool ATTRIBUTE Controls whether or not AI Max features are served for this campaign. Individual AI Max features are enabled or disabled by their respective settings. But if enable_ai_max is set to false or cleared, then no AI Max features will serve for this campaign, regardless of the other settings. Search Term Matching is enabled by default when AI Max is enabled, and can be disabled at the ad group level.
CampaignAppCampaignSettingAppId String ATTRIBUTE Immutable. A string that uniquely identifies a mobile application.
CampaignAppCampaignSettingAppStore String ATTRIBUTE Immutable. The application store that distributes this specific app.

The allowed values are APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN.

CampaignAppCampaignSettingBiddingStrategyGoalType String ATTRIBUTE Represents the goal which the bidding strategy of this app campaign should optimize towards.

The allowed values are OPTIMIZE_INSTALLS_TARGET_INSTALL_COST, OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST, OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST, OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST, OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA, OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME, OPTIMIZE_RETURN_ON_ADVERTISING_SPEND, OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS, UNKNOWN.

CampaignAssetAutomationSettings String ATTRIBUTE Contains the opt-in/out status of each AssetAutomationType.
CampaignAudienceSettingUseAudienceGrouped Bool ATTRIBUTE Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
CampaignBaseCampaign String ATTRIBUTE Output only. The resource name of the base campaign of a draft or
CampaignBiddingStrategy String ATTRIBUTE The resource name of the portfolio bidding strategy used by the campaign.
CampaignBiddingStrategySystemStatus String ATTRIBUTE Output only. The system status of the campaign's bidding strategy.

The allowed values are ENABLED, LEARNING_BUDGET_CHANGE, LEARNING_COMPOSITION_CHANGE, LEARNING_CONVERSION_SETTING_CHANGE, LEARNING_CONVERSION_TYPE_CHANGE, LEARNING_NEW, LEARNING_SETTING_CHANGE, LIMITED_BY_BUDGET, LIMITED_BY_CPC_BID_CEILING, LIMITED_BY_CPC_BID_FLOOR, LIMITED_BY_DATA, LIMITED_BY_INVENTORY, LIMITED_BY_LOW_PRIORITY_SPEND, LIMITED_BY_LOW_QUALITY, MISCONFIGURED_CONVERSION_SETTINGS, MISCONFIGURED_CONVERSION_TYPES, MISCONFIGURED_SHARED_BUDGET, MISCONFIGURED_STRATEGY_TYPE, MISCONFIGURED_ZERO_ELIGIBILITY, MULTIPLE, MULTIPLE_LEARNING, MULTIPLE_LIMITED, MULTIPLE_MISCONFIGURED, PAUSED, UNAVAILABLE, UNKNOWN.

CampaignBiddingStrategyType String ATTRIBUTE Output only. The type of bidding strategy.

The allowed values are COMMISSION, ENHANCED_CPC, FIXED_CPM, FIXED_SHARE_OF_VOICE, INVALID, MANUAL_CPA, MANUAL_CPC, MANUAL_CPM, MANUAL_CPV, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, PAGE_ONE_PROMOTED, PERCENT_CPC, TARGET_CPA, TARGET_CPC, TARGET_CPM, TARGET_CPV, TARGET_IMPRESSION_SHARE, TARGET_OUTRANK_SHARE, TARGET_ROAS, TARGET_SPEND, UNKNOWN.

CampaignBrandGuidelinesAccentColor String ATTRIBUTE The accent brand color, entered as a hex code (e.g., #00ff00). You must provide the accent_color if you provide a main_color.
CampaignBrandGuidelinesMainColor String ATTRIBUTE The main brand color, entered as a hex code (e.g., #00ff00). You must provide the main_color if you provide an accent_color.
CampaignBrandGuidelinesPredefinedFontFamily String ATTRIBUTE The brand's font family. Must be one of the following Google Fonts (case sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald, Playfair Display, Roboto Slab.
CampaignBrandGuidelinesEnabled Bool ATTRIBUTE Immutable. Whether Brand Guidelines are enabled for this Campaign.
CampaignCampaignBudget String ATTRIBUTE The resource name of the campaign budget of the campaign.
CampaignCampaignGroup String ATTRIBUTE The resource name of the campaign group that this campaign belongs to.
CampaignCommissionCommissionRateMicros Long ATTRIBUTE Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%).
CampaignContainsEuPoliticalAdvertising String ATTRIBUTE The advertiser should self-declare whether this campaign contains

The allowed values are CONTAINS_EU_POLITICAL_ADVERTISING, DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, UNKNOWN.

CampaignDemandGenCampaignSettingsUpgradedTargeting Bool ATTRIBUTE Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to true, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to true, and can only be set when creating a campaign.
CampaignDynamicSearchAdsSettingDomainName String ATTRIBUTE Required. The Internet domain name that this setting represents, for example, 'google.com' or 'www.google.com'.
CampaignDynamicSearchAdsSettingLanguageCode String ATTRIBUTE Required. The language code specifying the language of the domain, for example, 'en'.
CampaignDynamicSearchAdsSettingUseSuppliedUrlsOnly Bool ATTRIBUTE Whether the campaign uses advertiser supplied URLs exclusively.
CampaignEndDateTime Datetime ATTRIBUTE The last day and time of the campaign in serving customer's timezone in
CampaignExcludedParentAssetFieldTypes String ATTRIBUTE The asset field types that should be excluded from this campaign. Asset

The allowed values are AD_IMAGE, BOOK_ON_GOOGLE, BUSINESS_LOGO, BUSINESS_MESSAGE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION, CALL_TO_ACTION_SELECTION, DEMAND_GEN_CAROUSEL_CARD, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, HOTEL_PROPERTY, LANDING_PAGE_PREVIEW, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_DESCRIPTION, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOTION, RELATED_YOUTUBE_VIDEOS, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, TALL_PORTRAIT_MARKETING_IMAGE, UNKNOWN, VIDEO, YOUTUBE_VIDEO.

CampaignExcludedParentAssetSetTypes String ATTRIBUTE The asset set types that should be excluded from this campaign. Asset set

The allowed values are BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, HOTEL_PROPERTY, LOCATION_SYNC, MERCHANT_CENTER_FEED, PAGE_FEED, STATIC_LOCATION_GROUP, TRAVEL_FEED, UNKNOWN.

CampaignExperimentType String ATTRIBUTE Output only. The type of campaign: normal, draft, or experiment.

The allowed values are BASE, DRAFT, EXPERIMENT, UNKNOWN.

CampaignFeedTypes String ATTRIBUTE Output only. Types of feeds that are attached directly to this campaign.

The allowed values are BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, HOTEL_PROPERTY, LOCATION_SYNC, MERCHANT_CENTER_FEED, PAGE_FEED, STATIC_LOCATION_GROUP, TRAVEL_FEED, UNKNOWN.

CampaignFinalUrlSuffix String ATTRIBUTE Suffix used to append query parameters to landing pages that are served
CampaignFixedCpmGoal String ATTRIBUTE Fixed CPM bidding goal. Determines the exact bidding optimization parameters.

The allowed values are REACH, TARGET_FREQUENCY, UNKNOWN.

CampaignFixedCpmTargetFrequencyInfoTargetCount Long ATTRIBUTE Target frequency count represents the number of times an advertiser wants to show the ad to target a single user.
CampaignFixedCpmTargetFrequencyInfoTimeUnit String ATTRIBUTE Time window expressing the period over which you want to reach the specified target_count.

The allowed values are MONTHLY, UNKNOWN.

CampaignFrequencyCaps String ATTRIBUTE A list that limits how often each user will see this campaign's ads.
CampaignGeoTargetTypeSettingNegativeGeoTargetType String ATTRIBUTE The setting used for negative geotargeting in this particular campaign.

The allowed values are PRESENCE, PRESENCE_OR_INTEREST, UNKNOWN.

CampaignGeoTargetTypeSettingPositiveGeoTargetType String ATTRIBUTE The setting used for positive geotargeting in this particular campaign.

The allowed values are PRESENCE, PRESENCE_OR_INTEREST, SEARCH_INTEREST, UNKNOWN.

CampaignHotelPropertyAssetSet String ATTRIBUTE Immutable. The resource name for a set of hotel properties for Performance
CampaignHotelSettingDisableHotelSetting Bool ATTRIBUTE Disable the optional hotel setting. This field is currently supported only for Demand Gen campaigns.
CampaignHotelSettingHotelCenterId Long ATTRIBUTE The linked Hotel Center account.
CampaignId Long ATTRIBUTE Output only. The ID of the campaign.
CampaignKeywordMatchType String ATTRIBUTE Keyword match type of Campaign. Set to BROAD to set broad matching for all

The allowed values are BROAD, UNKNOWN.

CampaignLabels String ATTRIBUTE Output only. The resource names of labels attached to this campaign.
CampaignListingType String ATTRIBUTE Immutable. Listing type of ads served for this campaign.

The allowed values are UNKNOWN, VEHICLES.

CampaignLocalCampaignSettingLocationSourceType String ATTRIBUTE The location source type for this local campaign.

The allowed values are AFFILIATE, GOOGLE_MY_BUSINESS, UNKNOWN.

CampaignLocalServicesCampaignSettingsCategoryBids String ATTRIBUTE Categorical level bids associated with MANUAL_CPA bidding strategy.
CampaignManualCpa String ATTRIBUTE Standard Manual CPA bidding strategy.
CampaignManualCpcEnhancedCpcEnabled Bool ATTRIBUTE Whether bids are to be enhanced based on conversion optimizer data.
CampaignManualCpm String ATTRIBUTE Standard Manual CPM bidding strategy.
CampaignManualCpv String ATTRIBUTE A bidding strategy that pays a configurable amount per video view.
CampaignMaximizeConversionValueTargetRoas Double ATTRIBUTE The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.
CampaignMaximizeConversionValueTargetRoasTolerancePercentMillis Long ATTRIBUTE The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS.
CampaignMaximizeConversionsTargetCpaMicros Long ATTRIBUTE The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget.
CampaignMissingEuPoliticalAdvertisingDeclaration Bool ATTRIBUTE Output only. Indicates whether this campaign is missing a declaration about
CampaignName String ATTRIBUTE The name of the campaign.
CampaignNetworkSettingsTargetContentNetwork Bool ATTRIBUTE Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
CampaignNetworkSettingsTargetGoogleSearch Bool ATTRIBUTE Whether ads will be served with google.com search results.
CampaignNetworkSettingsTargetGoogleTvNetwork Bool ATTRIBUTE Whether ads will be served on the Google TV network.
CampaignNetworkSettingsTargetPartnerSearchNetwork Bool ATTRIBUTE Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use target_search_network for that instead.
CampaignNetworkSettingsTargetSearchNetwork Bool ATTRIBUTE Whether ads will be served on sites in the Google Search Partners Network (requires target_google_search to also be true).
CampaignNetworkSettingsTargetYoutube Bool ATTRIBUTE Whether ads will be served on YouTube.
CampaignOptimizationGoalSettingOptimizationGoalTypes String ATTRIBUTE The list of optimization goal types.

The allowed values are APP_PRE_REGISTRATION, CALL_CLICKS, DRIVING_DIRECTIONS, UNKNOWN.

CampaignOptimizationScore Double ATTRIBUTE Output only. Optimization score of the campaign.
CampaignPaymentMode String ATTRIBUTE Payment mode for the campaign.

The allowed values are CLICKS, CONVERSIONS, CONVERSION_VALUE, GUEST_STAY, UNKNOWN.

CampaignPercentCpcCpcBidCeilingMicros Long ATTRIBUTE Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.
CampaignPercentCpcEnhancedCpcEnabled Bool ATTRIBUTE Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not.
CampaignPerformanceMaxUpgradePerformanceMaxCampaign String ATTRIBUTE Output only. The resource name of the Performance Max campaign the campaign is upgraded to.
CampaignPerformanceMaxUpgradePreUpgradeCampaign String ATTRIBUTE Output only. The resource name of the legacy campaign upgraded to Performance Max.
CampaignPerformanceMaxUpgradeStatus String ATTRIBUTE Output only. The upgrade status of a campaign requested to be upgraded to Performance Max.

The allowed values are UNKNOWN, UPGRADE_COMPLETE, UPGRADE_ELIGIBLE, UPGRADE_FAILED, UPGRADE_IN_PROGRESS.

CampaignPmaxCampaignSettingsBrandTargetingOverridesIgnoreExclusionsForShoppingAds Bool ATTRIBUTE If true, brand exclusions are ignored for Shopping ads.
CampaignPrimaryStatus String ATTRIBUTE Output only. The primary status of the campaign.

The allowed values are ELIGIBLE, ENDED, LEARNING, LIMITED, MISCONFIGURED, NOT_ELIGIBLE, PAUSED, PENDING, REMOVED, UNKNOWN.

CampaignPrimaryStatusReasons String ATTRIBUTE Output only. The primary status reasons of the campaign.

The allowed values are AD_GROUPS_PAUSED, AD_GROUP_ADS_PAUSED, APP_NOT_RELEASED, APP_PARTIALLY_RELEASED, ASSET_GROUPS_PAUSED, BIDDING_STRATEGY_CONSTRAINED, BIDDING_STRATEGY_LEARNING, BIDDING_STRATEGY_LIMITED, BIDDING_STRATEGY_MISCONFIGURED, BOOKING_CANCELLED, BOOKING_HOLD_EXPIRED, BOOKING_HOLD_EXPIRING, BUDGET_CONSTRAINED, BUDGET_MISCONFIGURED, CALL_EXTENSION_DISAPPROVED, CALL_EXTENSION_UNDER_REVIEW, CAMPAIGN_DRAFT, CAMPAIGN_ENDED, CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED, CAMPAIGN_GROUP_PAUSED, CAMPAIGN_NOT_BOOKED, CAMPAIGN_PAUSED, CAMPAIGN_PENDING, CAMPAIGN_REMOVED, HAS_ADS_DISAPPROVED, HAS_ADS_LIMITED_BY_POLICY, HAS_ASSET_GROUPS_DISAPPROVED, HAS_ASSET_GROUPS_LIMITED_BY_POLICY, KEYWORDS_PAUSED, LEAD_FORM_EXTENSION_DISAPPROVED, LEAD_FORM_EXTENSION_UNDER_REVIEW, MISSING_CALL_EXTENSION, MISSING_LEAD_FORM_EXTENSION, MISSING_LOCATION_TARGETING, MOST_ADS_UNDER_REVIEW, MOST_ASSET_GROUPS_UNDER_REVIEW, NO_AD_GROUPS, NO_AD_GROUP_ADS, NO_ASSET_GROUPS, NO_KEYWORDS, NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA, SEARCH_VOLUME_LIMITED, UNKNOWN.

CampaignRealTimeBiddingSettingOptIn Bool ATTRIBUTE Whether the campaign is opted in to real-time bidding.
CampaignResourceName String ATTRIBUTE Immutable. The resource name of the campaign.
CampaignSelectiveOptimizationConversionActions String ATTRIBUTE The selected set of resource names for conversion actions for optimizing this campaign.
CampaignServingStatus String ATTRIBUTE Output only. The ad serving status of the campaign.

The allowed values are ENDED, NONE, PENDING, SERVING, SUSPENDED, UNKNOWN.

CampaignShoppingSettingAdvertisingPartnerIds String ATTRIBUTE The list of Google Ads accounts IDs of advertising partners cooperating within the campaign. This feature is currently available only for accounts having an advertising partner link. Once set, the field is immutable. This feature is currently supported only for Performance Max, Shopping, Search and Demand Gen campaign types.
CampaignShoppingSettingCampaignPriority Int ATTRIBUTE Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
CampaignShoppingSettingDisableProductFeed Bool ATTRIBUTE Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature.
CampaignShoppingSettingEnableLocal Bool ATTRIBUTE Whether to include local products.
CampaignShoppingSettingFeedLabel String ATTRIBUTE Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated sales_country in the two-letter country code (XX) format, the feed_label field should be used instead. For more information see the feed label support article.
CampaignShoppingSettingMerchantId Long ATTRIBUTE ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
CampaignShoppingSettingUseVehicleInventory Bool ATTRIBUTE Immutable. Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns. For setting Vehicle Listing inventory in Performance Max campaigns, use listing_type instead.
CampaignStartDateTime Datetime ATTRIBUTE The date and time when campaign started in serving. The timestamp is in
CampaignStatus String ATTRIBUTE The status of the campaign.

The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN.

CampaignTargetCpaCpcBidCeilingMicros Long ATTRIBUTE Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetCpaCpcBidFloorMicros Long ATTRIBUTE Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetCpaTargetCpaMicros Long ATTRIBUTE Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
CampaignTargetCpcTargetCpcMicros Long ATTRIBUTE Average CPC target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
CampaignTargetCpmTargetFrequencyGoalTargetCount Long ATTRIBUTE Target Frequency count representing how many times you want to reach a single user.
CampaignTargetCpmTargetFrequencyGoalTimeUnit String ATTRIBUTE Time window expressing the period over which you want to reach the specified target_count.

The allowed values are MONTHLY, UNKNOWN, WEEKLY.

CampaignTargetCpv String ATTRIBUTE An automated bidding strategy that sets bids to optimize performance
CampaignTargetImpressionShareCpcBidCeilingMicros Long ATTRIBUTE The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.
CampaignTargetImpressionShareLocation String ATTRIBUTE The targeted location on the search results page.

The allowed values are ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN.

CampaignTargetImpressionShareLocationFractionMicros Long ATTRIBUTE The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
CampaignTargetRoasCpcBidCeilingMicros Long ATTRIBUTE Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetRoasCpcBidFloorMicros Long ATTRIBUTE Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetRoasTargetRoas Double ATTRIBUTE Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
CampaignTargetRoasTargetRoasTolerancePercentMillis Long ATTRIBUTE The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. This field is only mutable for portfolio bidding strategies.
CampaignTargetSpendCpcBidCeilingMicros Long ATTRIBUTE Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
CampaignTargetSpendTargetSpendMicros Long ATTRIBUTE Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.
CampaignTargetingSettingTargetRestrictions String ATTRIBUTE The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
CampaignTextGuidelinesMessagingRestrictions String ATTRIBUTE Freeform instructions that will be used to guide text asset generation using LLM inference. At most 40 restrictions may be provided.
CampaignTextGuidelinesTermExclusions String ATTRIBUTE Exact words or phrases that will be excluded from generated text assets. At most 25 exclusions may be provided. Valid exclusions may contain a maximum of 30 characters.
CampaignThirdPartyIntegrationPartnersBrandLiftIntegrationPartners String ATTRIBUTE Third party integration partners for Brand Lift verification for this Campaign.
CampaignThirdPartyIntegrationPartnersBrandSafetyIntegrationPartners String ATTRIBUTE Third party integration partners for brand safety verification for this Campaign.
CampaignThirdPartyIntegrationPartnersReachIntegrationPartners String ATTRIBUTE Third party integration partners for reach verification for this Campaign.
CampaignThirdPartyIntegrationPartnersViewabilityIntegrationPartners String ATTRIBUTE Third party integration partners for YouTube viewability verification for this Campaign.
CampaignTrackingSettingTrackingUrl String ATTRIBUTE Output only. The url used for dynamic tracking.
CampaignTrackingUrlTemplate String ATTRIBUTE The URL template for constructing a tracking URL.
CampaignTravelCampaignSettingsTravelAccountId Long ATTRIBUTE Immutable. The Travel account ID associated with the Travel campaign.
CampaignUrlCustomParameters String ATTRIBUTE The list of mappings used to substitute custom parameter tags in a
CampaignVanityPharmaVanityPharmaDisplayUrlMode String ATTRIBUTE The display mode for vanity pharma URLs.

The allowed values are MANUFACTURER_WEBSITE_URL, UNKNOWN, WEBSITE_DESCRIPTION.

CampaignVanityPharmaVanityPharmaText String ATTRIBUTE The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.

The allowed values are MEDICAL_DEVICE_WEBSITE_EN, MEDICAL_DEVICE_WEBSITE_ES, PRESCRIPTION_CONTRACEPTION_WEBSITE_EN, PRESCRIPTION_CONTRACEPTION_WEBSITE_ES, PRESCRIPTION_DEVICE_WEBSITE_EN, PRESCRIPTION_DEVICE_WEBSITE_ES, PRESCRIPTION_TREATMENT_WEBSITE_EN, PRESCRIPTION_TREATMENT_WEBSITE_ES, PRESCRIPTION_VACCINE_WEBSITE_EN, PRESCRIPTION_VACCINE_WEBSITE_ES, PREVENTATIVE_TREATMENT_WEBSITE_EN, PREVENTATIVE_TREATMENT_WEBSITE_ES, UNKNOWN.

CampaignVideoBrandSafetySuitability String ATTRIBUTE Brand Safety setting at the individual campaign level. Allows for selecting

The allowed values are EXPANDED_INVENTORY, LIMITED_INVENTORY, STANDARD_INVENTORY, UNKNOWN.

CampaignVideoCampaignSettingsBookingDetailsCancellationDateTime Datetime ATTRIBUTE Output only. Time when the booked inventory of this campaign will be cancelled or has been cancelled. Available for primary status NOT_ELIGIBLE if the campaign will be cancelled and for primary status reason BOOKING_CANCELLED. Format is 'yyyy-MM-dd HH:mm:ss' in the customer's time zone.
CampaignVideoCampaignSettingsBookingDetailsHoldExpirationDateTime Datetime ATTRIBUTE Output only. Time until which booked inventory will be held or has been held for this campaign. Available for status HELD and HOLD_EXPIRED. Format is 'yyyy-MM-dd HH:mm:ss' in the customer's time zone.
CampaignVideoCampaignSettingsBookingDetailsStatus String ATTRIBUTE Output only. The status of the booking.

The allowed values are BOOKED, BOOKING_CANCELLED, CAMPAIGN_ENDED, HELD, HOLD_EXPIRED, UNKNOWN.

CampaignVideoCampaignSettingsReservationAdCategorySelfDisclosureAlcohol Bool ATTRIBUTE The campaign is expected to contain alcohol-related ads.
CampaignVideoCampaignSettingsReservationAdCategorySelfDisclosureGambling Bool ATTRIBUTE The campaign is expected to contain gambling-related ads.
CampaignVideoCampaignSettingsReservationAdCategorySelfDisclosurePolitics Bool ATTRIBUTE The campaign is expected to contain politics-related ads.
CampaignVideoCampaignSettingsVideoAdFormatControlFormatRestriction String ATTRIBUTE All contained responsive ads are expected to respect this restriction.

The allowed values are NON_SKIPPABLE_IN_STREAM, UNKNOWN.

CampaignVideoCampaignSettingsVideoAdFormatControlNonSkippableInStreamRestrictionsMaxDuration String ATTRIBUTE The maximum allowed duration for non-skippable ads.

The allowed values are MAX_DURATION_FIFTEEN_SECONDS, MAX_DURATION_SIXTY_SECONDS, MAX_DURATION_THIRTY_SECONDS, UNKNOWN.

CampaignVideoCampaignSettingsVideoAdFormatControlNonSkippableInStreamRestrictionsMinDuration String ATTRIBUTE The minimum allowed duration for non-skippable ads.

The allowed values are MIN_DURATION_FIVE_SECONDS, MIN_DURATION_SEVEN_SECONDS, MIN_DURATION_SIXTEEN_SECONDS, MIN_DURATION_THIRTY_ONE_SECONDS, UNKNOWN.

CampaignVideoCampaignSettingsVideoAdInventoryControlAllowInFeed Bool ATTRIBUTE Determine if video responsive ads can be used for in-feed video ads.
CampaignVideoCampaignSettingsVideoAdInventoryControlAllowInStream Bool ATTRIBUTE Determine if video responsive ads can be used for in-stream video ads.
CampaignVideoCampaignSettingsVideoAdInventoryControlAllowNonSkippableInStream Bool ATTRIBUTE Determine if video responsive ads can be used for non-skippable in-stream ads. This is only available for campaigns that allow mixing of non-skippable with other formats (Video reach campaign with Target Frequency bidding strategy goal).
CampaignVideoCampaignSettingsVideoAdInventoryControlAllowShorts Bool ATTRIBUTE Determine if video responsive ads can be used as shorts format.
CampaignVideoCampaignSettingsVideoAdSequenceMinimumDuration String ATTRIBUTE Users are eligible to repeat sequence after this period. Defaults to WEEK if not specified.

The allowed values are MONTH, UNKNOWN, WEEK.

CampaignVideoCampaignSettingsVideoAdSequenceSteps String ATTRIBUTE The list of sequence steps and data associated with them.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
AbsoluteTopImpressionPercentage Double METRIC Search absolute top impression share is the percentage of your Search ad
ActiveViewAudibilityInvalidGivtMeasurableImpressionsRate Double METRIC The number of impressions for which Active View could measure audibility,
ActiveViewAudibilityInvalidMeasurableImpressionsRate Double METRIC The number of impressions for which Active View could measure audibility,
ActiveViewAudibilityMeasurableImpressions Long METRIC The number of impressions for which Active View could measure if the ad was
ActiveViewAudibilityMeasurableImpressionsRate Double METRIC The number of impressions for which Active View could measure if the ad was
ActiveViewAudibleImpressions Long METRIC The number of impressions that were audible (volume > 0%) at any point
ActiveViewAudibleImpressionsRate Double METRIC The number of impressions that were audible (volume > 0%) at any point
ActiveViewAudibleQuartileP100Rate Double METRIC The number of impressions that were audible at the fourth quartile of the
ActiveViewAudibleQuartileP25Rate Double METRIC The number of impressions that were audible at the first quartile of the
ActiveViewAudibleQuartileP50Rate Double METRIC The number of impressions that were audible at the second quartile of the
ActiveViewAudibleQuartileP75Rate Double METRIC The number of impressions that were audible at the third quartile of the
ActiveViewAudibleThirtySecondsImpressions Long METRIC The number of impressions that were audible for at least 30 seconds
ActiveViewAudibleThirtySecondsImpressionsRate Double METRIC The number of impressions that were audible for at least 30 seconds
ActiveViewAudibleTwoSecondsImpressions Long METRIC The number of impressions that were audible for at least 2 seconds
ActiveViewAudibleTwoSecondsImpressionsRate Double METRIC The number of impressions that were audible for at least 2 seconds
ActiveViewCpm Double METRIC Average cost of viewable impressions (active_view_impressions).
ActiveViewCtr Double METRIC Active view measurable clicks divided by active view viewable impressions.
ActiveViewImpressions Long METRIC A measurement of how often your ad has become viewable on a Display
ActiveViewMeasurability Double METRIC The ratio of impressions that could be measured by Active View over the
ActiveViewMeasurableCostMicros Long METRIC The cost of the impressions you received that were measurable by Active
ActiveViewMeasurableImpressions Long METRIC The number of times your ads are appearing on placements in positions
ActiveViewViewability Double METRIC The percentage of time when your ad appeared on an Active View enabled site
AllConversions Double METRIC The total number of conversions. This includes all conversions regardless
AllConversionsByConversionDate Double METRIC The total number of conversions. This includes all conversions regardless
AllConversionsFromClickToCall Double METRIC The number of times people clicked the 'Call' button to call a business
AllConversionsFromDirections Double METRIC The number of times people clicked a 'Get directions' button to navigate to
AllConversionsFromInteractionsRate Double METRIC All conversions from interactions (as oppose to view through conversions)
AllConversionsFromLocationAssetClickToCall Double METRIC Number of call button clicks on any location surface after a chargeable ad
AllConversionsFromLocationAssetDirections Double METRIC Number of driving directions clicks on any location surface after a
AllConversionsFromLocationAssetMenu Double METRIC Number of menu link clicks on any location surface after a chargeable ad
AllConversionsFromLocationAssetOrder Double METRIC Number of order clicks on any location surface after a chargeable ad event
AllConversionsFromLocationAssetOtherEngagement Double METRIC Number of other types of local action clicks on any location surface after
AllConversionsFromLocationAssetStoreVisits Double METRIC Estimated number of visits to the business after a chargeable
AllConversionsFromLocationAssetWebsite Double METRIC Number of website URL clicks on any location surface after a chargeable ad
AllConversionsFromMenu Double METRIC The number of times people clicked a link to view a business's menu after
AllConversionsFromOrder Double METRIC The number of times people placed an order at a business after clicking an
AllConversionsFromOtherEngagement Double METRIC The number of other conversions (for example, posting a review or saving a
AllConversionsFromStoreVisit Double METRIC Estimated number of times people visited a business after clicking an ad.
AllConversionsFromStoreWebsite Double METRIC The number of times that people were taken to a business's URL after
AllConversionsValue Double METRIC The value of all conversions.
AllConversionsValueByConversionDate Double METRIC The value of all conversions. When this column is selected with date, the
AllNewCustomerLifetimeValue Double METRIC All of new customers' lifetime conversion value. If you have set up
AverageCartSize Double METRIC Average cart size is the average number of products in each order
AverageCost Double METRIC The average amount you pay per interaction. This amount is the total cost
AverageCpc Double METRIC The total cost of all clicks divided by the total number of clicks
AverageCpe Double METRIC The average amount that you've been charged for an ad engagement. This
AverageCpm Double METRIC Average cost-per-thousand impressions (CPM).
AverageImpressionFrequencyPerUser Double METRIC The average number of times a unique user saw your ad during the requested
AverageOrderValueMicros Long METRIC Average order value is the average revenue you made per order attributed to
AveragePageViews Double METRIC Average number of pages viewed per session.
AverageTargetCpaMicros Long METRIC The average Target CPA, or unset if not available (for example, for
AverageTargetRoas Double METRIC The average Target ROAS, or unset if not available (for example, for
AverageTimeOnSite Double METRIC Total duration of all sessions (in seconds) / number of sessions. Imported
AverageVideoWatchTimeDurationMillis Long METRIC Average video watch time duration in milliseconds for video impressions
BiddableAppInstallConversions Double METRIC Number of app installs.
BiddableAppPostInstallConversions Double METRIC Number of in-app actions.
BiddableCohortAppPostInstallConversions Double METRIC Participated in-app actions. The number of in app actions that come
BiddableIndirectInstallFirstInAppConversionMicros Long METRIC The number of biddable first in app conversions where the app install was
BounceRate Double METRIC Percentage of clicks where the user only visited a single page on your
Clicks Long METRIC The number of clicks.
ClicksUniqueQueryClusters Long METRIC Unique query intent cluster count for clicks.
ContentBudgetLostImpressionShare Double METRIC The estimated percent of times that your ad was eligible to show
ContentImpressionShare Double METRIC The impressions you've received on the Display Network divided
ContentRankLostImpressionShare Double METRIC The estimated percentage of impressions on the Display Network
Conversions Double METRIC The number of conversions. This only includes conversion actions which
ConversionsByConversionDate Double METRIC The number of conversions. This only includes conversion actions which
ConversionsFromInteractionsRate Double METRIC Conversions from interactions divided by the number of ad interactions
ConversionsUniqueQueryClusters Long METRIC Unique query intent cluster count for conversions.
ConversionsValue Double METRIC The value of conversions. This only includes conversion actions which
ConversionsValueByConversionDate Double METRIC The value of conversions. This only includes conversion actions which
CostConvertedCurrencyPerPlatformComparableConversion Double METRIC The cost of the platform comparable conversion in the currency of the
CostMicros Long METRIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions
CostOfGoodsSoldMicros Long METRIC Cost of goods sold (COGS) is the total cost of the products you sold in
CostPerAllConversions Double METRIC The cost of ad interactions divided by all conversions.
CostPerConversion Double METRIC The cost of ad interactions divided by conversions. This only includes
CostPerCurrentModelAttributedConversion Double METRIC The cost of ad interactions divided by current model attributed
CostPerPlatformComparableConversion Double METRIC The cost of ad interactions divided by the number of platform comparable
CoviewedImpressions Long METRIC All co-viewed impressions represent the total number of people who saw your
CrossDeviceConversions Double METRIC Conversions from when a customer clicks on a Google Ads ad on one device,
CrossDeviceConversionsByConversionDate Double METRIC The number of cross-device conversions by conversion date.
CrossDeviceConversionsValueByConversionDate Double METRIC The sum of cross-device conversions value by conversion date.
CrossDeviceConversionsValueMicros Long METRIC The sum of the value of cross-device conversions, in micros.
CrossSellCostOfGoodsSoldMicros Long METRIC Cross-sell cost of goods sold (COGS) is the total cost of products sold as
CrossSellGrossProfitMicros Long METRIC Cross-sell gross profit is the profit you made from products sold as a
CrossSellRevenueMicros Long METRIC Cross-sell revenue is the total amount you made from products sold as a
CrossSellUnitsSold Double METRIC Cross-sell units sold is the total number of products sold as a result of
Ctr Double METRIC The number of clicks your ad receives (Clicks) divided by the number
CurrentModelAttributedConversions Double METRIC Shows how your historic conversions data would look under the attribution
CurrentModelAttributedConversionsFromInteractionsRate Double METRIC Current model attributed conversions from interactions divided by the
CurrentModelAttributedConversionsFromInteractionsValuePerInteraction Double METRIC The value of current model attributed conversions from interactions divided
CurrentModelAttributedConversionsValue Double METRIC The value of current model attributed conversions. This only includes
CurrentModelAttributedConversionsValuePerCost Double METRIC The value of current model attributed conversions divided by the cost of ad
EligibleImpressionsFromLocationAssetStoreReach Long METRIC Number of impressions in which the business location was shown or the
EngagementRate Double METRIC How often people engage with your ad after it's shown to them. This is the
Engagements Long METRIC The number of engagements.
GeneralInvalidClickRate Double METRIC The percentage of clicks that have been filtered out of your total number
GeneralInvalidClicks Long METRIC Number of general invalid clicks. These are a subset of your invalid clicks
GmailForwards Long METRIC The number of times the ad was forwarded to someone else as a message.
GmailSaves Long METRIC The number of times someone has saved your Gmail ad to their inbox as a
GmailSecondaryClicks Long METRIC The number of clicks to the landing page on the expanded state of Gmail
GrossProfitMargin Double METRIC Gross profit margin is the percentage gross profit you made from orders
GrossProfitMicros Long METRIC Gross profit is the profit you made from orders attributed to your ads
Impressions Long METRIC Count of how often your ad has appeared on a search results page or
ImpressionsUniqueQueryClusters Long METRIC Unique query intent cluster count for impressions.
InteractionEventTypes String METRIC The types of payable and free interactions.

The allowed values are CLICK, ENGAGEMENT, NONE, UNKNOWN, VIDEO_VIEW.

InteractionRate Double METRIC How often people interact with your ad after it is shown to them.
Interactions Long METRIC The number of interactions.
InvalidClickRate Double METRIC The percentage of clicks filtered out of your total number of clicks
InvalidClicks Long METRIC Number of clicks Google considers illegitimate and doesn't charge you for.
LeadCostOfGoodsSoldMicros Long METRIC Lead cost of goods sold (COGS) is the total cost of products sold as a
LeadGrossProfitMicros Long METRIC Lead gross profit is the profit you made from products sold as a result of
LeadRevenueMicros Long METRIC Lead revenue is the total amount you made from products sold as a result of
LeadUnitsSold Double METRIC Lead units sold is the total number of products sold as a result of
NewCustomerLifetimeValue Double METRIC New customers' lifetime conversion value. If you have set up
OptimizationScoreUplift Double METRIC Total optimization score uplift of all recommendations.
OptimizationScoreUrl String METRIC URL for the optimization score page in the Google Ads web interface.
Orders Double METRIC Orders is the total number of purchase conversions you received attributed
PercentNewVisitors Double METRIC Percentage of first-time sessions (from people who had never visited your
PhoneCalls Long METRIC Number of offline phone calls.
PhoneImpressions Long METRIC Number of offline phone impressions.
PhoneThroughRate Double METRIC Number of phone calls received (phone_calls) divided by the number of
PlatformComparableConversions Double METRIC The number of platform comparable conversions. This only includes
PlatformComparableConversionsByConversionDate Double METRIC The number of platform comparable conversions. When this metric is
PlatformComparableConversionsFromInteractionsRate Double METRIC Platform comparable conversions from interactions divided by the number of
PlatformComparableConversionsFromInteractionsValuePerInteraction Double METRIC The value of platform comparable conversions from interactions divided by
PlatformComparableConversionsValue Double METRIC The value of platform comparable conversions. This only includes conversion
PlatformComparableConversionsValueByConversionDate Double METRIC The value of platform comparable conversions. When this metric is segmented
PlatformComparableConversionsValuePerCost Double METRIC The value of conversions divided by the cost of ad interactions. This only
PrimaryImpressions Long METRIC Primary impression is counted each time your ad is served. This metric is
PublisherOrganicClicks Long METRIC Clicks from properties for which the traffic the publisher has not paid
PublisherPurchasedClicks Long METRIC Clicks from properties not owned by the publisher for which the traffic
PublisherUnknownClicks Long METRIC Clicks from traffic which is not identified as 'Publisher Purchased' or
RelativeCtr Double METRIC Your clickthrough rate (Ctr) divided by the average clickthrough rate of
ResultsConversionsPurchase Double METRIC The purchase conversion stats for the unified goals results.
RevenueMicros Long METRIC Revenue is the total amount you made from orders attributed to your ads.
SearchAbsoluteTopImpressionShare Double METRIC The percentage of the customer's Shopping or Search ad impressions that are
SearchBudgetLostAbsoluteTopImpressionShare Double METRIC The number estimating how often your ad wasn't the very first ad among the
SearchBudgetLostImpressionShare Double METRIC The estimated percent of times that your ad was eligible to show on the
SearchBudgetLostTopImpressionShare Double METRIC The number estimating how often your ad didn't show adjacent to the top
SearchClickShare Double METRIC The number of clicks you've received on the Search Network
SearchExactMatchImpressionShare Double METRIC The impressions you've received divided by the estimated number of
SearchImpressionShare Double METRIC The impressions you've received on the Search Network divided
SearchRankLostAbsoluteTopImpressionShare Double METRIC The number estimating how often your ad wasn't the very first ad among the
SearchRankLostImpressionShare Double METRIC The estimated percentage of impressions on the Search Network
SearchRankLostTopImpressionShare Double METRIC The number estimating how often your ad didn't show adjacent to the top
SearchTopImpressionShare Double METRIC The impressions you've received among the top ads compared to the estimated
SkAdNetworkInstalls Long METRIC The number of iOS Store Kit Ad Network conversions.
SkAdNetworkTotalConversions Long METRIC The total number of iOS Store Kit Ad Network conversions.
StoreVisitsLastClickModelAttributedConversions Double METRIC The amount of business visits attributed by the last click model.
Svr Long METRIC This feature is available to allowlisted accounts only.
TopImpressionPercentage Double METRIC The percent of your ad impressions that are shown adjacent to the top
TrueviewAverageCpv Double METRIC The average amount you pay each time someone views your ad.
UniqueUsers Long METRIC The number of unique users who saw your ad during the requested time
UniqueUsersFivePlus Long METRIC This metric counts the unique individuals who were shown your video ad five
UniqueUsersFourPlus Long METRIC This metric counts the unique individuals who were shown your video ad four
UniqueUsersTenPlus Long METRIC This metric counts the unique individuals who were shown your video ad ten
UniqueUsersThreePlus Long METRIC This metric counts the unique individuals who were shown your video ad
UniqueUsersTwoPlus Long METRIC This metric counts the unique individuals who were shown your video ad two
UnitsSold Double METRIC Units sold is the total number of products sold from orders attributed to
ValuePerAllConversions Double METRIC The value of all conversions divided by the number of all conversions.
ValuePerAllConversionsByConversionDate Double METRIC The value of all conversions divided by the number of all conversions. When
ValuePerConversion Double METRIC The value of conversions divided by the number of conversions. This only
ValuePerConversionsByConversionDate Double METRIC The value of conversions divided by the number of conversions. This only
ValuePerCurrentModelAttributedConversion Double METRIC The value of current model attributed conversions divided by the number of
ValuePerPlatformComparableConversion Double METRIC The value of platform comparable conversions divided by the number of
ValuePerPlatformComparableConversionsByConversionDate Double METRIC The value of platform comparable conversions divided by the number of
VideoQuartileP100Rate Double METRIC Percentage of impressions where the viewer watched all of your video.
VideoQuartileP25Rate Double METRIC Percentage of impressions where the viewer watched 25% of your video.
VideoQuartileP50Rate Double METRIC Percentage of impressions where the viewer watched 50% of your video.
VideoQuartileP75Rate Double METRIC Percentage of impressions where the viewer watched 75% of your video.
VideoTrueviewViewRate Double METRIC The number of TrueView views your video ad receives divided by its number
VideoTrueviewViewRateInFeed Double METRIC The number of TrueView views divided by number of impressions that can
VideoTrueviewViewRateInStream Double METRIC The number of TrueView views divided by number of impressions that can
VideoTrueviewViewRateShorts Double METRIC The number of TrueView views divided by number of impressions that can
VideoTrueviewViews Long METRIC The number of TrueView views your video ads received.
VideoWatchTimeDurationMillis Long METRIC Total watch time duration in milliseconds for video impressions that
ViewThroughConversions Long METRIC The total number of view-through conversions.
ViewThroughConversionsFromLocationAssetClickToCall Double METRIC Number of call button clicks on any location surface after an impression.
ViewThroughConversionsFromLocationAssetDirections Double METRIC Number of driving directions clicks on any location surface after an
ViewThroughConversionsFromLocationAssetMenu Double METRIC Number of menu link clicks on any location surface after an impression.
ViewThroughConversionsFromLocationAssetOrder Double METRIC Number of order clicks on any location surface after an impression. This
ViewThroughConversionsFromLocationAssetOtherEngagement Double METRIC Number of other types of local action clicks on any location surface after
ViewThroughConversionsFromLocationAssetStoreVisits Double METRIC Estimated number of visits to the business after an impression.
ViewThroughConversionsFromLocationAssetWebsite Double METRIC Number of website URL clicks on any location surface after an impression.
AdDestinationType String SEGMENT Ad Destination type.

The allowed values are APP_DEEP_LINK, APP_STORE, LEAD_FORM, LOCATION_LISTING, MAP_DIRECTIONS, MESSAGE, NOT_APPLICABLE, PHONE_CALL, UNKNOWN, UNMODELED_FOR_CONVERSIONS, WEBSITE, YOUTUBE.

AdFormatType String SEGMENT Ad Format type.

The allowed values are AUDIO, BUMPER, INFEED, INSTREAM_NON_SKIPPABLE, INSTREAM_SKIPPABLE, MASTHEAD, OTHER, OUTSTREAM, PAUSE, SHORTS, TEXT, UNKNOWN, UNSEGMENTED, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.

AdNetworkType String SEGMENT Ad network type.

The allowed values are CONTENT, DISCOVER, GMAIL, GOOGLE_OWNED_CHANNELS, GOOGLE_TV, MAPS, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, YOUTUBE.

AdSubNetworkType String SEGMENT Ad sub network type. Currently only available for ads running as part of

The allowed values are UNKNOWN, UNSEGMENTED, YOUTUBE_INFEED, YOUTUBE_INSTREAM, YOUTUBE_SHORTS.

AdUsingProductData Bool SEGMENT Indicates whether an ad is using product data from a Google Merchant
AdUsingVideo Bool SEGMENT Indicates whether an ad is using a video asset. This segment is only
AdjustedAgeRange String SEGMENT Adjusted age range. This is the age range of the user after applying

The allowed values are AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44, AGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP, AGE_RANGE_UNDETERMINED, UNKNOWN.

AdjustedGender String SEGMENT Adjusted gender. This is the gender of the user after applying modeling to

The allowed values are FEMALE, MALE, UNDETERMINED, UNKNOWN.

AssetInteractionTargetAsset String SEGMENT The asset resource name.
AssetInteractionTargetInteractionOnThisAsset Bool SEGMENT Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.
AuctionInsightDomain String SEGMENT Domain (visible URL) of a participant in the Auction Insights report.
ClickType String SEGMENT Click type.

The allowed values are AD_IMAGE, APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CLICK_TO_MESSAGE_LANDING_PAGE_CLICK, CLICK_TO_MESSAGE_THIRD_PARTY_CLICK, CROSS_NETWORK, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_ASSETS, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, TRAVEL_ASSETS, UNKNOWN, URL_CLICKS, VEHICLE_ASSETS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_CHANNEL_CLICK, VIDEO_END_CAP_CLICKS, VIDEO_RELATED_VIDEOS_CLICK, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.

ConversionAction String SEGMENT Resource name of the conversion action.
ConversionActionCategory String SEGMENT Conversion action category.

The allowed values are ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, UNKNOWN, YOUTUBE_FOLLOW_ON_VIEWS.

ConversionActionName String SEGMENT Conversion action name.
ConversionAdjustment Bool SEGMENT This segments your conversion columns by the original conversion and
ConversionAttributionEventType String SEGMENT Conversion attribution event type.

The allowed values are ENGAGED_VIEW, IMPRESSION, INTERACTION, UNKNOWN.

ConversionLagBucket String SEGMENT An enum value representing the number of days between the impression and

The allowed values are EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS, SIXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, THIRTEEN_TO_FOURTEEN_DAYS, THIRTY_TO_FORTY_FIVE_DAYS, THREE_TO_FOUR_DAYS, TWELVE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, TWO_TO_THREE_DAYS, UNKNOWN.

ConversionOrAdjustmentLagBucket String SEGMENT An enum value representing the number of days between the impression and

The allowed values are ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_EIGHT_DAYS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, UNKNOWN.

ConversionValueRulePrimaryDimension String SEGMENT Primary dimension of applied conversion value rules.

The allowed values are AUDIENCE, DEVICE, GEO_LOCATION, ITINERARY, MULTIPLE, NEW_VS_RETURNING_USER, NO_RULE_APPLIED, ORIGINAL, UNKNOWN.

Date Date SEGMENT Date to which metrics apply.
DayOfWeek String SEGMENT Day of the week, for example, MONDAY.

The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, WEDNESDAY.

Device String SEGMENT Device to which metrics apply.

The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN.

ExternalConversionSource String SEGMENT External conversion source.

The allowed values are AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_ATTRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.

Hour Int SEGMENT Hour of day as a number between 0 and 23, inclusive.
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as
MonthOfYear String SEGMENT Month of the year, for example, January.

The allowed values are APRIL, AUGUST, DECEMBER, FEBRUARY, JANUARY, JULY, JUNE, MARCH, MAY, NOVEMBER, OCTOBER, SEPTEMBER, UNKNOWN.

NewVersusReturningCustomers String SEGMENT This is for segmenting conversions by whether the user is a new customer

The allowed values are NEW, NEW_AND_HIGH_LTV, RETURNING, UNKNOWN.

Period String SEGMENT Predefined date range.

The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.

Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter.
RecommendationType String SEGMENT Recommendation type.

The allowed values are CALLOUT_ASSET, CALL_ASSET, CAMPAIGN_BUDGET, CUSTOM_AUDIENCE_OPT_IN, DISPLAY_EXPANSION_OPT_IN, DYNAMIC_IMAGE_EXTENSION_OPT_IN, ENHANCED_CPC_OPT_IN, FORECASTING_CAMPAIGN_BUDGET, FORECASTING_SET_TARGET_CPA, FORECASTING_SET_TARGET_ROAS, IMPROVE_DEMAND_GEN_AD_STRENGTH, IMPROVE_GOOGLE_TAG_COVERAGE, IMPROVE_PERFORMANCE_MAX_AD_STRENGTH, KEYWORD, KEYWORD_MATCH_TYPE, LEAD_FORM_ASSET, LOWER_TARGET_ROAS, MARGINAL_ROI_CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX, MOVE_UNUSED_BUDGET, OPTIMIZE_AD_ROTATION, PERFORMANCE_MAX_FINAL_URL_OPT_IN, PERFORMANCE_MAX_OPT_IN, RAISE_TARGET_CPA, RAISE_TARGET_CPA_BID_TOO_LOW, REFRESH_CUSTOMER_MATCH_LIST, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH, SEARCH_PARTNERS_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_ADD_SIZE, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING, SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, SHOPPING_TARGET_ALL_OFFERS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UNKNOWN, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, USE_BROAD_MATCH_KEYWORD.

SkAdNetworkAdEventType String SEGMENT iOS Store Kit Ad Network ad event type.

The allowed values are INTERACTION, UNAVAILABLE, UNKNOWN, VIEW.

SkAdNetworkAttributionCredit String SEGMENT iOS Store Kit Ad Network attribution credit

The allowed values are CONTRIBUTED, UNAVAILABLE, UNKNOWN, WON.

SkAdNetworkCoarseConversionValue String SEGMENT iOS Store Kit Ad Network coarse conversion value.

The allowed values are HIGH, LOW, MEDIUM, NONE, UNAVAILABLE, UNKNOWN.

SkAdNetworkFineConversionValue Long SEGMENT iOS Store Kit Ad Network conversion value.
SkAdNetworkPostbackSequenceIndex Long SEGMENT iOS Store Kit Ad Network postback sequence index.
SkAdNetworkRedistributedFineConversionValue Long SEGMENT iOS Store Kit Ad Network redistributed fine conversion value.
SkAdNetworkSourceAppSkAdNetworkSourceAppId String SEGMENT App id where the ad that drove the iOS Store Kit Ad Network install was shown.
SkAdNetworkSourceDomain String SEGMENT Website where the ad that drove the iOS Store Kit Ad Network install was
SkAdNetworkSourceType String SEGMENT The source type where the ad that drove the iOS Store Kit Ad Network

The allowed values are MOBILE_APPLICATION, UNAVAILABLE, UNKNOWN, WEBSITE.

SkAdNetworkUserType String SEGMENT iOS Store Kit Ad Network user type.

The allowed values are NEW_INSTALLER, REINSTALLER, UNAVAILABLE, UNKNOWN.

SkAdNetworkVersion String SEGMENT The version of the SKAdNetwork API used.
Slot String SEGMENT Position of the ad.

The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN.

TravelDestinationCity String SEGMENT The city the user is searching for at query time.
TravelDestinationCountry String SEGMENT The country the user is searching for at query time.
TravelDestinationRegion String SEGMENT The region the user is searching for at query time.
VerticalAdsEventParticipantDisplayNames String SEGMENT The display names of participants in an event listing, like performers,
VerticalAdsHotelClass Long SEGMENT The class of the hotel. Generally in the range of 1 to 5 stars, but fully
VerticalAdsListing String SEGMENT The listing associated with a listing impression, click or conversion.
VerticalAdsListingBrand String SEGMENT The brand associated with a specific listing within a Vertical Ads
VerticalAdsListingCity String SEGMENT The city where the vertical ads listing is located.
VerticalAdsListingCountry String SEGMENT The country where the vertical ads listing is located.
VerticalAdsListingRegion String SEGMENT The region where the vertical ads listing is located.
VerticalAdsPartnerAccount Long SEGMENT A specific partner account within a Partner Center (for example, Hotel
VerticalAdsVertical String SEGMENT Type of vertical ad, such as Vacation Rentals, Car Rentals, or

The allowed values are EVENTS, FLIGHTS, HOTELS, RENTAL_CARS, THINGS_TO_DO, UNKNOWN, VACATION_RENTALS.

Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of
Year Int SEGMENT Year, formatted as yyyy.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer more granular control over the data returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 26.0.9655