Search Ads 360 report transformation

This document describes how you can transform your reports forSearch Ads 360.

To see the Search Ads 360 report transformation that uses the oldSearch Ads 360 reporting API, seeSearch Ads 360 report transformation (Deprecated).

Table mapping for Search Ads 360 reports

When your Search Ads 360 reports are transferred toBigQuery, the reports are transformed into the followingBigQuery tables and views. When you view the tables and views inBigQuery, the value forcustomer_id is yourSearch Ads 360 customer ID.

ad_group

ad_group

Tables:
p_sa_AdGroup_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupStats_customer_id
Views:
sa_AdGroup_customer_id
sa_AdGroupConversionActionAndDeviceStats_customer_id
sa_AdGroupDeviceStats_customer_id
sa_AdGroupStats_customer_id

ad_group_ad

ad_group_ad

Tables:
p_sa_Ad_customer_id
p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id
Views:
a_Ad_customer_id
sa_AdConversionActionAndDeviceStats_customer_id
sa_AdDeviceStats_customer_id

ad_group_asset

ad_group_asset

Tables:
p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id
Views:
sa_AdGroupAssetStats_customer_id
sa_AdGroupConversionActionAndAssetStats_customer_id

ad_group_audience_view

ad_group_audience_view

Tables:
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
p_sa_AdGroupAudienceDeviceStats_customer_id
Views:
sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
sa_AdGroupAudienceDeviceStats_customer_id

ad_group_criterion

ad_group_criterion

Tables:
p_sa_AdGroupCriterion_customer_id
p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id
Views:
sa_AdGroupCriterion_customer_id
sa_NegativeAdGroupCriterion_customer_id
sa_NegativeAdGroupKeyword_customer_id

ad_group_label

ad_group_label

Tables:
p_sa_AdGroupLabel_customer_id
Views:
sa_AdGroupLabel_customer_id

age_range_view

age_range_view

Tables:
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
p_sa_AgeRangeDeviceStats_customer_id
Views:
sa_AgeRangeConversionActionAndDeviceStats_customer_id
sa_AgeRangeDeviceStats_customer_id

asset

asset

Tables:
p_sa_Asset_customer_id
Views:
sa_Asset_customer_id

asset_set_asset

asset_set_asset

Tables:
p_sa_AccountConversionActionAndAssetStats_customer_id
p_sa_AssetSetStats_customer_id
Views:
sa_AccountConversionActionAndAssetStats_customer_id
sa_AssetSetStats_customer_id

bidding_strategy

bidding_strategy

Tables:
p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
Views:
sa_BidStrategy_customer_id
sa_BidStrategyStats_customer_id

campaign

campaign

Tables:
p_sa_Campaign_customer_id
p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id
Views:
sa_Campaign_customer_id
sa_CampaignConversionActionAndDeviceStats_customer_id
sa_CampaignDeviceStats_customer_id
sa_CampaignStats_customer_id

campaign_asset

campaign_asset

Tables:
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
Views:
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id

campaign_audience_view

campaign_audience_view

Tables:
p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id
Views:
sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
sa_CampaignAudienceDeviceStats_customer_id

campaign_criterion

campaign_criterion

Tables:
p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id
Views:
sa_CampaignCriterion_customer_id
sa_NegativeCampaignCriterion_customer_id
sa_NegativeCampaignKeyword_customer_id

campaign_label

campaign_label

Tables:
p_sa_CampaignLabel_customer_id
Views:
sa_CampaignLabel_customer_id

cart_data_sales_view

cart_data_sales_view

Tables:
p_sa_CartDataSalesStats_customer_id
Views:
sa_CartDataSalesStats_customer_id

conversion

conversion

Tables:
p_sa_Conversion_customer_id
Views:
sa_Conversion_customer_id

conversion_action

conversion_action

Tables:
p_sa_ConversionAction_customer_id
Views:
sa_ConversionAction_customer_id

customer

customer

Tables:
p_sa_Account_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountStats_customer_id
Views:
sa_Account_customer_id
sa_AccountConversionActionAndDeviceStats_customer_id
sa_AccountDeviceStats_customer_id
sa_AccountStats_customer_id

customer_asset

customer_asset

Tables:
p_sa_AccountAssetStats_customer_id
Views:
sa_AccountAssetStats_customer_id

gender_view

gender_view

Tables:
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id
Views:
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id

keyword_view

keyword_view

Tables:
p_sa_Keyword_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id
Views:
sa_Keyword_customer_id
sa_KeywordConversionActionAndDeviceStats_customer_id
sa_KeywordDeviceStats_customer_id
sa_KeywordStats_customer_id

location_view

location_view

Tables:
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id
Views:
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id

product_group_view

product_group_view

Tables:
p_sa_ProductGroup_customer_id
p_sa_ProductGroupStats_customer_id
Views:
sa_ProductGroup_customer_id
sa_ProductGroupStats_customer_id

