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_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. 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 | 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.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 |
|