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.ad_tracking_id |
| Field description | The tracking 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.expanded_dynamic_search_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.expanded_dynamic_search_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.expanded_text_ad.ad_tracking_id |
| Field description | The tracking 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.expanded_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.expanded_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.expanded_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.expanded_text_ad.headline2 |
| Field description | The second 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.expanded_text_ad.headline3 |
| Field description | The third 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.expanded_text_ad.path1 |
| Field description | Text appended to the auto-generated visible URL with a delimiter. |
| 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 | Text appended to path1 with a delimiter. |
| 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.searchads360.v0.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.id |
| Field description | 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.name |
| Field description | 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. |
| 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 | 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_search_ad.ad_tracking_id |
| Field description | The tracking 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.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.searchads360.v0.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.searchads360.v0.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad_group_ad.ad.responsive_search_ad.path1 |
| Field description | Text appended to the auto-generated visible URL with a delimiter. |
| 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 | Text appended to path1 with a delimiter. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad_group_ad.ad.text_ad.ad_tracking_id |
| Field description | The tracking 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.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.display_mobile_url |
| Field description | The displayed mobile URL of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad_group_ad.ad.text_ad.display_url |
| Field description | The displayed URL of the ad. |
| 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.type |
| Field description | The type of ad. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
APP_AD APP_ENGAGEMENT_AD APP_PRE_REGISTRATION_AD CALL_ONLY_AD DISCOVERY_CAROUSEL_AD DISCOVERY_MULTI_ASSET_AD DISCOVERY_VIDEO_RESPONSIVE_AD DYNAMIC_HTML5_AD EXPANDED_DYNAMIC_SEARCH_AD EXPANDED_TEXT_AD GMAIL_AD HOTEL_AD HTML5_UPLOAD_AD IMAGE_AD LEGACY_APP_INSTALL_AD LEGACY_RESPONSIVE_DISPLAY_AD LOCAL_AD MULTIMEDIA_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_DISCOVERY_AD VIDEO_TRUEVIEW_IN_STREAM_AD
|
| Type URL | google.ads.searchads360.v0.enums.AdTypeEnum.AdType |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad_group_ad.creation_time |
| Field description | The timestamp when this ad_group_ad was created. 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_ad.effective_labels |
| Field description | The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad_group_ad.engine_id |
| Field description | ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use "ad_group_ad.ad.id" instead. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad_group_ad.engine_status |
| Field description | Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
AD_GROUP_AD_ACCOUNT_PAUSED AD_GROUP_AD_AD_GROUP_PAUSED AD_GROUP_AD_APPROVED AD_GROUP_AD_CAMPAIGN_PAUSED AD_GROUP_AD_DISAPPROVED AD_GROUP_AD_ELIGIBLE AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW AD_GROUP_AD_NOT_REVIEWED AD_GROUP_AD_ON_HOLD AD_GROUP_AD_PARTIALLY_INVALID AD_GROUP_AD_PAUSED AD_GROUP_AD_PENDING_REVIEW AD_GROUP_AD_REMOVED AD_GROUP_AD_SERVING AD_GROUP_AD_TO_BE_ACTIVATED AD_GROUP_AD_UNDER_REVIEW UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.searchads360.v0.enums.AdGroupAdEngineStatusEnum.AdGroupAdEngineStatus |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad_group_ad.labels |
| Field description | 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.last_modified_time |
| Field description | The datetime when this ad group ad 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_ad.resource_name |
| Field description | 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.searchads360.v0.enums.AdGroupAdStatusEnum.AdGroupAdStatus |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
segments.ad_network_type |
| Field description | Ad network type. |
| Category | SEGMENT |
| Data Type |
ENUM
CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH
|
| Type URL | google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType |
| 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.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.searchads360.v0.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.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.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/sa360/answer/9250611. |
| 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/sa360/answer/9250611. |
| 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.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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
| 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_by_conversion_date |
| Field description | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611. |
| 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.cross_device_conversions_value_by_conversion_date |
| Field description | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611. |
| 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.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.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 |
|