shopping_performance_view

shopping_performance_view

Tables:
p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id
Views:
sa_ProductAdvertised_customer_id
sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
sa_ProductAdvertisedDeviceStats_customer_id

visit

visit

Tables:
p_sa_Visit_customer_id
Views:
sa_Visit_customer_id

webpage_view

webpage_view

Tables:
p_sa_WebpageConversionActionAndDeviceStats_customer_id
p_sa_WebpageDeviceStats_customer_id
Views:
sa_WebpageConversionActionAndDeviceStats_customer_id
sa_WebpageDeviceStats_customer_id

Column details for Search Ads 360 reports

The BigQuery tables created by a Search Ads 360 transfer consist of the following columns (fields):

Search Ads 360 Table Name: Account

Search Ads 360 API Resource:customer

Search Ads 360 Field NameDescription
customer_account_levelThe account level of the customer: Manager, Sub-manager, Associate manager or Service account.
customer_account_typeEngine account type. For example: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_creation_timeThe timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
customer_currency_codeThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
customer_descriptive_nameOptional, non-unique descriptive name of the customer.
customer_manager_descriptive_nameThe descriptive name of the manager.
customer_sub_manager_descriptive_nameThe descriptive name of the sub manager.
customer_associate_manager_descriptive_nameThe descriptive name of the associate manager.
customer_engine_idID of the account in the external engine account.
customer_idThe ID of the customer.
customer_manager_idThe customer ID of the manager.
customer_sub_manager_idThe customer ID of the sub manager.
customer_associate_manager_idThe customer ID of the associate manager.
customer_last_modified_timeThe datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
customer_statusThe status of the customer.
customer_time_zoneThe local timezone ID of the customer.

Search Ads 360 Table Name: AccountAssetStats

Search Ads 360 API Resource:customer_asset

Search Ads 360 Field NameDescription
customer_asset_assetRequired. Immutable. The asset which is linked to the customer.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: AccountConversionActionAndAssetStats

Search Ads 360 API Resource:asset_set_asset

Search Ads 360 Field NameDescription
asset_set_asset_assetImmutable. The asset which this asset set asset is linking to.
asset_set_asset_asset_setImmutable. The asset set which this asset set asset is linking to.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: AccountConversionActionAndDeviceStats

Search Ads 360 API Resource:customer

Search Ads 360 Field NameDescription
customer_engine_idID of the account in the external engine account.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AccountDeviceStats

Search Ads 360 API Resource:customer

Search Ads 360 Field NameDescription
customer_engine_idID of the account in the external engine account.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
metrics_visitsClicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AccountStats

Search Ads 360 API Resource:customer

Search Ads 360 Field NameDescription
customer_engine_idID of the account in the external engine account.
customer_idThe ID of the customer.
metrics_content_budget_lost_impression_shareThe 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.
metrics_content_impression_shareThe 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.
metrics_content_rank_lost_impression_shareThe 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.
metrics_historical_quality_scoreThe historical quality score.
metrics_search_budget_lost_impression_shareThe 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.
metrics_search_impression_shareThe 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.
metrics_search_rank_lost_impression_shareThe 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.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: Ad

Search Ads 360 API Resource:ad_group_ad

Search Ads 360 Field NameDescription
ad_group_ad_ad_display_urlThe URL that appears in the ad description for some ad formats.
ad_group_ad_ad_expanded_dynamic_search_ad_description1The first line of the ad's description.
ad_group_ad_ad_expanded_dynamic_search_ad_description2The second line of the ad's description.
ad_group_ad_ad_expanded_text_ad_description1The first line of the ad's description.
ad_group_ad_ad_expanded_text_ad_description2The second line of the ad's description.
ad_group_ad_ad_expanded_text_ad_headlineThe headline of the ad.
ad_group_ad_ad_expanded_text_ad_headline2The second headline of the ad.
ad_group_ad_ad_expanded_text_ad_headline3The third headline of the ad.
ad_group_ad_ad_final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
ad_group_ad_ad_idThe ID of the ad.
ad_group_ad_ad_nameThe 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 only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
ad_group_ad_ad_text_ad_description1The first line of the ad's description.
ad_group_ad_ad_text_ad_description2The second line of the ad's description.
ad_group_ad_ad_text_ad_headlineThe headline of the ad.
ad_group_ad_ad_typeThe type of ad.
ad_group_ad_creation_timeThe 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.
ad_group_ad_engine_idID of the ad in the external engine account. This field is for SearchAds 360 account only. For example: Yahoo Japan, Microsoft, Baidu. For non-SearchAds 360 entity, use "ad_group_ad.ad.id" instead.
ad_group_ad_engine_statusAdditional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review.
ad_group_ad_labelsThe resource names of labels attached to this ad group ad.
ad_group_ad_last_modified_timeThe 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.
ad_group_ad_statusThe status of the ad.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: AdConversionActionAndDeviceStats

