- نمایندگی JSON
- بودجه حساب
- AccountBudgetStatus
- در حال انتظار حساب بودجه
- AdGroupAdAssetCombinationView
- AssetUsage
- AdGroupAdAssetView
- AdGroupAdAssetPolicySummary
- AdGroupAudienceView
- AdGroupCriterionSimulation
- نوع شبیه سازی
- SimulationModification Method
- CpcBidSimulationPointList
- CpcBidSimulationPoint
- PercentCpcBidSimulationPointList
- PercentCpcBidSimulationPoint
- AdGroupSimulation
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- AgeRangeView
- AdScheduleView
- دسته دامنه
- AssetFieldTypeView
- AssetGroupProductGroupView
- AssetSetTypeView
- شبیه سازی استراتژی مناقصه
- CallView
- CallTrackingDisplayLocation
- نوع تماس
- GoogleVoiceCallStatus
- CampaignAudienceView
- CampaignSearchTermInsight
- شبیه سازی کمپین
- TargetImpressionShareSimulationPointList
- TargetImpressionShareSimulationPoint
- BudgetSimulationPointList
- BudgetSimulationPoint
- CarrierConstant
- ChangeEvent
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
- ResourceChangeOperation
- تغییر وضعیت
- ChangeStatusResourceType
- ChangeStatusOperation
- مخاطب ترکیبی
- CombinedAudienceStatus
- مشاهده کلیک کنید
- مکان کلیک کنید
- ارز ثابت
- Accessible Bidding Strategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- مشتری مشتری
- CustomerSearchTermInsight
- DetailPlacementView
- نوع قرارگیری
- اطلاعات جمعیتی
- CriterionCategoryAvailability
- CriterionCategoryChannelAvailability
- CriterionCategoryChannelModeAvailabilityMode
- CriterionCategoryLocaleAvailability
- CriterionCategoryLocaleAvailabilityMode
- DisplayKeywordView
- DistanceView
- DistanceBucket
- DynamicSearchAdsSearchTermView
- ExpandedLandingPageView
- FeedPlaceholderView
- GenderView
- GeographicView
- GeoTargeting Type
- GroupPlacementView
- HotelGroupView
- HotelPerformanceView
- آشتی هتل
- وضعیت آشتی هتل
- IncomeRangeView
- KeywordView
- LandingPageView
- LanguageConstant
- LocationView
- ManagedPlacementView
- MobileAppCategoryConstant
- MobileDeviceConstant
- نوع دستگاه موبایل
- OperatingSystemVersionConstant
- OperatingSystemVersionOperatorType
- PaidOrganicSearchTermView
- Qualifying Question
- ParentalStatusView
- PerStoreView
- Product BiddingCategoryConstant
- Product BiddingCategoryStatus
- ProductGroupView
- توصیه
- نوع توصیه
- تاثیر توصیه
- توصیه متریک
- CampaignBudgetRecommendation
- CampaignBudgetRecommendationOption
- کلید واژه توصیه
- مدت جستجو
- TextAdRecommendation
- TargetCpaOptInRecommendation
- TargetCpaOptInRecommendationOption
- TargetCpaOptInRecommendationGoal
- MaximizeConversionsOptInRecommendation
- EnhancedCpcOptInRecommendation
- SearchPartnersOptInRecommendation
- MaximizeClicksOptInRecommendation
- OptimizeAdRotationRecommendation
- KeywordMatchTypeRecommendation
- MoveUnusedBudgetRecommendation
- TargetRoasOptInRecommendation
- ResponsiveSearchAdRecommendation
- UseBroadMatchKeywordRecommendation
- ResponsiveSearchAdAssetRecommendation
- UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
- ResponsiveSearchAdImproveAdStrengthRecommendation
- DisplayExpansionOptInRecommendation
- UpgradeLocalCampaignToPerformanceMaxRecommendation
- RaiseTargetCpaBidTooLowRecommendation
- ForecastingSetTargetRoasRecommendation
- بودجه کمپین
- CalloutAssetRecommendation
- SitelinkAssetRecommendation
- CallAssetRecommendation
- ShoppingOfferAttributeRecommendation
- MerchantInfo
- خرید افزودن محصولات به توصیه کمپین
- دلیل
- ShoppingFixDisapprovedProductsRecommendation
- ShoppingTargetAllOffersRecommendation
- ShoppingMerchantCenterAccountSuspensionRecommendation
- ShoppingMigrateRegularShopping CampaignOffersTo PerformanceMaxRecommendation
- DynamicImageExtensionOptInRecommendation
- RaiseTargetCpaRecommendation
- TargetAdjustmentInfo
- AppBiddingGoal
- LowerTargetRoasRecommendation
- PerformanceMaxOptInRecommendation
- ImprovePerformanceMaxAdStrengthRecommendation
- MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
- SearchTermView
- SearchTermTargetingStatus
- ShoppingPerformanceView
- SmartCampaignSearchTermView
- ThirdPartyAppAnalytics Link
- TopicView
- TravelActivityGroupView
- TravelActivityPerformanceView
- علاقه کاربر
- UserInterestTaxonomyType
- LifeEvent
- UserLocationView
- موضوع ثابت
- ویدئو
- مشاهده وب سایت
- LeadFormSubmissionData
- LeadFormSubmissionField
- CustomLeadFormSubmissionField
- معیارهای
- InteractionEventType
- Search VolumeRange
- بخش ها
- AdDestinationType
- AdNetworkType
- BudgetCampaignAssociationStatus
- BudgetCampaignAssociationStatus
- تایپ کلیک کنید
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- کلمه کلیدی
- SearchEngine ResultsPageType
- SearchTermMatchType
- اسلات
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- SkAdNetworkAdEventType
- SkAdNetworkSourceApp
- SkAdNetworkAttributionCredit
- AssetInteractionTarget
- ConvertingUserPriorEngagementTypeAndLtvBucket
یک ردیف برگشتی از پرس و جو.
نمایندگی JSON |
---|
{ "accountBudget": { object ( |
زمینه های | |
---|---|
accountBudget | بودجه حساب در پرس و جو. |
accountBudgetProposal | پیشنهاد بودجه حساب که در پرس و جو اشاره شده است. |
accountLink | AccountLink اشاره شده در پرس و جو. |
adGroup | گروه تبلیغاتی مورد اشاره در پرس و جو. |
adGroupAd | آگهی اشاره شده در پرس و جو. |
adGroupAdAssetCombinationView | نمای ترکیبی دارایی آگهی گروه آگهی در جستار. |
adGroupAdAssetView | نمای دارایی آگهی گروه آگهی در جستار. |
adGroupAdLabel | برچسب آگهی گروه تبلیغاتی که در پرس و جو ارجاع داده شده است. |
adGroupAsset | دارایی گروه تبلیغاتی که در پرس و جو به آن اشاره شده است. |
adGroupAssetSet | مجموعه دارایی گروه تبلیغاتی که در جستار به آن اشاره شده است. |
adGroupAudienceView | نمای مخاطب گروه تبلیغاتی که در پرس و جو به آن اشاره شده است. |
adGroupBidModifier | اصلاح کننده قیمت پیشنهادی که در پرس و جو به آن اشاره شده است. |
adGroupCriterion | معیاری که در پرس و جو به آن اشاره شده است. |
adGroupCriterionCustomizer | سفارشیکننده معیار گروه آگهی که در جستار به آن اشاره شده است. |
adGroupCriterionLabel | برچسب معیار گروه آگهی که در پرس و جو ارجاع داده شده است. |
adGroupCriterionSimulation | شبیه سازی معیار گروه آگهی که در پرس و جو ارجاع شده است. |
adGroupCustomizer | سفارشیساز گروه تبلیغاتی که در جستار به آن اشاره شده است. |
adGroupExtensionSetting | تنظیم برنامه افزودنی گروه تبلیغاتی که در پرس و جو به آن اشاره شده است. |
adGroupFeed | فید گروه تبلیغاتی که در پرس و جو به آن اشاره شده است. |
adGroupLabel | برچسب گروه تبلیغاتی که در پرس و جو ارجاع داده شده است. |
adGroupSimulation | شبیه سازی گروه تبلیغاتی که در پرس و جو ارجاع داده شده است. |
adParameter | پارامتر تبلیغی که در پرس و جو به آن اشاره شده است. |
ageRangeView | نمای محدوده سنی اشاره شده در پرس و جو. |
adScheduleView | نمای برنامه زمانی آگهی که در پرس و جو به آن اشاره شده است. |
domainCategory | دسته دامنه مورد اشاره در پرس و جو. |
asset | دارایی مورد اشاره در پرس و جو. |
assetFieldTypeView | نمای نوع فیلد دارایی که در پرس و جو ارجاع داده شده است. |
assetGroupAsset | دارایی گروه دارایی که در پرس و جو به آن اشاره شده است. |
assetGroupSignal | سیگنال گروه دارایی که در پرس و جو ارجاع داده شده است. |
assetGroupListingGroupFilter | فیلتر گروه فهرست گروه دارایی که در جستار به آن ارجاع داده شده است. |
assetGroupProductGroupView | نمای گروه محصول گروه دارایی که در پرس و جو اشاره شده است. |
assetGroup | گروه دارایی مورد اشاره در جستار. |
assetSetAsset | دارایی مجموعه دارایی که در پرس و جو به آن اشاره شده است. |
assetSet | مجموعه دارایی مورد اشاره در پرس و جو. |
assetSetTypeView | نمای نوع مجموعه دارایی که در پرس و جو ارجاع شده است. |
batchJob | کار دسته ای که در پرس و جو به آن اشاره شده است. |
biddingDataExclusion | استثنای داده های مناقصه که در پرس و جو به آن اشاره شده است. |
biddingSeasonalityAdjustment | تعدیل فصلی مناقصه اشاره شده در پرس و جو. |
biddingStrategy | استراتژی مناقصه اشاره شده در پرس و جو. |
biddingStrategySimulation | شبیه سازی استراتژی مناقصه که در پرس و جو ارجاع شده است. |
billingSetup | راهاندازی صورتحساب به آن اشاره شده است. |
callView | نمای تماس اشاره شده در پرس و جو. |
campaignBudget | بودجه کمپین اشاره شده در پرس و جو. |
campaign | کمپین مورد اشاره در پرس و جو. |
campaignAsset | دارایی کمپین اشاره شده در جستار. |
campaignAssetSet | مجموعه دارایی کمپین که در پرس و جو ارجاع داده شده است. |
campaignAudienceView | نمای مخاطب کمپین که در پرس و جو به آن اشاره شده است. |
campaignBidModifier | اصلاح کننده پیشنهاد کمپین که در پرس و جو به آن اشاره شده است. |
campaignConversionGoal | CampaignConversionGoal در پرس و جو ارجاع داده شد. |
campaignCriterion | معیار کمپین مورد اشاره در پرس و جو. |
campaignCustomizer | سفارشیساز کمپین که در جستار به آن اشاره شده است. |
campaignDraft | پیشنویس کمپین که در جستار به آن اشاره شده است. |
campaignExtensionSetting | تنظیم برنامه افزودنی کمپین که در پرس و جو به آن اشاره شده است. |
campaignFeed | فید کمپین اشاره شده در پرس و جو. |
campaignGroup | گروه کمپین در پرس و جوی AWQL ارجاع داده شد. |
campaignLabel | برچسب کمپین مورد اشاره در پرس و جو. |
campaignSearchTermInsight | عبارت جستجوی کمپین بینش اشاره شده در جستار. |
campaignSharedSet | مجموعه اشتراکگذاری شده کمپین در جستار AWQL ارجاع شده است. |
campaignSimulation | شبیه سازی کمپین که در پرس و جو به آن اشاره شده است. |
carrierConstant | ثابت حاملی که در پرس و جو ارجاع داده شده است. |
changeEvent | ChangeEvent در پرس و جو ارجاع داده شد. |
changeStatus | ChangeStatus اشاره شده در پرس و جو. |
combinedAudience | CombinedAudience در پرس و جو ارجاع داده شد. |
audience | مخاطبی که در پرس و جو به آن اشاره شده است. |
conversionAction | عمل تبدیلی که در پرس و جو به آن اشاره شده است. |
conversionCustomVariable | متغیر سفارشی تبدیل که در پرس و جو ارجاع داده شده است. |
conversionGoalCampaignConfig | ConversionGoalCampaignConfig در پرس و جو ارجاع داده شده است. |
conversionValueRule | قانون ارزش تبدیلی که در پرس و جو ارجاع داده شده است. |
conversionValueRuleSet | مجموعه قانون ارزش تبدیلی که در پرس و جو ارجاع شده است. |
clickView | ClickView در پرس و جو ارجاع داده شد. |
currencyConstant | ثابت واحد پولی که در پرس و جو به آن اشاره شده است. |
customAudience | مخاطب سفارشی که در پرس و جو به آن اشاره شده است. |
customConversionGoal | CustomConversionGoal اشاره شده در پرس و جو. |
customInterest | CustomInterest اشاره شده در پرس و جو. |
customer | مشتری در پرس و جو به آن اشاره کرد. |
customerAsset | دارایی مشتری اشاره شده در پرس و جو. |
customerAssetSet | مجموعه دارایی مشتری که در پرس و جو به آن اشاره شده است. |
accessibleBiddingStrategy | استراتژی مناقصه قابل دسترس که در پرس و جو به آن اشاره شده است. |
customerCustomizer | سفارشیساز مشتری در پرس و جو به آن اشاره شده است. |
customerManagerLink | CustomerManagerLink اشاره شده در پرس و جو. |
customerClientLink | CustomerClientLink در پرس و جو ارجاع داده شده است. |
customerClient | مشتری مشتری در پرس و جو به آن اشاره کرد. |
customerConversionGoal | CustomerConversionGoal اشاره شده در پرس و جو. |
customerExtensionSetting | تنظیم برنامه افزودنی مشتری که در پرس و جو به آن اشاره شده است. |
customerFeed | فید مشتری که در پرس و جو به آن اشاره شده است. |
customerLabel | برچسب مشتری اشاره شده در پرس و جو. |
customerNegativeCriterion | معیار منفی مشتری که در پرس و جو به آن اشاره شده است. |
customerSearchTermInsight | عبارت جستجوی مشتری بینش اشاره شده در پرس و جو. |
customerUserAccess | CustomerUserAccess اشاره شده در پرس و جو. |
customerUserAccessInvitation | CustomerUserAccessInvitation اشاره شده در پرس و جو. |
customizerAttribute | ویژگی customizer که در پرس و جو ارجاع داده شده است. |
detailPlacementView | نمای قرار دادن جزئیات که در پرس و جو ارجاع شده است. |
detailedDemographic | اطلاعات دموگرافیک دقیق به پرس و جو اشاره شده است. |
displayKeywordView | نمای کلمه کلیدی نمایش داده شده در پرس و جو. |
distanceView | نمای فاصله اشاره شده در پرس و جو. |
dynamicSearchAdsSearchTermView | مشاهده عبارت جستجوی تبلیغات جستجوی پویا که در پرس و جو ارجاع شده است. |
expandedLandingPageView | نمای صفحه فرود گسترش یافته که در پرس و جو ارجاع داده شده است. |
extensionFeedItem | مورد فید افزونه که در جستار ارجاع داده شده است. |
feed | فید اشاره شده در پرس و جو. |
feedItem | مورد فید اشاره شده در جستار. |
feedItemSet | مجموعه مورد فید که در جستار به آن ارجاع داده شده است. |
feedItemSetLink | پیوند مجموعه آیتم فید که در جستار به آن ارجاع شده است. |
feedItemTarget | مورد هدف فید که در پرس و جو به آن اشاره شده است. |
feedMapping | نگاشت فید اشاره شده در پرس و جو. |
feedPlaceholderView | نمای جایبان فید که در پرس و جو به آن اشاره شده است. |
genderView | نمای جنسیتی اشاره شده در پرس و جو. |
geoTargetConstant | ثابت هدف جغرافیایی که در پرس و جو ارجاع داده شده است. |
geographicView | نمای جغرافیایی اشاره شده در پرس و جو. |
groupPlacementView | نمای قرارگیری گروهی که در پرس و جو به آن اشاره شده است. |
hotelGroupView | نمای گروه هتل که در پرس و جو اشاره شده است. |
hotelPerformanceView | نمای عملکرد هتل اشاره شده در پرس و جو. |
hotelReconciliation | آشتی هتل که در جستار اشاره شده است. |
incomeRangeView | نمای محدوده درآمدی که در پرس و جو به آن اشاره شده است. |
keywordView | نمای کلمه کلیدی مورد اشاره در پرس و جو. |
keywordPlan | طرح کلمه کلیدی مورد اشاره در پرس و جو. |
keywordPlanCampaign | کمپین طرح کلمه کلیدی مورد اشاره در پرس و جو. |
keywordPlanCampaignKeyword | کلمه کلیدی کمپین طرح کلمه کلیدی که در پرس و جو ارجاع داده شده است. |
keywordPlanAdGroup | گروه تبلیغاتی طرح کلمه کلیدی که در پرس و جو ارجاع داده شده است. |
keywordPlanAdGroupKeyword | گروه تبلیغاتی طرح کلمه کلیدی که در پرس و جو ارجاع داده شده است. |
keywordThemeConstant | موضوع اصلی کلمه کلیدی که در پرس و جو ارجاع داده شده است. |
label | برچسب اشاره شده در پرس و جو. |
landingPageView | نمای صفحه فرود اشاره شده در پرس و جو. |
languageConstant | ثابت زبان مورد اشاره در پرس و جو. |
locationView | نمای مکان اشاره شده در پرس و جو. |
managedPlacementView | نمای مکان مدیریت شده که در پرس و جو ارجاع داده شده است. |
mediaFile | فایل رسانه ای که در پرس و جو ارجاع داده شده است. |
mobileAppCategoryConstant | ثابت دسته برنامه تلفن همراه که در پرس و جو به آن اشاره شده است. |
mobileDeviceConstant | ثابت دستگاه تلفن همراه در پرس و جو ارجاع داده شده است. |
offlineUserDataJob | کار داده های کاربر آفلاین که در پرس و جو ارجاع داده شده است. |
operatingSystemVersionConstant | نسخه سیستم عامل ثابت در پرس و جو ارجاع شده است. |
paidOrganicSearchTermView | نمای عبارت جستجوی ارگانیک پولی که در عبارت جستجو ارجاع شده است. |
qualifyingQuestion | سوال واجد شرایطی که در پرس و جو به آن اشاره شده است. |
parentalStatusView | نمای وضعیت والدین که در پرس و جو ارجاع داده شده است. |
perStoreView | نمای هر فروشگاهی که در پرس و جو به آن اشاره شده است. |
productBiddingCategoryConstant | دسته مناقصه محصول اشاره شده در پرس و جو. |
productGroupView | نمای گروه محصول اشاره شده در پرس و جو. |
productLink | لینک محصول ذکر شده در پرس و جو. |
recommendation | توصیه ای که در پرس و جو به آن اشاره شده است. |
searchTermView | نمای عبارت جستجو شده در پرس و جو ارجاع داده شده است. |
sharedCriterion | مجموعه مشترکی که در پرس و جو ارجاع داده شده است. |
sharedSet | مجموعه مشترکی که در پرس و جو ارجاع داده شده است. |
smartCampaignSetting | تنظیم کمپین هوشمند که در پرس و جو به آن اشاره شده است. |
shoppingPerformanceView | نمای عملکرد خرید اشاره شده در پرس و جو. |
smartCampaignSearchTermView | نمای عبارت جستجوی کمپین هوشمند اشاره شده در پرس و جو. |
thirdPartyAppAnalyticsLink | AccountLink اشاره شده در پرس و جو. |
topicView | نمای موضوعی که در پرس و جو به آن اشاره شده است. |
travelActivityGroupView | نمای گروه فعالیت سفر که در پرس و جو به آن اشاره شده است. |
travelActivityPerformanceView | نمای عملکرد فعالیت سفر که در پرس و جو ارجاع شده است. |
experiment | آزمایشی که در پرس و جو به آن اشاره شد. |
experimentArm | بازوی آزمایشی که در پرس و جو ارجاع داده شده است. |
userInterest | علاقه کاربر به درخواست اشاره شده است. |
lifeEvent | رویداد زندگی که در پرس و جو به آن اشاره شده است. |
userList | لیست کاربری که در پرس و جو به آن اشاره شده است. |
userLocationView | نمای موقعیت مکانی کاربر که در پرس و جو به آن اشاره شده است. |
remarketingAction | اقدام بازاریابی مجدد که در جستار به آن اشاره شده است. |
topicConstant | ثابت موضوعی که در پرس و جو به آن اشاره شده است. |
video | ویدیوی مورد اشاره در پرس و جو. |
webpageView | نمای صفحه وب مورد اشاره در پرس و جو. |
leadFormSubmissionData | ارسال کاربر فرم سرنخ که در پرس و جو ارجاع داده شده است. |
metrics | معیارها |
segments | بخش ها |
بودجه حساب
بودجه در سطح حساب این شامل اطلاعات مربوط به خود بودجه و همچنین آخرین تغییرات تصویب شده در بودجه و تغییرات پیشنهادی است که در انتظار تصویب هستند. تغییرات پیشنهادی که در انتظار تأیید هستند، در صورت وجود، در «پیشنهاد در انتظار» یافت میشوند. جزئیات مؤثر در مورد بودجه در فیلدهای با پیشوند «تأیید شده_»، «تعدیل_» و موارد بدون پیشوند یافت می شود. از آنجایی که ممکن است برخی از جزئیات مؤثر با آنچه کاربر در ابتدا درخواست کرده بود متفاوت باشد (مثلاً محدودیت هزینه)، این تفاوتها از طریق فیلدهای «پیشنهاد_»، «تأیید شده_» و احتمالاً «تعدیل_» کنار هم قرار میگیرند.
این منبع با استفاده از AccountBudgetProposal جهش یافته است و نمی توان آن را مستقیماً تغییر داد. یک بودجه ممکن است در هر زمان معین حداکثر یک پیشنهاد معلق داشته باشد. از طریق Proposal در انتظار خوانده می شود.
پس از تصویب، ممکن است بودجه مورد تعدیل قرار گیرد، مانند تعدیل اعتبار. تنظیمات تفاوت هایی بین فیلدهای «تأیید شده» و «تعدیل شده» ایجاد می کند که در غیر این صورت یکسان خواهند بود.
نمایندگی JSON |
---|
{ "resourceName": string, "status": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع بودجه در سطح حساب. نام منابع AccountBudget به شکل زیر است: |
status | فقط خروجی وضعیت این بودجه در سطح حساب. |
totalAdjustmentsMicros | فقط خروجی مقدار کل تعدیل ها نمونه ای از تعدیل اعتبارات حسن نیت است. |
amountServedMicros | فقط خروجی ارزش تبلیغاتی که ارائه شده است، در میکرو. این شامل هزینه های تحویل بیش از حد می شود، در این صورت ممکن است اعتباری به طور خودکار به بودجه اعمال شود (به totalAdjustmentsMicros مراجعه کنید). |
pendingProposal | فقط خروجی پیشنهاد معلق برای اصلاح این بودجه، در صورت وجود. |
id | فقط خروجی شناسه بودجه در سطح حساب. |
billingSetup | فقط خروجی نام منبع تنظیم صورتحساب مرتبط با این بودجه در سطح حساب. نام منابع BillingSetup به شکل زیر است: |
name | فقط خروجی نام بودجه در سطح حساب. |
proposedStartDateTime | فقط خروجی زمان پیشنهادی شروع بودجه در سطح حساب در قالب yyyy-MM-dd HH:mm:ss. اگر نوع زمان شروع NOW پیشنهاد شده بود، این زمان درخواست است. |
approvedStartDateTime | فقط خروجی زمان شروع تایید شده بودجه در سطح حساب در قالب yyyy-MM-dd HH:mm:ss. به عنوان مثال، اگر بودجه جدیدی پس از زمان شروع پیشنهادی تصویب شود، زمان شروع مصوب، زمان تصویب است. |
purchaseOrderNumber | فقط خروجی شماره سفارش خرید مقداری است که به کاربران کمک می کند این بودجه را در فاکتورهای ماهانه خود ارجاع دهند. |
notes | فقط خروجی یادداشت های مرتبط با بودجه |
فیلد اتحادیه proposed_end_time . زمان پیشنهادی پایان بودجه در سطح حساب. proposed_end_time فقط می تواند یکی از موارد زیر باشد: | |
proposedEndDateTime | فقط خروجی زمان پایان پیشنهادی در قالب yyyy-MM-dd HH:mm:ss. |
proposedEndTimeType | فقط خروجی زمان پایان پیشنهادی به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، FOREVER. |
فیلد اتحادیه به عنوان مثال، اگر زمان پایان بودجه به روز شود و پیشنهاد پس از پایان زمان پیشنهادی تصویب شود، زمان پایان تایید شده زمان تصویب است. | |
approvedEndDateTime | فقط خروجی زمان پایان تایید شده در قالب yyyy-MM-dd HH:mm:ss. |
approvedEndTimeType | فقط خروجی زمان پایان تایید شده به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، FOREVER. |
فیلد اتحادیه proposed_spending_limit . محدودیت هزینه پیشنهادی proposed_spending_limit تنها می تواند یکی از موارد زیر باشد: | |
proposedSpendingLimitMicros | فقط خروجی محدودیت هزینه پیشنهادی در میکرو. یک میلیون معادل یک واحد است. |
proposedSpendingLimitType | فقط خروجی محدودیت هزینه پیشنهادی به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE. |
فیلد اتحادیه به عنوان مثال، اگر مبلغی که قبلاً توسط حساب خرج شده است از سقف هزینه پیشنهادی در زمان تأیید پیشنهاد بیشتر شود، سقف هزینه تأیید شده به مبلغی که قبلاً خرج شده است تنظیم می شود. | |
approvedSpendingLimitMicros | فقط خروجی حد مجاز هزینه در میکرو. یک میلیون معادل یک واحد است. این فقط در صورتی پر می شود که حد هزینه پیشنهادی محدود باشد و همیشه بزرگتر یا برابر با حد هزینه پیشنهادی خواهد بود. |
approvedSpendingLimitType | فقط خروجی محدودیت هزینه تایید شده به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE. این فقط در صورتی پر می شود که محدودیت هزینه تایید شده بی نهایت باشد. |
فیلد اتحادیه این مقدار حرف آخر را در مورد میزان مجاز خرج کردن حساب میزند. | |
adjustedSpendingLimitMicros | فقط خروجی محدودیت هزینه تعدیل شده در میکرو. یک میلیون معادل یک واحد است. اگر محدودیت مخارج تایید شده محدود باشد، محدودیت هزینه تعدیل شده ممکن است بسته به نوع تعدیلات اعمال شده در این بودجه، در صورت وجود، متفاوت باشد. انواع مختلف تنظیمات در اینجا توضیح داده شده است: https://support.google.com/google-ads/answer/1704323 به عنوان مثال، تعدیل بدهی میزان مجاز مصرف حساب را کاهش می دهد. |
adjustedSpendingLimitType | فقط خروجی محدودیت هزینه تنظیم شده به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE. این فقط در صورتی تکمیل میشود که محدودیت هزینه تنظیمشده INFINITE باشد، که اگر محدودیت مخارج تأیید شده INFINITE باشد، تضمین میشود که درست باشد. |
AccountBudgetStatus
وضعیت های احتمالی یک بودجه حساب.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
PENDING | بودجه حساب در انتظار تایید است. |
APPROVED | بودجه حساب تصویب شد. |
CANCELLED | بودجه حساب توسط کاربر لغو شده است. |
در حال انتظار حساب بودجه
یک پیشنهاد معلق مرتبط با بودجه در سطح حساب، در صورت وجود.
نمایندگی JSON |
---|
{ "proposalType": enum ( |
زمینه های | |
---|---|
proposalType | فقط خروجی نوع این پیشنهاد، به عنوان مثال، END برای پایان دادن به بودجه مرتبط با این پیشنهاد. |
accountBudgetProposal | فقط خروجی نام منبع پیشنهاد. نام منابع AccountBudgetProposal به شکل زیر است: |
name | فقط خروجی نامی که باید به بودجه سطح حساب اختصاص دهید. |
startDateTime | فقط خروجی زمان شروع در قالب yyyy-MM-dd HH:mm:ss. |
purchaseOrderNumber | فقط خروجی شماره سفارش خرید مقداری است که به کاربران کمک می کند این بودجه را در فاکتورهای ماهانه خود ارجاع دهند. |
notes | فقط خروجی یادداشت های مرتبط با این بودجه. |
creationDateTime | فقط خروجی زمانی که این پیشنهاد بودجه در سطح حساب ایجاد شد. قالببندی شده بهعنوان yyyy-MM-dd HH:mm:ss. |
end_time فیلد اتحادیه زمان پایان بودجه در سطح حساب. end_time می تواند تنها یکی از موارد زیر باشد: | |
endDateTime | فقط خروجی زمان پایان در قالب yyyy-MM-dd HH:mm:ss. |
endTimeType | فقط خروجی زمان پایان به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، FOREVER. |
اتحادیه spending_limit . محدودیت هزینه. spending_limit تنها می تواند یکی از موارد زیر باشد: | |
spendingLimitMicros | فقط خروجی محدودیت هزینه در میکرو یک میلیون معادل یک واحد است. |
spendingLimitType | فقط خروجی محدودیت هزینه به عنوان یک نوع کاملاً تعریف شده، به عنوان مثال، INFINITE. |
AdGroupAdAssetCombinationView
دیدگاهی در مورد استفاده از ترکیب دارایی تبلیغات گروه تبلیغات. اکنون ما فقط از AdGroupAdAssetCombinationView برای تبلیغات جستجوی واکنشگرا پشتیبانی می کنیم و انواع تبلیغات بیشتری برای آینده برنامه ریزی شده است.
نمایندگی JSON |
---|
{
"resourceName": string,
"servedAssets": [
{
object ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای ترکیبی دارایی آگهی گروه آگهی. شناسه ترکیبی 128 بیت است که 64 بیت بالا در asset_combination_id_high و 64 بیت پایین در asset_combination_id_low ذخیره میشوند. نام منابع نمای ترکیبی دارایی AdGroupAd به این شکل است: |
servedAssets[] | فقط خروجی دارایی های خدمت شده |
enabled | فقط خروجی وضعیت بین ترکیب دارایی و آخرین نسخه آگهی. اگر درست باشد، ترکیب دارایی به آخرین نسخه آگهی پیوند داده می شود. اگر نادرست باشد، به این معنی است که پیوند زمانی وجود داشته است اما حذف شده است و دیگر در آخرین نسخه آگهی وجود ندارد. |
AssetUsage
حاوی اطلاعات استفاده از دارایی است.
نمایندگی JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
زمینه های | |
---|---|
asset | نام منبع دارایی |
servedAssetFieldType | نوع فیلد ارائه شده دارایی. |
AdGroupAdAssetView
پیوندی بین AdGroupAd و دارایی. در حال حاضر ما فقط از AdGroupAdAssetView برای AppAds و تبلیغات جستجوی پاسخگو پشتیبانی می کنیم.
نمایندگی JSON |
---|
{ "resourceName": string, "fieldType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای دارایی آگهی گروه آگهی. نامهای منابع مشاهده دارایی آگهی گروه تبلیغات به شکل (قبل از V4) است: نامهای منابع نمای دارایی آگهی گروه آگهی به شکل (از V4 شروع میشود): |
fieldType | فقط خروجی نقشی که دارایی در آگهی ایفا می کند. |
policySummary | فقط خروجی اطلاعات خطمشی برای دارایی آگهی گروه آگهی. |
performanceLabel | فقط خروجی عملکرد یک پیوند دارایی. |
pinnedField | فقط خروجی فیلد پین شده |
adGroupAd | فقط خروجی آگهی گروه تبلیغاتی که دارایی به آن مرتبط است. |
asset | فقط خروجی دارایی که به آگهی گروه تبلیغاتی مرتبط است. |
enabled | فقط خروجی وضعیت بین دارایی و آخرین نسخه آگهی. اگر درست باشد، دارایی به آخرین نسخه آگهی پیوند داده می شود. اگر نادرست باشد، به این معنی است که پیوند زمانی وجود داشته است اما حذف شده است و دیگر در آخرین نسخه آگهی وجود ندارد. |
AdGroupAdAssetPolicySummary
حاوی اطلاعات خطمشی برای دارایی تبلیغات گروه تبلیغاتی است.
نمایندگی JSON |
---|
{ "policyTopicEntries": [ { object ( |
زمینه های | |
---|---|
policyTopicEntries[] | فقط خروجی فهرست یافتههای خطمشی برای دارایی آگهی گروه آگهی. |
reviewStatus | فقط خروجی این دارایی آگهی گروه تبلیغاتی در کجای فرآیند بررسی قرار دارد. |
approvalStatus | فقط خروجی وضعیت تأیید کلی این دارایی آگهی گروه آگهی، بر اساس وضعیت ورودیهای موضوع خطمشی فردی آن محاسبه میشود. |
AdGroupAudienceView
نمای مخاطب گروه تبلیغاتی شامل دادههای عملکرد از علایق و فهرستهای بازاریابی مجدد برای تبلیغات شبکه نمایش و شبکه YouTube، و فهرستهای بازاریابی مجدد برای تبلیغات جستجو (RLSA)، جمعآوریشده در سطح مخاطب است.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای مخاطب گروه تبلیغات. نام منابع مشاهده مخاطبان گروه تبلیغات به شکل زیر است: |
AdGroupCriterionSimulation
شبیه سازی معیار گروه تبلیغاتی ترکیبات پشتیبانی شده از نوع کانال تبلیغاتی، نوع معیار، نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است. عملیات شبیه سازی هتل AdGroupCriterion در V5 شروع می شود.
- DISPLAY - KEYWORD - CPC_BID - UNIFORM
- SEARCH - KEYWORD - CPC_BID - UNIFORM
- خرید - LISTING_GROUP - CPC_BID - UNIFORM
- هتل - LISTING_GROUP - CPC_BID - یونیفرم
- هتل - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
نمایندگی JSON |
---|
{ "resourceName": string, "type": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع شبیه سازی معیار گروه آگهی. نام منابع شبیه سازی معیار گروه تبلیغات به شکل زیر است: |
type | فقط خروجی فیلدی که شبیه سازی آن را اصلاح می کند. |
modificationMethod | فقط خروجی چگونه شبیه سازی زمینه را تغییر می دهد. |
adGroupId | فقط خروجی شناسه AdGroup شبیه سازی. |
criterionId | فقط خروجی شناسه معیار شبیه سازی |
startDate | فقط خروجی اولین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD. |
endDate | فقط خروجی آخرین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD. |
فیلد اتحادیه point_list . لیست نقاط شبیه سازی point_list فقط می تواند یکی از موارد زیر باشد: | |
cpcBidPointList | فقط خروجی اگر نوع شبیه سازی CPC_BID باشد، نقاط شبیه سازی. |
percentCpcBidPointList | فقط خروجی اگر نوع شبیه سازی 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 ( |
زمینه های | |
---|---|
points[] | معیارهای پیشبینیشده برای مجموعهای از مبالغ پیشنهادی CPC. |
CpcBidSimulationPoint
معیارهای پیش بینی شده برای مبلغ پیشنهادی CPC خاص.
نمایندگی JSON |
---|
{ "requiredBudgetAmountMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
زمینه های | |
---|---|
requiredBudgetAmountMicros | بودجه روزانه مورد نیاز پیشبینیشده که تبلیغکننده باید برای دریافت ترافیک تخمینی، بر حسب میکرو ارز تبلیغکننده تنظیم کند. |
biddableConversions | تعداد پیشبینیشده تبدیلهای قابل پیشنهاد. |
biddableConversionsValue | ارزش کل پیشبینیشده تبدیلهای قابل پیشنهاد. |
clicks | تعداد کلیک های پیش بینی شده |
costMicros | هزینه پیش بینی شده در میکرو |
impressions | تعداد نمایش پیش بینی شده |
topSlotImpressions | تعداد پیشبینیشده نمایشهای اسلات برتر. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند. |
فیلد اتحادیه cpc_simulation_key_value . وقتی SimulationModificationMethod = UNIFORM یا DEFAULT، cpc_bid_micros تنظیم می شود. وقتی SimulationModificationMethod = SCALING، cpc_bid_scaling_modifier تنظیم می شود. cpc_simulation_key_value تنها می تواند یکی از موارد زیر باشد: | |
cpcBidMicros | پیشنهاد CPC شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. |
cpcBidScalingModifier | اصلاح کننده مقیاس شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. همه پیشنهادات CPC مربوط به موجودیت شبیه سازی شده توسط این اصلاح کننده مقیاس بندی می شوند. |
PercentCpcBidSimulationPointList
محفظه ای برای نقاط شبیه سازی برای شبیه سازی از نوع PERCENT_CPC_BID.
نمایندگی JSON |
---|
{
"points": [
{
object ( |
زمینه های | |
---|---|
points[] | معیارهای پیشبینیشده برای یک سری از مقادیر پیشنهادی CPC درصد. |
PercentCpcBidSimulationPoint
معیارهای پیش بینی شده برای مقدار CPC درصدی خاص. فقط نوع کانال تبلیغاتی هتل از این فیلد پشتیبانی می کند.
نمایندگی JSON |
---|
{ "percentCpcBidMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
زمینه های | |
---|---|
percentCpcBidMicros | درصد CPC شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. درصد CPC به عنوان کسری از قیمت تبلیغ شده برای برخی کالاها یا خدمات بیان می شود. مقدار ذخیره شده در اینجا 1,000,000 * [کسری] است. |
biddableConversions | تعداد پیشبینیشده تبدیلهای قابل پیشنهاد. |
biddableConversionsValue | ارزش کل پیشبینیشده تبدیلهای قابل پیشنهاد به ارز محلی. |
clicks | تعداد کلیک های پیش بینی شده |
costMicros | هزینه پیش بینی شده در میکرو |
impressions | تعداد نمایش پیش بینی شده |
topSlotImpressions | تعداد پیشبینیشده نمایشهای اسلات برتر. |
AdGroupSimulation
شبیه سازی گروه تبلیغاتی ترکیبات پشتیبانی شده از نوع کانال تبلیغاتی، نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است.
- SEARCH - CPC_BID - DEFAULT
- SEARCH - CPC_BID - UNIFORM
- SEARCH - TARGET_CPA - UNIFORM
- SEARCH - TARGET_ROAS - UNIFORM
- DISPLAY - CPC_BID - DEFAULT
- DISPLAY - CPC_BID - UNIFORM
- DISPLAY - TARGET_CPA - UNIFORM
نمایندگی JSON |
---|
{ "resourceName": string, "type": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع شبیه سازی گروه تبلیغاتی. نام منابع شبیه سازی گروه تبلیغاتی به شکل زیر است: |
type | فقط خروجی فیلدی که شبیه سازی آن را اصلاح می کند. |
modificationMethod | فقط خروجی چگونه شبیه سازی زمینه را تغییر می دهد. |
adGroupId | فقط خروجی شناسه گروه آگهی شبیه سازی. |
startDate | فقط خروجی اولین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD. |
endDate | فقط خروجی آخرین روزی که شبیه سازی بر اساس آن انجام شد، در قالب YYYY-MM-DD |
فیلد اتحادیه point_list . لیست نقاط شبیه سازی point_list فقط می تواند یکی از موارد زیر باشد: | |
cpcBidPointList | فقط خروجی اگر نوع شبیه سازی CPC_BID باشد، نقاط شبیه سازی. |
cpvBidPointList | فقط خروجی اگر نوع شبیه سازی CPV_BID باشد، نقاط شبیه سازی. |
targetCpaPointList | فقط خروجی اگر نوع شبیه سازی TARGET_CPA باشد، نقاط شبیه سازی. |
targetRoasPointList | فقط خروجی اگر نوع شبیه سازی TARGET_ROAS باشد، نقاط شبیه سازی. |
CpvBidSimulationPointList
ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع CPV_BID.
نمایندگی JSON |
---|
{
"points": [
{
object ( |
زمینه های | |
---|---|
points[] | معیارهای پیشبینیشده برای یک سری مبالغ پیشنهادی CPV. |
CpvBidSimulationPoint
معیارهای پیش بینی شده برای مبلغ پیشنهادی CPV خاص.
نمایندگی JSON |
---|
{ "cpvBidMicros": string, "costMicros": string, "impressions": string, "views": string } |
زمینه های | |
---|---|
cpvBidMicros | پیشنهاد CPV شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. |
costMicros | هزینه پیش بینی شده در میکرو |
impressions | تعداد نمایش پیش بینی شده |
views | تعداد بازدید پیش بینی شده |
TargetCpaSimulationPointList
ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع TARGET_CPA.
نمایندگی JSON |
---|
{
"points": [
{
object ( |
زمینه های | |
---|---|
points[] | معیارهای پیش بینی شده برای یک سری مقادیر CPA هدف. |
TargetCpaSimulationPoint
معیارهای پیش بینی شده برای یک مقدار CPA هدف خاص.
نمایندگی JSON |
---|
{ "requiredBudgetAmountMicros": string, "appInstalls": number, "inAppActions": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
زمینه های | |
---|---|
requiredBudgetAmountMicros | بودجه روزانه مورد نیاز پیشبینیشده که تبلیغکننده باید برای دریافت ترافیک تخمینی، بر حسب میکرو ارز تبلیغکننده تنظیم کند. |
appInstalls | تعداد نصب برنامه پیش بینی شده |
inAppActions | تعداد پیشبینیشده اقدامات درونبرنامه. |
biddableConversions | تعداد پیشبینیشده تبدیلهای قابل پیشنهاد. |
biddableConversionsValue | ارزش کل پیشبینیشده تبدیلهای قابل پیشنهاد. |
clicks | تعداد کلیک های پیش بینی شده |
costMicros | هزینه پیش بینی شده در میکرو |
impressions | تعداد نمایش پیش بینی شده |
topSlotImpressions | تعداد پیشبینیشده نمایشهای اسلات برتر. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند. |
فیلد اتحادیه target_cpa_simulation_key_value . وقتی SimulationModificationMethod = UNIFORM یا DEFAULT، target_cpa_micros تنظیم می شود. وقتی SimulationModificationMethod = SCALING، target_cpa_scaling_modifier تنظیم می شود. target_cpa_simulation_key_value تنها می تواند یکی از موارد زیر باشد: | |
targetCpaMicros | CPA هدف شبیهسازی شده که معیارهای پیشبینیشده بر اساس آن است. |
targetCpaScalingModifier | اصلاح کننده مقیاس شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. تمام اهداف CPA مربوط به موجودیت شبیه سازی شده توسط این اصلاح کننده مقیاس بندی می شوند. |
TargetRoasSimulationPointList
ظرفی برای نقاط شبیه سازی برای شبیه سازی از نوع TARGET_ROAS.
نمایندگی JSON |
---|
{
"points": [
{
object ( |
زمینه های | |
---|---|
points[] | معیارهای پیش بینی شده برای یک سری مقادیر ROAS هدف. |
TargetRoasSimulationPoint
معیارهای پیش بینی شده برای مقدار ROAS هدف خاص.
نمایندگی JSON |
---|
{ "requiredBudgetAmountMicros": string, "targetRoas": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
زمینه های | |
---|---|
requiredBudgetAmountMicros | بودجه روزانه مورد نیاز پیشبینیشده که تبلیغکننده باید برای دریافت ترافیک تخمینی، بر حسب میکرو ارز تبلیغکننده تنظیم کند. |
targetRoas | ROAS هدف شبیه سازی شده که معیارهای پیش بینی شده بر اساس آن است. |
biddableConversions | تعداد پیشبینیشده تبدیلهای قابل پیشنهاد. |
biddableConversionsValue | ارزش کل پیشبینیشده تبدیلهای قابل پیشنهاد. |
clicks | تعداد کلیک های پیش بینی شده |
costMicros | هزینه پیش بینی شده در میکرو |
impressions | تعداد نمایش پیش بینی شده |
topSlotImpressions | تعداد پیشبینیشده نمایشهای اسلات برتر. فقط نوع کانال تبلیغاتی جستجو از این فیلد پشتیبانی می کند. |
AgeRangeView
نمای محدوده سنی
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای محدوده سنی. نام منابع نمای محدوده سنی به شکل زیر است: |
AdScheduleView
نمای برنامه زمانی تبلیغات، عملکرد کمپین ها را بر اساس معیارهای AdSchedule خلاصه می کند.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای برنامه زمانی تبلیغات. نام منابع مشاهده AdSchedule به شکل زیر است: |
دسته دامنه
دسته ای که به طور خودکار با خزیدن دامنه ایجاد می شود. اگر یک کمپین از 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 | فقط خروجی نام منبع دسته دامنه. نام منابع دسته دامنه به شکل زیر است: |
campaign | فقط خروجی کمپینی که این دسته برای آن توصیه می شود. |
category | فقط خروجی دسته بندی توصیه شده برای دامنه وب سایت، به عنوان مثال، اگر وب سایتی در مورد الکترونیک دارید، دسته ها می توانند «دوربین»، «تلویزیون» و غیره باشند. |
languageCode | فقط خروجی کد زبانی که زبان وب سایت را مشخص می کند، به عنوان مثال، "en" برای انگلیسی. زبان را می توان در DynamicSearchAdsSetting مورد نیاز برای تبلیغات جستجوی پویا مشخص کرد. این زبان صفحاتی از وبسایت شما است که میخواهید Google Ads آنها را پیدا کند، برای آنها تبلیغات ایجاد کند و جستجوها را با آن مطابقت دهد. |
domain | فقط خروجی دامنه برای وب سایت. دامنه را می توان در DynamicSearchAdsSetting مورد نیاز برای تبلیغات جستجوی پویا مشخص کرد. |
coverageFraction | فقط خروجی کسری از صفحات سایت شما که این دسته با آنها مطابقت دارد. |
categoryRank | فقط خروجی جایگاه این دسته در مجموعه دسته بندی ها. اعداد کمتر نشان دهنده تطابق بهتر با دامنه است. null نشان می دهد توصیه نمی شود. |
hasChildren | فقط خروجی نشان می دهد که آیا این دسته دارای زیرمجموعه هایی است یا خیر. |
recommendedCpcBidMicros | فقط خروجی هزینه پیشنهادی برای هر کلیک برای دسته. |
AssetFieldTypeView
نمای نوع فیلد دارایی. هنگامی که دارایی به عنوان برنامه افزودنی استفاده می شود، این نما معیارهای غیر شمارش شده را برای هر نوع فیلد دارایی گزارش می دهد.
نمایندگی JSON |
---|
{
"resourceName": string,
"fieldType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای نوع فیلد دارایی. نام منابع مشاهده نوع فیلد دارایی به شکل زیر است: |
fieldType | فقط خروجی نوع فیلد دارایی نمای نوع فیلد دارایی. |
AssetGroupProductGroupView
نمای گروه محصول گروه دارایی.
نمایندگی JSON |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای گروه محصول گروه دارایی. نام منابع مشاهده گروه محصولات گروه دارایی به شکل زیر است: |
assetGroup | فقط خروجی گروه دارایی مرتبط با فیلتر گروه فهرست. |
assetGroupListingGroupFilter | فقط خروجی نام منابع فیلتر گروه لیست دارایی. |
دارایی
نمای نوع دارایی. این نمایش معیارهای غیر همپوشانی را برای هر نوع مجموعه دارایی گزارش می دهد. انواع مجموعه دارایی کودک در این گزارش گنجانده نشده است. آمار آنها تحت نوع مجموعه دارایی والدین جمع می شود.
نمایندگی JSON |
---|
{
"resourceName": string,
"assetSetType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای مجموعه دارایی. مجموعه دارایی نوع مشاهده نام منابع دارای فرم است: |
assetSetType | فقط خروجی نوع مجموعه دارایی نمای نوع مجموعه دارایی. |
پیشنهادات
شبیه سازی استراتژی مناقصه. ترکیبی پشتیبانی شده از نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است.
- Target_CPA - یکنواخت
- Target_roas - یکنواخت
نمایندگی JSON |
---|
{ "resourceName": string, "biddingStrategyId": string, "type": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع شبیه سازی استراتژی مناقصه. نام منابع شبیه سازی استراتژی مناقصه فرم: |
biddingStrategyId | فقط خروجی استراتژی مناقصه به اشتراک گذاری شناسه مجموعه شبیه سازی. |
type | فقط خروجی فیلدی که شبیه سازی تغییر می دهد. |
modificationMethod | فقط خروجی چگونه شبیه سازی زمینه را اصلاح می کند. |
startDate | فقط خروجی روز اول که در آن شبیه سازی مبتنی است ، در قالب Yyyy-MM-DD. |
endDate | فقط خروجی آخرین روز که در آن شبیه سازی استوار است ، در قالب yyyy-mm-dd |
Union Field point_list . لیست نقاط شبیه سازی. point_list فقط می تواند یکی از موارد زیر باشد: | |
targetCpaPointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_CPA باشد. |
targetRoasPointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_Roas باشد. |
بیداد
نمای تماس که شامل داده هایی برای ردیابی تماس از تبلیغات فقط تماس یا برنامه های افزودنی فراخوانی است.
نمایندگی JSON |
---|
{ "resourceName": string, "callerCountryCode": string, "callerAreaCode": string, "callDurationSeconds": string, "startCallDateTime": string, "endCallDateTime": string, "callTrackingDisplayLocation": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای تماس. نام منابع مشاهده تماس با فرم: |
callerCountryCode | فقط خروجی کد کشور تماس گیرنده. |
callerAreaCode | فقط خروجی کد منطقه تماس گیرنده. اگر مدت زمان تماس کوتاهتر از 15 ثانیه باشد ، تهی است. |
callDurationSeconds | فقط خروجی مدت زمان تماس با تبلیغ کننده در چند ثانیه. |
startCallDateTime | فقط خروجی زمان شروع تماس تماس با تبلیغ کننده. |
endCallDateTime | فقط خروجی زمان پایان تماس تلفنی تبلیغ کننده. |
callTrackingDisplayLocation | فقط خروجی مکان نمایش ردیابی تماس. |
type | فقط خروجی نوع تماس |
callStatus | فقط خروجی وضعیت تماس |
CallTrackingDisplayLocation
مکان های نمایش ردیابی تماس احتمالی.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است |
UNKNOWN | فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد. |
AD | تماس تلفنی از آگهی. |
LANDING_PAGE | تماس تلفنی از نقاط تبلیغات صفحه Landing به. |
نوع فراخوانی
انواع احتمالی املاک از جایی که تماس برقرار شده است.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است |
UNKNOWN | فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد. |
MANUALLY_DIALED | تماس تلفنی به صورت دستی شماره گیری شد. |
HIGH_END_MOBILE_SEARCH | تماس تلفنی یک کلیک موبایل بود. |
GooglevoiceCallstatus
وضعیت احتمالی یک تماس صوتی Google.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است |
UNKNOWN | فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد. |
MISSED | تماس از دست رفته بود. |
RECEIVED | تماس دریافت شد |
CampaiceAudienceView
دیدگاه مخاطبان مبارزات انتخاباتی. شامل داده های عملکردی از علاقه ها و لیست های بازاریابی برای نمایش شبکه و تبلیغات شبکه YouTube و لیست های بازاریابی برای تبلیغات جستجو (RLSA) ، که توسط کمپین و معیار مخاطبان جمع شده است. این دیدگاه فقط شامل مخاطبان متصل در سطح کمپین است.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع دیدگاه مخاطبان کمپین. مخاطبان کمپین مشاهده نام منابع این شکل را دارند: |
CampaignearchTerminsight
نمای اصطلاح جستجوی کمپین. داده های تاریخی از مارس 2023 در دسترس است.
نمایندگی JSON |
---|
{ "resourceName": string, "categoryLabel": string, "id": string, "campaignId": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع بینش سطح جستجوی سطح کمپین. سطح جستجوی کمپین اصطلاحات بینش نام منابع دارای فرم است: |
categoryLabel | فقط خروجی برچسب برای گروه جستجو. یک رشته خالی نشانگر دسته همه چیز برای اصطلاحات جستجو است که در گروه دیگری قرار نگرفته است. |
id | فقط خروجی شناسه بینش. |
campaignId | فقط خروجی شناسه کمپین. |
عمل جراحی
یک شبیه سازی کمپین. ترکیبی پشتیبانی شده از نوع کانال تبلیغاتی ، نوع شبیه سازی و روش اصلاح شبیه سازی به ترتیب در زیر شرح داده شده است.
- جستجو - 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 ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع شبیه سازی کمپین. نام منابع شبیه سازی کمپین شکل دارد: |
campaignId | فقط خروجی شناسه کمپین شبیه سازی. |
type | فقط خروجی فیلدی که شبیه سازی تغییر می دهد. |
modificationMethod | فقط خروجی چگونه شبیه سازی زمینه را اصلاح می کند. |
startDate | فقط خروجی روز اول که در آن شبیه سازی مبتنی است ، در قالب Yyyy-MM-DD. |
endDate | فقط خروجی آخرین روز که در آن شبیه سازی استوار است ، در قالب yyyy-mm-dd |
Union Field point_list . لیست نقاط شبیه سازی. point_list فقط می تواند یکی از موارد زیر باشد: | |
cpcBidPointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی CPC_BID باشد. |
targetCpaPointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_CPA باشد. |
targetRoasPointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_Roas باشد. |
targetImpressionSharePointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی Target_Impression_Share باشد. |
budgetPointList | فقط خروجی نقاط شبیه سازی اگر نوع شبیه سازی بودجه باشد. |
بودجه سنج
یک کانتینر برای نقاط شبیه سازی برای شبیه سازی بودجه نوع.
نمایندگی JSON |
---|
{
"points": [
{
object ( |
زمینه های | |
---|---|
points[] | معیارهای پیش بینی شده برای یک سری از مبلغ بودجه. |
نقطه نظر
معیارهای پیش بینی شده برای یک مبلغ بودجه خاص.
نمایندگی JSON |
---|
{ "budgetAmountMicros": string, "requiredCpcBidCeilingMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
زمینه های | |
---|---|
budgetAmountMicros | بودجه شبیه سازی شده ای که معیارهای پیش بینی شده بر اساس آن بنا شده است. |
requiredCpcBidCeilingMicros | پیش بینی شده به سقف پیشنهاد روزانه CPC که تبلیغ کننده باید برای تحقق این شبیه سازی ، در Micros از ارز تبلیغ کننده تنظیم کند. فقط کمپین هایی با هدف قیمت پیشنهادی هزینه های پیشنهادی از این زمینه پشتیبانی می کنند. |
biddableConversions | تعداد پیش بینی شده از تبدیل های قابل پیشنهاد. |
biddableConversionsValue | ارزش کل پیش بینی شده از تبدیل های قابل پیشنهاد. |
clicks | تعداد کلیک پیش بینی شده. |
costMicros | هزینه پیش بینی شده در میکرو. |
impressions | تعداد پیش بینی شده از برداشت ها. |
topSlotImpressions | تعداد پیش بینی شده از برداشت های برتر شکاف. فقط نوع کانال تبلیغاتی جستجو از این قسمت پشتیبانی می کند. |
حامل
معیار حامل که می تواند در هدف قرار دادن کمپین استفاده شود.
نمایندگی JSON |
---|
{ "resourceName": string, "id": string, "name": string, "countryCode": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع معیار حامل. نام منابع معیار حامل فرم دارد: |
id | فقط خروجی شناسه معیار حامل. |
name | فقط خروجی نام کامل حامل به زبان انگلیسی. |
countryCode | فقط خروجی کد کشور کشور که در آن شرکت حمل و نقل قرار دارد ، به عنوان مثال "AR" ، "FR" و غیره. |
تغییر دهنده
تغییر گرانول منابع برگشتی از انواع منابع خاص را توصیف می کند. تغییرات ایجاد شده از طریق UI یا API در 30 روز گذشته گنجانده شده است. مقادیر قبلی و جدید زمینه های تغییر یافته نشان داده شده است. ChangeEvent می تواند تا 3 دقیقه تأخیر داشته باشد تا یک تغییر جدید را منعکس کند.
نمایندگی JSON |
---|
{ "resourceName": string, "changeDateTime": string, "changeResourceType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع رویداد تغییر. تغییر نام منابع رویداد فرم: |
changeDateTime | فقط خروجی زمانی که تغییر در این منبع انجام شد. |
changeResourceType | فقط خروجی نوع منبع تغییر یافته. این نشان می دهد که چه منبعی در Oldresource و NewResource تعیین می شود. |
changeResourceName | فقط خروجی منبع ساده این تغییر در آن رخ داده است. |
clientType | فقط خروجی جایی که این تغییر انجام شد. |
userEmail | فقط خروجی ایمیل کاربر که این تغییر را انجام داده است. |
oldResource | فقط خروجی منبع قدیمی قبل از تغییر. فقط زمینه های تغییر یافته جمع می شوند. |
newResource | فقط خروجی منبع جدید پس از تغییر. فقط زمینه های تغییر یافته جمع می شوند. |
resourceChangeOperation | فقط خروجی عملیات در منبع تغییر یافته. |
changedFields | فقط خروجی لیستی از زمینه هایی که در منبع برگشتی تغییر می کنند. این یک لیست جدا از کاما از نام های کاملاً واجد شرایط است. مثال: |
campaign | فقط خروجی کمپین تحت تأثیر این تغییر. |
adGroup | فقط خروجی گروه ADGROUP تحت تأثیر این تغییر. |
feed | فقط خروجی خوراک تحت تأثیر این تغییر. |
feedItem | فقط خروجی خوراک تحت تأثیر این تغییر. |
asset | فقط خروجی دارایی تحت تأثیر این تغییر. |
تغییر
فهرست لیست منابع پشتیبانی توسط منبع 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 | فقط خروجی اگر changeresourcetype == ad. |
adGroup | فقط خروجی اگر changeresourcetype == ad_group را تنظیم کنید. |
adGroupCriterion | فقط خروجی اگر changeresourcetype == ad_group_criterion را تنظیم کنید. |
campaign | فقط خروجی اگر کمپین changeresourcetype == را تنظیم کنید. |
campaignBudget | فقط خروجی اگر changeresourcetype == campaign_budget. |
adGroupBidModifier | فقط خروجی اگر changeresourcetype == ad_group_bid_modifier را تنظیم کنید. |
campaignCriterion | فقط خروجی اگر changeresourcetype == campaign_criterion. |
feed | فقط خروجی اگر changeresourcetype == خوراک را تنظیم کنید. |
feedItem | فقط خروجی اگر changeresourcetype == feed_item را تنظیم کنید. |
campaignFeed | فقط خروجی اگر changeresourcetype == campaign_feed را تنظیم کنید. |
adGroupFeed | فقط خروجی اگر changeresourcetype == ad_group_feed را تنظیم کنید. |
adGroupAd | فقط خروجی اگر changeresourcetype == ad_group_ad را تنظیم کنید. |
asset | فقط خروجی اگر changeresourcetype == دارایی را تنظیم کنید. |
customerAsset | فقط خروجی اگر changeresourcetype == customer_asset را تنظیم کنید. |
campaignAsset | فقط خروجی اگر changeresourcetype == campaign_asset را تنظیم کنید. |
adGroupAsset | فقط خروجی اگر changeresourcetype == ad_group_asset را تنظیم کنید. |
assetSet | فقط خروجی اگر changeresourcetype == asset_set را تنظیم کنید. |
assetSetAsset | فقط خروجی اگر changeresourcetype == asset_set_asset را تنظیم کنید. |
campaignAssetSet | فقط خروجی اگر changeresourcetype == campaign_asset_set را تنظیم کنید. |
منبع
عملیات در منبع تغییر یافته در منبع تغییر.
Enums | |
---|---|
UNSPECIFIED | هیچ مقدار مشخص نشده است. |
UNKNOWN | فقط برای مقدار بازگشت استفاده می شود. نمایانگر یک عملیات غیر طبقه بندی شده در این نسخه است. |
CREATE | این منبع ایجاد شد. |
UPDATE | این منبع اصلاح شد. |
REMOVE | منبع برداشته شد. |
تغییر وضعیت
وضعیت منبع برگشتی را توصیف می کند. Changestatus می تواند تا 3 دقیقه تأخیر داشته باشد تا یک تغییر جدید را منعکس کند.
نمایندگی JSON |
---|
{ "resourceName": string, "resourceType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع وضعیت تغییر. تغییر نام منابع وضعیت فرم: |
resourceType | فقط خروجی نشان دهنده نوع منبع تغییر یافته است. این نشان می دهد که چه زمینه هایی تعیین می شود. به عنوان مثال ، برای زمینه های AD_GROUP ، کمپین و AdGroup تنظیم می شود. |
resourceStatus | فقط خروجی نشان دهنده وضعیت منبع تغییر یافته است. |
sharedSet | فقط خروجی مشترک تحت تأثیر این تغییر. |
campaignSharedSet | فقط خروجی CampaignSharedset تحت تأثیر این تغییر قرار گرفت. |
asset | فقط خروجی دارایی تحت تأثیر این تغییر. |
customerAsset | فقط خروجی مشتری تحت تأثیر این تغییر. |
campaignAsset | فقط خروجی کمپین تحت تأثیر این تغییر. |
adGroupAsset | فقط خروجی AdGroupAsset تحت تأثیر این تغییر. |
combinedAudience | فقط خروجی ترکیبی که تحت تأثیر این تغییر قرار گرفته است. |
lastChangeDateTime | فقط خروجی زمانی که جدیدترین تغییر در این منبع رخ داده است. |
campaign | فقط خروجی کمپین تحت تأثیر این تغییر. |
adGroup | فقط خروجی گروه ADGROUP تحت تأثیر این تغییر. |
adGroupAd | فقط خروجی Adgroupad تحت تأثیر این تغییر قرار گرفت. |
adGroupCriterion | فقط خروجی آداب و رسوم آداب و رسوم تحت تأثیر این تغییر. |
campaignCriterion | فقط خروجی ComplictCriterion تحت تأثیر این تغییر. |
feed | فقط خروجی خوراک تحت تأثیر این تغییر. |
feedItem | فقط خروجی خوراک تحت تأثیر این تغییر. |
adGroupFeed | فقط خروجی AdgroupFeed تحت تأثیر این تغییر قرار گرفت. |
campaignFeed | فقط خروجی کمپین تحت تأثیر این تغییر. |
adGroupBidModifier | فقط خروجی 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 ( |
زمینه های | |
---|---|
resourceName | تغییر ناپذیر نام منابع مخاطب ترکیبی. نام مخاطبان ترکیبی فرم دارند: |
id | فقط خروجی شناسه مخاطبان ترکیبی. |
status | فقط خروجی وضعیت این مخاطب ترکیبی. نشان می دهد که آیا مخاطب ترکیبی فعال شده یا حذف شده است. |
name | فقط خروجی نام مخاطبان ترکیبی. این باید در همه مخاطبان ترکیبی منحصر به فرد باشد. |
description | فقط خروجی شرح این مخاطب ترکیبی. |
ترکیبی
enum حاوی انواع وضعیت مخاطبان ترکیبی احتمالی.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است |
UNKNOWN | فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد. |
ENABLED | وضعیت فعال شده - مخاطب ترکیبی فعال است و می توان آنها را هدف قرار داد. |
REMOVED | وضعیت حذف شده - مخاطب ترکیبی برداشته می شود و برای هدف قرار دادن قابل استفاده نیست. |
clickview
نمای کلیک با معیارهای جمع شده در هر سطح کلیک ، از جمله هر دو کلیک معتبر و نامعتبر. برای کمپین های غیر جستجو ، Metrics.Clicks تعداد تعامل معتبر و نامعتبر را نشان می دهد. نمایش داده شدگان از جمله ClickView باید یک فیلتر داشته باشند که نتایج را به یک روز محدود کند و می تواند برای تاریخ 90 روز قبل از زمان درخواست درخواست شود.
نمایندگی JSON |
---|
{ "resourceName": string, "areaOfInterest": { object ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای کلیک. روی مشاهده نام منابع ، فرم را دارند: |
areaOfInterest | فقط خروجی معیارهای مکان مطابق با منطقه مورد علاقه مرتبط با این تصور. |
locationOfPresence | فقط خروجی معیارهای مکان مطابق با محل حضور در ارتباط با برداشت. |
keyword | فقط خروجی کلمه کلیدی مرتبط ، در صورت وجود و کلیک با کانال جستجو مطابقت دارد. |
keywordInfo | فقط خروجی در صورت وجود اطلاعات اساسی در مورد کلمه کلیدی مرتبط. |
gclid | فقط خروجی شناسه کلیک Google. |
pageNumber | فقط خروجی شماره صفحه در نتایج جستجو که در آن تبلیغ نشان داده شده است. |
adGroupAd | فقط خروجی تبلیغ مرتبط |
campaignLocationTarget | فقط خروجی در صورت وجود موقعیت مکانی کمپین مرتبط ، هدف قرار می گیرد. |
userList | فقط خروجی اگر یکی وجود داشته باشد ، لیست کاربر مرتبط. |
clicklocation
معیارهای موقعیت مکانی مرتبط با کلیک.
نمایندگی JSON |
---|
{ "city": string, "country": string, "metro": string, "mostSpecific": string, "region": string } |
زمینه های | |
---|---|
city | معیار موقعیت مکانی شهر در ارتباط با برداشت است. |
country | معیار موقعیت مکانی کشور در ارتباط با برداشت. |
metro | معیار موقعیت مکانی مترو همراه با تصور. |
mostSpecific | خاص ترین معیار موقعیت مکانی مرتبط با تصور. |
region | معیار موقعیت مکانی منطقه در ارتباط با برداشت. |
ارز
یک ارز ثابت.
نمایندگی JSON |
---|
{ "resourceName": string, "code": string, "name": string, "symbol": string, "billableUnitMicros": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع ارز ثابت. نام منابع ثابت ارز فرم دارد: |
code | فقط خروجی کد ارز سه حرفی ISO 4217 ، به عنوان مثال ، "USD" |
name | فقط خروجی نام کامل انگلیسی ارز. |
symbol | فقط خروجی نماد استاندارد برای توصیف این ارز ، به عنوان مثال ، "$" برای دلار آمریکا. |
billableUnitMicros | فقط خروجی واحد قابل پرداخت برای این ارز. مبالغ صورتحساب باید چند برابر از این مقدار باشد. |
در دسترس
نمای نمایشی از پیشنهادات متعلق به و به اشتراک گذاشته شده با مشتری را نشان می دهد.
برخلاف DiddingStrategy ، این منبع شامل استراتژی های متعلق به مدیران مشتری و به اشتراک گذاشته شده با این مشتری - علاوه بر استراتژی های متعلق به این مشتری است. این منبع معیارهایی را ارائه نمی دهد و فقط زیر مجموعه محدودی از ویژگی های PiddingStrategy را در معرض نمایش قرار می دهد.
نمایندگی JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع استراتژی مناقصه در دسترس. نام منابع در دسترس |
id | فقط خروجی شناسه استراتژی مناقصه. |
name | فقط خروجی نام استراتژی مناقصه. |
type | فقط خروجی نوع استراتژی مناقصه. |
ownerCustomerId | فقط خروجی شناسه مشتری که صاحب استراتژی مناقصه است. |
ownerDescriptiveName | فقط خروجی توصیف نام مشتری که صاحب استراتژی مناقصه است. |
فقط یک نفر قابل تنظیم است. | |
maximizeConversionValue | فقط خروجی یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود. |
maximizeConversions | فقط خروجی یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود. |
targetCpa | فقط خروجی یک استراتژی مناقصه که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند. |
targetImpressionShare | فقط خروجی یک استراتژی مناقصه که به طور خودکار نسبت به درصد منتخب برداشت ها بهینه می شود. |
targetRoas | فقط خروجی یک استراتژی مناقصه که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید. |
targetSpend | فقط خروجی یک استراتژی پیشنهادی که پیشنهادات شما را برای کمک به شما کمک می کند تا هرچه بیشتر کلیک در بودجه شما بدست آورید. |
حداکثر
یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود.
نمایندگی JSON |
---|
{ "targetRoas": number } |
زمینه های | |
---|---|
targetRoas | فقط خروجی گزینه Return On Ad Devent (ROAS) گزینه. در صورت تنظیم ، استراتژی پیشنهاد در حالی که میانگین بازده هدف در تبلیغات را دارد ، درآمد را به حداکثر می رساند. اگر ROAS هدف بالا باشد ، ممکن است استراتژی پیشنهاد نتواند بودجه کامل را خرج کند. اگر ROA های هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود. |
حداکثر
یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود.
نمایندگی JSON |
---|
{ "targetCpaMicros": string } |
زمینه های | |
---|---|
targetCpaMicros | فقط خروجی هزینه هدف برای هر گزینه Acquisition (CPA). این میانگین مبلغی است که می خواهید در هر خرید هزینه کنید. |
TargetCPA
یک استراتژی پیشنهادی خودکار که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.
نمایندگی JSON |
---|
{ "targetCpaMicros": string } |
زمینه های | |
---|---|
targetCpaMicros | فقط خروجی هدف متوسط CPA. این هدف باید بر اساس ارز برای حساب بیشتر یا مساوی با حداقل واحد قابل پرداخت باشد. |
عناوین هدف
یک استراتژی مناقصه خودکار که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید.
نمایندگی JSON |
---|
{ "targetRoas": number } |
زمینه های | |
---|---|
targetRoas | فقط خروجی درآمد انتخاب شده (بر اساس داده های تبدیل) در هر واحد هزینه. |
هدف
یک استراتژی پیشنهادی خودکار که پیشنهادات شما را برای کمک به دریافت هرچه بیشتر کلیک در بودجه شما تعیین می کند.
نمایندگی JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
زمینه های | |
---|---|
targetSpendMicros | فقط خروجی هدف هزینه ای که در آن برای به حداکثر رساندن کلیک ها انجام می شود. یک پیشنهاد دهنده Targetspend سعی خواهد کرد که کوچکتر از این ارزش یا مبلغ هزینه های طبیعی را خرج کند. اگر مشخص نشده باشد ، بودجه به عنوان هدف هزینه استفاده می شود. این قسمت مستهلک می شود و دیگر نباید مورد استفاده قرار گیرد. برای جزئیات بیشتر به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید. |
cpcBidCeilingMicros | فقط خروجی حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. |
مشتری مشتری
پیوندی بین مشتری داده شده و مشتری مشتری. مشتری های مشتری فقط برای مشتریان مدیر وجود دارند. کلیه مشتریان مشتری مستقیم و غیرمستقیم و همچنین خود مدیر گنجانده شده است.
نمایندگی JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع مشتری مشتری. نام منابع مشتری مشتری فرم دارد: |
appliedLabels[] | فقط خروجی نام منابع برچسب های متعلق به مشتری درخواست کننده که برای مشتری مشتری اعمال می شود. نام منابع برچسب فرم دارد: |
status | فقط خروجی وضعیت مشتری مشتری. فقط خواندنی. |
clientCustomer | فقط خروجی نام منبع مشتری مشتری که به مشتری داده شده مرتبط است. فقط خواندنی. |
level | فقط خروجی فاصله بین مشتری و مشتری. برای پیوند خود ، مقدار سطح فقط 0 خواهد بود. |
timeZone | فقط خروجی مخزن داده های محلی محلی (CLDR) بازنمایی رشته از منطقه زمانی مشتری ، به عنوان مثال ، America/LOS_ANGELES. فقط خواندنی. |
testAccount | فقط خروجی مشخص می کند که آیا مشتری یک حساب آزمایشی است یا خیر. فقط خواندنی. |
manager | فقط خروجی آیا مشتری مدیر است یا خیر. فقط خواندنی. |
descriptiveName | فقط خروجی نام توصیفی برای مشتری. فقط خواندنی. |
currencyCode | فقط خروجی کد ارز (به عنوان مثال ، "USD" ، "EUR") برای مشتری. فقط خواندنی. |
id | فقط خروجی شناسه مشتری مشتری. فقط خواندنی. |
Customersearch terminsight
نمای اصطلاح جستجوی مشتری. داده های تاریخی از مارس 2023 در دسترس است.
نمایندگی JSON |
---|
{ "resourceName": string, "categoryLabel": string, "id": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع بینش اصطلاح جستجوی سطح مشتری. سطح جستجوی سطح مشتری نام منابع بینش فرم دارد: |
categoryLabel | فقط خروجی برچسب برای گروه جستجو. یک رشته خالی نشانگر دسته همه چیز برای اصطلاحات جستجو است که در گروه دیگری قرار نگرفته است. |
id | فقط خروجی شناسه بینش. |
نمای جزئیات
نمایی با معیارهای جمع شده توسط گروه تبلیغاتی و URL یا YouTube Video.
نمایندگی JSON |
---|
{
"resourceName": string,
"placementType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای قرار دادن جزئیات. جزئیات قرار دادن جزئیات نام منابع فرم: |
placementType | فقط خروجی نوع قرارگیری ، به عنوان مثال ، وب سایت ، ویدیوی YouTube و برنامه موبایل. |
placement | فقط خروجی رشته قرار دادن خودکار در سطح جزئیات ، به عنوان مثال URL وب سایت ، شناسه برنامه کاربردی موبایل یا شناسه ویدیویی YouTube. |
displayName | فقط خروجی نام نمایش نام URL برای وب سایت ها ، نام ویدیوی YouTube برای فیلم های YouTube و نام برنامه تلفن همراه ترجمه شده برای برنامه های تلفن همراه است. |
groupPlacementTargetUrl | فقط خروجی URL از قرار دادن گروه ، به عنوان مثال ، دامنه ، پیوند به برنامه موبایل در فروشگاه App یا URL کانال YouTube. |
targetUrl | فقط خروجی 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 ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع جمعیتی دقیق. نام منابع دموگرافیک دقیق فرم دارد: |
id | فقط خروجی شناسه جمعیتی مفصل. |
name | فقط خروجی نام جمعیتی مفصل. به عنوان مثال ، "بالاترین سطح دستیابی آموزشی" |
parent | فقط خروجی پدر و مادر DectiveDemographic. |
launchedToAll | فقط خروجی اگر جمعیتی دقیق به همه کانال ها و محلی ها راه اندازی شود ، درست است. |
availabilities[] | فقط خروجی اطلاعات در دسترس بودن جمعیتی دقیق. |
CriterionCategorAailability
اطلاعات مربوط به در دسترس بودن دسته ، در هر کانال تبلیغاتی.
نمایندگی JSON |
---|
{ "channel": { object ( |
زمینه های | |
---|---|
channel | انواع کانال و زیرگروه هایی که در دسترس گروه هستند. |
locale[] | محلی که برای کانال در دسترس هستند. |
CriterionCategoryChannelAileability
اطلاعات مربوط به نوع کانال تبلیغاتی و زیرگروه ها یک دسته در دسترس است.
نمایندگی JSON |
---|
{ "availabilityMode": enum ( |
زمینه های | |
---|---|
availabilityMode | قالب در دسترس بودن کانال. می تواند All_Channels باشد (بقیه زمینه ها تنظیم نمی شوند) ، کانال_Type (فقط نوع تبلیغات CHANNELTYPE تنظیم می شود ، این دسته در دسترس همه انواع زیر در زیر آن است) یا channel_type_and_subtypes (AdvertisingChanneltype ، AdvertisingChannelSubtype ، و GrovedefefaultChannelSubtype همه تنظیم می شوند). |
advertisingChannelType | نوع کانال این دسته در دسترس است. |
advertisingChannelSubType[] | زیرگروه های کانال در زیر نوع کانال که دسته در دسترس است. |
includeDefaultChannelSubType | آیا نوع زیر کانال پیش فرض گنجانده شده است. به عنوان مثال ، 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 ( |
زمینه های | |
---|---|
availabilityMode | قالب در دسترس بودن محلی. می توان راه اندازی کرد_TO_ALL (هر دو کشور و زبان خالی خواهد بود) ، کشور (فقط کشور تعیین می شود) ، زبان (فقط زبان تنظیم می شود) ، Country_and_language (هر دو کشور و زبان تنظیم می شوند). |
countryCode | کد کشور ISO-3166-1 alpha-2 مرتبط با این گروه. |
languageCode | 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 | فقط خروجی نام منبع نمایش کلمه کلیدی نمایشگر. نمایش کلمات کلیدی مشاهده نام منابع فرم: |
نمای فاصله
نمای فاصله با معیارهای جمع شده از فاصله کاربر از برنامه های تبلیغاتی یک تبلیغ کننده. هر فاصله از راه دور شامل تمام برداشت هایی است که در فاصله آن قرار می گیرند و یک برداشت واحد به معیارهای مربوط به همه راه دور که شامل فاصله کاربر است ، کمک می کند.
نمایندگی JSON |
---|
{
"resourceName": string,
"distanceBucket": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای فاصله. نام منابع از راه دور فرم دارد: |
distanceBucket | فقط خروجی گروه بندی فاصله کاربر از پسوندهای مکان. |
metricSystem | فقط خروجی درست است اگر 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 | فقط خروجی نام منابع نمای جستجوی آگهی های جستجوی پویا. آگهی های جستجوی پویا جستجوی اصطلاح مشاهده نام منابع دارای فرم هستند: |
searchTerm | فقط خروجی عبارت جستجو این قسمت فقط خواندنی است. |
headline | فقط خروجی تیتر پویا تولید شده از آگهی جستجوی پویا. این قسمت فقط خواندنی است. |
landingPage | فقط خروجی URL صفحه فرود پویا انتخاب شده از این تصور. این قسمت فقط خواندنی است. |
pageUrl | فقط خروجی URL مورد از صفحه خوراک صفحه برای برداشت استفاده می شود. این قسمت فقط خواندنی است. |
hasNegativeKeyword | فقط خروجی اگر پرس و جو با یک کلمه کلیدی منفی مطابقت داشته باشد ، درست است. این قسمت فقط خواندنی است. |
hasMatchingKeyword | فقط خروجی اگر پرس و جو به کلمات کلیدی هدفمند اضافه شود ، درست است. این قسمت فقط خواندنی است. |
hasNegativeUrl | فقط خروجی درست است اگر پرس و جو با URL منفی مطابقت داشته باشد. این قسمت فقط خواندنی است. |
نمای گسترده
نمای صفحه فرود با معیارهای جمع شده در سطح URL نهایی گسترش یافته.
نمایندگی JSON |
---|
{ "resourceName": string, "expandedFinalUrl": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای صفحه فرود گسترده. نمای صفحه نمایش گسترش یافته نام منابع فرم دارد: |
expandedFinalUrl | فقط خروجی URL نهایی که کلیک به آن هدایت می شود. |
نمایندگان بازدارنده
یک نمای نگهدارنده خوراک.
نمایندگی JSON |
---|
{
"resourceName": string,
"placeholderType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای نگهدارنده خوراک. نام منابع نگهدارنده محل تغذیه فرم: |
placeholderType | فقط خروجی نوع نگهدارنده محل نمای نگهدارنده خوراک. |
ژاندرویز
یک نمای جنسیتی منبع Genderview به جای اینکه معیارهایی اضافه شود ، وضعیت مؤثر خدمت را منعکس می کند. یک گروه تبلیغاتی بدون معیارهای جنسیتی به طور پیش فرض به همه جنس ها نشان می دهد ، بنابراین همه جنس ها در Genderview با آمار ظاهر می شوند.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منابع نمای جنسیت. نام منابع مشاهده جنسیت فرم دارد: |
نمای جغرافیایی
یک دیدگاه جغرافیایی
نمای جغرافیایی شامل تمام معیارهای جمع شده در سطح کشور ، یک ردیف در هر کشور است. این معیارها را در هر دو مکان فیزیکی واقعی کاربر یا منطقه مورد علاقه گزارش می کند. در صورت استفاده از قسمتهای دیگر بخش ، ممکن است بیش از یک ردیف در هر کشور بدست آورید.
نمایندگی JSON |
---|
{
"resourceName": string,
"locationType": enum ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع نمای جغرافیایی. نام منابع نمایش جغرافیایی فرم دارد: |
locationType | فقط خروجی نوع هدف قرار دادن GEO از کمپین. |
countryCriterionId | فقط خروجی 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 ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the group placement view. Group placement view resource names have the form: |
placementType | Output only. Type of the placement, for example, Website, YouTube Channel, Mobile Application. |
placement | Output only. The automatic placement string at group level, eg web domain, mobile app ID, or a YouTube channel ID. |
displayName | Output only. Domain name for websites and YouTube channel name for YouTube channels. |
targetUrl | Output only. URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL. |
HotelGroupView
A hotel group view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the hotel group view. Hotel Group view resource names have the form: |
HotelPerformanceView
A hotel performance view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the hotel performance view. Hotel performance view resource names have the form: |
HotelReconciliation
A hotel reconciliation. It contains conversion information from Hotel bookings to reconcile with advertiser records. These rows may be updated or canceled before billing through Bulk Uploads.
نمایندگی JSON |
---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"campaign": string,
"hotelCenterId": string,
"hotelId": string,
"checkInDate": string,
"checkOutDate": string,
"reconciledValueMicros": string,
"billed": boolean,
"status": enum ( |
زمینه های | |
---|---|
resourceName | Immutable. The resource name of the hotel reconciliation. Hotel reconciliation resource names have the form: |
commissionId | ضروری. Output only. The commission ID is Google's ID for this booking. Every booking event is assigned a Commission ID to help you match it to a guest stay. |
orderId | Output only. The order ID is the identifier for this booking as provided in the 'transaction_id' parameter of the conversion tracking tag. |
campaign | Output only. The resource name for the Campaign associated with the conversion. |
hotelCenterId | Output only. Identifier for the Hotel Center account which provides the rates for the Hotel campaign. |
hotelId | Output only. Unique identifier for the booked property, as provided in the Hotel Center feed. The hotel ID comes from the 'ID' parameter of the conversion tracking tag. |
checkInDate | Output only. Check-in date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD. |
checkOutDate | Output only. Check-out date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD. |
reconciledValueMicros | ضروری. Output only. Reconciled value is the final value of a booking as paid by the guest. If original booking value changes for any reason, such as itinerary changes or room upsells, the reconciled value should be the full final amount collected. If a booking is canceled, the reconciled value should include the value of any cancellation fees or non-refundable nights charged. Value is in millionths of the base unit currency. For example, $12.35 would be represented as 12350000. Currency unit is in the default customer currency. |
billed | Output only. Whether a given booking has been billed. Once billed, a booking can't be modified. |
status | ضروری. 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 | Output only. The resource name of the income range view. Income range view resource names have the form: |
KeywordView
A keyword view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the keyword view. Keyword view resource names have the form: |
LandingPageView
A landing page view with metrics aggregated at the unexpanded final URL level.
نمایندگی JSON |
---|
{ "resourceName": string, "unexpandedFinalUrl": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the landing page view. Landing page view resource names have the form: |
unexpandedFinalUrl | Output only. The advertiser-specified final URL. |
LanguageConstant
یک زبان.
نمایندگی JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the language constant. Language constant resource names have the form: |
id | Output only. The ID of the language constant. |
code | Output only. The language code, for example, "en_US", "en_AU", "es", "fr", etc. |
name | Output only. The full name of the language in English, for example, "English (US)", "Spanish", etc. |
targetable | Output only. Whether the language is targetable. |
LocationView
A location view summarizes the performance of campaigns by a Location criterion. If no Location criterion is set, no results are returned; instead, use geographicView or userLocationView for visitor location data.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the location view. Location view resource names have the form: |
ManagedPlacementView
A managed placement view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the Managed Placement view. Managed placement view resource names have the form: |
MobileAppCategoryConstant
A mobile application category constant.
نمایندگی JSON |
---|
{ "resourceName": string, "id": integer, "name": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the mobile app category constant. Mobile app category constant resource names have the form: |
id | Output only. The ID of the mobile app category constant. |
name | Output only. Mobile app category name. |
MobileDeviceConstant
A mobile device constant.
نمایندگی JSON |
---|
{
"resourceName": string,
"type": enum ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the mobile device constant. Mobile device constant resource names have the form: |
type | Output only. The type of mobile device. |
id | Output only. The ID of the mobile device constant. |
name | Output only. The name of the mobile device. |
manufacturerName | Output only. The manufacturer of the mobile device. |
operatingSystemName | Output only. The operating system of the mobile device. |
MobileDeviceType
The type of mobile device.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
MOBILE | تلفن های همراه. |
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 ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the operating system version constant. Operating system version constant resource names have the form: |
operatorType | Output only. Determines whether this constant represents a single version or a range of versions. |
id | Output only. The ID of the operating system version. |
name | Output only. Name of the operating system. |
osMajorVersion | Output only. The OS Major Version number. |
osMinorVersion | Output only. The OS Minor Version number. |
OperatingSystemVersionOperatorType
The type of operating system version.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
EQUALS_TO | Equals to the specified version. |
GREATER_THAN_EQUALS_TO | Greater than or equals to the specified version. |
PaidOrganicSearchTermView
A paid organic search term view providing a view of search stats across ads and organic listings aggregated by search term at the ad group level.
نمایندگی JSON |
---|
{ "resourceName": string, "searchTerm": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the search term view. Search term view resource names have the form: |
searchTerm | Output only. The search term. |
QualifyingQuestion
Qualifying Questions for Lead Form.
نمایندگی JSON |
---|
{ "resourceName": string, "qualifyingQuestionId": string, "locale": string, "text": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the qualifying question. 'qualifyingQuestions/{qualifyingQuestionId}' |
qualifyingQuestionId | Output only. The id of the qualifying question. |
locale | Output only. The locale of the qualifying question. |
text | Output only. The qualifying question. |
ParentalStatusView
A parental status view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the parental status view. Parental Status view resource names have the form: |
PerStoreView
A per store view. This view provides per store impression reach and local action conversion stats for advertisers.
نمایندگی JSON |
---|
{ "resourceName": string, "placeId": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the per store view. Per Store view resource names have the form: |
placeId | Output only. The place ID of the per store view. |
ProductBiddingCategoryConstant
A Product Bidding Category.
نمایندگی JSON |
---|
{ "resourceName": string, "level": enum ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the product bidding category. Product bidding category resource names have the form: |
level | Output only. Level of the product bidding category. |
status | Output only. Status of the product bidding category. |
id | Output only. ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 . |
countryCode | Output only. Two-letter upper-case country code of the product bidding category. |
productBiddingCategoryConstantParent | Output only. Resource name of the parent product bidding category. |
languageCode | Output only. Language code of the product bidding category. |
localizedName | Output only. Display value of the product bidding category localized according to languageCode. |
ProductBiddingCategoryStatus
Enum describing the status of the product bidding category.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
ACTIVE | The category is active and can be used for bidding. |
OBSOLETE | The category is obsolete. Used only for reporting purposes. |
ProductGroupView
A product group view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the product group view. Product group view resource names have the form: |
توصیه
یک توصیه
نمایندگی JSON |
---|
{ "resourceName": string, "type": enum ( |
زمینه های | |
---|---|
resourceName | Immutable. The resource name of the recommendation. |
type | Output only. The type of recommendation. |
impact | Output only. The impact on account performance as a result of applying the recommendation. |
campaigns[] | Output only. The campaigns targeted by this recommendation. This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET and MOVE_UNUSED_BUDGET |
campaignBudget | Output only. The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget. This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET |
campaign | Output only. The campaign targeted by this recommendation. This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS, |
adGroup | Output only. The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group. This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD |
dismissed | Output only. Whether the recommendation is dismissed or not. |
Union field recommendation . The details of recommendation. recommendation can be only one of the following: | |
campaignBudgetRecommendation | Output only. The campaign budget recommendation. |
forecastingCampaignBudgetRecommendation | Output only. The forecasting campaign budget recommendation. |
keywordRecommendation | Output only. The keyword recommendation. |
textAdRecommendation | Output only. Add expanded text ad recommendation. |
targetCpaOptInRecommendation | Output only. The TargetCPA opt-in recommendation. |
maximizeConversionsOptInRecommendation | Output only. The MaximizeConversions Opt-In recommendation. |
enhancedCpcOptInRecommendation | Output only. The Enhanced Cost-Per-Click Opt-In recommendation. |
searchPartnersOptInRecommendation | Output only. The Search Partners Opt-In recommendation. |
maximizeClicksOptInRecommendation | Output only. The MaximizeClicks Opt-In recommendation. |
optimizeAdRotationRecommendation | Output only. The Optimize Ad Rotation recommendation. |
keywordMatchTypeRecommendation | Output only. The keyword match type recommendation. |
moveUnusedBudgetRecommendation | Output only. The move unused budget recommendation. |
targetRoasOptInRecommendation | Output only. The Target ROAS opt-in recommendation. |
responsiveSearchAdRecommendation | Output only. The add responsive search ad recommendation. |
marginalRoiCampaignBudgetRecommendation | Output only. The marginal ROI campaign budget recommendation. |
useBroadMatchKeywordRecommendation | Output only. The use broad match keyword recommendation. |
responsiveSearchAdAssetRecommendation | Output only. The responsive search ad asset recommendation. |
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation | Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation. |
responsiveSearchAdImproveAdStrengthRecommendation | Output only. The responsive search ad improve ad strength recommendation. |
displayExpansionOptInRecommendation | Output only. The Display Expansion opt-in recommendation. |
upgradeLocalCampaignToPerformanceMaxRecommendation | Output only. The upgrade a Local campaign to a Performance Max campaign recommendation. |
raiseTargetCpaBidTooLowRecommendation | Output only. The raise target CPA bid too low recommendation. |
forecastingSetTargetRoasRecommendation | Output only. The forecasting set target ROAS recommendation. |
calloutAssetRecommendation | Output only. The callout asset recommendation. |
sitelinkAssetRecommendation | Output only. The sitelink asset recommendation. |
callAssetRecommendation | Output only. The call asset recommendation. |
shoppingAddAgeGroupRecommendation | Output only. The shopping add age group recommendation. |
shoppingAddColorRecommendation | Output only. The shopping add color recommendation. |
shoppingAddGenderRecommendation | Output only. The shopping add gender recommendation. |
shoppingAddGtinRecommendation | Output only. The shopping add GTIN recommendation. |
shoppingAddMoreIdentifiersRecommendation | Output only. The shopping add more identifiers recommendation. |
shoppingAddSizeRecommendation | Output only. The shopping add size recommendation. |
shoppingAddProductsToCampaignRecommendation | Output only. The shopping add products to campaign recommendation. |
shoppingFixDisapprovedProductsRecommendation | Output only. The shopping fix disapproved products recommendation. |
shoppingTargetAllOffersRecommendation | Output only. The shopping target all offers recommendation. |
shoppingFixSuspendedMerchantCenterAccountRecommendation | Output only. The shopping fix suspended Merchant Center account recommendation. |
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation | Output only. The shopping fix Merchant Center account suspension warning recommendation. |
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation | Output only. The shopping migrate Regular Shopping Campaign offers to Performance Max recommendation. |
dynamicImageExtensionOptInRecommendation | Output only. Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads. |
raiseTargetCpaRecommendation | Output only. Recommendation to raise Target CPA. |
lowerTargetRoasRecommendation | Output only. Recommendation to lower Target ROAS. |
performanceMaxOptInRecommendation | Output only. The Performance Max Opt In recommendation. |
improvePerformanceMaxAdStrengthRecommendation | Output only. The improve Performance Max ad strength recommendation. |
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation | Output only. The Dynamic Search Ads to Performance Max migration recommendation. |
RecommendationType
Types of recommendations.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
CAMPAIGN_BUDGET | Budget recommendation for campaigns that are currently budget-constrained (as opposed to the FORECASTING_CAMPAIGN_BUDGET recommendation, which applies to campaigns that are expected to become budget-constrained in the future). |
KEYWORD | Keyword recommendation. |
TEXT_AD | Recommendation to add a new text ad. |
TARGET_CPA_OPT_IN | Recommendation to update a campaign to use a Target CPA bidding strategy. |
MAXIMIZE_CONVERSIONS_OPT_IN | Recommendation to update a campaign to use the Maximize Conversions bidding strategy. |
ENHANCED_CPC_OPT_IN | Recommendation to enable Enhanced Cost Per Click for a campaign. |
SEARCH_PARTNERS_OPT_IN | Recommendation to start showing your campaign's ads on Google Search Partners Websites. |
MAXIMIZE_CLICKS_OPT_IN | Recommendation to update a campaign to use a Maximize Clicks bidding strategy. |
OPTIMIZE_AD_ROTATION | Recommendation to start using the "Optimize" ad rotation setting for the given ad group. |
KEYWORD_MATCH_TYPE | Recommendation to change an existing keyword from one match type to a broader match type. |
MOVE_UNUSED_BUDGET | Recommendation to move unused budget from one budget to a constrained budget. |
FORECASTING_CAMPAIGN_BUDGET | Budget recommendation for campaigns that are expected to become budget-constrained in the future (as opposed to the CAMPAIGN_BUDGET recommendation, which applies to campaigns that are currently budget-constrained). |
TARGET_ROAS_OPT_IN | Recommendation to update a campaign to use a Target ROAS bidding strategy. |
RESPONSIVE_SEARCH_AD | Recommendation to add a new responsive search ad. |
MARGINAL_ROI_CAMPAIGN_BUDGET | Budget recommendation for campaigns whose ROI is predicted to increase with a budget adjustment. |
USE_BROAD_MATCH_KEYWORD | Recommendation to add broad match versions of keywords for fully automated conversion-based bidding campaigns. |
RESPONSIVE_SEARCH_AD_ASSET | Recommendation to add new responsive search ad assets. |
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX | Recommendation to upgrade a Smart Shopping campaign to a Performance Max campaign. |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH | Recommendation to improve strength of responsive search ad. |
DISPLAY_EXPANSION_OPT_IN | Recommendation to update a campaign to use Display Expansion. |
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX | Recommendation to upgrade a Local campaign to a Performance Max campaign. |
RAISE_TARGET_CPA_BID_TOO_LOW | Recommendation to raise target CPA when it is too low and there are very few or no conversions. It is applied asynchronously and can take minutes depending on the number of ad groups there are in the related campaign. |
FORECASTING_SET_TARGET_ROAS | Recommendation to raise the budget in advance of a seasonal event that is forecasted to increase traffic, and change bidding strategy from maximize conversion value to target ROAS. |
CALLOUT_ASSET | Recommendation to add callout assets to campaign or customer level. |
SITELINK_ASSET | Recommendation to add sitelink assets to campaign or customer level. |
CALL_ASSET | Recommendation to add call assets to campaign or customer level. |
SHOPPING_ADD_AGE_GROUP | Recommendation to add the age group attribute to offers that are demoted because of a missing age group. |
SHOPPING_ADD_COLOR | Recommendation to add a color to offers that are demoted because of a missing color. |
SHOPPING_ADD_GENDER | Recommendation to add a gender to offers that are demoted because of a missing gender. |
SHOPPING_ADD_GTIN | Recommendation to add a GTIN (Global Trade Item Number) to offers that are demoted because of a missing GTIN. |
SHOPPING_ADD_MORE_IDENTIFIERS | Recommendation to add more identifiers to offers that are demoted because of missing identifiers. |
SHOPPING_ADD_SIZE | Recommendation to add the size to offers that are demoted because of a missing size. |
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN | Recommendation informing a customer about a campaign that cannot serve because no products are being targeted. |
SHOPPING_FIX_DISAPPROVED_PRODUCTS | The shopping recommendation informing a customer about campaign with a high percentage of disapproved products. |
SHOPPING_TARGET_ALL_OFFERS | Recommendation to create a catch-all campaign that targets all offers. |
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT | Recommendation to fix Merchant Center account suspension issues. |
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING | Recommendation to fix Merchant Center account suspension warning issues. |
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX | Recommendation to migrate offers targeted by Regular Shopping Campaigns to existing Performance Max campaigns. |
DYNAMIC_IMAGE_EXTENSION_OPT_IN | Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads. |
RAISE_TARGET_CPA | Recommendation to raise Target CPA based on Google predictions modeled from past conversions. It is applied asynchronously and can take minutes depending on the number of ad groups there are in the related campaign. |
LOWER_TARGET_ROAS | Recommendation to lower Target ROAS. |
PERFORMANCE_MAX_OPT_IN | Recommendation to opt into Performance Max campaigns. |
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH | Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating. |
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX | Recommendation to migrate Dynamic Search Ads to Performance Max campaigns. |
RecommendationImpact
The impact of making the change as described in the recommendation. Some types of recommendations may not have impact information.
نمایندگی JSON |
---|
{ "baseMetrics": { object ( |
زمینه های | |
---|---|
baseMetrics | Output only. Base metrics at the time the recommendation was generated. |
potentialMetrics | Output only. Estimated metrics if the recommendation is applied. |
RecommendationMetrics
Weekly account performance metrics. For some recommendation types, these are averaged over the past 90-day period and hence can be fractional.
نمایندگی JSON |
---|
{ "impressions": number, "clicks": number, "costMicros": string, "conversions": number, "videoViews": number } |
زمینه های | |
---|---|
impressions | Output only. Number of ad impressions. |
clicks | Output only. Number of ad clicks. |
costMicros | Output only. Cost (in micros) for advertising, in the local currency for the account. |
conversions | Output only. Number of conversions. |
videoViews | Output only. Number of video views for a video ad campaign. |
CampaignBudgetRecommendation
The budget recommendation for budget constrained campaigns.
نمایندگی JSON |
---|
{
"budgetOptions": [
{
object ( |
زمینه های | |
---|---|
budgetOptions[] | Output only. The budget amounts and associated impact estimates for some values of possible budget amounts. |
currentBudgetAmountMicros | Output only. The current budget amount in micros. |
recommendedBudgetAmountMicros | Output only. The recommended budget amount in micros. |
CampaignBudgetRecommendationOption
The impact estimates for a given budget amount.
نمایندگی JSON |
---|
{
"impact": {
object ( |
زمینه های | |
---|---|
impact | Output only. The impact estimate if budget is changed to amount specified in this option. |
budgetAmountMicros | Output only. The budget amount for this option. |
KeywordRecommendation
The keyword recommendation.
نمایندگی JSON |
---|
{ "keyword": { object ( |
زمینه های | |
---|---|
keyword | Output only. The recommended keyword. |
searchTerms[] | Output only. A list of search terms this keyword matches. The same search term may be repeated for multiple keywords. |
recommendedCpcBidMicros | Output only. The recommended CPC (cost-per-click) bid. |
SearchTerm
Information about a search term as related to a keyword recommendation.
نمایندگی JSON |
---|
{ "text": string, "estimatedWeeklySearchCount": string } |
زمینه های | |
---|---|
text | Output only. The text of the search term. |
estimatedWeeklySearchCount | Output only. Estimated number of historical weekly searches for this search term. |
TextAdRecommendation
The text ad recommendation.
نمایندگی JSON |
---|
{
"ad": {
object ( |
زمینه های | |
---|---|
ad | Output only. Recommended ad. |
creationDate | Output only. Creation date of the recommended ad. YYYY-MM-DD format, for example, 2018-04-17. |
autoApplyDate | Output only. Date, if present, is the earliest when the recommendation will be auto applied. YYYY-MM-DD format, for example, 2018-04-17. |
TargetCpaOptInRecommendation
The Target CPA opt-in recommendation.
نمایندگی JSON |
---|
{
"options": [
{
object ( |
زمینه های | |
---|---|
options[] | Output only. The available goals and corresponding options for Target CPA strategy. |
recommendedTargetCpaMicros | Output only. The recommended average CPA target. See required budget amount and impact of using this recommendation in options list. |
TargetCpaOptInRecommendationOption
The Target CPA opt-in option with impact estimate.
نمایندگی JSON |
---|
{ "goal": enum ( |
زمینه های | |
---|---|
goal | Output only. The goal achieved by this option. |
impact | Output only. The impact estimate if this option is selected. |
targetCpaMicros | Output only. Average CPA target. |
requiredCampaignBudgetAmountMicros | Output only. The minimum campaign budget, in local currency for the account, required to achieve the target CPA. Amount is specified in micros, where one million is equivalent to one currency unit. |
TargetCpaOptInRecommendationGoal
Goal of TargetCpaOptIn recommendation.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
SAME_COST | Recommendation to set Target CPA to maintain the same cost. |
SAME_CONVERSIONS | Recommendation to set Target CPA to maintain the same conversions. |
SAME_CPA | Recommendation to set Target CPA to maintain the same CPA. |
CLOSEST_CPA | Recommendation to set Target CPA to a value that is as close as possible to, yet lower than, the actual CPA (computed for past 28 days). |
MaximizeConversionsOptInRecommendation
The Maximize Conversions Opt-In recommendation.
نمایندگی JSON |
---|
{ "recommendedBudgetAmountMicros": string } |
زمینه های | |
---|---|
recommendedBudgetAmountMicros | Output only. The recommended new budget amount. |
EnhancedCpcOptInRecommendation
This type has no fields.
The Enhanced Cost-Per-Click Opt-In recommendation.
SearchPartnersOptInRecommendation
This type has no fields.
The Search Partners Opt-In recommendation.
MaximizeClicksOptInRecommendation
The Maximize Clicks opt-in recommendation.
نمایندگی JSON |
---|
{ "recommendedBudgetAmountMicros": string } |
زمینه های | |
---|---|
recommendedBudgetAmountMicros | Output only. The recommended new budget amount. Only set if the current budget is too high. |
OptimizeAdRotationRecommendation
This type has no fields.
The Optimize Ad Rotation recommendation.
KeywordMatchTypeRecommendation
The keyword match type recommendation.
نمایندگی JSON |
---|
{ "keyword": { object ( |
زمینه های | |
---|---|
keyword | Output only. The existing keyword where the match type should be more broad. |
recommendedMatchType | Output only. The recommended new match type. |
MoveUnusedBudgetRecommendation
The move unused budget recommendation.
نمایندگی JSON |
---|
{
"budgetRecommendation": {
object ( |
زمینه های | |
---|---|
budgetRecommendation | Output only. The recommendation for the constrained budget to increase. |
excessCampaignBudget | Output only. The excess budget's resourceName. |
TargetRoasOptInRecommendation
The Target ROAS opt-in recommendation.
نمایندگی JSON |
---|
{ "recommendedTargetRoas": number, "requiredCampaignBudgetAmountMicros": string } |
زمینه های | |
---|---|
recommendedTargetRoas | Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive. |
requiredCampaignBudgetAmountMicros | Output only. The minimum campaign budget, in local currency for the account, required to achieve the target ROAS. Amount is specified in micros, where one million is equivalent to one currency unit. |
ResponsiveSearchAdRecommendation
The add responsive search ad recommendation.
نمایندگی JSON |
---|
{
"ad": {
object ( |
زمینه های | |
---|---|
ad | Output only. Recommended ad. |
UseBroadMatchKeywordRecommendation
The use broad match keyword recommendation.
نمایندگی JSON |
---|
{
"keyword": [
{
object ( |
زمینه های | |
---|---|
keyword[] | Output only. Sample of keywords to be expanded to Broad Match. |
suggestedKeywordsCount | Output only. Total number of keywords to be expanded to Broad Match in the campaign. |
campaignKeywordsCount | Output only. Total number of keywords in the campaign. |
campaignUsesSharedBudget | Output only. Whether the associated campaign uses a shared budget. |
requiredCampaignBudgetAmountMicros | Output only. The budget recommended to avoid becoming budget constrained after applying the recommendation. |
ResponsiveSearchAdAssetRecommendation
The add responsive search ad asset recommendation.
نمایندگی JSON |
---|
{ "currentAd": { object ( |
زمینه های | |
---|---|
currentAd | Output only. The current ad to be updated. |
recommendedAssets | Output only. The recommended assets. This is populated only with the new headlines and/or descriptions, and is otherwise empty. |
UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.
نمایندگی JSON |
---|
{ "merchantId": string, "salesCountryCode": string } |
زمینه های | |
---|---|
merchantId | Output only. ID of Merchant Center account. |
salesCountryCode | Output only. Country whose products from merchant's inventory should be included. |
ResponsiveSearchAdImproveAdStrengthRecommendation
The responsive search ad improve ad strength recommendation.
نمایندگی JSON |
---|
{ "currentAd": { object ( |
زمینه های | |
---|---|
currentAd | Output only. The current ad to be updated. |
recommendedAd | Output only. The updated ad. |
DisplayExpansionOptInRecommendation
This type has no fields.
The Display Expansion opt-in recommendation.
UpgradeLocalCampaignToPerformanceMaxRecommendation
This type has no fields.
The Upgrade Local campaign to Performance Max campaign recommendation.
RaiseTargetCpaBidTooLowRecommendation
The raise target CPA bid too low recommendation.
نمایندگی JSON |
---|
{ "recommendedTargetMultiplier": number, "averageTargetCpaMicros": string } |
زمینه های | |
---|---|
recommendedTargetMultiplier | Output only. A number greater than 1.0 indicating the factor by which we recommend the target CPA should be increased. |
averageTargetCpaMicros | Output only. The current average target CPA of the campaign, in micros of customer local currency. |
ForecastingSetTargetRoasRecommendation
The forecasting set target ROAS recommendation.
نمایندگی JSON |
---|
{
"recommendedTargetRoas": number,
"campaignBudget": {
object ( |
زمینه های | |
---|---|
recommendedTargetRoas | Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive. |
campaignBudget | Output only. The campaign budget. |
CampaignBudget
A campaign budget shared amongst various budget recommendation types.
نمایندگی JSON |
---|
{ "currentAmountMicros": string, "recommendedNewAmountMicros": string, "newStartDate": string } |
زمینه های | |
---|---|
currentAmountMicros | Output only. Current budget amount. |
recommendedNewAmountMicros | Output only. Recommended budget amount. |
newStartDate | Output only. The date when the new budget would start being used. This field will be set for the following recommendation types: FORECASTING_SET_TARGET_ROAS YYYY-MM-DD format, for example, 2018-04-17. |
CalloutAssetRecommendation
The callout asset recommendation.
نمایندگی JSON |
---|
{ "recommendedCampaignCalloutAssets": [ { object ( |
زمینه های | |
---|---|
recommendedCampaignCalloutAssets[] | Output only. New callout extension assets recommended at the campaign level. |
recommendedCustomerCalloutAssets[] | Output only. New callout extension assets recommended at the customer level. |
SitelinkAssetRecommendation
The sitelink asset recommendation.
نمایندگی JSON |
---|
{ "recommendedCampaignSitelinkAssets": [ { object ( |
زمینه های | |
---|---|
recommendedCampaignSitelinkAssets[] | Output only. New sitelink assets recommended at the campaign level. |
recommendedCustomerSitelinkAssets[] | Output only. New sitelink assets recommended at the customer level. |
CallAssetRecommendation
This type has no fields.
The call asset recommendation.
ShoppingOfferAttributeRecommendation
The shopping recommendation to add an attribute to offers that are demoted because it is missing.
نمایندگی JSON |
---|
{
"merchant": {
object ( |
زمینه های | |
---|---|
merchant | Output only. The details of the Merchant Center account. |
feedLabel | Output only. The campaign feed label. |
offersCount | Output only. The number of online, servable offers. |
demotedOffersCount | Output only. The number of online, servable offers that are demoted for missing attributes. Visit the Merchant Center for more details. |
MerchantInfo
The Merchant Center account details.
نمایندگی JSON |
---|
{ "id": string, "name": string, "multiClient": boolean } |
زمینه های | |
---|---|
id | Output only. The Merchant Center account ID. |
name | Output only. The name of the Merchant Center account. |
multiClient | Output only. Whether the Merchant Center account is a Multi-Client account (MCA). |
ShoppingAddProductsToCampaignRecommendation
The shopping recommendation to add products to a Shopping Campaign Inventory.
نمایندگی JSON |
---|
{ "merchant": { object ( |
زمینه های | |
---|---|
merchant | Output only. The details of the Merchant Center account. |
feedLabel | Output only. The feed label for the campaign. |
reason | Output only. The reason why no products are attached to the campaign. |
دلیل
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 ( |
زمینه های | |
---|---|
merchant | Output only. The details of the Merchant Center account. |
feedLabel | Output only. The feed label for the campaign. |
productsCount | Output only. The number of products of the campaign. |
disapprovedProductsCount | Output only. The numbers of products of the campaign that are disapproved. |
ShoppingTargetAllOffersRecommendation
The shopping recommendation to create a catch-all campaign that targets all offers.
نمایندگی JSON |
---|
{
"merchant": {
object ( |
زمینه های | |
---|---|
merchant | Output only. The details of the Merchant Center account. |
untargetedOffersCount | Output only. The number of untargeted offers. |
feedLabel | Output only. The offer feed label. |
ShoppingMerchantCenterAccountSuspensionRecommendation
The shopping recommendation to fix Merchant Center account suspension issues.
نمایندگی JSON |
---|
{
"merchant": {
object ( |
زمینه های | |
---|---|
merchant | Output only. The details of the Merchant Center account. |
feedLabel | Output only. The feed label of the campaign for which the suspension happened. |
ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
The shopping recommendation to migrate Regular Shopping Campaign targeted offers to Performance Max campaigns.
نمایندگی JSON |
---|
{
"merchant": {
object ( |
زمینه های | |
---|---|
merchant | Output only. The details of the Merchant Center account. |
feedLabel | Output only. The feed label of the offers targeted by the campaigns sharing this suggestion. |
DynamicImageExtensionOptInRecommendation
This type has no fields.
Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.
RaiseTargetCpaRecommendation
Recommendation to raise Target CPA.
نمایندگی JSON |
---|
{ "targetAdjustment": { object ( |
زمینه های | |
---|---|
targetAdjustment | Output only. The relevant information describing the recommended target adjustment. |
appBiddingGoal | Output only. Represents the goal towards which the bidding strategy should optimize. Only populated for App Campaigns. |
TargetAdjustmentInfo
Information of a target adjustment recommendation.
نمایندگی JSON |
---|
{ "recommendedTargetMultiplier": number, "currentAverageTargetMicros": string, "sharedSet": string } |
زمینه های | |
---|---|
recommendedTargetMultiplier | Output only. The factor by which we recommend the target to be adjusted by. |
currentAverageTargetMicros | Output only. The current average target of the campaign or portfolio targeted by this recommendation. |
sharedSet | Output only. The shared set resource name of the portfolio bidding strategy where the target is defined. Only populated if the recommendation is portfolio level. |
AppBiddingGoal
Represents the goal towards which the bidding strategy, of an app campaign, should optimize for.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Represents value unknown in this version of the API. |
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME | The bidding strategy of the app campaign should aim to maximize installation of the app. |
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME | The bidding strategy of the app campaign should aim to maximize the selected in-app conversions' volume. |
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE | The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions. |
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION | The bidding strategy of the app campaign should aim to maximize just the selected in-app conversion's volume, while achieving or exceeding target cost per in-app conversion. |
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND | The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions while achieving or exceeding target return on advertising spend. |
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI | This bidding strategy of the app campaign should aim to maximize installation of the app without advertiser-provided target cost-per-install. |
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME | This bidding strategy of the app campaign should aim to maximize pre-registration of the app. |
LowerTargetRoasRecommendation
Recommendation to lower Target ROAS.
نمایندگی JSON |
---|
{
"targetAdjustment": {
object ( |
زمینه های | |
---|---|
targetAdjustment | Output only. The relevant information describing the recommended target adjustment. |
PerformanceMaxOptInRecommendation
This type has no fields.
The Performance Max Opt In recommendation.
ImprovePerformanceMaxAdStrengthRecommendation
Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating.
نمایندگی JSON |
---|
{ "assetGroup": string } |
زمینه های | |
---|---|
assetGroup | Output only. The asset group resource name. |
MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
The Dynamic Search Ads to Performance Max migration recommendation.
نمایندگی JSON |
---|
{ "applyLink": string } |
زمینه های | |
---|---|
applyLink | Output only. A link to the Google Ads UI where the customer can manually apply the recommendation. |
SearchTermView
A search term view with metrics aggregated by search term at the ad group level.
نمایندگی JSON |
---|
{
"resourceName": string,
"status": enum ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the search term view. Search term view resource names have the form: |
status | Output only. Indicates whether the search term is currently one of your targeted or excluded keywords. |
searchTerm | Output only. The search term. |
adGroup | Output only. The ad group the search term served in. |
SearchTermTargetingStatus
Indicates whether the search term is one of your targeted or excluded keywords.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
ADDED | Search term is added to targeted keywords. |
EXCLUDED | Search term matches a negative keyword. |
ADDED_EXCLUDED | Search term has been both added and excluded. |
NONE | Search term is neither targeted nor excluded. |
ShoppingPerformanceView
Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: |
SmartCampaignSearchTermView
A Smart campaign search term view.
نمایندگی JSON |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the Smart campaign search term view. Smart campaign search term view resource names have the form: |
searchTerm | Output only. The search term. |
campaign | Output only. The Smart campaign the search term served in. |
ThirdPartyAppAnalyticsLink
A data sharing connection, allowing the import of third party app analytics into a Google Ads Customer.
نمایندگی JSON |
---|
{ "resourceName": string, "shareableLinkId": string } |
زمینه های | |
---|---|
resourceName | Immutable. The resource name of the third party app analytics link. Third party app analytics link resource names have the form: |
shareableLinkId | Output only. The shareable link ID that should be provided to the third party when setting up app analytics. This is able to be regenerated using regenerate method in the ThirdPartyAppAnalyticsLinkService. |
TopicView
A topic view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the topic view. Topic view resource names have the form: |
TravelActivityGroupView
A travel activity group view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the travel activity group view. Travel Activity Group view resource names have the form: |
TravelActivityPerformanceView
A travel activity performance view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form: |
UserInterest
A user interest: a particular interest-based vertical to be targeted.
نمایندگی JSON |
---|
{ "resourceName": string, "taxonomyType": enum ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the user interest. User interest resource names have the form: |
taxonomyType | Output only. Taxonomy type of the user interest. |
availabilities[] | Output only. Availability information of the user interest. |
userInterestId | Output only. The ID of the user interest. |
name | Output only. The name of the user interest. |
userInterestParent | Output only. The parent of the user interest. |
launchedToAll | Output only. True if the user interest is launched to all channels and locales. |
UserInterestTaxonomyType
Enum containing the possible UserInterestTaxonomyTypes.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
AFFINITY | The affinity for this user interest. |
IN_MARKET | The market for this user interest. |
MOBILE_APP_INSTALL_USER | Users known to have installed applications in the specified categories. |
VERTICAL_GEO | The geographical location of the interest-based vertical. |
NEW_SMART_PHONE_USER | User interest criteria for new smart phone users. |
LifeEvent
A life event: a particular interest-based vertical to be targeted to reach users when they are in the midst of important life milestones.
نمایندگی JSON |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the life event. Life event resource names have the form: |
id | Output only. The ID of the life event. |
name | Output only. The name of the life event, for example,"Recently Moved" |
parent | Output only. The parent of the lifeEvent. |
launchedToAll | Output only. True if the life event is launched to all channels and locales. |
availabilities[] | Output only. Availability information of the life event. |
UserLocationView
A user location view.
User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.
نمایندگی JSON |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the user location view. UserLocation view resource names have the form: |
countryCriterionId | Output only. Criterion Id for the country. |
targetingLocation | Output only. Indicates whether location was targeted or not. |
TopicConstant
Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").
نمایندگی JSON |
---|
{ "resourceName": string, "path": [ string ], "id": string, "topicConstantParent": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the topic constant. topic constant resource names have the form: |
path[] | Output only. The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, {"Pets & Animals", "Pets", "Dogs"} represents the "Pets & Animals/Pets/Dogs" category. List of available topic categories at https://developers.google.com/google-ads/api/reference/data/verticals |
id | Output only. The ID of the topic. |
topicConstantParent | Output only. Resource name of parent of the topic constant. |
ویدئو
A video.
نمایندگی JSON |
---|
{ "resourceName": string, "id": string, "channelId": string, "durationMillis": string, "title": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the video. Video resource names have the form: |
id | Output only. The ID of the video. |
channelId | Output only. The owner channel id of the video. |
durationMillis | Output only. The duration of the video in milliseconds. |
title | Output only. The title of the video. |
WebpageView
A webpage view.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the webpage view. Webpage view resource names have the form: |
LeadFormSubmissionData
Data from lead form submissions.
نمایندگی JSON |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
زمینه های | |
---|---|
resourceName | Output only. The resource name of the lead form submission data. Lead form submission data resource names have the form: |
id | Output only. ID of this lead form submission. |
asset | Output only. Asset associated with the submitted lead form. |
campaign | Output only. Campaign associated with the submitted lead form. |
leadFormSubmissionFields[] | Output only. Submission data associated with a lead form. |
customLeadFormSubmissionFields[] | Output only. Submission data associated with a custom lead form. |
adGroup | Output only. AdGroup associated with the submitted lead form. |
adGroupAd | Output only. AdGroupAd associated with the submitted lead form. |
gclid | Output only. Google Click Id associated with the submissed lead form. |
submissionDateTime | Output only. The date and time at which the lead form was submitted. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", for example, "2019-01-01 12:32:45-08:00". |
LeadFormSubmissionField
Fields in the submitted lead form.
نمایندگی JSON |
---|
{
"fieldType": enum ( |
زمینه های | |
---|---|
fieldType | Output only. Field type for lead form fields. |
fieldValue | Output only. Field value for lead form fields. |
CustomLeadFormSubmissionField
Fields in the submitted custom question
نمایندگی JSON |
---|
{ "questionText": string, "fieldValue": string } |
زمینه های | |
---|---|
questionText | Output only. Question text for custom question, maximum number of characters is 300. |
fieldValue | Output only. Field value for custom question response, maximum number of characters is 70. |
معیارهای
Metrics data.
نمایندگی JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionsValueByConversionDate": number, "conversionsByConversionDate": number, "historicalCreativeQualityScore": enum ( |
زمینه های | |
---|---|
allConversionsValueByConversionDate | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 . |
allConversionsByConversionDate | The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 . |
conversionsValueByConversionDate | The value of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 . |
conversionsByConversionDate | The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 . |
historicalCreativeQualityScore | The creative historical quality score. |
historicalLandingPageQualityScore | The quality of historical landing page experience. |
historicalSearchPredictedCtr | The historical search predicted click through rate (CTR). |
interactionEventTypes[] | The types of payable and free interactions. |
skAdNetworkConversions | The number of iOS Store Kit Ad Network conversions. |
publisherPurchasedClicks | Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity |
publisherOrganicClicks | Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity |
publisherUnknownClicks | Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" |
absoluteTopImpressionPercentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
activeViewCpm | Average cost of viewable impressions ( |
activeViewCtr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network. |
activeViewImpressions | A measurement of how often your ad has become viewable on a Display Network site. |
activeViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
activeViewMeasurableCostMicros | The cost of the impressions you received that were measurable by Active View. |
activeViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. |
activeViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
allConversionsFromInteractionsRate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
allConversionsValue | The value of all conversions. |
allNewCustomerLifetimeValue | All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "allConversionsValue". See https://support.google.com/google-ads/answer/12080169 for more details. |
allConversions | The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. |
allConversionsValuePerCost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
allConversionsFromClickToCall | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
allConversionsFromDirections | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
allConversionsFromInteractionsValuePerInteraction | The value of all conversions from interactions divided by the total number of interactions. |
allConversionsFromMenu | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
allConversionsFromOrder | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
allConversionsFromOtherEngagement | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
allConversionsFromStoreVisit | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
allConversionsFromStoreWebsite | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
auctionInsightSearchAbsoluteTopImpressionPercentage | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed in the most prominent position on the search results page. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
auctionInsightSearchImpressionShare | This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
auctionInsightSearchOutrankingShare | This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
auctionInsightSearchOverlapRate | This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. |
auctionInsightSearchPositionAboveRate | This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. |
auctionInsightSearchTopImpressionPercentage | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed adjacent to the top organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
averageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
averageCpc | The total cost of all clicks divided by the total number of clicks received. |
averageCpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
averageCpm | Average cost-per-thousand impressions (CPM). |
averageCpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
averagePageViews | Average number of pages viewed per session. |
averageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
benchmarkAverageMaxCpc | An indication of how other advertisers are bidding on similar products. |
biddableAppInstallConversions | Number of app installs. |
biddableAppPostInstallConversions | Number of in-app actions. |
benchmarkCtr | An indication on how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad click on it. |
bounceRate | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
clicks | The number of clicks. |
combinedClicks | The number of times your ad or your site's listing in the unpaid results was clicked. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
combinedClicksPerQuery | The number of times your ad or your site's listing in the unpaid results was clicked (combinedClicks) divided by combinedQueries. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
combinedQueries | The number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
contentBudgetLostImpressionShare | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
contentImpressionShare | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
conversionLastReceivedRequestDateTime | The last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (for example, because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone. |
conversionLastConversionDate | The date of the most recent conversion for this conversion action. The date is in the customer's time zone. |
contentRankLostImpressionShare | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversionsFromInteractionsRate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversionsValue | The value of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
newCustomerLifetimeValue | New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversionsValue" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. |
conversionsValuePerCost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversionsFromInteractionsValuePerInteraction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions | The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
costMicros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
costPerAllConversions | The cost of ad interactions divided by all conversions. |
costPerConversion | The cost of ad interactions divided by conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
costPerCurrentModelAttributedConversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
crossDeviceConversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in allConversions. |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
currentModelAttributedConversions | Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsFromInteractionsRate | Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsFromInteractionsValuePerInteraction | The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsValue | The value of current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
currentModelAttributedConversionsValuePerCost | The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
engagementRate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
hotelAverageLeadValueMicros | Average lead value based on clicks. |
hotelCommissionRateMicros | Commission bid rate in micros. A 20% commission is represented as 200,000. |
hotelExpectedCommissionCost | Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency. |
hotelPriceDifferencePercentage | The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. |
hotelEligibleImpressions | The number of impressions that hotel partners could have had given their feed performance. |
historicalQualityScore | The historical quality score. |
gmailForwards | The number of times the ad was forwarded to someone else as a message. |
gmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. |
gmailSecondaryClicks | The number of clicks to the landing page on the expanded state of Gmail ads. |
impressionsFromStoreReach | The number of times a store's location-based ad was shown. This metric applies to feed items only. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interactionRate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalidClickRate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalidClicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
messageChats | Number of message chats initiated for Click To Message impressions that were message tracking eligible. |
messageImpressions | Number of Click To Message impressions that were message tracking eligible. |
messageChatRate | Number of message chats initiated (messageChats) divided by the number of message impressions (messageImpressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression. |
mobileFriendlyClicksPercentage | The percentage of mobile clicks that go to a mobile-friendly page. |
optimizationScoreUplift | Total optimization score uplift of all recommendations. |
optimizationScoreUrl | URL for the optimization score page in the Google Ads web interface. This metric can be selected from |
organicClicks | The number of times someone clicked your site's listing in the unpaid results for a particular query. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicClicksPerQuery | The number of times someone clicked your site's listing in the unpaid results (organicClicks) divided by the total number of searches that returned pages from your site (organicQueries). See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicImpressions | The number of listings for your site in the unpaid search results. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicImpressionsPerQuery | The number of times a page from your site was listed in the unpaid search results (organicImpressions) divided by the number of searches returning your site's listing in the unpaid results (organicQueries). See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
organicQueries | The total number of searches that returned your site's listing in the unpaid results. See the help page at https://support.google.com/google-ads/answer/3097241 for details. |
percentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
phoneCalls | Number of offline phone calls. |
phoneImpressions | Number of offline phone impressions. |
phoneThroughRate | Number of phone calls received (phoneCalls) divided by the number of times your phone number is shown (phoneImpressions). |
relativeCtr | Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
searchAbsoluteTopImpressionShare | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999. |
searchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchBudgetLostImpressionShare | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchBudgetLostTopImpressionShare | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchClickShare | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
searchExactMatchImpressionShare | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
searchImpressionShare | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
searchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchRankLostTopImpressionShare | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
searchTopImpressionShare | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
searchVolume | Search volume range for a search term insight category. |
speedScore | A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest. |
averageTargetCpaMicros | The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA). |
averageTargetRoas | The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS). |
topImpressionPercentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
validAcceleratedMobilePagesClicksPercentage | The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. |
valuePerAllConversions | The value of all conversions divided by the number of all conversions. |
valuePerAllConversionsByConversionDate | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 . |
valuePerConversion | The value of conversions divided by the number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
valuePerConversionsByConversionDate | The value of conversions divided by the number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 . |
valuePerCurrentModelAttributedConversion | The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
videoQuartileP100Rate | Percentage of impressions where the viewer watched all of your video. |
videoQuartileP25Rate | Percentage of impressions where the viewer watched 25% of your video. |
videoQuartileP50Rate | Percentage of impressions where the viewer watched 50% of your video. |
videoQuartileP75Rate | Percentage of impressions where the viewer watched 75% of your video. |
videoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
videoViews | The number of times your video ads were viewed. |
viewThroughConversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
allConversionsFromLocationAssetClickToCall | Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetDirections | Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetMenu | Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetOrder | Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetOtherEngagement | Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetStoreVisits | Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
allConversionsFromLocationAssetWebsite | Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
eligibleImpressionsFromLocationAssetStoreReach | Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetClickToCall | Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetDirections | Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetMenu | Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetOrder | Number of order clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetOtherEngagement | Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetStoreVisits | Estimated number of visits to the store after an impression. This measure is coming from Asset based location. |
viewThroughConversionsFromLocationAssetWebsite | Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. |
InteractionEventType
Enum describing possible types of payable and free interactions.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
CLICK | Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events. |
ENGAGEMENT | The user's expressed intent to engage with the ad in-place. |
VIDEO_VIEW | User viewed a video ad. |
NONE | The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (for example, the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions. |
SearchVolumeRange
Search volume range. Actual search volume falls within this range.
نمایندگی JSON |
---|
{ "min": string, "max": string } |
زمینه های | |
---|---|
min | Lower bound of search volume. |
max | Upper bound of search volume. |
بخش ها
Segment only fields.
نمایندگی JSON |
---|
{ "adDestinationType": enum ( |
زمینه های | |
---|---|
adDestinationType | Ad Destination type. |
adNetworkType | Ad network type. |
budgetCampaignAssociationStatus | Budget campaign association status. |
clickType | Click type. |
conversionActionCategory | Conversion action category. |
conversionAttributionEventType | Conversion attribution event type. |
conversionLagBucket | An enum value representing the number of days between the impression and the conversion. |
conversionOrAdjustmentLagBucket | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
dayOfWeek | Day of the week, for example, MONDAY. |
device | Device to which metrics apply. |
externalConversionSource | External conversion source. |
hotelCheckInDayOfWeek | Hotel check-in day of week. |
hotelDateSelectionType | Hotel date selection type. |
hotelRateType | Hotel rate type. |
hotelPriceBucket | Hotel price bucket. |
keyword | Keyword criterion. |
monthOfYear | Month of the year, for example, January. |
placeholderType | Placeholder type. This is only used with feed item metrics. |
productChannel | Channel of the product. |
productChannelExclusivity | Channel exclusivity of the product. |
productCondition | Condition of the product. |
recommendationType | Recommendation type. |
searchEngineResultsPageType | Type of the search engine results page. |
searchTermMatchType | Match type of the keyword that triggered the ad, including variants. |
slot | Position of the ad. |
conversionValueRulePrimaryDimension | Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. |
skAdNetworkUserType | iOS Store Kit Ad Network user type. |
skAdNetworkAdEventType | iOS Store Kit Ad Network ad event type. |
skAdNetworkAttributionCredit | iOS Store Kit Ad Network attribution credit |
newVersusReturningCustomers | This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. |
activityAccountId | Activity account ID. |
activityRating | Activity rating. |
externalActivityId | Advertiser supplied activity ID. |
adGroup | Resource name of the ad group. |
assetGroup | Resource name of the asset group. |
auctionInsightDomain | Domain (visible URL) of a participant in the Auction Insights report. |
campaign | Resource name of the campaign. |
conversionAction | Resource name of the conversion action. |
conversionActionName | Conversion action name. |
conversionAdjustment | This segments your conversion columns by the original conversion and conversion value versus the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data. |
date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
geoTargetAirport | Resource name of the geo target constant that represents an airport. |
geoTargetCanton | Resource name of the geo target constant that represents a canton. |
geoTargetCity | Resource name of the geo target constant that represents a city. |
geoTargetCountry | Resource name of the geo target constant that represents a country. |
geoTargetCounty | Resource name of the geo target constant that represents a county. |
geoTargetDistrict | Resource name of the geo target constant that represents a district. |
geoTargetMetro | Resource name of the geo target constant that represents a metro. |
geoTargetMostSpecificLocation | Resource name of the geo target constant that represents the most specific location. |
geoTargetPostalCode | Resource name of the geo target constant that represents a postal code. |
geoTargetProvince | Resource name of the geo target constant that represents a province. |
geoTargetRegion | Resource name of the geo target constant that represents a region. |
geoTargetState | Resource name of the geo target constant that represents a state. |
hotelBookingWindowDays | Hotel booking window in days. |
hotelCenterId | Hotel center ID. |
hotelCheckInDate | Hotel check-in date. Formatted as yyyy-MM-dd. |
hotelCity | Hotel city. |
hotelClass | Hotel class. |
hotelCountry | Hotel country. |
hotelLengthOfStay | Hotel length of stay. |
hotelRateRuleId | Hotel rate rule ID. |
hotelState | Hotel state. |
hour | Hour of day as a number between 0 and 23, inclusive. |
interactionOnThisExtension | Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. |
month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
partnerHotelId | Partner hotel ID. |
productAggregatorId | Aggregator ID of the product. |
productBiddingCategoryLevel1 | Bidding category (level 1) of the product. |
productBiddingCategoryLevel2 | Bidding category (level 2) of the product. |
productBiddingCategoryLevel3 | Bidding category (level 3) of the product. |
productBiddingCategoryLevel4 | Bidding category (level 4) of the product. |
productBiddingCategoryLevel5 | Bidding category (level 5) of the product. |
productBrand | Brand of the product. |
productCountry | Resource name of the geo target constant for the country of sale of the product. |
productCustomAttribute0 | Custom attribute 0 of the product. |
productCustomAttribute1 | Custom attribute 1 of the product. |
productCustomAttribute2 | Custom attribute 2 of the product. |
productCustomAttribute3 | Custom attribute 3 of the product. |
productCustomAttribute4 | Custom attribute 4 of the product. |
productFeedLabel | Feed label of the product. |
productItemId | Item ID of the product. |
productLanguage | Resource name of the language constant for the language of the product. |
productMerchantId | Merchant ID of the product. |
productStoreId | Store ID of the product. |
productTitle | Title of the product. |
productTypeL1 | Type (level 1) of the product. |
productTypeL2 | Type (level 2) of the product. |
productTypeL3 | Type (level 3) of the product. |
productTypeL4 | Type (level 4) of the product. |
productTypeL5 | Type (level 5) of the product. |
quarter | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
searchSubcategory | A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory. |
searchTerm | A search term. |
webpage | Resource name of the ad group criterion that represents webpage criterion. |
week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
year | Year, formatted as yyyy. |
skAdNetworkConversionValue | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign. |
skAdNetworkSourceApp | App where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. |
assetInteractionTarget | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interactionOnThisAsset is true, it means the interactions are on this specific asset and when interactionOnThisAsset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with. |
AdDestinationType
Enumerates Google Ads destination types
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | The value is unknown in this version. |
NOT_APPLICABLE | Ads that don't intend to drive users off from ads to other destinations |
WEBSITE | سایت اینترنتی |
APP_DEEP_LINK | App Deep Link |
APP_STORE | iOS App Store or Play Store |
PHONE_CALL | Call Dialer |
MAP_DIRECTIONS | Map App |
LOCATION_LISTING | Location Dedicated Page |
MESSAGE | پیام متنی |
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_SEARCH | YouTube Search. |
YOUTUBE_WATCH | ویدئوهای یوتیوب |
MIXED | Cross-network. |
BudgetCampaignAssociationStatus
A BudgetCampaignAssociationStatus segment.
نمایندگی JSON |
---|
{
"status": enum ( |
زمینه های | |
---|---|
status | Budget campaign association status. |
campaign | The campaign resource name. |
BudgetCampaignAssociationStatus
Possible statuses of the association between the Budget and the Campaign.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
ENABLED | The campaign is currently using the budget. |
REMOVED | The campaign is no longer using the budget. |
ClickType
Enumerates Google Ads click types.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | The value is unknown in this version. |
APP_DEEPLINK | App engagement ad deep link. |
BREADCRUMBS | پودرهای سوخاری. |
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. |
SITELINKS | Sitelink. |
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 | سایت اینترنتی. |
VISUAL_SITELINKS | Visual Sitelinks. |
WIRELESS_PLAN | Wireless Plan. |
PRODUCT_LISTING_AD_LOCAL | Shopping - Product - Local. |
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL | Shopping - Product - MultiChannel Local. |
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE | Shopping - Product - MultiChannel Online. |
PRODUCT_LISTING_ADS_COUPON | Shopping - Product - Coupon. |
PRODUCT_LISTING_AD_TRANSACTABLE | Shopping - Product - Sell on Google. |
PRODUCT_AD_APP_DEEPLINK | Shopping - Product - App engagement ad deep link. |
SHOWCASE_AD_CATEGORY_LINK | Shopping - Showcase - Category. |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK | Shopping - Showcase - Local storefront. |
SHOWCASE_AD_ONLINE_PRODUCT_LINK | Shopping - Showcase - Online product. |
SHOWCASE_AD_LOCAL_PRODUCT_LINK | Shopping - Showcase - Local product. |
PROMOTION_EXTENSION | Promotion Extension. |
SWIPEABLE_GALLERY_AD_HEADLINE | Ad Headline. |
SWIPEABLE_GALLERY_AD_SWIPES | Swipes. |
SWIPEABLE_GALLERY_AD_SEE_MORE | بیشتر ببین. |
SWIPEABLE_GALLERY_AD_SITELINK_ONE | Sitelink 1. |
SWIPEABLE_GALLERY_AD_SITELINK_TWO | Sitelink 2. |
SWIPEABLE_GALLERY_AD_SITELINK_THREE | Sitelink 3. |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR | Sitelink 4. |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE | Sitelink 5. |
HOTEL_PRICE | Hotel price. |
PRICE_EXTENSION | Price Extension. |
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION | Book on Google hotel room selection. |
SHOPPING_COMPARISON_LISTING | Shopping - Comparison Listing. |
CROSS_NETWORK | Cross-network. From Performance Max and Discovery Campaigns. |
ConversionAttributionEventType
The event type of conversions that are attributed to.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Represents value unknown in this version. |
IMPRESSION | The conversion is attributed to an impression. |
INTERACTION | The conversion is attributed to an interaction. |
ConversionLagBucket
Enum representing the number of days between impression and conversion.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
LESS_THAN_ONE_DAY | Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
ONE_TO_TWO_DAYS | Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
TWO_TO_THREE_DAYS | Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
THREE_TO_FOUR_DAYS | Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
FOUR_TO_FIVE_DAYS | Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
FIVE_TO_SIX_DAYS | Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
SIX_TO_SEVEN_DAYS | Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
SEVEN_TO_EIGHT_DAYS | Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
EIGHT_TO_NINE_DAYS | Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
NINE_TO_TEN_DAYS | Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
TEN_TO_ELEVEN_DAYS | Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
ELEVEN_TO_TWELVE_DAYS | Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
TWELVE_TO_THIRTEEN_DAYS | Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
THIRTEEN_TO_FOURTEEN_DAYS | Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
FOURTEEN_TO_TWENTY_ONE_DAYS | Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
TWENTY_ONE_TO_THIRTY_DAYS | Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
THIRTY_TO_FORTY_FIVE_DAYS | Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
FORTY_FIVE_TO_SIXTY_DAYS | Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
SIXTY_TO_NINETY_DAYS | Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ConversionOrAdjustmentLagBucket
Enum representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
CONVERSION_LESS_THAN_ONE_DAY | Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
CONVERSION_ONE_TO_TWO_DAYS | Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
CONVERSION_TWO_TO_THREE_DAYS | Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
CONVERSION_THREE_TO_FOUR_DAYS | Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
CONVERSION_FOUR_TO_FIVE_DAYS | Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
CONVERSION_FIVE_TO_SIX_DAYS | Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
CONVERSION_SIX_TO_SEVEN_DAYS | Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
CONVERSION_SEVEN_TO_EIGHT_DAYS | Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
CONVERSION_EIGHT_TO_NINE_DAYS | Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
CONVERSION_NINE_TO_TEN_DAYS | Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
CONVERSION_TEN_TO_ELEVEN_DAYS | Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
CONVERSION_ELEVEN_TO_TWELVE_DAYS | Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
CONVERSION_TWELVE_TO_THIRTEEN_DAYS | Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS | Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS | Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS | Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS | Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS | Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
CONVERSION_SIXTY_TO_NINETY_DAYS | Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ADJUSTMENT_LESS_THAN_ONE_DAY | Conversion adjustment lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
ADJUSTMENT_ONE_TO_TWO_DAYS | Conversion adjustment lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
ADJUSTMENT_TWO_TO_THREE_DAYS | Conversion adjustment lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
ADJUSTMENT_THREE_TO_FOUR_DAYS | Conversion adjustment lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
ADJUSTMENT_FOUR_TO_FIVE_DAYS | Conversion adjustment lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
ADJUSTMENT_FIVE_TO_SIX_DAYS | Conversion adjustment lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
ADJUSTMENT_SIX_TO_SEVEN_DAYS | Conversion adjustment lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS | Conversion adjustment lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
ADJUSTMENT_EIGHT_TO_NINE_DAYS | Conversion adjustment lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
ADJUSTMENT_NINE_TO_TEN_DAYS | Conversion adjustment lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
ADJUSTMENT_TEN_TO_ELEVEN_DAYS | Conversion adjustment lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS | Conversion adjustment lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS | Conversion adjustment lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS | Conversion adjustment lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS | Conversion adjustment lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS | Conversion adjustment lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS | Conversion adjustment lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS | Conversion adjustment lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
ADJUSTMENT_SIXTY_TO_NINETY_DAYS | Conversion adjustment lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS | Conversion adjustment lag bucket from 90 to 145 days. 90 days is included, 145 days is not. |
CONVERSION_UNKNOWN | Conversion lag bucket UNKNOWN. This is for dates before conversion lag bucket was available in Google Ads. |
ADJUSTMENT_UNKNOWN | Conversion adjustment lag bucket UNKNOWN. This is for dates before conversion adjustment lag bucket was available in Google Ads. |
ExternalConversionSource
The external conversion source that is associated with a ConversionAction.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Represents value unknown in this version. |
WEBPAGE | Conversion that occurs when a user navigates to a particular webpage after viewing an ad; Displayed in Google Ads UI as 'Website'. |
ANALYTICS | Conversion that comes from linked Google Analytics goal or transaction; Displayed in Google Ads UI as 'Analytics'. |
UPLOAD | Website conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from clicks'. |
AD_CALL_METRICS | Conversion that occurs when a user clicks on a call extension directly on an ad; Displayed in Google Ads UI as 'Calls from ads'. |
WEBSITE_CALL_METRICS | Conversion that occurs when a user calls a dynamically-generated phone number (by installed javascript) from an advertiser's website after clicking on an ad; Displayed in Google Ads UI as 'Calls from website'. |
STORE_VISITS | Conversion that occurs when a user visits an advertiser's retail store after clicking on a Google ad; Displayed in Google Ads UI as 'Store visits'. |
ANDROID_IN_APP | Conversion that occurs when a user takes an in-app action such as a purchase in an Android app; Displayed in Google Ads UI as 'Android in-app action'. |
IOS_IN_APP | Conversion that occurs when a user takes an in-app action such as a purchase in an iOS app; Displayed in Google Ads UI as 'iOS in-app action'. |
IOS_FIRST_OPEN | Conversion that occurs when a user opens an iOS app for the first time; Displayed in Google Ads UI as 'iOS app install (first open)'. |
APP_UNSPECIFIED | Legacy app conversions that do not have an AppPlatform provided; Displayed in Google Ads UI as 'Mobile app'. |
ANDROID_FIRST_OPEN | Conversion that occurs when a user opens an Android app for the first time; Displayed in Google Ads UI as 'Android app install (first open)'. |
UPLOAD_CALLS | Call conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from calls'. |
FIREBASE | Conversion that comes from a linked Firebase event; Displayed in Google Ads UI as 'Firebase'. |
CLICK_TO_CALL | Conversion that occurs when a user clicks on a mobile phone number; Displayed in Google Ads UI as 'Phone number clicks'. |
SALESFORCE | Conversion that comes from Salesforce; Displayed in Google Ads UI as 'Salesforce.com'. |
STORE_SALES_CRM | Conversion that comes from in-store purchases recorded by CRM; Displayed in Google Ads UI as 'Store sales (data partner)'. |
STORE_SALES_PAYMENT_NETWORK | Conversion that comes from in-store purchases from payment network; Displayed in Google Ads UI as 'Store sales (payment network)'. |
GOOGLE_PLAY | Codeless Google Play conversion; Displayed in Google Ads UI as 'Google Play'. |
THIRD_PARTY_APP_ANALYTICS | Conversion that comes from a linked third-party app analytics event; Displayed in Google Ads UI as 'Third-party app analytics'. |
GOOGLE_ATTRIBUTION | Conversion that is controlled by Google Attribution. |
STORE_SALES_DIRECT_UPLOAD | Store Sales conversion based on first-party or third-party merchant data uploads. Displayed in Google Ads UI as 'Store sales (direct upload)'. |
STORE_SALES | Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Displayed in Google Ads UI as 'Store sales'. |
SEARCH_ADS_360 | Conversions imported from Search Ads 360 Floodlight data. |
GOOGLE_HOSTED | Conversions that track local actions from Google's products and services after interacting with an ad. |
FLOODLIGHT | Conversions reported by Floodlight tags. |
ANALYTICS_SEARCH_ADS_360 | Conversions that come from Google Analytics specifically for Search Ads 360. Displayed in Google Ads UI as Analytics (SA360). |
FIREBASE_SEARCH_ADS_360 | Conversion that comes from a linked Firebase event for Search Ads 360. |
DISPLAY_AND_VIDEO_360_FLOODLIGHT | Conversion that is reported by Floodlight for DV360. |
HotelRateType
Enum describing possible hotel rate types.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | The value is unknown in this version. |
UNAVAILABLE | Rate type information is unavailable. |
PUBLIC_RATE | Rates available to everyone. |
QUALIFIED_RATE | A membership program rate is available and satisfies basic requirements like having a public rate available. UI treatment will strikethrough the public rate and indicate that a discount is available to the user. For more on Qualified Rates, visit https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates |
PRIVATE_RATE | Rates available to users that satisfy some eligibility criteria, for example, all signed-in users, 20% of mobile users, all mobile users in Canada, etc. |
HotelPriceBucket
Enum describing possible hotel price buckets.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | The value is unknown in this version. |
LOWEST_UNIQUE | Uniquely lowest price. Partner has the lowest price, and no other partners are within a small variance of that price. |
LOWEST_TIED | Tied for lowest price. Partner is within a small variance of the lowest price. |
NOT_LOWEST | Not lowest price. Partner is not within a small variance of the lowest price. |
ONLY_PARTNER_SHOWN | Partner was the only one shown. |
کلمه کلیدی
A Keyword criterion segment.
نمایندگی JSON |
---|
{
"info": {
object ( |
زمینه های | |
---|---|
info | Keyword info. |
adGroupCriterion | The AdGroupCriterion resource name. |
SearchEngineResultsPageType
The type of the search engine results page.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
ADS_ONLY | Only ads were contained in the search engine results page. |
ORGANIC_ONLY | Only organic results were contained in the search engine results page. |
ADS_AND_ORGANIC | Both ads and organic results were contained in the search engine results page. |
SearchTermMatchType
Possible match types for a keyword triggering an ad, including variants.
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | Used for return value only. Represents value unknown in this version. |
BROAD | Broad match. |
EXACT | مطابقت کامل. |
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 | 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 | The asset resource name. |
interactionOnThisAsset | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. |
ConvertingUserPriorEngagementTypeAndLtvBucket
Enumerates converting user prior engagement types and lifetime-value bucket
Enums | |
---|---|
UNSPECIFIED | Not specified. |
UNKNOWN | The value is unknown in this version. |
NEW | Converting user is new to the advertiser. |
RETURNING | Converting user is returning to the advertiser. Definition of returning differs among conversion types, such as a second store visit versus a second online purchase. |
NEW_AND_HIGH_LTV | Converting user is new to the advertiser and has high lifetime value. |