GoogleAdsRow

یک ردیف برگشتی از پرس و جو.

نمایندگی JSON
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "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)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "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)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "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)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
زمینه های
accountBudget

object ( AccountBudget )

بودجه حساب در پرس و جو.

accountBudgetProposal

object ( AccountBudgetProposal )

پیشنهاد بودجه حساب که در پرس و جو اشاره شده است.

adGroup

object ( AdGroup )

گروه تبلیغاتی مورد اشاره در پرس و جو.

adGroupAd

object ( AdGroupAd )

آگهی اشاره شده در پرس و جو.

adGroupAdAssetCombinationView

object ( AdGroupAdAssetCombinationView )

نمای ترکیبی دارایی آگهی گروه آگهی در جستار.

adGroupAdAssetView

object ( AdGroupAdAssetView )

نمای دارایی آگهی گروه آگهی در جستار.

adGroupAdLabel

object ( AdGroupAdLabel )

برچسب آگهی گروه تبلیغاتی که در پرس و جو ارجاع داده شده است.

adGroupAsset

object ( AdGroupAsset )

دارایی گروه تبلیغاتی که در پرس و جو به آن اشاره شده است.

adGroupAssetSet

object ( AdGroupAssetSet )

مجموعه دارایی گروه تبلیغاتی که در جستار به آن اشاره شده است.

adGroupAudienceView

object ( AdGroupAudienceView )

نمای مخاطب گروه تبلیغاتی که در پرس و جو به آن اشاره شده است.

adGroupBidModifier

object ( AdGroupBidModifier )

اصلاح کننده قیمت پیشنهادی که در پرس و جو به آن اشاره شده است.

adGroupCriterion

object ( AdGroupCriterion )

معیاری که در پرس و جو به آن اشاره شده است.

adGroupCriterionCustomizer

object ( AdGroupCriterionCustomizer )

سفارشی‌کننده معیار گروه آگهی که در جستار به آن اشاره شده است.

adGroupCriterionLabel

object ( AdGroupCriterionLabel )

برچسب معیار گروه آگهی که در پرس و جو ارجاع داده شده است.

adGroupCriterionSimulation

object ( AdGroupCriterionSimulation )

شبیه سازی معیار گروه آگهی که در پرس و جو ارجاع شده است.

adGroupCustomizer

object ( AdGroupCustomizer )

سفارشی‌ساز گروه تبلیغاتی که در جستار به آن اشاره شده است.

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 )

دارایی مورد اشاره در پرس و جو.

assetFieldTypeView

object ( AssetFieldTypeView )

نمای نوع فیلد دارایی که در پرس و جو ارجاع داده شده است.

assetGroupAsset

object ( AssetGroupAsset )

دارایی گروه دارایی که در پرس و جو به آن اشاره شده است.

assetGroupSignal

object ( AssetGroupSignal )

سیگنال گروه دارایی که در پرس و جو ارجاع داده شده است.

assetGroupListingGroupFilter

object ( AssetGroupListingGroupFilter )

فیلتر گروه فهرست گروه دارایی که در جستار به آن ارجاع داده شده است.

assetGroupProductGroupView

object ( AssetGroupProductGroupView )

نمای گروه محصول گروه دارایی که در پرس و جو اشاره شده است.

assetGroup

object ( AssetGroup )

گروه دارایی مورد اشاره در جستار.

assetSetAsset

object ( AssetSetAsset )

دارایی مجموعه دارایی که در پرس و جو به آن اشاره شده است.

assetSet

object ( AssetSet )

مجموعه دارایی مورد اشاره در پرس و جو.

assetSetTypeView

object ( AssetSetTypeView )

نمای نوع مجموعه دارایی که در پرس و جو ارجاع شده است.

batchJob

object ( BatchJob )

کار دسته ای که در پرس و جو به آن اشاره شده است.

biddingDataExclusion

object ( BiddingDataExclusion )

استثنای داده های مناقصه که در پرس و جو به آن اشاره شده است.

biddingSeasonalityAdjustment

object ( BiddingSeasonalityAdjustment )

تعدیل فصلی مناقصه اشاره شده در پرس و جو.

biddingStrategy

object ( BiddingStrategy )

استراتژی مناقصه اشاره شده در پرس و جو.

biddingStrategySimulation

object ( BiddingStrategySimulation )

شبیه سازی استراتژی مناقصه که در پرس و جو ارجاع شده است.

billingSetup

object ( BillingSetup )

راه‌اندازی صورت‌حساب به آن اشاره شده است.

callView

object ( CallView )

نمای تماس اشاره شده در پرس و جو.

campaignBudget

object ( CampaignBudget )

بودجه کمپین اشاره شده در پرس و جو.

campaign

object ( Campaign )

کمپین مورد اشاره در پرس و جو.

campaignAsset

object ( CampaignAsset )

دارایی کمپین اشاره شده در جستار.

campaignAssetSet

object ( CampaignAssetSet )

مجموعه دارایی کمپین که در پرس و جو ارجاع داده شده است.

campaignAudienceView

object ( CampaignAudienceView )

نمای مخاطب کمپین که در پرس و جو به آن اشاره شده است.

campaignBidModifier

object ( CampaignBidModifier )

اصلاح کننده پیشنهاد کمپین که در پرس و جو به آن اشاره شده است.

campaignConversionGoal

object ( CampaignConversionGoal )

CampaignConversionGoal در پرس و جو ارجاع داده شد.

campaignCriterion

object ( CampaignCriterion )

معیار کمپین مورد اشاره در پرس و جو.

campaignCustomizer

object ( CampaignCustomizer )

سفارشی‌ساز کمپین که در جستار به آن اشاره شده است.

campaignDraft

object ( CampaignDraft )

پیش‌نویس کمپین که در جستار به آن اشاره شده است.

campaignExtensionSetting

object ( CampaignExtensionSetting )

تنظیم برنامه افزودنی کمپین که در پرس و جو به آن اشاره شده است.

campaignFeed

object ( CampaignFeed )

فید کمپین اشاره شده در پرس و جو.

campaignGroup

object ( CampaignGroup )

گروه کمپین در پرس و جوی AWQL ارجاع داده شد.

campaignLabel

object ( CampaignLabel )

برچسب کمپین مورد اشاره در پرس و جو.

campaignSearchTermInsight

object ( CampaignSearchTermInsight )

عبارت جستجوی کمپین بینش اشاره شده در جستار.

campaignSharedSet

object ( CampaignSharedSet )

مجموعه اشتراک‌گذاری شده کمپین در جستار AWQL ارجاع شده است.

campaignSimulation

object ( CampaignSimulation )

شبیه سازی کمپین که در پرس و جو به آن اشاره شده است.

carrierConstant

object ( CarrierConstant )

ثابت حاملی که در پرس و جو ارجاع داده شده است.

changeEvent

object ( ChangeEvent )

ChangeEvent در پرس و جو ارجاع داده شد.

changeStatus

object ( ChangeStatus )

ChangeStatus اشاره شده در پرس و جو.

combinedAudience

object ( CombinedAudience )

CombinedAudience در پرس و جو ارجاع داده شد.

audience

object ( Audience )

مخاطبی که در پرس و جو به آن اشاره شده است.

conversionAction

object ( ConversionAction )

عمل تبدیلی که در پرس و جو به آن اشاره شده است.

conversionCustomVariable

object ( ConversionCustomVariable )

متغیر سفارشی تبدیل که در پرس و جو ارجاع داده شده است.

conversionGoalCampaignConfig

object ( ConversionGoalCampaignConfig )

ConversionGoalCampaignConfig در پرس و جو ارجاع داده شده است.

conversionValueRule

object ( ConversionValueRule )

قانون ارزش تبدیلی که در پرس و جو ارجاع داده شده است.

conversionValueRuleSet

object ( ConversionValueRuleSet )

مجموعه قانون ارزش تبدیلی که در پرس و جو ارجاع شده است.

clickView

object ( ClickView )

ClickView در پرس و جو ارجاع داده شد.

currencyConstant

object ( CurrencyConstant )

ثابت واحد پولی که در پرس و جو به آن اشاره شده است.

customAudience

object ( CustomAudience )

مخاطب سفارشی که در پرس و جو به آن اشاره شده است.

customConversionGoal

object ( CustomConversionGoal )

CustomConversionGoal اشاره شده در پرس و جو.

customInterest

object ( CustomInterest )

CustomInterest اشاره شده در پرس و جو.

customer

object ( Customer )

مشتری در پرس و جو به آن اشاره کرد.

customerAsset

object ( CustomerAsset )

دارایی مشتری اشاره شده در پرس و جو.

customerAssetSet

object ( CustomerAssetSet )

مجموعه دارایی مشتری که در پرس و جو به آن اشاره شده است.

accessibleBiddingStrategy

object ( AccessibleBiddingStrategy )

استراتژی مناقصه قابل دسترس که در پرس و جو به آن اشاره شده است.

customerCustomizer

object ( CustomerCustomizer )

سفارشی‌ساز مشتری در پرس و جو به آن اشاره شده است.

customerClient

object ( CustomerClient )

مشتری مشتری در پرس و جو به آن اشاره کرد.

customerConversionGoal

object ( CustomerConversionGoal )

CustomerConversionGoal اشاره شده در پرس و جو.

customerExtensionSetting

object ( CustomerExtensionSetting )

تنظیم برنامه افزودنی مشتری که در پرس و جو به آن اشاره شده است.

customerFeed

object ( CustomerFeed )

فید مشتری که در پرس و جو به آن اشاره شده است.

customerLabel

object ( CustomerLabel )

برچسب مشتری اشاره شده در پرس و جو.

customerNegativeCriterion

object ( CustomerNegativeCriterion )

معیار منفی مشتری که در پرس و جو به آن اشاره شده است.

customerSearchTermInsight

object ( CustomerSearchTermInsight )

عبارت جستجوی مشتری بینش اشاره شده در پرس و جو.

customerUserAccess

object ( CustomerUserAccess )

CustomerUserAccess اشاره شده در پرس و جو.

customerUserAccessInvitation

object ( CustomerUserAccessInvitation )

CustomerUserAccessInvitation اشاره شده در پرس و جو.

customizerAttribute

object ( CustomizerAttribute )

ویژگی customizer که در پرس و جو ارجاع داده شده است.

detailPlacementView

object ( DetailPlacementView )

نمای قرار دادن جزئیات که در پرس و جو ارجاع شده است.

detailedDemographic

object ( DetailedDemographic )

اطلاعات دموگرافیک دقیق به پرس و جو اشاره شده است.

displayKeywordView

object ( DisplayKeywordView )

نمای کلمه کلیدی نمایش داده شده در پرس و جو.

distanceView

object ( DistanceView )

نمای فاصله اشاره شده در پرس و جو.

dynamicSearchAdsSearchTermView

object ( DynamicSearchAdsSearchTermView )

مشاهده عبارت جستجوی تبلیغات جستجوی پویا که در پرس و جو ارجاع شده است.

expandedLandingPageView

object ( ExpandedLandingPageView )

نمای صفحه فرود گسترش یافته که در پرس و جو ارجاع داده شده است.

extensionFeedItem

object ( ExtensionFeedItem )

مورد فید افزونه که در جستار ارجاع داده شده است.

feed

object ( Feed )

فید اشاره شده در پرس و جو.

feedItem

object ( FeedItem )

مورد فید اشاره شده در جستار.

feedItemSet

object ( FeedItemSet )

مجموعه مورد فید که در جستار به آن ارجاع داده شده است.

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 )

نمای عملکرد هتل اشاره شده در پرس و جو.

hotelReconciliation

object ( HotelReconciliation )

آشتی هتل که در جستار اشاره شده است.

incomeRangeView

object ( IncomeRangeView )

نمای محدوده درآمدی که در پرس و جو به آن اشاره شده است.

keywordView

object ( KeywordView )

نمای کلمه کلیدی مورد اشاره در پرس و جو.

keywordPlan

object ( KeywordPlan )

طرح کلمه کلیدی مورد اشاره در پرس و جو.

keywordPlanCampaign

object ( KeywordPlanCampaign )

کمپین طرح کلمه کلیدی مورد اشاره در پرس و جو.

keywordPlanCampaignKeyword

object ( KeywordPlanCampaignKeyword )

کلمه کلیدی کمپین طرح کلمه کلیدی که در پرس و جو ارجاع داده شده است.

keywordPlanAdGroup

object ( KeywordPlanAdGroup )

گروه تبلیغاتی طرح کلمه کلیدی که در پرس و جو ارجاع داده شده است.

keywordPlanAdGroupKeyword

object ( KeywordPlanAdGroupKeyword )

گروه تبلیغاتی طرح کلمه کلیدی که در پرس و جو ارجاع داده شده است.

keywordThemeConstant

object ( KeywordThemeConstant )

موضوع اصلی کلمه کلیدی که در پرس و جو ارجاع داده شده است.

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 )

نمای عبارت جستجوی ارگانیک پولی که در عبارت جستجو ارجاع شده است.

qualifyingQuestion

object ( QualifyingQuestion )

سوال واجد شرایطی که در پرس و جو به آن اشاره شده است.

parentalStatusView

object ( ParentalStatusView )

نمای وضعیت والدین که در پرس و جو ارجاع داده شده است.

perStoreView

object ( PerStoreView )

نمای هر فروشگاهی که در پرس و جو به آن اشاره شده است.

productBiddingCategoryConstant

object ( ProductBiddingCategoryConstant )

دسته مناقصه محصول اشاره شده در پرس و جو.

productGroupView

object ( ProductGroupView )

نمای گروه محصول اشاره شده در پرس و جو.

recommendation

object ( Recommendation )

توصیه ای که در پرس و جو به آن اشاره شده است.

searchTermView

object ( SearchTermView )

نمای عبارت جستجو شده در پرس و جو ارجاع داده شده است.

sharedCriterion

object ( SharedCriterion )

مجموعه مشترکی که در پرس و جو ارجاع داده شده است.

sharedSet

object ( SharedSet )

مجموعه مشترکی که در پرس و جو ارجاع داده شده است.

smartCampaignSetting

object ( SmartCampaignSetting )

تنظیم کمپین هوشمند که در پرس و جو به آن اشاره شده است.

shoppingPerformanceView

object ( ShoppingPerformanceView )

نمای عملکرد خرید اشاره شده در پرس و جو.

smartCampaignSearchTermView

object ( SmartCampaignSearchTermView )

نمای عبارت جستجوی کمپین هوشمند اشاره شده در پرس و جو.

topicView

object ( TopicView )

نمای موضوعی که در پرس و جو به آن اشاره شده است.

travelActivityGroupView

object ( TravelActivityGroupView )

نمای گروه فعالیت سفر که در پرس و جو به آن اشاره شده است.

travelActivityPerformanceView

object ( TravelActivityPerformanceView )

نمای عملکرد فعالیت سفر که در پرس و جو ارجاع شده است.

experiment

object ( Experiment )

آزمایشی که در پرس و جو به آن اشاره شد.

experimentArm

object ( ExperimentArm )

بازوی آزمایشی که در پرس و جو ارجاع داده شده است.

userInterest

object ( UserInterest )

علاقه کاربر به درخواست اشاره شده است.

lifeEvent

object ( LifeEvent )

رویداد زندگی که در پرس و جو به آن اشاره شده است.

userList

object ( UserList )

لیست کاربری که در پرس و جو به آن اشاره شده است.

userLocationView

object ( UserLocationView )

نمای موقعیت مکانی کاربر که در پرس و جو به آن اشاره شده است.

remarketingAction

object ( RemarketingAction )

اقدام بازاریابی مجدد که در جستار به آن اشاره شده است.

topicConstant

object ( TopicConstant )

ثابت موضوعی که در پرس و جو به آن اشاره شده است.

video

object ( Video )

ویدیوی مورد اشاره در پرس و جو.

webpageView