Search Ads 360 API Resource:ad_group_ad

Search Ads 360 Field NameDescription
ad_group_ad_ad_idThe ID of the ad.
ad_group_ad_engine_idID of the ad in the external engine account. This field is for SearchAds 360 account only. For example: Yahoo Japan, Microsoft, Baidu. For non-SearchAds 360 entity, use "ad_group_ad.ad.id" instead.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_by_conversion_dateThe 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. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_all_conversions_valueThe value of all conversions.
metrics_all_conversions_value_by_conversion_dateThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_by_conversion_dateThe number of cross-device conversions by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
metrics_cross_device_conversions_value_by_conversion_dateThe sum of cross-device conversions value by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AdDeviceStats

Search Ads 360 API Resource:ad_group_ad

Search Ads 360 Field NameDescription
ad_group_ad_ad_idThe ID of the ad.
ad_group_ad_engine_idID of the ad in the external engine account. This field is for SearchAds 360 account only. For example: Yahoo Japan, Microsoft, Baidu. For non-SearchAds 360 entity, use "ad_group_ad.ad.id" instead.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
metrics_visitsClicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AdGroup

Search Ads 360 API Resource:ad_group

Search Ads 360 Field NameDescription
ad_group_bid_modifier_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. The range is 1.0 - 6.0 for PreferredContent. Use 0 to opt out of a Device type.
ad_group_bid_modifier_device_typeType of the device.
ad_group_cpc_bid_microsThe maximum CPC (cost-per-click) bid.
ad_group_creation_timeThe 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.
ad_group_end_dateDate 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
ad_group_engine_idID of the ad group in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "ad_group.id" instead.
ad_group_engine_statusThe Engine Status for ad group.
ad_group_idThe ID of the ad group.
ad_group_labelsThe resource names of labels attached to this ad group.
ad_group_language_codeThe language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts.
ad_group_last_modified_timeThe 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.
ad_group_nameThe name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
ad_group_start_dateDate 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
ad_group_statusThe status of the ad group.
ad_group_targeting_setting_target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
bidding_strategy_idThe ID of the bidding strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: AdGroupAssetStats

Search Ads 360 API Resource:ad_group_asset

Search Ads 360 Field NameDescription
ad_group_asset_ad_groupRequired. Immutable. The ad group to which the asset is linked.
ad_group_asset_assetRequired. Immutable. The asset which is linked to the ad group.
ad_group_engine_idID of the ad group in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "ad_group.id" instead.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: AdGroupAudienceConversionActionAndDeviceStats

Search Ads 360 API Resource:ad_group_audience_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17.
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AdGroupAudienceDeviceStats

Search Ads 360 API Resource:ad_group_audience_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AdGroupConversionActionAndAssetStats

Search Ads 360 API Resource:ad_group_asset

Search Ads 360 Field NameDescription
ad_group_asset_ad_groupRequired. Immutable. The ad group to which the asset is linked.
ad_group_asset_assetRequired. Immutable. The asset which is linked to the ad group.
ad_group_engine_idID of the ad group in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "ad_group.id" instead.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2018-04-17

Search Ads 360 Table Name: AdGroupConversionActionAndDeviceStats

Search Ads 360 API Resource:ad_group

Search Ads 360 Field NameDescription
ad_group_engine_idOutput 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. For Google Ads entity, use "ad_group.id" instead.
ad_group_idOutput only. The ID of the ad group.
bidding_strategy_idOutput only. The ID of the bidding strategy.
campaign_idOutput only. The ID of the campaign.
customer_idOutput only. The ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AdGroupCriterion

Search Ads 360 API Resource:ad_group_criterion

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_creation_timeThe timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_last_modified_timeThe datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
ad_group_criterion_typeThe type of the criterion.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
ad_group_nameThe name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
ad_group_statusThe status of the ad group.
campaign_idThe ID of the campaign.
campaign_nameThe name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
campaign_statusThe status of the campaign.
customer_account_typeEngine account type. For example: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_descriptive_nameOptional, non-unique descriptive name of the customer.
customer_idThe ID of the customer.

Search Ads 360 Table Name: AdGroupDeviceStats

Search Ads 360 API Resource:ad_group

Search Ads 360 Field NameDescription
ad_group_engine_idID of the ad group in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "ad_group.id" instead.
ad_group_idThe ID of the ad group.
bidding_strategy_idThe ID of the bidding strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
metrics_visitsClicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AdGroupLabel

Search Ads 360 API Resource:ad_group_label

Search Ads 360 Field NameDescription
ad_group_label_ad_groupThe ad group to which the label is attached.
ad_group_label_labelThe label assigned to the ad group.
ad_group_label_owner_customer_idThe ID of the Customer which owns the label.
ad_group_label_resource_nameThe resource name of the ad group label. Ad group label resource names have the form: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: AdGroupStats

