ad_group.ad_rotation_mode |
Field description | The ad rotation mode of the ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
OPTIMIZE ROTATE_FOREVER UNKNOWN UNSPECIFIED
|
Type URL | google.ads.searchads360.v0.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.cpc_bid_micros |
Field description | The maximum CPC (cost-per-click) bid. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.creation_time |
Field description | Output only. The timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. |
Category | ATTRIBUTE |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.end_date |
Field description | Output only. Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 |
Category | ATTRIBUTE |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.engine_id |
Field description | Output only. ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.engine_status |
Field description | Output only. The Engine Status for ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
ACCOUNT_PAUSED AD_GROUP_DRAFT AD_GROUP_ELIGIBLE AD_GROUP_EXPIRED AD_GROUP_PAUSED AD_GROUP_REMOVED AD_GROUP_SERVING AD_GROUP_SUBMITTED CAMPAIGN_PAUSED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.searchads360.v0.enums.AdGroupEngineStatusEnum.AdGroupEngineStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.id |
Field description | Output only. The ID of the ad group. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.labels |
Field description | Output only. The resource names of labels attached to this ad group. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
ad_group.last_modified_time |
Field description | Output only. The datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. |
Category | ATTRIBUTE |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.name |
Field description | The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.resource_name |
Field description | Immutable. The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id} |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group.start_date |
Field description | Output only. Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 |
Category | ATTRIBUTE |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.status |
Field description | The status of the ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.searchads360.v0.enums.AdGroupStatusEnum.AdGroupStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.targeting_setting.target_restrictions |
Field description | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.searchads360.v0.common.TargetRestriction |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group.type |
Field description | Immutable. The type of the ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
DISPLAY_STANDARD HOTEL_ADS PROMOTED_HOTEL_ADS SEARCH_DYNAMIC_ADS SEARCH_STANDARD SHOPPING_COMPARISON_LISTING_ADS SHOPPING_PRODUCT_ADS SHOPPING_SHOWCASE_ADS SHOPPING_SMART_ADS SMART_CAMPAIGN_ADS TRAVEL_ADS UNKNOWN UNSPECIFIED VIDEO_BUMPER VIDEO_EFFICIENT_REACH VIDEO_NON_SKIPPABLE_IN_STREAM VIDEO_OUTSTREAM VIDEO_RESPONSIVE VIDEO_TRUE_VIEW_IN_DISPLAY VIDEO_TRUE_VIEW_IN_STREAM
|
Type URL | google.ads.searchads360.v0.enums.AdGroupTypeEnum.AdGroupType |
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 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.searchads360.v0.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.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.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.searchads360.v0.enums.DeviceEnum.Device |
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.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.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 | The percent of your ad impressions that are shown as the very first ad above the organic search results. |
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_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.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_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.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.client_account_conversions |
Field description | The number of client account conversions. This only includes conversion actions which include_in_client_account_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.client_account_conversions_value |
Field description | The value of client account conversions. This only includes conversion actions which include_in_client_account_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.client_account_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 |
|
metrics.content_budget_lost_impression_share |
Field description | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_impression_share |
Field description | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_rank_lost_impression_share |
Field description | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
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_value |
Field description | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
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.cross_device_conversions |
Field description | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_device_conversions_value |
Field description | The sum of the value of cross-device conversions. |
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.historical_quality_score |
Field description | The historical quality score. |
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.search_absolute_top_impression_share |
Field description | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_absolute_top_impression_share |
Field description | The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_impression_share |
Field description | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_top_impression_share |
Field description | The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_impression_share |
Field description | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_absolute_top_impression_share |
Field description | The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_impression_share |
Field description | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_top_impression_share |
Field description | The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_top_impression_share |
Field description | The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
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 anywhere above the organic search results. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.visits |
Field description | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|