object ( WebpageView )

نمای صفحه وب مورد اشاره در پرس و جو.

leadFormSubmissionData

object ( LeadFormSubmissionData )

ارسال کاربر فرم سرنخ که در پرس و جو ارجاع داده شده است.

metrics

object ( Metrics )

معیارها

segments

object ( Segments )

بخش ها

بودجه حساب

بودجه در سطح حساب این شامل اطلاعات مربوط به خود بودجه و همچنین آخرین تغییرات تصویب شده در بودجه و تغییرات پیشنهادی است که در انتظار تصویب هستند. تغییرات پیشنهادی که در انتظار تأیید هستند، در صورت وجود، در «پیشنهاد در انتظار» یافت می‌شوند. جزئیات مؤثر در مورد بودجه در فیلدهای با پیشوند «تأیید شده_»، «تعدیل_» و موارد بدون پیشوند یافت می شود. از آنجایی که ممکن است برخی از جزئیات مؤثر با آنچه کاربر در ابتدا درخواست کرده بود متفاوت باشد (مثلاً محدودیت هزینه)، این تفاوت‌ها از طریق فیلدهای «پیشنهاد_»، «تأیید شده_» و احتمالاً «تعدیل_» کنار هم قرار می‌گیرند.

این منبع با استفاده از AccountBudgetProposal جهش یافته است و نمی توان آن را مستقیماً تغییر داد. یک بودجه ممکن است در هر زمان معین حداکثر یک پیشنهاد معلق داشته باشد. از طریق Proposal در انتظار خوانده می شود.

پس از تصویب، ممکن است بودجه مورد تعدیل قرار گیرد، مانند تعدیل اعتبار. تنظیمات تفاوت هایی بین فیلدهای «تأیید شده» و «تعدیل شده» ایجاد می کند که در غیر این صورت یکسان خواهند بود.

نمایندگی JSON
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

  // Union field proposed_end_time can be only one of the following:
  "proposedEndDateTime": string,
  "proposedEndTimeType": enum (TimeType)
  // End of list of possible types for union field proposed_end_time.

  // Union field approved_end_time can be only one of the following:
  "approvedEndDateTime": string,
  "approvedEndTimeType": enum (TimeType)
  // End of list of possible types for union field approved_end_time.

  // Union field proposed_spending_limit can be only one of the following:
  "proposedSpendingLimitMicros": string,
  "proposedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field proposed_spending_limit.

  // Union field approved_spending_limit can be only one of the following:
  "approvedSpendingLimitMicros": string,
  "approvedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field approved_spending_limit.

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
زمینه های
resourceName

string

فقط خروجی نام منبع بودجه در سطح حساب. نام منابع AccountBudget به شکل زیر است:

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum ( AccountBudgetStatus )

فقط خروجی وضعیت این بودجه در سطح حساب.

totalAdjustmentsMicros

string ( int64 format)

فقط خروجی مقدار کل تعدیل ها

نمونه ای از تعدیل اعتبارات حسن نیت است.

amountServedMicros

string ( int64 format)

فقط خروجی ارزش تبلیغاتی که ارائه شده است، در میکرو.

این شامل هزینه های تحویل بیش از حد می شود، در این صورت ممکن است اعتباری به طور خودکار به بودجه اعمال شود (به totalAdjustmentsMicros مراجعه کنید).

pendingProposal

object ( PendingAccountBudgetProposal )

فقط خروجی پیشنهاد معلق برای اصلاح این بودجه، در صورت وجود.

id

string ( int64 format)

فقط خروجی شناسه بودجه در سطح حساب.

billingSetup

string

فقط خروجی نام منبع تنظیم صورت‌حساب مرتبط با این بودجه در سطح حساب. نام منابع BillingSetup به شکل زیر است:

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

فقط خروجی نام بودجه در سطح حساب.

proposedStartDateTime

string

فقط خروجی زمان پیشنهادی شروع بودجه در سطح حساب در قالب yyyy-MM-dd HH:mm:ss. اگر نوع زمان شروع NOW پیشنهاد شده بود، این زمان درخواست است.

approvedStartDateTime

string

فقط خروجی زمان شروع تایید شده بودجه در سطح حساب در قالب yyyy-MM-dd HH:mm:ss.

به عنوان مثال، اگر بودجه جدیدی پس از زمان شروع پیشنهادی تصویب شود، زمان شروع مصوب، زمان تصویب است.

purchaseOrderNumber

string

فقط خروجی شماره سفارش خرید مقداری است که به کاربران کمک می کند این بودجه را در فاکتورهای ماهانه خود ارجاع دهند.

notes

string

فقط خروجی یادداشت های مرتبط با بودجه

فیلد اتحادیه proposed_end_time . زمان پیشنهادی پایان بودجه در سطح حساب. proposed_end_time فقط می تواند یکی از موارد زیر باشد:
proposedEndDateTime

string

فقط خروجی زمان پایان پیشنهادی در قالب yyyy-MM-dd HH:mm:ss.

proposedEndTimeType

enum ( TimeType )

فقط خروجی زمان پایان پیشنهادی به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، FOREVER.

فیلد اتحادیه approved_end_time . زمان پایان تایید شده بودجه در سطح حساب.

به عنوان مثال، اگر زمان پایان بودجه به روز شود و پیشنهاد پس از پایان زمان پیشنهادی تصویب شود، زمان پایان تایید شده زمان تصویب است. approved_end_time می تواند تنها یکی از موارد زیر باشد:

approvedEndDateTime

string

فقط خروجی زمان پایان تایید شده در قالب yyyy-MM-dd HH:mm:ss.

approvedEndTimeType

enum ( TimeType )

فقط خروجی زمان پایان تایید شده به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، FOREVER.

فیلد اتحادیه proposed_spending_limit . محدودیت هزینه پیشنهادی proposed_spending_limit تنها می تواند یکی از موارد زیر باشد:
proposedSpendingLimitMicros

string ( int64 format)

فقط خروجی محدودیت هزینه پیشنهادی در میکرو. یک میلیون معادل یک واحد است.

proposedSpendingLimitType

enum ( SpendingLimitType )

فقط خروجی محدودیت هزینه پیشنهادی به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE.

فیلد اتحادیه approved_spending_limit . سقف هزینه مصوب

به عنوان مثال، اگر مبلغی که قبلاً توسط حساب خرج شده است از سقف هزینه پیشنهادی در زمان تأیید پیشنهاد بیشتر شود، سقف هزینه تأیید شده به مبلغی که قبلاً خرج شده است تنظیم می شود. approved_spending_limit تنها می تواند یکی از موارد زیر باشد:

approvedSpendingLimitMicros

string ( int64 format)

فقط خروجی حد مجاز هزینه در میکرو. یک میلیون معادل یک واحد است. این فقط در صورتی پر می شود که حد هزینه پیشنهادی محدود باشد و همیشه بزرگتر یا برابر با حد هزینه پیشنهادی خواهد بود.

approvedSpendingLimitType

enum ( SpendingLimitType )

فقط خروجی محدودیت هزینه تایید شده به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE. این فقط در صورتی پر می شود که محدودیت هزینه تایید شده بی نهایت باشد.

فیلد اتحادیه adjusted_spending_limit . محدودیت هزینه پس از اعمال تعدیل. تنظیمات در total_adjustments_micros ذخیره می شوند.

این مقدار حرف آخر را در مورد میزان مجاز خرج کردن حساب می‌زند. adjusted_spending_limit تنها می تواند یکی از موارد زیر باشد:

adjustedSpendingLimitMicros

string ( int64 format)

فقط خروجی محدودیت هزینه تعدیل شده در میکرو. یک میلیون معادل یک واحد است.

اگر محدودیت مخارج تایید شده محدود باشد، محدودیت هزینه تعدیل شده ممکن است بسته به نوع تعدیلات اعمال شده در این بودجه، در صورت وجود، متفاوت باشد.

انواع مختلف تنظیمات در اینجا توضیح داده شده است: https://support.google.com/google-ads/answer/1704323

به عنوان مثال، تعدیل بدهی میزان مجاز مصرف حساب را کاهش می دهد.

adjustedSpendingLimitType

enum ( SpendingLimitType )

فقط خروجی محدودیت هزینه تنظیم شده به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE. این فقط در صورتی تکمیل می‌شود که محدودیت هزینه تنظیم‌شده INFINITE باشد، که اگر محدودیت مخارج تأیید شده INFINITE باشد، تضمین می‌شود که درست باشد.

AccountBudgetStatus

وضعیت های احتمالی یک بودجه حساب.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
PENDING بودجه حساب در انتظار تایید است.
APPROVED بودجه حساب تصویب شد.
CANCELLED بودجه حساب توسط کاربر لغو شده است.

در حال انتظار حساب بودجه

یک پیشنهاد معلق مرتبط با بودجه در سطح حساب، در صورت وجود.

نمایندگی JSON
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
زمینه های
proposalType

enum ( AccountBudgetProposalType )

فقط خروجی نوع این پیشنهاد، به عنوان مثال، END برای پایان دادن به بودجه مرتبط با این پیشنهاد.

accountBudgetProposal

string

فقط خروجی نام منبع پیشنهاد. نام منابع AccountBudgetProposal به شکل زیر است:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

فقط خروجی نامی که باید به بودجه سطح حساب اختصاص دهید.

startDateTime

string

فقط خروجی زمان شروع در قالب yyyy-MM-dd HH:mm:ss.

purchaseOrderNumber

string

فقط خروجی شماره سفارش خرید مقداری است که به کاربران کمک می کند این بودجه را در فاکتورهای ماهانه خود ارجاع دهند.

notes

string

فقط خروجی یادداشت های مرتبط با این بودجه.

creationDateTime

string

فقط خروجی زمانی که این پیشنهاد بودجه در سطح حساب ایجاد شد. قالب‌بندی شده به‌عنوان yyyy-MM-dd HH:mm:ss.

end_time فیلد اتحادیه زمان پایان بودجه در سطح حساب. end_time می تواند تنها یکی از موارد زیر باشد:
endDateTime

string

فقط خروجی زمان پایان در قالب yyyy-MM-dd HH:mm:ss.

endTimeType

enum ( TimeType )

فقط خروجی زمان پایان به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، FOREVER.

اتحادیه spending_limit . محدودیت هزینه. spending_limit تنها می تواند یکی از موارد زیر باشد:
spendingLimitMicros

string ( int64 format)

فقط خروجی محدودیت هزینه در میکرو یک میلیون معادل یک واحد است.

spendingLimitType

enum ( SpendingLimitType )

فقط خروجی محدودیت هزینه به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE.

AdGroupAdAssetCombinationView

دیدگاهی در مورد استفاده از ترکیب دارایی تبلیغات گروه تبلیغات. اکنون ما فقط از AdGroupAdAssetCombinationView برای تبلیغات جستجوی واکنشگرا پشتیبانی می کنیم و انواع تبلیغات بیشتری برای آینده برنامه ریزی شده است.

نمایندگی JSON
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای ترکیبی دارایی آگهی گروه آگهی. شناسه ترکیبی 128 بیت است که 64 بیت بالا در asset_combination_id_high و 64 بیت پایین در asset_combination_id_low ذخیره می‌شوند. نام منابع نمای ترکیبی دارایی AdGroupAd به این شکل است: customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}

servedAssets[]

object ( AssetUsage )

فقط خروجی دارایی های خدمت شده

enabled

boolean

فقط خروجی وضعیت بین ترکیب دارایی و آخرین نسخه آگهی. اگر درست باشد، ترکیب دارایی به آخرین نسخه آگهی پیوند داده می شود. اگر نادرست باشد، به این معنی است که پیوند زمانی وجود داشته است اما حذف شده است و دیگر در آخرین نسخه آگهی وجود ندارد.

AssetUsage

حاوی اطلاعات استفاده از دارایی است.

نمایندگی JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
زمینه های
asset

string

نام منبع دارایی

servedAssetFieldType

enum ( ServedAssetFieldType )

نوع فیلد ارائه شده دارایی.

AdGroupAdAssetView

پیوندی بین AdGroupAd و دارایی. در حال حاضر ما فقط از AdGroupAdAssetView برای AppAds و تبلیغات جستجوی پاسخگو پشتیبانی می کنیم.

نمایندگی JSON
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای دارایی آگهی گروه آگهی. نام‌های منابع مشاهده دارایی آگهی گروه تبلیغات به شکل (قبل از V4) است:

customers/{customerId}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

نام‌های منابع نمای دارایی آگهی گروه آگهی به شکل (از V4 شروع می‌شود):

customers/{customerId}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

fieldType

enum ( AssetFieldType )

فقط خروجی نقشی که دارایی در آگهی ایفا می کند.

policySummary

object ( AdGroupAdAssetPolicySummary )

فقط خروجی اطلاعات خط‌مشی برای دارایی آگهی گروه آگهی.

performanceLabel

enum ( AssetPerformanceLabel )

فقط خروجی عملکرد یک پیوند دارایی.

pinnedField

enum ( ServedAssetFieldType )

فقط خروجی فیلد پین شده

adGroupAd

string

فقط خروجی آگهی گروه تبلیغاتی که دارایی به آن مرتبط است.

asset

string

فقط خروجی دارایی که به آگهی گروه تبلیغاتی مرتبط است.

enabled

boolean

فقط خروجی وضعیت بین دارایی و آخرین نسخه آگهی. اگر درست باشد، دارایی به آخرین نسخه آگهی پیوند داده می شود. اگر نادرست باشد، به این معنی است که پیوند زمانی وجود داشته است اما حذف شده است و دیگر در آخرین نسخه آگهی وجود ندارد.

AdGroupAdAssetPolicySummary

حاوی اطلاعات خط‌مشی برای دارایی تبلیغات گروه تبلیغاتی است.

نمایندگی JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
زمینه های
policyTopicEntries[]

object ( PolicyTopicEntry )

فقط خروجی فهرست یافته‌های خط‌مشی برای دارایی آگهی گروه آگهی.

reviewStatus

enum ( PolicyReviewStatus )

فقط خروجی این دارایی آگهی گروه تبلیغاتی در کجای فرآیند بررسی قرار دارد.

approvalStatus

enum ( PolicyApprovalStatus )

فقط خروجی وضعیت تأیید کلی این دارایی آگهی گروه آگهی، بر اساس وضعیت ورودی‌های موضوع خط‌مشی فردی آن محاسبه می‌شود.

AdGroupAudienceView

نمای مخاطب گروه تبلیغاتی شامل داده‌های عملکرد از علایق و فهرست‌های بازاریابی مجدد برای تبلیغات شبکه نمایش و شبکه YouTube، و فهرست‌های بازاریابی مجدد برای تبلیغات جستجو (RLSA)، جمع‌آوری‌شده در سطح مخاطب است.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای مخاطب گروه تبلیغات. نام منابع مشاهده مخاطبان گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupCriterionSimulation

شبیه سازی معیار گروه تبلیغاتی ترکیبات پشتیبانی شده از نوع کانال تبلیغاتی، نوع معیار، نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است. عملیات شبیه سازی هتل AdGroupCriterion در V5 شروع می شود.

  1. DISPLAY - KEYWORD - CPC_BID - UNIFORM
  2. SEARCH - KEYWORD - CPC_BID - UNIFORM
  3. خرید - LISTING_GROUP - CPC_BID - UNIFORM
  4. هتل - LISTING_GROUP - CPC_BID - یونیفرم
  5. هتل - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
نمایندگی JSON
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
زمینه های
resourceName

string

فقط خروجی نام منبع شبیه سازی معیار گروه آگهی. نام منابع شبیه سازی معیار گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroupCriterionSimulations/{adGroupId}~{criterionId}~{type}~{modificationMethod}~{startDate}~{endDate}

type

enum ( SimulationType )

فقط خروجی فیلدی که شبیه سازی آن را اصلاح می کند.

modificationMethod

