ad_group_ad.action_items |
Field description | Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.". |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.added_by_google_ads |
Field description | Output only. Indicates 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. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.app_ad.descriptions |
Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_ad.headlines |
Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
Field description | List of media bundle assets that may be used with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdMediaBundleAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
Field description | The Asset resource name of this media bundle. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_ad.images |
Field description | List of image assets that may be displayed with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_ad.images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_ad.mandatory_ad_text |
Field description | Mandatory ad text. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_ad.youtube_videos |
Field description | List of YouTube video assets that may be displayed with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_ad.youtube_videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_engagement_ad.descriptions |
Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_engagement_ad.headlines |
Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_engagement_ad.images |
Field description | List of image assets that may be displayed with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_engagement_ad.images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_engagement_ad.videos |
Field description | List of video assets that may be displayed with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_engagement_ad.videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_pre_registration_ad.descriptions |
Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_pre_registration_ad.headlines |
Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_pre_registration_ad.images |
Field description | List of image asset IDs whose images may be displayed with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_pre_registration_ad.images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.app_pre_registration_ad.youtube_videos |
Field description | List of YouTube video asset IDs whose videos may be displayed with the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.app_pre_registration_ad.youtube_videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.call_ad.business_name |
Field description | The business name in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.call_tracked |
Field description | Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.call_ad.conversion_action |
Field description | The 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. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.call_ad.conversion_reporting_state |
Field description | The call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled. |
Category | ATTRIBUTE |
Data Type |
ENUM
DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
|
Type URL | google.ads.googleads.v18.enums.CallConversionReportingStateEnum.CallConversionReportingState |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.country_code |
Field description | The country code in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.description1 |
Field description | The first line of the ad's description. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.description2 |
Field description | The second line of the ad's description. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.disable_call_conversion |
Field description | Whether 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. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.call_ad.headline1 |
Field description | First headline in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.headline2 |
Field description | Second headline in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.path1 |
Field description | First part of text that can be appended to the URL in the ad. Optional. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.path2 |
Field description | Second 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. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.phone_number |
Field description | The phone number in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.call_ad.phone_number_verification_url |
Field description | The URL to be used for phone number verification. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.business_name |
Field description | Required. The Advertiser/brand name. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text |
Field description | Call to action text. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards |
Field description | Required. Carousel cards that will display with the ad. Min 2 max 10. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdDemandGenCarouselCardAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards.asset |
Field description | The Asset resource name of this discovery carousel card. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.description |
Field description | Required. The descriptive text of the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.headline |
Field description | Required. Headline of the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.logo_image |
Field description | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_carousel_ad.logo_image.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.business_name |
Field description | The Advertiser/brand name. Maximum display width is 25. Required. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text |
Field description | Call to action text. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions |
Field description | The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.headlines |
Field description | Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
Field description | Boolean option that indicates if this ad must be served with lead form. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images |
Field description | Logo image assets 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%). At least 1 and max 5 logo images can be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images |
Field description | Marketing image assets 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%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images |
Field description | Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images |
Field description | Square marketing image assets 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%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.breadcrumb1 |
Field description | First part of text that appears in the ad with the displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.breadcrumb2 |
Field description | Second part of text that appears in the ad with the displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.business_name |
Field description | Required. The advertiser/brand name. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.call_to_action |
Field description | Asset of type CallToActionAsset used for the "Call To Action" button. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdCallToActionAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.call_to_action.asset |
Field description | The Asset resource name of this call to action asset. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.description |
Field description | Required. Text asset used for the description. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.headline |
Field description | Required. Text asset used for the short headline. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.logo_image |
Field description | Required. Logo image 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%). |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_product_ad.logo_image.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1 |
Field description | First part of text that appears in the ad with the displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2 |
Field description | Second part of text that appears in the ad with the displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.business_name |
Field description | Required. The advertiser/brand name. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions |
Field description | Assets of type CallToActionAsset used for the "Call To Action" button. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdCallToActionAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions.asset |
Field description | The Asset resource name of this call to action asset. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions |
Field description | List of text assets used for the description. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.headlines |
Field description | List of text assets used for the short headline. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images |
Field description | Logo image 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%). |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines |
Field description | List of text assets used for the long headline. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.videos |
Field description | List of YouTube video assets used for the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.demand_gen_video_responsive_ad.videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.device_preference |
Field description | The 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, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. |
Category | ATTRIBUTE |
Data Type |
ENUM
CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.DeviceEnum.Device |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.display_upload_ad.display_upload_product_type |
Field description | The product type of this ad. See comments on the enum for details. |
Category | ATTRIBUTE |
Data Type |
ENUM
DYNAMIC_HTML5_CUSTOM_AD DYNAMIC_HTML5_EDUCATION_AD DYNAMIC_HTML5_FLIGHT_AD DYNAMIC_HTML5_HOTEL_AD DYNAMIC_HTML5_HOTEL_RENTAL_AD DYNAMIC_HTML5_JOB_AD DYNAMIC_HTML5_LOCAL_AD DYNAMIC_HTML5_REAL_ESTATE_AD DYNAMIC_HTML5_TRAVEL_AD HTML5_UPLOAD_AD UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | A 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdMediaBundleAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
|
Field description | The Asset resource name of this media bundle. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.display_url |
Field description | The URL that appears in the ad description for some ad formats. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_dynamic_search_ad.description |
Field description | The description of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_dynamic_search_ad.description2 |
Field description | The second description of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.description |
Field description | The description of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.description2 |
Field description | The second description of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.headline_part1 |
Field description | The first part of the ad's headline. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.headline_part2 |
Field description | The second part of the ad's headline. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.headline_part3 |
Field description | The third part of the ad's headline. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.path1 |
Field description | The text that can appear alongside the ad's displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.expanded_text_ad.path2 |
Field description | Additional text that can appear alongside the ad's displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.final_app_urls |
Field description | A list of final app URLs that will be used on mobile if the user has the specific app installed. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.FinalAppUrl |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.final_mobile_urls |
Field description | The list of possible final mobile URLs after all cross-domain redirects for the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.final_url_suffix |
Field description | The suffix to use when constructing a final URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.final_urls |
Field description | The list of possible final URLs after all cross-domain redirects for the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.hotel_ad |
Field description | Details pertaining to a hotel ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.HotelAdInfo |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.id |
Field description | Output only. The ID of the ad. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.image_asset.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.image_url |
Field description | URL of the full size image. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.mime_type |
Field description | The mime type of the image. |
Category | ATTRIBUTE |
Data Type |
ENUM
AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.MimeTypeEnum.MimeType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.name |
Field description | The 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. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.pixel_height |
Field description | Height in pixels of the full size image. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.pixel_width |
Field description | Width in pixels of the full size image. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.preview_image_url |
Field description | URL of the preview size image. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.preview_pixel_height |
Field description | Height in pixels of the preview size image. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.image_ad.preview_pixel_width |
Field description | Width in pixels of the preview size image. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_app_install_ad |
Field description | Immutable. Details pertaining to a legacy app install ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.LegacyAppInstallAdInfo |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.accent_color |
Field description | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_color |
Field description | Advertiser'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. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.business_name |
Field description | The business name in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_text |
Field description | The call-to-action text for the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.description |
Field description | The description of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
Category | ATTRIBUTE |
Data Type |
ENUM
ALL_FORMATS NATIVE NON_NATIVE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.logo_image |
Field description | The MediaFile resource name of the logo image used in the ad. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.long_headline |
Field description | The long version of the ad's headline. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.main_color |
Field description | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.marketing_image |
Field description | The MediaFile resource name of the marketing image used in the ad. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.price_prefix |
Field description | Prefix before price. For example, 'as low as'. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.promo_text |
Field description | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.short_headline |
Field description | The short version of the ad's headline. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.square_logo_image |
Field description | The MediaFile resource name of the square logo image used in the ad. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_image |
Field description | The MediaFile resource name of the square marketing image used in the ad. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.local_ad.call_to_actions |
Field description | List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. At least 1 and at most 5 call-to-actions must be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.local_ad.descriptions |
Field description | List 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.local_ad.headlines |
Field description | List 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.local_ad.logo_images |
Field description | List 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.local_ad.logo_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.local_ad.marketing_images |
Field description | List 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.local_ad.marketing_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.local_ad.path1 |
Field description | First part of optional text that can be appended to the URL in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.local_ad.path2 |
Field description | Second 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. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.local_ad.videos |
Field description | List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.local_ad.videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.name |
Field description | Immutable. The 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. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.resource_name |
Field description | Immutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id} |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.accent_color |
Field description | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.allow_flexible_color |
Field description | Advertiser'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. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.business_name |
Field description | The advertiser/brand name. Maximum display width is 25. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.call_to_action_text |
Field description | The call-to-action text for the ad. Maximum display width is 30. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancements |
Field description | Whether the advertiser has opted into the asset enhancements feature. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_video |
Field description | Whether the advertiser has opted into auto-gen video feature. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.descriptions |
Field description | Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
Field description | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
Category | ATTRIBUTE |
Data Type |
ENUM
ALL_FORMATS NATIVE NON_NATIVE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.headlines |
Field description | Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_display_ad.logo_images |
Field description | Logo 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_display_ad.logo_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.long_headline |
Field description | A required long format headline. The maximum length is 90 characters. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.main_color |
Field description | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.marketing_images |
Field description | Marketing 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_display_ad.marketing_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.price_prefix |
Field description | Prefix before price. For example, 'as low as'. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.promo_text |
Field description | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.square_logo_images |
Field description | Square 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 logo_images , the maximum is 5. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_display_ad.square_logo_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.square_marketing_images |
Field description | Square 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. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_display_ad.youtube_videos |
Field description | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_display_ad.youtube_videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.responsive_search_ad.descriptions |
Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_search_ad.headlines |
Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.responsive_search_ad.path1 |
Field description | First part of text that can be appended to the URL in the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.responsive_search_ad.path2 |
Field description | Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Details pertaining to a Shopping product ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.ShoppingProductAdInfo |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
|
Field description | Details pertaining to a Smart Shopping ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.ShoppingSmartAdInfo |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.smart_campaign_ad.descriptions |
Field description | List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.smart_campaign_ad.headlines |
Field description | List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.system_managed_resource_source |
Field description | Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_VARIATIONS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.text_ad.description1 |
Field description | The first line of the ad's description. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.text_ad.description2 |
Field description | The second line of the ad's description. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.text_ad.headline |
Field description | The headline of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.tracking_url_template |
Field description | The URL template for constructing a tracking URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.travel_ad |
Field description | Details pertaining to a travel ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.TravelAdInfo |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.type |
Field description | Output only. The type of ad. |
Category | ATTRIBUTE |
Data Type |
ENUM
APP_AD APP_ENGAGEMENT_AD APP_PRE_REGISTRATION_AD CALL_AD DEMAND_GEN_CAROUSEL_AD DEMAND_GEN_MULTI_ASSET_AD DEMAND_GEN_PRODUCT_AD DEMAND_GEN_VIDEO_RESPONSIVE_AD DYNAMIC_HTML5_AD EXPANDED_DYNAMIC_SEARCH_AD EXPANDED_TEXT_AD HOTEL_AD HTML5_UPLOAD_AD IMAGE_AD IN_FEED_VIDEO_AD LEGACY_APP_INSTALL_AD LEGACY_RESPONSIVE_DISPLAY_AD LOCAL_AD RESPONSIVE_DISPLAY_AD RESPONSIVE_SEARCH_AD SHOPPING_COMPARISON_LISTING_AD SHOPPING_PRODUCT_AD SHOPPING_SMART_AD SMART_CAMPAIGN_AD TEXT_AD TRAVEL_AD UNKNOWN UNSPECIFIED VIDEO_AD VIDEO_BUMPER_AD VIDEO_NON_SKIPPABLE_IN_STREAM_AD VIDEO_OUTSTREAM_AD VIDEO_RESPONSIVE_AD VIDEO_TRUEVIEW_IN_STREAM_AD
|
Type URL | google.ads.googleads.v18.enums.AdTypeEnum.AdType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.url_collections |
Field description | Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.UrlCollection |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.url_custom_parameters |
Field description | The 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, use url custom parameter operations. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.CustomParameter |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
Field description | Label on the "Call To Action" button taking the user to the video ad's final URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.bumper.action_headline |
Field description | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.bumper.companion_banner.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.in_feed.description1 |
Field description | First text line for the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.in_feed.description2 |
Field description | Second text line for the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.in_feed.headline |
Field description | The headline of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.in_feed.thumbnail |
Field description | Video thumbnail image to use. |
Category | ATTRIBUTE |
Data Type |
ENUM
DEFAULT_THUMBNAIL THUMBNAIL_1 THUMBNAIL_2 THUMBNAIL_3 UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.VideoThumbnailEnum.VideoThumbnail |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Label 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. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.in_stream.action_headline |
Field description | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.in_stream.companion_banner.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Label on the "Call To Action" button taking the user to the video ad's final URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.non_skippable.action_headline |
Field description | Additional text displayed with the "Call To Action" button to give context and encourage clicking on the button. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.non_skippable.companion_banner.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.out_stream.description |
Field description | The description line. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.out_stream.headline |
Field description | The headline of the ad. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_ad.video.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_responsive_ad.breadcrumb1 |
Field description | First part of text that appears in the ad with the displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_responsive_ad.breadcrumb2 |
Field description | Second part of text that appears in the ad with the displayed URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.ad.video_responsive_ad.call_to_actions |
Field description | List of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.video_responsive_ad.companion_banners |
Field description | List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdImageAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.video_responsive_ad.companion_banners.asset |
Field description | The Asset resource name of this image. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad.video_responsive_ad.descriptions |
Field description | List of text assets used for the description. Currently, only a single value for the description is supported. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.video_responsive_ad.headlines |
Field description | List of text assets used for the short headline. Currently, only a single value for the short headline is supported. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.video_responsive_ad.long_headlines |
Field description | List of text assets used for the long headline. Currently, only a single value for the long headline is supported. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdTextAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.video_responsive_ad.videos |
Field description | List of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.AdVideoAsset |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad.video_responsive_ad.videos.asset |
Field description | The Asset resource name of this video. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | False |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad_group |
Field description | Immutable. The ad group to which the ad belongs. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.ad_group_ad_asset_automation_settings |
Field description | Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.resources.AdGroupAdAssetAutomationSetting |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.ad_strength |
Field description | Output only. Overall ad strength for this ad group ad. |
Category | ATTRIBUTE |
Data Type |
ENUM
AVERAGE EXCELLENT GOOD NO_ADS PENDING POOR UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdStrengthEnum.AdStrength |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.labels |
Field description | Output only. The resource names of labels attached to this ad group ad. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.policy_summary.approval_status |
Field description | Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. |
Category | ATTRIBUTE |
Data Type |
ENUM
APPROVED APPROVED_LIMITED AREA_OF_INTEREST_ONLY DISAPPROVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.policy_summary.policy_topic_entries |
Field description | Output only. The list of policy findings for this ad. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.PolicyTopicEntry |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.policy_summary.review_status |
Field description | Output only. Where in the review process this ad is. |
Category | ATTRIBUTE |
Data Type |
ENUM
ELIGIBLE_MAY_SERVE REVIEWED REVIEW_IN_PROGRESS UNDER_APPEAL UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.PolicyReviewStatusEnum.PolicyReviewStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.primary_status |
Field description | Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally. |
Category | ATTRIBUTE |
Data Type |
ENUM
ELIGIBLE LIMITED NOT_ELIGIBLE PAUSED PENDING REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupAdPrimaryStatusEnum.AdGroupAdPrimaryStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group_ad.primary_status_reasons |
Field description | Output only. Provides reasons for why an ad group ad is not serving or not serving optimally. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_GROUP_AD_APPROVED_LABELED AD_GROUP_AD_AREA_OF_INTEREST_ONLY AD_GROUP_AD_DISAPPROVED AD_GROUP_AD_NO_ADS AD_GROUP_AD_PAUSED AD_GROUP_AD_POOR_QUALITY AD_GROUP_AD_REMOVED AD_GROUP_AD_UNDER_APPEAL AD_GROUP_AD_UNDER_REVIEW AD_GROUP_PAUSED AD_GROUP_REMOVED CAMPAIGN_ENDED CAMPAIGN_PAUSED CAMPAIGN_PENDING CAMPAIGN_REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupAdPrimaryStatusReasonEnum.AdGroupAdPrimaryStatusReason |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group_ad.resource_name |
Field description | Immutable. The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id} |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group_ad.status |
Field description | The status of the ad. |
Category | ATTRIBUTE |
Data Type |
ENUM
ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupAdStatusEnum.AdGroupAdStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_destination_type |
Field description | Ad Destination type. |
Category | SEGMENT |
Data Type |
ENUM
APP_DEEP_LINK APP_STORE LEAD_FORM LOCATION_LISTING MAP_DIRECTIONS MESSAGE NOT_APPLICABLE PHONE_CALL UNKNOWN UNMODELED_FOR_CONVERSIONS UNSPECIFIED WEBSITE YOUTUBE
|
Type URL | google.ads.googleads.v18.enums.AdDestinationTypeEnum.AdDestinationType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Ad Format type. |
Category | SEGMENT |
Data Type |
ENUM
AUDIO BUMPER INFEED INSTREAM_NON_SKIPPABLE INSTREAM_SKIPPABLE MASTHEAD OTHER OUTSTREAM SHORTS UNKNOWN UNSEGMENTED UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdFormatTypeEnum.AdFormatType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_network_type |
Field description | Ad network type. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT GOOGLE_OWNED_CHANNELS GOOGLE_TV MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE
|
Type URL | google.ads.googleads.v18.enums.AdNetworkTypeEnum.AdNetworkType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.click_type |
Field description | Click type. |
Category | SEGMENT |
Data Type |
ENUM
AD_IMAGE APP_DEEPLINK BREADCRUMBS BROADBAND_PLAN CALLS CALL_TRACKING CLICK_ON_ENGAGEMENT_AD CROSS_NETWORK GET_DIRECTIONS HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION HOTEL_PRICE LOCATION_EXPANSION LOCATION_FORMAT_CALL LOCATION_FORMAT_DIRECTIONS LOCATION_FORMAT_IMAGE LOCATION_FORMAT_LANDING_PAGE LOCATION_FORMAT_MAP LOCATION_FORMAT_STORE_INFO LOCATION_FORMAT_TEXT MOBILE_CALL_TRACKING OFFER_PRINTS OTHER PRICE_EXTENSION PRODUCT_AD_APP_DEEPLINK PRODUCT_EXTENSION_CLICKS PRODUCT_LISTING_ADS_COUPON PRODUCT_LISTING_AD_CLICKS PRODUCT_LISTING_AD_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE PRODUCT_LISTING_AD_TRANSACTABLE PROMOTION_EXTENSION SHOPPING_COMPARISON_LISTING SHOWCASE_AD_CATEGORY_LINK SHOWCASE_AD_LOCAL_PRODUCT_LINK SHOWCASE_AD_LOCAL_STOREFRONT_LINK SHOWCASE_AD_ONLINE_PRODUCT_LINK SITELINKS STORE_LOCATOR SWIPEABLE_GALLERY_AD_HEADLINE SWIPEABLE_GALLERY_AD_SEE_MORE SWIPEABLE_GALLERY_AD_SITELINK_FIVE SWIPEABLE_GALLERY_AD_SITELINK_FOUR SWIPEABLE_GALLERY_AD_SITELINK_ONE SWIPEABLE_GALLERY_AD_SITELINK_THREE SWIPEABLE_GALLERY_AD_SITELINK_TWO SWIPEABLE_GALLERY_AD_SWIPES TRAVEL_ASSETS UNKNOWN UNSPECIFIED URL_CLICKS VIDEO_APP_STORE_CLICKS VIDEO_CALL_TO_ACTION_CLICKS VIDEO_CARD_ACTION_HEADLINE_CLICKS VIDEO_END_CAP_CLICKS VIDEO_WEBSITE_CLICKS VISUAL_SITELINKS WIRELESS_PLAN
|
Type URL | google.ads.googleads.v18.enums.ClickTypeEnum.ClickType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action |
Field description | Resource name of the conversion action. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action_category |
Field description | Conversion action category. |
Category | SEGMENT |
Data Type |
ENUM
ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionActionCategoryEnum.ConversionActionCategory |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action_name |
Field description | Conversion action name. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_adjustment |
Field description | This segments your conversion columns by the original conversion and conversion value versus 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. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_attribution_event_type |
Field description | Conversion attribution event type. |
Category | SEGMENT |
Data Type |
ENUM
IMPRESSION INTERACTION UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_lag_bucket |
Field description | An enum value representing the number of days between the impression and the conversion. |
Category | SEGMENT |
Data Type |
ENUM
EIGHT_TO_NINE_DAYS ELEVEN_TO_TWELVE_DAYS FIVE_TO_SIX_DAYS FORTY_FIVE_TO_SIXTY_DAYS FOURTEEN_TO_TWENTY_ONE_DAYS FOUR_TO_FIVE_DAYS LESS_THAN_ONE_DAY NINE_TO_TEN_DAYS ONE_TO_TWO_DAYS SEVEN_TO_EIGHT_DAYS SIXTY_TO_NINETY_DAYS SIX_TO_SEVEN_DAYS TEN_TO_ELEVEN_DAYS THIRTEEN_TO_FOURTEEN_DAYS THIRTY_TO_FORTY_FIVE_DAYS THREE_TO_FOUR_DAYS TWELVE_TO_THIRTEEN_DAYS TWENTY_ONE_TO_THIRTY_DAYS TWO_TO_THREE_DAYS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionLagBucketEnum.ConversionLagBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_or_adjustment_lag_bucket |
Field description | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
Category | SEGMENT |
Data Type |
ENUM
ADJUSTMENT_EIGHT_TO_NINE_DAYS ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS ADJUSTMENT_FIVE_TO_SIX_DAYS ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS ADJUSTMENT_FOUR_TO_FIVE_DAYS ADJUSTMENT_LESS_THAN_ONE_DAY ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS ADJUSTMENT_NINE_TO_TEN_DAYS ADJUSTMENT_ONE_TO_TWO_DAYS ADJUSTMENT_SEVEN_TO_EIGHT_DAYS ADJUSTMENT_SIXTY_TO_NINETY_DAYS ADJUSTMENT_SIX_TO_SEVEN_DAYS ADJUSTMENT_TEN_TO_ELEVEN_DAYS ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS ADJUSTMENT_THREE_TO_FOUR_DAYS ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS ADJUSTMENT_TWO_TO_THREE_DAYS ADJUSTMENT_UNKNOWN CONVERSION_EIGHT_TO_NINE_DAYS CONVERSION_ELEVEN_TO_TWELVE_DAYS CONVERSION_FIVE_TO_SIX_DAYS CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS CONVERSION_FOUR_TO_FIVE_DAYS CONVERSION_LESS_THAN_ONE_DAY CONVERSION_NINE_TO_TEN_DAYS CONVERSION_ONE_TO_TWO_DAYS CONVERSION_SEVEN_TO_EIGHT_DAYS CONVERSION_SIXTY_TO_NINETY_DAYS CONVERSION_SIX_TO_SEVEN_DAYS CONVERSION_TEN_TO_ELEVEN_DAYS CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS CONVERSION_THREE_TO_FOUR_DAYS CONVERSION_TWELVE_TO_THIRTEEN_DAYS CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS CONVERSION_TWO_TO_THREE_DAYS CONVERSION_UNKNOWN UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.date |
Field description | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.day_of_week |
Field description | Day of the week, for example, MONDAY. |
Category | SEGMENT |
Data Type |
ENUM
FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY
|
Type URL | google.ads.googleads.v18.enums.DayOfWeekEnum.DayOfWeek |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.device |
Field description | Device to which metrics apply. |
Category | SEGMENT |
Data Type |
ENUM
CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.DeviceEnum.Device |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.external_conversion_source |
Field description | External conversion source. |
Category | SEGMENT |
Data Type |
ENUM
AD_CALL_METRICS ANALYTICS ANALYTICS_SEARCH_ADS_360 ANDROID_FIRST_OPEN ANDROID_IN_APP APP_UNSPECIFIED CLICK_TO_CALL DISPLAY_AND_VIDEO_360_FLOODLIGHT FIREBASE FIREBASE_SEARCH_ADS_360 FLOODLIGHT GOOGLE_ATTRIBUTION GOOGLE_HOSTED GOOGLE_PLAY IOS_FIRST_OPEN IOS_IN_APP SALESFORCE SEARCH_ADS_360 STORE_SALES STORE_SALES_CRM STORE_SALES_DIRECT_UPLOAD STORE_SALES_PAYMENT_NETWORK STORE_VISITS THIRD_PARTY_APP_ANALYTICS UNKNOWN UNSPECIFIED UPLOAD UPLOAD_CALLS WEBPAGE WEBSITE_CALL_METRICS
|
Type URL | google.ads.googleads.v18.enums.ExternalConversionSourceEnum.ExternalConversionSource |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.interaction_on_this_extension |
Field description | Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.keyword.ad_group_criterion |
Field description | The AdGroupCriterion resource name. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.keyword.info.match_type |
Field description | The match type of the keyword. |
Category | SEGMENT |
Data Type |
ENUM
BROAD EXACT PHRASE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.KeywordMatchTypeEnum.KeywordMatchType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.keyword.info.text |
Field description | The text of the keyword (at most 80 characters and 10 words). |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.month |
Field description | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.month_of_year |
Field description | Month of the year, for example, January. |
Category | SEGMENT |
Data Type |
ENUM
APRIL AUGUST DECEMBER FEBRUARY JANUARY JULY JUNE MARCH MAY NOVEMBER OCTOBER SEPTEMBER UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.MonthOfYearEnum.MonthOfYear |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.new_versus_returning_customers |
Field description | This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. |
Category | SEGMENT |
Data Type |
ENUM
NEW NEW_AND_HIGH_LTV RETURNING UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConvertingUserPriorEngagementTypeAndLtvBucketEnum.ConvertingUserPriorEngagementTypeAndLtvBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.placeholder_type |
Field description | Placeholder type. This is only used with feed item metrics. |
Category | SEGMENT |
Data Type |
ENUM
AD_CUSTOMIZER AFFILIATE_LOCATION APP CALL CALLOUT DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHT DYNAMIC_HOTEL DYNAMIC_JOB DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL IMAGE LOCATION MESSAGE PRICE PROMOTION SITELINK STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.PlaceholderTypeEnum.PlaceholderType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.quarter |
Field description | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.search_term_match_type |
Field description | Match type of the keyword that triggered the ad, including variants. |
Category | SEGMENT |
Data Type |
ENUM
BROAD EXACT NEAR_EXACT NEAR_PHRASE PHRASE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.SearchTermMatchTypeEnum.SearchTermMatchType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.slot |
Field description | Position of the ad. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT MIXED SEARCH_OTHER SEARCH_PARTNER_OTHER SEARCH_PARTNER_TOP SEARCH_SIDE SEARCH_TOP UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.SlotEnum.Slot |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.week |
Field description | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.year |
Field description | Year, formatted as yyyy. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.absolute_top_impression_percentage |
Field description | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_cpm |
Field description | Average cost of viewable impressions (active_view_impressions ). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_ctr |
Field description | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_impressions |
Field description | A measurement of how often your ad has become viewable on a Display Network site. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurability |
Field description | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurable_cost_micros |
Field description | The cost of the impressions you received that were measurable by Active View. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurable_impressions |
Field description | The number of times your ads are appearing on placements in positions where they can be seen. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_viewability |
Field description | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions |
Field description | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_by_conversion_date |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_interactions_rate |
Field description | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_interactions_value_per_interaction |
Field description | The value of all conversions from interactions divided by the total number of interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value |
Field description | The value of all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value_by_conversion_date |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value_per_cost |
Field description | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_new_customer_lifetime_value |
Field description | All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "all_conversions_value". See https://support.google.com/google-ads/answer/12080169 for more details. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cart_size |
Field description | Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cost |
Field description | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpc |
Field description | The total cost of all clicks divided by the total number of clicks received. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpe |
Field description | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpm |
Field description | Average cost-per-thousand impressions (CPM). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpv |
Field description | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_order_value_micros |
Field description | Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_page_views |
Field description | Average number of pages viewed per session. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_time_on_site |
Field description | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.bounce_rate |
Field description | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.clicks |
Field description | The number of clicks. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions |
Field description | 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_by_conversion_date |
Field description | 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_from_interactions_rate |
Field description | 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_from_interactions_value_per_interaction |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value_by_conversion_date |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value_per_cost |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_micros |
Field description | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_of_goods_sold_micros |
Field description | Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_all_conversions |
Field description | The cost of ad interactions divided by all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_conversion |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_current_model_attributed_conversion |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_device_conversions |
Field description | Conversions 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_device_conversions_value_micros |
Field description | The sum of the value of cross-device conversions, in micros. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_cost_of_goods_sold_micros |
Field description | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_gross_profit_micros |
Field description | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_revenue_micros |
Field description | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_units_sold |
Field description | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.ctr |
Field description | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions |
Field description | Shows 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_from_interactions_rate |
Field description | Current 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_from_interactions_value_per_interaction |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_value |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_value_per_cost |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.engagement_rate |
Field description | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.engagements |
Field description | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_forwards |
Field description | The number of times the ad was forwarded to someone else as a message. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_saves |
Field description | The number of times someone has saved your Gmail ad to their inbox as a message. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_secondary_clicks |
Field description | The number of clicks to the landing page on the expanded state of Gmail ads. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gross_profit_margin |
Field description | Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gross_profit_micros |
Field description | Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.impressions |
Field description | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.interaction_event_types |
Field description | The types of payable and free interactions. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v18.enums.InteractionEventTypeEnum.InteractionEventType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
metrics.interaction_rate |
Field description | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.interactions |
Field description | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_cost_of_goods_sold_micros |
Field description | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_gross_profit_micros |
Field description | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_revenue_micros |
Field description | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_units_sold |
Field description | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.new_customer_lifetime_value |
Field description | New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversions_value" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.orders |
Field description | Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.percent_new_visitors |
Field description | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_calls |
Field description | Number of offline phone calls. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_impressions |
Field description | Number of offline phone impressions. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_through_rate |
Field description | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.revenue_micros |
Field description | Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.top_impression_percentage |
Field description | The percent of your ad impressions that are shown adjacent to the top organic search results. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.units_sold |
Field description | Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_all_conversions |
Field description | The value of all conversions divided by the number of all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_all_conversions_by_conversion_date |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_conversion |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_conversions_by_conversion_date |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_current_model_attributed_conversion |
Field description | The 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p100_rate |
Field description | Percentage of impressions where the viewer watched all of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p25_rate |
Field description | Percentage of impressions where the viewer watched 25% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p50_rate |
Field description | Percentage of impressions where the viewer watched 50% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p75_rate |
Field description | Percentage of impressions where the viewer watched 75% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_view_rate |
Field description | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_views |
Field description | The number of times your video ads were viewed. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions |
Field description | The 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 (for example, clicking on) another ad. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|