Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

GoogleAdsRow

A returned row from the query.

JSON representation
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCriterionSimulation": {
    object (CampaignCriterionSimulation)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExperiment": {
    object (CampaignExperiment)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "recommendation": {
    object (Recommendation)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
Fields
accountBudget

object (AccountBudget)

The account budget in the query.

accountBudgetProposal

object (AccountBudgetProposal)

The account budget proposal referenced in the query.

adGroup

object (AdGroup)

The ad group referenced in the query.

adGroupAd

object (AdGroupAd)

The ad referenced in the query.

adGroupAdAssetView

object (AdGroupAdAssetView)

The ad group ad asset view in the query.

adGroupAdLabel

object (AdGroupAdLabel)

The ad group ad label referenced in the query.

adGroupAsset

object (AdGroupAsset)

The ad group asset referenced in the query.

adGroupAudienceView

object (AdGroupAudienceView)

The ad group audience view referenced in the query.

adGroupBidModifier

object (AdGroupBidModifier)

The bid modifier referenced in the query.

adGroupCriterion

object (AdGroupCriterion)

The criterion referenced in the query.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

The ad group criterion label referenced in the query.

adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

The ad group criterion simulation referenced in the query.

adGroupExtensionSetting

object (AdGroupExtensionSetting)

The ad group extension setting referenced in the query.

adGroupFeed

object (AdGroupFeed)

The ad group feed referenced in the query.

adGroupLabel

object (AdGroupLabel)

The ad group label referenced in the query.

adGroupSimulation

object (AdGroupSimulation)

The ad group simulation referenced in the query.

adParameter

object (AdParameter)

The ad parameter referenced in the query.

ageRangeView

object (AgeRangeView)

The age range view referenced in the query.

adScheduleView

object (AdScheduleView)

The ad schedule view referenced in the query.

domainCategory

object (DomainCategory)

The domain category referenced in the query.

asset

object (Asset)

The asset referenced in the query.

batchJob

object (BatchJob)

The batch job referenced in the query.

biddingStrategy

object (BiddingStrategy)

The bidding strategy referenced in the query.

biddingStrategySimulation

object (BiddingStrategySimulation)

The bidding strategy simulation referenced in the query.

billingSetup

object (BillingSetup)

The billing setup referenced in the query.

callView

object (CallView)

The call view referenced in the query.

campaignBudget

object (CampaignBudget)

The campaign budget referenced in the query.

campaign

object (Campaign)

The campaign referenced in the query.

campaignAsset

object (CampaignAsset)

The campaign asset referenced in the query.

campaignAudienceView

object (CampaignAudienceView)

The campaign audience view referenced in the query.

campaignBidModifier

object (CampaignBidModifier)

The campaign bid modifier referenced in the query.

campaignCriterion

object (CampaignCriterion)

The campaign criterion referenced in the query.

campaignCriterionSimulation

object (CampaignCriterionSimulation)

The campaign criterion simulation referenced in the query.

campaignDraft

object (CampaignDraft)

The campaign draft referenced in the query.

campaignExperiment

object (CampaignExperiment)

The campaign experiment referenced in the query.

campaignExtensionSetting

object (CampaignExtensionSetting)

The campaign extension setting referenced in the query.

campaignFeed

object (CampaignFeed)

The campaign feed referenced in the query.

campaignLabel

object (CampaignLabel)

The campaign label referenced in the query.

campaignSharedSet

object (CampaignSharedSet)

Campaign Shared Set referenced in AWQL query.

campaignSimulation

object (CampaignSimulation)

The campaign simulation referenced in the query.

carrierConstant

object (CarrierConstant)

The carrier constant referenced in the query.

changeEvent

object (ChangeEvent)

The ChangeEvent referenced in the query.

changeStatus

object (ChangeStatus)

The ChangeStatus referenced in the query.

combinedAudience

object (CombinedAudience)

The CombinedAudience referenced in the query.

conversionAction

object (ConversionAction)

The conversion action referenced in the query.

conversionCustomVariable

object (ConversionCustomVariable)

The conversion custom variable referenced in the query.

clickView

object (ClickView)

The ClickView referenced in the query.

currencyConstant

object (CurrencyConstant)

The currency constant referenced in the query.

customAudience

object (CustomAudience)

The CustomAudience referenced in the query.

customInterest

object (CustomInterest)

The CustomInterest referenced in the query.

customer

object (Customer)

The customer referenced in the query.

customerAsset

object (CustomerAsset)

The customer asset referenced in the query.

customerClient

object (CustomerClient)

The CustomerClient referenced in the query.

customerExtensionSetting

object (CustomerExtensionSetting)

The customer extension setting referenced in the query.

customerFeed

object (CustomerFeed)

The customer feed referenced in the query.

customerLabel

object (CustomerLabel)

The customer label referenced in the query.

customerNegativeCriterion

object (CustomerNegativeCriterion)

The customer negative criterion referenced in the query.

customerUserAccess

object (CustomerUserAccess)

The CustomerUserAccess referenced in the query.

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

The CustomerUserAccessInvitation referenced in the query.

detailPlacementView

object (DetailPlacementView)

The detail placement view referenced in the query.

displayKeywordView

object (DisplayKeywordView)

The display keyword view referenced in the query.

distanceView

object (DistanceView)

The distance view referenced in the query.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

The dynamic search ads search term view referenced in the query.

expandedLandingPageView

object (ExpandedLandingPageView)

The expanded landing page view referenced in the query.

extensionFeedItem

object (ExtensionFeedItem)

The extension feed item referenced in the query.

feed

object (Feed)

The feed referenced in the query.

feedItem

object (FeedItem)

The feed item referenced in the query.

feedItemSet

object (FeedItemSet)

The feed item set referenced in the query.

feedItemTarget

object (FeedItemTarget)

The feed item target referenced in the query.

feedMapping

object (FeedMapping)

The feed mapping referenced in the query.

feedPlaceholderView

object (FeedPlaceholderView)

The feed placeholder view referenced in the query.

genderView

object (GenderView)

The gender view referenced in the query.

geoTargetConstant

object (GeoTargetConstant)

The geo target constant referenced in the query.

geographicView

object (GeographicView)

The geographic view referenced in the query.

groupPlacementView

object (GroupPlacementView)

The group placement view referenced in the query.

hotelGroupView

object (HotelGroupView)

The hotel group view referenced in the query.

hotelPerformanceView

object (HotelPerformanceView)

The hotel performance view referenced in the query.

incomeRangeView

object (IncomeRangeView)

The income range view referenced in the query.

keywordView

object (KeywordView)

The keyword view referenced in the query.

keywordPlan

object (KeywordPlan)

The keyword plan referenced in the query.

keywordPlanCampaign

object (KeywordPlanCampaign)

The keyword plan campaign referenced in the query.

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

The keyword plan campaign keyword referenced in the query.

keywordPlanAdGroup

object (KeywordPlanAdGroup)

The keyword plan ad group referenced in the query.

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

The keyword plan ad group referenced in the query.

label

object (Label)

The label referenced in the query.

landingPageView

object (LandingPageView)

The landing page view referenced in the query.

languageConstant

object (LanguageConstant)

The language constant referenced in the query.

locationView

object (LocationView)

The location view referenced in the query.

managedPlacementView

object (ManagedPlacementView)

The managed placement view referenced in the query.

mediaFile

object (MediaFile)

The media file referenced in the query.

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

The mobile app category constant referenced in the query.

mobileDeviceConstant

object (MobileDeviceConstant)

The mobile device constant referenced in the query.

offlineUserDataJob

object (OfflineUserDataJob)

The offline user data job referenced in the query.

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

The operating system version constant referenced in the query.

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

The paid organic search term view referenced in the query.

parentalStatusView

object (ParentalStatusView)

The parental status view referenced in the query.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

The Product Bidding Category referenced in the query.

productGroupView

object (ProductGroupView)

The product group view referenced in the query.

recommendation

object (Recommendation)

The recommendation referenced in the query.

searchTermView

object (SearchTermView)

The search term view referenced in the query.

sharedCriterion

object (SharedCriterion)

The shared set referenced in the query.

sharedSet

object (SharedSet)

The shared set referenced in the query.

shoppingPerformanceView

object (ShoppingPerformanceView)

The shopping performance view referenced in the query.

topicView

object (TopicView)

The topic view referenced in the query.

userInterest

object (UserInterest)

The user interest referenced in the query.

lifeEvent

object (LifeEvent)

The life event referenced in the query.

userList

object (UserList)

The user list referenced in the query.

userLocationView

object (UserLocationView)

The user location view referenced in the query.

remarketingAction

object (RemarketingAction)

The remarketing action referenced in the query.

topicConstant

object (TopicConstant)

The topic constant referenced in the query.

video

object (Video)

The video referenced in the query.

webpageView

object (WebpageView)

The webpage view referenced in the query.

metrics

object (Metrics)

The metrics.

segments

object (Segments)

The segments.

CallView

A call view that includes data for call tracking of call-only ads or call extensions.

JSON representation
{
  "resourceName": string,
  "callerRegionCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
Fields
resourceName

string

Output only. The resource name of the call view. Call view resource names have the form:

customers/{customerId}/callViews/{call_detail_id}

callerRegionCode

string

Output only. Region code of the caller.

callerAreaCode

string

Output only. Area code of the caller. Null if the call duration is shorter than 15 seconds.

callDurationSeconds

string (int64 format)

Output only. The advertiser-provided call duration in seconds.

startCallDateTime

string

Output only. The advertiser-provided call start date time.

endCallDateTime

string

Output only. The advertiser-provided call end date time.

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

Output only. The call tracking display location.

type

enum (CallType)

Output only. The type of the call.

callStatus

enum (GoogleVoiceCallStatus)

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.

GoogleVoiceCallStatus

Possible statuses of a google voice call.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
MISSED The call was missed.
RECEIVED The call was received.

ChangeEvent

Describes the granular change of returned resource of certain resource types. Changes made through UI, API and new versions of Editor by external users (including external users, and internal users that can be shown externally) in the past 30 days will be shown. The change shows the old values of the changed fields before the change and the new values right after the change. ChangeEvent could have up to 3 minutes delay to reflect a new change.

JSON representation
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string
}
Fields
resourceName

string

Output only. The resource name of the change event. Change event resource names have the form:

customers/{customerId}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}

