Connect Google Ads to Azure with Windsor.ai

googleads2 1

+

azure logo 2

Stream all your marketing data from Google Ads to Azure

About Google Ads

Google Ads (formerly known as Google Adwords) is a pay per click advertising platform. It’s customers can buy keyword ads on the Google Search engine or use other Google Ads services like the Google Display Network or Google Shopping.

About Azure

Azure or Microsoft Azure is a cloud computing offering which allows management and hosting on Microsoft Managed data centers. It is used for business critical applications. In combination with Windsor.ai it allows joining marketing, analytics and CRM data to gain deeper insights.

First step:

You need to select Google Ads as a Data Source and Grant Access to Windsor.ai.

Second Step:

you will need to go to Select  Destination and select Azur Blog Storage As A Data Destination.

Instruction

Create an Azure Blob Storage (or an Azure Synapse Analytics) resource on your Azure Portal and provide a connection string for it. Also, you may choose different container and blob names.

Visit Wiki page for details: https://wiki.windsor.ai/azure_blob_storage

You should also read:

Stream Your Data to Azure

Power BI Facebook Ads vs Google Ads Report Template

Google Sheets PPC Planning Template for Google Ads, Bing ads, Facebook Ads, LinkedIn Ads

Google Ads metrics and dimensions available for streaming into Azure