enum ( SimulationModificationMethod )

فقط خروجی چگونه شبیه سازی زمینه را تغییر می دهد.

adGroupId

string ( int64 format)

فقط خروجی شناسه AdGroup شبیه سازی.

criterionId

string ( int64 format)

فقط خروجی شناسه معیار شبیه سازی

startDate

string

فقط خروجی اولین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD.

endDate

string

فقط خروجی آخرین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD.

فیلد اتحادیه point_list . لیست نقاط شبیه سازی point_list فقط می تواند یکی از موارد زیر باشد:
cpcBidPointList

object ( CpcBidSimulationPointList )

فقط خروجی اگر نوع شبیه سازی CPC_BID باشد، نقاط شبیه سازی.

percentCpcBidPointList

object ( PercentCpcBidSimulationPointList )

فقط خروجی اگر نوع شبیه سازی PERCENT_CPC_BID باشد، نقاط شبیه سازی.

نوع شبیه سازی

Enum توصیف کننده فیلد یک شبیه سازی اصلاح شده است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
CPC_BID شبیه سازی برای پیشنهاد CPC است.
CPV_BID شبیه سازی برای پیشنهاد CPV است.
TARGET_CPA شبیه سازی برای یک هدف CPA است.
BID_MODIFIER شبیه سازی برای یک اصلاح کننده قیمت پیشنهادی است.
TARGET_ROAS شبیه سازی برای یک هدف ROAS است.
PERCENT_CPC_BID شبیه سازی برای پیشنهاد درصد CPC است.
TARGET_IMPRESSION_SHARE شبیه سازی برای یک هدف سهم نمایش است.
BUDGET شبیه سازی برای بودجه است.

SimulationModification Method

Enum روشی را که توسط آن شبیه سازی یک فیلد را تغییر می دهد، توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
UNIFORM مقادیر موجود در یک شبیه سازی برای همه فرزندان یک منبع داده شده به طور یکنواخت اعمال شد. نادیده گرفتن منابع کودک رعایت نشد.
DEFAULT مقادیر در یک شبیه سازی برای منبع داده شده اعمال شد. نادیده گرفتن منابع کودک رعایت شد و برآوردهای ترافیکی این منابع را شامل نمی شود.
SCALING مقادیر در یک شبیه سازی همه با یک عامل مقیاس بندی شدند. به عنوان مثال، در یک کمپین TargetCpa شبیه سازی شده، هدف کمپین و تمام اهداف گروه تبلیغاتی با ضریب X مقیاس بندی شدند.

CpcBidSimulationPointList

ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع CPC_BID.

نمایندگی JSON
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( CpcBidSimulationPoint )

معیارهای پیش‌بینی‌شده برای مجموعه‌ای از مبالغ پیشنهادی CPC.

CpcBidSimulationPoint

معیارهای پیش بینی شده برای مبلغ پیشنهادی CPC خاص.

نمایندگی JSON
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
زمینه های
requiredBudgetAmountMicros

string ( int64 format)

بودجه روزانه مورد نیاز پیش‌بینی‌شده که تبلیغ‌کننده باید برای دریافت ترافیک تخمینی، بر حسب میکرو ارز تبلیغ‌کننده تنظیم کند.

biddableConversions

number

تعداد پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

biddableConversionsValue

number

ارزش کل پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

clicks

string ( int64 format)

تعداد کلیک های پیش بینی شده

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو

impressions

string ( int64 format)

تعداد نمایش پیش بینی شده

topSlotImpressions

string ( int64 format)

تعداد پیش‌بینی‌شده نمایش‌های اسلات برتر. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند.

فیلد اتحادیه cpc_simulation_key_value . وقتی SimulationModificationMethod = UNIFORM یا DEFAULT، cpc_bid_micros تنظیم می شود. وقتی SimulationModificationMethod = SCALING، cpc_bid_scaling_modifier تنظیم می شود. cpc_simulation_key_value تنها می تواند یکی از موارد زیر باشد:
cpcBidMicros

string ( int64 format)

پیشنهاد CPC شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است.

cpcBidScalingModifier

number

اصلاح کننده مقیاس شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. همه پیشنهادات CPC مربوط به موجودیت شبیه سازی شده توسط این اصلاح کننده مقیاس بندی می شوند.

PercentCpcBidSimulationPointList

محفظه ای برای نقاط شبیه سازی برای شبیه سازی از نوع PERCENT_CPC_BID.

نمایندگی JSON
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( PercentCpcBidSimulationPoint )

معیارهای پیش‌بینی‌شده برای یک سری از مقادیر پیشنهادی CPC درصد.

PercentCpcBidSimulationPoint

معیارهای پیش بینی شده برای مقدار CPC درصدی خاص. فقط نوع کانال تبلیغاتی هتل از این فیلد پشتیبانی می کند.

نمایندگی JSON
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
زمینه های
percentCpcBidMicros

string ( int64 format)

درصد CPC شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. درصد CPC به عنوان کسری از قیمت تبلیغ شده برای برخی کالاها یا خدمات بیان می شود. مقدار ذخیره شده در اینجا 1,000,000 * [کسری] است.

biddableConversions

number

تعداد پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

biddableConversionsValue

number

ارزش کل پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد به ارز محلی.

clicks

string ( int64 format)

تعداد کلیک های پیش بینی شده

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو

impressions

string ( int64 format)

تعداد نمایش پیش بینی شده

topSlotImpressions

string ( int64 format)

تعداد پیش‌بینی‌شده نمایش‌های اسلات برتر.

AdGroupSimulation

شبیه سازی گروه تبلیغاتی ترکیبات پشتیبانی شده از نوع کانال تبلیغاتی، نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است.

  1. SEARCH - CPC_BID - DEFAULT
  2. SEARCH - CPC_BID - UNIFORM
  3. SEARCH - TARGET_CPA - UNIFORM
  4. SEARCH - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_BID - DEFAULT
  6. DISPLAY - CPC_BID - UNIFORM
  7. DISPLAY - TARGET_CPA - UNIFORM
نمایندگی JSON
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
زمینه های
resourceName

string

فقط خروجی نام منبع شبیه سازی گروه تبلیغاتی. نام منابع شبیه سازی گروه تبلیغاتی به شکل زیر است:

customers/{customerId}/adGroupSimulations/{adGroupId}~{type}~{modificationMethod}~{startDate}~{endDate}

type

enum ( SimulationType )

فقط خروجی فیلدی که شبیه سازی آن را اصلاح می کند.

modificationMethod

enum ( SimulationModificationMethod )

فقط خروجی چگونه شبیه سازی زمینه را تغییر می دهد.

adGroupId

string ( int64 format)

فقط خروجی شناسه گروه آگهی شبیه سازی.

startDate

string

فقط خروجی اولین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD.

endDate

string

فقط خروجی آخرین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD

فیلد اتحادیه point_list . لیست نقاط شبیه سازی point_list فقط می تواند یکی از موارد زیر باشد:
cpcBidPointList

object ( CpcBidSimulationPointList )

فقط خروجی اگر نوع شبیه سازی CPC_BID باشد، نقاط شبیه سازی.

cpvBidPointList

object ( CpvBidSimulationPointList )

فقط خروجی اگر نوع شبیه سازی CPV_BID باشد، نقاط شبیه سازی.

targetCpaPointList

object ( TargetCpaSimulationPointList )

فقط خروجی اگر نوع شبیه سازی TARGET_CPA باشد، نقاط شبیه سازی.

targetRoasPointList

object ( TargetRoasSimulationPointList )

فقط خروجی اگر نوع شبیه سازی TARGET_ROAS باشد، نقاط شبیه سازی.

CpvBidSimulationPointList

ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع CPV_BID.

نمایندگی JSON
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( CpvBidSimulationPoint )

معیارهای پیش‌بینی‌شده برای یک سری مبالغ پیشنهادی CPV.

CpvBidSimulationPoint

معیارهای پیش بینی شده برای مبلغ پیشنهادی CPV خاص.

نمایندگی JSON
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
زمینه های
cpvBidMicros

string ( int64 format)

پیشنهاد CPV شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است.

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو

impressions

string ( int64 format)

تعداد نمایش پیش بینی شده

views

string ( int64 format)

تعداد بازدید پیش بینی شده

TargetCpaSimulationPointList

ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع TARGET_CPA.

نمایندگی JSON
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( TargetCpaSimulationPoint )

معیارهای پیش بینی شده برای یک سری مقادیر CPA هدف.

TargetCpaSimulationPoint

معیارهای پیش بینی شده برای یک مقدار CPA هدف خاص.

نمایندگی JSON
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
زمینه های
requiredBudgetAmountMicros

string ( int64 format)

بودجه روزانه مورد نیاز پیش‌بینی‌شده که تبلیغ‌کننده باید برای دریافت ترافیک تخمینی، بر حسب میکرو ارز تبلیغ‌کننده تنظیم کند.

appInstalls

number

تعداد نصب برنامه پیش بینی شده

inAppActions

number

تعداد پیش‌بینی‌شده اقدامات درون‌برنامه.

biddableConversions

number

تعداد پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

biddableConversionsValue

number

ارزش کل پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

clicks

string ( int64 format)

تعداد کلیک های پیش بینی شده

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو

impressions

string ( int64 format)

تعداد نمایش پیش بینی شده

topSlotImpressions

string ( int64 format)

تعداد پیش‌بینی‌شده نمایش‌های اسلات برتر. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند.

فیلد اتحادیه target_cpa_simulation_key_value . وقتی SimulationModificationMethod = UNIFORM یا DEFAULT، target_cpa_micros تنظیم می شود. وقتی SimulationModificationMethod = SCALING، target_cpa_scaling_modifier تنظیم می شود. target_cpa_simulation_key_value تنها می تواند یکی از موارد زیر باشد:
targetCpaMicros

string ( int64 format)

CPA هدف شبیه‌سازی شده که معیارهای پیش‌بینی‌شده بر اساس آن است.

targetCpaScalingModifier

number

اصلاح کننده مقیاس شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. تمام اهداف CPA مربوط به موجودیت شبیه سازی شده توسط این اصلاح کننده مقیاس بندی می شوند.

TargetRoasSimulationPointList

ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع TARGET_ROAS.

نمایندگی JSON
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( TargetRoasSimulationPoint )

معیارهای پیش بینی شده برای یک سری مقادیر ROAS هدف.

TargetRoasSimulationPoint

معیارهای پیش بینی شده برای مقدار ROAS هدف خاص.

نمایندگی JSON
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
زمینه های
requiredBudgetAmountMicros

string ( int64 format)

بودجه روزانه مورد نیاز پیش‌بینی‌شده که تبلیغ‌کننده باید برای دریافت ترافیک تخمینی، بر حسب میکرو ارز تبلیغ‌کننده تنظیم کند.

targetRoas

number

ROAS هدف شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است.

biddableConversions

number

تعداد پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

biddableConversionsValue

number

ارزش کل پیش‌بینی‌شده تبدیل‌های قابل پیشنهاد.

clicks

string ( int64 format)

تعداد کلیک های پیش بینی شده

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو

impressions

string ( int64 format)

تعداد نمایش پیش بینی شده

topSlotImpressions

string ( int64 format)

تعداد پیش‌بینی‌شده نمایش‌های اسلات برتر. فقط نوع کانال تبلیغاتی جستجو از این فیلد پشتیبانی می کند.

AgeRangeView

نمای محدوده سنی

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای محدوده سنی. نام منابع نمای محدوده سنی به شکل زیر است:

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

AdScheduleView

نمای برنامه زمانی تبلیغات، عملکرد کمپین ها را بر اساس معیارهای AdSchedule خلاصه می کند.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای برنامه زمانی تبلیغات. نام منابع مشاهده AdSchedule به شکل زیر است:

customers/{customerId}/adScheduleViews/{campaignId}~{criterionId}

دسته دامنه

دسته ای که به طور خودکار با خزیدن دامنه ایجاد می شود. اگر یک کمپین از DynamicSearchAdsSetting استفاده کند، دسته بندی دامنه برای دامنه ایجاد می شود. دسته ها را می توان با استفاده از WebpageConditionInfo هدف قرار داد. ببینید: https://support.google.com/google-ads/answer/2471185

نمایندگی JSON
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع دسته دامنه. نام منابع دسته دامنه به شکل زیر است:

customers/{customerId}/domainCategories/{campaignId}~{category_base64}~{languageCode}

campaign

string

فقط خروجی کمپینی که این دسته برای آن توصیه می شود.

category

string

فقط خروجی دسته بندی توصیه شده برای دامنه وب سایت، به عنوان مثال، اگر وب سایتی در مورد الکترونیک دارید، دسته ها می توانند «دوربین»، «تلویزیون» و غیره باشند.

languageCode

string

فقط خروجی کد زبانی که زبان وب سایت را مشخص می کند، به عنوان مثال، "en" برای انگلیسی. زبان را می توان در DynamicSearchAdsSetting مورد نیاز برای تبلیغات جستجوی پویا مشخص کرد. این زبان صفحاتی از وب‌سایت شما است که می‌خواهید Google Ads آن‌ها را پیدا کند، برای آنها تبلیغات ایجاد کند و جستجوها را با آن مطابقت دهد.

domain

string

فقط خروجی دامنه برای وب سایت. دامنه را می توان در DynamicSearchAdsSetting مورد نیاز برای تبلیغات جستجوی پویا مشخص کرد.

coverageFraction

number

فقط خروجی کسری از صفحات سایت شما که این دسته با آنها مطابقت دارد.

categoryRank

string ( int64 format)

فقط خروجی جایگاه این دسته در مجموعه دسته بندی ها. اعداد کمتر نشان دهنده تطابق بهتر با دامنه است. null نشان می دهد توصیه نمی شود.

hasChildren

boolean

فقط خروجی نشان می دهد که آیا این دسته دارای زیرمجموعه هایی است یا خیر.

recommendedCpcBidMicros

string ( int64 format)

فقط خروجی هزینه پیشنهادی برای هر کلیک برای دسته.

AssetFieldTypeView

نمای نوع فیلد دارایی. هنگامی که دارایی به عنوان برنامه افزودنی استفاده می شود، این نما معیارهای غیر شمارش شده را برای هر نوع فیلد دارایی گزارش می دهد.

نمایندگی JSON
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای نوع فیلد دارایی. نام منابع مشاهده نوع فیلد دارایی به شکل زیر است:

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum ( AssetFieldType )

فقط خروجی نوع فیلد دارایی نمای نوع فیلد دارایی.

AssetGroupProductGroupView

نمای گروه محصول گروه دارایی.

نمایندگی JSON
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای گروه محصول گروه دارایی. نام منابع مشاهده گروه محصولات گروه دارایی به شکل زیر است:

customers/{customerId}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

فقط خروجی گروه دارایی مرتبط با فیلتر گروه فهرست.

assetGroupListingGroupFilter

string

فقط خروجی نام منابع فیلتر گروه لیست دارایی.

دارایی

نمای نوع دارایی. این نمایش معیارهای غیر همپوشانی را برای هر نوع مجموعه دارایی گزارش می دهد. انواع مجموعه دارایی کودک در این گزارش گنجانده نشده است. آمار آنها تحت نوع مجموعه دارایی والدین جمع می شود.

نمایندگی JSON
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای مجموعه دارایی. مجموعه دارایی نوع مشاهده نام منابع دارای فرم است:

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum ( AssetSetType )

فقط خروجی نوع مجموعه دارایی نمای نوع مجموعه دارایی.

پیشنهادات

شبیه سازی استراتژی مناقصه. ترکیبی پشتیبانی شده از نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است.

  1. Target_CPA - یکنواخت
  2. Target_roas - یکنواخت
نمایندگی JSON
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
زمینه های
resourceName

string