changeDateTime

string

Output only. Time at which the change was committed on this resource.

changeResourceType

enum (ChangeEventResourceType)

Output only. The type of the changed resource. This dictates what resource will be set in oldResource and newResource.

changeResourceName

string

Output only. The Simply resource this change occurred on.

clientType

enum (ChangeClientType)

Output only. Where the change was made through.

userEmail

string

Output only. The email of the user who made this change.

oldResource

object (ChangedResource)

Output only. The old resource before the change. Only changed fields will be populated.

newResource

object (ChangedResource)

Output only. The new resource after the change. Only changed fields will be populated.

resourceChangeOperation

enum (ResourceChangeOperation)

Output only. The operation on the changed resource.

changedFields

string (FieldMask format)

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: "user.displayName,photo".

campaign

string

Output only. The Campaign affected by this change.

adGroup

string

Output only. The AdGroup affected by this change.

feed

string

Output only. The Feed affected by this change.

feedItem

string

Output only. The FeedItem 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.

ChangeClientType

The source that the changeEvent resource was made through.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN Used for return value only. Represents an unclassified client type unknown in this version.
GOOGLE_ADS_WEB_CLIENT Changes made through the "ads.google.com". For example, changes made through campaign management.
GOOGLE_ADS_AUTOMATED_RULE Changes made through Google Ads automated rules.
GOOGLE_ADS_SCRIPTS Changes made through Google Ads scripts.
GOOGLE_ADS_BULK_UPLOAD Changes made by Google Ads bulk upload.
GOOGLE_ADS_API Changes made by Google Ads API.
GOOGLE_ADS_EDITOR Changes made by Google Ads Editor.
GOOGLE_ADS_MOBILE_APP Changes made by Google Ads mobile app.
GOOGLE_ADS_RECOMMENDATIONS Changes made through Google Ads recommendations.
SEARCH_ADS_360_SYNC Changes made through googleAds.search Ads 360 Sync.
SEARCH_ADS_360_POST Changes made through googleAds.search Ads 360 Post.
INTERNAL_TOOL Changes made through internal tools. For example, when a user sets a URL template on an entity like a Campaign, it's automatically wrapped with the SA360 Clickserver URL.
OTHER Types of changes that are not categorized, for example, changes made by coupon redemption through Google Ads.

