- JSON representation
- AssetGroupProductGroupView
- CallView
- CallTrackingDisplayLocation
- CallType
- GoogleVoiceCallStatus
- ChangeEvent
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
- ResourceChangeOperation
- HotelReconciliation
- HotelReconciliationStatus
- Metrics
- InteractionEventType
- Segments
- AdDestinationType
- AdNetworkType
- BudgetCampaignAssociationStatus
- BudgetCampaignAssociationStatus
- ClickType
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- Keyword
- SearchEngineResultsPageType
- SearchTermMatchType
- Slot
- ConversionValueRulePrimaryDimension
- AssetInteractionTarget
A returned row from the query.
JSON representation | |
---|---|
{ "accountBudget": { object ( |
Fields | |
---|---|
accountBudget |
The account budget in the query. |
accountBudgetProposal |
The account budget proposal referenced in the query. |
accountLink |
The AccountLink referenced in the query. |
adGroup |
The ad group referenced in the query. |
adGroupAd |
The ad referenced in the query. |
adGroupAdAssetView |
The ad group ad asset view in the query. |
adGroupAdLabel |
The ad group ad label referenced in the query. |
adGroupAsset |
The ad group asset referenced in the query. |
adGroupAudienceView |
The ad group audience view referenced in the query. |
adGroupBidModifier |
The bid modifier referenced in the query. |
adGroupCriterion |
The criterion referenced in the query. |
adGroupCriterionCustomizer |
The ad group criterion customizer referenced in the query. |
adGroupCriterionLabel |
The ad group criterion label referenced in the query. |
adGroupCriterionSimulation |
The ad group criterion simulation referenced in the query. |
adGroupCustomizer |
The ad group customizer referenced in the query. |
adGroupExtensionSetting |
The ad group extension setting referenced in the query. |
adGroupFeed |
The ad group feed referenced in the query. |
adGroupLabel |
The ad group label referenced in the query. |
adGroupSimulation |
The ad group simulation referenced in the query. |
adParameter |
The ad parameter referenced in the query. |
ageRangeView |
The age range view referenced in the query. |
adScheduleView |
The ad schedule view referenced in the query. |
domainCategory |
The domain category referenced in the query. |
asset |
The asset referenced in the query. |
assetFieldTypeView |
The asset field type view referenced in the query. |
assetGroupAsset |
The asset group asset referenced in the query. |
assetGroupListingGroupFilter |
The asset group listing group filter referenced in the query. |
assetGroupProductGroupView |
The asset group product group view referenced in the query. |
assetGroup |
The asset group referenced in the query. |
assetSetAsset |
The asset set asset referenced in the query. |
assetSet |
The asset set referenced in the query. |
batchJob |
The batch job referenced in the query. |
biddingDataExclusion |
The bidding data exclusion referenced in the query. |
biddingSeasonalityAdjustment |
The bidding seasonality adjustment referenced in the query. |
biddingStrategy |
The bidding strategy referenced in the query. |
biddingStrategySimulation |
The bidding strategy simulation referenced in the query. |
billingSetup |
The billing setup referenced in the query. |
callView |
The call view referenced in the query. |
campaignBudget |
The campaign budget referenced in the query. |
campaign |
The campaign referenced in the query. |
campaignAsset |
The campaign asset referenced in the query. |
campaignAssetSet |
The campaign asset set referenced in the query. |
campaignAudienceView |
The campaign audience view referenced in the query. |
campaignBidModifier |
The campaign bid modifier referenced in the query. |
campaignConversionGoal |
The CampaignConversionGoal referenced in the query. |
campaignCriterion |
The campaign criterion referenced in the query. |
campaignCriterionSimulation |
The campaign criterion simulation referenced in the query. |
campaignCustomizer |
The campaign customizer referenced in the query. |
campaignDraft |
The campaign draft referenced in the query. |
campaignExperiment |
The campaign experiment referenced in the query. |
campaignExtensionSetting |
The campaign extension setting referenced in the query. |
campaignFeed |
The campaign feed referenced in the query. |
campaignLabel |
The campaign label referenced in the query. |
campaignSharedSet |
Campaign Shared Set referenced in AWQL query. |
campaignSimulation |
The campaign simulation referenced in the query. |
carrierConstant |
The carrier constant referenced in the query. |
changeEvent |
The ChangeEvent referenced in the query. |
changeStatus |
The ChangeStatus referenced in the query. |
combinedAudience |
The CombinedAudience referenced in the query. |
conversionAction |
The conversion action referenced in the query. |
conversionCustomVariable |
The conversion custom variable referenced in the query. |
conversionGoalCampaignConfig |
The ConversionGoalCampaignConfig referenced in the query. |
conversionValueRule |
The conversion value rule referenced in the query. |
conversionValueRuleSet |
The conversion value rule set referenced in the query. |
clickView |
The ClickView referenced in the query. |
currencyConstant |
The currency constant referenced in the query. |
customAudience |
The CustomAudience referenced in the query. |
customConversionGoal |
The CustomConversionGoal referenced in the query. |
customInterest |
The CustomInterest referenced in the query. |
customer |
The customer referenced in the query. |
customerAsset |
The customer asset referenced in the query. |
accessibleBiddingStrategy |
The accessible bidding strategy referenced in the query. |
customerCustomizer |
The customer customizer referenced in the query. |
customerManagerLink |
The CustomerManagerLink referenced in the query. |
customerClientLink |
The CustomerClientLink referenced in the query. |
customerClient |
The CustomerClient referenced in the query. |
customerConversionGoal |
The CustomerConversionGoal referenced in the query. |
customerExtensionSetting |
The customer extension setting referenced in the query. |
customerFeed |
The customer feed referenced in the query. |
customerLabel |
The customer label referenced in the query. |
customerNegativeCriterion |
The customer negative criterion referenced in the query. |
customerUserAccess |
The CustomerUserAccess referenced in the query. |
customerUserAccessInvitation |
The CustomerUserAccessInvitation referenced in the query. |
customizerAttribute |
The customizer attribute referenced in the query. |
detailPlacementView |
The detail placement view referenced in the query. |
detailedDemographic |
The detailed demographic referenced in the query. |
displayKeywordView |
The display keyword view referenced in the query. |
distanceView |
The distance view referenced in the query. |
dynamicSearchAdsSearchTermView |
The dynamic search ads search term view referenced in the query. |
expandedLandingPageView |
The expanded landing page view referenced in the query. |
extensionFeedItem |
The extension feed item referenced in the query. |
feed |
The feed referenced in the query. |
feedItem |
The feed item referenced in the query. |
feedItemSet |
The feed item set referenced in the query. |
feedItemSetLink |
The feed item set link referenced in the query. |
feedItemTarget |
The feed item target referenced in the query. |
feedMapping |
The feed mapping referenced in the query. |
feedPlaceholderView |
The feed placeholder view referenced in the query. |
genderView |
The gender view referenced in the query. |
geoTargetConstant |
The geo target constant referenced in the query. |
geographicView |
The geographic view referenced in the query. |
groupPlacementView |
The group placement view referenced in the query. |
hotelGroupView |
The hotel group view referenced in the query. |
hotelPerformanceView |
The hotel performance view referenced in the query. |
hotelReconciliation |
The hotel reconciliation referenced in the query. |
incomeRangeView |
The income range view referenced in the query. |
keywordView |
The keyword view referenced in the query. |
keywordPlan |
The keyword plan referenced in the query. |
keywordPlanCampaign |
The keyword plan campaign referenced in the query. |
keywordPlanCampaignKeyword |
The keyword plan campaign keyword referenced in the query. |
keywordPlanAdGroup |
The keyword plan ad group referenced in the query. |
keywordPlanAdGroupKeyword |
The keyword plan ad group referenced in the query. |
keywordThemeConstant |
The keyword theme constant referenced in the query. |
label |
The label referenced in the query. |
landingPageView |
The landing page view referenced in the query. |
languageConstant |
The language constant referenced in the query. |
locationView |
The location view referenced in the query. |
managedPlacementView |
The managed placement view referenced in the query. |
mediaFile |
The media file referenced in the query. |
mobileAppCategoryConstant |
The mobile app category constant referenced in the query. |
mobileDeviceConstant |
The mobile device constant referenced in the query. |
offlineUserDataJob |
The offline user data job referenced in the query. |
operatingSystemVersionConstant |
The operating system version constant referenced in the query. |
paidOrganicSearchTermView |
The paid organic search term view referenced in the query. |
parentalStatusView |
The parental status view referenced in the query. |
productBiddingCategoryConstant |
The Product Bidding Category referenced in the query. |
productGroupView |
The product group view referenced in the query. |
recommendation |
The recommendation referenced in the query. |
searchTermView |
The search term view referenced in the query. |
sharedCriterion |
The shared set referenced in the query. |
sharedSet |
The shared set referenced in the query. |
smartCampaignSetting |
The Smart campaign setting referenced in the query. |
shoppingPerformanceView |
The shopping performance view referenced in the query. |
smartCampaignSearchTermView |
The Smart campaign search term view referenced in the query. |
thirdPartyAppAnalyticsLink |
The AccountLink referenced in the query. |
topicView |
The topic view referenced in the query. |
userInterest |
The user interest referenced in the query. |
lifeEvent |
The life event referenced in the query. |
userList |
The user list referenced in the query. |
userLocationView |
The user location view referenced in the query. |
remarketingAction |
The remarketing action referenced in the query. |
topicConstant |
The topic constant referenced in the query. |
video |
The video referenced in the query. |
webpageView |
The webpage view referenced in the query. |
metrics |
The metrics. |
segments |
The segments. |
AssetGroupProductGroupView
An asset group product group view.
JSON representation | |
---|---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the asset group product group view. Asset group product group view resource names have the form:
|
CallView
A call view that includes data for call tracking of call-only ads or call extensions.
JSON representation | |
---|---|
{ "resourceName": string, "callerCountryCode": string, "callerAreaCode": string, "callDurationSeconds": string, "startCallDateTime": string, "endCallDateTime": string, "callTrackingDisplayLocation": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the call view. Call view resource names have the form:
|
callerCountryCode |
Output only. Country code of the caller. |
callerAreaCode |
Output only. Area code of the caller. Null if the call duration is shorter than 15 seconds. |
callDurationSeconds |
Output only. The advertiser-provided call duration in seconds. |
startCallDateTime |
Output only. The advertiser-provided call start date time. |
endCallDateTime |
Output only. The advertiser-provided call end date time. |
callTrackingDisplayLocation |
Output only. The call tracking display location. |
type |
Output only. The type of the call. |
callStatus |
Output only. The status of the call. |
CallTrackingDisplayLocation
Possible call tracking display locations.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
AD |
The phone call placed from the ad. |
LANDING_PAGE |
The phone call placed from the landing page ad points to. |
CallType
Possible types of property from where the call was made.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
MANUALLY_DIALED |
The phone call was manually dialed. |
HIGH_END_MOBILE_SEARCH |
The phone call was a mobile click-to-call. |
GoogleVoiceCallStatus
Possible statuses of a google voice call.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
MISSED |
The call was missed. |
RECEIVED |
The call was received. |
ChangeEvent
Describes the granular change of returned resource of certain resource types. Changes made through UI, API and new versions of Editor by external users (including external users, and internal users that can be shown externally) in the past 30 days will be shown. The change shows the old values of the changed fields before the change and the new values right after the change. ChangeEvent could have up to 3 minutes delay to reflect a new change.
JSON representation | |
---|---|
{ "resourceName": string, "changeDateTime": string, "changeResourceType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the change event. Change event resource names have the form:
|
changeDateTime |
Output only. Time at which the change was committed on this resource. |
changeResourceType |
Output only. The type of the changed resource. This dictates what resource will be set in oldResource and newResource. |
changeResourceName |
Output only. The Simply resource this change occurred on. |
clientType |
Output only. Where the change was made through. |
userEmail |
Output only. The email of the user who made this change. |
oldResource |
Output only. The old resource before the change. Only changed fields will be populated. |
newResource |
Output only. The new resource after the change. Only changed fields will be populated. |
resourceChangeOperation |
Output only. The operation on the changed resource. |
changedFields |
Output only. A list of fields that are changed in the returned resource. This is a comma-separated list of fully qualified names of fields. Example: |
campaign |
Output only. The Campaign affected by this change. |
adGroup |
Output only. The AdGroup affected by this change. |
feed |
Output only. The Feed affected by this change. |
feedItem |
Output only. The FeedItem affected by this change. |
asset |
Output only. The Asset affected by this change. |
ChangeEventResourceType
Enum listing the resource types support by the ChangeEvent resource.
Enums | |
---|---|
UNSPECIFIED |
No value has been specified. |
UNKNOWN |
Used for return value only. Represents an unclassified resource unknown in this version. |
AD |
An Ad resource change. |
AD_GROUP |
An AdGroup resource change. |
AD_GROUP_CRITERION |
An AdGroupCriterion resource change. |
CAMPAIGN |
A Campaign resource change. |
CAMPAIGN_BUDGET |
A CampaignBudget resource change. |
AD_GROUP_BID_MODIFIER |
An AdGroupBidModifier resource change. |
CAMPAIGN_CRITERION |
A CampaignCriterion resource change. |
FEED |
A Feed resource change. |
FEED_ITEM |
A FeedItem resource change. |
CAMPAIGN_FEED |
A CampaignFeed resource change. |
AD_GROUP_FEED |
An AdGroupFeed resource change. |
AD_GROUP_AD |
An AdGroupAd resource change. |
ASSET |
An Asset resource change. |
CUSTOMER_ASSET |
A CustomerAsset resource change. |
CAMPAIGN_ASSET |
A CampaignAsset resource change. |
AD_GROUP_ASSET |
An AdGroupAsset resource change. |
ChangeClientType
The source that the changeEvent resource was made through.
Enums | |
---|---|
UNSPECIFIED |
No value has been specified. |
UNKNOWN |
Used for return value only. Represents an unclassified client type unknown in this version. |
GOOGLE_ADS_WEB_CLIENT |
Changes made through the "ads.google.com". For example, changes made through campaign management. |
GOOGLE_ADS_AUTOMATED_RULE |
Changes made through Google Ads automated rules. |
GOOGLE_ADS_SCRIPTS |
Changes made through Google Ads scripts. |
GOOGLE_ADS_BULK_UPLOAD |
Changes made by Google Ads bulk upload. |
GOOGLE_ADS_API |
Changes made by Google Ads API. |
GOOGLE_ADS_EDITOR |
Changes made by Google Ads Editor. |
GOOGLE_ADS_MOBILE_APP |
Changes made by Google Ads mobile app. |
GOOGLE_ADS_RECOMMENDATIONS |
Changes made through Google Ads recommendations. |
SEARCH_ADS_360_SYNC |
Changes made through googleAds.search Ads 360 Sync. |
SEARCH_ADS_360_POST |
Changes made through googleAds.search Ads 360 Post. |
INTERNAL_TOOL |
Changes made through internal tools. For example, when a user sets a URL template on an entity like a Campaign, it's automatically wrapped with the SA360 Clickserver URL. |
OTHER |
Types of changes that are not categorized, for example, changes made by coupon redemption through Google Ads. |
ChangedResource
A wrapper proto presenting all supported resources. Only the resource of the changeResourceType will be set.
JSON representation | |
---|---|
{ "ad": { object ( |
Fields | |
---|---|
ad |
Output only. Set if changeResourceType == AD. |
adGroup |
Output only. Set if changeResourceType == AD_GROUP. |
adGroupCriterion |
Output only. Set if changeResourceType == AD_GROUP_CRITERION. |
campaign |
Output only. Set if changeResourceType == CAMPAIGN. |
campaignBudget |
Output only. Set if changeResourceType == CAMPAIGN_BUDGET. |
adGroupBidModifier |
Output only. Set if changeResourceType == AD_GROUP_BID_MODIFIER. |
campaignCriterion |
Output only. Set if changeResourceType == CAMPAIGN_CRITERION. |
feed |
Output only. Set if changeResourceType == FEED. |
feedItem |
Output only. Set if changeResourceType == FEED_ITEM. |
campaignFeed |
Output only. Set if changeResourceType == CAMPAIGN_FEED. |
adGroupFeed |
Output only. Set if changeResourceType == AD_GROUP_FEED. |
adGroupAd |
Output only. Set if changeResourceType == AD_GROUP_AD. |
asset |
Output only. Set if changeResourceType == ASSET. |
customerAsset |
Output only. Set if changeResourceType == CUSTOMER_ASSET. |
campaignAsset |
Output only. Set if changeResourceType == CAMPAIGN_ASSET. |
adGroupAsset |
Output only. Set if changeResourceType == AD_GROUP_ASSET. |
ResourceChangeOperation
The operation on the changed resource in changeEvent resource.
Enums | |
---|---|
UNSPECIFIED |
No value has been specified. |
UNKNOWN |
Used for return value only. Represents an unclassified operation unknown in this version. |
CREATE |
The resource was created. |
UPDATE |
The resource was modified. |
REMOVE |
The resource was removed. |
HotelReconciliation
A hotel reconciliation. It contains conversion information from Hotel bookings to reconcile with advertiser records. These rows may be updated or canceled before billing via Bulk Uploads.
JSON representation | |
---|---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"hotelCenterId": string,
"hotelId": string,
"checkInDate": string,
"checkOutDate": string,
"reconciledValueMicros": string,
"billed": boolean,
"status": enum ( |
Fields | |
---|---|
resourceName |
Immutable. The resource name of the hotel reconciliation. Hotel reconciliation resource names have the form:
|
commissionId |
Required. Output only. The commission ID is Google's ID for this booking. Every booking event is assigned a Commission ID to help you match it to a guest stay. |
orderId |
Output only. The order ID is the identifier for this booking as provided in the 'transaction_id' parameter of the conversion tracking tag. |
hotelCenterId |
Output only. Identifier for the Hotel Center account which provides the rates for the Hotel campaign. |
hotelId |
Output only. Unique identifier for the booked property, as provided in the Hotel Center feed. The hotel ID comes from the 'ID' parameter of the conversion tracking tag. |
checkInDate |
Output only. Check-in date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD. |
checkOutDate |
Output only. Check-out date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD. |
reconciledValueMicros |
Required. Output only. Reconciled value is the final value of a booking as paid by the guest. If original booking value changes for any reason, such as itinerary changes or room upsells, the reconciled value should be the full final amount collected. If a booking is canceled, the reconciled value should include the value of any cancellation fees or non-refundable nights charged. Value is in millionths of the base unit currency. For example, $12.35 would be represented as 12350000. Currency unit is in the default customer currency. |
billed |
Output only. Whether a given booking has been billed. Once billed, a booking can't be modified. |
status |
Required. Output only. Current status of a booking with regards to reconciliation and billing. Bookings should be reconciled within 45 days after the check-out date. Any booking not reconciled within 45 days will be billed at its original value. |
HotelReconciliationStatus
Status of the hotel booking reconciliation.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
RESERVATION_ENABLED |
Bookings are for a future date, or a stay is underway but the check-out date hasn't passed. An active reservation can't be reconciled. |
RECONCILIATION_NEEDED |
Check-out has already taken place, or the booked dates have passed without cancellation. Bookings that are not reconciled within 45 days of the check-out date are billed based on the original booking price. |
RECONCILED |
These bookings have been reconciled. Reconciled bookings are billed 45 days after the check-out date. |
CANCELED |
This booking was marked as canceled. Canceled stays with a value greater than zero (due to minimum stay rules or cancellation fees) are billed 45 days after the check-out date. |
Metrics
Metrics data.
JSON representation | |
---|---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionsValueByConversionDate": number, "conversionsByConversionDate": number, "historicalCreativeQualityScore": enum ( |
Fields | |
---|---|
allConversionsValueByConversionDate |
The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
allConversionsByConversionDate |
The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
conversionsValueByConversionDate |
The value of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
conversionsByConversionDate |
The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
historicalCreativeQualityScore |
The creative historical quality score. |
historicalLandingPageQualityScore |
The quality of historical landing page experience. |
historicalSearchPredictedCtr |
The historical search predicted click through rate (CTR). |
interactionEventTypes[] |
The types of payable and free interactions. |
skAdNetworkConversions |
The number of iOS Store Kit Ad Network conversions. |
absoluteTopImpressionPercentage |
The percent of your ad impressions that are shown as the very first ad above the organic search results. |
activeViewCpm |
Average cost of viewable impressions ( |
activeViewCtr |
Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
activeViewImpressions |
A measurement of how often your ad has become viewable on a Display Network site. |
activeViewMeasurability |
The ratio of impressions that could be measured by Active View over the number of served impressions. |
activeViewMeasurableCostMicros |
The cost of the impressions you received that were measurable by Active View. |
activeViewMeasurableImpressions |
The number of times your ads are appearing on placements in positions where they can be seen. |
activeViewViewability |
The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
allConversionsFromInteractionsRate |
All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
allConversionsValue |
The value of all conversions. |
allConversions |
The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. |
allConversionsValuePerCost |
The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
allConversionsFromClickToCall |
The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
allConversionsFromDirections |
The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
allConversionsFromInteractionsValuePerInteraction |
The value of all conversions from interactions divided by the total number of interactions. |
allConversionsFromMenu |
The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
allConversionsFromOrder |
The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
allConversionsFromOtherEngagement |
The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
allConversionsFromStoreVisit |
Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
allConversionsFromStoreWebsite |
The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
averageCost |
The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
averageCpc |
The total cost of all clicks divided by the total number of clicks received. |
averageCpe |
The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
averageCpm |
Average cost-per-thousand impressions (CPM). |
averageCpv |
The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
averagePageViews |
Average number of pages viewed per session. |
averageTimeOnSite |
Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
benchmarkAverageMaxCpc |
An indication of how other advertisers are bidding on similar products. |
benchmarkCtr |
An indication on how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad click on it. |
bounceRate |
Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
clicks |
The number of clicks. |
combinedClicks |
The number of times your ad or your site's listing in the unpaid results was clicked. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
combinedClicksPerQuery |
The number of times your ad or your site's listing in the unpaid results was clicked (combinedClicks) divided by combinedQueries. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
combinedQueries |
The number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
contentBudgetLostImpressionShare |
The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
contentImpressionShare |
The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
conversionLastReceivedRequestDateTime |
The last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (e.g. because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone. |
conversionLastConversionDate |
The date of the most recent conversion for this conversion action. The date is in the customer's time zone. |
contentRankLostImpressionShare |
The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversionsFromInteractionsRate |
Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversionsValue |
The value of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversionsValuePerCost |
The value of conversions divided by the cost of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversionsFromInteractionsValuePerInteraction |
The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions |
The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
costMicros |
The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
costPerAllConversions |
The cost of ad interactions divided by all conversions. |
costPerConversion |
The cost of ad interactions divided by conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
costPerCurrentModelAttributedConversion |
The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
crossDeviceConversions |
Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in allConversions. |
ctr |
The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
currentModelAttributedConversions |
Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsFromInteractionsRate |
Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsFromInteractionsValuePerInteraction |
The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsValue |
The value of current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsValuePerCost |
The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
engagementRate |
How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
engagements |
The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
hotelAverageLeadValueMicros |
Average lead value based on clicks. |
hotelPriceDifferencePercentage |
The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. |
hotelEligibleImpressions |
The number of impressions that hotel partners could have had given their feed performance. |
historicalQualityScore |
The historical quality score. |
gmailForwards |
The number of times the ad was forwarded to someone else as a message. |
gmailSaves |
The number of times someone has saved your Gmail ad to their inbox as a message. |
gmailSecondaryClicks |
The number of clicks to the landing page on the expanded state of Gmail ads. |
impressionsFromStoreReach |
The number of times a store's location-based ad was shown. This metric applies to feed items only. |
impressions |
Count of how often your ad has appeared on a search results page or website on the Google Network. |
interactionRate |
How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions |
The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalidClickRate |
The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalidClicks |
Number of clicks Google considers illegitimate and doesn't charge you for. |
messageChats |
Number of message chats initiated for Click To Message impressions that were message tracking eligible. |
messageImpressions |
Number of Click To Message impressions that were message tracking eligible. |
messageChatRate |
Number of message chats initiated (messageChats) divided by the number of message impressions (messageImpressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression. |
mobileFriendlyClicksPercentage |
The percentage of mobile clicks that go to a mobile-friendly page. |
optimizationScoreUplift |
Total optimization score uplift of all recommendations. |
optimizationScoreUrl |
URL for the optimization score page in the Google Ads web interface. This metric can be selected from |
organicClicks |
The number of times someone clicked your site's listing in the unpaid results for a particular query. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicClicksPerQuery |
The number of times someone clicked your site's listing in the unpaid results (organicClicks) divided by the total number of searches that returned pages from your site (organicQueries). See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicImpressions |
The number of listings for your site in the unpaid search results. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicImpressionsPerQuery |
The number of times a page from your site was listed in the unpaid search results (organicImpressions) divided by the number of searches returning your site's listing in the unpaid results (organicQueries). See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicQueries |
The total number of searches that returned your site's listing in the unpaid results. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
percentNewVisitors |
Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
phoneCalls |
Number of offline phone calls. |
phoneImpressions |
Number of offline phone impressions. |
phoneThroughRate |
Number of phone calls received (phoneCalls) divided by the number of times your phone number is shown (phoneImpressions). |
relativeCtr |
Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
searchAbsoluteTopImpressionShare |
The percentage of the customer's Shopping or googleAds.search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999. |
searchBudgetLostAbsoluteTopImpressionShare |
The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: googleAds.search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchBudgetLostImpressionShare |
The estimated percent of times that your ad was eligible to show on the googleAds.search Network but didn't because your budget was too low. Note: googleAds.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. |
searchBudgetLostTopImpressionShare |
The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: googleAds.search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchClickShare |
The number of clicks you've received on the googleAds.search Network divided by the estimated number of clicks you were eligible to receive. Note: googleAds.search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
searchExactMatchImpressionShare |
The impressions you've received divided by the estimated number of impressions you were eligible to receive on the googleAds.search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: googleAds.search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
searchImpressionShare |
The impressions you've received on the googleAds.search Network divided by the estimated number of impressions you were eligible to receive. Note: googleAds.search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
searchRankLostAbsoluteTopImpressionShare |
The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: googleAds.search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchRankLostImpressionShare |
The estimated percentage of impressions on the googleAds.search Network that your ads didn't receive due to poor Ad Rank. Note: googleAds.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. |
searchRankLostTopImpressionShare |
The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: googleAds.search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchTopImpressionShare |
The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: googleAds.search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
speedScore |
A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest. |
topImpressionPercentage |
The percent of your ad impressions that are shown anywhere above the organic search results. |
validAcceleratedMobilePagesClicksPercentage |
The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. |
valuePerAllConversions |
The value of all conversions divided by the number of all conversions. |
valuePerAllConversionsByConversionDate |
The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
valuePerConversion |
The value of conversions divided by the number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
valuePerConversionsByConversionDate |
The value of conversions divided by the number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
valuePerCurrentModelAttributedConversion |
The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
videoQuartileP100Rate |
Percentage of impressions where the viewer watched all of your video. |
videoQuartileP25Rate |
Percentage of impressions where the viewer watched 25% of your video. |
videoQuartileP50Rate |
Percentage of impressions where the viewer watched 50% of your video. |
videoQuartileP75Rate |
Percentage of impressions where the viewer watched 75% of your video. |
videoViewRate |
The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
videoViews |
The number of times your video ads were viewed. |
viewThroughConversions |
The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
InteractionEventType
Enum describing possible types of payable and free interactions.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
CLICK |
Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events. |
ENGAGEMENT |
The user's expressed intent to engage with the ad in-place. |
VIDEO_VIEW |
User viewed a video ad. |
NONE |
The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (i.e., the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions. |
Segments
Segment only fields.
JSON representation | |
---|---|
{ "adDestinationType": enum ( |
Fields | |
---|---|
adDestinationType |
Ad Destination type. |
adNetworkType |
Ad network type. |
budgetCampaignAssociationStatus |
Budget campaign association status. |
clickType |
Click type. |
conversionActionCategory |
Conversion action category. |
conversionAttributionEventType |
Conversion attribution event type. |
conversionLagBucket |
An enum value representing the number of days between the impression and the conversion. |
conversionOrAdjustmentLagBucket |
An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
dayOfWeek |
Day of the week, e.g., MONDAY. |
device |
Device to which metrics apply. |
externalConversionSource |
External conversion source. |
hotelCheckInDayOfWeek |
Hotel check-in day of week. |
hotelDateSelectionType |
Hotel date selection type. |
hotelRateType |
Hotel rate type. |
hotelPriceBucket |
Hotel price bucket. |
keyword |
Keyword criterion. |
monthOfYear |
Month of the year, e.g., January. |
placeholderType |
Placeholder type. This is only used with feed item metrics. |
productChannel |
Channel of the product. |
productChannelExclusivity |
Channel exclusivity of the product. |
productCondition |
Condition of the product. |
recommendationType |
Recommendation type. |
searchEngineResultsPageType |
Type of the search engine results page. |
searchTermMatchType |
Match type of the keyword that triggered the ad, including variants. |
slot |
Position of the ad. |
conversionValueRulePrimaryDimension |
Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. |
conversionAction |
Resource name of the conversion action. |
conversionActionName |
Conversion action name. |
conversionAdjustment |
This segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data. |
date |
Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
geoTargetAirport |
Resource name of the geo target constant that represents an airport. |
geoTargetCanton |
Resource name of the geo target constant that represents a canton. |
geoTargetCity |
Resource name of the geo target constant that represents a city. |
geoTargetCountry |
Resource name of the geo target constant that represents a country. |
geoTargetCounty |
Resource name of the geo target constant that represents a county. |
geoTargetDistrict |
Resource name of the geo target constant that represents a district. |
geoTargetMetro |
Resource name of the geo target constant that represents a metro. |
geoTargetMostSpecificLocation |
Resource name of the geo target constant that represents the most specific location. |
geoTargetPostalCode |
Resource name of the geo target constant that represents a postal code. |
geoTargetProvince |
Resource name of the geo target constant that represents a province. |
geoTargetRegion |
Resource name of the geo target constant that represents a region. |
geoTargetState |
Resource name of the geo target constant that represents a state. |
hotelBookingWindowDays |
Hotel booking window in days. |
hotelCenterId |
Hotel center ID. |
hotelCheckInDate |
Hotel check-in date. Formatted as yyyy-MM-dd. |
hotelCity |
Hotel city. |
hotelClass |
Hotel class. |
hotelCountry |
Hotel country. |
hotelLengthOfStay |
Hotel length of stay. |
hotelRateRuleId |
Hotel rate rule ID. |
hotelState |
Hotel state. |
hour |
Hour of day as a number between 0 and 23, inclusive. |
interactionOnThisExtension |
Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. |
month |
Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
partnerHotelId |
Partner hotel ID. |
productAggregatorId |
Aggregator ID of the product. |
productBiddingCategoryLevel1 |
Bidding category (level 1) of the product. |
productBiddingCategoryLevel2 |
Bidding category (level 2) of the product. |
productBiddingCategoryLevel3 |
Bidding category (level 3) of the product. |
productBiddingCategoryLevel4 |
Bidding category (level 4) of the product. |
productBiddingCategoryLevel5 |
Bidding category (level 5) of the product. |
productBrand |
Brand of the product. |
productCountry |
Resource name of the geo target constant for the country of sale of the product. |
productCustomAttribute0 |
Custom attribute 0 of the product. |
productCustomAttribute1 |
Custom attribute 1 of the product. |
productCustomAttribute2 |
Custom attribute 2 of the product. |
productCustomAttribute3 |
Custom attribute 3 of the product. |
productCustomAttribute4 |
Custom attribute 4 of the product. |
productItemId |
Item ID of the product. |
productLanguage |
Resource name of the language constant for the language of the product. |
productMerchantId |
Merchant ID of the product. |
productStoreId |
Store ID of the product. |
productTitle |
Title of the product. |
productTypeL1 |
Type (level 1) of the product. |
productTypeL2 |
Type (level 2) of the product. |
productTypeL3 |
Type (level 3) of the product. |
productTypeL4 |
Type (level 4) of the product. |
productTypeL5 |
Type (level 5) of the product. |
quarter |
Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
webpage |
Resource name of the ad group criterion that represents webpage criterion. |
week |
Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
year |
Year, formatted as yyyy. |
skAdNetworkConversionValue |
iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign. |
assetInteractionTarget |
Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (e.g. clicks) are counted across all the parts of the served ad (e.g. Ad itself and other components like Sitelinks) when they are served together. When interactionOnThisAsset is true, it means the interactions are on this specific asset and when interactionOnThisAsset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with. |
AdDestinationType
Enumerates Google Ads destination types
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
NOT_APPLICABLE |
Ads that don't intend to drive users off from ads to other destinations |
WEBSITE |
Website |
APP_DEEP_LINK |
App Deep Link |
APP_STORE |
iOS App Store or Play Store |
PHONE_CALL |
Call Dialer |
MAP_DIRECTIONS |
Map App |
LOCATION_LISTING |
Location Dedicated Page |
MESSAGE |
Text Message |
LEAD_FORM |
Lead Generation Form |
YOUTUBE |
YouTube |
UNMODELED_FOR_CONVERSIONS |
Ad Destination for Conversions with keys unknown |
AdNetworkType
Enumerates Google Ads network types.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
SEARCH |
Google search. |
SEARCH_PARTNERS |
googleAds.search partners. |
CONTENT |
Display Network. |
YOUTUBE_SEARCH |
YouTube googleAds.search. |
YOUTUBE_WATCH |
YouTube Videos |
MIXED |
Cross-network. |
BudgetCampaignAssociationStatus
A BudgetCampaignAssociationStatus segment.
JSON representation | |
---|---|
{
"status": enum ( |
Fields | |
---|---|
status |
Budget campaign association status. |
campaign |
The campaign resource name. |
BudgetCampaignAssociationStatus
Possible statuses of the association between the Budget and the Campaign.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ENABLED |
The campaign is currently using the budget. |
REMOVED |
The campaign is no longer using the budget. |
ClickType
Enumerates Google Ads click types.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
APP_DEEPLINK |
App engagement ad deep link. |
BREADCRUMBS |
Breadcrumbs. |
BROADBAND_PLAN |
Broadband Plan. |
CALL_TRACKING |
Manually dialed phone calls. |
CALLS |
Phone calls. |
CLICK_ON_ENGAGEMENT_AD |
Click on engagement ad. |
GET_DIRECTIONS |
Driving direction. |
LOCATION_EXPANSION |
Get location details. |
LOCATION_FORMAT_CALL |
Call. |
LOCATION_FORMAT_DIRECTIONS |
Directions. |
LOCATION_FORMAT_IMAGE |
Image(s). |
LOCATION_FORMAT_LANDING_PAGE |
Go to landing page. |
LOCATION_FORMAT_MAP |
Map. |
LOCATION_FORMAT_STORE_INFO |
Go to store info. |
LOCATION_FORMAT_TEXT |
Text. |
MOBILE_CALL_TRACKING |
Mobile phone calls. |
OFFER_PRINTS |
Print offer. |
OTHER |
Other. |
PRODUCT_EXTENSION_CLICKS |
Product plusbox offer. |
PRODUCT_LISTING_AD_CLICKS |
Shopping - Product - Online. |
SITELINKS |
Sitelink. |
STORE_LOCATOR |
Show nearby locations. |
URL_CLICKS |
Headline. |
VIDEO_APP_STORE_CLICKS |
App store. |
VIDEO_CALL_TO_ACTION_CLICKS |
Call-to-Action overlay. |
VIDEO_CARD_ACTION_HEADLINE_CLICKS |
Cards. |
VIDEO_END_CAP_CLICKS |
End cap. |
VIDEO_WEBSITE_CLICKS |
Website. |
VISUAL_SITELINKS |
Visual Sitelinks. |
WIRELESS_PLAN |
Wireless Plan. |
PRODUCT_LISTING_AD_LOCAL |
Shopping - Product - Local. |
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL |
Shopping - Product - MultiChannel Local. |
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE |
Shopping - Product - MultiChannel Online. |
PRODUCT_LISTING_ADS_COUPON |
Shopping - Product - Coupon. |
PRODUCT_LISTING_AD_TRANSACTABLE |
Shopping - Product - Sell on Google. |
PRODUCT_AD_APP_DEEPLINK |
Shopping - Product - App engagement ad deep link. |
SHOWCASE_AD_CATEGORY_LINK |
Shopping - Showcase - Category. |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK |
Shopping - Showcase - Local storefront. |
SHOWCASE_AD_ONLINE_PRODUCT_LINK |
Shopping - Showcase - Online product. |
SHOWCASE_AD_LOCAL_PRODUCT_LINK |
Shopping - Showcase - Local product. |
PROMOTION_EXTENSION |
Promotion Extension. |
SWIPEABLE_GALLERY_AD_HEADLINE |
Ad Headline. |
SWIPEABLE_GALLERY_AD_SWIPES |
Swipes. |
SWIPEABLE_GALLERY_AD_SEE_MORE |
See More. |
SWIPEABLE_GALLERY_AD_SITELINK_ONE |
Sitelink 1. |
SWIPEABLE_GALLERY_AD_SITELINK_TWO |
Sitelink 2. |
SWIPEABLE_GALLERY_AD_SITELINK_THREE |
Sitelink 3. |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR |
Sitelink 4. |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE |
Sitelink 5. |
HOTEL_PRICE |
Hotel price. |
PRICE_EXTENSION |
Price Extension. |
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION |
Book on Google hotel room selection. |
SHOPPING_COMPARISON_LISTING |
Shopping - Comparison Listing. |
ConversionAttributionEventType
The event type of conversions that are attributed to.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Represents value unknown in this version. |
IMPRESSION |
The conversion is attributed to an impression. |
INTERACTION |
The conversion is attributed to an interaction. |
ConversionLagBucket
Enum representing the number of days between impression and conversion.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
LESS_THAN_ONE_DAY |
Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
ONE_TO_TWO_DAYS |
Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
TWO_TO_THREE_DAYS |
Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
THREE_TO_FOUR_DAYS |
Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
FOUR_TO_FIVE_DAYS |
Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
FIVE_TO_SIX_DAYS |
Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
SIX_TO_SEVEN_DAYS |
Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
SEVEN_TO_EIGHT_DAYS |
Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
EIGHT_TO_NINE_DAYS |
Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
NINE_TO_TEN_DAYS |
Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
TEN_TO_ELEVEN_DAYS |
Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
ELEVEN_TO_TWELVE_DAYS |
Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
TWELVE_TO_THIRTEEN_DAYS |
Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
THIRTEEN_TO_FOURTEEN_DAYS |
Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
FOURTEEN_TO_TWENTY_ONE_DAYS |
Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
TWENTY_ONE_TO_THIRTY_DAYS |
Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
THIRTY_TO_FORTY_FIVE_DAYS |
Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
FORTY_FIVE_TO_SIXTY_DAYS |
Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
SIXTY_TO_NINETY_DAYS |
Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ConversionOrAdjustmentLagBucket
Enum representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
CONVERSION_LESS_THAN_ONE_DAY |
Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
CONVERSION_ONE_TO_TWO_DAYS |
Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
CONVERSION_TWO_TO_THREE_DAYS |
Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
CONVERSION_THREE_TO_FOUR_DAYS |
Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
CONVERSION_FOUR_TO_FIVE_DAYS |
Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
CONVERSION_FIVE_TO_SIX_DAYS |
Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
CONVERSION_SIX_TO_SEVEN_DAYS |
Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
CONVERSION_SEVEN_TO_EIGHT_DAYS |
Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
CONVERSION_EIGHT_TO_NINE_DAYS |
Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
CONVERSION_NINE_TO_TEN_DAYS |
Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
CONVERSION_TEN_TO_ELEVEN_DAYS |
Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
CONVERSION_ELEVEN_TO_TWELVE_DAYS |
Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
CONVERSION_TWELVE_TO_THIRTEEN_DAYS |
Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS |
Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS |
Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS |
Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS |
Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS |
Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
CONVERSION_SIXTY_TO_NINETY_DAYS |
Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ADJUSTMENT_LESS_THAN_ONE_DAY |
Conversion adjustment lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
ADJUSTMENT_ONE_TO_TWO_DAYS |
Conversion adjustment lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
ADJUSTMENT_TWO_TO_THREE_DAYS |
Conversion adjustment lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
ADJUSTMENT_THREE_TO_FOUR_DAYS |
Conversion adjustment lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
ADJUSTMENT_FOUR_TO_FIVE_DAYS |
Conversion adjustment lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
ADJUSTMENT_FIVE_TO_SIX_DAYS |
Conversion adjustment lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
ADJUSTMENT_SIX_TO_SEVEN_DAYS |
Conversion adjustment lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS |
Conversion adjustment lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
ADJUSTMENT_EIGHT_TO_NINE_DAYS |
Conversion adjustment lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
ADJUSTMENT_NINE_TO_TEN_DAYS |
Conversion adjustment lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
ADJUSTMENT_TEN_TO_ELEVEN_DAYS |
Conversion adjustment lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS |
Conversion adjustment lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS |
Conversion adjustment lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS |
Conversion adjustment lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS |
Conversion adjustment lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS |
Conversion adjustment lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS |
Conversion adjustment lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS |
Conversion adjustment lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
ADJUSTMENT_SIXTY_TO_NINETY_DAYS |
Conversion adjustment lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS |
Conversion adjustment lag bucket from 90 to 145 days. 90 days is included, 145 days is not. |
CONVERSION_UNKNOWN |
Conversion lag bucket UNKNOWN. This is for dates before conversion lag bucket was available in Google Ads. |
ADJUSTMENT_UNKNOWN |
Conversion adjustment lag bucket UNKNOWN. This is for dates before conversion adjustment lag bucket was available in Google Ads. |
ExternalConversionSource
The external conversion source that is associated with a ConversionAction.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Represents value unknown in this version. |
WEBPAGE |
Conversion that occurs when a user navigates to a particular webpage after viewing an ad; Displayed in Google Ads UI as 'Website'. |
ANALYTICS |
Conversion that comes from linked Google Analytics goal or transaction; Displayed in Google Ads UI as 'Analytics'. |
UPLOAD |
Website conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from clicks'. |
AD_CALL_METRICS |
Conversion that occurs when a user clicks on a call extension directly on an ad; Displayed in Google Ads UI as 'Calls from ads'. |
WEBSITE_CALL_METRICS |
Conversion that occurs when a user calls a dynamically-generated phone number (by installed javascript) from an advertiser's website after clicking on an ad; Displayed in Google Ads UI as 'Calls from website'. |
STORE_VISITS |
Conversion that occurs when a user visits an advertiser's retail store after clicking on a Google ad; Displayed in Google Ads UI as 'Store visits'. |
ANDROID_IN_APP |
Conversion that occurs when a user takes an in-app action such as a purchase in an Android app; Displayed in Google Ads UI as 'Android in-app action'. |
IOS_IN_APP |
Conversion that occurs when a user takes an in-app action such as a purchase in an iOS app; Displayed in Google Ads UI as 'iOS in-app action'. |
IOS_FIRST_OPEN |
Conversion that occurs when a user opens an iOS app for the first time; Displayed in Google Ads UI as 'iOS app install (first open)'. |
APP_UNSPECIFIED |
Legacy app conversions that do not have an AppPlatform provided; Displayed in Google Ads UI as 'Mobile app'. |
ANDROID_FIRST_OPEN |
Conversion that occurs when a user opens an Android app for the first time; Displayed in Google Ads UI as 'Android app install (first open)'. |
UPLOAD_CALLS |
Call conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from calls'. |
FIREBASE |
Conversion that comes from a linked Firebase event; Displayed in Google Ads UI as 'Firebase'. |
CLICK_TO_CALL |
Conversion that occurs when a user clicks on a mobile phone number; Displayed in Google Ads UI as 'Phone number clicks'. |
SALESFORCE |
Conversion that comes from Salesforce; Displayed in Google Ads UI as 'Salesforce.com'. |
STORE_SALES_CRM |
Conversion that comes from in-store purchases recorded by CRM; Displayed in Google Ads UI as 'Store sales (data partner)'. |
STORE_SALES_PAYMENT_NETWORK |
Conversion that comes from in-store purchases from payment network; Displayed in Google Ads UI as 'Store sales (payment network)'. |
GOOGLE_PLAY |
Codeless Google Play conversion; Displayed in Google Ads UI as 'Google Play'. |
THIRD_PARTY_APP_ANALYTICS |
Conversion that comes from a linked third-party app analytics event; Displayed in Google Ads UI as 'Third-party app analytics'. |
GOOGLE_ATTRIBUTION |
Conversion that is controlled by Google Attribution. |
STORE_SALES_DIRECT_UPLOAD |
Store Sales conversion based on first-party or third-party merchant data uploads. Displayed in Google Ads UI as 'Store sales (direct upload)'. |
STORE_SALES |
Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Displayed in Google Ads UI as 'Store sales'. |
SEARCH_ADS_360 |
Conversions imported from googleAds.search Ads 360 Floodlight data. |
GOOGLE_HOSTED |
Conversions that track local actions from Google's products and services after interacting with an ad. |
FLOODLIGHT |
Conversions reported by Floodlight tags. |
ANALYTICS_SEARCH_ADS_360 |
Conversions that come from Google Analytics specifically for googleAds.search Ads 360. Displayed in Google Ads UI as Analytics (SA360). |
FIREBASE_SEARCH_ADS_360 |
Conversion that comes from a linked Firebase event for googleAds.search Ads 360. |
HotelRateType
Enum describing possible hotel rate types.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
UNAVAILABLE |
Rate type information is unavailable. |
PUBLIC_RATE |
Rates available to everyone. |
QUALIFIED_RATE |
A membership program rate is available and satisfies basic requirements like having a public rate available. UI treatment will strikethrough the public rate and indicate that a discount is available to the user. For more on Qualified Rates, visit https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates |
PRIVATE_RATE |
Rates available to users that satisfy some eligibility criteria. e.g. all signed-in users, 20% of mobile users, all mobile users in Canada, etc. |
HotelPriceBucket
Enum describing possible hotel price buckets.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
LOWEST_UNIQUE |
Uniquely lowest price. Partner has the lowest price, and no other partners are within a small variance of that price. |
LOWEST_TIED |
Tied for lowest price. Partner is within a small variance of the lowest price. |
NOT_LOWEST |
Not lowest price. Partner is not within a small variance of the lowest price. |
ONLY_PARTNER_SHOWN |
Partner was the only one shown. |
Keyword
A Keyword criterion segment.
JSON representation | |
---|---|
{
"info": {
object ( |
Fields | |
---|---|
info |
Keyword info. |
adGroupCriterion |
The AdGroupCriterion resource name. |
SearchEngineResultsPageType
The type of the search engine results page.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ADS_ONLY |
Only ads were contained in the search engine results page. |
ORGANIC_ONLY |
Only organic results were contained in the search engine results page. |
ADS_AND_ORGANIC |
Both ads and organic results were contained in the search engine results page. |
SearchTermMatchType
Possible match types for a keyword triggering an ad, including variants.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
BROAD |
Broad match. |
EXACT |
Exact match. |
PHRASE |
Phrase match. |
NEAR_EXACT |
Exact match (close variant). |
NEAR_PHRASE |
Phrase match (close variant). |
Slot
Enumerates possible positions of the Ad.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
SEARCH_SIDE |
Google search: Side. |
SEARCH_TOP |
Google search: Top. |
SEARCH_OTHER |
Google search: Other. |
CONTENT |
Google Display Network. |
SEARCH_PARTNER_TOP |
googleAds.search partners: Top. |
SEARCH_PARTNER_OTHER |
googleAds.search partners: Other. |
MIXED |
Cross-network. |
ConversionValueRulePrimaryDimension
Identifies the primary dimension for conversion value rule stats.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
NO_RULE_APPLIED |
For no-value-rule-applied conversions after value rule is enabled. |
ORIGINAL |
Below are for value-rule-applied conversions: The original stats. |
NEW_VS_RETURNING_USER |
When a new or returning customer condition is satisfied. |
GEO_LOCATION |
When a query-time Geo location condition is satisfied. |
DEVICE |
When a query-time browsing device condition is satisfied. |
AUDIENCE |
When a query-time audience condition is satisfied. |
MULTIPLE |
When multiple rules are applied. |
AssetInteractionTarget
An AssetInteractionTarget segment.
JSON representation | |
---|---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Fields | |
---|---|
asset |
The asset resource name. |
interactionOnThisAsset |
Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. |