Search Ads 360 API Resource:ad_group

Search Ads 360 Field NameDescription
ad_group_engine_idID of the ad group in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "ad_group.id" instead.
ad_group_idThe ID of the ad group.
bidding_strategy_idThe ID of the bidding strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_content_impression_shareThe 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.
metrics_content_rank_lost_impression_shareThe 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.
metrics_historical_quality_scoreThe historical quality score.
metrics_search_impression_shareThe 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.
metrics_search_rank_lost_impression_shareThe 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.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17.

Search Ads 360 Table Name: AgeRangeConversionActionAndDeviceStats

Search Ads 360 API Resource:age_range_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: AgeRangeDeviceStats

Search Ads 360 API Resource:age_range_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: Asset

Search Ads 360 API Resource:asset

Search Ads 360 Field NameDescription
asset_creation_timeThe timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
asset_engine_statusThe Engine Status of the asset.
asset_final_urlsA list of possible final URLs after all cross domain redirects.
asset_idThe ID of the asset.
asset_last_modified_timeThe datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
asset_sitelink_asset.description1First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
asset_sitelink_asset.description2Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
asset_sitelink_asset_link_textURL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
asset_statusThe status of the asset.
asset_tracking_url_templateURL template for constructing a tracking URL.
customer_idThe ID of the customer.

Search Ads 360 Table Name: AssetSetStats

Search Ads 360 API Resource:asset_set_asset

Search Ads 360 Field NameDescription
asset_set_asset_assetImmutable. The asset which this asset set asset is linking to.
asset_set_asset_asset_setImmutable. The asset set which this asset set asset is linking to.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: BidStrategy

Search Ads 360 API Resource:bidding_strategy

Search Ads 360 Field NameDescription
bidding_strategy_idThe ID of the bidding strategy.
bidding_strategy_nameThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
bidding_strategy_statusThe status of the bidding strategy.
bidding_strategy_target_cpa_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_cpa_cpc_bid_floor_microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_cpa_target_cpa_microsAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
bidding_strategy_target_impression_share_cpc_bid_ceiling_microsThe highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.
bidding_strategy_target_outrank_share_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
bidding_strategy_target_roas_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_roas_cpc_bid_floor_microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_roas_target_roasThe chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
bidding_strategy_target_spend_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
bidding_strategy_target_spend_target_spend_microsThe spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used.
segments_conversion_actionResource name of the conversion action.

Search Ads 360 Table Name: BidStrategyStats

Search Ads 360 API Resource:bidding_strategy

Search Ads 360 Field NameDescription
bidding_strategy_idThe ID of the bidding strategy.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_by_conversion_dateThe 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. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_all_conversions_valueThe value of all conversions.
metrics_all_conversions_value_by_conversion_dateThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_by_conversion_dateThe number of cross-device conversions by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
metrics_cross_device_conversions_value_by_conversion_dateThe sum of cross-device conversions value by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: Campaign

Search Ads 360 API Resource:campaign

Search Ads 360 Field NameDescription
accessible_bidding_strategy_idThe ID of the bidding strategy.
accessible_bidding_strategy_nameThe name of the bidding strategy.
bidding_strategy_idThe ID of the bidding strategy.
bidding_strategy_nameThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
campaign_advertising_channel_sub_typeOptional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
campaign_advertising_channel_typeThe primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
campaign_bidding_strategy_typeThe type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only.
campaign_budget_amount_microsThe amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.
campaign_budget_delivery_methodThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
campaign_budget_periodPeriod over which to spend the budget. Defaults to DAILY if not specified.
campaign_creation_timeThe timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
campaign_end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.
campaign_engine_idID of the campaign in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "campaign.id" instead.
campaign_idThe ID of the campaign.
campaign_labelsThe resource names of labels attached to this campaign.
campaign_last_modified_timeThe datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
campaign_nameThe name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
campaign_network_settings_target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
campaign_network_settings_target_google_searchWhether ads will be served with google.com search results.
campaign_network_settings_target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
campaign_network_settings_target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
campaign_start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
campaign_statusThe status of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: CampaignAssetStats

Search Ads 360 API Resource:campaign_asset

Search Ads 360 Field NameDescription
campaign_asset_assetImmutable. The asset which is linked to the campaign.
campaign_asset_campaignImmutable. The campaign to which the asset is linked.
campaign_engine_idID of the campaign in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "campaign.id" instead.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: CampaignAudienceConversionActionAndDeviceStats

Search Ads 360 API Resource:campaign_audience_view

Search Ads 360 Field NameDescription
campaign_criterion_criterion_idThe ID of the criterion.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: CampaignAudienceDeviceStats

Search Ads 360 API Resource:campaign_audience_view