ChangedResource

A wrapper proto presenting all supported resources. Only the resource of the changeResourceType will be set.

JSON representation
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  }
}
Fields
ad

object (Ad)

Output only. Set if changeResourceType == AD.

adGroup

object (AdGroup)

Output only. Set if changeResourceType == AD_GROUP.

adGroupCriterion

object (AdGroupCriterion)

Output only. Set if changeResourceType == AD_GROUP_CRITERION.

campaign

object (Campaign)

Output only. Set if changeResourceType == CAMPAIGN.

campaignBudget

object (CampaignBudget)

Output only. Set if changeResourceType == CAMPAIGN_BUDGET.

adGroupBidModifier

object (AdGroupBidModifier)

Output only. Set if changeResourceType == AD_GROUP_BID_MODIFIER.

campaignCriterion

object (CampaignCriterion)

Output only. Set if changeResourceType == CAMPAIGN_CRITERION.

feed

object (Feed)

Output only. Set if changeResourceType == FEED.

feedItem

object (FeedItem)

Output only. Set if changeResourceType == FEED_ITEM.

campaignFeed

object (CampaignFeed)

Output only. Set if changeResourceType == CAMPAIGN_FEED.

adGroupFeed

object (AdGroupFeed)

Output only. Set if changeResourceType == AD_GROUP_FEED.

adGroupAd

object (AdGroupAd)

Output only. Set if changeResourceType == AD_GROUP_AD.

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.

Metrics

Metrics data.

JSON representation
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "speedScore": string,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string
}
Fields
allConversionsValueByConversionDate

number

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

number

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

number

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

number

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

enum (QualityScoreBucket)

The creative historical quality score.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

The quality of historical landing page experience.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