فقط خروجی نام منابع شبیه سازی استراتژی مناقصه. نام منابع شبیه سازی استراتژی مناقصه فرم:

customers/{customerId}/biddingStrategySimulations/{biddingStrategyId}~{type}~{modificationMethod}~{startDate}~{endDate}

biddingStrategyId

string ( int64 format)

فقط خروجی استراتژی مناقصه به اشتراک گذاری شناسه مجموعه شبیه سازی.

type

enum ( SimulationType )

فقط خروجی فیلدی که شبیه سازی تغییر می دهد.

modificationMethod

enum ( SimulationModificationMethod )

فقط خروجی چگونه شبیه سازی زمینه را اصلاح می کند.

startDate

string

فقط خروجی روز اول که در آن شبیه سازی مبتنی است ، در قالب Yyyy-MM-DD.

endDate

string

فقط خروجی آخرین روز که در آن شبیه سازی استوار است ، در قالب yyyy-mm-dd

Union Field point_list . لیست نقاط شبیه سازی. point_list فقط می تواند یکی از موارد زیر باشد:
targetCpaPointList

object ( TargetCpaSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_CPA باشد.

targetRoasPointList

object ( TargetRoasSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_Roas باشد.

بیداد

نمای تماس که شامل داده هایی برای ردیابی تماس از تبلیغات فقط تماس یا برنامه های افزودنی فراخوانی است.

نمایندگی JSON
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای تماس. نام منابع مشاهده تماس با فرم:

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

فقط خروجی کد کشور تماس گیرنده.

callerAreaCode

string

فقط خروجی کد منطقه تماس گیرنده. اگر مدت زمان تماس کوتاهتر از 15 ثانیه باشد ، تهی است.

callDurationSeconds

string ( int64 format)

فقط خروجی مدت زمان تماس با تبلیغ کننده در چند ثانیه.

startCallDateTime

string

فقط خروجی زمان شروع تماس تماس با تبلیغ کننده.

endCallDateTime

string

فقط خروجی زمان پایان تماس تلفنی تبلیغ کننده.

callTrackingDisplayLocation

enum ( CallTrackingDisplayLocation )

فقط خروجی مکان نمایش ردیابی تماس.

type

enum ( CallType )

فقط خروجی نوع تماس

callStatus

enum ( GoogleVoiceCallStatus )

فقط خروجی وضعیت تماس

CallTrackingDisplayLocation

مکان های نمایش ردیابی تماس احتمالی.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
AD تماس تلفنی از آگهی.
LANDING_PAGE تماس تلفنی از نقاط تبلیغات صفحه Landing به.

نوع فراخوانی

انواع احتمالی املاک از جایی که تماس برقرار شده است.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
MANUALLY_DIALED تماس تلفنی به صورت دستی شماره گیری شد.

GooglevoiceCallstatus

وضعیت احتمالی یک تماس صوتی Google.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
MISSED تماس از دست رفته بود.
RECEIVED تماس دریافت شد

CampaiceAudienceView

دیدگاه مخاطبان مبارزات انتخاباتی. شامل داده های عملکردی از علاقه ها و لیست های بازاریابی برای نمایش شبکه و تبلیغات شبکه YouTube و لیست های بازاریابی برای تبلیغات جستجو (RLSA) ، که توسط کمپین و معیار مخاطبان جمع شده است. این دیدگاه فقط شامل مخاطبان متصل در سطح کمپین است.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

فقط خروجی نام منابع دیدگاه مخاطبان کمپین. مخاطبان کمپین مشاهده نام منابع این شکل را دارند:

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignearchTerminsight

نمای اصطلاح جستجوی کمپین. داده های تاریخی از مارس 2023 در دسترس است.

نمایندگی JSON
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
زمینه های
resourceName

string

فقط خروجی نام منابع بینش سطح جستجوی سطح کمپین. سطح جستجوی کمپین اصطلاحات بینش نام منابع دارای فرم است:

customers/{customerId}/campaignSearchTermInsights/{campaignId}~{categoryId}

categoryLabel

string

فقط خروجی برچسب برای گروه جستجو. یک رشته خالی نشانگر دسته همه چیز برای اصطلاحات جستجو است که در گروه دیگری قرار نگرفته است.

id

string ( int64 format)

فقط خروجی شناسه بینش.

campaignId

string ( int64 format)

فقط خروجی شناسه کمپین.

عمل جراحی

یک شبیه سازی کمپین. ترکیبی پشتیبانی شده از نوع کانال تبلیغاتی ، نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است.

  • جستجو - cpc_bid - لباس
  • جستجو - cpc_bid - مقیاس گذاری
  • جستجو - Target_CPA - لباس
  • جستجو - Target_CPA - مقیاس گذاری
  • جستجو - Target_roas - یکنواخت
  • جستجو - target_impression_share - یکنواخت
  • جستجو - بودجه - لباس
  • خرید - بودجه - لباس
  • خرید - Target_roas - یکنواخت
  • Multi_Channel - Target_CPA - یکنواخت
  • multi_channel - target_roas - لباس
  • Discovery - Target_CPA - پیش فرض
  • نمایش - Target_CPA - لباس
  • Performance_max - Target_CPA - یکنواخت
  • Performance_max - Target_roas - یکنواخت
  • عملکرد_مکس - بودجه - یکنواخت
نمایندگی JSON
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
زمینه های
resourceName

string

فقط خروجی نام منابع شبیه سازی کمپین. نام منابع شبیه سازی کمپین شکل دارد:

customers/{customerId}/campaignSimulations/{campaignId}~{type}~{modificationMethod}~{startDate}~{endDate}

campaignId

string ( int64 format)

فقط خروجی شناسه کمپین شبیه سازی.

type

enum ( SimulationType )

فقط خروجی فیلدی که شبیه سازی تغییر می دهد.

modificationMethod

enum ( SimulationModificationMethod )

فقط خروجی چگونه شبیه سازی زمینه را اصلاح می کند.

startDate

string

فقط خروجی روز اول که در آن شبیه سازی مبتنی است ، در قالب Yyyy-MM-DD.

endDate

string

فقط خروجی آخرین روز که در آن شبیه سازی استوار است ، در قالب yyyy-mm-dd

Union Field point_list . لیست نقاط شبیه سازی. point_list فقط می تواند یکی از موارد زیر باشد:
cpcBidPointList

object ( CpcBidSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی CPC_BID باشد.

targetCpaPointList

object ( TargetCpaSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_CPA باشد.

targetRoasPointList

object ( TargetRoasSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_Roas باشد.

targetImpressionSharePointList

object ( TargetImpressionShareSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_Impression_Share باشد.

budgetPointList

object ( BudgetSimulationPointList )

فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی بودجه باشد.

هدف

یک ظرف برای نقاط شبیه سازی برای شبیه سازی Type Target_Impression_Share.

نمایندگی JSON
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( TargetImpressionShareSimulationPoint )

معیارهای پیش بینی شده برای یک ارزش سهم خاص هدف.

هدف

معیارهای پیش بینی شده برای یک ارزش سهم خاص هدف.

نمایندگی JSON
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
زمینه های
targetImpressionShareMicros

string ( int64 format)

ارزش سهم سه گانه شبیه سازی شده (در میکرو) که معیارهای پیش بینی شده بر اساس آن بنا شده اند. به عنوان مثال ، سهم تصور 10 ٪ ، که برابر با 0.1 است ، به عنوان 100_000 ذخیره می شود. این مقدار تأیید شده و از 1M (100 ٪) تجاوز نمی کند.

requiredCpcBidCeilingMicros

string ( int64 format)

پیش بینی شده به سقف پیشنهاد روزانه CPC که تبلیغ کننده باید برای تحقق این شبیه سازی ، در Micros از ارز تبلیغ کننده تنظیم کند.

requiredBudgetAmountMicros

string ( int64 format)

پیش بینی شده بودجه روزانه مورد نیاز که تبلیغ کننده برای دریافت ترافیک تخمین زده شده ، در Micro از ارز تبلیغ کننده باید تنظیم کند.

biddableConversions

number

تعداد پیش بینی شده از تبدیل های قابل پیشنهاد.

biddableConversionsValue

number

ارزش کل پیش بینی شده از تبدیل های قابل پیشنهاد.

clicks

string ( int64 format)

تعداد کلیک پیش بینی شده.

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو.

impressions

string ( int64 format)

تعداد پیش بینی شده از برداشت ها.

topSlotImpressions

string ( int64 format)

تعداد پیش بینی شده از برداشت های برتر شکاف. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند.

absoluteTopImpressions

string ( int64 format)

تعداد پیش بینی شده از برداشت های مطلق برتر. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند.

بودجه سنج

یک کانتینر برای نقاط شبیه سازی برای شبیه سازی بودجه نوع.

نمایندگی JSON
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
زمینه های
points[]

object ( BudgetSimulationPoint )

معیارهای پیش بینی شده برای یک سری از مبلغ بودجه.

نقطه نظر

معیارهای پیش بینی شده برای یک مبلغ بودجه خاص.

نمایندگی JSON
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
زمینه های
budgetAmountMicros

string ( int64 format)

بودجه شبیه سازی شده ای که معیارهای پیش بینی شده بر اساس آن بنا شده است.

requiredCpcBidCeilingMicros

string ( int64 format)

پیش بینی شده به سقف پیشنهاد روزانه CPC که تبلیغ کننده باید برای تحقق این شبیه سازی ، در Micros از ارز تبلیغ کننده تنظیم کند. فقط کمپین هایی با هدف قیمت پیشنهادی هزینه های پیشنهادی از این زمینه پشتیبانی می کنند.

biddableConversions

number

تعداد پیش بینی شده از تبدیل های قابل پیشنهاد.

biddableConversionsValue

number

ارزش کل پیش بینی شده از تبدیل های قابل پیشنهاد.

clicks

string ( int64 format)

تعداد کلیک پیش بینی شده.

costMicros

string ( int64 format)

هزینه پیش بینی شده در میکرو.

impressions

string ( int64 format)

تعداد پیش بینی شده از برداشت ها.

topSlotImpressions

string ( int64 format)

تعداد پیش بینی شده از برداشت های برتر شکاف. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند.

حامل

معیار حامل که می تواند در هدف قرار دادن کمپین استفاده شود.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع معیار حامل. نام منابع معیار حامل فرم دارد:

carrierConstants/{criterionId}

id

string ( int64 format)

فقط خروجی شناسه معیار حامل.

name

string

فقط خروجی نام کامل حامل به زبان انگلیسی.

countryCode

string

فقط خروجی کد کشور کشور که در آن شرکت حمل و نقل قرار دارد ، به عنوان مثال "AR" ، "FR" و غیره.

تغییر دهنده

تغییر گرانول منابع برگشتی از انواع منابع خاص را توصیف می کند. تغییرات ایجاد شده از طریق UI یا API در 30 روز گذشته گنجانده شده است. مقادیر قبلی و جدید زمینه های تغییر یافته نشان داده شده است. ChangeEvent می تواند تا 3 دقیقه تأخیر داشته باشد تا یک تغییر جدید را منعکس کند.

نمایندگی JSON
{
  "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,
  "asset": string
}
زمینه های
resourceName

string

فقط خروجی نام منابع رویداد تغییر. تغییر نام منابع رویداد فرم:

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

changeDateTime

string

فقط خروجی زمانی که تغییر در این منبع انجام شد.

changeResourceType

enum ( ChangeEventResourceType )

فقط خروجی نوع منبع تغییر یافته. این نشان می دهد که چه منبعی در Oldresource و NewResource تعیین می شود.

changeResourceName

string

فقط خروجی منبع ساده این تغییر در آن رخ داده است.

clientType

enum ( ChangeClientType )

فقط خروجی جایی که این تغییر انجام شد.

userEmail

string

فقط خروجی ایمیل کاربر که این تغییر را انجام داده است.

oldResource

object ( ChangedResource )

فقط خروجی منبع قدیمی قبل از تغییر. فقط زمینه های تغییر یافته جمع می شوند.

newResource

object ( ChangedResource )

فقط خروجی منبع جدید پس از تغییر. فقط زمینه های تغییر یافته جمع می شوند.

resourceChangeOperation

enum ( ResourceChangeOperation )

فقط خروجی عملیات در منبع تغییر یافته.

changedFields

string ( FieldMask format)

فقط خروجی لیستی از زمینه هایی که در منبع برگشتی تغییر می کنند.

این یک لیست جدا از کاما از نام های کاملاً واجد شرایط است. مثال: "user.displayName,photo" .

campaign

string

فقط خروجی کمپین تحت تأثیر این تغییر.

adGroup

string

فقط خروجی گروه ADGROUP تحت تأثیر این تغییر.

feed

string

فقط خروجی خوراک تحت تأثیر این تغییر.

feedItem

string

فقط خروجی خوراک تحت تأثیر این تغییر.

asset

string

فقط خروجی دارایی تحت تأثیر این تغییر.

تغییر

فهرست لیست منابع پشتیبانی توسط منبع ChangeEvent.

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. نمایانگر یک منبع غیر طبقه بندی شده در این نسخه است.
AD تغییر منابع تبلیغاتی.
AD_GROUP تغییر منابع AdGroup.
AD_GROUP_CRITERION تغییر منابع AdGroupCriterion.
CAMPAIGN تغییر منابع کمپین.
CAMPAIGN_BUDGET تغییر منابع کمپین.
AD_GROUP_BID_MODIFIER تغییر منبع AdGroupbidModifer.
CAMPAIGN_CRITERION تغییر منابع کمپین.
FEED تغییر منابع خوراک.
FEED_ITEM تغییر منابع Feeditem.
CAMPAIGN_FEED تغییر منابع کمپین.
AD_GROUP_FEED تغییر منابع AdgroupFeed.
AD_GROUP_AD تغییر منابع Adgroupad.
ASSET تغییر منابع دارایی.
CUSTOMER_ASSET تغییر منابع مشتری.
CAMPAIGN_ASSET تغییر منابع کمپین.
AD_GROUP_ASSET تغییر منابع AdGroupAsset.
ASSET_SET تغییر منابع دارایی.
ASSET_SET_ASSET تغییر منابع دارایی.
CAMPAIGN_ASSET_SET تغییر منابع کمپین.

changeclienttype

منبعی که منبع ChangeEvent از طریق آن ساخته شده است.

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. یک نوع مشتری طبقه بندی نشده را در این نسخه ناشناخته است.
GOOGLE_ADS_WEB_CLIENT تغییرات ایجاد شده از طریق "ads.google.com". به عنوان مثال ، تغییراتی که از طریق مدیریت کمپین ایجاد شده است.
GOOGLE_ADS_AUTOMATED_RULE تغییراتی که از طریق قوانین خودکار تبلیغات Google ایجاد شده است.
GOOGLE_ADS_SCRIPTS تغییرات ایجاد شده از طریق اسکریپت های Google ADS.
GOOGLE_ADS_BULK_UPLOAD تغییرات ایجاد شده توسط Google Ads Fulk Luadload.
GOOGLE_ADS_API تغییرات ایجاد شده توسط Google ADS API.
GOOGLE_ADS_EDITOR تغییرات ایجاد شده توسط ویرایشگر Google Ads. این مقدار یک مکان نگهدارنده است. API این تغییرات را برنمی گرداند.
GOOGLE_ADS_MOBILE_APP تغییرات ایجاد شده توسط برنامه تلفن همراه Google ADS.
GOOGLE_ADS_RECOMMENDATIONS تغییرات ایجاد شده از طریق توصیه های Google Ads.
SEARCH_ADS_360_SYNC تغییرات ایجاد شده از طریق ADS ADS 360 SYNC.
SEARCH_ADS_360_POST تغییرات ایجاد شده از طریق تبلیغات جستجو 360 پست.
INTERNAL_TOOL تغییرات ایجاد شده از طریق ابزارهای داخلی. به عنوان مثال ، هنگامی که کاربر یک الگوی URL را بر روی یک موجودیت مانند یک کمپین تنظیم می کند ، به طور خودکار با URL SA360 ClickServer پیچیده می شود.
OTHER انواع تغییراتی که طبقه بندی نمی شوند ، به عنوان مثال ، تغییراتی که توسط بازخرید کوپن از طریق تبلیغات Google ایجاد شده است.

تغییر یافته

یک بسته بندی Proto که تمام منابع پشتیبانی شده را ارائه می دهد. فقط منبع ChangerEsourCeType تنظیم می شود.

نمایندگی JSON
{
  "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)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
زمینه های
ad

object ( Ad )

فقط خروجی اگر changeresourcetype == ad.

adGroup

object ( AdGroup )

فقط خروجی اگر changeresourcetype == ad_group را تنظیم کنید.

adGroupCriterion

object ( AdGroupCriterion )

فقط خروجی اگر changeresourcetype == ad_group_criterion را تنظیم کنید.

campaign

object ( Campaign )

فقط خروجی اگر کمپین changeresourcetype == را تنظیم کنید.

campaignBudget

object ( CampaignBudget )

فقط خروجی اگر changeresourcetype == campaign_budget.

adGroupBidModifier

object ( AdGroupBidModifier )

فقط خروجی اگر changeresourcetype == ad_group_bid_modifier را تنظیم کنید.

campaignCriterion

object ( CampaignCriterion )

فقط خروجی اگر changeresourcetype == campaign_criterion.

feed

object ( Feed )

فقط خروجی اگر changeresourcetype == خوراک را تنظیم کنید.

feedItem

object ( FeedItem )

فقط خروجی اگر changeresourcetype == feed_item را تنظیم کنید.

campaignFeed

object ( CampaignFeed )

فقط خروجی اگر changeresourcetype == campaign_feed را تنظیم کنید.

adGroupFeed

object ( AdGroupFeed )

فقط خروجی اگر changeresourcetype == ad_group_feed را تنظیم کنید.

adGroupAd

object ( AdGroupAd )

فقط خروجی اگر changeresourcetype == ad_group_ad را تنظیم کنید.

asset

object ( Asset )

فقط خروجی اگر changeresourcetype == دارایی را تنظیم کنید.

customerAsset

object ( CustomerAsset )

فقط خروجی اگر changeresourcetype == customer_asset را تنظیم کنید.

campaignAsset

object ( CampaignAsset )

فقط خروجی اگر changeresourcetype == campaign_asset را تنظیم کنید.

adGroupAsset

object ( AdGroupAsset )

فقط خروجی اگر changeresourcetype == ad_group_asset را تنظیم کنید.

assetSet

object ( AssetSet )

فقط خروجی اگر changeresourcetype == asset_set را تنظیم کنید.

assetSetAsset

object ( AssetSetAsset )

فقط خروجی اگر changeresourcetype == asset_set_asset را تنظیم کنید.

campaignAssetSet

object ( CampaignAssetSet )

فقط خروجی اگر changeresourcetype == campaign_asset_set را تنظیم کنید.

منبع

عملیات در منبع تغییر یافته در منبع تغییر.

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. نمایانگر یک عملیات غیر طبقه بندی شده در این نسخه است.
CREATE این منبع ایجاد شد.
UPDATE این منبع اصلاح شد.
REMOVE منبع برداشته شد.

تغییر وضعیت

وضعیت منبع برگشتی را توصیف می کند. Changestatus می تواند تا 3 دقیقه تأخیر داشته باشد تا یک تغییر جدید را منعکس کند.

نمایندگی JSON
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع وضعیت تغییر. تغییر نام منابع وضعیت فرم:

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum ( ChangeStatusResourceType )

فقط خروجی نشان دهنده نوع منبع تغییر یافته است. این نشان می دهد که چه زمینه هایی تعیین می شود. به عنوان مثال ، برای زمینه های AD_GROUP ، کمپین و AdGroup تنظیم می شود.

resourceStatus

enum ( ChangeStatusOperation )

فقط خروجی نشان دهنده وضعیت منبع تغییر یافته است.

sharedSet

string

فقط خروجی مشترک تحت تأثیر این تغییر.

campaignSharedSet

string

فقط خروجی CampaignSharedset تحت تأثیر این تغییر قرار گرفت.

asset

string

فقط خروجی دارایی تحت تأثیر این تغییر.

customerAsset

string

فقط خروجی مشتری تحت تأثیر این تغییر.

campaignAsset

string

فقط خروجی کمپین تحت تأثیر این تغییر.

adGroupAsset

string

فقط خروجی AdGroupAsset تحت تأثیر این تغییر.

combinedAudience

string

فقط خروجی ترکیبی که تحت تأثیر این تغییر قرار گرفته است.

lastChangeDateTime

string

فقط خروجی زمانی که جدیدترین تغییر در این منبع رخ داده است.

campaign

string

فقط خروجی کمپین تحت تأثیر این تغییر.

adGroup

string

فقط خروجی گروه ADGROUP تحت تأثیر این تغییر.

adGroupAd

string

فقط خروجی Adgroupad تحت تأثیر این تغییر قرار گرفت.

adGroupCriterion

string

فقط خروجی آداب و رسوم آداب و رسوم تحت تأثیر این تغییر.

campaignCriterion

string

فقط خروجی ComplictCriterion تحت تأثیر این تغییر.

feed

string

فقط خروجی خوراک تحت تأثیر این تغییر.

feedItem

string

فقط خروجی خوراک تحت تأثیر این تغییر.

adGroupFeed

string

فقط خروجی AdgroupFeed تحت تأثیر این تغییر قرار گرفت.

campaignFeed

string

فقط خروجی کمپین تحت تأثیر این تغییر.

adGroupBidModifier

string

فقط خروجی AdGroupbidModifer تحت تأثیر این تغییر.

changestatusresourcetype

فهرست فهرست پشتیبانی انواع منابع توسط منبع Changestatus.

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. نمایانگر یک منبع غیر طبقه بندی شده در این نسخه است.
AD_GROUP تغییر منابع AdGroup.
AD_GROUP_AD تغییر منابع Adgroupad.
AD_GROUP_CRITERION تغییر منابع AdGroupCriterion.
CAMPAIGN تغییر منابع کمپین.
CAMPAIGN_CRITERION تغییر منابع کمپین.
FEED تغییر منابع خوراک.
FEED_ITEM تغییر منابع Feeditem.
AD_GROUP_FEED تغییر منابع AdgroupFeed.
CAMPAIGN_FEED تغییر منابع کمپین.
AD_GROUP_BID_MODIFIER تغییر منبع AdGroupbidModifer.
SHARED_SET تغییر منابع مشترک.
CAMPAIGN_SHARED_SET تغییر منابع کمپین.
ASSET تغییر منابع دارایی.
CUSTOMER_ASSET تغییر منابع مشتری.
CAMPAIGN_ASSET تغییر منابع کمپین.
AD_GROUP_ASSET تغییر منابع AdGroupAsset.
COMBINED_AUDIENCE تغییر منابع ترکیبی.

تعقیب و گریز

وضعیت منبع تغییر یافته

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. نمایانگر یک منبع غیر طبقه بندی شده در این نسخه است.
ADDED این منبع ایجاد شد.
CHANGED این منبع اصلاح شد.
REMOVED منبع برداشته شد.

تجربیات ترکیبی

منبعی را برای مخاطبان ترکیبی که شامل مخاطبان مختلف است ، توصیف کنید.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
زمینه های
resourceName

string

تغییر ناپذیر نام منابع مخاطب ترکیبی. نام مخاطبان ترکیبی فرم دارند:

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string ( int64 format)

فقط خروجی شناسه مخاطبان ترکیبی.

status

enum ( CombinedAudienceStatus )

فقط خروجی وضعیت این مخاطب ترکیبی. نشان می دهد که آیا مخاطب ترکیبی فعال شده یا حذف شده است.

name

string

فقط خروجی نام مخاطبان ترکیبی. این باید در همه مخاطبان ترکیبی منحصر به فرد باشد.

description

string

فقط خروجی شرح این مخاطب ترکیبی.

ترکیبی

enum حاوی انواع وضعیت مخاطبان ترکیبی احتمالی.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
ENABLED وضعیت فعال شده - مخاطب ترکیبی فعال است و می توان آنها را هدف قرار داد.
REMOVED وضعیت حذف شده - مخاطب ترکیبی برداشته می شود و برای هدف قرار دادن قابل استفاده نیست.

clickview

نمای کلیک با معیارهای جمع شده در هر سطح کلیک ، از جمله هر دو کلیک معتبر و نامعتبر. برای کمپین های غیر جستجو ، Metrics.Clicks تعداد تعامل معتبر و نامعتبر را نشان می دهد. نمایش داده شدگان از جمله ClickView باید یک فیلتر داشته باشند که نتایج را به یک روز محدود کند و می تواند برای تاریخ 90 روز قبل از زمان درخواست درخواست شود.

نمایندگی JSON
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای کلیک. روی مشاهده نام منابع ، فرم را دارند:

customers/{customerId}/clickViews/{date (yyyy-MM-dd)}~{gclid}

areaOfInterest

object ( ClickLocation )

فقط خروجی معیارهای مکان مطابق با منطقه مورد علاقه مرتبط با این تصور.

locationOfPresence

object ( ClickLocation )

فقط خروجی معیارهای مکان مطابق با محل حضور در ارتباط با برداشت.

keyword

string

فقط خروجی کلمه کلیدی مرتبط ، در صورت وجود و کلیک با کانال جستجو مطابقت دارد.

keywordInfo

object ( KeywordInfo )

فقط خروجی در صورت وجود اطلاعات اساسی در مورد کلمه کلیدی مرتبط.

gclid

string

فقط خروجی شناسه کلیک Google.

pageNumber

string ( int64 format)

فقط خروجی شماره صفحه در نتایج جستجو که در آن تبلیغ نشان داده شده است.

adGroupAd

string

فقط خروجی تبلیغ مرتبط

campaignLocationTarget

string

فقط خروجی در صورت وجود موقعیت مکانی کمپین مرتبط ، هدف قرار می گیرد.

userList

string

فقط خروجی اگر یکی وجود داشته باشد ، لیست کاربر مرتبط.

clicklocation

معیارهای موقعیت مکانی مرتبط با کلیک.

نمایندگی JSON
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
زمینه های
city

string

معیار موقعیت مکانی شهر در ارتباط با برداشت است.

country

string

معیار موقعیت مکانی کشور در ارتباط با برداشت.

metro

string

معیار موقعیت مکانی مترو همراه با تصور.

mostSpecific

string

خاص ترین معیار موقعیت مکانی مرتبط با تصور.

region

string

معیار موقعیت مکانی منطقه در ارتباط با برداشت.

ارز

یک ارز ثابت.

نمایندگی JSON
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع ارز ثابت. نام منابع ثابت ارز فرم دارد:

currencyConstants/{code}

code

string

فقط خروجی کد ارز سه حرفی ISO 4217 ، به عنوان مثال ، "USD"

name

string

فقط خروجی نام کامل انگلیسی ارز.

symbol

string

فقط خروجی نماد استاندارد برای توصیف این ارز ، به عنوان مثال ، "$" برای دلار آمریکا.

billableUnitMicros

string ( int64 format)

فقط خروجی واحد قابل پرداخت برای این ارز. مبالغ صورتحساب باید چند برابر از این مقدار باشد.

در دسترس

نمای نمایشی از پیشنهادات متعلق به و به اشتراک گذاشته شده با مشتری را نشان می دهد.

برخلاف DiddingStrategy ، این منبع شامل استراتژی های متعلق به مدیران مشتری و به اشتراک گذاشته شده با این مشتری - علاوه بر استراتژی های متعلق به این مشتری است. این منبع معیارهایی را ارائه نمی دهد و فقط زیر مجموعه محدودی از ویژگی های PiddingStrategy را در معرض نمایش قرار می دهد.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
زمینه های
resourceName

string

فقط خروجی نام منابع استراتژی مناقصه در دسترس. نام منابع در دسترس

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string ( int64 format)

فقط خروجی شناسه استراتژی مناقصه.

name

string

فقط خروجی نام استراتژی مناقصه.

type

enum ( BiddingStrategyType )

فقط خروجی نوع استراتژی مناقصه.

ownerCustomerId

string ( int64 format)

فقط خروجی شناسه مشتری که صاحب استراتژی مناقصه است.

ownerDescriptiveName

string

فقط خروجی توصیف نام مشتری که صاحب استراتژی مناقصه است.

scheme میدانی اتحادیه. طرح مناقصه

فقط یک نفر قابل تنظیم است. scheme فقط می تواند یکی از موارد زیر باشد:

maximizeConversionValue

object ( MaximizeConversionValue )

فقط خروجی یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود.

maximizeConversions

object ( MaximizeConversions )

فقط خروجی یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود.

targetCpa

object ( TargetCpa )

فقط خروجی یک استراتژی مناقصه که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.

targetImpressionShare

object ( TargetImpressionShare )

فقط خروجی یک استراتژی مناقصه که به طور خودکار نسبت به درصد منتخب برداشت ها بهینه می شود.

targetRoas

object ( TargetRoas )

فقط خروجی یک استراتژی مناقصه که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید.

targetSpend

object ( TargetSpend )

فقط خروجی یک استراتژی پیشنهادی که پیشنهادات شما را برای کمک به شما کمک می کند تا هرچه بیشتر کلیک در بودجه شما بدست آورید.

حداکثر

یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود.

نمایندگی JSON
{
  "targetRoas": number
}
زمینه های
targetRoas

number

فقط خروجی گزینه Return On Ad Devent (ROAS) گزینه. در صورت تنظیم ، استراتژی پیشنهاد در حالی که میانگین بازده هدف در تبلیغات را دارد ، درآمد را به حداکثر می رساند. اگر ROAS هدف بالا باشد ، ممکن است استراتژی پیشنهاد نتواند بودجه کامل را خرج کند. اگر ROA های هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود.

حداکثر

یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود.

نمایندگی JSON
{
  "targetCpaMicros": string
}
زمینه های
targetCpaMicros

string ( int64 format)

فقط خروجی هزینه هدف برای هر گزینه Acquisition (CPA). این میانگین مبلغی است که می خواهید در هر خرید هزینه کنید.

TargetCPA

یک استراتژی پیشنهادی خودکار که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.

نمایندگی JSON
{
  "targetCpaMicros": string
}
زمینه های
targetCpaMicros

string ( int64 format)

فقط خروجی هدف متوسط ​​CPA. این هدف باید بر اساس ارز برای حساب بیشتر یا مساوی با حداقل واحد قابل پرداخت باشد.

هدف گیری

یک استراتژی مناقصه خودکار که پیشنهادات را تعیین می کند به گونه ای که درصد مشخصی از تبلیغات جستجو در بالای صفحه اول (یا مکان هدفمند دیگر) نشان داده می شود.

نمایندگی JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
زمینه های
location

enum ( TargetImpressionShareLocation )

فقط خروجی مکان هدفمند در صفحه نتایج جستجو.

locationFractionMicros

string ( int64 format)

بخش انتخابی از تبلیغات که در مکان هدفمند در میکرو نشان داده می شود. به عنوان مثال ، 1 ٪ برابر با 10،000 است.

cpcBidCeilingMicros

string ( int64 format)

فقط خروجی بالاترین پیشنهاد CPC سیستم مناقصه خودکار مجاز به مشخص کردن است. این یک زمینه مورد نیاز است که توسط تبلیغ کننده وارد شده است که سقف را تنظیم کرده و در MICRO های محلی مشخص شده است.

عناوین هدف

یک استراتژی مناقصه خودکار که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید.

نمایندگی JSON
{
  "targetRoas": number
}
زمینه های
targetRoas

number

فقط خروجی درآمد انتخاب شده (بر اساس داده های تبدیل) در هر واحد هزینه.

هدف

یک استراتژی پیشنهادی خودکار که پیشنهادات شما را برای کمک به دریافت هرچه بیشتر کلیک در بودجه شما تعیین می کند.

نمایندگی JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
زمینه های
targetSpendMicros
(deprecated)

string ( int64 format)

فقط خروجی هدف هزینه ای که در آن برای به حداکثر رساندن کلیک ها انجام می شود. یک پیشنهاد دهنده Targetspend سعی خواهد کرد که کوچکتر از این ارزش یا مبلغ هزینه های طبیعی را خرج کند. اگر مشخص نشده باشد ، بودجه به عنوان هدف هزینه استفاده می شود. این قسمت مستهلک می شود و دیگر نباید مورد استفاده قرار گیرد. برای جزئیات بیشتر به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید.

cpcBidCeilingMicros

string ( int64 format)

فقط خروجی حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود.

مشتری مشتری

پیوندی بین مشتری داده شده و مشتری مشتری. مشتری های مشتری فقط برای مشتریان مدیر وجود دارند. کلیه مشتریان مشتری مستقیم و غیرمستقیم و همچنین خود مدیر گنجانده شده است.

نمایندگی JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع مشتری مشتری. نام منابع مشتری مشتری فرم دارد: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

فقط خروجی نام منابع برچسب های متعلق به مشتری درخواست کننده که برای مشتری مشتری اعمال می شود. نام منابع برچسب فرم دارد:

customers/{customerId}/labels/{label_id}

status

enum ( CustomerStatus )

فقط خروجی وضعیت مشتری مشتری. فقط خواندنی.

clientCustomer

string

فقط خروجی نام منبع مشتری مشتری که به مشتری داده شده مرتبط است. فقط خواندنی.

hidden

boolean

فقط خروجی مشخص می کند که آیا این یک حساب پنهان است یا خیر. فقط خواندنی.

level

string ( int64 format)

فقط خروجی فاصله بین مشتری و مشتری. برای پیوند خود ، مقدار سطح فقط 0 خواهد بود.

timeZone

string

فقط خروجی مخزن داده های محلی محلی (CLDR) بازنمایی رشته از منطقه زمانی مشتری ، به عنوان مثال ، America/LOS_ANGELES. فقط خواندنی.

testAccount

boolean

فقط خروجی مشخص می کند که آیا مشتری یک حساب آزمایشی است یا خیر. فقط خواندنی.

manager

boolean

فقط خروجی آیا مشتری مدیر است یا خیر. فقط خواندنی.

descriptiveName

string

فقط خروجی نام توصیفی برای مشتری. فقط خواندنی.

currencyCode

string

فقط خروجی کد ارز (به عنوان مثال ، "USD" ، "EUR") برای مشتری. فقط خواندنی.

id

string ( int64 format)

فقط خروجی شناسه مشتری مشتری. فقط خواندنی.

Customersearch terminsight

نمای اصطلاح جستجوی مشتری. داده های تاریخی از مارس 2023 در دسترس است.

نمایندگی JSON
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
زمینه های
resourceName

string

فقط خروجی نام منابع بینش اصطلاح جستجوی سطح مشتری. سطح جستجوی سطح مشتری نام منابع بینش فرم دارد:

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

فقط خروجی برچسب برای گروه جستجو. یک رشته خالی نشانگر دسته همه چیز برای اصطلاحات جستجو است که در گروه دیگری قرار نگرفته است.

id

string ( int64 format)

فقط خروجی شناسه بینش.

نمای جزئیات

نمایی با معیارهای جمع شده توسط گروه تبلیغاتی و URL یا YouTube Video.

نمایندگی JSON
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای قرار دادن جزئیات. جزئیات قرار دادن جزئیات نام منابع فرم:

customers/{customerId}/detailPlacementViews/{adGroupId}~{base64_placement}

placementType

enum ( PlacementType )

فقط خروجی نوع قرارگیری ، به عنوان مثال ، وب سایت ، ویدیوی YouTube و برنامه موبایل.

placement

string

فقط خروجی رشته قرار دادن خودکار در سطح جزئیات ، به عنوان مثال URL وب سایت ، شناسه برنامه کاربردی موبایل یا شناسه ویدیویی YouTube.

displayName

string

فقط خروجی نام نمایش نام URL برای وب سایت ها ، نام ویدیوی YouTube برای فیلم های YouTube و نام برنامه تلفن همراه ترجمه شده برای برنامه های تلفن همراه است.

groupPlacementTargetUrl

string

فقط خروجی URL از قرار دادن گروه ، به عنوان مثال ، دامنه ، پیوند به برنامه موبایل در فروشگاه App یا URL کانال YouTube.

targetUrl

string

فقط خروجی URL محل قرارگیری ، به عنوان مثال ، وب سایت ، پیوند به برنامه موبایل در فروشگاه App یا یک URL ویدیویی YouTube.

نوع قرار دادن

انواع قرارگیری احتمالی برای نقشه برداری خوراک.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
WEBSITE وب سایت ها (به عنوان مثال ، "www.flowers4sale.com").
MOBILE_APP_CATEGORY دسته برنامه های کاربردی موبایل (به عنوان مثال ، "بازی ها").
MOBILE_APPLICATION برنامه های تلفن همراه (به عنوان مثال ، "MobileApp :: 2-com.whatsthewordanswers ').
YOUTUBE_VIDEO فیلم های YouTube (به عنوان مثال ، youtube.com/video/wtljpvx7-ys ').
YOUTUBE_CHANNEL کانال های YouTube (به عنوان مثال ، "youtube.com:.com:.l8zulxascc1i_oaot0naoq").
GOOGLE_PRODUCTS سطوح متعلق به و اداره شده توسط Google (به عنوان مثال ، "tv.google.com").

ممتاز

جمعیتی مفصل: یک عمودی مبتنی بر علاقه خاص برای دستیابی به کاربران بر اساس حقایق زندگی بلند مدت.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
زمینه های
resourceName

string

فقط خروجی نام منابع جمعیتی دقیق. نام منابع دموگرافیک دقیق فرم دارد:

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string ( int64 format)

فقط خروجی شناسه جمعیتی مفصل.

name

string

فقط خروجی نام جمعیتی مفصل. به عنوان مثال ، "بالاترین سطح دستیابی آموزشی"

parent

string

فقط خروجی پدر و مادر DectiveDemographic.

launchedToAll

boolean

فقط خروجی اگر جمعیتی دقیق به همه کانال ها و محلی ها راه اندازی شود ، درست است.

availabilities[]

object ( CriterionCategoryAvailability )

فقط خروجی اطلاعات در دسترس بودن جمعیتی دقیق.

CriterionCategorAailability

اطلاعات مربوط به در دسترس بودن دسته ، در هر کانال تبلیغاتی.

نمایندگی JSON
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
زمینه های
channel

object ( CriterionCategoryChannelAvailability )

انواع کانال و زیرگروه هایی که در دسترس گروه هستند.

locale[]

object ( CriterionCategoryLocaleAvailability )

محلی که برای کانال در دسترس هستند.

CriterionCategoryChannelAileability

اطلاعات مربوط به نوع کانال تبلیغاتی و زیرگروه ها یک دسته در دسترس است.

نمایندگی JSON
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
زمینه های
availabilityMode

enum ( CriterionCategoryChannelAvailabilityMode )

قالب در دسترس بودن کانال. می تواند All_Channels باشد (بقیه زمینه ها تنظیم نمی شوند) ، کانال_Type (فقط نوع تبلیغات CHANNELTYPE تنظیم می شود ، این دسته در دسترس همه انواع زیر در زیر آن است) یا channel_type_and_subtypes (AdvertisingChanneltype ، AdvertisingChannelSubtype ، و GrovedefefaultChannelSubtype همه تنظیم می شوند).

advertisingChannelType

enum ( AdvertisingChannelType )

نوع کانال این دسته در دسترس است.

advertisingChannelSubType[]

enum ( AdvertisingChannelSubType )

زیرگروه های کانال در زیر نوع کانال که دسته در دسترس است.

includeDefaultChannelSubType

boolean

آیا نوع زیر کانال پیش فرض گنجانده شده است. به عنوان مثال ، AdvertisingChanneltype نمایش داده می شود و شامل FALLEFAULTCHANNELSUBTYPE FALSE است به این معنی است که کمپین نمایش پیش فرض در جایی که نوع زیر کانال تنظیم نشده است در این پیکربندی در دسترس قرار نمی گیرد.

CriterionCategorChannelavaIlabilityMode

Enum حاوی CriterionCategorCateChannelAvaIlabilityMode.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
ALL_CHANNELS این گروه برای کمپین های همه انواع و زیرگروه های کانال در دسترس است.
CHANNEL_TYPE_AND_ALL_SUBTYPES این گروه برای کمپین هایی از یک نوع کانال خاص ، از جمله تمام زیرگروه های زیر آن در دسترس است.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES این گروه برای کمپین هایی از نوع کانال خاص و زیرگروه (های) در دسترس است.

CriterionCategorLocaleAvilability

اطلاعاتی در مورد کدام یک از دسته ها در دسترس است.

نمایندگی JSON
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
زمینه های
availabilityMode

enum ( CriterionCategoryLocaleAvailabilityMode )

قالب در دسترس بودن محلی. می توان راه اندازی کرد_TO_ALL (هر دو کشور و زبان خالی خواهد بود) ، کشور (فقط کشور تعیین می شود) ، زبان (فقط زبان تنظیم می شود) ، Country_and_language (هر دو کشور و زبان تنظیم می شوند).

countryCode

string

کد کشور ISO-3166-1 alpha-2 مرتبط با این گروه.

languageCode

string

ISO 639-1 کد زبان مرتبط با این گروه.

CriterionCategorLocalAiaIbabilityMode

Enum حاوی CriterionCategorCategorLocalAiaiabilationMode.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
ALL_LOCALES این گروه برای کمپین های همه محلی ها در دسترس است.
COUNTRY_AND_ALL_LANGUAGES این گروه بدون در نظر گرفتن زبان در اختیار کمپین های موجود در لیست کشورها قرار می گیرد.
LANGUAGE_AND_ALL_COUNTRIES این گروه بدون در نظر گرفتن کشور ، در اختیار کمپین های موجود در لیست زبانها قرار می گیرد.
COUNTRY_AND_LANGUAGE این گروه در لیستی از کشور ، جفت زبان در اختیار کمپین های موجود است.

DisplayKeywordView

نمای کلمه کلیدی نمایش.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمایش کلمه کلیدی نمایشگر. نمایش کلمات کلیدی مشاهده نام منابع فرم:

customers/{customerId}/displayKeywordViews/{adGroupId}~{criterionId}

نمای فاصله

نمای فاصله با معیارهای جمع شده از فاصله کاربر از برنامه های تبلیغاتی یک تبلیغ کننده. هر فاصله از راه دور شامل تمام برداشت هایی است که در فاصله آن قرار می گیرند و یک برداشت واحد به معیارهای مربوط به همه راه دور که شامل فاصله کاربر است ، کمک می کند.

نمایندگی JSON
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای فاصله. نام منابع از راه دور فرم دارد:

customers/{customerId}/distanceViews/1~{distanceBucket}

distanceBucket

enum ( DistanceBucket )

فقط خروجی گروه بندی فاصله کاربر از پسوندهای مکان.

metricSystem

boolean

فقط خروجی درست است اگر BAINDBUCKET از سیستم متریک استفاده می کند ، در غیر این صورت نادرست است.

از راه دور

سطل مسافت برای فاصله کاربر از پسوند مکان تبلیغ کننده.

Enums
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
WITHIN_700M کاربر در 700 متر از مکان قرار داشت.
WITHIN_1KM کاربر در فاصله 1 کیلومتری محل قرار داشت.
WITHIN_5KM کاربر در فاصله 5 کیلومتری محل قرار داشت.
WITHIN_10KM کاربر در فاصله 10 کیلومتری محل قرار داشت.
WITHIN_15KM کاربر در فاصله 15 کیلومتری مکان قرار داشت.
WITHIN_20KM کاربر در فاصله 20 کیلومتری محل قرار داشت.
WITHIN_25KM کاربر در فاصله 25 کیلومتری مکان قرار داشت.
WITHIN_30KM کاربر در فاصله 30 کیلومتری محل قرار داشت.
WITHIN_35KM کاربر در فاصله 35 کیلومتری مکان قرار داشت.
WITHIN_40KM کاربر در فاصله 40 کیلومتری محل قرار داشت.
WITHIN_45KM کاربر در فاصله 45 کیلومتری مکان قرار داشت.
WITHIN_50KM کاربر در فاصله 50 کیلومتری محل قرار داشت.
WITHIN_55KM کاربر در فاصله 55 کیلومتری مکان قرار داشت.
WITHIN_60KM کاربر در فاصله 60 کیلومتری مکان قرار داشت.
WITHIN_65KM کاربر در فاصله 65 کیلومتری مکان قرار داشت.
BEYOND_65KM کاربر فراتر از 65 کیلومتر از مکان بود.
WITHIN_0_7MILES کاربر در فاصله 0.7 مایل از مکان قرار داشت.
WITHIN_1MILE کاربر در فاصله 1 مایل از مکان قرار داشت.
WITHIN_5MILES کاربر در فاصله 5 مایل از مکان قرار داشت.
WITHIN_10MILES کاربر در فاصله 10 مایل از مکان قرار داشت.
WITHIN_15MILES کاربر در فاصله 15 مایل از مکان قرار داشت.
WITHIN_20MILES کاربر در فاصله 20 مایل از مکان قرار داشت.
WITHIN_25MILES کاربر در فاصله 25 مایل از مکان قرار داشت.
WITHIN_30MILES کاربر در فاصله 30 مایل از مکان قرار داشت.
WITHIN_35MILES کاربر در 35 مایل از مکان قرار داشت.
WITHIN_40MILES کاربر در فاصله 40 مایل از مکان قرار داشت.
BEYOND_40MILES کاربر فراتر از 40 مایل از مکان بود.

DynamicsearchAdsSearchTermView

نمای جستجوی تبلیغات پویا جستجو.

نمایندگی JSON
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
زمینه های
resourceName

string

فقط خروجی نام منابع نمای جستجوی آگهی های جستجوی پویا. آگهی های جستجوی پویا جستجوی اصطلاح مشاهده نام منابع دارای فرم هستند:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

searchTerm

string

فقط خروجی عبارت جستجو

این قسمت فقط خواندنی است.

headline

string

فقط خروجی تیتر پویا تولید شده از آگهی جستجوی پویا.

این قسمت فقط خواندنی است.

landingPage

string

فقط خروجی URL صفحه فرود پویا انتخاب شده از این تصور.

این قسمت فقط خواندنی است.

pageUrl

string

فقط خروجی URL مورد از صفحه خوراک صفحه برای برداشت استفاده می شود.

این قسمت فقط خواندنی است.

hasNegativeKeyword

boolean

فقط خروجی اگر پرس و جو با یک کلمه کلیدی منفی مطابقت داشته باشد ، درست است.

این قسمت فقط خواندنی است.

hasMatchingKeyword

boolean

فقط خروجی اگر پرس و جو به کلمات کلیدی هدفمند اضافه شود ، درست است.

این قسمت فقط خواندنی است.

hasNegativeUrl

boolean

فقط خروجی درست است اگر پرس و جو با URL منفی مطابقت داشته باشد.

این قسمت فقط خواندنی است.

نمای گسترده

نمای صفحه فرود با معیارهای جمع شده در سطح URL نهایی گسترش یافته.

نمایندگی JSON
{
  "resourceName": string,
  "expandedFinalUrl": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای صفحه فرود گسترده. نمای صفحه نمایش گسترش یافته نام منابع فرم دارد:

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expandedFinalUrl

string

فقط خروجی URL نهایی که کلیک به آن هدایت می شود.

نمایندگان بازدارنده

یک نمای نگهدارنده خوراک.

نمایندگی JSON
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای نگهدارنده خوراک. نام منابع نگهدارنده محل تغذیه فرم:

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum ( PlaceholderType )

فقط خروجی نوع نگهدارنده محل نمای نگهدارنده خوراک.

ژاندرویز

یک نمای جنسیتی منبع Genderview به جای اینکه معیارهایی اضافه شود ، وضعیت مؤثر خدمت را منعکس می کند. یک گروه تبلیغاتی بدون معیارهای جنسیتی به طور پیش فرض به همه جنس ها نشان می دهد ، بنابراین همه جنس ها در Genderview با آمار ظاهر می شوند.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

فقط خروجی نام منابع نمای جنسیت. نام منابع مشاهده جنسیت فرم دارد:

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

نمای جغرافیایی

یک دیدگاه جغرافیایی

نمای جغرافیایی شامل تمام معیارهای جمع شده در سطح کشور ، یک ردیف در هر کشور است. این معیارها را در هر دو مکان فیزیکی واقعی کاربر یا منطقه مورد علاقه گزارش می کند. در صورت استفاده از قسمتهای دیگر بخش ، ممکن است بیش از یک ردیف در هر کشور بدست آورید.

نمایندگی JSON
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
زمینه های
resourceName

string

فقط خروجی نام منبع نمای جغرافیایی. نام منابع نمایش جغرافیایی فرم دارد:

customers/{customerId}/geographicViews/{countryCriterionId}~{locationType}

locationType

enum ( GeoTargetingType )

فقط خروجی نوع هدف قرار دادن GEO از کمپین.

countryCriterionId

string ( int64 format)

فقط خروجی 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
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
زمینه های
resourceName

string

Output only. The resource name of the group placement view. Group placement view resource names have the form:

customers/{customerId}/groupPlacementViews/{adGroupId}~{base64_placement}

placementType

enum ( PlacementType )

Output only. Type of the placement, for example, Website, YouTube Channel, Mobile Application.

placement

string

Output only. The automatic placement string at group level, eg web domain, mobile app ID, or a YouTube channel ID.

displayName

string

Output only. Domain name for websites and YouTube channel name for YouTube channels.

targetUrl

string

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
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the hotel group view. Hotel Group view resource names have the form:

customers/{customerId}/hotelGroupViews/{adGroupId}~{criterionId}

HotelPerformanceView

A hotel performance view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the hotel performance view. Hotel performance view resource names have the form:

customers/{customerId}/hotelPerformanceView

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
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
زمینه های
resourceName

string

Immutable. The resource name of the hotel reconciliation. Hotel reconciliation resource names have the form:

customers/{customerId}/hotelReconciliations/{commissionId}

commissionId

string

ضروری. 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

string

Output only. The order ID is the identifier for this booking as provided in the 'transaction_id' parameter of the conversion tracking tag.

campaign

string

Output only. The resource name for the Campaign associated with the conversion.

hotelCenterId

string ( int64 format)

Output only. Identifier for the Hotel Center account which provides the rates for the Hotel campaign.

hotelId

string

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

string

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

string

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

string ( int64 format)

ضروری. 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

boolean

Output only. Whether a given booking has been billed. Once billed, a booking can't be modified.

status

enum ( HotelReconciliationStatus )

ضروری. 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
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the income range view. Income range view resource names have the form:

customers/{customerId}/incomeRangeViews/{adGroupId}~{criterionId}

KeywordView

A keyword view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the keyword view. Keyword view resource names have the form:

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

LandingPageView

A landing page view with metrics aggregated at the unexpanded final URL level.

نمایندگی JSON
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
زمینه های
resourceName

string

Output only. The resource name of the landing page view. Landing page view resource names have the form:

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}

unexpandedFinalUrl

string

Output only. The advertiser-specified final URL.

LanguageConstant

یک زبان.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
زمینه های
resourceName

string

Output only. The resource name of the language constant. Language constant resource names have the form:

languageConstants/{criterionId}

id

string ( int64 format)

Output only. The ID of the language constant.

code

string

Output only. The language code, for example, "en_US", "en_AU", "es", "fr", etc.

name

string

Output only. The full name of the language in English, for example, "English (US)", "Spanish", etc.

targetable

boolean

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
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the location view. Location view resource names have the form:

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ManagedPlacementView

A managed placement view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the Managed Placement view. Managed placement view resource names have the form:

customers/{customerId}/managedPlacementViews/{adGroupId}~{criterionId}

MobileAppCategoryConstant

A mobile application category constant.

نمایندگی JSON
{
  "resourceName": string,
  "id": integer,
  "name": string
}
زمینه های
resourceName

string

Output only. The resource name of the mobile app category constant. Mobile app category constant resource names have the form:

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

Output only. The ID of the mobile app category constant.

name

string

Output only. Mobile app category name.

MobileDeviceConstant

A mobile device constant.

نمایندگی JSON
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
زمینه های
resourceName

string

Output only. The resource name of the mobile device constant. Mobile device constant resource names have the form:

mobileDeviceConstants/{criterionId}

type

enum ( MobileDeviceType )

Output only. The type of mobile device.

id

string ( int64 format)

Output only. The ID of the mobile device constant.

name

string

Output only. The name of the mobile device.

manufacturerName

string

Output only. The manufacturer of the mobile device.

operatingSystemName

string

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 تلفن های همراه.
TABLET قرص.

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
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
زمینه های
resourceName

string

Output only. The resource name of the operating system version constant. Operating system version constant resource names have the form:

operatingSystemVersionConstants/{criterionId}

operatorType

enum ( OperatingSystemVersionOperatorType )

Output only. Determines whether this constant represents a single version or a range of versions.

id

string ( int64 format)

Output only. The ID of the operating system version.

name

string

Output only. Name of the operating system.

osMajorVersion

integer

Output only. The OS Major Version number.

osMinorVersion

integer

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
{
  "resourceName": string,
  "searchTerm": string
}
زمینه های
resourceName

string

Output only. The resource name of the search term view. Search term view resource names have the form:

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}

searchTerm

string

Output only. The search term.

QualifyingQuestion

Qualifying Questions for Lead Form.

نمایندگی JSON
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
زمینه های
resourceName

string

Output only. The resource name of the qualifying question.

'qualifyingQuestions/{qualifyingQuestionId}'

qualifyingQuestionId

string ( int64 format)

Output only. The id of the qualifying question.

locale

string

Output only. The locale of the qualifying question.

text

string

Output only. The qualifying question.

ParentalStatusView

A parental status view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the parental status view. Parental Status view resource names have the form:

customers/{customerId}/parentalStatusViews/{adGroupId}~{criterionId}

PerStoreView

A per store view. This view provides per store impression reach and local action conversion stats for advertisers.

نمایندگی JSON
{
  "resourceName": string,
  "placeId": string
}
زمینه های
resourceName

string

Output only. The resource name of the per store view. Per Store view resource names have the form:

customers/{customerId}/perStoreViews/{placeId}

placeId

string

Output only. The place ID of the per store view.

ProductBiddingCategoryConstant

A Product Bidding Category.

نمایندگی JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
زمینه های
resourceName

string

Output only. The resource name of the product bidding category. Product bidding category resource names have the form:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum ( ProductBiddingCategoryLevel )

Output only. Level of the product bidding category.

status

enum ( ProductBiddingCategoryStatus )

Output only. Status of the product bidding category.

id

string ( int64 format)

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

string

Output only. Two-letter upper-case country code of the product bidding category.

productBiddingCategoryConstantParent

string

Output only. Resource name of the parent product bidding category.

languageCode

string

Output only. Language code of the product bidding category.

localizedName

string

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
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the product group view. Product group view resource names have the form:

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

توصیه

یک توصیه

نمایندگی JSON
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
زمینه های
resourceName

string

Immutable. The resource name of the recommendation.

customers/{customerId}/recommendations/{recommendation_id}

type

enum ( RecommendationType )

Output only. The type of recommendation.

impact

object ( RecommendationImpact )

Output only. The impact on account performance as a result of applying the recommendation.

campaigns[]

string

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

string

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

string

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

string

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

boolean

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

object ( CampaignBudgetRecommendation )

Output only. The campaign budget recommendation.

forecastingCampaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The forecasting campaign budget recommendation.

keywordRecommendation

object ( KeywordRecommendation )

Output only. The keyword recommendation.

textAdRecommendation

object ( TextAdRecommendation )

Output only. Add expanded text ad recommendation.

targetCpaOptInRecommendation

object ( TargetCpaOptInRecommendation )

Output only. The TargetCPA opt-in recommendation.

maximizeConversionsOptInRecommendation

object ( MaximizeConversionsOptInRecommendation )

Output only. The MaximizeConversions Opt-In recommendation.

enhancedCpcOptInRecommendation

object ( EnhancedCpcOptInRecommendation )

Output only. The Enhanced Cost-Per-Click Opt-In recommendation.

searchPartnersOptInRecommendation

object ( SearchPartnersOptInRecommendation )

Output only. The Search Partners Opt-In recommendation.

maximizeClicksOptInRecommendation

object ( MaximizeClicksOptInRecommendation )

Output only. The MaximizeClicks Opt-In recommendation.

optimizeAdRotationRecommendation

object ( OptimizeAdRotationRecommendation )

Output only. The Optimize Ad Rotation recommendation.

keywordMatchTypeRecommendation

object ( KeywordMatchTypeRecommendation )

Output only. The keyword match type recommendation.

moveUnusedBudgetRecommendation

object ( MoveUnusedBudgetRecommendation )

Output only. The move unused budget recommendation.

targetRoasOptInRecommendation

object ( TargetRoasOptInRecommendation )

Output only. The Target ROAS opt-in recommendation.

responsiveSearchAdRecommendation

object ( ResponsiveSearchAdRecommendation )

Output only. The add responsive search ad recommendation.

marginalRoiCampaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The marginal ROI campaign budget recommendation.

useBroadMatchKeywordRecommendation

object ( UseBroadMatchKeywordRecommendation )

Output only. The use broad match keyword recommendation.

responsiveSearchAdAssetRecommendation

object ( ResponsiveSearchAdAssetRecommendation )

Output only. The responsive search ad asset recommendation.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object ( UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation )

Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.

responsiveSearchAdImproveAdStrengthRecommendation

object ( ResponsiveSearchAdImproveAdStrengthRecommendation )

Output only. The responsive search ad improve ad strength recommendation.

displayExpansionOptInRecommendation

object ( DisplayExpansionOptInRecommendation )

Output only. The Display Expansion opt-in recommendation.

upgradeLocalCampaignToPerformanceMaxRecommendation

object ( UpgradeLocalCampaignToPerformanceMaxRecommendation )

Output only. The upgrade a Local campaign to a Performance Max campaign recommendation.

raiseTargetCpaBidTooLowRecommendation

object ( RaiseTargetCpaBidTooLowRecommendation )

Output only. The raise target CPA bid too low recommendation.

forecastingSetTargetRoasRecommendation

object ( ForecastingSetTargetRoasRecommendation )

Output only. The forecasting set target ROAS recommendation.

calloutAssetRecommendation

object ( CalloutAssetRecommendation )

Output only. The callout asset recommendation.

callAssetRecommendation

object ( CallAssetRecommendation )

Output only. The call asset recommendation.

shoppingAddAgeGroupRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add age group recommendation.

shoppingAddColorRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add color recommendation.

shoppingAddGenderRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add gender recommendation.

shoppingAddGtinRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add GTIN recommendation.

shoppingAddMoreIdentifiersRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add more identifiers recommendation.

shoppingAddSizeRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add size recommendation.

shoppingAddProductsToCampaignRecommendation

object ( ShoppingAddProductsToCampaignRecommendation )

Output only. The shopping add products to campaign recommendation.

shoppingFixDisapprovedProductsRecommendation

object ( ShoppingFixDisapprovedProductsRecommendation )

Output only. The shopping fix disapproved products recommendation.

shoppingTargetAllOffersRecommendation

object ( ShoppingTargetAllOffersRecommendation )

Output only. The shopping target all offers recommendation.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

Output only. The shopping fix suspended Merchant Center account recommendation.

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

Output only. The shopping fix Merchant Center account suspension warning recommendation.

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object ( ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation )

Output only. The shopping migrate Regular Shopping Campaign offers to Performance Max recommendation.

dynamicImageExtensionOptInRecommendation

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

object ( RaiseTargetCpaRecommendation )

Output only. Recommendation to raise Target CPA.

lowerTargetRoasRecommendation

object ( LowerTargetRoasRecommendation )

Output only. Recommendation to lower Target ROAS.

performanceMaxOptInRecommendation

object ( PerformanceMaxOptInRecommendation )

Output only. The Performance Max Opt In recommendation.

improvePerformanceMaxAdStrengthRecommendation

object ( ImprovePerformanceMaxAdStrengthRecommendation )

Output only. The improve Performance Max ad strength recommendation.

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object ( 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.
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
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
زمینه های
baseMetrics

object ( RecommendationMetrics )

Output only. Base metrics at the time the recommendation was generated.

potentialMetrics

object ( RecommendationMetrics )

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
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
زمینه های
impressions

number

Output only. Number of ad impressions.

clicks

number

Output only. Number of ad clicks.

costMicros

string ( int64 format)

Output only. Cost (in micros) for advertising, in the local currency for the account.

conversions

number

Output only. Number of conversions.

videoViews

number

Output only. Number of video views for a video ad campaign.

CampaignBudgetRecommendation

The budget recommendation for budget constrained campaigns.

نمایندگی JSON
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
زمینه های
budgetOptions[]

object ( CampaignBudgetRecommendationOption )

Output only. The budget amounts and associated impact estimates for some values of possible budget amounts.

currentBudgetAmountMicros

string ( int64 format)

Output only. The current budget amount in micros.

recommendedBudgetAmountMicros

string ( int64 format)

Output only. The recommended budget amount in micros.

CampaignBudgetRecommendationOption

The impact estimates for a given budget amount.

نمایندگی JSON
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
زمینه های
impact

object ( RecommendationImpact )

Output only. The impact estimate if budget is changed to amount specified in this option.

budgetAmountMicros

string ( int64 format)

Output only. The budget amount for this option.

KeywordRecommendation

The keyword recommendation.

نمایندگی JSON
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
زمینه های
keyword

object ( KeywordInfo )

Output only. The recommended keyword.

searchTerms[]

object ( SearchTerm )

Output only. A list of search terms this keyword matches. The same search term may be repeated for multiple keywords.

recommendedCpcBidMicros

string ( int64 format)

Output only. The recommended CPC (cost-per-click) bid.

SearchTerm

Information about a search term as related to a keyword recommendation.

نمایندگی JSON
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
زمینه های
text

string

Output only. The text of the search term.

estimatedWeeklySearchCount

string ( int64 format)

Output only. Estimated number of historical weekly searches for this search term.

TextAdRecommendation

The text ad recommendation.

نمایندگی JSON
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
زمینه های
ad

object ( Ad )

Output only. Recommended ad.

creationDate

string

Output only. Creation date of the recommended ad. YYYY-MM-DD format, for example, 2018-04-17.

autoApplyDate

string

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
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
زمینه های
options[]

object ( TargetCpaOptInRecommendationOption )

Output only. The available goals and corresponding options for Target CPA strategy.

recommendedTargetCpaMicros

string ( int64 format)

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
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
زمینه های
goal

enum ( TargetCpaOptInRecommendationGoal )

Output only. The goal achieved by this option.

impact

object ( RecommendationImpact )

Output only. The impact estimate if this option is selected.

targetCpaMicros

string ( int64 format)

Output only. Average CPA target.

requiredCampaignBudgetAmountMicros

string ( int64 format)

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
{
  "recommendedBudgetAmountMicros": string
}
زمینه های
recommendedBudgetAmountMicros

string ( int64 format)

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
{
  "recommendedBudgetAmountMicros": string
}
زمینه های
recommendedBudgetAmountMicros

string ( int64 format)

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
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
زمینه های
keyword

object ( KeywordInfo )

Output only. The existing keyword where the match type should be more broad.

recommendedMatchType

enum ( KeywordMatchType )

Output only. The recommended new match type.

MoveUnusedBudgetRecommendation

The move unused budget recommendation.

نمایندگی JSON
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
زمینه های
budgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The recommendation for the constrained budget to increase.

excessCampaignBudget

string

Output only. The excess budget's resourceName.

TargetRoasOptInRecommendation

The Target ROAS opt-in recommendation.

نمایندگی JSON
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
زمینه های
recommendedTargetRoas

number

Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive.

requiredCampaignBudgetAmountMicros

string ( int64 format)

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
{
  "ad": {
    object (Ad)
  }
}
زمینه های
ad

object ( Ad )

Output only. Recommended ad.

UseBroadMatchKeywordRecommendation

The use broad match keyword recommendation.

نمایندگی JSON
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
زمینه های
keyword[]

object ( KeywordInfo )

Output only. Sample of keywords to be expanded to Broad Match.

suggestedKeywordsCount

string ( int64 format)

Output only. Total number of keywords to be expanded to Broad Match in the campaign.

campaignKeywordsCount

string ( int64 format)

Output only. Total number of keywords in the campaign.

campaignUsesSharedBudget

boolean

Output only. Whether the associated campaign uses a shared budget.

requiredCampaignBudgetAmountMicros

string ( int64 format)

Output only. The budget recommended to avoid becoming budget constrained after applying the recommendation.

ResponsiveSearchAdAssetRecommendation

The add responsive search ad asset recommendation.

نمایندگی JSON
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
زمینه های
currentAd

object ( Ad )

Output only. The current ad to be updated.

recommendedAssets

object ( Ad )

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
{
  "merchantId": string,
  "salesCountryCode": string
}
زمینه های
merchantId

string ( int64 format)

Output only. ID of Merchant Center account.

salesCountryCode

string

Output only. Country whose products from merchant's inventory should be included.

ResponsiveSearchAdImproveAdStrengthRecommendation

The responsive search ad improve ad strength recommendation.

نمایندگی JSON
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
زمینه های
currentAd

object ( Ad )

Output only. The current ad to be updated.

recommendedAd

object ( Ad )

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
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
زمینه های
recommendedTargetMultiplier

number

Output only. A number greater than 1.0 indicating the factor by which we recommend the target CPA should be increased.

averageTargetCpaMicros

string ( int64 format)

Output only. The current average target CPA of the campaign, in micros of customer local currency.

ForecastingSetTargetRoasRecommendation

The forecasting set target ROAS recommendation.

نمایندگی JSON
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
زمینه های
recommendedTargetRoas

number

Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive.

campaignBudget

object ( CampaignBudget )

Output only. The campaign budget.

CampaignBudget

A campaign budget shared amongst various budget recommendation types.

نمایندگی JSON
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
زمینه های
currentAmountMicros

string ( int64 format)

Output only. Current budget amount.

recommendedNewAmountMicros

string ( int64 format)

Output only. Recommended budget amount.

newStartDate

string

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
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
زمینه های
recommendedCampaignCalloutAssets[]

object ( Asset )

Output only. New callout extension assets recommended at the campaign level.

recommendedCustomerCalloutAssets[]

object ( Asset )

Output only. New callout extension assets recommended at the customer level.

SitelinkAssetRecommendation

The sitelink asset recommendation.

نمایندگی JSON
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
زمینه های

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
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
زمینه های
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The campaign feed label.

offersCount

string ( int64 format)

Output only. The number of online, servable offers.

demotedOffersCount

string ( int64 format)

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
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
زمینه های
id

string ( int64 format)

Output only. The Merchant Center account ID.

name

string

Output only. The name of the Merchant Center account.

multiClient

boolean

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
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
زمینه های
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label for the campaign.

reason

enum ( Reason )

Output only. The reason why no products are attached to the campaign.

دلیل

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
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
زمینه های
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label for the campaign.

productsCount

string ( int64 format)

Output only. The number of products of the campaign.

disapprovedProductsCount

string ( int64 format)

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
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
زمینه های
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

untargetedOffersCount

string ( int64 format)

Output only. The number of untargeted offers.

feedLabel

string

Output only. The offer feed label.

ShoppingMerchantCenterAccountSuspensionRecommendation

The shopping recommendation to fix Merchant Center account suspension issues.

نمایندگی JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
زمینه های
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

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
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
زمینه های
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

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
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
زمینه های
targetAdjustment

object ( TargetAdjustmentInfo )

Output only. The relevant information describing the recommended target adjustment.

appBiddingGoal

enum ( 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
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
زمینه های
recommendedTargetMultiplier

number

Output only. The factor by which we recommend the target to be adjusted by.

currentAverageTargetMicros

string ( int64 format)

Output only. The current average target of the campaign or portfolio targeted by this recommendation.

sharedSet

string

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
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
زمینه های
targetAdjustment

object ( TargetAdjustmentInfo )

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
{
  "assetGroup": string
}
زمینه های
assetGroup

string

Output only. The asset group resource name.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

The Dynamic Search Ads to Performance Max migration recommendation.

نمایندگی JSON
{
  "applyLink": string
}
زمینه های

SearchTermView

A search term view with metrics aggregated by search term at the ad group level.

نمایندگی JSON
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
زمینه های
resourceName

string

Output only. The resource name of the search term view. Search term view resource names have the form:

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}

status

enum ( SearchTermTargetingStatus )

Output only. Indicates whether the search term is currently one of your targeted or excluded keywords.

searchTerm

string

Output only. The search term.

adGroup

string

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
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

A Smart campaign search term view.

نمایندگی JSON
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
زمینه های
resourceName

string

Output only. The resource name of the Smart campaign search term view. Smart campaign search term view resource names have the form:

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}

searchTerm

string

Output only. The search term.

campaign

string

Output only. The Smart campaign the search term served in.

TopicView

A topic view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the topic view. Topic view resource names have the form:

customers/{customerId}/topicViews/{adGroupId}~{criterionId}

TravelActivityGroupView

A travel activity group view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the travel activity group view. Travel Activity Group view resource names have the form:

customers/{customerId}/travelActivityGroupViews/{adGroupId}~{criterionId}

TravelActivityPerformanceView

A travel activity performance view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form:

customers/{customerId}/travelActivityPerformanceView

UserInterest

A user interest: a particular interest-based vertical to be targeted.

نمایندگی JSON
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
زمینه های
resourceName

string

Output only. The resource name of the user interest. User interest resource names have the form:

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum ( UserInterestTaxonomyType )

Output only. Taxonomy type of the user interest.

availabilities[]

object ( CriterionCategoryAvailability )

Output only. Availability information of the user interest.

userInterestId

string ( int64 format)

Output only. The ID of the user interest.

name

string

Output only. The name of the user interest.

userInterestParent

string

Output only. The parent of the user interest.

launchedToAll

boolean

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
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
زمینه های
resourceName

string

Output only. The resource name of the life event. Life event resource names have the form:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string ( int64 format)

Output only. The ID of the life event.

name

string

Output only. The name of the life event, for example,"Recently Moved"

parent

string

Output only. The parent of the lifeEvent.

launchedToAll

boolean

Output only. True if the life event is launched to all channels and locales.

availabilities[]

object ( CriterionCategoryAvailability )

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
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
زمینه های
resourceName

string

Output only. The resource name of the user location view. UserLocation view resource names have the form:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string ( int64 format)

Output only. Criterion Id for the country.

targetingLocation

boolean

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
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
زمینه های
resourceName

string

Output only. The resource name of the topic constant. topic constant resource names have the form:

topicConstants/{topic_id}

path[]

string

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

string ( int64 format)

Output only. The ID of the topic.

topicConstantParent

string

Output only. Resource name of parent of the topic constant.

ویدئو

A video.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
زمینه های
resourceName

string

Output only. The resource name of the video. Video resource names have the form:

customers/{customerId}/videos/{videoId}

id

string

Output only. The ID of the video.

channelId

string

Output only. The owner channel id of the video.

durationMillis

string ( int64 format)

Output only. The duration of the video in milliseconds.

title

string

Output only. The title of the video.

WebpageView

A webpage view.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

Output only. The resource name of the webpage view. Webpage view resource names have the form:

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

LeadFormSubmissionData

Data from lead form submissions.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
زمینه های
resourceName

string

Output only. The resource name of the lead form submission data. Lead form submission data resource names have the form:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

Output only. ID of this lead form submission.

asset

string

Output only. Asset associated with the submitted lead form.

campaign

string

Output only. Campaign associated with the submitted lead form.

leadFormSubmissionFields[]

object ( LeadFormSubmissionField )

Output only. Submission data associated with a lead form.

customLeadFormSubmissionFields[]

object ( CustomLeadFormSubmissionField )

Output only. Submission data associated with a custom lead form.

adGroup

string

Output only. AdGroup associated with the submitted lead form.

adGroupAd

string

Output only. AdGroupAd associated with the submitted lead form.

gclid

string

Output only. Google Click Id associated with the submissed lead form.

submissionDateTime

string

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
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
زمینه های
fieldType

enum ( LeadFormFieldUserInputType )

Output only. Field type for lead form fields.

fieldValue

string

Output only. Field value for lead form fields.

CustomLeadFormSubmissionField

Fields in the submitted custom question

نمایندگی JSON
{
  "questionText": string,
  "fieldValue": string
}
زمینه های
questionText

string

Output only. Question text for custom question, maximum number of characters is 300.

fieldValue

string

Output only. Field value for custom question response, maximum number of characters is 70.

معیارهای

Metrics data.

نمایندگی JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": 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,
  "newCustomerLifetimeValue": 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,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": 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,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "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,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "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,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number
}
زمینه های
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.

publisherPurchasedClicks

string ( int64 format)

Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity

publisherOrganicClicks

string ( int64 format)

Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity

publisherUnknownClicks

string ( int64 format)

Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic"

absoluteTopImpressionPercentage

number

Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.

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

allNewCustomerLifetimeValue

number

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

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.

auctionInsightSearchAbsoluteTopImpressionPercentage

number

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

number

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

number

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

number

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

number

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

number

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

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.

biddableAppInstallConversions

number

Number of app installs.

biddableAppPostInstallConversions

number

Number of in-app actions.

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

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.

newCustomerLifetimeValue

number

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

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.

hotelCommissionRateMicros

string ( int64 format)

Commission bid rate in micros. A 20% commission is represented as 200,000.

hotelExpectedCommissionCost

number

Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency.

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.

optimizationScoreUplift

number

Total optimization score uplift of all recommendations.

optimizationScoreUrl

string

URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign , and can be segmented by segments.recommendation_type . For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendationType) combination.

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

object ( SearchVolumeRange )

Search volume range for a search term insight category.

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.

averageTargetCpaMicros

string ( int64 format)

The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA).

averageTargetRoas

number

The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS).

topImpressionPercentage

number

The percent of your ad impressions that are shown adjacent to the top 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 (for example, clicking on) another ad.

allConversionsFromLocationAssetClickToCall

number

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

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

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

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

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

number

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

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

string ( int64 format)

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

Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetDirections

number

Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetMenu

number

Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetOrder

number

Number of order clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetOtherEngagement

number

Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetStoreVisits

number

Estimated number of visits to the store after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetWebsite

number

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
{
  "min": string,
  "max": string
}
زمینه های
min

string ( int64 format)

Lower bound of search volume.

max

string ( int64 format)

Upper bound of search volume.

بخش ها

Segment only fields.

نمایندگی JSON
{
  "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),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "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,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
زمینه های
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, for example, 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, for example, 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.

recommendationType

enum ( RecommendationType )

Recommendation type.

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.

conversionValueRulePrimaryDimension

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

enum ( SkAdNetworkUserType )

iOS Store Kit Ad Network user type.

skAdNetworkAdEventType

enum ( SkAdNetworkAdEventType )

iOS Store Kit Ad Network ad event type.

skAdNetworkAttributionCredit

enum ( SkAdNetworkAttributionCredit )

iOS Store Kit Ad Network attribution credit

newVersusReturningCustomers

enum ( ConvertingUserPriorEngagementTypeAndLtvBucket )

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

string ( int64 format)

Activity account ID.

activityRating

string ( int64 format)

Activity rating.

externalActivityId

string

Advertiser supplied activity ID.

adGroup

string

Resource name of the ad group.

assetGroup

string

Resource name of the asset group.

auctionInsightDomain

string

Domain (visible URL) of a participant in the Auction Insights report.

campaign

string

Resource name of the campaign.

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

string

Date to which metrics apply. yyyy-MM-dd format, for example, 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.

productFeedLabel

string

Feed label 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

searchSubcategory

string

A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory.

searchTerm

string

A search term.

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, for example, non-iOS campaign.

skAdNetworkSourceApp

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

object ( 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 سایت اینترنتی
APP_STORE iOS App Store or Play Store
PHONE_CALL Call Dialer
MAP_DIRECTIONS Map App
LOCATION_LISTING Location Dedicated Page
MESSAGE پیام متنی
LEAD_FORM Lead Generation Form
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 جستجوی گوگل.
SEARCH_PARTNERS Search partners.
CONTENT Display Network.
YOUTUBE_WATCH ویدئوهای یوتیوب
MIXED Cross-network.

BudgetCampaignAssociationStatus

A BudgetCampaignAssociationStatus segment.

نمایندگی JSON
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
زمینه های
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 پودرهای سوخاری.
BROADBAND_PLAN Broadband Plan.
CALL_TRACKING Manually dialed phone calls.
CALLS تماس های تلفنی.
CLICK_ON_ENGAGEMENT_AD Click on engagement ad.
GET_DIRECTIONS Driving direction.
LOCATION_EXPANSION Get location details.
LOCATION_FORMAT_CALL زنگ زدن.
LOCATION_FORMAT_DIRECTIONS جهت ها.
LOCATION_FORMAT_IMAGE تصاویر).
LOCATION_FORMAT_LANDING_PAGE Go to landing page.
LOCATION_FORMAT_MAP نقشه.
LOCATION_FORMAT_STORE_INFO Go to store info.
LOCATION_FORMAT_TEXT متن
MOBILE_CALL_TRACKING Mobile phone calls.
OFFER_PRINTS Print offer.
OTHER دیگر.
PRODUCT_EXTENSION_CLICKS Product plusbox offer.
PRODUCT_LISTING_AD_CLICKS Shopping - Product - Online.
STORE_LOCATOR Show nearby locations.
URL_CLICKS عنوان.
VIDEO_APP_STORE_CLICKS فروشگاه اپلیکیشن.
VIDEO_CALL_TO_ACTION_CLICKS Call-to-Action overlay.
VIDEO_CARD_ACTION_HEADLINE_CLICKS Cards.
VIDEO_END_CAP_CLICKS End cap.
VIDEO_WEBSITE_CLICKS سایت اینترنتی.
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.
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.

کلمه کلیدی

A Keyword criterion segment.

نمایندگی JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
زمینه های
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 مطابقت کامل.
PHRASE Phrase match.
NEAR_EXACT Exact match (close variant).
NEAR_PHRASE Phrase match (close variant).

اسلات

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
{
  "skAdNetworkSourceAppId": string
}
زمینه های
skAdNetworkSourceAppId

string

App id where the ad that drove the iOS Store Kit Ad Network install was shown.

SkAdNetworkAttributionCredit

Enumerates SkAdNetwork attribution credits.

Enums
UNSPECIFIED مقدار پیش فرض. 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
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
زمینه های
asset

string

The asset resource name.

interactionOnThisAsset

boolean

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.