Search Ads 360 Field NameDescription
campaign_criterion_criterion_idThe ID of the criterion.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: CampaignConversionActionAndAssetStats

Search Ads 360 API Resource:campaign_asset

Search Ads 360 Field NameDescription
ad_group_idThe ID of the ad group.
campaign_asset_campaignImmutable. The campaign to which the asset is linked.
campaign_engine_idID of the campaign in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "campaign.id" instead.
campaign_idThe ID of the campaign.
campain_asset_assetImmutable. The asset which is linked to the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: CampaignConversionActionAndDeviceStats

Search Ads 360 API Resource:campaign

Search Ads 360 Field NameDescription
bidding_strategy_idThe ID of the bidding strategy.
campaign_engine_idID of the campaign in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "campaign.id" instead.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_by_conversion_dateThe 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. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_all_conversions_valueThe value of all conversions.
metrics_all_conversions_value_by_conversion_dateThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_by_conversion_dateThe number of cross-device conversions by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
metrics_cross_device_conversions_value_by_conversion_dateThe sum of cross-device conversions value by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: CampaignCriterion

Search Ads 360 API Resource:campaign_criterion

Search Ads 360 Field NameDescription
campaign_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
campaign_criterion_criterion_idThe ID of the criterion.
campaign_criterion_last_modified_timeThe datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
campaign_criterion_location_geo_target_constantThe geo target constant resource name.
campaign_criterion_statusThe status of the criterion.
campaign_criterion_typeThe type of the criterion.
campaign_criterion_user_list_user_listThe User List resource name.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: CampaignDeviceStats

Search Ads 360 API Resource:campaign

Search Ads 360 Field NameDescription
bidding_strategy_idThe ID of the bidding strategy.
campaign_engine_idID of the campaign in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "campaign.id" instead.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
metrics_visitsClicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: CampaignLabel

Search Ads 360 API Resource:campaign_label

Search Ads 360 Field NameDescription
campaign_idThe ID of the campaign.
campaign_label_campaignThe campaign to which the label is attached.
campaign_label_labelThe label assigned to the campaign.
campaign_label_owner_customer_idThe ID of the Customer which owns the label.
campaign_label_resource_name Name of the resource. Campaign label resource names have the form: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
customer_idThe ID of the customer.

Search Ads 360 Table Name: CampaignStats

Search Ads 360 API Resource:campaign

Search Ads 360 Field NameDescription
bidding_strategy_idThe ID of the bidding strategy.
campaign_engine_idID of the campaign in the external engine account. This field is for non-Google Ads account only. For example: Yahoo Japan, Microsoft, Baidu. For Google Ads entity, use "campaign.id" instead.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_content_budget_lost_impression_shareThe 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 greater than 0.9 is reported as 0.9001.
metrics_content_impression_shareThe 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 lower than 0.1 is reported as 0.0999.
metrics_content_rank_lost_impression_shareThe 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 greater than 0.9 is reported as 0.9001.
metrics_conversionsThe 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.
metrics_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_historical_quality_scoreThe historical quality score.
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
metrics_search_budget_lost_impression_shareThe 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.
metrics_search_impression_shareThe 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.
metrics_search_rank_lost_impression_shareThe 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.
metrics_visitsClicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: CartDataSalesStats

Search Ads 360 API Resource:cart_data_sales_view

Search Ads 360 Field NameDescription
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_client_account_cross_sell_gross_profit_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_gross_profit_micros
metrics_client_account_cross_sell_revenue_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_revenue_micros
metrics_client_account_cross_sell_units_soldhttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_units_sold
metrics_client_account_lead_gross_profit_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_gross_profit_micros
metrics_client_account_lead_revenue_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_revenue_micros
metrics_client_account_lead_units_soldhttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_units_sold
metrics_cross_sell_gross_profit_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_gross_profit_micros
metrics_cross_sell_revenue_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_revenue_micros
metrics_cross_sell_units_soldhttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_units_sold
metrics_lead_gross_profit_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_gross_profit_micros
metrics_lead_revenue_microshttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_revenue_micros
metrics_lead_units_soldhttps://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_units_sold
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_product_brandBrand of the product.
segments_product_item_idItem ID of the product.
segments_product_sold_brandBrand of the product sold.
segments_product_sold_item_idItem ID of the product sold.
segments_product_sold_titleTitle of the product sold.
segments_product_sold_type_l1Type (level 1) of the product sold.
segments_product_sold_type_l2Type (level 2) of the product sold.
segments_product_sold_type_l3Type (level 3) of the product sold.
segments_product_sold_type_l4Type (level 4) of the product sold.
segments_product_sold_type_l5Type (level 5) of the product sold.
segments_product_titleTitle of the product.
segments_product_type_l1Type (level 1) of the product.
segments_product_type_l2Type (level 2) of the product.
segments_product_type_l3Type (level 3) of the product.
segments_product_type_l4Type (level 4) of the product.
segments_product_type_l5Type (level 5) of the product.