The historical search predicted click through rate (CTR).

interactionEventTypes[]

enum (InteractionEventType)

The types of payable and free interactions.

skAdNetworkConversions

string (int64 format)

The number of iOS Store Kit Ad Network conversions.

absoluteTopImpressionPercentage

number

The percent of your ad impressions that are shown as the very first ad above the organic search results.

activeViewCpm

number

Average cost of viewable impressions (activeViewImpressions).

activeViewCtr

number

Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.

activeViewImpressions

string (int64 format)

A measurement of how often your ad has become viewable on a Display Network site.

activeViewMeasurability

number

The ratio of impressions that could be measured by Active View over the number of served impressions.

activeViewMeasurableCostMicros

string (int64 format)

The cost of the impressions you received that were measurable by Active View.

activeViewMeasurableImpressions

string (int64 format)

The number of times your ads are appearing on placements in positions where they can be seen.

activeViewViewability

number

The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).

allConversionsFromInteractionsRate

number

All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.

allConversionsValue

number

The value of all conversions.

allConversions

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric.

allConversionsValuePerCost

number

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

number

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

number

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

number

The value of all conversions from interactions divided by the total number of interactions.

allConversionsFromMenu

number

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

number

The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.

allConversionsFromOtherEngagement

number

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

number

Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only.

allConversionsFromStoreWebsite

number

The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.

averageCost

number

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.

averageCpc

number

The total cost of all clicks divided by the total number of clicks received.

averageCpe

number

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

number

Average cost-per-thousand impressions (CPM).

averageCpv

number

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

number

Average number of pages viewed per session.

averageTimeOnSite

number

Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.

benchmarkAverageMaxCpc

number

An indication of how other advertisers are bidding on similar products.

benchmarkCtr

number

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

number

Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.

clicks

string (int64 format)

The number of clicks.

combinedClicks

string (int64 format)

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

number

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

string (int64 format)

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

number

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

number

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

string