NameTypeDescription
Absolute top impression percentageNUMERICThe percent of your ad impressions that are shown as the very first ad above the organic search results.
Accessible bidding strategyTEXTResource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
Accessible bidding strategy idNUMERICThe ID of the bidding strategy.
Accessible bidding strategy maximize conversion value target roasNUMERICThe 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.
Accessible bidding strategy maximize conversions target cpaNUMERICThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
Accessible bidding strategy nameTEXTThe name of the bidding strategy.
Accessible bidding strategy owner customer idNUMERICThe ID of the Customer which owns the bidding strategy.
Accessible bidding strategy owner descriptive nameTEXTdescriptive_name of the Customer which owns the bidding strategy.
Accessible bidding strategy resource nameTEXTThe resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
Accessible bidding strategy target cpa target cpa microsNUMERICAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Accessible bidding strategy target impression share cpc bid ceiling microsNUMERICThe 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.
Accessible bidding strategy target impression share locationTEXTThe targeted location on the search results page.
Accessible bidding strategy target impression share location fraction microsNUMERICThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Accessible bidding strategy target roas target roasNUMERICThe desired revenue (based on conversion data) per unit of spend.
Accessible bidding strategy target spend cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Accessible bidding strategy target spend target spend microsNUMERICThe 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.
Accessible bidding strategy typeTEXTThe type of the bidding strategy.
Account currency codeTEXTThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Account descriptive nameTEXTOptional, non-unique descriptive name of the customer.
Account IDTEXTThe Google Ads account ID.
Account NameTEXTOptional, non-unique descriptive name of the customer.
Account time zoneTEXTThe local timezone ID of the customer.
Action itemsTEXTA list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.".
Active view cpmNUMERICAverage cost of viewable impressions (active_view_impressions).
Active view ctrNUMERICActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
Active view impressionsNUMERICA measurement of how often your ad has become viewable on a Display Network site.
Active view measurabilityNUMERICThe ratio of impressions that could be measured by Active View over the number of served impressions.
Active view measurable costNUMERICThe cost of the impressions you received that were measurable by Active View.
Active view measurable cost microsNUMERICThe cost of the impressions you received that were measurable by Active View.
Active view measurable impressionsNUMERICThe number of times your ads are appearing on placements in positions where they can be seen.
Active view viewabilityNUMERICThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
Ad added by google adsBOOLEANIndicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing.
Ad app ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad app ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad app ad html5 media bundlesTEXTList of media bundle assets that may be used with the ad.
Ad app ad html5 media bundles assetTEXTThe Asset resource name of this media bundle.
Ad app ad imagesTEXTList of image assets that may be displayed with the ad.
Ad app ad images assetTEXTThe Asset resource name of this image.
Ad app ad mandatory ad textTEXTMandatory ad text.
Ad app ad youtube videosTEXTList of YouTube video assets that may be displayed with the ad.
Ad app ad youtube videos assetTEXTThe Asset resource name of this video.
Ad app engagement ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad app engagement ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad app engagement ad imagesTEXTList of image assets that may be displayed with the ad.
Ad app engagement ad images assetTEXTThe Asset resource name of this image.
Ad app engagement ad videosTEXTList of video assets that may be displayed with the ad.
Ad app engagement ad videos assetTEXTThe Asset resource name of this video.
Ad app pre registration ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad app pre registration ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad app pre registration ad imagesTEXTList of image asset IDs whose images may be displayed with the ad.
Ad app pre registration ad images assetTEXTThe Asset resource name of this image.
Ad app pre registration ad youtube videosTEXTList of YouTube video asset IDs whose videos may be displayed with the ad.
Ad app pre registration ad youtube videos assetTEXTThe Asset resource name of this video.
Ad call ad business nameTEXTThe business name in the ad.
Ad call ad call trackedBOOLEANWhether to enable call tracking for the creative. Enabling call tracking also enables call conversions.
Ad call ad conversion actionTEXTThe conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored.
Ad call ad conversion reporting stateTEXTThe call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled.
Ad call ad country codeTEXTThe country code in the ad.
Ad call ad description1TEXTThe first line of the ad's description.
Ad call ad description2TEXTThe second line of the ad's description.
Ad call ad disable call conversionBOOLEANWhether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored.
Ad call ad headline1TEXTFirst headline in the ad.
Ad call ad headline2TEXTSecond headline in the ad.
Ad call ad path1TEXTFirst part of text that can be appended to the URL in the ad. Optional.
Ad call ad path2TEXTSecond part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional.
Ad call ad phone numberTEXTThe phone number in the ad.
Ad call ad phone number verification urlTEXTThe URL to be used for phone number verification.
Ad destination typeTEXTAd Destination type.
Ad device preferenceTEXTThe device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
Ad display upload ad display upload product typeTEXTThe product type of this ad. See comments on the enum for details.
Ad display upload ad media bundleTEXTA media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
Ad display upload ad media bundle assetTEXTThe Asset resource name of this media bundle.
Ad display urlTEXTThe URL that appears in the ad description for some ad formats.
Ad expanded dynamic search ad descriptionTEXTThe description of the ad.
Ad expanded dynamic search ad description2TEXTThe second description of the ad.
Ad expanded text ad descriptionTEXTThe description of the ad.
Ad expanded text ad description2TEXTThe second description of the ad.
Ad expanded text ad headline part1TEXTThe first part of the ad's headline.
Ad expanded text ad headline part2TEXTThe second part of the ad's headline.
Ad expanded text ad headline part3TEXTThe third part of the ad's headline.
Ad expanded text ad path1TEXTThe text that can appear alongside the ad's displayed URL.
Ad expanded text ad path2TEXTAdditional text that can appear alongside the ad's displayed URL.
Ad final app urlsTEXTA list of final app URLs that will be used on mobile if the user has the specific app installed.
Ad final mobile urlsTEXTThe list of possible final mobile URLs after all cross-domain redirects for the ad.
Ad final url suffixTEXTThe suffix to use when constructing a final URL.
Ad final urlsTEXTThe list of possible final URLs after all cross-domain redirects for the ad.
Ad gmail ad header imageTEXTThe MediaFile resource name of the header image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must be between 3:1 and 5:1 (+-1%).
Ad gmail ad marketing imageTEXTThe MediaFile resource name of the marketing image. Valid image types are GIF, JPEG and PNG. The image must either be landscape with a minimum size of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
Ad gmail ad marketing image descriptionTEXTDescription of the marketing image.
Ad gmail ad marketing image display call to action textTEXTText for the display-call-to-action.
Ad gmail ad marketing image display call to action text colorTEXTText color for the display-call-to-action in hexadecimal, e.g. #ffffff for white.
Ad gmail ad marketing image display call to action url collection idTEXTIdentifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url.
Ad gmail ad marketing image headlineTEXTHeadline of the marketing image.
Ad gmail ad product imagesTEXTProduct images. Up to 15 images are supported.
Ad gmail ad product images product imageTEXTThe MediaFile resource name of the product image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio must be 1:1 (+-1%).
Ad gmail ad product videosTEXTProduct videos. Up to 7 videos are supported. At least one product video or a marketing image must be specified.
Ad gmail ad product videos product videoTEXTThe MediaFile resource name of a video which must be hosted on YouTube.
Ad gmail ad teaser business nameTEXTBusiness name of the advertiser.
Ad gmail ad teaser descriptionTEXTDescription of the teaser.
Ad gmail ad teaser headlineTEXTHeadline of the teaser.
Ad gmail ad teaser logo imageTEXTThe MediaFile resource name of the logo image. Valid image types are GIF, JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must be 1:1 (+-1%).
Ad groupTEXTThe ad group to which the ad belongs.
Ad group ad action itemsTEXTA list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.".
Ad group ad ad added by google adsBOOLEANIndicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing.
Ad group ad ad app ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad group ad ad app ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad group ad ad app ad html5 media bundlesTEXTList of media bundle assets that may be used with the ad.
Ad group ad ad app ad html5 media bundles assetTEXTThe Asset resource name of this media bundle.
Ad group ad ad app ad imagesTEXTList of image assets that may be displayed with the ad.
Ad group ad ad app ad images assetTEXTThe Asset resource name of this image.
Ad group ad ad app ad mandatory ad textTEXTMandatory ad text.
Ad group ad ad app ad youtube videosTEXTList of YouTube video assets that may be displayed with the ad.
Ad group ad ad app ad youtube videos assetTEXTThe Asset resource name of this video.
Ad group ad ad app engagement ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad group ad ad app engagement ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad group ad ad app engagement ad imagesTEXTList of image assets that may be displayed with the ad.
Ad group ad ad app engagement ad images assetTEXTThe Asset resource name of this image.
Ad group ad ad app engagement ad videosTEXTList of video assets that may be displayed with the ad.
Ad group ad ad app engagement ad videos assetTEXTThe Asset resource name of this video.
Ad group ad ad app pre registration ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad group ad ad app pre registration ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad group ad ad app pre registration ad imagesTEXTList of image asset IDs whose images may be displayed with the ad.
Ad group ad ad app pre registration ad images assetTEXTThe Asset resource name of this image.
Ad group ad ad app pre registration ad youtube videosTEXTList of YouTube video asset IDs whose videos may be displayed with the ad.
Ad group ad ad app pre registration ad youtube videos assetTEXTThe Asset resource name of this video.
Ad group ad ad call ad business nameTEXTThe business name in the ad.
Ad group ad ad call ad call trackedBOOLEANWhether to enable call tracking for the creative. Enabling call tracking also enables call conversions.
Ad group ad ad call ad conversion actionTEXTThe conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored.
Ad group ad ad call ad conversion reporting stateTEXTThe call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled.
Ad group ad ad call ad country codeTEXTThe country code in the ad.
Ad group ad ad call ad description1TEXTThe first line of the ad's description.
Ad group ad ad call ad description2TEXTThe second line of the ad's description.
Ad group ad ad call ad disable call conversionBOOLEANWhether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored.
Ad group ad ad call ad headline1TEXTFirst headline in the ad.
Ad group ad ad call ad headline2TEXTSecond headline in the ad.
Ad group ad ad call ad path1TEXTFirst part of text that can be appended to the URL in the ad. Optional.
Ad group ad ad call ad path2TEXTSecond part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional.
Ad group ad ad call ad phone numberTEXTThe phone number in the ad.
Ad group ad ad call ad phone number verification urlTEXTThe URL to be used for phone number verification.
Ad group ad ad device preferenceTEXTThe device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
Ad group ad ad display upload ad display upload product typeTEXTThe product type of this ad. See comments on the enum for details.
Ad group ad ad display upload ad media bundleTEXTA media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
Ad group ad ad display upload ad media bundle assetTEXTThe Asset resource name of this media bundle.
Ad group ad ad display urlTEXTThe URL that appears in the ad description for some ad formats.
Ad group ad ad expanded dynamic search ad descriptionTEXTThe description of the ad.
Ad group ad ad expanded dynamic search ad description2TEXTThe second description of the ad.
Ad group ad ad expanded text ad descriptionTEXTThe description of the ad.
Ad group ad ad expanded text ad description2TEXTThe second description of the ad.
Ad group ad ad expanded text ad headline part1TEXTThe first part of the ad's headline.
Ad group ad ad expanded text ad headline part2TEXTThe second part of the ad's headline.
Ad group ad ad expanded text ad headline part3TEXTThe third part of the ad's headline.
Ad group ad ad expanded text ad path1TEXTThe text that can appear alongside the ad's displayed URL.
Ad group ad ad expanded text ad path2TEXTAdditional text that can appear alongside the ad's displayed URL.
Ad group ad ad final app urlsTEXTA list of final app URLs that will be used on mobile if the user has the specific app installed.
Ad group ad ad final mobile urlsTEXTThe list of possible final mobile URLs after all cross-domain redirects for the ad.
Ad group ad ad final url suffixTEXTThe suffix to use when constructing a final URL.
Ad group ad ad final urlsTEXTThe list of possible final URLs after all cross-domain redirects for the ad.
Ad group ad ad gmail ad header imageTEXTThe MediaFile resource name of the header image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must be between 3:1 and 5:1 (+-1%).
Ad group ad ad gmail ad marketing imageTEXTThe MediaFile resource name of the marketing image. Valid image types are GIF, JPEG and PNG. The image must either be landscape with a minimum size of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
Ad group ad ad gmail ad marketing image descriptionTEXTDescription of the marketing image.
Ad group ad ad gmail ad marketing image display call to action textTEXTText for the display-call-to-action.
Ad group ad ad gmail ad marketing image display call to action text colorTEXTText color for the display-call-to-action in hexadecimal, e.g. #ffffff for white.
Ad group ad ad gmail ad marketing image display call to action url collection idTEXTIdentifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url.
Ad group ad ad gmail ad marketing image headlineTEXTHeadline of the marketing image.
Ad group ad ad gmail ad product imagesTEXTProduct images. Up to 15 images are supported.
Ad group ad ad gmail ad product images product imageTEXTThe MediaFile resource name of the product image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio must be 1:1 (+-1%).
Ad group ad ad gmail ad product videosTEXTProduct videos. Up to 7 videos are supported. At least one product video or a marketing image must be specified.
Ad group ad ad gmail ad product videos product videoTEXTThe MediaFile resource name of a video which must be hosted on YouTube.
Ad group ad ad gmail ad teaser business nameTEXTBusiness name of the advertiser.
Ad group ad ad gmail ad teaser descriptionTEXTDescription of the teaser.
Ad group ad ad gmail ad teaser headlineTEXTHeadline of the teaser.
Ad group ad ad gmail ad teaser logo imageTEXTThe MediaFile resource name of the logo image. Valid image types are GIF, JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must be 1:1 (+-1%).
Ad group ad ad groupTEXTThe ad group to which the ad belongs.
Ad group ad ad hotel adTEXTDetails pertaining to a hotel ad.
Ad group ad ad idNUMERICThe ID of the ad.
Ad group ad ad image ad image urlTEXTURL of the full size image.
Ad group ad ad image ad media fileTEXTThe MediaFile resource to use for the image.
Ad group ad ad image ad mime typeTEXTThe mime type of the image.
Ad group ad ad image ad nameTEXTThe name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty.
Ad group ad ad image ad pixel heightNUMERICHeight in pixels of the full size image.
Ad group ad ad image ad pixel widthNUMERICWidth in pixels of the full size image.
Ad group ad ad image ad preview image urlTEXTURL of the preview size image.
Ad group ad ad image ad preview pixel heightNUMERICHeight in pixels of the preview size image.
Ad group ad ad image ad preview pixel widthNUMERICWidth in pixels of the preview size image.
Ad group ad ad legacy app install adTEXTDetails pertaining to a legacy app install ad.
Ad group ad ad legacy responsive display ad accent colorTEXTThe accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad group ad ad legacy responsive display ad allow flexible colorBOOLEANAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
Ad group ad ad legacy responsive display ad business nameTEXTThe business name in the ad.
Ad group ad ad legacy responsive display ad call to action textTEXTThe call-to-action text for the ad.
Ad group ad ad legacy responsive display ad descriptionTEXTThe description of the ad.
Ad group ad ad legacy responsive display ad format settingTEXTSpecifies which format the ad will be served in. Default is ALL_FORMATS.
Ad group ad ad legacy responsive display ad logo imageTEXTThe MediaFile resource name of the logo image used in the ad.
Ad group ad ad legacy responsive display ad long headlineTEXTThe long version of the ad's headline.
Ad group ad ad legacy responsive display ad main colorTEXTThe main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad group ad ad legacy responsive display ad marketing imageTEXTThe MediaFile resource name of the marketing image used in the ad.
Ad group ad ad legacy responsive display ad price prefixTEXTPrefix before price. E.g. 'as low as'.
Ad group ad ad legacy responsive display ad promo textTEXTPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
Ad group ad ad legacy responsive display ad short headlineTEXTThe short version of the ad's headline.
Ad group ad ad legacy responsive display ad square logo imageTEXTThe MediaFile resource name of the square logo image used in the ad.
Ad group ad ad legacy responsive display ad square marketing imageTEXTThe MediaFile resource name of the square marketing image used in the ad.
Ad group ad ad local ad call to actionsTEXTList of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. Call-to-actions are optional and at most 5 can be specified.
Ad group ad ad local ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified.
Ad group ad ad local ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified.
Ad group ad ad local ad logo imagesTEXTList of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified.
Ad group ad ad local ad logo images assetTEXTThe Asset resource name of this image.
Ad group ad ad local ad marketing imagesTEXTList of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified.
Ad group ad ad local ad marketing images assetTEXTThe Asset resource name of this image.
Ad group ad ad local ad path1TEXTFirst part of optional text that can be appended to the URL in the ad.
Ad group ad ad local ad path2TEXTSecond part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
Ad group ad ad local ad videosTEXTList of YouTube video assets that may be displayed with the ad. Videos are optional and at most 20 can be specified.
Ad group ad ad local ad videos assetTEXTThe Asset resource name of this video.
Ad group ad ad nameTEXTThe name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
Ad group ad ad resource nameTEXTThe resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
Ad group ad ad responsive display ad accent colorTEXTThe accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad group ad ad responsive display ad allow flexible colorBOOLEANAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
Ad group ad ad responsive display ad business nameTEXTThe advertiser/brand name. Maximum display width is 25.
Ad group ad ad responsive display ad call to action textTEXTThe call-to-action text for the ad. Maximum display width is 30.
Ad group ad ad responsive display ad control spec enable asset enhancementsBOOLEANWhether the advertiser has opted into the asset enhancements feature.
Ad group ad ad responsive display ad control spec enable autogen videoBOOLEANWhether the advertiser has opted into auto-gen video feature.
Ad group ad ad responsive display ad descriptionsTEXTDescriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
Ad group ad ad responsive display ad format settingTEXTSpecifies which format the ad will be served in. Default is ALL_FORMATS.
Ad group ad ad responsive display ad headlinesTEXTShort format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
Ad group ad ad responsive display ad logo imagesTEXTLogo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5.
Ad group ad ad responsive display ad logo images assetTEXTThe Asset resource name of this image.
Ad group ad ad responsive display ad long headlineTEXTA required long format headline. The maximum length is 90 characters.
Ad group ad ad responsive display ad main colorTEXTThe main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad group ad ad responsive display ad marketing imagesTEXTMarketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15.
Ad group ad ad responsive display ad marketing images assetTEXTThe Asset resource name of this image.
Ad group ad ad responsive display ad price prefixTEXTPrefix before price. E.g. 'as low as'.
Ad group ad ad responsive display ad promo textTEXTPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
Ad group ad ad responsive display ad square logo imagesTEXTSquare logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with square_logo_images, the maximum is 5.
Ad group ad ad responsive display ad square logo images assetTEXTThe Asset resource name of this image.
Ad group ad ad responsive display ad square marketing imagesTEXTSquare marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15.
Ad group ad ad responsive display ad square marketing images assetTEXTThe Asset resource name of this image.
Ad group ad ad responsive display ad youtube videosTEXTOptional YouTube videos for the ad. A maximum of 5 videos can be specified.
Ad group ad ad responsive display ad youtube videos assetTEXTThe Asset resource name of this video.
Ad group ad ad responsive search ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad group ad ad responsive search ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad group ad ad responsive search ad path1TEXTFirst part of text that can be appended to the URL in the ad.
Ad group ad ad responsive search ad path2TEXTSecond part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
Ad group ad ad shopping comparison listing ad headlineTEXTHeadline of the ad. This field is required. Allowed length is between 25 and 45 characters.
Ad group ad ad shopping product adTEXTDetails pertaining to a Shopping product ad.
Ad group ad ad shopping smart adTEXTDetails pertaining to a Smart Shopping ad.
Ad group ad ad smart campaign ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified.
Ad group ad ad smart campaign ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified.
Ad group ad ad strengthTEXTOverall ad strength for this ad group ad.
Ad group ad ad system managed resource sourceTEXTIf this ad is system managed, then this field will indicate the source. This field is read-only.
Ad group ad ad text ad description1TEXTThe first line of the ad's description.
Ad group ad ad text ad description2TEXTThe second line of the ad's description.
Ad group ad ad text ad headlineTEXTThe headline of the ad.
Ad group ad ad tracking url templateTEXTThe URL template for constructing a tracking URL.
Ad group ad ad typeTEXTThe type of ad.
Ad group ad ad url collectionsTEXTAdditional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
Ad group ad ad url custom parametersTEXTThe list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, please use url custom parameter operations.
Ad group ad ad video ad bumper companion banner assetTEXTThe Asset resource name of this image.
Ad group ad ad video ad discovery description1TEXTFirst text line for a TrueView video discovery ad.
Ad group ad ad video ad discovery description2TEXTSecond text line for a TrueView video discovery ad.
Ad group ad ad video ad discovery headlineTEXTThe headline of the ad.
Ad group ad ad video ad discovery thumbnailTEXTVideo thumbnail image to use.
Ad group ad ad video ad in stream action button labelTEXTLabel on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise.
Ad group ad ad video ad in stream action headlineTEXTAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
Ad group ad ad video ad in stream companion banner assetTEXTThe Asset resource name of this image.
Ad group ad ad video ad non skippable action button labelTEXTLabel on the "Call To Action" button taking the user to the video ad's final URL.
Ad group ad ad video ad non skippable action headlineTEXTAdditional text displayed with the "Call To Action" button to give context and encourage clicking on the button.
Ad group ad ad video ad non skippable companion banner assetTEXTThe Asset resource name of this image.
Ad group ad ad video ad out stream descriptionTEXTThe description line.
Ad group ad ad video ad out stream headlineTEXTThe headline of the ad.
Ad group ad ad video ad video assetTEXTThe Asset resource name of this video.
Ad group ad ad video responsive ad call to actionsTEXTList of text assets used for the button, e.g. the "Call To Action" button. Currently, only a single value for the button is supported.
Ad group ad ad video responsive ad companion bannersTEXTList of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
Ad group ad ad video responsive ad companion banners assetTEXTThe Asset resource name of this image.
Ad group ad ad video responsive ad descriptionsTEXTList of text assets used for the description. Currently, only a single value for the description is supported.
Ad group ad ad video responsive ad headlinesTEXTList of text assets used for the short headline, e.g. the "Call To Action" banner. Currently, only a single value for the short headline is supported.
Ad group ad ad video responsive ad long headlinesTEXTList of text assets used for the long headline. Currently, only a single value for the long headline is supported.
Ad group ad ad video responsive ad videosTEXTList of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported.
Ad group ad ad video responsive ad videos assetTEXTThe Asset resource name of this video.
Ad group ad labelsTEXTThe resource names of labels attached to this ad group ad.
Ad group ad policy summary approval statusTEXTThe overall approval status of this ad, calculated based on the status of its individual policy topic entries.
Ad group ad policy summary policy topic entriesTEXTThe list of policy findings for this ad.
Ad group ad policy summary review statusTEXTWhere in the review process this ad is.
Ad group ad resource nameTEXTThe resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
Ad group ad statusTEXTThe status of the ad.
Ad group campaignTEXTThe campaign to which the ad group belongs.
Ad group excluded parent asset field typesTEXTThe asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels.
Ad group explorer auto optimizer setting opt inBOOLEANIndicates whether the optimizer is turned on.
Ad group idNUMERICThe ID of the ad group.
Ad group labelsTEXTThe resource names of labels attached to this ad group.
Ad group nameTEXTThe name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
Ad group percent cpc bid microsNUMERICThe percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].
Ad group resource nameTEXTThe resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id}
Ad group statusTEXTThe status of the ad group.
Ad group target cpa microsNUMERICThe target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored.
Ad group target cpm microsNUMERICAverage amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
Ad group target roasNUMERICThe target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
Ad group targeting setting target restrictionsTEXTThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Ad group typeTEXTThe type of the ad group.
Ad hotel adTEXTDetails pertaining to a hotel ad.
Ad idTEXTThe ID of the ad.
Ad image ad image urlTEXTURL of the full size image.
Ad image ad media fileTEXTThe MediaFile resource to use for the image.
Ad image ad mime typeTEXTThe mime type of the image.
Ad image ad nameTEXTThe name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty.
Ad image ad pixel heightNUMERICHeight in pixels of the full size image.
Ad image ad pixel widthNUMERICWidth in pixels of the full size image.
Ad image ad preview image urlTEXTURL of the preview size image.
Ad image ad preview pixel heightNUMERICHeight in pixels of the preview size image.
Ad image ad preview pixel widthNUMERICWidth in pixels of the preview size image.
Ad legacy app install adTEXTDetails pertaining to a legacy app install ad.
Ad legacy responsive display ad accent colorTEXTThe accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad legacy responsive display ad allow flexible colorBOOLEANAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
Ad legacy responsive display ad business nameTEXTThe business name in the ad.
Ad legacy responsive display ad call to action textTEXTThe call-to-action text for the ad.
Ad legacy responsive display ad descriptionTEXTThe description of the ad.
Ad legacy responsive display ad format settingTEXTSpecifies which format the ad will be served in. Default is ALL_FORMATS.
Ad legacy responsive display ad logo imageTEXTThe MediaFile resource name of the logo image used in the ad.
Ad legacy responsive display ad long headlineTEXTThe long version of the ad's headline.
Ad legacy responsive display ad main colorTEXTThe main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad legacy responsive display ad marketing imageTEXTThe MediaFile resource name of the marketing image used in the ad.
Ad legacy responsive display ad price prefixTEXTPrefix before price. E.g. 'as low as'.
Ad legacy responsive display ad promo textTEXTPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
Ad legacy responsive display ad short headlineTEXTThe short version of the ad's headline.
Ad legacy responsive display ad square logo imageTEXTThe MediaFile resource name of the square logo image used in the ad.
Ad legacy responsive display ad square marketing imageTEXTThe MediaFile resource name of the square marketing image used in the ad.
Ad local ad call to actionsTEXTList of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. Call-to-actions are optional and at most 5 can be specified.
Ad local ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified.
Ad local ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified.
Ad local ad logo imagesTEXTList of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified.
Ad local ad logo images assetTEXTThe Asset resource name of this image.
Ad local ad marketing imagesTEXTList of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified.
Ad local ad marketing images assetTEXTThe Asset resource name of this image.
Ad local ad path1TEXTFirst part of optional text that can be appended to the URL in the ad.
Ad local ad path2TEXTSecond part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
Ad local ad videosTEXTList of YouTube video assets that may be displayed with the ad. Videos are optional and at most 20 can be specified.
Ad local ad videos assetTEXTThe Asset resource name of this video.
Ad nameTEXTThe name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
Ad network typeTEXTAd network type.
Ad network type2TEXTAd network type.
Ad resource nameTEXTThe resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
Ad responsive display ad accent colorTEXTThe accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad responsive display ad allow flexible colorBOOLEANAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
Ad responsive display ad business nameTEXTThe advertiser/brand name. Maximum display width is 25.
Ad responsive display ad call to action textTEXTThe call-to-action text for the ad. Maximum display width is 30.
Ad responsive display ad control spec enable asset enhancementsBOOLEANWhether the advertiser has opted into the asset enhancements feature.
Ad responsive display ad control spec enable autogen videoBOOLEANWhether the advertiser has opted into auto-gen video feature.
Ad responsive display ad descriptionsTEXTDescriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
Ad responsive display ad format settingTEXTSpecifies which format the ad will be served in. Default is ALL_FORMATS.
Ad responsive display ad headlinesTEXTShort format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
Ad responsive display ad logo imagesTEXTLogo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5.
Ad responsive display ad logo images assetTEXTThe Asset resource name of this image.
Ad responsive display ad long headlineTEXTA required long format headline. The maximum length is 90 characters.
Ad responsive display ad main colorTEXTThe main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad responsive display ad marketing imagesTEXTMarketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15.
Ad responsive display ad marketing images assetTEXTThe Asset resource name of this image.
Ad responsive display ad price prefixTEXTPrefix before price. E.g. 'as low as'.
Ad responsive display ad promo textTEXTPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
Ad responsive display ad square logo imagesTEXTSquare logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with square_logo_images, the maximum is 5.
Ad responsive display ad square logo images assetTEXTThe Asset resource name of this image.
Ad responsive display ad square marketing imagesTEXTSquare marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15.
Ad responsive display ad square marketing images assetTEXTThe Asset resource name of this image.
Ad responsive display ad youtube videosTEXTOptional YouTube videos for the ad. A maximum of 5 videos can be specified.
Ad responsive display ad youtube videos assetTEXTThe Asset resource name of this video.
Ad responsive search ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad responsive search ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad responsive search ad path1TEXTFirst part of text that can be appended to the URL in the ad.
Ad responsive search ad path2TEXTSecond part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
Ad rotation modeTEXTThe ad rotation mode of the ad group.
Ad serving optimization statusTEXTThe ad serving optimization status of the campaign.
Ad shopping comparison listing ad headlineTEXTHeadline of the ad. This field is required. Allowed length is between 25 and 45 characters.
Ad shopping product adTEXTDetails pertaining to a Shopping product ad.
Ad shopping smart adTEXTDetails pertaining to a Smart Shopping ad.
Ad smart campaign ad descriptionsTEXTList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified.
Ad smart campaign ad headlinesTEXTList of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified.
Ad strengthTEXTOverall ad strength for this ad group ad.
Ad system managed resource sourceTEXTIf this ad is system managed, then this field will indicate the source. This field is read-only.
Ad text ad description1TEXTThe first line of the ad's description.
Ad text ad description2TEXTThe second line of the ad's description.
Ad text ad headlineTEXTThe headline of the ad.
Ad tracking url templateTEXTThe URL template for constructing a tracking URL.
Ad typeTEXTThe type of ad.
Ad url collectionsTEXTAdditional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
Ad url custom parametersTEXTThe list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, please use url custom parameter operations.
Ad video ad bumper companion banner assetTEXTThe Asset resource name of this image.
Ad video ad discovery description1TEXTFirst text line for a TrueView video discovery ad.
Ad video ad discovery description2TEXTSecond text line for a TrueView video discovery ad.
Ad video ad discovery headlineTEXTThe headline of the ad.
Ad video ad discovery thumbnailTEXTVideo thumbnail image to use.
Ad video ad in stream action button labelTEXTLabel on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise.
Ad video ad in stream action headlineTEXTAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
Ad video ad in stream companion banner assetTEXTThe Asset resource name of this image.
Ad video ad non skippable action button labelTEXTLabel on the "Call To Action" button taking the user to the video ad's final URL.
Ad video ad non skippable action headlineTEXTAdditional text displayed with the "Call To Action" button to give context and encourage clicking on the button.
Ad video ad non skippable companion banner assetTEXTThe Asset resource name of this image.
Ad video ad out stream descriptionTEXTThe description line.
Ad video ad out stream headlineTEXTThe headline of the ad.
Ad video ad video assetTEXTThe Asset resource name of this video.
Ad video responsive ad call to actionsTEXTList of text assets used for the button, e.g. the "Call To Action" button. Currently, only a single value for the button is supported.
Ad video responsive ad companion bannersTEXTList of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
Ad video responsive ad companion banners assetTEXTThe Asset resource name of this image.
Ad video responsive ad descriptionsTEXTList of text assets used for the description. Currently, only a single value for the description is supported.
Ad video responsive ad headlinesTEXTList of text assets used for the short headline, e.g. the "Call To Action" banner. Currently, only a single value for the short headline is supported.
Ad video responsive ad long headlinesTEXTList of text assets used for the long headline. Currently, only a single value for the long headline is supported.
Ad video responsive ad videosTEXTList of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported.
Ad video responsive ad videos assetTEXTThe Asset resource name of this video.
Adnetwork conversionsNUMERICThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
Adnetwork revenueNUMERICThe value of all conversions.
Advertising channel sub typeTEXTOptional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
Advertising channel typeTEXTThe primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
Aggregator idNUMERICAggregator ID of the product.
All conversion rateNUMERICAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
All conversion valueNUMERICThe value of all conversions.
All conversionsNUMERICThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All conversions by conversion dateNUMERICThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
All conversions from click to callNUMERICThe number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only.
All conversions from directionsNUMERICThe number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only.
All conversions from interactions rateNUMERICAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
All conversions from interactions value per interactionNUMERICThe value of all conversions from interactions divided by the total number of interactions.
All conversions from menuNUMERICThe number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
All conversions from orderNUMERICThe number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
All conversions from other engagementNUMERICThe number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.
All conversions from store visitNUMERICEstimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
All conversions from store websiteNUMERICThe number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
All conversions valueNUMERICThe value of all conversions.
All conversions value by conversion dateNUMERICThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
All conversions value per costNUMERICThe value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
AmountNUMERICThe amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.
Amount microsNUMERICThe amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.
App campaign setting app idTEXTA string that uniquely identifies a mobile application.
App campaign setting app storeTEXTThe application store that distributes this specific app.
App campaign setting bidding strategy goal typeTEXTRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Auto tagging enabledBOOLEANWhether auto-tagging is enabled for the customer.
Average costNUMERICThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average cpcNUMERICThe total cost of all clicks divided by the total number of clicks received.
Average cpeNUMERICThe 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.
Average cpmNUMERICAverage cost-per-thousand impressions (CPM).
Average cpvNUMERICThe 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.
Average page viewsNUMERICAverage number of pages viewed per session.
Average pageviewsNUMERICAverage number of pages viewed per session.
Average time on siteNUMERICTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
Base ad groupTEXTFor draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only.
Base ad group idTEXTFor draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only.
Base campaignTEXTThe resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only.
Base campaign idTEXTThe resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only.
Benchmark average max cpcNUMERICAn indication of how other advertisers are bidding on similar products.
Bidding strategyTEXTPortfolio bidding strategy used by campaign.
Bidding strategy campaign countNUMERICThe number of campaigns attached to this bidding strategy. This field is read-only.
Bidding strategy currency codeTEXTThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
Bidding strategy effective currency codeTEXTThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
Bidding strategy enhanced cpcTEXTA bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
Bidding strategy idTEXTPortfolio bidding strategy used by campaign.
Bidding strategy maximize conversion value cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding strategy maximize conversion value cpc bid floor microsNUMERICMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding strategy maximize conversion value target roasNUMERICThe 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.
Bidding strategy maximize conversions cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding strategy maximize conversions cpc bid floor microsNUMERICMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding strategy maximize conversions target cpaNUMERICThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
Bidding strategy nameTEXTThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Bidding strategy non removed campaign countNUMERICThe number of non-removed campaigns attached to this bidding strategy. This field is read-only.
Bidding strategy resource nameTEXTThe resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
Bidding strategy sourceTEXTThe type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only.
Bidding strategy statusTEXTThe status of the bidding strategy. This field is read-only.
Bidding strategy target cpa cpc bid ceiling microsNUMERICMaximum 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.
Bidding strategy target cpa cpc bid floor microsNUMERICMinimum 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.
Bidding strategy target cpa target cpa microsNUMERICAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Bidding strategy target impression share cpc bid ceiling microsNUMERICThe 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.
Bidding strategy target impression share locationTEXTThe targeted location on the search results page.
Bidding strategy target impression share location fraction microsNUMERICThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Bidding strategy target roas cpc bid ceiling microsNUMERICMaximum 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.
Bidding strategy target roas cpc bid floor microsNUMERICMinimum 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.
Bidding strategy target roas target roasNUMERICThe desired revenue (based on conversion data) per unit of spend.
Bidding strategy target spend cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Bidding strategy target spend target spend microsNUMERICThe 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.
Bidding strategy typeTEXTThe type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only.
Bounce rateNUMERICPercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
BrandTEXTBrand of the product.
Budget campaign association status campaignTEXTThe campaign resource name.
Budget campaign association status statusTEXTBudget campaign association status.
Budget idTEXTThe budget of the campaign.
Call reporting setting call conversion actionTEXTCustomer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
Call reporting setting call conversion reporting enabledBOOLEANWhether to enable call conversion reporting.
Call reporting setting call reporting enabledBOOLEANEnable reporting of phone call events by redirecting them via Google System.
CampaignTEXTThe name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
Campaign accessible bidding strategyTEXTResource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
Campaign ad serving optimization statusTEXTThe ad serving optimization status of the campaign.
Campaign app campaign setting app idTEXTA string that uniquely identifies a mobile application.
Campaign app campaign setting app storeTEXTThe application store that distributes this specific app.
Campaign app campaign setting bidding strategy goal typeTEXTRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign budgetTEXTThe budget of the campaign.
Campaign budget delivery methodTEXTThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
Campaign budget idTEXTThe ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
Campaign budget nameTEXTThe name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Campaign budget recommended budget estimated change weekly clicksNUMERICThe estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
Campaign budget recommended budget estimated change weekly cost microsNUMERICThe estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
Campaign budget recommended budget estimated change weekly interactionsNUMERICThe estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
Campaign budget recommended budget estimated change weekly viewsNUMERICThe estimated change in weekly views if the recommended budget is applied. This field is read-only.
Campaign budget reference countNUMERICThe number of campaigns actively using the budget. This field is read-only.
Campaign budget resource nameTEXTThe resource name of the campaign budget. Campaign budget resource names have the form: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
Campaign budget statusTEXTThe status of this campaign budget. This field is read-only.
Campaign budget typeTEXTThe type of the campaign budget.
Campaign commission commission rate microsNUMERICCommission 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%).
Campaign countNUMERICThe number of campaigns attached to this bidding strategy. This field is read-only.
Campaign dynamic search ads setting domain nameTEXTRequired. The Internet domain name that this setting represents, e.g., "google.com" or "www.google.com".
Campaign dynamic search ads setting feedsTEXTThe list of page feeds associated with the campaign.
Campaign dynamic search ads setting language codeTEXTRequired. The language code specifying the language of the domain, e.g., "en".
Campaign dynamic search ads setting use supplied urls onlyBOOLEANWhether the campaign uses advertiser supplied URLs exclusively.
Campaign excluded parent asset field typesTEXTThe asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
Campaign frequency capsTEXTA list that limits how often each user will see this campaign's ads.
Campaign geo target type setting negative geo target typeTEXTThe setting used for negative geotargeting in this particular campaign.
Campaign geo target type setting positive geo target typeTEXTThe setting used for positive geotargeting in this particular campaign.
Campaign hotel setting hotel center idNUMERICThe linked Hotel Center account.
Campaign idTEXTThe ID of the campaign.
Campaign labelsTEXTThe resource names of labels attached to this campaign.
Campaign local campaign setting location source typeTEXTThe location source type for this local campaign.
Campaign manual cpc enhanced cpc enabledBOOLEANWhether bids are to be enhanced based on conversion optimizer data.
Campaign manual cpmTEXTStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign manual cpvTEXTA bidding strategy that pays a configurable amount per video view.
Campaign maximize conversions target cpaNUMERICThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
Campaign nameTEXTThe name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
Campaign network settings target content networkBOOLEANWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign network settings target google searchBOOLEANWhether ads will be served with google.com search results.
Campaign network settings target partner search networkBOOLEANWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign network settings target search networkBOOLEANWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign optimization goal setting optimization goal typesTEXTThe list of optimization goal types.
Campaign optimization scoreNUMERICOptimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
Campaign payment modeTEXTPayment mode for the campaign.
Campaign percent cpc cpc bid ceiling microsNUMERICMaximum 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.
Campaign percent cpc enhanced cpc enabledBOOLEANAdjusts 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.
Campaign real time bidding setting opt inBOOLEANWhether the campaign is opted in to real-time bidding.
Campaign resource nameTEXTThe resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign selective optimization conversion actionsTEXTThe selected set of conversion actions for optimizing this campaign.
Campaign shopping setting campaign priorityNUMERICPriority 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.
Campaign shopping setting enable localBOOLEANWhether to include local products.
Campaign shopping setting merchant idNUMERICID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign shopping setting sales countryTEXTSales country of products to include in the campaign. This field is required for Shopping campaigns. This field is immutable. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign statusTEXTThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign target cpa cpc bid ceiling microsNUMERICMaximum 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.
Campaign target cpa cpc bid floor microsNUMERICMinimum 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.
Campaign target cpa target cpa microsNUMERICAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign target cpmTEXTA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign target impression share cpc bid ceiling microsNUMERICThe 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.
Campaign target impression share locationTEXTThe targeted location on the search results page.
Campaign target impression share location fraction microsNUMERICThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign target roas cpc bid ceiling microsNUMERICMaximum 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.
Campaign target roas cpc bid floor microsNUMERICMinimum 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.
Campaign target roas target roasNUMERICThe desired revenue (based on conversion data) per unit of spend.
Campaign target spend cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign target spend target spend microsNUMERICThe 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.
Campaign targeting setting target restrictionsTEXTThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign tracking setting tracking urlTEXTThe url used for dynamic tracking.
Campaign trial typeTEXTThe type of campaign: normal, draft, or experiment.
Campaign url expansion opt outBOOLEANRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign vanity pharma vanity pharma display url modeTEXTThe display mode for vanity pharma URLs.
Campaign vanity pharma vanity pharma textTEXTThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign video brand safety suitabilityTEXT3-Tier Brand Safety setting for the campaign.
Category l1TEXTBidding category (level 1) of the product.
Category l2TEXTBidding category (level 2) of the product.
Category l3TEXTBidding category (level 3) of the product.
Category l4TEXTBidding category (level 4) of the product.
Category l5TEXTBidding category (level 5) of the product.
ChannelTEXTChannel of the product.
Channel exclusivityTEXTChannel exclusivity of the product.
Click typeTEXTClick type.
ClicksNUMERICThe number of clicks.
Commission commission rate microsNUMERICCommission 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%).
Content bid criterion type groupTEXTAllows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search.
Content budget lost impression shareNUMERICThe estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Content impression shareNUMERICThe impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Content rank lost impression shareNUMERICThe estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Conversion actionTEXTResource name of the conversion action.
Conversion action categoryTEXTConversion action category.
Conversion action nameTEXTConversion action name.
Conversion adjustmentBOOLEANThis segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data.
Conversion adjustment lag bucketTEXTAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Conversion attribution event typeTEXTConversion attribution event type.
Conversion category nameTEXTConversion action category.
Conversion lag bucketTEXTAn enum value representing the number of days between the impression and the conversion.
Conversion last conversion dateDATEThe date of the most recent conversion for this conversion action. The date is in the customer's time zone.
Conversion last received request date timeDATEThe last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (e.g. because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone.
Conversion or adjustment lag bucketTEXTAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Conversion rateNUMERICConversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Conversion tracker idTEXTResource name of the conversion action.
Conversion tracking setting conversion tracking idNUMERICThe conversion tracking id used for this account. This id is automatically assigned after any conversion tracking feature is used. If the customer doesn't use conversion tracking, this is 0. This field is read-only.
Conversion tracking setting cross account conversion tracking idNUMERICThe conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
Conversion type nameTEXTConversion action name.
Conversion valueNUMERICThe value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Conversion value rule primary dimensionTEXTPrimary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied.
ConversionsNUMERICThe number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Conversions by conversion dateNUMERICThe number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Conversions from interactions rateNUMERICConversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Conversions from interactions value per interactionNUMERICThe value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Conversions valueNUMERICThe value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Conversions value by conversion dateNUMERICThe value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Conversions value per costNUMERICThe value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CostNUMERICThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost microsNUMERICThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost per all conversionNUMERICThe cost of ad interactions divided by all conversions.
Cost per all conversionsNUMERICThe cost of ad interactions divided by all conversions.
Cost per conversionNUMERICThe cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Cost per current model attributed conversionNUMERICThe cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Country criteria idTEXTResource name of the geo target constant for the country of sale of the product.
Cpc bidNUMERICThe maximum CPC (cost-per-click) bid.
Cpc bid microsNUMERICThe maximum CPC (cost-per-click) bid.
Cpm bidNUMERICThe maximum CPM (cost-per-thousand viewable impressions) bid.
Cpm bid microsNUMERICThe maximum CPM (cost-per-thousand viewable impressions) bid.
Cpv bidNUMERICThe CPV (cost-per-view) bid.
Cpv bid microsNUMERICThe CPV (cost-per-view) bid.
Cross device conversionsNUMERICConversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
CtrNUMERICThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
CurrencyTEXTThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Currency codeTEXTThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Current model attributed conversion valueNUMERICThe value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Current model attributed conversionsNUMERICShows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Current model attributed conversions from interactions rateNUMERICCurrent model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Current model attributed conversions from interactions value per interactionNUMERICThe value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Current model attributed conversions valueNUMERICThe value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Current model attributed conversions value per costNUMERICThe value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Custom attribute0TEXTCustom attribute 0 of the product.
Custom attribute1TEXTCustom attribute 1 of the product.
Custom attribute2TEXTCustom attribute 2 of the product.
Custom attribute3TEXTCustom attribute 3 of the product.
Custom attribute4TEXTCustom attribute 4 of the product.
Customer auto tagging enabledBOOLEANWhether auto-tagging is enabled for the customer.
Customer call reporting setting call conversion actionTEXTCustomer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
Customer call reporting setting call conversion reporting enabledBOOLEANWhether to enable call conversion reporting.
Customer call reporting setting call reporting enabledBOOLEANEnable reporting of phone call events by redirecting them via Google System.
Customer conversion tracking setting conversion tracking idNUMERICThe conversion tracking id used for this account. This id is automatically assigned after any conversion tracking feature is used. If the customer doesn't use conversion tracking, this is 0. This field is read-only.
Customer conversion tracking setting cross account conversion tracking idNUMERICThe conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
Customer descriptive nameTEXTOptional, non-unique descriptive name of the customer.
Customer final url suffixTEXTThe URL template for appending params to the final URL
Customer has partners badgeBOOLEANWhether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
Customer managerBOOLEANWhether the customer is a manager.
Customer optimization scoreNUMERICOptimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
Customer optimization score weightNUMERICOptimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
Customer pay per conversion eligibility failure reasonsTEXTReasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
Customer remarketing setting google global site tagTEXTThe Google global site tag.
Customer resource nameTEXTThe resource name of the customer. Customer resource names have the form: customers/{customer_id}
Customer test accountBOOLEANWhether the customer is a test account.
Customer tracking url templateTEXTThe URL template for constructing a tracking URL out of parameters.
DateDATEDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Day of weekTEXTDay of the week, e.g., MONDAY.
Delivery methodTEXTThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
Descriptive nameTEXTOptional, non-unique descriptive name of the customer.
DeviceTEXTDevice to which metrics apply.
Display custom bid dimensionTEXTAllows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search.
Dynamic search ads setting domain nameTEXTRequired. The Internet domain name that this setting represents, e.g., "google.com" or "www.google.com".
Dynamic search ads setting feedsTEXTThe list of page feeds associated with the campaign.
Dynamic search ads setting language codeTEXTRequired. The language code specifying the language of the domain, e.g., "en".
Dynamic search ads setting use supplied urls onlyBOOLEANWhether the campaign uses advertiser supplied URLs exclusively.
Effective currency codeTEXTThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
Effective target cpa microsNUMERICThe effective target CPA (cost-per-acquisition). This field is read-only.
Effective target cpa sourceTEXTSource of the effective target CPA. This field is read-only.
Effective target roasNUMERICThe effective target ROAS (return-on-ad-spend). This field is read-only.
Effective target roas sourceTEXTSource of the effective target ROAS. This field is read-only.
End dateDATEThe last day of the campaign.
Engagement rateNUMERICHow 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.
EngagementsNUMERICThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Enhanced cpcTEXTA bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
Excluded parent asset field typesTEXTThe asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
Experiment typeTEXTThe type of campaign: normal, draft, or experiment.
Explicitly sharedBOOLEANSpecifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
Explorer auto optimizer setting opt inBOOLEANIndicates whether the optimizer is turned on.
External conversion sourceTEXTExternal conversion source.
External customer idNUMERICThe ID of the customer.
Final urlTEXTThe advertiser-specified final URL.
Final url suffixTEXTSuffix used to append query parameters to landing pages that are served with parallel tracking.
Frequency capsTEXTA list that limits how often each user will see this campaign's ads.
Geo target airportTEXTResource name of the geo target constant that represents an airport.
Geo target cantonTEXTResource name of the geo target constant that represents a canton.
Geo target cityTEXTResource name of the geo target constant that represents a city.
Geo target countryTEXTResource name of the geo target constant that represents a country.
Geo target countyTEXTResource name of the geo target constant that represents a county.
Geo target districtTEXTResource name of the geo target constant that represents a district.
Geo target metroTEXTResource name of the geo target constant that represents a metro.
Geo target most specific locationTEXTResource name of the geo target constant that represents the most specific location.
Geo target postal codeTEXTResource name of the geo target constant that represents a postal code.
Geo target provinceTEXTResource name of the geo target constant that represents a province.
Geo target regionTEXTResource name of the geo target constant that represents a region.
Geo target stateTEXTResource name of the geo target constant that represents a state.
Geo target type setting negative geo target typeTEXTThe setting used for negative geotargeting in this particular campaign.
Geo target type setting positive geo target typeTEXTThe setting used for positive geotargeting in this particular campaign.
Gmail forwardsNUMERICThe number of times the ad was forwarded to someone else as a message.
Gmail savesNUMERICThe number of times someone has saved your Gmail ad to their inbox as a message.
Gmail secondary clicksNUMERICThe number of clicks to the landing page on the expanded state of Gmail ads.
Has partners badgeBOOLEANWhether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
Has recommended budgetBOOLEANIndicates whether there is a recommended budget for this campaign budget. This field is read-only.
Historical creative quality scoreTEXTThe creative historical quality score.
Historical landing page quality scoreTEXTThe quality of historical landing page experience.
Historical quality scoreNUMERICThe historical quality score.
Historical search predicted ctrTEXTThe historical search predicted click through rate (CTR).
Hotel average lead value microsNUMERICAverage lead value based on clicks.
Hotel booking window daysNUMERICHotel booking window in days.
Hotel center idNUMERICHotel center ID.
Hotel check in dateDATEHotel check-in date. Formatted as yyyy-MM-dd.
Hotel check in day of weekTEXTHotel check-in day of week.
Hotel cityTEXTHotel city.
Hotel classNUMERICHotel class.
Hotel countryTEXTHotel country.
Hotel date selection typeTEXTHotel date selection type.
Hotel eligible impressionsNUMERICThe number of impressions that hotel partners could have had given their feed performance.
Hotel length of stayNUMERICHotel length of stay.
Hotel price bucketTEXTHotel price bucket.
Hotel price difference percentageNUMERICThe average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser.
Hotel rate rule idTEXTHotel rate rule ID.
Hotel rate typeTEXTHotel rate type.
Hotel setting hotel center idNUMERICThe linked Hotel Center account.
Hotel stateTEXTHotel state.
HourTEXTHour of day as a number between 0 and 23, inclusive.
Hour of dayNUMERICHour of day as a number between 0 and 23, inclusive.
IdTEXTThe ID of the campaign.
ImpressionsNUMERICCount of how often your ad has appeared on a search results page or website on the Google Network.
Interaction event typesTEXTThe types of payable and free interactions.
Interaction on this extensionBOOLEANOnly used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.
Interaction rateNUMERICHow 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.
Interaction typesTEXTThe types of payable and free interactions.
InteractionsNUMERICThe 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.
Invalid click rateNUMERICThe percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
Invalid clicksNUMERICNumber of clicks Google considers illegitimate and doesn't charge you for.
Is budget explicitly sharedBOOLEANSpecifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
Keyword ad group criterionTEXTThe AdGroupCriterion resource name.
Keyword Criterion IDTEXTThe Criterion ID for a keyword
Keyword info match typeTEXTThe match type of the keyword.
Keyword info textTEXTThe text of the keyword (at most 80 characters and 10 words).
Keyword view resource nameTEXTThe resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}
Label idNUMERICId of the label. Read only.
Label nameTEXTThe name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
Label resource nameTEXTName of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id}
Label statusTEXTStatus of the label. Read only.
Label text label background colorTEXTBackground color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
Label text label descriptionTEXTA short description of the label. The length must be no more than 200 characters.
LabelsTEXTThe resource names of labels attached to this campaign.
Landing page view resource nameTEXTThe resource name of the landing page view. Landing page view resource names have the form: customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}
Language criteria idTEXTResource name of the language constant for the language of the product.
Local campaign setting location source typeTEXTThe location source type for this local campaign.
ManagerBOOLEANWhether the customer is a manager.
Manual cpc enhanced cpc enabledBOOLEANWhether bids are to be enhanced based on conversion optimizer data.
Manual cpmTEXTStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Manual cpvTEXTA bidding strategy that pays a configurable amount per video view.
Maximize conversion value cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Maximize conversion value cpc bid floor microsNUMERICMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Maximize conversion value target roasNUMERICThe 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.
Maximize conversions cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Maximize conversions cpc bid floor microsNUMERICMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Maximize conversions target cpaNUMERICThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
Merchant idNUMERICMerchant ID of the product.
Message chat rateNUMERICNumber of message chats initiated (message_chats) divided by the number of message impressions (message_impressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression.
Message chatsNUMERICNumber of message chats initiated for Click To Message impressions that were message tracking eligible.
Message impressionsNUMERICNumber of Click To Message impressions that were message tracking eligible.
Mobile friendly clicks percentageNUMERICThe percentage of mobile clicks that go to a mobile-friendly page.
MonthTEXTMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Month of yearTEXTMonth of the year, e.g., January.
NameTEXTThe name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
Network settings target content networkBOOLEANWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Network settings target google searchBOOLEANWhether ads will be served with google.com search results.
Network settings target partner search networkBOOLEANWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Network settings target search networkBOOLEANWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Non removed campaign countNUMERICThe number of non-removed campaigns attached to this bidding strategy. This field is read-only.
Num offline impressionsNUMERICNumber of offline phone impressions.
Num offline interactionsNUMERICNumber of offline phone calls.
Offer idTEXTItem ID of the product.
Offline interaction rateNUMERICNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
Optimization goal setting optimization goal typesTEXTThe list of optimization goal types.
Optimization scoreNUMERICOptimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
Optimization score upliftNUMERICTotal optimization score uplift of all recommendations.
Optimization score urlTEXTURL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign, and can be segmented by segments.recommendation_type. For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendation_type) combination.
Optimization score weightNUMERICOptimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
Owner customer idNUMERICThe ID of the Customer which owns the bidding strategy.
Owner descriptive nameTEXTdescriptive_name of the Customer which owns the bidding strategy.
Partner hotel idTEXTPartner hotel ID.
Pay per conversion eligibility failure reasonsTEXTReasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
Payment modeTEXTPayment mode for the campaign.
Percent cpc bid microsNUMERICThe percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].
Percent cpc cpc bid ceiling microsNUMERICMaximum 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.
Percent cpc enhanced cpc enabledBOOLEANAdjusts 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.
Percent new visitorsNUMERICPercentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
PeriodTEXTPeriod over which to spend the budget. Defaults to DAILY if not specified.
Phone callsNUMERICNumber of offline phone calls.
Phone impressionsNUMERICNumber of offline phone impressions.
Phone through rateNUMERICNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
Placeholder typeTEXTPlaceholder type. This is only used with feed item metrics.
Policy summary approval statusTEXTThe overall approval status of this ad, calculated based on the status of its individual policy topic entries.
Policy summary policy topic entriesTEXTThe list of policy findings for this ad.
Policy summary review statusTEXTWhere in the review process this ad is.
Product aggregator idNUMERICAggregator ID of the product.
Product bidding category level1TEXTBidding category (level 1) of the product.
Product bidding category level2TEXTBidding category (level 2) of the product.
Product bidding category level3TEXTBidding category (level 3) of the product.
Product bidding category level4TEXTBidding category (level 4) of the product.
Product bidding category level5TEXTBidding category (level 5) of the product.
Product brandTEXTBrand of the product.
Product channelTEXTChannel of the product.
Product channel exclusivityTEXTChannel exclusivity of the product.
Product conditionTEXTCondition of the product.
Product countryTEXTResource name of the geo target constant for the country of sale of the product.
Product custom attribute0TEXTCustom attribute 0 of the product.
Product custom attribute1TEXTCustom attribute 1 of the product.
Product custom attribute2TEXTCustom attribute 2 of the product.
Product custom attribute3TEXTCustom attribute 3 of the product.
Product custom attribute4TEXTCustom attribute 4 of the product.
Product item idTEXTItem ID of the product.
Product languageTEXTResource name of the language constant for the language of the product.
Product merchant idNUMERICMerchant ID of the product.
Product store idTEXTStore ID of the product.
Product titleTEXTTitle of the product.
Product type l1TEXTType (level 1) of the product.
Product type l2TEXTType (level 2) of the product.
Product type l3TEXTType (level 3) of the product.
Product type l4TEXTType (level 4) of the product.
Product type l5TEXTType (level 5) of the product.
QuarterTEXTQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Real time bidding setting opt inBOOLEANWhether the campaign is opted in to real-time bidding.
Recommendation typeTEXTRecommendation type.
Recommended budget amountNUMERICThe recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
Recommended budget amount microsNUMERICThe recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
Recommended budget estimated change weekly clicksNUMERICThe estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
Recommended budget estimated change weekly cost microsNUMERICThe estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
Recommended budget estimated change weekly interactionsNUMERICThe estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
Recommended budget estimated change weekly viewsNUMERICThe estimated change in weekly views if the recommended budget is applied. This field is read-only.
Reference countNUMERICThe number of campaigns actively using the budget. This field is read-only.
Relative ctrNUMERICYour 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.
Remarketing setting google global site tagTEXTThe Google global site tag.
Resource nameTEXTThe resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Search absolute top impression shareNUMERICThe percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999.
Search budget lost absolute top impression shareNUMERICThe number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search budget lost impression shareNUMERICThe estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search budget lost top impression shareNUMERICThe number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search click shareNUMERICThe number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Search engine results page typeTEXTType of the search engine results page.
Search exact match impression shareNUMERICThe 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. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Search impression shareNUMERICThe impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Search rank lost absolute top impression shareNUMERICThe number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search rank lost impression shareNUMERICThe estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search rank lost top impression shareNUMERICThe number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search termTEXTThe search term.
Search term match typeTEXTMatch type of the keyword that triggered the ad, including variants.
Search term view ad groupTEXTThe ad group the search term served in.
Search Term View Ad Group IDTEXTThe Ad Group ID for a search term
Search Term View Campaign IDTEXTThe Campaign ID for a search term
Search Term View Keyword IDTEXTThe Keyword ID for a search term
Search term view resource nameTEXTThe resource name of the search term view. Search term view resource names have the form: customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}
Search term view search termTEXTThe search term.
Search term view statusTEXTIndicates whether the search term is currently one of your targeted or excluded keywords.
Search top impression shareNUMERICThe 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. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Selective optimization conversion actionsTEXTThe selected set of conversion actions for optimizing this campaign.
Serving statusTEXTThe ad serving status of the campaign.
Shopping performance view resource nameTEXTThe resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView
Shopping setting campaign priorityNUMERICPriority 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.
Shopping setting enable localBOOLEANWhether to include local products.
Shopping setting merchant idNUMERICID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Shopping setting sales countryTEXTSales country of products to include in the campaign. This field is required for Shopping campaigns. This field is immutable. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Sk ad network conversion valueNUMERICiOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign.
Sk ad network conversionsNUMERICThe number of iOS Store Kit Ad Network conversions.
SlotTEXTPosition of the ad.
SourceTEXTThe name of the connector ("google_ads")
Speed scoreNUMERICA measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest.
SpendNUMERICThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Start dateDATEThe date when campaign started.
StatusTEXTThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Store idTEXTStore ID of the product.
Target cpaNUMERICThe effective target CPA (cost-per-acquisition). This field is read-only.
Target cpa bid sourceTEXTSource of the effective target CPA. This field is read-only.
Target cpa cpc bid ceiling microsNUMERICMaximum 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.
Target cpa cpc bid floor microsNUMERICMinimum 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.
Target cpa microsNUMERICThe target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored.
Target cpa target cpa microsNUMERICAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Target cpmTEXTA bidding strategy that automatically optimizes cost per thousand impressions.
Target cpm microsNUMERICAverage amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
Target impression share cpc bid ceiling microsNUMERICThe 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.
Target impression share locationTEXTThe targeted location on the search results page.
Target impression share location fraction microsNUMERICThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Target roasNUMERICThe target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
Target roas cpc bid ceiling microsNUMERICMaximum 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.
Target roas cpc bid floor microsNUMERICMinimum 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.
Target roas target roasNUMERICThe desired revenue (based on conversion data) per unit of spend.
Target spend cpc bid ceiling microsNUMERICMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Target spend target spend microsNUMERICThe 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.
Targeting setting target restrictionsTEXTThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Test accountBOOLEANWhether the customer is a test account.
Text label background colorTEXTBackground color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
Text label descriptionTEXTA short description of the label. The length must be no more than 200 characters.
Time zoneTEXTThe local timezone ID of the customer.
Top impression percentageNUMERICThe percent of your ad impressions that are shown anywhere above the organic search results.
Total amountNUMERICThe lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
Total amount microsNUMERICThe lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
Total CostNUMERICThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Tracking setting tracking urlTEXTThe url used for dynamic tracking.
Tracking url templateTEXTThe URL template for constructing a tracking URL.
TransactionrevenueNUMERICThe value of all conversions.
TransactionsNUMERICThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
TypeTEXTThe type of the ad group.
Url custom parametersTEXTThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Url expansion opt outBOOLEANRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Valid accelerated mobile pages clicks percentageNUMERICThe percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page.
Value per all conversionNUMERICThe value of all conversions divided by the number of all conversions.
Value per all conversionsNUMERICThe value of all conversions divided by the number of all conversions.
Value per all conversions by conversion dateNUMERICThe value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Value per conversionNUMERICThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Value per conversions by conversion dateNUMERICThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Value per current model attributed conversionNUMERICThe value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Vanity pharma vanity pharma display url modeTEXTThe display mode for vanity pharma URLs.
Vanity pharma vanity pharma textTEXTThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Video brand safety suitabilityTEXT3-Tier Brand Safety setting for the campaign.
Video quartile100 rateNUMERICPercentage of impressions where the viewer watched all of your video.
Video quartile25 rateNUMERICPercentage of impressions where the viewer watched 25% of your video.
Video quartile50 rateNUMERICPercentage of impressions where the viewer watched 50% of your video.
Video quartile75 rateNUMERICPercentage of impressions where the viewer watched 75% of your video.
Video quartile p100 rateNUMERICPercentage of impressions where the viewer watched all of your video.
Video quartile p25 rateNUMERICPercentage of impressions where the viewer watched 25% of your video.
Video quartile p50 rateNUMERICPercentage of impressions where the viewer watched 50% of your video.
Video quartile p75 rateNUMERICPercentage of impressions where the viewer watched 75% of your video.
Video view rateNUMERICThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video viewsNUMERICThe number of times your video ads were viewed.
View through conversionsNUMERICThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
WeekTEXTWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
YearTEXTYear, formatted as yyyy.

Windsor.ai: Easily connect Google Ads to Azure

See the value and return on every marketing touchpoint

data warehouse

Providing 50+ marketing data streams, we make sure that all the data we integrate is fresh and accessible by marketeers, whenever they want.

insights

Spend less time on manual data loading and spreadsheets. Focus on delighting your customers.

Start a free trial today.

Integrate all your data and measure what matters.