Search Ads 360 Table Name: Conversion

Search Ads 360 API Resource:conversion

Search Ads 360 Field NameDescription
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
conversion_ad_idAd ID. A value of 0 indicates that the ad is unattributed.
conversion_advertiser_conversion_idFor offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the id column or the floodlight_order_id column depending on the advertiser's Floodlight instructions.
conversion_attribution_typeWhat the conversion is attributed to: Visit or Keyword+Ad.
conversion_click_idA unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the click id URL parameter.
conversion_conversion_date_timeThe timestamp of the conversion event.
conversion_conversion_last_modified_date_timeThe timestamp of the last time the conversion was modified.
conversion_conversion_quantityThe quantity of items recorded by the conversion, as determined by the qty url parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1.
conversion_conversion_revenue_microsThe adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.
conversion_conversion_visit_date_timeThe timestamp of the visit that the conversion is attributed to.
conversion_criterion_idSearch Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.
conversion_floodlight_order_idThe Floodlight order ID provided by the advertiser for the conversion.
conversion_floodlight_original_revenueThe original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.
conversion_idThe ID of the conversion
conversion_merchant_idThe SearchAds360 inventory account ID containing the product that was clicked on. SearchAds360 generates this ID when you link an inventory account in SearchAds360.
conversion_product_channelThe sales channel of the product that was clicked on: Online or Local.
conversion_product_country_codeThe country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.
conversion_product_idThe ID of the product clicked on.
conversion_product_language_codeThe language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.
conversion_product_store_idThe store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.
conversion_statusThe status of the conversion, either ENABLED or REMOVED.
conversion_visit_idThe SearchAds360 visit ID that the conversion is attributed to.
customer_account_typeEngine account type. For example: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_descriptive_nameOptional, non-unique descriptive name of the customer.
customer_idThe ID of the customer.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: ConversionAction

Search Ads 360 API Resource:conversion_action

Search Ads 360 Field NameDescription
conversion_action_creation_timeTimestamp of the Floodlight activity's creation, formatted in ISO 8601.
conversion_action_floodlight_settings_activity_group_tagString used to identify a Floodlight activity group when reporting conversions.
conversion_action_floodlight_settings_activity_idID of the Floodlight activity in DoubleClick Campaign Manager (DCM).
conversion_action_floodlight_settings_activity_tagString used to identify a Floodlight activity when reporting conversions.
conversion_action_nameThe name of the conversion action. This field is required and should not be empty when creating new conversion actions.
conversion_action_statusThe status of this conversion action for conversion event accrual.
conversion_action_typeThe type of this conversion action.

Search Ads 360 Table Name: GenderConversionActionAndDeviceStats

Search Ads 360 API Resource:gender_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: GenderDeviceStats

Search Ads 360 API Resource:gender_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: Keyword

Search Ads 360 API Resource:keyword_view

Search Ads 360 Field NameDescription
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_creation_timeThe timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_effective_cpc_bid_microsThe effective CPC (cost-per-click) bid.
ad_group_criterion_engine_idID of the ad group criterion in the external engine account. This field is for SearchAds 360 account only,. For example: Yahoo Japan, Microsoft, Baidu. For non-SearchAds 360 entity, use "ad_group_criterion.criterion_id" instead.
ad_group_criterion_engine_statusThe Engine Status for ad group criterion.
ad_group_criterion_final_url_suffixURL template for appending params to final URL.
ad_group_criterion_final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
ad_group_criterion_keyword_match_typeThe match type of the keyword.
ad_group_criterion_keyword_textThe text of the keyword (at most 80 characters and 10 words).
ad_group_criterion_labelsThe resource names of labels attached to this ad group criterion.
ad_group_criterion_last_modified_timeThe datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
ad_group_criterion_quality_info_quality_scoreThe quality score. This field may not be populated if Google does not have enough information to determine a value.
ad_group_criterion_statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
ad_group_criterion_tracking_url_templateThe URL template for constructing a tracking URL.
ad_group_idThe ID of the ad group.
bidding_strategy_idThe ID of the bidding strategy.
bidding_strategy_target_cpa_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_cpa_cpc_bid_floor_microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_impression_share_cpc_bid_ceiling_microsThe highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.
bidding_strategy_target_outrank_share_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
bidding_strategy_target_roas_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_roas_cpc_bid_floor_microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
bidding_strategy_target_spend_cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: KeywordConversionActionAndDeviceStats

Search Ads 360 API Resource:keyword_view