The last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (e.g. because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone.

conversionLastConversionDate

string

The date of the most recent conversion for this conversion action. The date is in the customer's time zone.

contentRankLostImpressionShare

number

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

number

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

number

The value of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

conversionsValuePerCost

number

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

number

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

number

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

string (int64 format)

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.

costPerAllConversions

number

The cost of ad interactions divided by all conversions.

costPerConversion

number

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

number

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

number

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

number

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

currentModelAttributedConversions

number

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

number

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

number

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

number

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

number

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

number

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

string (int64 format)

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

number

Average lead value based on clicks.

hotelPriceDifferencePercentage

number

The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser.

hotelEligibleImpressions

string (int64 format)

The number of impressions that hotel partners could have had given their feed performance.

historicalQualityScore

string (int64 format)

The historical quality score.

gmailForwards

string (int64 format)

The number of times the ad was forwarded to someone else as a message.

gmailSaves

string (int64 format)

The number of times someone has saved your Gmail ad to their inbox as a message.

gmailSecondaryClicks

string (int64 format)

The number of clicks to the landing page on the expanded state of Gmail ads.

impressionsFromStoreReach

string (int64 format)

The number of times a store's location-based ad was shown. This metric applies to feed items only.

impressions

string (int64 format)

Count of how often your ad has appeared on a search results page or website on the Google Network.

interactionRate

number

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

string (int64 format)

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

number

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalidClicks

string (int64 format)

Number of clicks Google considers illegitimate and doesn't charge you for.

messageChats

string (int64 format)

Number of message chats initiated for Click To Message impressions that were message tracking eligible.

messageImpressions

string (int64 format)

Number of Click To Message impressions that were message tracking eligible.

messageChatRate

number

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

number

The percentage of mobile clicks that go to a mobile-friendly page.

organicClicks

string (int64 format)

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

number

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

string (int64 format)

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

number

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

string (int64 format)

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

number

Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.

phoneCalls

string (int64 format)

Number of offline phone calls.

phoneImpressions

string (int64 format)

Number of offline phone impressions.

phoneThroughRate

number

Number of phone calls received (phoneCalls) divided by the number of times your phone number is shown (phoneImpressions).

relativeCtr

number

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

number

The percentage of the customer's Shopping or googleAds.search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999.

searchBudgetLostAbsoluteTopImpressionShare

number

The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: googleAds.search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

searchBudgetLostImpressionShare

number

The estimated percent of times that your ad was eligible to show on the googleAds.search Network but didn't because your budget was too low. Note: googleAds.search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

searchBudgetLostTopImpressionShare

number

The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: googleAds.search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

searchClickShare

number

The number of clicks you've received on the googleAds.search Network divided by the estimated number of clicks you were eligible to receive. Note: googleAds.search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

searchExactMatchImpressionShare

number

The impressions you've received divided by the estimated number of impressions you were eligible to receive on the googleAds.search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: googleAds.search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

searchImpressionShare

number

The impressions you've received on the googleAds.search Network divided by the estimated number of impressions you were eligible to receive. Note: googleAds.search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

searchRankLostAbsoluteTopImpressionShare

number

The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: googleAds.search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

searchRankLostImpressionShare

number

The estimated percentage of impressions on the googleAds.search Network that your ads didn't receive due to poor Ad Rank. Note: googleAds.search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

searchRankLostTopImpressionShare

number

The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: googleAds.search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

searchTopImpressionShare

number

The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: googleAds.search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

speedScore

string (int64 format)

A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest.

topImpressionPercentage

number

The percent of your ad impressions that are shown anywhere above the organic search results.

validAcceleratedMobilePagesClicksPercentage

number

The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page.

valuePerAllConversions

number

The value of all conversions divided by the number of all conversions.

valuePerAllConversionsByConversionDate

number

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

number

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

number

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

number

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

number

Percentage of impressions where the viewer watched all of your video.

videoQuartileP25Rate

number

Percentage of impressions where the viewer watched 25% of your video.

videoQuartileP50Rate

number

Percentage of impressions where the viewer watched 50% of your video.

videoQuartileP75Rate

number

Percentage of impressions where the viewer watched 75% of your video.

videoViewRate

number

The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.

videoViews

string (int64 format)

The number of times your video ads were viewed.

viewThroughConversions

string (int64 format)

The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.

InteractionEventType

Enum describing possible types of payable and free interactions.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
CLICK Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events.
ENGAGEMENT The user's expressed intent to engage with the ad in-place.
VIDEO_VIEW User viewed a video ad.
NONE The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (i.e., the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions.

Segments

Segment only fields.

JSON representation
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string
}
Fields
adDestinationType

enum (AdDestinationType)

Ad Destination type.

adNetworkType

enum (AdNetworkType)

Ad network type.

budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

Budget campaign association status.

clickType

enum (ClickType)

Click type.

conversionActionCategory

enum (ConversionActionCategory)

Conversion action category.

conversionAttributionEventType

enum (ConversionAttributionEventType)

Conversion attribution event type.

conversionLagBucket

enum (ConversionLagBucket)

An enum value representing the number of days between the impression and the conversion.

conversionOrAdjustmentLagBucket

enum (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

enum (DayOfWeek)

Day of the week, e.g., MONDAY.

device

enum (Device)

Device to which metrics apply.

externalConversionSource

enum (ExternalConversionSource)

External conversion source.

hotelCheckInDayOfWeek

enum (DayOfWeek)

Hotel check-in day of week.

hotelDateSelectionType

enum (HotelDateSelectionType)

Hotel date selection type.

hotelRateType

enum (HotelRateType)

Hotel rate type.

hotelPriceBucket

enum (HotelPriceBucket)

Hotel price bucket.

keyword

object (Keyword)

Keyword criterion.

monthOfYear

enum (MonthOfYear)

Month of the year, e.g., January.

placeholderType

enum (PlaceholderType)

Placeholder type. This is only used with feed item metrics.

productChannel

enum (ProductChannel)

Channel of the product.

productChannelExclusivity

enum (ProductChannelExclusivity)

Channel exclusivity of the product.

productCondition

enum (ProductCondition)

Condition of the product.

searchEngineResultsPageType

enum (SearchEngineResultsPageType)

Type of the search engine results page.

searchTermMatchType

enum (SearchTermMatchType)

Match type of the keyword that triggered the ad, including variants.

slot

enum (Slot)

Position of the ad.

conversionAction

string

Resource name of the conversion action.

conversionActionName

string

Conversion action name.

conversionAdjustment

boolean

This segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data.

date

string

Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.

geoTargetAirport

string

Resource name of the geo target constant that represents an airport.

geoTargetCanton

string

Resource name of the geo target constant that represents a canton.

geoTargetCity

string

Resource name of the geo target constant that represents a city.

geoTargetCountry

string

Resource name of the geo target constant that represents a country.

geoTargetCounty

string

Resource name of the geo target constant that represents a county.

geoTargetDistrict

string

Resource name of the geo target constant that represents a district.

geoTargetMetro

string

Resource name of the geo target constant that represents a metro.

geoTargetMostSpecificLocation

string

Resource name of the geo target constant that represents the most specific location.

geoTargetPostalCode

string

Resource name of the geo target constant that represents a postal code.

geoTargetProvince

string

Resource name of the geo target constant that represents a province.

geoTargetRegion

string

Resource name of the geo target constant that represents a region.

geoTargetState

string

Resource name of the geo target constant that represents a state.

hotelBookingWindowDays

string (int64 format)

Hotel booking window in days.

hotelCenterId

string (int64 format)

Hotel center ID.

hotelCheckInDate

string

Hotel check-in date. Formatted as yyyy-MM-dd.

hotelCity

string

Hotel city.

hotelClass

integer

Hotel class.

hotelCountry

string

Hotel country.

hotelLengthOfStay

integer

Hotel length of stay.

hotelRateRuleId

string

Hotel rate rule ID.

hotelState

string

Hotel state.

hour

integer

Hour of day as a number between 0 and 23, inclusive.

interactionOnThisExtension

boolean

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

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

partnerHotelId

string

Partner hotel ID.

productAggregatorId

string (int64 format)

Aggregator ID of the product.

productBiddingCategoryLevel1

string

Bidding category (level 1) of the product.

productBiddingCategoryLevel2

string

Bidding category (level 2) of the product.

productBiddingCategoryLevel3

string

Bidding category (level 3) of the product.

productBiddingCategoryLevel4

string

Bidding category (level 4) of the product.

productBiddingCategoryLevel5

string

Bidding category (level 5) of the product.

productBrand

string

Brand of the product.

productCountry

string

Resource name of the geo target constant for the country of sale of the product.

productCustomAttribute0

string

Custom attribute 0 of the product.

productCustomAttribute1

string

Custom attribute 1 of the product.

productCustomAttribute2

string

Custom attribute 2 of the product.

productCustomAttribute3

string

Custom attribute 3 of the product.

productCustomAttribute4

string

Custom attribute 4 of the product.

productItemId

string

Item ID of the product.

productLanguage

string

Resource name of the language constant for the language of the product.

productMerchantId

string (int64 format)

Merchant ID of the product.

productStoreId

string

Store ID of the product.

productTitle

string

Title of the product.

productTypeL1

string

Type (level 1) of the product.

productTypeL2

string

Type (level 2) of the product.

productTypeL3

string

Type (level 3) of the product.

productTypeL4

string

Type (level 4) of the product.

productTypeL5

string

Type (level 5) of the product.

quarter

string

Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

webpage

string

Resource name of the ad group criterion that represents webpage criterion.

week

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

year

integer

Year, formatted as yyyy.

skAdNetworkConversionValue

string (int64 format)

iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign.

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_STORE iOS App Store or Play Store
PHONE_CALL Call Dialer
MAP_DIRECTIONS Map App
LOCATION_LISTING Location Dedicated Page
MESSAGE Text Message
LEAD_FORM Lead Generation Form
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS Ad Destination for Conversions with keys unknown

AdNetworkType

Enumerates Google Ads network types.

Enums
UNSPECIFIED Not specified.
UNKNOWN The value is unknown in this version.
SEARCH Google search.
SEARCH_PARTNERS googleAds.search partners.
CONTENT Display Network.
YOUTUBE_WATCH YouTube Videos
MIXED Cross-network.

BudgetCampaignAssociationStatus

A BudgetCampaignAssociationStatus segment.

JSON representation
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
Fields
status

enum (BudgetCampaignAssociationStatus)

Budget campaign association status.

campaign

string

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.
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.
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.
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.
PROMOTION_EXTENSION Promotion Extension.
HOTEL_PRICE Hotel price.
PRICE_EXTENSION Price Extension.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Book on Google hotel room selection.
SHOPPING_COMPARISON_LISTING Shopping - Comparison Listing.

ConversionAttributionEventType

The event type of conversions that are attributed to.

Enums
UNSPECIFIED Not specified.
UNKNOWN Represents value unknown in this version.
IMPRESSION The conversion is attributed to an impression.
INTERACTION The conversion is attributed to an interaction.

ConversionLagBucket

Enum representing the number of days between impression and conversion.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
LESS_THAN_ONE_DAY Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not.
ONE_TO_TWO_DAYS Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not.
TWO_TO_THREE_DAYS Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not.
THREE_TO_FOUR_DAYS Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not.
FOUR_TO_FIVE_DAYS Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not.
FIVE_TO_SIX_DAYS Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not.
SIX_TO_SEVEN_DAYS Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not.
SEVEN_TO_EIGHT_DAYS Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not.
EIGHT_TO_NINE_DAYS Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not.
NINE_TO_TEN_DAYS Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not.
TEN_TO_ELEVEN_DAYS Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not.
ELEVEN_TO_TWELVE_DAYS Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not.
TWELVE_TO_THIRTEEN_DAYS Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not.
THIRTEEN_TO_FOURTEEN_DAYS Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not.
FOURTEEN_TO_TWENTY_ONE_DAYS Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not.
TWENTY_ONE_TO_THIRTY_DAYS Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not.
THIRTY_TO_FORTY_FIVE_DAYS Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not.
FORTY_FIVE_TO_SIXTY_DAYS Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not.
SIXTY_TO_NINETY_DAYS Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not.

ConversionOrAdjustmentLagBucket

Enum representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
CONVERSION_LESS_THAN_ONE_DAY Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not.
CONVERSION_ONE_TO_TWO_DAYS Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not.
CONVERSION_TWO_TO_THREE_DAYS Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not.
CONVERSION_THREE_TO_FOUR_DAYS Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not.
CONVERSION_FOUR_TO_FIVE_DAYS Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not.
CONVERSION_FIVE_TO_SIX_DAYS Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not.
CONVERSION_SIX_TO_SEVEN_DAYS Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not.
CONVERSION_SEVEN_TO_EIGHT_DAYS Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not.
CONVERSION_EIGHT_TO_NINE_DAYS Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not.
CONVERSION_NINE_TO_TEN_DAYS Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not.
CONVERSION_TEN_TO_ELEVEN_DAYS Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not.
CONVERSION_ELEVEN_TO_TWELVE_DAYS Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not.
CONVERSION_SIXTY_TO_NINETY_DAYS Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not.
ADJUSTMENT_LESS_THAN_ONE_DAY Conversion adjustment lag bucket from 0 to 1 day. 0 day is included, 1 day is not.
ADJUSTMENT_ONE_TO_TWO_DAYS Conversion adjustment lag bucket from 1 to 2 days. 1 day is included, 2 days is not.
ADJUSTMENT_TWO_TO_THREE_DAYS Conversion adjustment lag bucket from 2 to 3 days. 2 days is included, 3 days is not.
ADJUSTMENT_THREE_TO_FOUR_DAYS Conversion adjustment lag bucket from 3 to 4 days. 3 days is included, 4 days is not.
ADJUSTMENT_FOUR_TO_FIVE_DAYS Conversion adjustment lag bucket from 4 to 5 days. 4 days is included, 5 days is not.
ADJUSTMENT_FIVE_TO_SIX_DAYS Conversion adjustment lag bucket from 5 to 6 days. 5 days is included, 6 days is not.
ADJUSTMENT_SIX_TO_SEVEN_DAYS Conversion adjustment lag bucket from 6 to 7 days. 6 days is included, 7 days is not.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS Conversion adjustment lag bucket from 7 to 8 days. 7 days is included, 8 days is not.
ADJUSTMENT_EIGHT_TO_NINE_DAYS Conversion adjustment lag bucket from 8 to 9 days. 8 days is included, 9 days is not.
ADJUSTMENT_NINE_TO_TEN_DAYS Conversion adjustment lag bucket from 9 to 10 days. 9 days is included, 10 days is not.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS Conversion adjustment lag bucket from 10 to 11 days. 10 days is included, 11 days is not.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS Conversion adjustment lag bucket from 11 to 12 days. 11 days is included, 12 days is not.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS Conversion adjustment lag bucket from 12 to 13 days. 12 days is included, 13 days is not.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS Conversion adjustment lag bucket from 13 to 14 days. 13 days is included, 14 days is not.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS Conversion adjustment lag bucket from 14 to 21 days. 14 days is included, 21 days is not.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS Conversion adjustment lag bucket from 21 to 30 days. 21 days is included, 30 days is not.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS Conversion adjustment lag bucket from 30 to 45 days. 30 days is included, 45 days is not.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS Conversion adjustment lag bucket from 45 to 60 days. 45 days is included, 60 days is not.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS Conversion adjustment lag bucket from 60 to 90 days. 60 days is included, 90 days is not.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS Conversion adjustment lag bucket from 90 to 145 days. 90 days is included, 145 days is not.
CONVERSION_UNKNOWN Conversion lag bucket UNKNOWN. This is for dates before conversion lag bucket was available in Google Ads.
ADJUSTMENT_UNKNOWN Conversion adjustment lag bucket UNKNOWN. This is for dates before conversion adjustment lag bucket was available in Google Ads.

ExternalConversionSource

The external conversion source that is associated with a ConversionAction.

Enums
UNSPECIFIED Not specified.
UNKNOWN Represents value unknown in this version.
WEBPAGE Conversion that occurs when a user navigates to a particular webpage after viewing an ad; Displayed in Google Ads UI as 'Website'.
ANALYTICS Conversion that comes from linked Google Analytics goal or transaction; Displayed in Google Ads UI as 'Analytics'.
UPLOAD Website conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from clicks'.
AD_CALL_METRICS Conversion that occurs when a user clicks on a call extension directly on an ad; Displayed in Google Ads UI as 'Calls from ads'.
WEBSITE_CALL_METRICS Conversion that occurs when a user calls a dynamically-generated phone number (by installed javascript) from an advertiser's website after clicking on an ad; Displayed in Google Ads UI as 'Calls from website'.
STORE_VISITS Conversion that occurs when a user visits an advertiser's retail store after clicking on a Google ad; Displayed in Google Ads UI as 'Store visits'.
ANDROID_IN_APP Conversion that occurs when a user takes an in-app action such as a purchase in an Android app; Displayed in Google Ads UI as 'Android in-app action'.
IOS_IN_APP Conversion that occurs when a user takes an in-app action such as a purchase in an iOS app; Displayed in Google Ads UI as 'iOS in-app action'.
IOS_FIRST_OPEN Conversion that occurs when a user opens an iOS app for the first time; Displayed in Google Ads UI as 'iOS app install (first open)'.
APP_UNSPECIFIED Legacy app conversions that do not have an AppPlatform provided; Displayed in Google Ads UI as 'Mobile app'.
ANDROID_FIRST_OPEN Conversion that occurs when a user opens an Android app for the first time; Displayed in Google Ads UI as 'Android app install (first open)'.
UPLOAD_CALLS Call conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from calls'.
FIREBASE Conversion that comes from a linked Firebase event; Displayed in Google Ads UI as 'Firebase'.
CLICK_TO_CALL Conversion that occurs when a user clicks on a mobile phone number; Displayed in Google Ads UI as 'Phone number clicks'.
SALESFORCE Conversion that comes from Salesforce; Displayed in Google Ads UI as 'Salesforce.com'.
STORE_SALES_CRM Conversion that comes from in-store purchases recorded by CRM; Displayed in Google Ads UI as 'Store sales (data partner)'.
STORE_SALES_PAYMENT_NETWORK Conversion that comes from in-store purchases from payment network; Displayed in Google Ads UI as 'Store sales (payment network)'.
GOOGLE_PLAY Codeless Google Play conversion; Displayed in Google Ads UI as 'Google Play'.
THIRD_PARTY_APP_ANALYTICS Conversion that comes from a linked third-party app analytics event; Displayed in Google Ads UI as 'Third-party app analytics'.
GOOGLE_ATTRIBUTION Conversion that is controlled by Google Attribution.
STORE_SALES_DIRECT_UPLOAD Store Sales conversion based on first-party or third-party merchant data uploads. Displayed in Google Ads UI as 'Store sales (direct upload)'.
STORE_SALES Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Displayed in Google Ads UI as 'Store sales'.
SEARCH_ADS_360 Conversions imported from googleAds.search Ads 360 Floodlight data.
GOOGLE_HOSTED Conversions that track local actions from Google's products and services after interacting with an ad.
FLOODLIGHT Conversions reported by Floodlight tags.
ANALYTICS_SEARCH_ADS_360 Conversions that come from Google Analytics specifically for googleAds.search Ads 360. Displayed in Google Ads UI as Analytics (SA360).
FIREBASE_SEARCH_ADS_360 Conversion that comes from a linked Firebase event for googleAds.search Ads 360.

HotelRateType

Enum describing possible hotel rate types.

Enums
UNSPECIFIED Not specified.
UNKNOWN The value is unknown in this version.
UNAVAILABLE Rate type information is unavailable.
PUBLIC_RATE Rates available to everyone.
QUALIFIED_RATE A membership program rate is available and satisfies basic requirements like having a public rate available. UI treatment will strikethrough the public rate and indicate that a discount is available to the user. For more on Qualified Rates, visit https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE Rates available to users that satisfy some eligibility criteria. e.g. all signed-in users, 20% of mobile users, all mobile users in Canada, etc.

HotelPriceBucket

Enum describing possible hotel price buckets.

Enums
UNSPECIFIED Not specified.
UNKNOWN The value is unknown in this version.
LOWEST_UNIQUE Uniquely lowest price. Partner has the lowest price, and no other partners are within a small variance of that price.
LOWEST_TIED Tied for lowest price. Partner is within a small variance of the lowest price.
NOT_LOWEST Not lowest price. Partner is not within a small variance of the lowest price.
ONLY_PARTNER_SHOWN Partner was the only one shown.

Keyword

A Keyword criterion segment.

JSON representation
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Fields
info

object (KeywordInfo)

Keyword info.

adGroupCriterion

string

The AdGroupCriterion resource name.

SearchEngineResultsPageType

The type of the search engine results page.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
ADS_ONLY Only ads were contained in the search engine results page.
ORGANIC_ONLY Only organic results were contained in the search engine results page.
ADS_AND_ORGANIC Both ads and organic results were contained in the search engine results page.

SearchTermMatchType

Possible match types for a keyword triggering an ad, including variants.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
BROAD Broad match.
EXACT Exact match.
PHRASE Phrase match.
NEAR_EXACT Exact match (close variant).
NEAR_PHRASE Phrase match (close variant).

Slot

Enumerates possible positions of the Ad.

Enums
UNSPECIFIED Not specified.
UNKNOWN The value is unknown in this version.
SEARCH_SIDE Google search: Side.
SEARCH_TOP Google search: Top.
SEARCH_OTHER Google search: Other.
CONTENT Google Display Network.
SEARCH_PARTNER_TOP googleAds.search partners: Top.
SEARCH_PARTNER_OTHER googleAds.search partners: Other.
MIXED Cross-network.