- JSON representation
- AccountBudget
- AccountBudgetStatus
- PendingAccountBudgetProposal
- AdGroupAdAssetCombinationView
- AssetUsage
- AdGroupAdAssetView
- AdGroupAdAssetPolicySummary
- AdGroupAudienceView
- AdGroupCriterionSimulation
- SimulationType
- SimulationModificationMethod
- CpcBidSimulationPointList
- CpcBidSimulationPoint
- PercentCpcBidSimulationPointList
- PercentCpcBidSimulationPoint
- AdGroupSimulation
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- AgeRangeView
- AdScheduleView
- DomainCategory
- AssetFieldTypeView
- AssetGroupProductGroupView
- AssetSetTypeView
- BiddingStrategySimulation
- CallView
- CallTrackingDisplayLocation
- CallType
- GoogleVoiceCallStatus
- CampaignAudienceView
- CampaignSearchTermInsight
- CampaignSimulation
- TargetImpressionShareSimulationPointList
- TargetImpressionShareSimulationPoint
- BudgetSimulationPointList
- BudgetSimulationPoint
- CarrierConstant
- ChangeEvent
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
- ResourceChangeOperation
- ChangeStatus
- ChangeStatusResourceType
- ChangeStatusOperation
- CombinedAudience
- CombinedAudienceStatus
- ClickView
- ClickLocation
- CurrencyConstant
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerClient
- CustomerSearchTermInsight
- DetailPlacementView
- PlacementType
- DetailedDemographic
- CriterionCategoryAvailability
- CriterionCategoryChannelAvailability
- CriterionCategoryChannelAvailabilityMode
- CriterionCategoryLocaleAvailability
- CriterionCategoryLocaleAvailabilityMode
- DisplayKeywordView
- DistanceView
- DistanceBucket
- DynamicSearchAdsSearchTermView
- ExpandedLandingPageView
- FeedPlaceholderView
- GenderView
- GeographicView
- GeoTargetingType
- GroupPlacementView
- HotelGroupView
- HotelPerformanceView
- HotelReconciliation
- HotelReconciliationStatus
- IncomeRangeView
- KeywordView
- LandingPageView
- LanguageConstant
- LocationView
- ManagedPlacementView
- MobileAppCategoryConstant
- MobileDeviceConstant
- MobileDeviceType
- OperatingSystemVersionConstant
- OperatingSystemVersionOperatorType
- PaidOrganicSearchTermView
- QualifyingQuestion
- ParentalStatusView
- PerStoreView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryStatus
- ProductGroupView
- Recommendation
- RecommendationType
- RecommendationImpact
- RecommendationMetrics
- CampaignBudgetRecommendation
- CampaignBudgetRecommendationOption
- KeywordRecommendation
- SearchTerm
- TextAdRecommendation
- TargetCpaOptInRecommendation
- TargetCpaOptInRecommendationOption
- TargetCpaOptInRecommendationGoal
- MaximizeConversionsOptInRecommendation
- EnhancedCpcOptInRecommendation
- SearchPartnersOptInRecommendation
- MaximizeClicksOptInRecommendation
- OptimizeAdRotationRecommendation
- KeywordMatchTypeRecommendation
- MoveUnusedBudgetRecommendation
- TargetRoasOptInRecommendation
- ResponsiveSearchAdRecommendation
- UseBroadMatchKeywordRecommendation
- ResponsiveSearchAdAssetRecommendation
- UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
- ResponsiveSearchAdImproveAdStrengthRecommendation
- DisplayExpansionOptInRecommendation
- UpgradeLocalCampaignToPerformanceMaxRecommendation
- RaiseTargetCpaBidTooLowRecommendation
- ForecastingSetTargetRoasRecommendation
- CampaignBudget
- CalloutAssetRecommendation
- SitelinkAssetRecommendation
- CallAssetRecommendation
- ShoppingOfferAttributeRecommendation
- MerchantInfo
- ShoppingAddProductsToCampaignRecommendation
- Reason
- ShoppingFixDisapprovedProductsRecommendation
- ShoppingTargetAllOffersRecommendation
- ShoppingMerchantCenterAccountSuspensionRecommendation
- ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
- DynamicImageExtensionOptInRecommendation
- RaiseTargetCpaRecommendation
- TargetAdjustmentInfo
- AppBiddingGoal
- LowerTargetRoasRecommendation
- PerformanceMaxOptInRecommendation
- ImprovePerformanceMaxAdStrengthRecommendation
- MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
- SearchTermView
- SearchTermTargetingStatus
- ShoppingPerformanceView
- SmartCampaignSearchTermView
- ThirdPartyAppAnalyticsLink
- TopicView
- TravelActivityGroupView
- TravelActivityPerformanceView
- UserInterest
- UserInterestTaxonomyType
- LifeEvent
- UserLocationView
- TopicConstant
- Video
- WebpageView
- LeadFormSubmissionData
- LeadFormSubmissionField
- CustomLeadFormSubmissionField
- Metrics
- InteractionEventType
- SearchVolumeRange
- Segments
- AdDestinationType
- AdNetworkType
- BudgetCampaignAssociationStatus
- BudgetCampaignAssociationStatus
- ClickType
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- Keyword
- SearchEngineResultsPageType
- SearchTermMatchType
- Slot
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- SkAdNetworkAdEventType
- SkAdNetworkSourceApp
- SkAdNetworkAttributionCredit
- AssetInteractionTarget
- ConvertingUserPriorEngagementTypeAndLtvBucket
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. |
adGroupAdAssetCombinationView |
The ad group ad asset combination view 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. |
adGroupAssetSet |
The ad group asset set 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. |
assetGroupSignal |
The asset group signal 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. |
assetSetTypeView |
The asset set type view 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. |
campaignCustomizer |
The campaign customizer referenced in the query. |
campaignDraft |
The campaign draft referenced in the query. |
campaignExtensionSetting |
The campaign extension setting referenced in the query. |
campaignFeed |
The campaign feed referenced in the query. |
campaignGroup |
Campaign Group referenced in AWQL query. |
campaignLabel |
The campaign label referenced in the query. |
campaignSearchTermInsight |
The campaign search term insight 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. |
audience |
The Audience 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. |
customerAssetSet |
The customer asset set 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. |
customerSearchTermInsight |
The customer search term insight 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. |
qualifyingQuestion |
The qualifying question referenced in the query. |
parentalStatusView |
The parental status view referenced in the query. |
perStoreView |
The per store view referenced in the query. |
productBiddingCategoryConstant |
The Product Bidding Category referenced in the query. |
productGroupView |
The product group view referenced in the query. |
productLink |
The product link 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. |
travelActivityGroupView |
The travel activity group view referenced in the query. |
travelActivityPerformanceView |
The travel activity performance view referenced in the query. |
experiment |
The experiment referenced in the query. |
experimentArm |
The experiment arm 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. |
leadFormSubmissionData |
The lead form user submission referenced in the query. |
metrics |
The metrics. |
segments |
The segments. |
AccountBudget
An account-level budget. It contains information about the budget itself, as well as the most recently approved changes to the budget and proposed changes that are pending approval. The proposed changes that are pending approval, if any, are found in 'pendingProposal'. Effective details about the budget are found in fields prefixed 'approved_', 'adjusted_' and those without a prefix. Since some effective details may differ from what the user had originally requested (for example, spending limit), these differences are juxtaposed through 'proposed_', 'approved_', and possibly 'adjusted_' fields.
This resource is mutated using AccountBudgetProposal and cannot be mutated directly. A budget may have at most one pending proposal at any given time. It is read through pendingProposal.
Once approved, a budget may be subject to adjustments, such as credit adjustments. Adjustments create differences between the 'approved' and 'adjusted' fields, which would otherwise be identical.
JSON representation |
---|
{ "resourceName": string, "status": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the account-level budget. AccountBudget resource names have the form:
|
status |
Output only. The status of this account-level budget. |
totalAdjustmentsMicros |
Output only. The total adjustments amount. An example of an adjustment is courtesy credits. |
amountServedMicros |
Output only. The value of Ads that have been served, in micros. This includes overdelivery costs, in which case a credit might be automatically applied to the budget (see totalAdjustmentsMicros). |
pendingProposal |
Output only. The pending proposal to modify this budget, if applicable. |
id |
Output only. The ID of the account-level budget. |
billingSetup |
Output only. The resource name of the billing setup associated with this account-level budget. BillingSetup resource names have the form:
|
name |
Output only. The name of the account-level budget. |
proposedStartDateTime |
Output only. The proposed start time of the account-level budget in yyyy-MM-dd HH:mm:ss format. If a start time type of NOW was proposed, this is the time of request. |
approvedStartDateTime |
Output only. The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss format. For example, if a new budget is approved after the proposed start time, the approved start time is the time of approval. |
purchaseOrderNumber |
Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices. |
notes |
Output only. Notes associated with the budget. |
Union field proposed_end_time . The proposed end time of the account-level budget. proposed_end_time can be only one of the following: |
|
proposedEndDateTime |
Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format. |
proposedEndTimeType |
Output only. The proposed end time as a well-defined type, for example, FOREVER. |
Union field For example, if a budget's end time is updated and the proposal is approved after the proposed end time, the approved end time is the time of approval. |
|
approvedEndDateTime |
Output only. The approved end time in yyyy-MM-dd HH:mm:ss format. |
approvedEndTimeType |
Output only. The approved end time as a well-defined type, for example, FOREVER. |
Union field proposed_spending_limit . The proposed spending limit. proposed_spending_limit can be only one of the following: |
|
proposedSpendingLimitMicros |
Output only. The proposed spending limit in micros. One million is equivalent to one unit. |
proposedSpendingLimitType |
Output only. The proposed spending limit as a well-defined type, for example, INFINITE. |
Union field For example, if the amount already spent by the account exceeds the proposed spending limit at the time the proposal is approved, the approved spending limit is set to the amount already spent. |
|
approvedSpendingLimitMicros |
Output only. The approved spending limit in micros. One million is equivalent to one unit. This will only be populated if the proposed spending limit is finite, and will always be greater than or equal to the proposed spending limit. |
approvedSpendingLimitType |
Output only. The approved spending limit as a well-defined type, for example, INFINITE. This will only be populated if the approved spending limit is INFINITE. |
Union field This value has the final say on how much the account is allowed to spend. |
|
adjustedSpendingLimitMicros |
Output only. The adjusted spending limit in micros. One million is equivalent to one unit. If the approved spending limit is finite, the adjusted spending limit may vary depending on the types of adjustments applied to this budget, if applicable. The different kinds of adjustments are described here: https://support.google.com/google-ads/answer/1704323 For example, a debit adjustment reduces how much the account is allowed to spend. |
adjustedSpendingLimitType |
Output only. The adjusted spending limit as a well-defined type, for example, INFINITE. This will only be populated if the adjusted spending limit is INFINITE, which is guaranteed to be true if the approved spending limit is INFINITE. |
AccountBudgetStatus
The possible statuses of an AccountBudget.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
PENDING |
The account budget is pending approval. |
APPROVED |
The account budget has been approved. |
CANCELLED |
The account budget has been cancelled by the user. |
PendingAccountBudgetProposal
A pending proposal associated with the enclosing account-level budget, if applicable.
JSON representation |
---|
{ "proposalType": enum ( |
Fields | |
---|---|
proposalType |
Output only. The type of this proposal, for example, END to end the budget associated with this proposal. |
accountBudgetProposal |
Output only. The resource name of the proposal. AccountBudgetProposal resource names have the form:
|
name |
Output only. The name to assign to the account-level budget. |
startDateTime |
Output only. The start time in yyyy-MM-dd HH:mm:ss format. |
purchaseOrderNumber |
Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices. |
notes |
Output only. Notes associated with this budget. |
creationDateTime |
Output only. The time when this account-level budget proposal was created. Formatted as yyyy-MM-dd HH:mm:ss. |
Union field end_time . The end time of the account-level budget. end_time can be only one of the following: |
|
endDateTime |
Output only. The end time in yyyy-MM-dd HH:mm:ss format. |
endTimeType |
Output only. The end time as a well-defined type, for example, FOREVER. |
Union field spending_limit . The spending limit. spending_limit can be only one of the following: |
|
spendingLimitMicros |
Output only. The spending limit in micros. One million is equivalent to one unit. |
spendingLimitType |
Output only. The spending limit as a well-defined type, for example, INFINITE. |
AdGroupAdAssetCombinationView
A view on the usage of ad group ad asset combination. Now we only support AdGroupAdAssetCombinationView for Responsive Search Ads, with more ad types planned for the future.
JSON representation |
---|
{
"resourceName": string,
"servedAssets": [
{
object ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the ad group ad asset combination view. The combination ID is 128 bits long, where the upper 64 bits are stored in asset_combination_id_high, and the lower 64 bits are stored in asset_combination_id_low. AdGroupAd Asset Combination view resource names have the form: |
servedAssets[] |
Output only. Served assets. |
enabled |
Output only. The status between the asset combination and the latest version of the ad. If true, the asset combination is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad. |
AssetUsage
Contains the usage information of the asset.
JSON representation |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Fields | |
---|---|
asset |
Resource name of the asset. |
servedAssetFieldType |
The served field type of the asset. |
AdGroupAdAssetView
A link between an AdGroupAd and an Asset. Currently we only support AdGroupAdAssetView for AppAds and Responsive Search Ads.
JSON representation |
---|
{ "resourceName": string, "fieldType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the ad group ad asset view. Ad group ad asset view resource names have the form (Before V4):
Ad group ad asset view resource names have the form (Beginning from V4):
|
fieldType |
Output only. Role that the asset takes in the ad. |
policySummary |
Output only. Policy information for the ad group ad asset. |
performanceLabel |
Output only. Performance of an asset linkage. |
pinnedField |
Output only. Pinned field. |
adGroupAd |
Output only. The ad group ad to which the asset is linked. |
asset |
Output only. The asset which is linked to the ad group ad. |
enabled |
Output only. The status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad. |
AdGroupAdAssetPolicySummary
Contains policy information for an ad group ad asset.
JSON representation |
---|
{ "policyTopicEntries": [ { object ( |
Fields | |
---|---|
policyTopicEntries[] |
Output only. The list of policy findings for the ad group ad asset. |
reviewStatus |
Output only. Where in the review process this ad group ad asset is. |
approvalStatus |
Output only. The overall approval status of this ad group ad asset, calculated based on the status of its individual policy topic entries. |
AdGroupAudienceView
An ad group audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the ad group audience view. Ad group audience view resource names have the form:
|
AdGroupCriterionSimulation
An ad group criterion simulation. Supported combinations of advertising channel type, criterion type, simulation type, and simulation modification method are detailed below respectively. Hotel AdGroupCriterion simulation operations starting in V5.
- DISPLAY - KEYWORD - CPC_BID - UNIFORM
- SEARCH - KEYWORD - CPC_BID - UNIFORM
- SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
- HOTEL - LISTING_GROUP - CPC_BID - UNIFORM
- HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON representation |
---|
{ "resourceName": string, "type": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the ad group criterion simulation. Ad group criterion simulation resource names have the form:
|
type |
Output only. The field that the simulation modifies. |
modificationMethod |
Output only. How the simulation modifies the field. |
adGroupId |
Output only. AdGroup ID of the simulation. |
criterionId |
Output only. Criterion ID of the simulation. |
startDate |
Output only. First day on which the simulation is based, in YYYY-MM-DD format. |
endDate |
Output only. Last day on which the simulation is based, in YYYY-MM-DD format. |
Union field point_list . List of simulation points. point_list can be only one of the following: |
|
cpcBidPointList |
Output only. Simulation points if the simulation type is CPC_BID. |
percentCpcBidPointList |
Output only. Simulation points if the simulation type is PERCENT_CPC_BID. |
SimulationType
Enum describing the field a simulation modifies.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
CPC_BID |
The simulation is for a CPC bid. |
CPV_BID |
The simulation is for a CPV bid. |
TARGET_CPA |
The simulation is for a CPA target. |
BID_MODIFIER |
The simulation is for a bid modifier. |
TARGET_ROAS |
The simulation is for a ROAS target. |
PERCENT_CPC_BID |
The simulation is for a percent CPC bid. |
TARGET_IMPRESSION_SHARE |
The simulation is for an impression share target. |
BUDGET |
The simulation is for a budget. |
SimulationModificationMethod
Enum describing the method by which a simulation modifies a field.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
UNIFORM |
The values in a simulation were applied to all children of a given resource uniformly. Overrides on child resources were not respected. |
DEFAULT |
The values in a simulation were applied to the given resource. Overrides on child resources were respected, and traffic estimates do not include these resources. |
SCALING |
The values in a simulation were all scaled by the same factor. For example, in a simulated TargetCpa campaign, the campaign target and all ad group targets were scaled by a factor of X. |
CpcBidSimulationPointList
A container for simulation points for simulations of type CPC_BID.
JSON representation |
---|
{
"points": [
{
object ( |
Fields | |
---|---|
points[] |
Projected metrics for a series of CPC bid amounts. |
CpcBidSimulationPoint
Projected metrics for a specific CPC bid amount.
JSON representation |
---|
{ "requiredBudgetAmountMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
Fields | |
---|---|
requiredBudgetAmountMicros |
Projected required daily budget that the advertiser must set in order to receive the estimated traffic, in micros of advertiser currency. |
biddableConversions |
Projected number of biddable conversions. |
biddableConversionsValue |
Projected total value of biddable conversions. |
clicks |
Projected number of clicks. |
costMicros |
Projected cost in micros. |
impressions |
Projected number of impressions. |
topSlotImpressions |
Projected number of top slot impressions. Only search advertising channel type supports this field. |
Union field cpc_simulation_key_value . When SimulationModificationMethod = UNIFORM or DEFAULT, cpc_bid_micros is set. When SimulationModificationMethod = SCALING, cpc_bid_scaling_modifier is set. cpc_simulation_key_value can be only one of the following: |
|
cpcBidMicros |
The simulated CPC bid upon which projected metrics are based. |
cpcBidScalingModifier |
The simulated scaling modifier upon which projected metrics are based. All CPC bids relevant to the simulated entity are scaled by this modifier. |
PercentCpcBidSimulationPointList
A container for simulation points for simulations of type PERCENT_CPC_BID.
JSON representation |
---|
{
"points": [
{
object ( |
Fields | |
---|---|
points[] |
Projected metrics for a series of percent CPC bid amounts. |
PercentCpcBidSimulationPoint
Projected metrics for a specific percent CPC amount. Only Hotel advertising channel type supports this field.
JSON representation |
---|
{ "percentCpcBidMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
Fields | |
---|---|
percentCpcBidMicros |
The simulated percent CPC upon which projected metrics are based. Percent CPC expressed as fraction of the advertised price for some good or service. The value stored here is 1,000,000 * [fraction]. |
biddableConversions |
Projected number of biddable conversions. |
biddableConversionsValue |
Projected total value of biddable conversions in local currency. |
clicks |
Projected number of clicks. |
costMicros |
Projected cost in micros. |
impressions |
Projected number of impressions. |
topSlotImpressions |
Projected number of top slot impressions. |
AdGroupSimulation
An ad group simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively.
- SEARCH - CPC_BID - DEFAULT
- SEARCH - CPC_BID - UNIFORM
- SEARCH - TARGET_CPA - UNIFORM
- SEARCH - TARGET_ROAS - UNIFORM
- DISPLAY - CPC_BID - DEFAULT
- DISPLAY - CPC_BID - UNIFORM
- DISPLAY - TARGET_CPA - UNIFORM
JSON representation |
---|
{ "resourceName": string, "type": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the ad group simulation. Ad group simulation resource names have the form:
|
type |
Output only. The field that the simulation modifies. |
modificationMethod |
Output only. How the simulation modifies the field. |
adGroupId |
Output only. Ad group id of the simulation. |
startDate |
Output only. First day on which the simulation is based, in YYYY-MM-DD format. |
endDate |
Output only. Last day on which the simulation is based, in YYYY-MM-DD format |
Union field point_list . List of simulation points. point_list can be only one of the following: |
|
cpcBidPointList |
Output only. Simulation points if the simulation type is CPC_BID. |
cpvBidPointList |
Output only. Simulation points if the simulation type is CPV_BID. |
targetCpaPointList |
Output only. Simulation points if the simulation type is TARGET_CPA. |
targetRoasPointList |
Output only. Simulation points if the simulation type is TARGET_ROAS. |
CpvBidSimulationPointList
A container for simulation points for simulations of type CPV_BID.
JSON representation |
---|
{
"points": [
{
object ( |
Fields | |
---|---|
points[] |
Projected metrics for a series of CPV bid amounts. |
CpvBidSimulationPoint
Projected metrics for a specific CPV bid amount.
JSON representation |
---|
{ "cpvBidMicros": string, "costMicros": string, "impressions": string, "views": string } |
Fields | |
---|---|
cpvBidMicros |
The simulated CPV bid upon which projected metrics are based. |
costMicros |
Projected cost in micros. |
impressions |
Projected number of impressions. |
views |
Projected number of views. |
TargetCpaSimulationPointList
A container for simulation points for simulations of type TARGET_CPA.
JSON representation |
---|
{
"points": [
{
object ( |
Fields | |
---|---|
points[] |
Projected metrics for a series of target CPA amounts. |
TargetCpaSimulationPoint
Projected metrics for a specific target CPA amount.
JSON representation |
---|
{ "requiredBudgetAmountMicros": string, "appInstalls": number, "inAppActions": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
Fields | |
---|---|
requiredBudgetAmountMicros |
Projected required daily budget that the advertiser must set in order to receive the estimated traffic, in micros of advertiser currency. |
appInstalls |
Projected number of app installs. |
inAppActions |
Projected number of in-app actions. |
biddableConversions |
Projected number of biddable conversions. |
biddableConversionsValue |
Projected total value of biddable conversions. |
clicks |
Projected number of clicks. |
costMicros |
Projected cost in micros. |
impressions |
Projected number of impressions. |
topSlotImpressions |
Projected number of top slot impressions. Only search advertising channel type supports this field. |
Union field target_cpa_simulation_key_value . When SimulationModificationMethod = UNIFORM or DEFAULT, target_cpa_micros is set. When SimulationModificationMethod = SCALING, target_cpa_scaling_modifier is set. target_cpa_simulation_key_value can be only one of the following: |
|
targetCpaMicros |
The simulated target CPA upon which projected metrics are based. |
targetCpaScalingModifier |
The simulated scaling modifier upon which projected metrics are based. All CPA targets relevant to the simulated entity are scaled by this modifier. |
TargetRoasSimulationPointList
A container for simulation points for simulations of type TARGET_ROAS.
JSON representation |
---|
{
"points": [
{
object ( |
Fields | |
---|---|
points[] |
Projected metrics for a series of target ROAS amounts. |
TargetRoasSimulationPoint
Projected metrics for a specific target ROAS amount.
JSON representation |
---|
{ "requiredBudgetAmountMicros": string, "targetRoas": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
Fields | |
---|---|
requiredBudgetAmountMicros |
Projected required daily budget that the advertiser must set in order to receive the estimated traffic, in micros of advertiser currency. |
targetRoas |
The simulated target ROAS upon which projected metrics are based. |
biddableConversions |
Projected number of biddable conversions. |
biddableConversionsValue |
Projected total value of biddable conversions. |
clicks |
Projected number of clicks. |
costMicros |
Projected cost in micros. |
impressions |
Projected number of impressions. |
topSlotImpressions |
Projected number of top slot impressions. Only Search advertising channel type supports this field. |
AgeRangeView
An age range view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the age range view. Age range view resource names have the form:
|
AdScheduleView
An ad schedule view summarizes the performance of campaigns by AdSchedule criteria.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the ad schedule view. AdSchedule view resource names have the form:
|
DomainCategory
A category generated automatically by crawling a domain. If a campaign uses the DynamicSearchAdsSetting, then domain categories will be generated for the domain. The categories can be targeted using WebpageConditionInfo. See: https://support.google.com/google-ads/answer/2471185
JSON representation |
---|
{ "resourceName": string, "campaign": string, "category": string, "languageCode": string, "domain": string, "coverageFraction": number, "categoryRank": string, "hasChildren": boolean, "recommendedCpcBidMicros": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the domain category. Domain category resource names have the form:
|
campaign |
Output only. The campaign this category is recommended for. |
category |
Output only. Recommended category for the website domain, for example, if you have a website about electronics, the categories could be "cameras", "televisions", etc. |
languageCode |
Output only. The language code specifying the language of the website, for example, "en" for English. The language can be specified in the DynamicSearchAdsSetting required for dynamic search ads. This is the language of the pages from your website that you want Google Ads to find, create ads for, and match searches with. |
domain |
Output only. The domain for the website. The domain can be specified in the DynamicSearchAdsSetting required for dynamic search ads. |
coverageFraction |
Output only. Fraction of pages on your site that this category matches. |
categoryRank |
Output only. The position of this category in the set of categories. Lower numbers indicate a better match for the domain. null indicates not recommended. |
hasChildren |
Output only. Indicates whether this category has sub-categories. |
recommendedCpcBidMicros |
Output only. The recommended cost per click for the category. |
AssetFieldTypeView
An asset field type view. This view reports non-overcounted metrics for each asset field type when the asset is used as extension.
JSON representation |
---|
{
"resourceName": string,
"fieldType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the asset field type view. Asset field type view resource names have the form:
|
fieldType |
Output only. The asset field type of the asset field type view. |
AssetGroupProductGroupView
An asset group product group view.
JSON representation |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": 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:
|
assetGroup |
Output only. The asset group associated with the listing group filter. |
assetGroupListingGroupFilter |
Output only. The resource name of the asset group listing group filter. |
AssetSetTypeView
An asset set type view. This view reports non-overcounted metrics for each asset set type. Child asset set types are not included in this report. Their stats are aggregated under the parent asset set type.
JSON representation |
---|
{
"resourceName": string,
"assetSetType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the asset set type view. Asset set type view resource names have the form:
|
assetSetType |
Output only. The asset set type of the asset set type view. |
BiddingStrategySimulation
A bidding strategy simulation. Supported combinations of simulation type and simulation modification method are detailed below respectively.
- TARGET_CPA - UNIFORM
- TARGET_ROAS - UNIFORM
JSON representation |
---|
{ "resourceName": string, "biddingStrategyId": string, "type": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the bidding strategy simulation. Bidding strategy simulation resource names have the form:
|
biddingStrategyId |
Output only. Bidding strategy shared set id of the simulation. |
type |
Output only. The field that the simulation modifies. |
modificationMethod |
Output only. How the simulation modifies the field. |
startDate |
Output only. First day on which the simulation is based, in YYYY-MM-DD format. |
endDate |
Output only. Last day on which the simulation is based, in YYYY-MM-DD format |
Union field point_list . List of simulation points. point_list can be only one of the following: |
|
targetCpaPointList |
Output only. Simulation points if the simulation type is TARGET_CPA. |
targetRoasPointList |
Output only. Simulation points if the simulation type is TARGET_ROAS. |
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. |
CampaignAudienceView
A campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the campaign audience view. Campaign audience view resource names have the form:
|
CampaignSearchTermInsight
A Campaign search term view. Historical data is available starting March 2023.
JSON representation |
---|
{ "resourceName": string, "categoryLabel": string, "id": string, "campaignId": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the campaign level search term insight. Campaign level search term insight resource names have the form:
|
categoryLabel |
Output only. The label for the search category. An empty string denotes the catch-all category for search terms that didn't fit into another category. |
id |
Output only. The ID of the insight. |
campaignId |
Output only. The ID of the campaign. |
CampaignSimulation
A campaign simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively.
- SEARCH - CPC_BID - UNIFORM
- SEARCH - CPC_BID - SCALING
- SEARCH - TARGET_CPA - UNIFORM
- SEARCH - TARGET_CPA - SCALING
- SEARCH - TARGET_ROAS - UNIFORM
- SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM
- SEARCH - BUDGET - UNIFORM
- SHOPPING - BUDGET - UNIFORM
- SHOPPING - TARGET_ROAS - UNIFORM
- MULTI_CHANNEL - TARGET_CPA - UNIFORM
- MULTI_CHANNEL - TARGET_ROAS - UNIFORM
- DISCOVERY - TARGET_CPA - DEFAULT
- DISPLAY - TARGET_CPA - UNIFORM
- PERFORMANCE_MAX - TARGET_CPA - UNIFORM
- PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
- PERFORMANCE_MAX - BUDGET - UNIFORM
JSON representation |
---|
{ "resourceName": string, "campaignId": string, "type": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the campaign simulation. Campaign simulation resource names have the form:
|
campaignId |
Output only. Campaign id of the simulation. |
type |
Output only. The field that the simulation modifies. |
modificationMethod |
Output only. How the simulation modifies the field. |
startDate |
Output only. First day on which the simulation is based, in YYYY-MM-DD format. |
endDate |
Output only. Last day on which the simulation is based, in YYYY-MM-DD format |
Union field point_list . List of simulation points. point_list can be only one of the following: |
|
cpcBidPointList |
Output only. Simulation points if the simulation type is CPC_BID. |
targetCpaPointList |
Output only. Simulation points if the simulation type is TARGET_CPA. |
targetRoasPointList |
Output only. Simulation points if the simulation type is TARGET_ROAS. |
targetImpressionSharePointList |
Output only. Simulation points if the simulation type is TARGET_IMPRESSION_SHARE. |
budgetPointList |
Output only. Simulation points if the simulation type is BUDGET. |
BudgetSimulationPointList
A container for simulation points for simulations of type BUDGET.
JSON representation |
---|
{
"points": [
{
object ( |
Fields | |
---|---|
points[] |
Projected metrics for a series of budget amounts. |
BudgetSimulationPoint
Projected metrics for a specific budget amount.
JSON representation |
---|
{ "budgetAmountMicros": string, "requiredCpcBidCeilingMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
Fields | |
---|---|
budgetAmountMicros |
The simulated budget upon which projected metrics are based. |
requiredCpcBidCeilingMicros |
Projected required daily cpc bid ceiling that the advertiser must set to realize this simulation, in micros of the advertiser currency. Only campaigns with the Target Spend bidding strategy support this field. |
biddableConversions |
Projected number of biddable conversions. |
biddableConversionsValue |
Projected total value of biddable conversions. |
clicks |
Projected number of clicks. |
costMicros |
Projected cost in micros. |
impressions |
Projected number of impressions. |
topSlotImpressions |
Projected number of top slot impressions. Only search advertising channel type supports this field. |
CarrierConstant
A carrier criterion that can be used in campaign targeting.
JSON representation |
---|
{ "resourceName": string, "id": string, "name": string, "countryCode": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the carrier criterion. Carrier criterion resource names have the form:
|
id |
Output only. The ID of the carrier criterion. |
name |
Output only. The full name of the carrier in English. |
countryCode |
Output only. The country code of the country where the carrier is located, for example, "AR", "FR", etc. |
ChangeEvent
Describes the granular change of returned resources of certain resource types. Changes made through the UI or API in the past 30 days are included. Previous and new values of the changed fields are shown. 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. |
ASSET_SET |
An AssetSet resource change. |
ASSET_SET_ASSET |
An AssetSetAsset resource change. |
CAMPAIGN_ASSET_SET |
A CampaignAssetSet 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. This value is a placeholder. The API does not return these changes. |
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 Search Ads 360 Sync. |
SEARCH_ADS_360_POST |
Changes made through 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. |
assetSet |
Output only. Set if changeResourceType == ASSET_SET. |
assetSetAsset |
Output only. Set if changeResourceType == ASSET_SET_ASSET. |
campaignAssetSet |
Output only. Set if changeResourceType == CAMPAIGN_ASSET_SET. |
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. |
ChangeStatus
Describes the status of returned resource. ChangeStatus could have up to 3 minutes delay to reflect a new change.
JSON representation |
---|
{ "resourceName": string, "resourceType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the change status. Change status resource names have the form:
|
resourceType |
Output only. Represents the type of the changed resource. This dictates what fields will be set. For example, for AD_GROUP, campaign and adGroup fields will be set. |
resourceStatus |
Output only. Represents the status of the changed resource. |
sharedSet |
Output only. The SharedSet affected by this change. |
campaignSharedSet |
Output only. The CampaignSharedSet affected by this change. |
asset |
Output only. The Asset affected by this change. |
customerAsset |
Output only. The CustomerAsset affected by this change. |
campaignAsset |
Output only. The CampaignAsset affected by this change. |
adGroupAsset |
Output only. The AdGroupAsset affected by this change. |
combinedAudience |
Output only. The CombinedAudience affected by this change. |
lastChangeDateTime |
Output only. Time at which the most recent change has occurred on this resource. |
campaign |
Output only. The Campaign affected by this change. |
adGroup |
Output only. The AdGroup affected by this change. |
adGroupAd |
Output only. The AdGroupAd affected by this change. |
adGroupCriterion |
Output only. The AdGroupCriterion affected by this change. |
campaignCriterion |
Output only. The CampaignCriterion affected by this change. |
feed |
Output only. The Feed affected by this change. |
feedItem |
Output only. The FeedItem affected by this change. |
adGroupFeed |
Output only. The AdGroupFeed affected by this change. |
campaignFeed |
Output only. The CampaignFeed affected by this change. |
adGroupBidModifier |
Output only. The AdGroupBidModifier affected by this change. |
ChangeStatusResourceType
Enum listing the resource types support by the ChangeStatus resource.
Enums | |
---|---|
UNSPECIFIED |
No value has been specified. |
UNKNOWN |
Used for return value only. Represents an unclassified resource unknown in this version. |
AD_GROUP |
An AdGroup resource change. |
AD_GROUP_AD |
An AdGroupAd resource change. |
AD_GROUP_CRITERION |
An AdGroupCriterion resource change. |
CAMPAIGN |
A Campaign resource change. |
CAMPAIGN_CRITERION |
A CampaignCriterion resource change. |
FEED |
A Feed resource change. |
FEED_ITEM |
A FeedItem resource change. |
AD_GROUP_FEED |
An AdGroupFeed resource change. |
CAMPAIGN_FEED |
A CampaignFeed resource change. |
AD_GROUP_BID_MODIFIER |
An AdGroupBidModifier resource change. |
SHARED_SET |
A SharedSet resource change. |
CAMPAIGN_SHARED_SET |
A CampaignSharedSet 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. |
COMBINED_AUDIENCE |
A CombinedAudience resource change. |
ChangeStatusOperation
Status of the changed resource
Enums | |
---|---|
UNSPECIFIED |
No value has been specified. |
UNKNOWN |
Used for return value only. Represents an unclassified resource unknown in this version. |
ADDED |
The resource was created. |
CHANGED |
The resource was modified. |
REMOVED |
The resource was removed. |
CombinedAudience
Describe a resource for combined audiences which includes different audiences.
JSON representation |
---|
{
"resourceName": string,
"id": string,
"status": enum ( |
Fields | |
---|---|
resourceName |
Immutable. The resource name of the combined audience. Combined audience names have the form:
|
id |
Output only. ID of the combined audience. |
status |
Output only. Status of this combined audience. Indicates whether the combined audience is enabled or removed. |
name |
Output only. Name of the combined audience. It should be unique across all combined audiences. |
description |
Output only. Description of this combined audience. |
CombinedAudienceStatus
Enum containing possible combined audience status types.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ENABLED |
Enabled status - combined audience is enabled and can be targeted. |
REMOVED |
Removed status - combined audience is removed and cannot be used for targeting. |
ClickView
A click view with metrics aggregated at each click level, including both valid and invalid clicks. For non-Search campaigns, metrics.clicks represents the number of valid and invalid interactions. Queries including ClickView must have a filter limiting the results to one day and can be requested for dates back to 90 days before the time of the request.
JSON representation |
---|
{ "resourceName": string, "areaOfInterest": { object ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the click view. Click view resource names have the form:
|
areaOfInterest |
Output only. The location criteria matching the area of interest associated with the impression. |
locationOfPresence |
Output only. The location criteria matching the location of presence associated with the impression. |
keyword |
Output only. The associated keyword, if one exists and the click corresponds to the SEARCH channel. |
keywordInfo |
Output only. Basic information about the associated keyword, if it exists. |
gclid |
Output only. The Google Click ID. |
pageNumber |
Output only. Page number in search results where the ad was shown. |
adGroupAd |
Output only. The associated ad. |
campaignLocationTarget |
Output only. The associated campaign location target, if one exists. |
userList |
Output only. The associated user list, if one exists. |
ClickLocation
Location criteria associated with a click.
JSON representation |
---|
{ "city": string, "country": string, "metro": string, "mostSpecific": string, "region": string } |
Fields | |
---|---|
city |
The city location criterion associated with the impression. |
country |
The country location criterion associated with the impression. |
metro |
The metro location criterion associated with the impression. |
mostSpecific |
The most specific location criterion associated with the impression. |
region |
The region location criterion associated with the impression. |
CurrencyConstant
A currency constant.
JSON representation |
---|
{ "resourceName": string, "code": string, "name": string, "symbol": string, "billableUnitMicros": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the currency constant. Currency constant resource names have the form:
|
code |
Output only. ISO 4217 three-letter currency code, for example, "USD" |
name |
Output only. Full English name of the currency. |
symbol |
Output only. Standard symbol for describing this currency, for example, '$' for US Dollars. |
billableUnitMicros |
Output only. The billable unit for this currency. Billed amounts should be multiples of this value. |
AccessibleBiddingStrategy
Represents a view of BiddingStrategies owned by and shared with the customer.
In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.
JSON representation |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form:
|
id |
Output only. The ID of the bidding strategy. |
name |
Output only. The name of the bidding strategy. |
type |
Output only. The type of the bidding strategy. |
ownerCustomerId |
Output only. The ID of the Customer which owns the bidding strategy. |
ownerDescriptiveName |
Output only. descriptiveName of the Customer which owns the bidding strategy. |
Union field Only one can be set. |
|
maximizeConversionValue |
Output only. An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. |
maximizeConversions |
Output only. An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. |
targetCpa |
Output only. A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. |
targetImpressionShare |
Output only. A bidding strategy that automatically optimizes towards a chosen percentage of impressions. |
targetRoas |
Output only. A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS). |
targetSpend |
Output only. A bid strategy that sets your bids to help get as many clicks as possible within your budget. |
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
JSON representation |
---|
{ "targetRoas": number } |
Fields | |
---|---|
targetRoas |
Output only. The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
JSON representation |
---|
{ "targetCpaMicros": string } |
Fields | |
---|---|
targetCpaMicros |
Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. |
TargetCpa
An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
JSON representation |
---|
{ "targetCpaMicros": string } |
Fields | |
---|---|
targetCpaMicros |
Output only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
TargetRoas
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
JSON representation |
---|
{ "targetRoas": number } |
Fields | |
---|---|
targetRoas |
Output only. The chosen revenue (based on conversion data) per unit of spend. |
TargetSpend
An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.
JSON representation |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Fields | |
---|---|
targetSpendMicros |
Output only. The 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. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
cpcBidCeilingMicros |
Output only. Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
CustomerClient
A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.
JSON representation |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the customer client. CustomerClient resource names have the form: |
appliedLabels[] |
Output only. The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form:
|
status |
Output only. The status of the client customer. Read only. |
clientCustomer |
Output only. The resource name of the client-customer which is linked to the given customer. Read only. |
level |
Output only. Distance between given customer and client. For self link, the level value will be 0. Read only. |
timeZone |
Output only. Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only. |
testAccount |
Output only. Identifies if the client is a test account. Read only. |
manager |
Output only. Identifies if the client is a manager. Read only. |
descriptiveName |
Output only. Descriptive name for the client. Read only. |
currencyCode |
Output only. Currency code (for example, 'USD', 'EUR') for the client. Read only. |
id |
Output only. The ID of the client customer. Read only. |
CustomerSearchTermInsight
A Customer search term view. Historical data is available starting March 2023.
JSON representation |
---|
{ "resourceName": string, "categoryLabel": string, "id": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the customer level search term insight. Customer level search term insight resource names have the form:
|
categoryLabel |
Output only. The label for the search category. An empty string denotes the catch-all category for search terms that didn't fit into another category. |
id |
Output only. The ID of the insight. |
DetailPlacementView
A view with metrics aggregated by ad group and URL or YouTube video.
JSON representation |
---|
{
"resourceName": string,
"placementType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the detail placement view. Detail placement view resource names have the form:
|
placementType |
Output only. Type of the placement, for example, Website, YouTube Video, and Mobile Application. |
placement |
Output only. The automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID. |
displayName |
Output only. The display name is URL name for websites, YouTube video name for YouTube videos, and translated mobile app name for mobile apps. |
groupPlacementTargetUrl |
Output only. URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL. |
targetUrl |
Output only. URL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL. |
PlacementType
Possible placement types for a feed mapping.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
WEBSITE |
Websites(for example, 'www.flowers4sale.com'). |
MOBILE_APP_CATEGORY |
Mobile application categories(for example, 'Games'). |
MOBILE_APPLICATION |
mobile applications(for example, 'mobileapp::2-com.whatsthewordanswers'). |
YOUTUBE_VIDEO |
YouTube videos(for example, 'youtube.com/video/wtLJPvx7-ys'). |
YOUTUBE_CHANNEL |
YouTube channels(for example, 'youtube.com::L8ZULXASCc1I_oaOT0NaOQ'). |
GOOGLE_PRODUCTS |
Surfaces owned and operated by Google(for example, 'tv.google.com'). |
DetailedDemographic
A detailed demographic: a particular interest-based vertical to be targeted to reach users based on long-term life facts.
JSON representation |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the detailed demographic. Detailed demographic resource names have the form:
|
id |
Output only. The ID of the detailed demographic. |
name |
Output only. The name of the detailed demographic. For example,"Highest Level of Educational Attainment" |
parent |
Output only. The parent of the detailedDemographic. |
launchedToAll |
Output only. True if the detailed demographic is launched to all channels and locales. |
availabilities[] |
Output only. Availability information of the detailed demographic. |
CriterionCategoryAvailability
Information of category availability, per advertising channel.
JSON representation |
---|
{ "channel": { object ( |
Fields | |
---|---|
channel |
Channel types and subtypes that are available to the category. |
locale[] |
Locales that are available to the category for the channel. |
CriterionCategoryChannelAvailability
Information of advertising channel type and subtypes a category is available in.
JSON representation |
---|
{ "availabilityMode": enum ( |
Fields | |
---|---|
availabilityMode |
Format of the channel availability. Can be ALL_CHANNELS (the rest of the fields will not be set), CHANNEL_TYPE (only advertisingChannelType type will be set, the category is available to all sub types under it) or CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType, and includeDefaultChannelSubType will all be set). |
advertisingChannelType |
Channel type the category is available to. |
advertisingChannelSubType[] |
Channel subtypes under the channel type the category is available to. |
includeDefaultChannelSubType |
Whether default channel sub type is included. For example, advertisingChannelType being DISPLAY and includeDefaultChannelSubType being false means that the default display campaign where channel sub type is not set is not included in this availability configuration. |
CriterionCategoryChannelAvailabilityMode
Enum containing the possible CriterionCategoryChannelAvailabilityMode.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ALL_CHANNELS |
The category is available to campaigns of all channel types and subtypes. |
CHANNEL_TYPE_AND_ALL_SUBTYPES |
The category is available to campaigns of a specific channel type, including all subtypes under it. |
CHANNEL_TYPE_AND_SUBSET_SUBTYPES |
The category is available to campaigns of a specific channel type and subtype(s). |
CriterionCategoryLocaleAvailability
Information about which locales a category is available in.
JSON representation |
---|
{
"availabilityMode": enum ( |
Fields | |
---|---|
availabilityMode |
Format of the locale availability. Can be LAUNCHED_TO_ALL (both country and language will be empty), COUNTRY (only country will be set), LANGUAGE (only language wil be set), COUNTRY_AND_LANGUAGE (both country and language will be set). |
countryCode |
The ISO-3166-1 alpha-2 country code associated with the category. |
languageCode |
ISO 639-1 code of the language associated with the category. |
CriterionCategoryLocaleAvailabilityMode
Enum containing the possible CriterionCategoryLocaleAvailabilityMode.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ALL_LOCALES |
The category is available to campaigns of all locales. |
COUNTRY_AND_ALL_LANGUAGES |
The category is available to campaigns within a list of countries, regardless of language. |
LANGUAGE_AND_ALL_COUNTRIES |
The category is available to campaigns within a list of languages, regardless of country. |
COUNTRY_AND_LANGUAGE |
The category is available to campaigns within a list of country, language pairs. |
DisplayKeywordView
A display keyword view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the display keyword view. Display Keyword view resource names have the form:
|
DistanceView
A distance view with metrics aggregated by the user's distance from an advertiser's location extensions. Each DistanceBucket includes all impressions that fall within its distance and a single impression will contribute to the metrics for all DistanceBuckets that include the user's distance.
JSON representation |
---|
{
"resourceName": string,
"distanceBucket": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the distance view. Distance view resource names have the form:
|
distanceBucket |
Output only. Grouping of user distance from location extensions. |
metricSystem |
Output only. True if the DistanceBucket is using the metric system, false otherwise. |
DistanceBucket
The distance bucket for a user's distance from an advertiser's location extension.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
WITHIN_700M |
User was within 700m of the location. |
WITHIN_1KM |
User was within 1KM of the location. |
WITHIN_5KM |
User was within 5KM of the location. |
WITHIN_10KM |
User was within 10KM of the location. |
WITHIN_15KM |
User was within 15KM of the location. |
WITHIN_20KM |
User was within 20KM of the location. |
WITHIN_25KM |
User was within 25KM of the location. |
WITHIN_30KM |
User was within 30KM of the location. |
WITHIN_35KM |
User was within 35KM of the location. |
WITHIN_40KM |
User was within 40KM of the location. |
WITHIN_45KM |
User was within 45KM of the location. |
WITHIN_50KM |
User was within 50KM of the location. |
WITHIN_55KM |
User was within 55KM of the location. |
WITHIN_60KM |
User was within 60KM of the location. |
WITHIN_65KM |
User was within 65KM of the location. |
BEYOND_65KM |
User was beyond 65KM of the location. |
WITHIN_0_7MILES |
User was within 0.7 miles of the location. |
WITHIN_1MILE |
User was within 1 mile of the location. |
WITHIN_5MILES |
User was within 5 miles of the location. |
WITHIN_10MILES |
User was within 10 miles of the location. |
WITHIN_15MILES |
User was within 15 miles of the location. |
WITHIN_20MILES |
User was within 20 miles of the location. |
WITHIN_25MILES |
User was within 25 miles of the location. |
WITHIN_30MILES |
User was within 30 miles of the location. |
WITHIN_35MILES |
User was within 35 miles of the location. |
WITHIN_40MILES |
User was within 40 miles of the location. |
BEYOND_40MILES |
User was beyond 40 miles of the location. |
DynamicSearchAdsSearchTermView
A dynamic search ads search term view.
JSON representation |
---|
{ "resourceName": string, "searchTerm": string, "headline": string, "landingPage": string, "pageUrl": string, "hasNegativeKeyword": boolean, "hasMatchingKeyword": boolean, "hasNegativeUrl": boolean } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form:
|
searchTerm |
Output only. Search term This field is read-only. |
headline |
Output only. The dynamically generated headline of the Dynamic Search Ad. This field is read-only. |
landingPage |
Output only. The dynamically selected landing page URL of the impression. This field is read-only. |
pageUrl |
Output only. The URL of page feed item served for the impression. This field is read-only. |
hasNegativeKeyword |
Output only. True if query matches a negative keyword. This field is read-only. |
hasMatchingKeyword |
Output only. True if query is added to targeted keywords. This field is read-only. |
hasNegativeUrl |
Output only. True if query matches a negative url. This field is read-only. |
ExpandedLandingPageView
A landing page view with metrics aggregated at the expanded final URL level.
JSON representation |
---|
{ "resourceName": string, "expandedFinalUrl": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the expanded landing page view. Expanded landing page view resource names have the form:
|
expandedFinalUrl |
Output only. The final URL that clicks are directed to. |
FeedPlaceholderView
A feed placeholder view.
JSON representation |
---|
{
"resourceName": string,
"placeholderType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the feed placeholder view. Feed placeholder view resource names have the form:
|
placeholderType |
Output only. The placeholder type of the feed placeholder view. |
GenderView
A gender view. The genderView resource reflects the effective serving state, rather than what criteria were added. An ad group without gender criteria by default shows to all genders, so all genders appear in genderView with stats.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the gender view. Gender view resource names have the form:
|
GeographicView
A geographic view.
Geographic View includes all metrics aggregated at the country level, one row per country. It reports metrics at either actual physical location of the user or an area of interest. If other segment fields are used, you may get more than one row per country.
JSON representation |
---|
{
"resourceName": string,
"locationType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the geographic view. Geographic view resource names have the form:
|
locationType |
Output only. Type of the geo targeting of the campaign. |
countryCriterionId |
Output only. Criterion Id for the country. |
GeoTargetingType
The possible geo targeting types.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
AREA_OF_INTEREST |
Location the user is interested in while making the query. |
LOCATION_OF_PRESENCE |
Location of the user issuing the query. |
GroupPlacementView
A group placement view.
JSON representation |
---|
{
"resourceName": string,
"placementType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the group placement view. Group placement view resource names have the form:
|
placementType |
Output only. Type of the placement, for example, Website, YouTube Channel, Mobile Application. |
placement |
Output only. The automatic placement string at group level, e. g. web domain, mobile app ID, or a YouTube channel ID. |
displayName |
Output only. Domain name for websites and YouTube channel name for YouTube channels. |
targetUrl |
Output only. URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL. |
HotelGroupView
A hotel group view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the hotel group view. Hotel Group view resource names have the form:
|
HotelPerformanceView
A hotel performance view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the hotel performance view. Hotel performance view resource names have the form:
|
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 through Bulk Uploads.
JSON representation |
---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"campaign": 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. |
campaign |
Output only. The resource name for the Campaign associated with the conversion. |
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. |
IncomeRangeView
An income range view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the income range view. Income range view resource names have the form:
|
KeywordView
A keyword view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the keyword view. Keyword view resource names have the form:
|
LandingPageView
A landing page view with metrics aggregated at the unexpanded final URL level.
JSON representation |
---|
{ "resourceName": string, "unexpandedFinalUrl": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the landing page view. Landing page view resource names have the form:
|
unexpandedFinalUrl |
Output only. The advertiser-specified final URL. |
LanguageConstant
A language.
JSON representation |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the language constant. Language constant resource names have the form:
|
id |
Output only. The ID of the language constant. |
code |
Output only. The language code, for example, "en_US", "en_AU", "es", "fr", etc. |
name |
Output only. The full name of the language in English, for example, "English (US)", "Spanish", etc. |
targetable |
Output only. Whether the language is targetable. |
LocationView
A location view summarizes the performance of campaigns by a Location criterion. If no Location criterion is set, no results are returned; instead, use geographicView or userLocationView for visitor location data.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the location view. Location view resource names have the form:
|
ManagedPlacementView
A managed placement view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the Managed Placement view. Managed placement view resource names have the form:
|
MobileAppCategoryConstant
A mobile application category constant.
JSON representation |
---|
{ "resourceName": string, "id": integer, "name": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the mobile app category constant. Mobile app category constant resource names have the form:
|
id |
Output only. The ID of the mobile app category constant. |
name |
Output only. Mobile app category name. |
MobileDeviceConstant
A mobile device constant.
JSON representation |
---|
{
"resourceName": string,
"type": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the mobile device constant. Mobile device constant resource names have the form:
|
type |
Output only. The type of mobile device. |
id |
Output only. The ID of the mobile device constant. |
name |
Output only. The name of the mobile device. |
manufacturerName |
Output only. The manufacturer of the mobile device. |
operatingSystemName |
Output only. The operating system of the mobile device. |
MobileDeviceType
The type of mobile device.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
MOBILE |
Mobile phones. |
TABLET |
Tablets. |
OperatingSystemVersionConstant
A mobile operating system version or a range of versions, depending on operatorType
. List of available mobile platforms at https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
JSON representation |
---|
{
"resourceName": string,
"operatorType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the operating system version constant. Operating system version constant resource names have the form:
|
operatorType |
Output only. Determines whether this constant represents a single version or a range of versions. |
id |
Output only. The ID of the operating system version. |
name |
Output only. Name of the operating system. |
osMajorVersion |
Output only. The OS Major Version number. |
osMinorVersion |
Output only. The OS Minor Version number. |
OperatingSystemVersionOperatorType
The type of operating system version.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
EQUALS_TO |
Equals to the specified version. |
GREATER_THAN_EQUALS_TO |
Greater than or equals to the specified version. |
PaidOrganicSearchTermView
A paid organic search term view providing a view of search stats across ads and organic listings aggregated by search term at the ad group level.
JSON representation |
---|
{ "resourceName": string, "searchTerm": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the search term view. Search term view resource names have the form:
|
searchTerm |
Output only. The search term. |
QualifyingQuestion
Qualifying Questions for Lead Form.
JSON representation |
---|
{ "resourceName": string, "qualifyingQuestionId": string, "locale": string, "text": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the qualifying question. 'qualifyingQuestions/{qualifyingQuestionId}' |
qualifyingQuestionId |
Output only. The id of the qualifying question. |
locale |
Output only. The locale of the qualifying question. |
text |
Output only. The qualifying question. |
ParentalStatusView
A parental status view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the parental status view. Parental Status view resource names have the form:
|
PerStoreView
A per store view. This view provides per store impression reach and local action conversion stats for advertisers.
JSON representation |
---|
{ "resourceName": string, "placeId": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the per store view. Per Store view resource names have the form:
|
placeId |
Output only. The place ID of the per store view. |
ProductBiddingCategoryConstant
A Product Bidding Category.
JSON representation |
---|
{ "resourceName": string, "level": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the product bidding category. Product bidding category resource names have the form:
|
level |
Output only. Level of the product bidding category. |
status |
Output only. Status of the product bidding category. |
id |
Output only. ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436. |
countryCode |
Output only. Two-letter upper-case country code of the product bidding category. |
productBiddingCategoryConstantParent |
Output only. Resource name of the parent product bidding category. |
languageCode |
Output only. Language code of the product bidding category. |
localizedName |
Output only. Display value of the product bidding category localized according to languageCode. |
ProductBiddingCategoryStatus
Enum describing the status of the product bidding category.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ACTIVE |
The category is active and can be used for bidding. |
OBSOLETE |
The category is obsolete. Used only for reporting purposes. |
ProductGroupView
A product group view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the product group view. Product group view resource names have the form:
|
Recommendation
A recommendation.
JSON representation |
---|
{ "resourceName": string, "type": enum ( |
Fields | |
---|---|
resourceName |
Immutable. The resource name of the recommendation.
|
type |
Output only. The type of recommendation. |
impact |
Output only. The impact on account performance as a result of applying the recommendation. |
campaigns[] |
Output only. The campaigns targeted by this recommendation. This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET and MOVE_UNUSED_BUDGET |
campaignBudget |
Output only. The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget. This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET |
campaign |
Output only. The campaign targeted by this recommendation. This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS, |
adGroup |
Output only. The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group. This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD |
dismissed |
Output only. Whether the recommendation is dismissed or not. |
Union field recommendation . The details of recommendation. recommendation can be only one of the following: |
|
campaignBudgetRecommendation |
Output only. The campaign budget recommendation. |
forecastingCampaignBudgetRecommendation |
Output only. The forecasting campaign budget recommendation. |
keywordRecommendation |
Output only. The keyword recommendation. |
textAdRecommendation |
Output only. Add expanded text ad recommendation. |
targetCpaOptInRecommendation |
Output only. The TargetCPA opt-in recommendation. |
maximizeConversionsOptInRecommendation |
Output only. The MaximizeConversions Opt-In recommendation. |
enhancedCpcOptInRecommendation |
Output only. The Enhanced Cost-Per-Click Opt-In recommendation. |
searchPartnersOptInRecommendation |
Output only. The Search Partners Opt-In recommendation. |
maximizeClicksOptInRecommendation |
Output only. The MaximizeClicks Opt-In recommendation. |
optimizeAdRotationRecommendation |
Output only. The Optimize Ad Rotation recommendation. |
keywordMatchTypeRecommendation |
Output only. The keyword match type recommendation. |
moveUnusedBudgetRecommendation |
Output only. The move unused budget recommendation. |
targetRoasOptInRecommendation |
Output only. The Target ROAS opt-in recommendation. |
responsiveSearchAdRecommendation |
Output only. The add responsive search ad recommendation. |
marginalRoiCampaignBudgetRecommendation |
Output only. The marginal ROI campaign budget recommendation. |
useBroadMatchKeywordRecommendation |
Output only. The use broad match keyword recommendation. |
responsiveSearchAdAssetRecommendation |
Output only. The responsive search ad asset recommendation. |
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation |
Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation. |
responsiveSearchAdImproveAdStrengthRecommendation |
Output only. The responsive search ad improve ad strength recommendation. |
displayExpansionOptInRecommendation |
Output only. The Display Expansion opt-in recommendation. |
upgradeLocalCampaignToPerformanceMaxRecommendation |
Output only. The upgrade a Local campaign to a Performance Max campaign recommendation. |
raiseTargetCpaBidTooLowRecommendation |
Output only. The raise target CPA bid too low recommendation. |
forecastingSetTargetRoasRecommendation |
Output only. The forecasting set target ROAS recommendation. |
calloutAssetRecommendation |
Output only. The callout asset recommendation. |
sitelinkAssetRecommendation |
Output only. The sitelink asset recommendation. |
callAssetRecommendation |
Output only. The call asset recommendation. |
shoppingAddAgeGroupRecommendation |
Output only. The shopping add age group recommendation. |
shoppingAddColorRecommendation |
Output only. The shopping add color recommendation. |
shoppingAddGenderRecommendation |
Output only. The shopping add gender recommendation. |
shoppingAddGtinRecommendation |
Output only. The shopping add GTIN recommendation. |
shoppingAddMoreIdentifiersRecommendation |
Output only. The shopping add more identifiers recommendation. |
shoppingAddSizeRecommendation |
Output only. The shopping add size recommendation. |
shoppingAddProductsToCampaignRecommendation |
Output only. The shopping add products to campaign recommendation. |
shoppingFixDisapprovedProductsRecommendation |
Output only. The shopping fix disapproved products recommendation. |
shoppingTargetAllOffersRecommendation |
Output only. The shopping target all offers recommendation. |
shoppingFixSuspendedMerchantCenterAccountRecommendation |
Output only. The shopping fix suspended Merchant Center account recommendation. |
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation |
Output only. The shopping fix Merchant Center account suspension warning recommendation. |
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation |
Output only. The shopping migrate Regular Shopping Campaign offers to Performance Max recommendation. |
dynamicImageExtensionOptInRecommendation |
Output only. Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads. |
raiseTargetCpaRecommendation |
Output only. Recommendation to raise Target CPA. |
lowerTargetRoasRecommendation |
Output only. Recommendation to lower Target ROAS. |
performanceMaxOptInRecommendation |
Output only. The Performance Max Opt In recommendation. |
improvePerformanceMaxAdStrengthRecommendation |
Output only. The improve Performance Max ad strength recommendation. |
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation |
Output only. The Dynamic Search Ads to Performance Max migration recommendation. |
RecommendationType
Types of recommendations.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
CAMPAIGN_BUDGET |
Budget recommendation for campaigns that are currently budget-constrained (as opposed to the FORECASTING_CAMPAIGN_BUDGET recommendation, which applies to campaigns that are expected to become budget-constrained in the future). |
KEYWORD |
Keyword recommendation. |
TEXT_AD |
Recommendation to add a new text ad. |
TARGET_CPA_OPT_IN |
Recommendation to update a campaign to use a Target CPA bidding strategy. |
MAXIMIZE_CONVERSIONS_OPT_IN |
Recommendation to update a campaign to use the Maximize Conversions bidding strategy. |
ENHANCED_CPC_OPT_IN |
Recommendation to enable Enhanced Cost Per Click for a campaign. |
SEARCH_PARTNERS_OPT_IN |
Recommendation to start showing your campaign's ads on Google Search Partners Websites. |
MAXIMIZE_CLICKS_OPT_IN |
Recommendation to update a campaign to use a Maximize Clicks bidding strategy. |
OPTIMIZE_AD_ROTATION |
Recommendation to start using the "Optimize" ad rotation setting for the given ad group. |
KEYWORD_MATCH_TYPE |
Recommendation to change an existing keyword from one match type to a broader match type. |
MOVE_UNUSED_BUDGET |
Recommendation to move unused budget from one budget to a constrained budget. |
FORECASTING_CAMPAIGN_BUDGET |
Budget recommendation for campaigns that are expected to become budget-constrained in the future (as opposed to the CAMPAIGN_BUDGET recommendation, which applies to campaigns that are currently budget-constrained). |
TARGET_ROAS_OPT_IN |
Recommendation to update a campaign to use a Target ROAS bidding strategy. |
RESPONSIVE_SEARCH_AD |
Recommendation to add a new responsive search ad. |
MARGINAL_ROI_CAMPAIGN_BUDGET |
Budget recommendation for campaigns whose ROI is predicted to increase with a budget adjustment. |
USE_BROAD_MATCH_KEYWORD |
Recommendation to add broad match versions of keywords for fully automated conversion-based bidding campaigns. |
RESPONSIVE_SEARCH_AD_ASSET |
Recommendation to add new responsive search ad assets. |
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX |
Recommendation to upgrade a Smart Shopping campaign to a Performance Max campaign. |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH |
Recommendation to improve strength of responsive search ad. |
DISPLAY_EXPANSION_OPT_IN |
Recommendation to update a campaign to use Display Expansion. |
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX |
Recommendation to upgrade a Local campaign to a Performance Max campaign. |
RAISE_TARGET_CPA_BID_TOO_LOW |
Recommendation to raise target CPA when it is too low and there are very few or no conversions. It is applied asynchronously and can take minutes depending on the number of ad groups there are in the related campaign. |
FORECASTING_SET_TARGET_ROAS |
Recommendation to raise the budget in advance of a seasonal event that is forecasted to increase traffic, and change bidding strategy from maximize conversion value to target ROAS. |
CALLOUT_ASSET |
Recommendation to add callout assets to campaign or customer level. |
SITELINK_ASSET |
Recommendation to add sitelink assets to campaign or customer level. |
CALL_ASSET |
Recommendation to add call assets to campaign or customer level. |
SHOPPING_ADD_AGE_GROUP |
Recommendation to add the age group attribute to offers that are demoted because of a missing age group. |
SHOPPING_ADD_COLOR |
Recommendation to add a color to offers that are demoted because of a missing color. |
SHOPPING_ADD_GENDER |
Recommendation to add a gender to offers that are demoted because of a missing gender. |
SHOPPING_ADD_GTIN |
Recommendation to add a GTIN (Global Trade Item Number) to offers that are demoted because of a missing GTIN. |
SHOPPING_ADD_MORE_IDENTIFIERS |
Recommendation to add more identifiers to offers that are demoted because of missing identifiers. |
SHOPPING_ADD_SIZE |
Recommendation to add the size to offers that are demoted because of a missing size. |
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN |
Recommendation informing a customer about a campaign that cannot serve because no products are being targeted. |
SHOPPING_FIX_DISAPPROVED_PRODUCTS |
The shopping recommendation informing a customer about campaign with a high percentage of disapproved products. |
SHOPPING_TARGET_ALL_OFFERS |
Recommendation to create a catch-all campaign that targets all offers. |
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT |
Recommendation to fix Merchant Center account suspension issues. |
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING |
Recommendation to fix Merchant Center account suspension warning issues. |
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX |
Recommendation to migrate offers targeted by Regular Shopping Campaigns to existing Performance Max campaigns. |
DYNAMIC_IMAGE_EXTENSION_OPT_IN |
Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads. |
RAISE_TARGET_CPA |
Recommendation to raise Target CPA based on Google predictions modeled from past conversions. It is applied asynchronously and can take minutes depending on the number of ad groups there are in the related campaign. |
LOWER_TARGET_ROAS |
Recommendation to lower Target ROAS. |
PERFORMANCE_MAX_OPT_IN |
Recommendation to opt into Performance Max campaigns. |
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH |
Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating. |
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX |
Recommendation to migrate Dynamic Search Ads to Performance Max campaigns. |
RecommendationImpact
The impact of making the change as described in the recommendation. Some types of recommendations may not have impact information.
JSON representation |
---|
{ "baseMetrics": { object ( |
Fields | |
---|---|
baseMetrics |
Output only. Base metrics at the time the recommendation was generated. |
potentialMetrics |
Output only. Estimated metrics if the recommendation is applied. |
RecommendationMetrics
Weekly account performance metrics. For some recommendation types, these are averaged over the past 90-day period and hence can be fractional.
JSON representation |
---|
{ "impressions": number, "clicks": number, "costMicros": string, "conversions": number, "videoViews": number } |
Fields | |
---|---|
impressions |
Output only. Number of ad impressions. |
clicks |
Output only. Number of ad clicks. |
costMicros |
Output only. Cost (in micros) for advertising, in the local currency for the account. |
conversions |
Output only. Number of conversions. |
videoViews |
Output only. Number of video views for a video ad campaign. |
CampaignBudgetRecommendation
The budget recommendation for budget constrained campaigns.
JSON representation |
---|
{
"budgetOptions": [
{
object ( |
Fields | |
---|---|
budgetOptions[] |
Output only. The budget amounts and associated impact estimates for some values of possible budget amounts. |
currentBudgetAmountMicros |
Output only. The current budget amount in micros. |
recommendedBudgetAmountMicros |
Output only. The recommended budget amount in micros. |
CampaignBudgetRecommendationOption
The impact estimates for a given budget amount.
JSON representation |
---|
{
"impact": {
object ( |
Fields | |
---|---|
impact |
Output only. The impact estimate if budget is changed to amount specified in this option. |
budgetAmountMicros |
Output only. The budget amount for this option. |
KeywordRecommendation
The keyword recommendation.
JSON representation |
---|
{ "keyword": { object ( |
Fields | |
---|---|
keyword |
Output only. The recommended keyword. |
searchTerms[] |
Output only. A list of search terms this keyword matches. The same search term may be repeated for multiple keywords. |
recommendedCpcBidMicros |
Output only. The recommended CPC (cost-per-click) bid. |
SearchTerm
Information about a search term as related to a keyword recommendation.
JSON representation |
---|
{ "text": string, "estimatedWeeklySearchCount": string } |
Fields | |
---|---|
text |
Output only. The text of the search term. |
estimatedWeeklySearchCount |
Output only. Estimated number of historical weekly searches for this search term. |
TextAdRecommendation
The text ad recommendation.
JSON representation |
---|
{
"ad": {
object ( |
Fields | |
---|---|
ad |
Output only. Recommended ad. |
creationDate |
Output only. Creation date of the recommended ad. YYYY-MM-DD format, for example, 2018-04-17. |
autoApplyDate |
Output only. Date, if present, is the earliest when the recommendation will be auto applied. YYYY-MM-DD format, for example, 2018-04-17. |
TargetCpaOptInRecommendation
The Target CPA opt-in recommendation.
JSON representation |
---|
{
"options": [
{
object ( |
Fields | |
---|---|
options[] |
Output only. The available goals and corresponding options for Target CPA strategy. |
recommendedTargetCpaMicros |
Output only. The recommended average CPA target. See required budget amount and impact of using this recommendation in options list. |
TargetCpaOptInRecommendationOption
The Target CPA opt-in option with impact estimate.
JSON representation |
---|
{ "goal": enum ( |
Fields | |
---|---|
goal |
Output only. The goal achieved by this option. |
impact |
Output only. The impact estimate if this option is selected. |
targetCpaMicros |
Output only. Average CPA target. |
requiredCampaignBudgetAmountMicros |
Output only. The minimum campaign budget, in local currency for the account, required to achieve the target CPA. Amount is specified in micros, where one million is equivalent to one currency unit. |
TargetCpaOptInRecommendationGoal
Goal of TargetCpaOptIn recommendation.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
SAME_COST |
Recommendation to set Target CPA to maintain the same cost. |
SAME_CONVERSIONS |
Recommendation to set Target CPA to maintain the same conversions. |
SAME_CPA |
Recommendation to set Target CPA to maintain the same CPA. |
CLOSEST_CPA |
Recommendation to set Target CPA to a value that is as close as possible to, yet lower than, the actual CPA (computed for past 28 days). |
MaximizeConversionsOptInRecommendation
The Maximize Conversions Opt-In recommendation.
JSON representation |
---|
{ "recommendedBudgetAmountMicros": string } |
Fields | |
---|---|
recommendedBudgetAmountMicros |
Output only. The recommended new budget amount. |
EnhancedCpcOptInRecommendation
This type has no fields.
The Enhanced Cost-Per-Click Opt-In recommendation.
SearchPartnersOptInRecommendation
This type has no fields.
The Search Partners Opt-In recommendation.
MaximizeClicksOptInRecommendation
The Maximize Clicks opt-in recommendation.
JSON representation |
---|
{ "recommendedBudgetAmountMicros": string } |
Fields | |
---|---|
recommendedBudgetAmountMicros |
Output only. The recommended new budget amount. Only set if the current budget is too high. |
OptimizeAdRotationRecommendation
This type has no fields.
The Optimize Ad Rotation recommendation.
KeywordMatchTypeRecommendation
The keyword match type recommendation.
JSON representation |
---|
{ "keyword": { object ( |
Fields | |
---|---|
keyword |
Output only. The existing keyword where the match type should be more broad. |
recommendedMatchType |
Output only. The recommended new match type. |
MoveUnusedBudgetRecommendation
The move unused budget recommendation.
JSON representation |
---|
{
"budgetRecommendation": {
object ( |
Fields | |
---|---|
budgetRecommendation |
Output only. The recommendation for the constrained budget to increase. |
excessCampaignBudget |
Output only. The excess budget's resourceName. |
TargetRoasOptInRecommendation
The Target ROAS opt-in recommendation.
JSON representation |
---|
{ "recommendedTargetRoas": number, "requiredCampaignBudgetAmountMicros": string } |
Fields | |
---|---|
recommendedTargetRoas |
Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive. |
requiredCampaignBudgetAmountMicros |
Output only. The minimum campaign budget, in local currency for the account, required to achieve the target ROAS. Amount is specified in micros, where one million is equivalent to one currency unit. |
ResponsiveSearchAdRecommendation
The add responsive search ad recommendation.
JSON representation |
---|
{
"ad": {
object ( |
Fields | |
---|---|
ad |
Output only. Recommended ad. |
UseBroadMatchKeywordRecommendation
The use broad match keyword recommendation.
JSON representation |
---|
{
"keyword": [
{
object ( |
Fields | |
---|---|
keyword[] |
Output only. Sample of keywords to be expanded to Broad Match. |
suggestedKeywordsCount |
Output only. Total number of keywords to be expanded to Broad Match in the campaign. |
campaignKeywordsCount |
Output only. Total number of keywords in the campaign. |
campaignUsesSharedBudget |
Output only. Whether the associated campaign uses a shared budget. |
requiredCampaignBudgetAmountMicros |
Output only. The budget recommended to avoid becoming budget constrained after applying the recommendation. |
ResponsiveSearchAdAssetRecommendation
The add responsive search ad asset recommendation.
JSON representation |
---|
{ "currentAd": { object ( |
Fields | |
---|---|
currentAd |
Output only. The current ad to be updated. |
recommendedAssets |
Output only. The recommended assets. This is populated only with the new headlines and/or descriptions, and is otherwise empty. |
UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.
JSON representation |
---|
{ "merchantId": string, "salesCountryCode": string } |
Fields | |
---|---|
merchantId |
Output only. ID of Merchant Center account. |
salesCountryCode |
Output only. Country whose products from merchant's inventory should be included. |
ResponsiveSearchAdImproveAdStrengthRecommendation
The responsive search ad improve ad strength recommendation.
JSON representation |
---|
{ "currentAd": { object ( |
Fields | |
---|---|
currentAd |
Output only. The current ad to be updated. |
recommendedAd |
Output only. The updated ad. |
DisplayExpansionOptInRecommendation
This type has no fields.
The Display Expansion opt-in recommendation.
UpgradeLocalCampaignToPerformanceMaxRecommendation
This type has no fields.
The Upgrade Local campaign to Performance Max campaign recommendation.
RaiseTargetCpaBidTooLowRecommendation
The raise target CPA bid too low recommendation.
JSON representation |
---|
{ "recommendedTargetMultiplier": number, "averageTargetCpaMicros": string } |
Fields | |
---|---|
recommendedTargetMultiplier |
Output only. A number greater than 1.0 indicating the factor by which we recommend the target CPA should be increased. |
averageTargetCpaMicros |
Output only. The current average target CPA of the campaign, in micros of customer local currency. |
ForecastingSetTargetRoasRecommendation
The forecasting set target ROAS recommendation.
JSON representation |
---|
{
"recommendedTargetRoas": number,
"campaignBudget": {
object ( |
Fields | |
---|---|
recommendedTargetRoas |
Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive. |
campaignBudget |
Output only. The campaign budget. |
CampaignBudget
A campaign budget shared amongst various budget recommendation types.
JSON representation |
---|
{ "currentAmountMicros": string, "recommendedNewAmountMicros": string, "newStartDate": string } |
Fields | |
---|---|
currentAmountMicros |
Output only. Current budget amount. |
recommendedNewAmountMicros |
Output only. Recommended budget amount. |
newStartDate |
Output only. The date when the new budget would start being used. This field will be set for the following recommendation types: FORECASTING_SET_TARGET_ROAS YYYY-MM-DD format, for example, 2018-04-17. |
CalloutAssetRecommendation
The callout asset recommendation.
JSON representation |
---|
{ "recommendedCampaignCalloutAssets": [ { object ( |
Fields | |
---|---|
recommendedCampaignCalloutAssets[] |
Output only. New callout extension assets recommended at the campaign level. |
recommendedCustomerCalloutAssets[] |
Output only. New callout extension assets recommended at the customer level. |
SitelinkAssetRecommendation
The sitelink asset recommendation.
JSON representation |
---|
{ "recommendedCampaignSitelinkAssets": [ { object ( |
Fields | |
---|---|
recommendedCampaignSitelinkAssets[] |
Output only. New sitelink assets recommended at the campaign level. |
recommendedCustomerSitelinkAssets[] |
Output only. New sitelink assets recommended at the customer level. |
CallAssetRecommendation
This type has no fields.
The call asset recommendation.
ShoppingOfferAttributeRecommendation
The shopping recommendation to add an attribute to offers that are demoted because it is missing.
JSON representation |
---|
{
"merchant": {
object ( |
Fields | |
---|---|
merchant |
Output only. The details of the Merchant Center account. |
feedLabel |
Output only. The campaign feed label. |
offersCount |
Output only. The number of online, servable offers. |
demotedOffersCount |
Output only. The number of online, servable offers that are demoted for missing attributes. Visit the Merchant Center for more details. |
MerchantInfo
The Merchant Center account details.
JSON representation |
---|
{ "id": string, "name": string, "multiClient": boolean } |
Fields | |
---|---|
id |
Output only. The Merchant Center account ID. |
name |
Output only. The name of the Merchant Center account. |
multiClient |
Output only. Whether the Merchant Center account is a Multi-Client account (MCA). |
ShoppingAddProductsToCampaignRecommendation
The shopping recommendation to add products to a Shopping Campaign Inventory.
JSON representation |
---|
{ "merchant": { object ( |
Fields | |
---|---|
merchant |
Output only. The details of the Merchant Center account. |
feedLabel |
Output only. The feed label for the campaign. |
reason |
Output only. The reason why no products are attached to the campaign. |
Reason
Issues that results in a shopping campaign targeting zero products.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS |
The Merchant Center account does not have any submitted products. |
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED |
The Merchant Center account does not have any submitted products in the feed. |
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN |
The Google Ads account has active campaign filters that prevents inclusion of offers in the campaign. |
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN |
All products available have been explicitly excluded from being targeted by the campaign. |
ShoppingFixDisapprovedProductsRecommendation
The shopping recommendation to fix disapproved products in a Shopping Campaign Inventory.
JSON representation |
---|
{
"merchant": {
object ( |
Fields | |
---|---|
merchant |
Output only. The details of the Merchant Center account. |
feedLabel |
Output only. The feed label for the campaign. |
productsCount |
Output only. The number of products of the campaign. |
disapprovedProductsCount |
Output only. The numbers of products of the campaign that are disapproved. |
ShoppingTargetAllOffersRecommendation
The shopping recommendation to create a catch-all campaign that targets all offers.
JSON representation |
---|
{
"merchant": {
object ( |
Fields | |
---|---|
merchant |
Output only. The details of the Merchant Center account. |
untargetedOffersCount |
Output only. The number of untargeted offers. |
feedLabel |
Output only. The offer feed label. |
ShoppingMerchantCenterAccountSuspensionRecommendation
The shopping recommendation to fix Merchant Center account suspension issues.
JSON representation |
---|
{
"merchant": {
object ( |
Fields | |
---|---|
merchant |
Output only. The details of the Merchant Center account. |
feedLabel |
Output only. The feed label of the campaign for which the suspension happened. |
ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
The shopping recommendation to migrate Regular Shopping Campaign targeted offers to Performance Max campaigns.
JSON representation |
---|
{
"merchant": {
object ( |
Fields | |
---|---|
merchant |
Output only. The details of the Merchant Center account. |
feedLabel |
Output only. The feed label of the offers targeted by the campaigns sharing this suggestion. |
DynamicImageExtensionOptInRecommendation
This type has no fields.
Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.
RaiseTargetCpaRecommendation
Recommendation to raise Target CPA.
JSON representation |
---|
{ "targetAdjustment": { object ( |
Fields | |
---|---|
targetAdjustment |
Output only. The relevant information describing the recommended target adjustment. |
appBiddingGoal |
Output only. Represents the goal towards which the bidding strategy should optimize. Only populated for App Campaigns. |
TargetAdjustmentInfo
Information of a target adjustment recommendation.
JSON representation |
---|
{ "recommendedTargetMultiplier": number, "currentAverageTargetMicros": string, "sharedSet": string } |
Fields | |
---|---|
recommendedTargetMultiplier |
Output only. The factor by which we recommend the target to be adjusted by. |
currentAverageTargetMicros |
Output only. The current average target of the campaign or portfolio targeted by this recommendation. |
sharedSet |
Output only. The shared set resource name of the portfolio bidding strategy where the target is defined. Only populated if the recommendation is portfolio level. |
AppBiddingGoal
Represents the goal towards which the bidding strategy, of an app campaign, should optimize for.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Represents value unknown in this version of the API. |
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME |
The bidding strategy of the app campaign should aim to maximize installation of the app. |
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME |
The bidding strategy of the app campaign should aim to maximize the selected in-app conversions' volume. |
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE |
The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions. |
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION |
The bidding strategy of the app campaign should aim to maximize just the selected in-app conversion's volume, while achieving or exceeding target cost per in-app conversion. |
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND |
The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions while achieving or exceeding target return on advertising spend. |
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI |
This bidding strategy of the app campaign should aim to maximize installation of the app without advertiser-provided target cost-per-install. |
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME |
This bidding strategy of the app campaign should aim to maximize pre-registration of the app. |
LowerTargetRoasRecommendation
Recommendation to lower Target ROAS.
JSON representation |
---|
{
"targetAdjustment": {
object ( |
Fields | |
---|---|
targetAdjustment |
Output only. The relevant information describing the recommended target adjustment. |
PerformanceMaxOptInRecommendation
This type has no fields.
The Performance Max Opt In recommendation.
ImprovePerformanceMaxAdStrengthRecommendation
Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating.
JSON representation |
---|
{ "assetGroup": string } |
Fields | |
---|---|
assetGroup |
Output only. The asset group resource name. |
MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
The Dynamic Search Ads to Performance Max migration recommendation.
JSON representation |
---|
{ "applyLink": string } |
Fields | |
---|---|
applyLink |
Output only. A link to the Google Ads UI where the customer can manually apply the recommendation. |
SearchTermView
A search term view with metrics aggregated by search term at the ad group level.
JSON representation |
---|
{
"resourceName": string,
"status": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the search term view. Search term view resource names have the form:
|
status |
Output only. Indicates whether the search term is currently one of your targeted or excluded keywords. |
searchTerm |
Output only. The search term. |
adGroup |
Output only. The ad group the search term served in. |
SearchTermTargetingStatus
Indicates whether the search term is one of your targeted or excluded keywords.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ADDED |
Search term is added to targeted keywords. |
EXCLUDED |
Search term matches a negative keyword. |
ADDED_EXCLUDED |
Search term has been both added and excluded. |
NONE |
Search term is neither targeted nor excluded. |
ShoppingPerformanceView
Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: |
SmartCampaignSearchTermView
A Smart campaign search term view.
JSON representation |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the Smart campaign search term view. Smart campaign search term view resource names have the form:
|
searchTerm |
Output only. The search term. |
campaign |
Output only. The Smart campaign the search term served in. |
ThirdPartyAppAnalyticsLink
A data sharing connection, allowing the import of third party app analytics into a Google Ads Customer.
JSON representation |
---|
{ "resourceName": string, "shareableLinkId": string } |
Fields | |
---|---|
resourceName |
Immutable. The resource name of the third party app analytics link. Third party app analytics link resource names have the form:
|
shareableLinkId |
Output only. The shareable link ID that should be provided to the third party when setting up app analytics. This is able to be regenerated using regenerate method in the ThirdPartyAppAnalyticsLinkService. |
TopicView
A topic view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the topic view. Topic view resource names have the form:
|
TravelActivityGroupView
A travel activity group view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the travel activity group view. Travel Activity Group view resource names have the form:
|
TravelActivityPerformanceView
A travel activity performance view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form:
|
UserInterest
A user interest: a particular interest-based vertical to be targeted.
JSON representation |
---|
{ "resourceName": string, "taxonomyType": enum ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the user interest. User interest resource names have the form:
|
taxonomyType |
Output only. Taxonomy type of the user interest. |
availabilities[] |
Output only. Availability information of the user interest. |
userInterestId |
Output only. The ID of the user interest. |
name |
Output only. The name of the user interest. |
userInterestParent |
Output only. The parent of the user interest. |
launchedToAll |
Output only. True if the user interest is launched to all channels and locales. |
UserInterestTaxonomyType
Enum containing the possible UserInterestTaxonomyTypes.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
AFFINITY |
The affinity for this user interest. |
IN_MARKET |
The market for this user interest. |
MOBILE_APP_INSTALL_USER |
Users known to have installed applications in the specified categories. |
VERTICAL_GEO |
The geographical location of the interest-based vertical. |
NEW_SMART_PHONE_USER |
User interest criteria for new smart phone users. |
LifeEvent
A life event: a particular interest-based vertical to be targeted to reach users when they are in the midst of important life milestones.
JSON representation |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the life event. Life event resource names have the form:
|
id |
Output only. The ID of the life event. |
name |
Output only. The name of the life event, for example,"Recently Moved" |
parent |
Output only. The parent of the lifeEvent. |
launchedToAll |
Output only. True if the life event is launched to all channels and locales. |
availabilities[] |
Output only. Availability information of the life event. |
UserLocationView
A user location view.
User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.
JSON representation |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the user location view. UserLocation view resource names have the form:
|
countryCriterionId |
Output only. Criterion Id for the country. |
targetingLocation |
Output only. Indicates whether location was targeted or not. |
TopicConstant
Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").
JSON representation |
---|
{ "resourceName": string, "path": [ string ], "id": string, "topicConstantParent": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the topic constant. topic constant resource names have the form:
|
path[] |
Output only. The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, {"Pets & Animals", "Pets", "Dogs"} represents the "Pets & Animals/Pets/Dogs" category. List of available topic categories at https://developers.google.com/google-ads/api/reference/data/verticals |
id |
Output only. The ID of the topic. |
topicConstantParent |
Output only. Resource name of parent of the topic constant. |
Video
A video.
JSON representation |
---|
{ "resourceName": string, "id": string, "channelId": string, "durationMillis": string, "title": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the video. Video resource names have the form:
|
id |
Output only. The ID of the video. |
channelId |
Output only. The owner channel id of the video. |
durationMillis |
Output only. The duration of the video in milliseconds. |
title |
Output only. The title of the video. |
WebpageView
A webpage view.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resourceName |
Output only. The resource name of the webpage view. Webpage view resource names have the form:
|
LeadFormSubmissionData
Data from lead form submissions.
JSON representation |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
Fields | |
---|---|
resourceName |
Output only. The resource name of the lead form submission data. Lead form submission data resource names have the form:
|
id |
Output only. ID of this lead form submission. |
asset |
Output only. Asset associated with the submitted lead form. |
campaign |
Output only. Campaign associated with the submitted lead form. |
leadFormSubmissionFields[] |
Output only. Submission data associated with a lead form. |
customLeadFormSubmissionFields[] |
Output only. Submission data associated with a custom lead form. |
adGroup |
Output only. AdGroup associated with the submitted lead form. |
adGroupAd |
Output only. AdGroupAd associated with the submitted lead form. |
gclid |
Output only. Google Click Id associated with the submissed lead form. |
submissionDateTime |
Output only. The date and time at which the lead form was submitted. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", for example, "2019-01-01 12:32:45-08:00". |
LeadFormSubmissionField
Fields in the submitted lead form.
JSON representation |
---|
{
"fieldType": enum ( |
Fields | |
---|---|
fieldType |
Output only. Field type for lead form fields. |
fieldValue |
Output only. Field value for lead form fields. |
CustomLeadFormSubmissionField
Fields in the submitted custom question
JSON representation |
---|
{ "questionText": string, "fieldValue": string } |
Fields | |
---|---|
questionText |
Output only. Question text for custom question, maximum number of characters is 300. |
fieldValue |
Output only. Field value for custom question response, maximum number of characters is 70. |
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. |
publisherPurchasedClicks |
Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity |
publisherOrganicClicks |
Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity |
publisherUnknownClicks |
Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" |
absoluteTopImpressionPercentage |
Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
activeViewCpm |
Average cost of viewable impressions ( |
activeViewCtr |
Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the 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. |
allNewCustomerLifetimeValue |
All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "allConversionsValue". See https://support.google.com/google-ads/answer/12080169 for more details. |
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. |
auctionInsightSearchAbsoluteTopImpressionPercentage |
This metric is part of the Auction Insights report, and tells how often the ads of another participant showed in the most prominent position on the search results page. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
auctionInsightSearchImpressionShare |
This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
auctionInsightSearchOutrankingShare |
This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
auctionInsightSearchOverlapRate |
This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. |
auctionInsightSearchPositionAboveRate |
This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. |
auctionInsightSearchTopImpressionPercentage |
This metric is part of the Auction Insights report, and tells how often the ads of another participant showed adjacent to the top organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
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. |
biddableAppInstallConversions |
Number of app installs. |
biddableAppPostInstallConversions |
Number of in-app actions. |
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 (for example, 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. |
newCustomerLifetimeValue |
New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversionsValue" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. |
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. |
hotelCommissionRateMicros |
Commission bid rate in micros. A 20% commission is represented as 200,000. |
hotelExpectedCommissionCost |
Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency. |
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 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 among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchBudgetLostImpressionShare |
The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchBudgetLostTopImpressionShare |
The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchClickShare |
The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: 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 Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: 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 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. |
searchRankLostAbsoluteTopImpressionShare |
The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchRankLostImpressionShare |
The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchRankLostTopImpressionShare |
The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchTopImpressionShare |
The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
searchVolume |
Search volume range for a search term insight category. |
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. |
averageTargetCpaMicros |
The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA). |
averageTargetRoas |
The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS). |
topImpressionPercentage |
The percent of your ad impressions that are shown adjacent to the top 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 (for example, clicking on) another ad. |
allConversionsFromLocationAssetClickToCall |
Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetDirections |
Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetMenu |
Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetOrder |
Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetOtherEngagement |
Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetStoreVisits |
Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetWebsite |
Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
eligibleImpressionsFromLocationAssetStoreReach |
Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetClickToCall |
Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetDirections |
Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetMenu |
Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetOrder |
Number of order clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetOtherEngagement |
Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetStoreVisits |
Estimated number of visits to the store after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetWebsite |
Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. |
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 (for example, the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions. |
SearchVolumeRange
Search volume range. Actual search volume falls within this range.
JSON representation |
---|
{ "min": string, "max": string } |
Fields | |
---|---|
min |
Lower bound of search volume. |
max |
Upper bound of search volume. |
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, for example, 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, for example, 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. |
skAdNetworkUserType |
iOS Store Kit Ad Network user type. |
skAdNetworkAdEventType |
iOS Store Kit Ad Network ad event type. |
skAdNetworkAttributionCredit |
iOS Store Kit Ad Network attribution credit |
newVersusReturningCustomers |
This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. |
activityAccountId |
Activity account ID. |
activityRating |
Activity rating. |
externalActivityId |
Advertiser supplied activity ID. |
adGroup |
Resource name of the ad group. |
assetGroup |
Resource name of the asset group. |
auctionInsightDomain |
Domain (visible URL) of a participant in the Auction Insights report. |
campaign |
Resource name of the campaign. |
conversionAction |
Resource name of the conversion action. |
conversionActionName |
Conversion action name. |
conversionAdjustment |
This segments your conversion columns by the original conversion and conversion value versus 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, for example, 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. |
productFeedLabel |
Feed label 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
searchSubcategory |
A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory. |
searchTerm |
A search term. |
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, for example, non-iOS campaign. |
skAdNetworkSourceApp |
App where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. |
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 (for example, clicks) are counted across all the parts of the served ad (for example, 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 |
Search partners. |
CONTENT |
Display Network. |
YOUTUBE_SEARCH |
YouTube 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. |
CROSS_NETWORK |
Cross-network. From Performance Max and Discovery Campaigns. |
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 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 Search Ads 360. Displayed in Google Ads UI as Analytics (SA360). |
FIREBASE_SEARCH_ADS_360 |
Conversion that comes from a linked Firebase event for Search Ads 360. |
DISPLAY_AND_VIDEO_360_FLOODLIGHT |
Conversion that is reported by Floodlight for DV360. |
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, for example, 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 |
Search partners: Top. |
SEARCH_PARTNER_OTHER |
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. |
SkAdNetworkUserType
Enumerates SkAdNetwork user types
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
UNAVAILABLE |
The value was not present in the postback or we do not have this data for other reasons. |
NEW_INSTALLER |
The user installed the app for the first time. |
REINSTALLER |
The user has previously installed the app. |
SkAdNetworkAdEventType
Enumerates SkAdNetwork ad event types
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
UNAVAILABLE |
The value was not present in the postback or we do not have this data for other reasons. |
INTERACTION |
The user interacted with the ad. |
VIEW |
The user viewed the ad. |
SkAdNetworkSourceApp
A SkAdNetworkSourceApp segment.
JSON representation |
---|
{ "skAdNetworkSourceAppId": string } |
Fields | |
---|---|
skAdNetworkSourceAppId |
App id where the ad that drove the iOS Store Kit Ad Network install was shown. |
SkAdNetworkAttributionCredit
Enumerates SkAdNetwork attribution credits.
Enums | |
---|---|
UNSPECIFIED |
Default value. This value is equivalent to null. |
UNKNOWN |
The value is unknown in this API version. The true enum value cannot be returned in this API version or is not supported yet. |
UNAVAILABLE |
The value was not present in the postback or we do not have this data for other reasons. |
WON |
Google was the ad network that won ad attribution. |
CONTRIBUTED |
Google qualified for attribution, but didn't win. |
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. |
ConvertingUserPriorEngagementTypeAndLtvBucket
Enumerates converting user prior engagement types and lifetime-value bucket
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
The value is unknown in this version. |
NEW |
Converting user is new to the advertiser. |
RETURNING |
Converting user is returning to the advertiser. Definition of returning differs among conversion types, such as a second store visit versus a second online purchase. |
NEW_AND_HIGH_LTV |
Converting user is new to the advertiser and has high lifetime value. |