Search Ads 360 Field NameDescription
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_engine_idID of the ad group criterion in the external engine account. This field is for SearchAds 360 account only. For example: Yahoo Japan, Microsoft, Baidu. For non-SearchAds 360 entity, use "ad_group_criterion.criterion_id" instead.
ad_group_idThe ID of the ad group.
bidding_strategy_idThe ID of the bidding strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_by_conversion_dateThe 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. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_all_conversions_valueThe value of all conversions.
metrics_all_conversions_value_by_conversion_dateThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_by_conversion_dateThe number of cross-device conversions by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
metrics_cross_device_conversions_value_by_conversion_dateThe sum of cross-device conversions value by conversion date. For more information aboutby_conversion_date columns, seeAbout the "All conversions" column.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: KeywordDeviceStats

Search Ads 360 API Resource:keyword_view

Search Ads 360 Field NameDescription
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_engine_idID of the ad group criterion in the external engine account. This field is for SearchAds 360 account only. For example: Yahoo Japan, Microsoft, Baidu. For non-SearchAds 360 entity, use "ad_group_criterion.criterion_id" instead.
ad_group_idThe ID of the ad group.
bidding_strategy_idThe ID of the bidding strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
metrics_visitsClicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: KeywordStats

Search Ads 360 API Resource:keyword_view

Search Ads 360 Field NameDescription
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_idThe ID of the ad group.
bidding_strategy_idThe ID of the bidding strategy.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_historical_quality_scoreThe historical quality score.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: LocationConversionActionAndDeviceStats

Search Ads 360 API Resource:location_view

Search Ads 360 Field NameDescription
campaign_criterion_criterion_idThe ID of the criterion.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: LocationDeviceStats

Search Ads 360 API Resource:location_view

Search Ads 360 Field NameDescription
campaign_criterion_criterion_idThe ID of the criterion.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: NegativeAdGroupCriterion

Search Ads 360 API Resource:ad_group_criterion

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_creation_timeThe timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_last_modified_timeThe datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
ad_group_criterion_typeThe type of the criterion.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for web page targeting. The list of web page targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: NegativeAdGroupKeyword

Search Ads 360 API Resource:ad_group_criterion

Search Ads 360 Field NameDescription
ad_group_criterion_creation_timeThe timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_keyword_match_typeThe match type of the keyword.
ad_group_criterion_keyword_textThe text of the keyword (at most 80 characters and 10 words).
ad_group_criterion_last_modified_timeThe datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
ad_group_criterion_statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: NegativeCampaignCriterion

Search Ads 360 API Resource:campaign_criterion

Search Ads 360 Field NameDescription
campaign_criterion_age_range_typeType of the age range.
campaign_criterion_criterion_idThe ID of the criterion.
campaign_criterion_gender_typeType of the gender.
campaign_criterion_last_modified_timeThe datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
campaign_criterion_location_geo_target_constantThe geo target constant resource name.
campaign_criterion_statusThe status of the criterion.
campaign_criterion_typeThe type of the criterion.
campaign_criterion_user_list_user_listThe User List resource name.
campaign_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: NegativeCampaignKeyword

Search Ads 360 API Resource:campaign_criterion

Search Ads 360 Field NameDescription
campaign_criterion_criterion_idThe ID of the criterion.
campaign_criterion_keyword_match_typeThe match type of the keyword.
campaign_criterion_keyword_textThe text of the keyword (at most 80 characters and 10 words).
campaign_criterion_last_modified_timeThe datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
campaign_criterion_statusThe status of the criterion.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.

Search Ads 360 Table Name: ProductAdvertised

Search Ads 360 API Resource:shopping_performance_view

Search Ads 360 Field NameDescription
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_product_bidding_category_level1Bidding category (level 1) of the product.
segments_product_bidding_category_level2Bidding category (level 2) of the product.
segments_product_bidding_category_level3Bidding category (level 3) of the product.
segments_product_bidding_category_level4Bidding category (level 4) of the product.
segments_product_bidding_category_level5Bidding category (level 5) of the product.
segments_product_brandBrand of the product.
segments_product_channelChannel of the product.
segments_product_channel_exclusivityChannel exclusivity of the product.
segments_product_conditionCondition of the product.
segments_product_countryResource name of the geo target constant for the country of sale of the product.
segments_product_custom_attribute0Custom attribute 0 of the product.
segments_product_custom_attribute1Custom attribute 1 of the product.
segments_product_custom_attribute2Custom attribute 2 of the product.
segments_product_custom_attribute3Custom attribute 3 of the product.
segments_product_custom_attribute4Custom attribute 4 of the product.
segments_product_item_idItem ID of the product.
segments_product_languageResource name of the language constant for the language of the product.
segments_product_store_idStore ID of the product.
segments_product_titleTitle of the product.
segments_product_type_l1Type (level 1) of the product.
segments_product_type_l2Type (level 2) of the product.
segments_product_type_l3Type (level 3) of the product.
segments_product_type_l4Type (level 4) of the product.
segments_product_type_l5Type (level 5) of the product.

Search Ads 360 Table Name: ProductAdvertisedConversionActionAndDeviceStats

Search Ads 360 API Resource:shopping_performance_view

Search Ads 360 Field NameDescription
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments.conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.
segments_product_item_idItem ID of the product.

Search Ads 360 Table Name: ProductAdvertisedDeviceStats

Search Ads 360 API Resource:shopping_performance_view

Search Ads 360 Field NameDescription
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.
segments_product_item_idItem ID of the product.

Search Ads 360 Table Name: ProductGroup

Search Ads 360 API Resource:product_group_view

Search Ads 360 Field NameDescription
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_creation_timeOutput only. The timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
ad_group_criterion_criterion_idOutput only. The ID of the criterion.
ad_group_criterion_effective_cpc_bid_microsOutput only. The effective CPC (cost-per-click) bid.
ad_group_criterion_engine_statusOutput only. The Engine Status for ad group criterion.
ad_group_criterion_final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
ad_group_criterion_last_modified_timeOutput only. The datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
ad_group_criterion_listing_group_typeType of the listing group.
ad_group_criterion_statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
ad_group_criterion_tracking_url_templateThe URL template for constructing a tracking URL.
ad_group_idOutput only. The ID of the ad group.
campaign_idOutput only. The ID of the campaign.
customer_idThe ID of the customer.
product_group_view_resource_nameOutput only. The resource name of the product group view. Product group view resource names have the form: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

Search Ads 360 Table Name: ProductGroupStats

Search Ads 360 API Resource:product_group_view

Search Ads 360 Field NameDescription
ad_group_criterion_criterion_idOutput only. The ID of the criterion.
ad_group_idOutput only. The ID of the ad group.
campaign_idOutput only. The ID of the campaign.
customer_idThe ID of the customer.
metrics_all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
metrics_all_conversions_valueThe value of all conversions.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17

Search Ads 360 Table Name: Visit

Search Ads 360 API Resource:visit

Search Ads 360 Field NameDescription
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_account_typeEngine account type. For example: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_descriptive_nameOptional, non-unique descriptive name of the customer.
customer_idThe ID of the customer.
segments_ad_network_typeAd network type.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.
visit_ad_idAd ID. A value of 0 indicates that the ad is unattributed.
visit_click_idA unique string for each visit that is passed to the landing page as the click id URL parameter.
visit_criterion_idSearch Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed..
visit_idThe ID of the visit.
visit_merchant_idThe Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.
visit_product_channelThe sales channel of the product that was clicked on: Online or Local.
visit_product_country_codeThe country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.
visit_product_idThe ID of the product clicked on.
visit_product_language_codeThe language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.
visit_product_store_idThe store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.
visit_visit_date_timeThe timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

Search Ads 360 Table Name: WebpageConversionActionAndDeviceStats

Search Ads 360 API Resource:webpage_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_cross_device_conversionsConversions 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.
metrics_cross_device_conversions_valueThe sum of the value of cross-device conversions.
segments_conversion_action_nameConversion action name.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Table Name: WebpageDeviceStats

Search Ads 360 API Resource:webpage_view

Search Ads 360 Field NameDescription
ad_group_criterion_age_range_typeType of the age range.
ad_group_criterion_bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
ad_group_criterion_cpc_bid_microsThe CPC (cost-per-click) bid.
ad_group_criterion_criterion_idThe ID of the criterion.
ad_group_criterion_gender_typeType of the gender.
ad_group_criterion_location_geo_target_constantThe geo target constant resource name.
ad_group_criterion_user_list_user_listThe User List resource name.
ad_group_criterion_webpage_conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage.
ad_group_idThe ID of the ad group.
campaign_idThe ID of the campaign.
customer_idThe ID of the customer.
metrics_average_cpcThe total cost of all clicks divided by the total number of clicks received.
metrics_average_cpmAverage cost-per-thousand impressions (CPM).
metrics_clicksThe number of clicks.
metrics_client_account_conversionsThe 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.
metrics_client_account_conversions_valueThe 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.
metrics_client_account_view_through_conversionsThe 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.
metrics_cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
metrics_ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
metrics_impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
segments_dateDate to which metrics apply, in yyyy-MM-dd format. For example: 2024-04-17
segments_deviceDevice to which metrics apply.

Search Ads 360 Match Tables

Search Ads 360 Match Tables are tables that contain onlyAttribute fields (fields containing settings or other fixed data), and they are defined for users to query account structure information. If you use the refresh window or schedule a backfill, Match Table snapshots are not updated.

Below is a list of Match Tables in Search Ads 360 transfer:

  • Account
  • Ad
  • AdGroup
  • AdGroupCriterion
  • AnyID mapping table
  • Asset
  • BidStrategy
  • Campaign
  • CampaignCriterion
  • ConversionAction
  • Keyword
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.