GoogleAdsRow

Возвращенная строка из запроса.

JSON-представление
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
Поля
accountBudget

object ( AccountBudget )

Бюджет аккаунта в запросе.

accountBudgetProposal

object ( AccountBudgetProposal )

Предложение по бюджету аккаунта, указанное в запросе.

adGroup

object ( AdGroup )

Группа объявлений, указанная в запросе.

adGroupAd

object ( AdGroupAd )

Объявление, указанное в запросе.

adGroupAdAssetCombinationView

object ( AdGroupAdAssetCombinationView )

Представление комбинации рекламных объектов группы объявлений в запросе.

adGroupAdAssetView

object ( AdGroupAdAssetView )

Представление рекламного объекта группы объявлений в запросе.

adGroupAdLabel

object ( AdGroupAdLabel )

Ярлык объявления группы объявлений, указанный в запросе.

adGroupAsset

object ( AdGroupAsset )

Объект группы объявлений, указанный в запросе.

adGroupAssetSet

object ( AdGroupAssetSet )

Набор объектов группы объявлений, указанный в запросе.

adGroupAudienceView

object ( AdGroupAudienceView )

Представление аудитории группы объявлений, указанное в запросе.

adGroupBidModifier

object ( AdGroupBidModifier )

Модификатор ставки, указанный в запросе.

adGroupCriterion

object ( AdGroupCriterion )

Критерий, указанный в запросе.

adGroupCriterionCustomizer

object ( AdGroupCriterionCustomizer )

Модификатор критерия группы объявлений, указанный в запросе.

adGroupCriterionLabel

object ( AdGroupCriterionLabel )

Метка критерия группы объявлений, указанная в запросе.

adGroupCriterionSimulation

object ( AdGroupCriterionSimulation )

Моделирование критерия группы объявлений, указанное в запросе.

adGroupCustomizer

object ( AdGroupCustomizer )

Модификатор группы объявлений, указанный в запросе.

adGroupExtensionSetting

object ( AdGroupExtensionSetting )

Настройка расширения группы объявлений, указанная в запросе.

adGroupFeed

object ( AdGroupFeed )

Фид группы объявлений, указанный в запросе.

adGroupLabel

object ( AdGroupLabel )

Ярлык группы объявлений, указанный в запросе.

adGroupSimulation

object ( AdGroupSimulation )

Моделирование группы объявлений, указанное в запросе.

adParameter

object ( AdParameter )

Параметр объявления, указанный в запросе.

ageRangeView

object ( AgeRangeView )

Представление возрастного диапазона, указанное в запросе.

adScheduleView

object ( AdScheduleView )

Представление расписания показа объявлений, указанное в запросе.

domainCategory

object ( DomainCategory )

Категория домена, указанная в запросе.

asset

object ( Asset )

Актив, указанный в запросе.

assetFieldTypeView

object ( AssetFieldTypeView )

Представление типа поля актива, указанное в запросе.

assetGroupAsset

object ( AssetGroupAsset )

Актив группы активов, указанный в запросе.

assetGroupSignal

object ( AssetGroupSignal )

Сигнал группы активов, указанный в запросе.

assetGroupListingGroupFilter

object ( AssetGroupListingGroupFilter )

Фильтр группы списков групп активов, на который ссылается запрос.

assetGroupProductGroupView

object ( AssetGroupProductGroupView )

Представление группы продуктов группы активов, указанное в запросе.

assetGroup

object ( AssetGroup )

Группа активов, указанная в запросе.

assetSetAsset

object ( AssetSetAsset )

Актив набора активов, на который ссылается запрос.

assetSet

object ( AssetSet )

Набор активов, на который ссылается запрос.

assetSetTypeView

object ( AssetSetTypeView )

Представление типа набора активов, указанное в запросе.

batchJob

object ( BatchJob )

Пакетное задание, указанное в запросе.

biddingDataExclusion

object ( BiddingDataExclusion )

Исключение данных о ставках, указанное в запросе.

biddingSeasonalityAdjustment

object ( BiddingSeasonalityAdjustment )

Сезонная корректировка ставок, указанная в запросе.

biddingStrategy

object ( BiddingStrategy )

Стратегия назначения ставок, указанная в запросе.

biddingStrategySimulation

object ( BiddingStrategySimulation )

Моделирование стратегии назначения ставок, указанное в запросе.

billingSetup

object ( BillingSetup )

Настройки выставления счетов, указанные в запросе.

callView

object ( CallView )

Представление вызова, указанное в запросе.

campaignBudget

object ( CampaignBudget )

Бюджет кампании, указанный в запросе.

campaign

object ( Campaign )

Кампания, указанная в запросе.

campaignAsset

object ( CampaignAsset )

Актив кампании, указанный в запросе.

campaignAssetSet

object ( CampaignAssetSet )

Набор объектов кампании, указанный в запросе.

campaignAudienceView

object ( CampaignAudienceView )

Представление аудитории кампании, указанное в запросе.

campaignBidModifier

object ( CampaignBidModifier )

Модификатор ставки кампании, указанный в запросе.

campaignConversionGoal

object ( CampaignConversionGoal )

CampaignConversionGoal, указанный в запросе.

campaignCriterion

object ( CampaignCriterion )

Критерий кампании, указанный в запросе.

campaignCustomizer

object ( CampaignCustomizer )

Модификатор кампании, указанный в запросе.

campaignDraft

object ( CampaignDraft )

Проект кампании, указанный в запросе.

campaignExtensionSetting

object ( CampaignExtensionSetting )

Настройка расширения кампании, указанная в запросе.

campaignFeed

object ( CampaignFeed )

Фид кампании, указанный в запросе.

campaignGroup

object ( CampaignGroup )

Группа кампаний, указанная в запросе AWQL.

campaignLabel

object ( CampaignLabel )

Ярлык кампании, указанный в запросе.

campaignSearchTermInsight

object ( CampaignSearchTermInsight )

Анализ поискового запроса кампании, указанный в запросе.

campaignSharedSet

object ( CampaignSharedSet )

Общий набор кампании, указанный в запросе AWQL.

campaignSimulation

object ( CampaignSimulation )

Моделирование кампании, указанное в запросе.

carrierConstant

object ( CarrierConstant )

Константа несущей, указанная в запросе.

changeEvent

object ( ChangeEvent )

ChangeEvent, указанный в запросе.

changeStatus

object ( ChangeStatus )

ChangeStatus, указанный в запросе.

combinedAudience

object ( CombinedAudience )

Комбинированная аудитория, указанная в запросе.

audience

object ( Audience )

Аудитория, указанная в запросе.

conversionAction

object ( ConversionAction )

Действие-конверсия, указанное в запросе.

conversionCustomVariable

object ( ConversionCustomVariable )

Пользовательская переменная преобразования, указанная в запросе.

conversionGoalCampaignConfig

object ( ConversionGoalCampaignConfig )

ConversionGoalCampaignConfig, указанный в запросе.

conversionValueRule

object ( ConversionValueRule )

Правило ценности конверсии, указанное в запросе.

conversionValueRuleSet

object ( ConversionValueRuleSet )

Набор правил ценности конверсии, указанный в запросе.

clickView

object ( ClickView )

ClickView, указанный в запросе.

currencyConstant

object ( CurrencyConstant )

Валютная константа, указанная в запросе.

customAudience

object ( CustomAudience )

CustomAudience, указанный в запросе.

customConversionGoal

object ( CustomConversionGoal )

CustomConversionGoal, указанный в запросе.

customInterest

object ( CustomInterest )

CustomInterest, указанный в запросе.

customer

object ( Customer )

Клиент, указанный в запросе.

customerAsset

object ( CustomerAsset )

Актив клиента, указанный в запросе.

customerAssetSet

object ( CustomerAssetSet )

Набор активов клиента, указанный в запросе.

accessibleBiddingStrategy

object ( AccessibleBiddingStrategy )

Доступная стратегия назначения ставок, указанная в запросе.

customerCustomizer

object ( CustomerCustomizer )

Настройщик клиента, указанный в запросе.

customerClient

object ( CustomerClient )

CustomerClient, указанный в запросе.

customerConversionGoal

object ( CustomerConversionGoal )

CustomerConversionGoal, указанный в запросе.

customerExtensionSetting

object ( CustomerExtensionSetting )

Настройка расширения клиента, указанная в запросе.

customerFeed

object ( CustomerFeed )

Фид клиентов, указанный в запросе.

customerLabel

object ( CustomerLabel )

Ярлык клиента, указанный в запросе.

customerNegativeCriterion

object ( CustomerNegativeCriterion )

Отрицательный критерий клиента, указанный в запросе.

customerSearchTermInsight

object ( CustomerSearchTermInsight )

Анализ поискового запроса клиента, на который ссылается запрос.

customerUserAccess

object ( CustomerUserAccess )

CustomerUserAccess, указанный в запросе.

customerUserAccessInvitation

object ( CustomerUserAccessInvitation )

CustomerUserAccessInvitation, указанный в запросе.

customizerAttribute

object ( CustomizerAttribute )

Атрибут настройщика, указанный в запросе.

detailPlacementView

object ( DetailPlacementView )

Подробное представление размещения, указанное в запросе.

detailedDemographic

object ( DetailedDemographic )

Подробные демографические данные, указанные в запросе.

displayKeywordView

object ( DisplayKeywordView )

Представление ключевого слова отображения, указанное в запросе.

distanceView

object ( DistanceView )

Представление на расстоянии, указанное в запросе.

dynamicSearchAdsSearchTermView

object ( DynamicSearchAdsSearchTermView )

Представление поискового запроса в динамических поисковых объявлениях, указанное в запросе.

expandedLandingPageView

object ( ExpandedLandingPageView )

Расширенное представление целевой страницы, указанное в запросе.

extensionFeedItem

object ( ExtensionFeedItem )

Элемент фида расширения, указанный в запросе.

feed

object ( Feed )

Фид, указанный в запросе.

feedItem

object ( FeedItem )

Элемент фида, на который ссылается запрос.

feedItemSet

object ( FeedItemSet )

Набор элементов фида, на который ссылается запрос.

feedItemTarget

object ( FeedItemTarget )

Цель элемента фида, указанная в запросе.

feedMapping

object ( FeedMapping )

Сопоставление фида, указанное в запросе.

feedPlaceholderView

object ( FeedPlaceholderView )

Представление заполнителя канала, указанное в запросе.

genderView

object ( GenderView )

Половое представление, указанное в запросе.

geoTargetConstant

object ( GeoTargetConstant )

Константа географической цели, указанная в запросе.

geographicView

object ( GeographicView )

Географическое представление, указанное в запросе.

groupPlacementView

object ( GroupPlacementView )

Представление размещения группы, указанное в запросе.

hotelGroupView

object ( HotelGroupView )

Представление группы отелей, указанное в запросе.

hotelPerformanceView

object ( HotelPerformanceView )

Представление эффективности отеля, указанное в запросе.

hotelReconciliation

object ( HotelReconciliation )

Сверка отелей, указанная в запросе.

incomeRangeView

object ( IncomeRangeView )

Представление диапазона доходов, указанное в запросе.

keywordView

object ( KeywordView )

Представление ключевого слова, указанное в запросе.

keywordPlan

object ( KeywordPlan )

План ключевых слов, указанный в запросе.

keywordPlanCampaign

object ( KeywordPlanCampaign )

Кампания с планом ключевых слов, указанная в запросе.

keywordPlanCampaignKeyword

object ( KeywordPlanCampaignKeyword )

Ключевое слово кампании плана ключевых слов, указанное в запросе.

keywordPlanAdGroup

object ( KeywordPlanAdGroup )

Группа объявлений плана ключевых слов, указанная в запросе.

keywordPlanAdGroupKeyword

object ( KeywordPlanAdGroupKeyword )

Группа объявлений плана ключевых слов, указанная в запросе.

keywordThemeConstant

object ( KeywordThemeConstant )

Константа темы ключевого слова, указанная в запросе.

label

object ( Label )

Метка, указанная в запросе.

landingPageView

object ( LandingPageView )

Представление целевой страницы, указанное в запросе.

languageConstant

object ( LanguageConstant )

Языковая константа, указанная в запросе.

locationView

object ( LocationView )

Представление местоположения, указанное в запросе.

managedPlacementView

object ( ManagedPlacementView )

Представление управляемого места размещения, указанное в запросе.

mediaFile

object ( MediaFile )

Медиа-файл, указанный в запросе.

mobileAppCategoryConstant

object ( MobileAppCategoryConstant )

Константа категории мобильного приложения, указанная в запросе.

mobileDeviceConstant

object ( MobileDeviceConstant )

Константа мобильного устройства, указанная в запросе.

offlineUserDataJob

object ( OfflineUserDataJob )

Автономное задание пользовательских данных, указанное в запросе.

operatingSystemVersionConstant

object ( OperatingSystemVersionConstant )

Константа версии операционной системы, указанная в запросе.

paidOrganicSearchTermView

object ( PaidOrganicSearchTermView )

Просмотр платного обычного поискового запроса, на который ссылается запрос.

qualifyingQuestion

object ( QualifyingQuestion )

Уточняющий вопрос, указанный в запросе.

parentalStatusView

object ( ParentalStatusView )

Представление родительского статуса, указанное в запросе.

perStoreView

object ( PerStoreView )

Представление каждого магазина, указанное в запросе.

productBiddingCategoryConstant

object ( ProductBiddingCategoryConstant )

Категория назначения ставок по продукту, указанная в запросе.

productGroupView

object ( ProductGroupView )

Представление группы продуктов, указанное в запросе.

recommendation

object ( Recommendation )

Рекомендация, указанная в запросе.

searchTermView

object ( SearchTermView )

Представление поискового запроса, указанное в запросе.

sharedCriterion

object ( SharedCriterion )

Общий набор, указанный в запросе.

sharedSet

object ( SharedSet )

Общий набор, указанный в запросе.

smartCampaignSetting

object ( SmartCampaignSetting )

Настройка умной кампании, указанная в запросе.

shoppingPerformanceView

object ( ShoppingPerformanceView )

Представление эффективности покупок, указанное в запросе.

smartCampaignSearchTermView

object ( SmartCampaignSearchTermView )

Представление поискового запроса умной кампании, указанное в запросе.

topicView

object ( TopicView )

Представление темы, указанное в запросе.

travelActivityGroupView

object ( TravelActivityGroupView )

Представление группы туристических операций, указанное в запросе.

travelActivityPerformanceView

object ( TravelActivityPerformanceView )

Представление эффективности поездок, указанное в запросе.

experiment

object ( Experiment )

Эксперимент, указанный в запросе.

experimentArm

object ( ExperimentArm )

Группа эксперимента, указанная в запросе.

userInterest

object ( UserInterest )

Интерес пользователя, указанный в запросе.

lifeEvent

object ( LifeEvent )

Жизненное событие, указанное в запросе.

userList

object ( UserList )

Список пользователей, на который ссылается запрос.

userLocationView

object ( UserLocationView )

Представление местоположения пользователя, указанное в запросе.

remarketingAction

object ( RemarketingAction )

Действие ремаркетинга, указанное в запросе.

topicConstant

object ( TopicConstant )

Константа темы, на которую ссылается запрос.

video

object ( Video )

Видео, указанное в запросе.

webpageView

object ( WebpageView )

Представление веб-страницы, указанное в запросе.

leadFormSubmissionData

object ( LeadFormSubmissionData )

Представление пользователя формы для потенциальных клиентов, указанное в запросе.

metrics

object ( Metrics )

Метрики.

segments

object ( Segments )

Сегменты.

АккаунтБюджет

Бюджет на уровне аккаунта. Он содержит информацию о самом бюджете, а также о последних утвержденных изменениях бюджета и предлагаемых изменениях, ожидающих утверждения. Предлагаемые изменения, ожидающие утверждения, если таковые имеются, находятся в «pendingProposal». Действительные сведения о бюджете можно найти в полях с префиксом «утверждено_», «скорректировано_» и полях без префикса. Поскольку некоторые действительные сведения могут отличаться от первоначально запрошенных пользователем данных (например, лимит расходов), эти различия сопоставляются через поля «предложено_», «утверждено_» и, возможно, «скорректировано_».

Этот ресурс мутируется с помощью AccountBudgetProposal и не может быть изменен напрямую. В любой момент времени в бюджете может быть не более одного ожидающего рассмотрения предложения. Он считывается через pendingProposal.

После утверждения бюджет может быть подвергнут корректировкам, например, кредитным корректировкам. Корректировки создают различия между полями «утверждено» и «скорректировано», которые в противном случае были бы идентичными.

JSON-представление
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

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

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

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

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

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
Поля
resourceName

string

Только вывод. Имя ресурса бюджета на уровне аккаунта. Имена ресурсов AccountBudget имеют вид:

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum ( AccountBudgetStatus )

Только вывод. Статус этого бюджета на уровне аккаунта.

totalAdjustmentsMicros

string ( int64 format)

Только вывод. Общая сумма корректировок.

Примером корректировки являются льготные кредиты.

amountServedMicros

string ( int64 format)

Только вывод. Стоимость показанных объявлений в микронах.

Сюда входят затраты на сверхпоставку, и в этом случае кредит может быть автоматически применен к бюджету (см. TotalAdjustmentsMicros).

pendingProposal

object ( PendingAccountBudgetProposal )

Только вывод. Ожидаемое предложение по изменению этого бюджета, если применимо.

id

string ( int64 format)

Только вывод. Идентификатор бюджета на уровне аккаунта.

billingSetup

string

Только вывод. Имя ресурса платежной настройки, связанной с этим бюджетом на уровне аккаунта. Имена ресурсов BillingSetup имеют вид:

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

Только вывод. Название бюджета на уровне аккаунта.

proposedStartDateTime

string

Только вывод. Предлагаемое время начала расчета бюджета на уровне аккаунта в формате гггг-ММ-дд ЧЧ:мм:сс. Если был предложен тип времени начала СЕЙЧАС, это время запроса.

approvedStartDateTime

string

Только вывод. Утвержденное время начала бюджета на уровне аккаунта в формате гггг-ММ-дд ЧЧ:мм:сс.

Например, если новый бюджет утверждается после предложенного времени начала, утвержденным временем начала является время утверждения.

purchaseOrderNumber

string

Только вывод. Номер заказа на покупку — это значение, которое помогает пользователям ссылаться на этот бюджет в своих ежемесячных счетах.

notes

string

Только вывод. Примечания, связанные с бюджетом.

Поле объединения proposed_end_time . Предлагаемое время окончания бюджета на уровне аккаунта. proposed_end_time может быть только одним из следующих:
proposedEndDateTime

string

Только вывод. Предлагаемое время окончания в формате гггг-ММ-дд ЧЧ:мм:сс.

proposedEndTimeType

enum ( TimeType )

Только вывод. Предлагаемое время окончания имеет четко определенный тип, например НАВСЕГДА.

Поле объединения approved_end_time . Утвержденное время окончания бюджета на уровне аккаунта.

Например, если время окончания бюджета обновляется и предложение утверждается после предложенного времени окончания, утвержденным временем окончания будет время утверждения. approved_end_time может быть только одним из следующих:

approvedEndDateTime

string

Только вывод. Утвержденное время окончания в формате гггг-ММ-дд ЧЧ:мм:сс.

approvedEndTimeType

enum ( TimeType )

Только вывод. Утвержденное время окончания имеет четко определенный тип, например НАВСЕГДА.

Поле объединения proposed_spending_limit . Предлагаемый лимит расходов. proposed_spending_limit может быть только одним из следующих:
proposedSpendingLimitMicros

string ( int64 format)

Только вывод. Предлагаемый лимит расходов в микро. Один миллион эквивалентен одной единице.

proposedSpendingLimitType

enum ( SpendingLimitType )

Только вывод. Предлагаемый лимит расходов имеет четко определенный тип, например, INFINITE.

Поле объединения approved_spending_limit . Утвержденный лимит расходов.

Например, если сумма, уже потраченная учетной записью, превышает предложенный лимит расходов на момент утверждения предложения, утвержденный лимит расходов устанавливается на уже потраченную сумму. approved_spending_limit может быть только одним из следующих:

approvedSpendingLimitMicros

string ( int64 format)

Только вывод. Утвержденный лимит расходов в микро. Один миллион эквивалентен одной единице. Оно будет заполнено только в том случае, если предлагаемый лимит расходов конечен и всегда будет больше или равен предлагаемому лимиту расходов.

approvedSpendingLimitType

enum ( SpendingLimitType )

Только вывод. Утвержденный лимит расходов имеет четко определенный тип, например, INFINITE. Это поле будет заполнено только в том случае, если утвержденный лимит расходов БЕСКОНЕЧНЫЙ.

Поле объединения adjusted_spending_limit ». Лимит расходов после применения корректировок. Корректировки хранятся в total_adjustments_micros.

Это значение имеет последнее слово в том, сколько аккаунту разрешено тратить. adjusted_spending_limit может быть только одним из следующих:

adjustedSpendingLimitMicros

string ( int64 format)

Только вывод. Скорректированный лимит расходов в микро. Один миллион эквивалентен одной единице.

Если утвержденный лимит расходов является конечным, скорректированный лимит расходов может варьироваться в зависимости от типов корректировок, примененных к этому бюджету, если это применимо.

Различные виды корректировок описаны здесь: https://support.google.com/google-ads/answer/1704323.

Например, корректировка дебета уменьшает сумму, которую разрешено тратить по счету.

adjustedSpendingLimitType

enum ( SpendingLimitType )

Только вывод. Скорректированный лимит расходов имеет четко определенный тип, например INFINITE. Оно будет заполнено только в том случае, если скорректированный лимит расходов равен БЕСКОНЕЧНО, что гарантированно будет верно, если утвержденный лимит расходов БЕСКОНЕЧЕН.

Статус бюджета аккаунта

Возможные статусы AccountBudget.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
PENDING Бюджет аккаунта ожидает утверждения.
APPROVED Бюджет счета утвержден.
CANCELLED Бюджет аккаунта был отменен пользователем.

Ожидается предложение по бюджету аккаунта

Ожидаемое предложение, связанное с прилагаемым бюджетом на уровне аккаунта, если применимо.

JSON-представление
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

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

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
Поля
proposalType

enum ( AccountBudgetProposalType )

Только вывод. Тип этого предложения, например END, чтобы завершить бюджет, связанный с этим предложением.

accountBudgetProposal

string

Только вывод. Имя ресурса предложения. Имена ресурсов AccountBudgetProposal имеют форму:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

Только вывод. Имя, которое нужно присвоить бюджету на уровне аккаунта.

startDateTime

string

Только вывод. Время начала в формате гггг-ММ-дд ЧЧ:мм:сс.

purchaseOrderNumber

string

Только вывод. Номер заказа на покупку — это значение, которое помогает пользователям ссылаться на этот бюджет в своих ежемесячных счетах.

notes

string

Только вывод. Примечания, связанные с этим бюджетом.

creationDateTime

string

Только вывод. Время создания предложения по бюджету на уровне аккаунта. В формате гггг-ММ-дд ЧЧ:мм:сс.

Поле объединения end_time . Время окончания бюджета на уровне аккаунта. end_time может быть только одним из следующих:
endDateTime

string

Только вывод. Время окончания в формате гггг-ММ-дд ЧЧ:мм:сс.

endTimeType

enum ( TimeType )

Только вывод. Время окончания имеет четко определенный тип, например НАВСЕГДА.

Поле объединения spending_limit ». Лимит расходов. spending_limit может быть только одним из следующих:
spendingLimitMicros

string ( int64 format)

Только вывод. Лимит расходов в микронах. Один миллион эквивалентен одной единице.

spendingLimitType

enum ( SpendingLimitType )

Только вывод. Лимит расходов имеет четко определенный тип, например, INFINITE.

Группа объявленийAdAssetCombinationView

Представление об использовании комбинации рекламных объектов группы объявлений. Сейчас мы поддерживаем только AdGroupAdAssetCombinationView для адаптивных поисковых объявлений; в будущем планируется добавить больше типов объявлений.

JSON-представление
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
Поля
resourceName

string

Только вывод. Имя ресурса представления комбинации объектов объявлений группы объявлений. Идентификатор комбинации имеет длину 128 бит, при этом старшие 64 бита хранятся в assets_combination_id_high, а младшие 64 бита хранятся в assets_combination_id_low. Имена ресурсов представления комбинации активов AdGroupAd имеют форму: customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}

servedAssets[]

object ( AssetUsage )

Только вывод. Обслуженные активы.

enabled

boolean

Только вывод. Статус между комбинацией объектов и последней версией объявления. Если это правда, комбинация объектов связана с последней версией объявления. Если значение false, это означает, что ссылка когда-то существовала, но была удалена и больше не присутствует в последней версии объявления.

Использование активов

Содержит информацию об использовании актива.

JSON-представление
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Поля
asset

string

Имя ресурса актива.

servedAssetFieldType

enum ( ServedAssetFieldType )

Тип обслуживаемого поля актива.

Группа объявленийAdAssetView

Связь между AdGroupAd и активом. В настоящее время мы поддерживаем только AdGroupAdAssetView для AppAds и адаптивных поисковых объявлений.

JSON-представление
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
Поля
resourceName

string

Только вывод. Имя ресурса просмотра объекта объявления группы объявлений. Имена ресурсов просмотра объектов объявлений группы объявлений имеют следующую форму (до версии V4):

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

Имена ресурсов просмотра объектов объявлений группы объявлений имеют следующую форму (начиная с версии 4):

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

fieldType

enum ( AssetFieldType )

Только вывод. Роль, которую объект играет в объявлении.

policySummary

object ( AdGroupAdAssetPolicySummary )

Только вывод. Информация о политике для рекламного объекта группы объявлений.

performanceLabel

enum ( AssetPerformanceLabel )

Только вывод. Эффективность привязки активов.

pinnedField

enum ( ServedAssetFieldType )

Только вывод. Закрепленное поле.

adGroupAd

string

Только вывод. Объявление группы объявлений, с которым связан объект.

asset

string

Только вывод. Объект, связанный с объявлением группы объявлений.

enabled

boolean

Только вывод. Статус между объектом и последней версией объявления. Если это правда, ресурс связан с последней версией объявления. Если значение false, это означает, что ссылка когда-то существовала, но была удалена и больше не присутствует в последней версии объявления.

AdGroupAdAssetPolicySummary

Содержит информацию о политике для рекламного объекта группы объявлений.

JSON-представление
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Поля
policyTopicEntries[]

object ( PolicyTopicEntry )

Только вывод. Список результатов политики для рекламного объекта группы объявлений.

reviewStatus

enum ( PolicyReviewStatus )

Только вывод. На каком этапе проверки находится этот рекламный объект группы объявлений.

approvalStatus

enum ( PolicyApprovalStatus )

Только вывод. Общий статус одобрения этого рекламного объекта в группе объявлений, рассчитанный на основе статуса его отдельных записей в теме политики.

Группа объявленийАудиторияView

Просмотр аудитории группы объявлений. Включает данные об эффективности из списков интересов и ремаркетинга для рекламы в контекстно-медийной сети и сети YouTube, а также списков ремаркетинга для поисковых объявлений (RLSA), агрегированные на уровне аудитории.

JSON-представление
{
  "resourceName": string
}
Поля
resourceName

string

Только вывод. Имя ресурса представления аудитории группы объявлений. Названия ресурсов просмотра аудитории группы объявлений имеют следующий вид:

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

AdGroupCriterionМоделирование

Моделирование критериев группы объявлений. Поддерживаемые комбинации типа рекламного канала, типа критерия, типа моделирования и метода модификации моделирования подробно описаны ниже соответственно. Операции моделирования AdGroupCriterion для отелей, начиная с версии V5.

  1. DISPLAY – KEYWORD – CPC_BID – UNIFORM
  2. ПОИСК – КЛЮЧЕВОЕ СЛОВО – CPC_BID – UNIFORM
  3. SHOPPING – LISTING_GROUP – CPC_BID – UNIFORM
  4. ОТЕЛЬ – LISTING_GROUP – CPC_BID – UNIFORM
  5. ОТЕЛЬ – LISTING_GROUP – PERCENT_CPC_BID – UNIFORM
JSON-представление
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Поля
resourceName

string

Только вывод. Имя ресурса моделирования критерия группы объявлений. Имена ресурсов моделирования критерия группы объявлений имеют следующий вид:

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

type

enum ( SimulationType )

Только вывод. Поле, которое модифицируется при моделировании.

modificationMethod

enum ( SimulationModificationMethod )

Только вывод. Как моделирование изменяет поле.

adGroupId

string ( int64 format)

Только вывод. Идентификатор группы объявлений моделирования.

criterionId

string ( int64 format)

Только вывод. Идентификатор критерия моделирования.

startDate

string

Только вывод. Первый день, на котором основано моделирование, в формате ГГГГ-ММ-ДД.

endDate

string

Только вывод. Последний день, на котором основано моделирование, в формате ГГГГ-ММ-ДД.

Поле объединения point_list . Список точек моделирования. point_list может быть только одним из следующих:
cpcBidPointList

object ( CpcBidSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования — CPC_BID.

percentCpcBidPointList

object ( PercentCpcBidSimulationPointList )

Только вывод. Баллы моделирования, если тип моделирования – PERCENT_CPC_BID.

Тип моделирования

Перечисление, описывающее поле, которое модифицируется при моделировании.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
CPC_BID Моделирование предназначено для ставки CPC.
CPV_BID Моделирование предназначено для ставки CPV.
TARGET_CPA Моделирование предназначено для целевой цены за конверсию.
BID_MODIFIER Моделирование предназначено для модификатора ставки.
TARGET_ROAS Моделирование предназначено для целевой рентабельности инвестиций в рекламу.
PERCENT_CPC_BID Моделирование рассчитано на процентную цену за клик.
TARGET_IMPRESSION_SHARE Моделирование предназначено для целевого процента полученных показов.
BUDGET Симулятор бюджетный.

Метод Модификации Симуляции

Перечисление, описывающее метод, с помощью которого симуляция изменяет поле.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
UNIFORM Значения в моделировании применялись ко всем дочерним элементам данного ресурса единообразно. Переопределения дочерних ресурсов не соблюдались.
DEFAULT Значения моделирования были применены к данному ресурсу. Переопределения дочерних ресурсов были соблюдены, и оценки трафика не включают эти ресурсы.
SCALING Все значения в моделировании были масштабированы по одному и тому же коэффициенту. Например, в смоделированной кампании TargetCpa цель кампании и все цели группы объявлений были масштабированы с коэффициентом X.

Цена за кликBidSimulationPointList

Контейнер для точек моделирования для моделирования типа CPC_BID.

JSON-представление
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
Поля
points[]

object ( CpcBidSimulationPoint )

Прогнозируемые показатели для ряда сумм ставок CPC.

Цена за кликBidSimulationPoint

Прогнозируемые показатели для конкретной суммы ставки CPC.

JSON-представление
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
Поля
requiredBudgetAmountMicros

string ( int64 format)

Прогнозируемый требуемый дневной бюджет, который рекламодатель должен установить для получения расчетного трафика, в микро валютах рекламодателя.

biddableConversions

number

Прогнозируемое количество конверсий, доступных для назначения ставок.

biddableConversionsValue

number

Прогнозируемая общая ценность конверсий, доступных для назначения ставок.

clicks

string ( int64 format)

Прогнозируемое количество кликов.

costMicros

string ( int64 format)

Ориентировочная стоимость в микро.

impressions

string ( int64 format)

Прогнозируемое количество показов.

topSlotImpressions

string ( int64 format)

Прогнозируемое количество показов на верхних позициях. Это поле поддерживается только для типа канала поисковой рекламы.

Поле объединения cpc_simulation_key_value . Если SimulationModificationMethod = UNIFORM или DEFAULT, устанавливается cpc_bid_micros. Когда SimulationModificationMethod = SCALING, устанавливается cpc_bid_scaling_modifier. cpc_simulation_key_value может быть только одним из следующих:
cpcBidMicros

string ( int64 format)

Имитированная ставка CPC, на которой основаны прогнозируемые показатели.

cpcBidScalingModifier

number

Модификатор моделируемого масштабирования, на котором основаны прогнозируемые показатели. Все ставки CPC, относящиеся к моделируемому объекту, масштабируются с помощью этого модификатора.

ПроцентCpcBidSimulationPointList

Контейнер для точек моделирования типа PERCENT_CPC_BID.

JSON-представление
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
Поля
points[]

object ( PercentCpcBidSimulationPoint )

Прогнозируемые показатели для ряда ставок процентной цены за клик.

ПроцентCpcBidSimulationPoint

Прогнозируемые показатели для определенного процента цены за клик. Это поле поддерживается только для типа рекламного канала отеля.

JSON-представление
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Поля
percentCpcBidMicros

string ( int64 format)

Моделируемая процентная цена за клик, на которой основаны прогнозируемые показатели. Процентная цена за клик выражается как доля рекламируемой цены на какой-либо товар или услугу. Здесь хранится значение 1 000 000 * [дробь].

biddableConversions

number

Прогнозируемое количество конверсий, доступных для назначения ставок.

biddableConversionsValue

number

Прогнозируемая общая стоимость конверсий, доступных для назначения ставок, в местной валюте.

clicks

string ( int64 format)

Прогнозируемое количество кликов.

costMicros

string ( int64 format)

Ориентировочная стоимость в микро.

impressions

string ( int64 format)

Прогнозируемое количество показов.

topSlotImpressions

string ( int64 format)

Прогнозируемое количество показов на верхних позициях.

AdGroupСимуляторы

Моделирование группы объявлений. Поддерживаемые комбинации типа рекламного канала, типа моделирования и метода модификации моделирования подробно описаны ниже соответственно.

  1. ПОИСК – CPC_BID – ПО УМОЛЧАНИЮ
  2. ПОИСК – CPC_BID – UNIFORM
  3. ПОИСК – TARGET_CPA – UNIFORM
  4. ПОИСК – TARGET_ROAS – UNIFORM
  5. DISPLAY – CPC_BID – ПО УМОЛЧАНИЮ
  6. DISPLAY – CPC_BID – UNIFORM
  7. DISPLAY – TARGET_CPA – UNIFORM
JSON-представление
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Поля
resourceName

string

Только вывод. Имя ресурса моделирования группы объявлений. Названия ресурсов моделирования группы объявлений имеют следующий вид:

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

type

enum ( SimulationType )

Только вывод. Поле, которое модифицируется при моделировании.

modificationMethod

enum ( SimulationModificationMethod )

Только вывод. Как моделирование изменяет поле.

adGroupId

string ( int64 format)

Только вывод. Идентификатор группы объявлений моделирования.

startDate

string

Только вывод. Первый день, на котором основано моделирование, в формате ГГГГ-ММ-ДД.

endDate

string

Только вывод. Последний день, на котором основано моделирование, в формате ГГГГ-ММ-ДД.

Поле объединения point_list . Список точек моделирования. point_list может быть только одним из следующих:
cpcBidPointList

object ( CpcBidSimulationPointList )

Только вывод. Баллы моделирования, если тип моделирования — CPC_BID.

cpvBidPointList

object ( CpvBidSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования – CPV_BID.

targetCpaPointList

object ( TargetCpaSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования – TARGET_CPA.

targetRoasPointList

object ( TargetRoasSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования – TARGET_ROAS.

CpvBidSimulationPointList

Контейнер для точек моделирования типа CPV_BID.

JSON-представление
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
Поля
points[]

object ( CpvBidSimulationPoint )

Прогнозируемые показатели для ряда сумм ставок CPV.

CpvBidSimulationPoint

Прогнозируемые показатели для конкретной суммы ставки CPV.

JSON-представление
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
Поля
cpvBidMicros

string ( int64 format)

Имитированная цена за просмотр, на которой основаны прогнозируемые показатели.

costMicros

string ( int64 format)

Ориентировочная стоимость в микронах.

impressions

string ( int64 format)

Прогнозируемое количество показов.

views

string ( int64 format)

Прогнозируемое количество просмотров.

TargetCpaSimulationPointList

Контейнер для точек моделирования типа TARGET_CPA.

JSON-представление
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
Поля
points[]

object ( TargetCpaSimulationPoint )

Прогнозируемые показатели для ряда целевых цен за конверсию.

TargetCpaSimulationPoint

Прогнозируемые показатели для определенной суммы целевой цены за конверсию.

JSON-представление
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
Поля
requiredBudgetAmountMicros

string ( int64 format)

Прогнозируемый необходимый дневной бюджет, который рекламодатель должен установить для получения расчетного трафика, в микро валютах рекламодателя.

appInstalls

number

Прогнозируемое количество установок приложения.

inAppActions

number

Прогнозируемое количество действий в приложении.

biddableConversions

number

Прогнозируемое количество конверсий, доступных для назначения ставок.

biddableConversionsValue

number

Прогнозируемая общая ценность конверсий, доступных для назначения ставок.

clicks

string ( int64 format)

Прогнозируемое количество кликов.

costMicros

string ( int64 format)

Ориентировочная стоимость в микро.

impressions

string ( int64 format)

Прогнозируемое количество показов.

topSlotImpressions

string ( int64 format)

Прогнозируемое количество показов на верхних позициях. Это поле поддерживается только для типа канала поисковой рекламы.

Поле объединения target_cpa_simulation_key_value . Когда SimulationModificationMethod = UNIFORM или DEFAULT, устанавливается target_cpa_micros. Когда SimulationModificationMethod = SCALING, устанавливается target_cpa_scaling_modifier. target_cpa_simulation_key_value может быть только одним из следующих:
targetCpaMicros

string ( int64 format)

Моделируемая целевая цена за конверсию, на которой основаны прогнозируемые показатели.

targetCpaScalingModifier

number

Модификатор моделируемого масштабирования, на котором основаны прогнозируемые показатели. Все целевые значения цены за конверсию, относящиеся к моделируемому объекту, масштабируются с помощью этого модификатора.

TargetRoAssimulationPointList

Контейнер для моделирования для моделирования типа Target_roas.

Представление JSON
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
Поля
points[]

object ( TargetRoasSimulationPoint )

Прогнозируемые метрики для серии целевых сумм ROAS.

TargetRoAssimulationPoint

Прогнозируемые метрики для определенной целевой суммы ROAS.

Представление JSON
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Поля
requiredBudgetAmountMicros

string ( int64 format)

Прогнозируется, требуется ежедневный бюджет, который рекламодатель должен установить для получения предполагаемого трафика в микросхемах -валюте.

targetRoas

number

Моделируемая цель, на которой основаны прогнозируемые метрики.

biddableConversions

number

Прогнозируемое количество преобразований.

biddableConversionsValue

number

Прогнозируемая общая стоимость преобразования.

clicks

string ( int64 format)

Прогнозируемое количество кликов.

costMicros

string ( int64 format)

Прогнозируемая стоимость в микросхеме.

impressions

string ( int64 format)

Прогнозируемое количество впечатлений.

topSlotImpressions

string ( int64 format)

Прогнозируемое количество в верхних слотных впечатлениях. Только поисковый рекламный тип канала поддерживает это поле.

AgerangeView

Вид возрастного диапазона.

Представление JSON
{
  "resourceName": string
}
Поля
resourceName

string

Только вывод. Название ресурса в возрастном диапазоне. Имена ресурсов в диапазоне возрастного диапазона имеет форму:

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

AdscheduleView

Просмотр расписания рекламы суммирует выполнение кампаний по критериям Adschedule.

Представление JSON
{
  "resourceName": string
}
Поля
resourceName

string

Только вывод. Имя ресурса представления расписания рекламы. Adschedule View имена ресурсов имеют форму:

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

Domaincategory

Категория, сгенерированная автоматически путем ползания домена. Если кампания использует DynamicSearchAdsSetting, то для домена будут генерироваться доменные категории. Категории могут быть нацелены на WebPageConditionInfo. См.: Https://support.google.com/google-ads/answer/2471185

Представление JSON
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
Поля
resourceName

string

Только вывод. Имя ресурса категории домена. Имена ресурсов доменной категории имеют форму:

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

campaign

string

Только вывод. Кампания этой категории рекомендуется.

category

string

Только вывод. Рекомендуемая категория для домена веб -сайта, например, если у вас есть веб -сайт об электронике, категории могут быть «камеры», «телевизоры» и т. Д.

languageCode

string

Только вывод. Языковой код, определяющий язык веб -сайта, например, «en» для английского языка. Язык может быть указан в DynamicSearchAdsSetting, необходимой для динамических поисковых объявлений. Это язык страниц с вашего веб -сайта, который вы хотите, чтобы Google Ads была поиска, создавала рекламу и сопоставляя поиск.

domain

string

Только вывод. Домен для сайта. Домен может быть указан в DynamicSearchAdsSetting, необходимой для динамических поисковых объявлений.

coverageFraction

number

Только вывод. Доля страниц на вашем сайте, что эта категория соответствует.

categoryRank

string ( int64 format)

Только вывод. Позиция этой категории в наборе категорий. Более низкие числа указывают на лучшее соответствие домену. NULL указывает не рекомендуется.

hasChildren

boolean

Только вывод. Указывает, имеет ли эта категория подкатегории.

recommendedCpcBidMicros

string ( int64 format)

Только вывод. Рекомендуемая стоимость за клик для категории.

Assetfieldtypeview

Представление типа поля актива. В этом представлении сообщается о непреодолимых показателях для каждого типа поля активов, когда актива используется в качестве расширения.

Представление JSON
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
Поля
resourceName

string

Только вывод. Имя ресурса представления типа поля актива. Поле поля актива Тип просмотра Имена ресурсов есть форма:

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum ( AssetFieldType )

Только вывод. Тип поля актива вида типа поля актива.

AssetGroupproductGroupView

Активная группа продукта группы.

Представление JSON
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
Поля
resourceName

string

Только вывод. Название ресурса представления группы продуктов Acset Group. Группа Asset Group Product Group Имена ресурсов имеют форму:

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

assetGroup

string

Только вывод. Группа активов, связанная с фильтром группы листинга.

assetGroupListingGroupFilter

string

Только вывод. Название ресурса группы листинга групп активов.

AssetSetTyPeview

Представление типа набора активов. В этом представлении сообщается о непреодолимых метрик для каждого типа набора активов. Типы набора активов дочерних активов не включены в этот отчет. Их статистика агрегирована в соответствии с типом набора родительских активов.

Представление JSON
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
Поля
resourceName

string

Только вывод. Имя ресурса представления типа набора активов. Набор активов Тип Вид имена ресурсов есть форма:

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum ( AssetSetType )

Только вывод. Тип набора активов типа набора активов.

Биддингстратегизимуляция

Моделирование стратегии торгов. Поддерживаемые комбинации типа моделирования и метода моделирования моделирования подробно описаны ниже соответственно.

  1. Target_cpa - униформа
  2. Target_roas - униформа
Представление JSON
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Поля
resourceName

string

Только вывод. Название ресурса моделирования стратегии торгов. Имена ресурсов для моделирования стратегии предложения имеют форму:

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

biddingStrategyId

string ( int64 format)

Только вывод. Стратегия ставки общего идентификатора набора моделирования.

type

enum ( SimulationType )

Только вывод. Поле, которое моделирование изменяет.

modificationMethod

enum ( SimulationModificationMethod )

Только вывод. Как моделирование изменяет поле.

startDate

string

Только вывод. Первый день, на котором базируется симуляция, в формате yyyy-mm-dd.

endDate

string

Только вывод. Последний день, на котором базируется симуляция, в формате yyyy-mm-dd

Союз Полевой point_list . Список моделирования точек. point_list может быть только одним из следующих:
targetCpaPointList

object ( TargetCpaSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования является target_cpa.

targetRoasPointList

object ( TargetRoasSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования является target_roas.

CallView

Просмотр вызова, который включает в себя данные для отслеживания вызовов рекламы только для вызовов или расширений вызовов.

Представление JSON
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
Поля
resourceName

string

Только вывод. Имя ресурса вида вызова. Вызовы имена ресурсов имеют форму:

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

Только вывод. Страна Код абонента.

callerAreaCode

string

Только вывод. Код зоны абонента. NULL, если продолжительность вызова короче 15 секунд.

callDurationSeconds

string ( int64 format)

Только вывод. Предоставленная реклама продолжительность вызова за считанные секунды.

startCallDateTime

string

Только вывод. Предоставленное рекламодателем время начала вызова времени.

endCallDateTime

string

Только вывод. Предоставленное рекламодателем время окончания даты вызова.

callTrackingDisplayLocation

enum ( CallTrackingDisplayLocation )

Только вывод. Расположение дисплея отслеживания вызовов.

type

enum ( CallType )

Только вывод. Тип вызова.

callStatus

enum ( GoogleVoiceCallStatus )

Только вывод. Статус вызова.

CalltrackingDisplayLocation

Возможные местоположения отображения вызовов.

Перечисление
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
AD Телефонный звонок поместил из объявления.
LANDING_PAGE Телефонный звонок, размещенный с рекламы на целевой странице, указывает на.

Calltype

Возможные виды имущества, откуда был сделан звонок.

Перечисление
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
MANUALLY_DIALED Телефонный звонок был набран вручную.

GooglevoiceCallStatus

Возможные статусы голосового вызова Google.

Перечисление
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
MISSED Звонок был пропущен.
RECEIVED Звонок был получен.

Кампания AudienceView

Представление об аудитории кампании. Включает данные о производительности от интересов и списков ремаркетинга для отображения сети и сетевых объявлений YouTube, а также списки ремаркетинга для поисковых рекламных объявлений (RLSA), агрегированы по кампании и критерию аудитории. Эта точка зрения включает в себя только аудиторию, прикрепленную на уровне кампании.

Представление JSON
{
  "resourceName": string
}
Поля
resourceName

string

Только вывод. Название ресурса представления аудитории кампании. Аудитория кампании. Название ресурсов имеет форму:

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

Campaignsearchminsight

Представление об поиске кампании. Исторические данные доступны с марта 2023 года.

Представление JSON
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
Поля
resourceName

string

Только вывод. Название ресурса Поисковому термину на уровне кампании. Название ресурсов поиска на уровне кампании имеет форму:

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

categoryLabel

string

Только вывод. Ярлык для категории поиска. Пустая строка обозначает категорию «Улов-все» для поисковых терминов, которые не вписывались в другую категорию.

id

string ( int64 format)

Только вывод. Идентификатор понимания.

campaignId

string ( int64 format)

Только вывод. Идентификатор кампании.

Кампания

Моделирование кампании. Поддерживаемые комбинации типа рекламного канала, типа моделирования и метода моделирования моделирования подробно описаны ниже соответственно.

  • Поиск - CPC_BIB
  • SEARK - CPC_BID - масштабирование
  • Поиск - target_cpa - униформа
  • Поиск - target_cpa - масштабирование
  • Поиск - target_roas - униформа
  • Search - 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 - униформа
  • Performance_max - бюджет - униформа
Представление JSON
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Поля
resourceName

string

Только вывод. Название ресурса моделирования кампании. Названия ресурсов имитации кампании имеют форму:

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

campaignId

string ( int64 format)

Только вывод. Кампания идентификатор симуляции.

type

enum ( SimulationType )

Только вывод. Поле, которое моделирование изменяет.

modificationMethod

enum ( SimulationModificationMethod )

Только вывод. Как моделирование изменяет поле.

startDate

string

Только вывод. Первый день, на котором базируется симуляция, в формате yyyy-mm-dd.

endDate

string

Только вывод. Последний день, на котором базируется симуляция, в формате yyyy-mm-dd

Союз Полевой point_list . Список моделирования точек. point_list может быть только одним из следующих:
cpcBidPointList

object ( CpcBidSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования - cpc_bid.

targetCpaPointList

object ( TargetCpaSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования является target_cpa.

targetRoasPointList

object ( TargetRoasSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования является target_roas.

targetImpressionSharePointList

object ( TargetImpressionShareSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования является target_impression_share.

budgetPointList

object ( BudgetSimulationPointList )

Только вывод. Точки моделирования, если тип моделирования является бюджетом.

TargetImpressionShareSimulationPointList

Контейнер для точек моделирования для моделирования типа target_impression_share.

Представление JSON
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
Поля
points[]

object ( TargetImpressionShareSimulationPoint )

Прогнозируемые метрики для конкретной стоимости акции целевого впечатления.

TargetImpressionShareSimulationPoint

Прогнозируемые метрики для конкретной стоимости акции целевого впечатления.

Представление JSON
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
Поля
targetImpressionShareMicros

string ( int64 format)

Моделируемое значение акции целевого впечатления (в микрос), на которых основаны прогнозируемые метрики. Например, 10% доля впечатления, которая равна 0,1, хранится как 100_000. Это значение подтверждено и не будет превышать 1 м (100%).

requiredCpcBidCeilingMicros

string ( int64 format)

Прогнозируется, требуется ежедневный потолок ставок CPC, который рекламодатель должен установить для реализации этого моделирования в микросхемах валюты рекламодателя.

requiredBudgetAmountMicros

string ( int64 format)

Прогнозируется, требуется ежедневный бюджет, который рекламодатель должен установить для получения предполагаемого трафика в микросхемах -валюте.

biddableConversions

number

Прогнозируемое количество преобразований.

biddableConversionsValue

number

Прогнозируемая общая стоимость преобразования.

clicks

string ( int64 format)

Прогнозируемое количество кликов.

costMicros

string ( int64 format)

Прогнозируемая стоимость в микросхеме.

impressions

string ( int64 format)

Прогнозируемое количество впечатлений.

topSlotImpressions

string ( int64 format)

Прогнозируемое количество в верхних слотных впечатлениях. Только поисковый рекламный тип канала поддерживает это поле.

absoluteTopImpressions

string ( int64 format)

Прогнозируемое количество абсолютных топ -впечатлений. Только поисковый рекламный тип канала поддерживает это поле.

BudgetSimulationPointList

Контейнер для моделирования точек для моделирования бюджета типа.

Представление JSON
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
Поля
points[]

object ( BudgetSimulationPoint )

Прогнозируемые показатели для серии бюджетных сумм.

Бюджетный счетчик

Прогнозируемые показатели для конкретной суммы бюджета.

Представление JSON
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Поля
budgetAmountMicros

string ( int64 format)

Моделируемый бюджет, на котором основаны прогнозируемые метрики.

requiredCpcBidCeilingMicros

string ( int64 format)

Прогнозируется, требуется ежедневный потолок ставок CPC, который рекламодатель должен установить для реализации этого моделирования в микросхемах валюты рекламодателя. Только кампании с целевой стратегией расходов на стратегию ставок поддерживают эту область.

biddableConversions

number

Прогнозируемое количество преобразований.

biddableConversionsValue

number

Прогнозируемая общая стоимость преобразования.

clicks

string ( int64 format)

Прогнозируемое количество кликов.

costMicros

string ( int64 format)

Прогнозируемая стоимость в микросхеме.

impressions

string ( int64 format)

Прогнозируемое количество впечатлений.

topSlotImpressions

string ( int64 format)

Прогнозируемое количество в верхних слотных впечатлениях. Только поисковый рекламный тип канала поддерживает это поле.

CarrierConstant

Критерий перевозчика, который можно использовать в таргетировании кампании.

Представление JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
Поля
resourceName

string

Только вывод. Название ресурса критерия перевозчика. Имена ресурсов критерия перевозчика имеют форму:

carrierConstants/{criterionId}

id

string ( int64 format)

Только вывод. Идентификатор критерия носителя.

name

string

Только вывод. Полное имя носителя на английском языке.

countryCode

string

Только вывод. Кодекс страны страны, где находится перевозчик, например, «AR», «FR» и т. Д.

Изменение

Описывает гранулированное изменение возвращаемых ресурсов определенных типов ресурсов. Изменения, внесенные через пользовательский интерфейс или API за последние 30 дней, включены. Предыдущие и новые значения измененных полей показаны. Изменение EvEvent может иметь до 3 минут задержки, чтобы отразить новое изменение.

Представление JSON
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
Поля
resourceName

string

Только вывод. Название ресурса события изменения. Изменение имен ресурсов событий имеет форму:

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

changeDateTime

string

Только вывод. Время, в течение которого изменение было совершено в этом ресурсе.

changeResourceType

enum ( ChangeEventResourceType )

Только вывод. Тип измененного ресурса. Это диктует, какой ресурс будет установлен в OldResource и Newresource.

changeResourceName

string

Только вывод. Простой ресурс это изменение произошло.

clientType

enum ( ChangeClientType )

Только вывод. Где было сделано изменение.

userEmail

string

Только вывод. Электронное письмо пользователя, который внес это изменение.

oldResource

object ( ChangedResource )

Только вывод. Старый ресурс перед изменением. Только измененные поля будут заполнены.

newResource

object ( ChangedResource )

Только вывод. Новый ресурс после изменения. Только измененные поля будут заполнены.

resourceChangeOperation

enum ( ResourceChangeOperation )

Только вывод. Операция на измененном ресурсе.

changedFields

string ( FieldMask format)

Только вывод. Список полей, которые изменены в возвращенном ресурсе.

Это разделенный запятой список полностью квалифицированных имен полей. Пример: "user.displayName,photo" .

campaign

string

Только вывод. Кампания повлияла на это изменение.

adGroup

string

Только вывод. Адгруппа, затронутая этим изменением.

feed

string

Только вывод. Корм затронут этим изменением.

feedItem

string

Только вывод. FeedItem, затронутая этим изменением.

asset

string

Только вывод. Актив, затронутый этим изменением.

ChangeEventResourcetype

Enum перечисляет поддержку типов ресурсов с помощью ресурса изменения.

Перечисление
UNSPECIFIED Значения не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет собой несекретный ресурс, неизвестный в этой версии.
AD Изменение рекламного ресурса.
AD_GROUP Изменение ресурса Adgroup.
AD_GROUP_CRITERION Адгруппитерионное изменение ресурса.
CAMPAIGN Изменение ресурсов кампании.
CAMPAIGN_BUDGET Кампания Budget Resource Change.
AD_GROUP_BID_MODIFIER Изменение ресурса Adgroupbidmodifier.
CAMPAIGN_CRITERION Изменение ресурсов Campaination Commancecriterion.
FEED Изменение ресурса корма.
FEED_ITEM Изменение ресурса FeedItem.
CAMPAIGN_FEED Изменение ресурсов Campaignfeed.
AD_GROUP_FEED Изменение ресурса Adgroupfeed.
AD_GROUP_AD Изменение ресурса adgroupad.
ASSET Изменение ресурса активов.
CUSTOMER_ASSET Изменение ресурса Customersset.
CAMPAIGN_ASSET Изменение ресурсов кампании.
AD_GROUP_ASSET Изменение ресурса adgroupasset.
ASSET_SET Изменение ресурса актива.
ASSET_SET_ASSET Изменение ресурса активаса.
CAMPAIGN_ASSET_SET Изменение ресурсов кампании.

Чанклиентип

Источник, через который был сделан ресурс изменения.

Перечисление
UNSPECIFIED Значения не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет собой неклассифицированный тип клиента, неизвестный в этой версии.
GOOGLE_ADS_WEB_CLIENT Изменения, внесенные через «ads.google.com». Например, изменения, внесенные с помощью управления кампаниями.
GOOGLE_ADS_AUTOMATED_RULE Изменения, внесенные через автоматические правила Google Ads.
GOOGLE_ADS_SCRIPTS Изменения, внесенные в сценарии Google Ads.
GOOGLE_ADS_BULK_UPLOAD Изменения, внесенные в Google Ads, объемная загрузка.
GOOGLE_ADS_API Изменения, внесенные Google Ads API.
GOOGLE_ADS_EDITOR Изменения, внесенные в Google Ads Editor. Эта стоимость является заполнителем. API не возвращает эти изменения.
GOOGLE_ADS_MOBILE_APP Изменения, внесенные Google Ads Mobile App.
GOOGLE_ADS_RECOMMENDATIONS Изменения, внесенные в Google Ads Рекомендации.
SEARCH_ADS_360_SYNC Изменения, внесенные через поисковую рекламу 360, синхронизированные.
SEARCH_ADS_360_POST Изменения, внесенные через поисковую рекламу 360.
INTERNAL_TOOL Изменения, внесенные с помощью внутренних инструментов. Например, когда пользователь устанавливает шаблон URL на такую ​​организацию, как кампания, он автоматически завершен URL SA360 ClickServer.
OTHER Типы изменений, которые не классифицируются, например, изменения, внесенные путем выкупа купонов через рекламу Google.

Изменился

Прото, представляющий все поддерживаемые ресурсы. Будет установлен только ресурс ChangerSourcetype.

Представление JSON
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
Поля
ad

object ( Ad )

Только вывод. Установите, если ChangerSourcetype == ad.

adGroup

object ( AdGroup )

Только вывод. Установите, если ChangerSourcetype == ad_group.

adGroupCriterion

object ( AdGroupCriterion )

Только вывод. Установите, если ChangerSourcetype == ad_group_criterion.

campaign

object ( Campaign )

Только вывод. Установите, если ChangerSourcetype == Кампания.

campaignBudget

object ( CampaignBudget )

Только вывод. Установите, если ChangerSourcetype == campaign_budget.

adGroupBidModifier

object ( AdGroupBidModifier )

Только вывод. Установите, если ChangerSourcetype == ad_group_bid_modifier.

campaignCriterion

object ( CampaignCriterion )

Только вывод. Установите, если ChangerSourcetype == Campaign_criterion.

feed

object ( Feed )

Только вывод. Установите, если ChangerSourcetype == Feed.

feedItem

object ( FeedItem )

Только вывод. Установите, если ChangerSourcetype == FEED_ITEM.

campaignFeed

object ( CampaignFeed )

Только вывод. Установите, если ChangerSourcetype == Campaign_feed.

adGroupFeed

object ( AdGroupFeed )

Только вывод. Установите, если ChangerSourcetype == ad_group_feed.

adGroupAd

object ( AdGroupAd )

Только вывод. Установите, если ChangerSourcetype == ad_group_ad.

asset

object ( Asset )

Только вывод. Установите, если ChangerSourcetype == Asset.

customerAsset

object ( CustomerAsset )

Только вывод. Установите, если ChangerSourcetype == customer_asset.

campaignAsset

object ( CampaignAsset )

Только вывод. Установите, если ChangerSourcetype == Campaign_asset.

adGroupAsset

object ( AdGroupAsset )

Только вывод. Установите, если ChangerSourcetype == ad_group_asset.

assetSet

object ( AssetSet )

Только вывод. Установите, если ChangerSourcetype == asset_set.

assetSetAsset

object ( AssetSetAsset )

Только вывод. Установите, если ChangerSourcetype == asset_set_asset.

campaignAssetSet

object ( CampaignAssetSet )

Только вывод. Установите, если ChangerSourcetype == Campaign_asset_set.

ResourceCechangeOperation

Операция на измененном ресурсе в ресурсе изменения.

Перечисление
UNSPECIFIED Значения не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет собой неклассифицированную операцию, неизвестную в этой версии.
CREATE Ресурс был создан.
UPDATE Ресурс был изменен.
REMOVE Ресурс был удален.

Изменить статус

Описывает статус возвращаемого ресурса. Changestatus может иметь до 3 минут задержки, чтобы отразить новое изменение.

Представление JSON
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
Поля
resourceName

string

Только вывод. Имя ресурса статуса изменения. Изменение имен ресурсов по изменению. Имеет форму:

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum ( ChangeStatusResourceType )

Только вывод. Представляет тип измененного ресурса. Это диктует, какие поля будут установлены. Например, будут установлены области AD_GROUP, кампания и AdGroup.

resourceStatus

enum ( ChangeStatusOperation )

Только вывод. Представляет статус измененного ресурса.

sharedSet

string

Только вывод. Шарсет, затронутый этим изменением.

campaignSharedSet

string

Только вывод. Кампания, затронутая этим изменением.

asset

string

Только вывод. Актив, затронутый этим изменением.

customerAsset

string

Только вывод. Customersset, затронутый этим изменением.

campaignAsset

string

Только вывод. Кампания, затронутая этим изменением.

adGroupAsset

string

Только вывод. Adgroupasset, затронутый этим изменением.

combinedAudience

string

Только вывод. Комбинированное, затронутое этим изменением.

lastChangeDateTime

string

Только вывод. Время, в течение которого самые последние изменения произошли в этом ресурсе.

campaign

string

Только вывод. Кампания повлияла на это изменение.

adGroup

string

Только вывод. Адгруппа, затронутая этим изменением.

adGroupAd

string

Только вывод. Адгрупад затронут этим изменением.

adGroupCriterion

string

Только вывод. Адгруппитерион, затронутое этим изменением.

campaignCriterion

string

Только вывод. Кампания, затронутая этим изменением.

feed

string

Только вывод. Корм затронут этим изменением.

feedItem

string

Только вывод. FeedItem, затронутая этим изменением.

adGroupFeed

string

Только вывод. Adgroupfeed, затронутое этим изменением.

campaignFeed

string

Только вывод. Наверное, затронутое этим изменением.

adGroupBidModifier

string

Только вывод. Adgroupbidmodifier, затронутый этим изменением.

Changestatusresourcetype

Enum перечисляет поддержку типов ресурсов с помощью ресурса Changestatus.

Перечисление
UNSPECIFIED Значения не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет собой несекретный ресурс, неизвестный в этой версии.
AD_GROUP Изменение ресурса Adgroup.
AD_GROUP_AD Изменение ресурса adgroupad.
AD_GROUP_CRITERION Адгруппитерионное изменение ресурса.
CAMPAIGN Изменение ресурсов кампании.
CAMPAIGN_CRITERION Изменение ресурсов Campaination Commancecriterion.
FEED Изменение ресурса корма.
FEED_ITEM Изменение ресурса FeedItem.
AD_GROUP_FEED Изменение ресурса Adgroupfeed.
CAMPAIGN_FEED Изменение ресурсов Campaignfeed.
AD_GROUP_BID_MODIFIER Изменение ресурса Adgroupbidmodifier.
SHARED_SET Изменение ресурса SharedSet.
CAMPAIGN_SHARED_SET Смена ресурсов кампании.
ASSET Изменение ресурса активов.
CUSTOMER_ASSET Изменение ресурса Customersset.
CAMPAIGN_ASSET Изменение ресурсов кампании.
AD_GROUP_ASSET Изменение ресурса adgroupasset.
COMBINED_AUDIENCE Комбинированное изменение ресурсов.

Changestatusoperation

Статус измененного ресурса

Перечисление
UNSPECIFIED Значения не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет собой несекретный ресурс, неизвестный в этой версии.
ADDED Ресурс был создан.
CHANGED Ресурс был изменен.
REMOVED Ресурс был удален.

Комбинированное

Опишите ресурс для комбинированной аудитории, который включает в себя различную аудиторию.

Представление JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
Поля
resourceName

string

Неизменный. Название ресурса комбинированной аудитории. Объединенные имена аудитории имеют форму:

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string ( int64 format)

Только вывод. ID комбинированной аудитории.

status

enum ( CombinedAudienceStatus )

Только вывод. Статус этой комбинированной аудитории. Указывает, включена ли комбинированная аудитория или удалена.

name

string

Только вывод. Название комбинированной аудитории. Это должно быть уникальным для всей комбинированной аудитории.

description

string

Только вывод. Описание этой комбинированной аудитории.

Комбинированное Audiencestatus

Enum, содержащий возможные комбинированные типы статусов аудитории.

Перечисление
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
ENABLED Включенный статус - комбинированная аудитория включена и может быть нацелена.
REMOVED Удаленный статус - комбинированная аудитория удаляется и не может использоваться для таргетинга.

НажмитеПросмотреть

Просмотр щелчка с метриками, агрегированными на каждом уровне клика, включая как действительные, так и недействительные клики. Для несовместимых кампаний Metrics.Clicks представляет количество действительных и недействительных взаимодействий. Запросы, включая ClickView, должны иметь фильтр, ограничивающий результаты до одного дня, и могут быть запрошены даты до 90 дней до времени запроса.

Представление JSON
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
Поля
resourceName

string

Только вывод. Имя ресурса представления Click. Нажмите «Просмотреть имена ресурсов» есть форма:

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

areaOfInterest

object ( ClickLocation )

Только вывод. Критерии местоположения, соответствующие интересующей области, связанной с впечатлением.

locationOfPresence

object ( ClickLocation )

Только вывод. Критерии местоположения, соответствующие местоположению присутствия, связанного с впечатлением.

keyword

string

Только вывод. Связанное ключевое слово, если оно существует и щелчок соответствует каналу поиска.

keywordInfo

object ( KeywordInfo )

Только вывод. Основная информация о связанном ключевом словах, если оно существует.

gclid

string

Только вывод. Google Click ID.

pageNumber

string ( int64 format)

Только вывод. Номер страницы в результатах поиска, где было показано объявление.

adGroupAd

string

Только вывод. Связанная реклама.

campaignLocationTarget

string

Только вывод. Сопутствующая цель расположения кампании, если он существует.

userList

string

Только вывод. Связанный список пользователей, если он существует.

Clicklocation

Критерии местоположения, связанные с щелчком.

Представление JSON
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
Поля
city

string

Критерий местоположения города, связанный с впечатлением.

country

string

Критерий местоположения страны, связанный с впечатлением.

metro

string

Критерий местоположения метро, ​​связанный с впечатлением.

mostSpecific

string

Самый конкретный критерий местоположения, связанный с впечатлением.

region

string

Критерий местоположения региона, связанный с впечатлением.

CurrencyConstant

Константа валюты.

Представление JSON
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
Поля
resourceName

string

Только вывод. Название ресурса постоянной валюты. Имена ресурсов постоянной валюты имеют форму:

currencyConstants/{code}

code

string

Только вывод. ISO 4217 Код трехбуквенного валюты, например, «USD»

name

string

Только вывод. Полное английское название валюты.

symbol

string

Только вывод. Стандартный символ для описания этой валюты, например, '$' за доллары США.

billableUnitMicros

string ( int64 format)

Только вывод. Оплачиваемая единица для этой валюты. Считаемые суммы должны быть множеством этого значения.

Доступно

Представляет представление о Биддингстратегии, принадлежащих и передаваемой клиенту.

В отличие от Biddingstrategy, этот ресурс включает в себя стратегии, принадлежащие менеджерам клиента и совместно с этим клиентом - в дополнение к стратегиям, принадлежащим этому клиенту. Этот ресурс не предоставляет метрики и обнажает только ограниченное подмножество атрибутов Биддингстратегии.

Представление JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Поля
resourceName

string

Только вывод. Имя ресурса доступной стратегии торгов. Доступные имена ресурсов доступны: есть форма:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string ( int64 format)

Только вывод. Идентификатор стратегии торгов.

name

string

Только вывод. Название стратегии торгов.

type

enum ( BiddingStrategyType )

Только вывод. Тип стратегии торгов.

ownerCustomerId

string ( int64 format)

Только вывод. Идентификатор клиента, который владеет стратегией торгов.

ownerDescriptiveName

string

Только вывод. descriptivename клиента, который владеет стратегией торгов.

Полевая scheme Союза. Схема торгов.

Только один может быть установлен. scheme может быть только одной из следующих:

maximizeConversionValue

object ( MaximizeConversionValue )

Только вывод. Автоматизированная стратегия торгов, чтобы помочь получить наибольшую ценность конверсии для ваших кампаний при проведении вашего бюджета.

maximizeConversions

object ( MaximizeConversions )

Только вывод. Автоматизированная стратегия торгов, чтобы помочь получить наибольшее количество конверсий для ваших кампаний при проведении вашего бюджета.

targetCpa

object ( TargetCpa )

Только вывод. Стратегия торгов, которая устанавливает ставки, чтобы помочь получить как можно больше конверсий в целевой стоимости за затрат на получение (CPA), которую вы устанавливаете.

targetImpressionShare

object ( TargetImpressionShare )

Только вывод. Стратегия торга, которая автоматически оптимизирует в направлении выбранного процента впечатлений.

targetRoas

object ( TargetRoas )

Только вывод. Стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной целевой доходности по расходам на рекламу (ROAS).

targetSpend

object ( TargetSpend )

Только вывод. Стратегия ставки, которая устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета.

MaximizeConversionValue

Автоматизированная стратегия торгов, чтобы помочь получить наибольшую ценность конверсии для ваших кампаний при проведении вашего бюджета.

Представление JSON
{
  "targetRoas": number
}
Поля
targetRoas

number

Только вывод. Опция «Возврат» на рекламу (ROAS). В случае установки стратегия ставки будет максимизировать доход, усредняя доход от целевого роста по расходам на рекламу. Если цель ROAS высока, стратегия ставки может не может потратить полный бюджет. Если Target ROAS не установлен, стратегия предложения будет направлена ​​на достижение максимально возможных ROA для бюджета.

Максимальные реверсии

Автоматизированная стратегия торгов, чтобы помочь получить наибольшее количество конверсий для ваших кампаний при проведении вашего бюджета.

Представление JSON
{
  "targetCpaMicros": string
}
Поля
targetCpaMicros

string ( int64 format)

Только вывод. Опция целевой стоимости за приобретение (CPA). Это средняя сумма, которую вы хотели бы потратить за приобретение.

TargetCpa

Автоматизированная стратегия ставки, которая устанавливает ставки, чтобы помочь получить как можно больше конверсий в целевой стоимости за затраты на получение (CPA), которую вы устанавливаете.

Представление JSON
{
  "targetCpaMicros": string
}
Поля
targetCpaMicros

string ( int64 format)

Только вывод. Средняя цель CPA. Эта цель должна быть больше или равна минимально оплачиваемой единице на основе валюты для учетной записи.

TargetImpressionShare

Автоматизированная стратегия торгов, которая устанавливает ставки так, чтобы определенный процент поисковой рекламы показан в верхней части первой страницы (или другого целевого местоположения).

Представление JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Поля
location

enum ( TargetImpressionShareLocation )

Только вывод. Целевое местоположение на странице результатов поиска.

locationFractionMicros

string ( int64 format)

Выбранная доля объявлений, которая будет показана в целевом месте в микрос. Например, 1% равняется 10000.

cpcBidCeilingMicros

string ( int64 format)

Только вывод. Самая высокая ставка CPC. Автоматизированная система торгов разрешена указать. Это требуемое поле, введенное рекламодателем, которое устанавливает потолок и указанный в локальных микросхемах.

TargetRoas

Автоматизированная стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной целевой доходности по расходам на рекламу (ROAS).

Представление JSON
{
  "targetRoas": number
}
Поля
targetRoas

number

Только вывод. Выбранный доход (на основе данных конверсии) на единицу расходов.

TargetSpend

Автоматизированная стратегия ставки, которая устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета.

Представление JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Поля
targetSpendMicros
(deprecated)

string ( int64 format)

Только вывод. Цель расходов, по которой можно максимизировать клики. Участник TargetSpend попытается потратить меньшую часть этой стоимости или на естественную сумму затрат на дросселирование. Если не указано, бюджет используется в качестве цели расходов. Это поле устарело и больше не должно использоваться. См .

cpcBidCeilingMicros

string ( int64 format)

Только вывод. Максимальный предел ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией.

CustomerClient

Связь между данным клиентом и клиентом клиента. Customerclients существуют только для клиентов менеджера. Все прямые и косвенные клиенты включены, а также самого менеджера.

Представление JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Поля
resourceName

string

Только вывод. Имя ресурса клиента. Имена ресурсов CustomerClient имеет форму: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Только вывод. Названия ресурсов меток, принадлежащих запрашивающему клиенту, которые применяются к клиенту. Имена ресурсов метки имеют форму:

customers/{customerId}/labels/{label_id}

status

enum ( CustomerStatus )

Только вывод. Статус клиента клиента. Читать только.

clientCustomer

string

Только вывод. Имя ресурса клиента-клиента, которое связано с данным клиентом. Читать только.

hidden

boolean

Только вывод. Указывает, является ли это скрытой учетной записью . Читать только.

level

string ( int64 format)

Только вывод. Расстояние между данным клиентом и клиентом. Для самооценки значение уровня будет 0. Только чтение.

timeZone

string

Только вывод. Обычное представление строки данных общего локали (CLDR) часового пояса клиента, например, America/Los_angeles. Читать только.

testAccount

boolean

Только вывод. Определяет, является ли клиент тестовой учетной записью. Читать только.

manager

boolean

Только вывод. Определяет, является ли клиент менеджером. Читать только.

descriptiveName

string

Только вывод. Описательное имя для клиента. Читать только.

currencyCode

string

Только вывод. Валютный код (например, «USD», «EUR») для клиента. Читать только.

id

string ( int64 format)

Только вывод. Идентификатор клиента клиента. Читать только.

CustomereShermInsight

Представление об поиске клиента. Исторические данные доступны с марта 2023 года.

Представление JSON
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
Поля
resourceName

string

Только вывод. Название ресурса Поисковому термину клиента Поиск. Имена ресурсов поиска на уровне клиента имеют форму:

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

Только вывод. Ярлык для категории поиска. Пустая строка обозначает категорию «Улов-все» для поисковых терминов, которые не вписывались в другую категорию.

id

string ( int64 format)

Только вывод. Идентификатор понимания.

DetailPlacewiew

Взгляд с метриками, агрегированными AD Group и URL или видео на YouTube.

Представление JSON
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
Поля
resourceName

string

Только вывод. Имя ресурса представления размещения детализации. Подробное размещение имена ресурсов имеют форму:

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

placementType

enum ( PlacementType )

Только вывод. Тип размещения, например, веб -сайт, видео на YouTube и мобильное приложение.

placement

string

Только вывод. Строка автоматического размещения на уровне детализации, например, URL -адрес веб -сайта, идентификатор мобильного приложения или идентификатор видео на YouTube.

displayName

string

Только вывод. Имя отображения - это имя URL для веб -сайтов, имя видео на YouTube для видео на YouTube и переведенное имя мобильного приложения для мобильных приложений.

groupPlacementTargetUrl

string

Только вывод. URL -адрес группы размещения, например, домена, ссылка на мобильное приложение в App Store или URL -адрес канала YouTube.

targetUrl

string

Только вывод. URL размещения, например, веб -сайта, ссылки на мобильное приложение в App Store или URL -адрес видео на YouTube.

PlacementType

Возможные типы размещения для картирования подачи.

Перечисление
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 ::L8ZULXASCC1I_OAOT0NAOQ»).
GOOGLE_PRODUCTS Поверхности, принадлежащие и управляемые Google (например, «tv.google.com»).

Подробный подразделение

Подробная демография: особая основанная на интересах вертикали, которая будет направлена ​​на охват пользователей на основе долгосрочных фактов жизни.

Представление JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Поля
resourceName

string

Только вывод. Название ресурса подробной демографии. Подробные демографические имена ресурсов имеют форму:

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string ( int64 format)

Только вывод. Идентификатор подробной демографии.

name

string

Только вывод. Название подробной демографии. Например, «самый высокий уровень образования»

parent

string

Только вывод. Родитель DetailedDemographic.

launchedToAll

boolean

Только вывод. Правда, если подробная демография запущена во все каналы и локали.

availabilities[]

object ( CriterionCategoryAvailability )

Только вывод. Информация о доступности подробной демографии.

CriterionCategoryAvailability

Информация о доступности категории, по рекламному каналу.

Представление JSON
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
Поля
channel

object ( CriterionCategoryChannelAvailability )

Типы каналов и подтипы, которые доступны для категории.

locale[]

object ( CriterionCategoryLocaleAvailability )

Локалы, которые доступны для категории для канала.

CriterionCategoryChannelAviability

Информация о типе рекламного канала и подтипах доступна в категории.

Представление JSON
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
Поля
availabilityMode

enum ( CriterionCategoryChannelAvailabilityMode )

Формат доступности канала. Может быть All_Channels (остальные поля не будут установлены), будет установлена ​​только тип рекламы CankenshannelType, категория доступна для всех подложений под ним) или Channel_type_and_subtypes (AdvertisingChannelType, AdvertisingChannelsUbtype и включены в комплект.

advertisingChannelType

enum ( AdvertisingChannelType )

Тип канала Категория доступна.

advertisingChannelSubType[]

enum ( AdvertisingChannelSubType )

Каналы подтипы под типом канала. Категория доступна.

includeDefaultChannelSubType

boolean

Включен ли подканальный тип канала по умолчанию. Например, AdvertisingChannelType отображается и включает в себя efaultChannelsUbtype False означает, что кампания отображения по умолчанию, в которой Sub -тип канала не установлен, не включена в эту конфигурацию доступности.

CriterionCategoryChannelabailabilityMode

Enum, содержащий возможный критерий категориюканал AvialabilityMode.

Перечисление
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
ALL_CHANNELS Категория доступна для кампаний всех типов каналов и подтипов.
CHANNEL_TYPE_AND_ALL_SUBTYPES Категория доступна для кампаний конкретного типа канала, включая все подтипы под ним.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES Категория доступна для кампаний конкретного типа канала и подтипа (ы).

CriterionCategorylocaleaVailability

Информация о том, какая локация категория доступна в.

Представление JSON
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
Поля
availabilityMode

enum ( CriterionCategoryLocaleAvailabilityMode )

Формат доступности локали. Может быть запущен_TO_ALL (как страна, так и язык будут пусты), страна (будет установлена ​​только страна), язык (только язык будет установлен), Country_and_language (как страна, так и язык будут установлены).

countryCode

string

ISO-3166-1 Код страны Альфа-2, связанный с категорией.

languageCode

string

ISO 639-1 Код языка, связанного с категорией.

CriterionCategorylocaleaVailabilityMode

Enum, содержащий возможный критерий категорийлокалеавейсмод.

Перечисление
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
ALL_LOCALES Категория доступна для кампаний всех мест.
COUNTRY_AND_ALL_LANGUAGES Категория доступна для кампаний в списке стран, независимо от языка.
LANGUAGE_AND_ALL_COUNTRIES Категория доступна для кампаний в списке языков, независимо от страны.
COUNTRY_AND_LANGUAGE Категория доступна для кампаний в списке страны, языковых пар.

DisplayKeyWordView

Просмотр ключевого слова отображения.

Представление JSON
{
  "resourceName": string
}
Поля
resourceName

string

Только вывод. Имя ресурса представления ключевого слова отображения. Display Keyword view resource names have the form:

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

DistanceView

A distance view with metrics aggregated by the user's distance from an advertiser's location extensions. Each DistanceBucket includes all impressions that fall within its distance and a single impression will contribute to the metrics for all DistanceBuckets that include the user's distance.

JSON representation
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
Поля
resourceName

string

Output only. The resource name of the distance view. Distance view resource names have the form:

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

distanceBucket

enum ( DistanceBucket )

Output only. Grouping of user distance from location extensions.

metricSystem

boolean

Output only. True if the DistanceBucket is using the metric system, false otherwise.

DistanceBucket

The distance bucket for a user's distance from an advertiser's location extension.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
WITHIN_700M User was within 700m of the location.
WITHIN_1KM User was within 1KM of the location.
WITHIN_5KM User was within 5KM of the location.
WITHIN_10KM User was within 10KM of the location.
WITHIN_15KM User was within 15KM of the location.
WITHIN_20KM User was within 20KM of the location.
WITHIN_25KM User was within 25KM of the location.
WITHIN_30KM User was within 30KM of the location.
WITHIN_35KM User was within 35KM of the location.
WITHIN_40KM User was within 40KM of the location.
WITHIN_45KM User was within 45KM of the location.
WITHIN_50KM User was within 50KM of the location.
WITHIN_55KM User was within 55KM of the location.
WITHIN_60KM User was within 60KM of the location.
WITHIN_65KM User was within 65KM of the location.
BEYOND_65KM User was beyond 65KM of the location.
WITHIN_0_7MILES User was within 0.7 miles of the location.
WITHIN_1MILE User was within 1 mile of the location.
WITHIN_5MILES User was within 5 miles of the location.
WITHIN_10MILES User was within 10 miles of the location.
WITHIN_15MILES User was within 15 miles of the location.
WITHIN_20MILES User was within 20 miles of the location.
WITHIN_25MILES User was within 25 miles of the location.
WITHIN_30MILES User was within 30 miles of the location.
WITHIN_35MILES User was within 35 miles of the location.
WITHIN_40MILES User was within 40 miles of the location.
BEYOND_40MILES User was beyond 40 miles of the location.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

JSON representation
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
Поля
resourceName

string

Output only. The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form:

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

searchTerm

string

Output only. Искать термин

This field is read-only.

headline

string

Output only. The dynamically generated headline of the Dynamic Search Ad.

This field is read-only.

landingPage

string

Output only. The dynamically selected landing page URL of the impression.

This field is read-only.

pageUrl

string

Output only. The URL of page feed item served for the impression.

This field is read-only.

hasNegativeKeyword

boolean

Output only. True if query matches a negative keyword.

This field is read-only.

hasMatchingKeyword

boolean

Output only. True if query is added to targeted keywords.

This field is read-only.

hasNegativeUrl

boolean

Output only. True if query matches a negative url.

This field is read-only.

ExpandedLandingPageView

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

JSON representation
{
  "resourceName": string,
  "expandedFinalUrl": string
}
Поля
resourceName

string

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

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expandedFinalUrl

string

Output only. The final URL that clicks are directed to.

FeedPlaceholderView

A feed placeholder view.

JSON representation
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
Поля
resourceName

string

Output only. The resource name of the feed placeholder view. Feed placeholder view resource names have the form:

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum ( PlaceholderType )

Output only. The placeholder type of the feed placeholder view.

GenderView

A gender view. The genderView resource reflects the effective serving state, rather than what criteria were added. An ad group without gender criteria by default shows to all genders, so all genders appear in genderView with stats.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

Output only. The resource name of the gender view. Gender view resource names have the form:

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

GeographicView

A geographic view.

Geographic View includes all metrics aggregated at the country level, one row per country. It reports metrics at either actual physical location of the user or an area of interest. If other segment fields are used, you may get more than one row per country.

JSON representation
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
Поля
resourceName

string

Output only. The resource name of the geographic view. Geographic view resource names have the form:

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

locationType

enum ( GeoTargetingType )

Output only. Type of the geo targeting of the campaign.

countryCriterionId

string ( int64 format)

Output only. Criterion Id for the country.

GeoTargetingType

The possible geo targeting types.

Enums
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
AREA_OF_INTEREST Location the user is interested in while making the query.
LOCATION_OF_PRESENCE Location of the user issuing the query.

GroupPlacementView

A group placement view.

JSON representation
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
Поля
resourceName

string

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

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

placementType

enum ( PlacementType )

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

placement

string

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

displayName

string

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

targetUrl

string

Output only. URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL.

HotelGroupView

A hotel group view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

HotelPerformanceView

A hotel performance view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

customers/{customerId}/hotelPerformanceView

HotelReconciliation

A hotel reconciliation. It contains conversion information from Hotel bookings to reconcile with advertiser records. These rows may be updated or canceled before billing through Bulk Uploads.

JSON representation
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
Поля
resourceName

string

Неизменный. The resource name of the hotel reconciliation. Hotel reconciliation resource names have the form:

customers/{customerId}/hotelReconciliations/{commissionId}

commissionId

string

Необходимый. Output only. The commission ID is Google's ID for this booking. Every booking event is assigned a Commission ID to help you match it to a guest stay.

orderId

string

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

campaign

string

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

hotelCenterId

string ( int64 format)

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

hotelId

string

Output only. Unique identifier for the booked property, as provided in the Hotel Center feed. The hotel ID comes from the 'ID' parameter of the conversion tracking tag.

checkInDate

string

Output only. Check-in date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD.

checkOutDate

string

Output only. Check-out date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD.

reconciledValueMicros

string ( int64 format)

Необходимый. Output only. Reconciled value is the final value of a booking as paid by the guest. If original booking value changes for any reason, such as itinerary changes or room upsells, the reconciled value should be the full final amount collected. If a booking is canceled, the reconciled value should include the value of any cancellation fees or non-refundable nights charged. Value is in millionths of the base unit currency. For example, $12.35 would be represented as 12350000. Currency unit is in the default customer currency.

billed

boolean

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

status

enum ( HotelReconciliationStatus )

Необходимый. Output only. Current status of a booking with regards to reconciliation and billing. Bookings should be reconciled within 45 days after the check-out date. Any booking not reconciled within 45 days will be billed at its original value.

HotelReconciliationStatus

Status of the hotel booking reconciliation.

Enums
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
RESERVATION_ENABLED Bookings are for a future date, or a stay is underway but the check-out date hasn't passed. An active reservation can't be reconciled.
RECONCILIATION_NEEDED Check-out has already taken place, or the booked dates have passed without cancellation. Bookings that are not reconciled within 45 days of the check-out date are billed based on the original booking price.
RECONCILED These bookings have been reconciled. Reconciled bookings are billed 45 days after the check-out date.
CANCELED This booking was marked as canceled. Canceled stays with a value greater than zero (due to minimum stay rules or cancellation fees) are billed 45 days after the check-out date.

IncomeRangeView

An income range view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

KeywordView

A keyword view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

LandingPageView

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

JSON representation
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
Поля
resourceName

string

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

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}

unexpandedFinalUrl

string

Output only. The advertiser-specified final URL.

LanguageConstant

Язык.

JSON representation
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Поля
resourceName

string

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

languageConstants/{criterionId}

id

string ( int64 format)

Output only. The ID of the language constant.

code

string

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

name

string

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

targetable

boolean

Output only. Whether the language is targetable.

LocationView

A location view summarizes the performance of campaigns by a Location criterion. If no Location criterion is set, no results are returned; instead, use geographicView or userLocationView for visitor location data.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

ManagedPlacementView

A managed placement view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

MobileAppCategoryConstant

A mobile application category constant.

JSON representation
{
  "resourceName": string,
  "id": integer,
  "name": string
}
Поля
resourceName

string

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

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

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

name

string

Output only. Mobile app category name.

MobileDeviceConstant

A mobile device constant.

JSON representation
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
Поля
resourceName

string

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

mobileDeviceConstants/{criterionId}

type

enum ( MobileDeviceType )

Output only. The type of mobile device.

id

string ( int64 format)

Output only. The ID of the mobile device constant.

name

string

Output only. The name of the mobile device.

manufacturerName

string

Output only. The manufacturer of the mobile device.

operatingSystemName

string

Output only. The operating system of the mobile device.

MobileDeviceType

The type of mobile device.

Enums
UNSPECIFIED Не указан.
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 representation
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
Поля
resourceName

string

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

operatingSystemVersionConstants/{criterionId}

operatorType

enum ( OperatingSystemVersionOperatorType )

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

id

string ( int64 format)

Output only. The ID of the operating system version.

name

string

Output only. Name of the operating system.

osMajorVersion

integer

Output only. The OS Major Version number.

osMinorVersion

integer

Output only. The OS Minor Version number.

OperatingSystemVersionOperatorType

The type of operating system version.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
EQUALS_TO Equals to the specified version.
GREATER_THAN_EQUALS_TO Greater than or equals to the specified version.

PaidOrganicSearchTermView

A paid organic search term view providing a view of search stats across ads and organic listings aggregated by search term at the ad group level.

JSON representation
{
  "resourceName": string,
  "searchTerm": string
}
Поля
resourceName

string

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

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

searchTerm

string

Output only. The search term.

QualifyingQuestion

Qualifying Questions for Lead Form.

JSON representation
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
Поля
resourceName

string

Output only. The resource name of the qualifying question.

'qualifyingQuestions/{qualifyingQuestionId}'

qualifyingQuestionId

string ( int64 format)

Output only. The id of the qualifying question.

locale

string

Output only. The locale of the qualifying question.

text

string

Output only. The qualifying question.

ParentalStatusView

A parental status view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

PerStoreView

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

JSON representation
{
  "resourceName": string,
  "placeId": string
}
Поля
resourceName

string

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

customers/{customerId}/perStoreViews/{placeId}

placeId

string

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

ProductBiddingCategoryConstant

A Product Bidding Category.

JSON representation
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Поля
resourceName

string

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

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

level

enum ( ProductBiddingCategoryLevel )

Output only. Level of the product bidding category.

status

enum ( ProductBiddingCategoryStatus )

Output only. Status of the product bidding category.

id

string ( int64 format)

Output only. ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 .

countryCode

string

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

productBiddingCategoryConstantParent

string

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

languageCode

string

Output only. Language code of the product bidding category.

localizedName

string

Output only. Display value of the product bidding category localized according to languageCode.

ProductBiddingCategoryStatus

Enum describing the status of the product bidding category.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE The category is active and can be used for bidding.
OBSOLETE The category is obsolete. Used only for reporting purposes.

ProductGroupView

A product group view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

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

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

Рекомендация

A recommendation.

JSON representation
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

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

string

Неизменный. The resource name of the recommendation.

customers/{customerId}/recommendations/{recommendation_id}

type

enum ( RecommendationType )

Output only. The type of recommendation.

impact

object ( RecommendationImpact )

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

campaigns[]

string

Output only. The campaigns targeted by this recommendation.

This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET and MOVE_UNUSED_BUDGET

campaignBudget

string

Output only. The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget.

This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET

campaign

string

Output only. The campaign targeted by this recommendation.

This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS,

adGroup

string

Output only. The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group.

This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD

dismissed

boolean

Output only. Whether the recommendation is dismissed or not.

Union field recommendation . The details of recommendation. recommendation can be only one of the following:
campaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The campaign budget recommendation.

forecastingCampaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The forecasting campaign budget recommendation.

keywordRecommendation

object ( KeywordRecommendation )

Output only. The keyword recommendation.

textAdRecommendation

object ( TextAdRecommendation )

Output only. Add expanded text ad recommendation.

targetCpaOptInRecommendation

object ( TargetCpaOptInRecommendation )

Output only. The TargetCPA opt-in recommendation.

maximizeConversionsOptInRecommendation

object ( MaximizeConversionsOptInRecommendation )

Output only. The MaximizeConversions Opt-In recommendation.

enhancedCpcOptInRecommendation

object ( EnhancedCpcOptInRecommendation )

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

searchPartnersOptInRecommendation

object ( SearchPartnersOptInRecommendation )

Output only. The Search Partners Opt-In recommendation.

maximizeClicksOptInRecommendation

object ( MaximizeClicksOptInRecommendation )

Output only. The MaximizeClicks Opt-In recommendation.

optimizeAdRotationRecommendation

object ( OptimizeAdRotationRecommendation )

Output only. The Optimize Ad Rotation recommendation.

keywordMatchTypeRecommendation

object ( KeywordMatchTypeRecommendation )

Output only. The keyword match type recommendation.

moveUnusedBudgetRecommendation

object ( MoveUnusedBudgetRecommendation )

Output only. The move unused budget recommendation.

targetRoasOptInRecommendation

object ( TargetRoasOptInRecommendation )

Output only. The Target ROAS opt-in recommendation.

responsiveSearchAdRecommendation

object ( ResponsiveSearchAdRecommendation )

Output only. The add responsive search ad recommendation.

marginalRoiCampaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The marginal ROI campaign budget recommendation.

useBroadMatchKeywordRecommendation

object ( UseBroadMatchKeywordRecommendation )

Output only. The use broad match keyword recommendation.

responsiveSearchAdAssetRecommendation

object ( ResponsiveSearchAdAssetRecommendation )

Output only. The responsive search ad asset recommendation.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object ( UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation )

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

responsiveSearchAdImproveAdStrengthRecommendation

object ( ResponsiveSearchAdImproveAdStrengthRecommendation )

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

displayExpansionOptInRecommendation

object ( DisplayExpansionOptInRecommendation )

Output only. The Display Expansion opt-in recommendation.

upgradeLocalCampaignToPerformanceMaxRecommendation

object ( UpgradeLocalCampaignToPerformanceMaxRecommendation )

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

raiseTargetCpaBidTooLowRecommendation

object ( RaiseTargetCpaBidTooLowRecommendation )

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

forecastingSetTargetRoasRecommendation

object ( ForecastingSetTargetRoasRecommendation )

Output only. The forecasting set target ROAS recommendation.

calloutAssetRecommendation

object ( CalloutAssetRecommendation )

Output only. The callout asset recommendation.

callAssetRecommendation

object ( CallAssetRecommendation )

Output only. The call asset recommendation.

shoppingAddAgeGroupRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add age group recommendation.

shoppingAddColorRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add color recommendation.

shoppingAddGenderRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add gender recommendation.

shoppingAddGtinRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add GTIN recommendation.

shoppingAddMoreIdentifiersRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add more identifiers recommendation.

shoppingAddSizeRecommendation

object ( ShoppingOfferAttributeRecommendation )

Output only. The shopping add size recommendation.

shoppingAddProductsToCampaignRecommendation

object ( ShoppingAddProductsToCampaignRecommendation )

Output only. The shopping add products to campaign recommendation.

shoppingFixDisapprovedProductsRecommendation

object ( ShoppingFixDisapprovedProductsRecommendation )

Output only. The shopping fix disapproved products recommendation.

shoppingTargetAllOffersRecommendation

object ( ShoppingTargetAllOffersRecommendation )

Output only. The shopping target all offers recommendation.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

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

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

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

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object ( ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation )

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

dynamicImageExtensionOptInRecommendation

object ( DynamicImageExtensionOptInRecommendation )

Output only. Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.

raiseTargetCpaRecommendation

object ( RaiseTargetCpaRecommendation )

Output only. Recommendation to raise Target CPA.

lowerTargetRoasRecommendation

object ( LowerTargetRoasRecommendation )

Output only. Recommendation to lower Target ROAS.

performanceMaxOptInRecommendation

object ( PerformanceMaxOptInRecommendation )

Output only. The Performance Max Opt In recommendation.

improvePerformanceMaxAdStrengthRecommendation

object ( ImprovePerformanceMaxAdStrengthRecommendation )

Output only. The improve Performance Max ad strength recommendation.

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object ( MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation )

Output only. The Dynamic Search Ads to Performance Max migration recommendation.

RecommendationType

Types of recommendations.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
CAMPAIGN_BUDGET Budget recommendation for campaigns that are currently budget-constrained (as opposed to the FORECASTING_CAMPAIGN_BUDGET recommendation, which applies to campaigns that are expected to become budget-constrained in the future).
KEYWORD Keyword recommendation.
TEXT_AD Recommendation to add a new text ad.
TARGET_CPA_OPT_IN Recommendation to update a campaign to use a Target CPA bidding strategy.
MAXIMIZE_CONVERSIONS_OPT_IN Recommendation to update a campaign to use the Maximize Conversions bidding strategy.
ENHANCED_CPC_OPT_IN Recommendation to enable Enhanced Cost Per Click for a campaign.
SEARCH_PARTNERS_OPT_IN Recommendation to start showing your campaign's ads on Google Search Partners Websites.
MAXIMIZE_CLICKS_OPT_IN Recommendation to update a campaign to use a Maximize Clicks bidding strategy.
OPTIMIZE_AD_ROTATION Recommendation to start using the "Optimize" ad rotation setting for the given ad group.
KEYWORD_MATCH_TYPE Recommendation to change an existing keyword from one match type to a broader match type.
MOVE_UNUSED_BUDGET Recommendation to move unused budget from one budget to a constrained budget.
FORECASTING_CAMPAIGN_BUDGET Budget recommendation for campaigns that are expected to become budget-constrained in the future (as opposed to the CAMPAIGN_BUDGET recommendation, which applies to campaigns that are currently budget-constrained).
TARGET_ROAS_OPT_IN Recommendation to update a campaign to use a Target ROAS bidding strategy.
RESPONSIVE_SEARCH_AD Recommendation to add a new responsive search ad.
MARGINAL_ROI_CAMPAIGN_BUDGET Budget recommendation for campaigns whose ROI is predicted to increase with a budget adjustment.
USE_BROAD_MATCH_KEYWORD Recommendation to add broad match versions of keywords for fully automated conversion-based bidding campaigns.
RESPONSIVE_SEARCH_AD_ASSET Recommendation to add new responsive search ad assets.
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX Recommendation to upgrade a Smart Shopping campaign to a Performance Max campaign.
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH Recommendation to improve strength of responsive search ad.
DISPLAY_EXPANSION_OPT_IN Recommendation to update a campaign to use Display Expansion.
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX Recommendation to upgrade a Local campaign to a Performance Max campaign.
RAISE_TARGET_CPA_BID_TOO_LOW Recommendation to raise target CPA when it is too low and there are very few or no conversions. It is applied asynchronously and can take minutes depending on the number of ad groups there are in the related campaign.
FORECASTING_SET_TARGET_ROAS Recommendation to raise the budget in advance of a seasonal event that is forecasted to increase traffic, and change bidding strategy from maximize conversion value to target ROAS.
CALLOUT_ASSET Recommendation to add callout assets to campaign or customer level.
CALL_ASSET Recommendation to add call assets to campaign or customer level.
SHOPPING_ADD_AGE_GROUP Recommendation to add the age group attribute to offers that are demoted because of a missing age group.
SHOPPING_ADD_COLOR Recommendation to add a color to offers that are demoted because of a missing color.
SHOPPING_ADD_GENDER Recommendation to add a gender to offers that are demoted because of a missing gender.
SHOPPING_ADD_GTIN Recommendation to add a GTIN (Global Trade Item Number) to offers that are demoted because of a missing GTIN.
SHOPPING_ADD_MORE_IDENTIFIERS Recommendation to add more identifiers to offers that are demoted because of missing identifiers.
SHOPPING_ADD_SIZE Recommendation to add the size to offers that are demoted because of a missing size.
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN Recommendation informing a customer about a campaign that cannot serve because no products are being targeted.
SHOPPING_FIX_DISAPPROVED_PRODUCTS The shopping recommendation informing a customer about campaign with a high percentage of disapproved products.
SHOPPING_TARGET_ALL_OFFERS Recommendation to create a catch-all campaign that targets all offers.
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT Recommendation to fix Merchant Center account suspension issues.
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING Recommendation to fix Merchant Center account suspension warning issues.
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX Recommendation to migrate offers targeted by Regular Shopping Campaigns to existing Performance Max campaigns.
DYNAMIC_IMAGE_EXTENSION_OPT_IN Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.
RAISE_TARGET_CPA Recommendation to raise Target CPA based on Google predictions modeled from past conversions. It is applied asynchronously and can take minutes depending on the number of ad groups there are in the related campaign.
LOWER_TARGET_ROAS Recommendation to lower Target ROAS.
PERFORMANCE_MAX_OPT_IN Recommendation to opt into Performance Max campaigns.
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating.
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX Recommendation to migrate Dynamic Search Ads to Performance Max campaigns.

RecommendationImpact

The impact of making the change as described in the recommendation. Some types of recommendations may not have impact information.

JSON representation
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
Поля
baseMetrics

object ( RecommendationMetrics )

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

potentialMetrics

object ( RecommendationMetrics )

Output only. Estimated metrics if the recommendation is applied.

RecommendationMetrics

Weekly account performance metrics. For some recommendation types, these are averaged over the past 90-day period and hence can be fractional.

JSON representation
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
Поля
impressions

number

Output only. Number of ad impressions.

clicks

number

Output only. Number of ad clicks.

costMicros

string ( int64 format)

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

conversions

number

Output only. Number of conversions.

videoViews

number

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

CampaignBudgetRecommendation

The budget recommendation for budget constrained campaigns.

JSON representation
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
Поля
budgetOptions[]

object ( CampaignBudgetRecommendationOption )

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

currentBudgetAmountMicros

string ( int64 format)

Output only. The current budget amount in micros.

recommendedBudgetAmountMicros

string ( int64 format)

Output only. The recommended budget amount in micros.

CampaignBudgetRecommendationOption

The impact estimates for a given budget amount.

JSON representation
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
Поля
impact

object ( RecommendationImpact )

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

budgetAmountMicros

string ( int64 format)

Output only. The budget amount for this option.

KeywordRecommendation

The keyword recommendation.

JSON representation
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
Поля
keyword

object ( KeywordInfo )

Output only. The recommended keyword.

searchTerms[]

object ( SearchTerm )

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

recommendedCpcBidMicros

string ( int64 format)

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

Искать термин

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

JSON representation
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
Поля
text

string

Output only. The text of the search term.

estimatedWeeklySearchCount

string ( int64 format)

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

TextAdRecommendation

The text ad recommendation.

JSON representation
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
Поля
ad

object ( Ad )

Output only. Recommended ad.

creationDate

string

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

autoApplyDate

string

Output only. Date, if present, is the earliest when the recommendation will be auto applied. YYYY-MM-DD format, for example, 2018-04-17.

TargetCpaOptInRecommendation

The Target CPA opt-in recommendation.

JSON representation
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
Поля
options[]

object ( TargetCpaOptInRecommendationOption )

Output only. The available goals and corresponding options for Target CPA strategy.

recommendedTargetCpaMicros

string ( int64 format)

Output only. The recommended average CPA target. See required budget amount and impact of using this recommendation in options list.

TargetCpaOptInRecommendationOption

The Target CPA opt-in option with impact estimate.

JSON representation
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
Поля
goal

enum ( TargetCpaOptInRecommendationGoal )

Output only. The goal achieved by this option.

impact

object ( RecommendationImpact )

Output only. The impact estimate if this option is selected.

targetCpaMicros

string ( int64 format)

Output only. Average CPA target.

requiredCampaignBudgetAmountMicros

string ( int64 format)

Output only. The minimum campaign budget, in local currency for the account, required to achieve the target CPA. Amount is specified in micros, where one million is equivalent to one currency unit.

TargetCpaOptInRecommendationGoal

Goal of TargetCpaOptIn recommendation.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
SAME_COST Recommendation to set Target CPA to maintain the same cost.
SAME_CONVERSIONS Recommendation to set Target CPA to maintain the same conversions.
SAME_CPA Recommendation to set Target CPA to maintain the same CPA.
CLOSEST_CPA Recommendation to set Target CPA to a value that is as close as possible to, yet lower than, the actual CPA (computed for past 28 days).

MaximizeConversionsOptInRecommendation

The Maximize Conversions Opt-In recommendation.

JSON representation
{
  "recommendedBudgetAmountMicros": string
}
Поля
recommendedBudgetAmountMicros

string ( int64 format)

Output only. The recommended new budget amount.

EnhancedCpcOptInRecommendation

This type has no fields.

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

SearchPartnersOptInRecommendation

This type has no fields.

The Search Partners Opt-In recommendation.

MaximizeClicksOptInRecommendation

The Maximize Clicks opt-in recommendation.

JSON representation
{
  "recommendedBudgetAmountMicros": string
}
Поля
recommendedBudgetAmountMicros

string ( int64 format)

Output only. The recommended new budget amount. Only set if the current budget is too high.

OptimizeAdRotationRecommendation

This type has no fields.

The Optimize Ad Rotation recommendation.

KeywordMatchTypeRecommendation

The keyword match type recommendation.

JSON representation
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
Поля
keyword

object ( KeywordInfo )

Output only. The existing keyword where the match type should be more broad.

recommendedMatchType

enum ( KeywordMatchType )

Output only. The recommended new match type.

MoveUnusedBudgetRecommendation

The move unused budget recommendation.

JSON representation
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
Поля
budgetRecommendation

object ( CampaignBudgetRecommendation )

Output only. The recommendation for the constrained budget to increase.

excessCampaignBudget

string

Output only. The excess budget's resourceName.

TargetRoasOptInRecommendation

The Target ROAS opt-in recommendation.

JSON representation
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
Поля
recommendedTargetRoas

number

Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive.

requiredCampaignBudgetAmountMicros

string ( int64 format)

Output only. The minimum campaign budget, in local currency for the account, required to achieve the target ROAS. Amount is specified in micros, where one million is equivalent to one currency unit.

ResponsiveSearchAdRecommendation

The add responsive search ad recommendation.

JSON representation
{
  "ad": {
    object (Ad)
  }
}
Поля
ad

object ( Ad )

Output only. Recommended ad.

UseBroadMatchKeywordRecommendation

The use broad match keyword recommendation.

JSON representation
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
Поля
keyword[]

object ( KeywordInfo )

Output only. Sample of keywords to be expanded to Broad Match.

suggestedKeywordsCount

string ( int64 format)

Output only. Total number of keywords to be expanded to Broad Match in the campaign.

campaignKeywordsCount

string ( int64 format)

Output only. Total number of keywords in the campaign.

campaignUsesSharedBudget

boolean

Output only. Whether the associated campaign uses a shared budget.

requiredCampaignBudgetAmountMicros

string ( int64 format)

Output only. The budget recommended to avoid becoming budget constrained after applying the recommendation.

ResponsiveSearchAdAssetRecommendation

The add responsive search ad asset recommendation.

JSON representation
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
Поля
currentAd

object ( Ad )

Output only. The current ad to be updated.

recommendedAssets

object ( Ad )

Output only. The recommended assets. This is populated only with the new headlines and/or descriptions, and is otherwise empty.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

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

JSON representation
{
  "merchantId": string,
  "salesCountryCode": string
}
Поля
merchantId

string ( int64 format)

Output only. ID of Merchant Center account.

salesCountryCode

string

Output only. Country whose products from merchant's inventory should be included.

ResponsiveSearchAdImproveAdStrengthRecommendation

The responsive search ad improve ad strength recommendation.

JSON representation
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
Поля
currentAd

object ( Ad )

Output only. The current ad to be updated.

recommendedAd

object ( Ad )

Output only. The updated ad.

DisplayExpansionOptInRecommendation

This type has no fields.

The Display Expansion opt-in recommendation.

UpgradeLocalCampaignToPerformanceMaxRecommendation

This type has no fields.

The Upgrade Local campaign to Performance Max campaign recommendation.

RaiseTargetCpaBidTooLowRecommendation

The raise target CPA bid too low recommendation.

JSON representation
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
Поля
recommendedTargetMultiplier

number

Output only. A number greater than 1.0 indicating the factor by which we recommend the target CPA should be increased.

averageTargetCpaMicros

string ( int64 format)

Output only. The current average target CPA of the campaign, in micros of customer local currency.

ForecastingSetTargetRoasRecommendation

The forecasting set target ROAS recommendation.

JSON representation
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Поля
recommendedTargetRoas

number

Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive.

campaignBudget

object ( CampaignBudget )

Output only. The campaign budget.

CampaignBudget

A campaign budget shared amongst various budget recommendation types.

JSON representation
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
Поля
currentAmountMicros

string ( int64 format)

Output only. Current budget amount.

recommendedNewAmountMicros

string ( int64 format)

Output only. Recommended budget amount.

newStartDate

string

Output only. The date when the new budget would start being used. This field will be set for the following recommendation types: FORECASTING_SET_TARGET_ROAS YYYY-MM-DD format, for example, 2018-04-17.

CalloutAssetRecommendation

The callout asset recommendation.

JSON representation
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
Поля
recommendedCampaignCalloutAssets[]

object ( Asset )

Output only. New callout extension assets recommended at the campaign level.

recommendedCustomerCalloutAssets[]

object ( Asset )

Output only. New callout extension assets recommended at the customer level.

SitelinkAssetRecommendation

The sitelink asset recommendation.

JSON representation
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
Поля

CallAssetRecommendation

This type has no fields.

The call asset recommendation.

ShoppingOfferAttributeRecommendation

The shopping recommendation to add an attribute to offers that are demoted because it is missing.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Поля
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The campaign feed label.

offersCount

string ( int64 format)

Output only. The number of online, servable offers.

demotedOffersCount

string ( int64 format)

Output only. The number of online, servable offers that are demoted for missing attributes. Visit the Merchant Center for more details.

MerchantInfo

The Merchant Center account details.

JSON representation
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
Поля
id

string ( int64 format)

Output only. The Merchant Center account ID.

name

string

Output only. The name of the Merchant Center account.

multiClient

boolean

Output only. Whether the Merchant Center account is a Multi-Client account (MCA).

ShoppingAddProductsToCampaignRecommendation

The shopping recommendation to add products to a Shopping Campaign Inventory.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Поля
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label for the campaign.

reason

enum ( Reason )

Output only. The reason why no products are attached to the campaign.

Причина

Issues that results in a shopping campaign targeting zero products.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS The Merchant Center account does not have any submitted products.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED The Merchant Center account does not have any submitted products in the feed.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN The Google Ads account has active campaign filters that prevents inclusion of offers in the campaign.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN All products available have been explicitly excluded from being targeted by the campaign.

ShoppingFixDisapprovedProductsRecommendation

The shopping recommendation to fix disapproved products in a Shopping Campaign Inventory.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Поля
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label for the campaign.

productsCount

string ( int64 format)

Output only. The number of products of the campaign.

disapprovedProductsCount

string ( int64 format)

Output only. The numbers of products of the campaign that are disapproved.

ShoppingTargetAllOffersRecommendation

The shopping recommendation to create a catch-all campaign that targets all offers.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Поля
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

untargetedOffersCount

string ( int64 format)

Output only. The number of untargeted offers.

feedLabel

string

Output only. The offer feed label.

ShoppingMerchantCenterAccountSuspensionRecommendation

The shopping recommendation to fix Merchant Center account suspension issues.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Поля
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label of the campaign for which the suspension happened.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

The shopping recommendation to migrate Regular Shopping Campaign targeted offers to Performance Max campaigns.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Поля
merchant

object ( MerchantInfo )

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label of the offers targeted by the campaigns sharing this suggestion.

DynamicImageExtensionOptInRecommendation

This type has no fields.

Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.

RaiseTargetCpaRecommendation

Recommendation to raise Target CPA.

JSON representation
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Поля
targetAdjustment

object ( TargetAdjustmentInfo )

Output only. The relevant information describing the recommended target adjustment.

appBiddingGoal

enum ( AppBiddingGoal )

Output only. Represents the goal towards which the bidding strategy should optimize. Only populated for App Campaigns.

TargetAdjustmentInfo

Information of a target adjustment recommendation.

JSON representation
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Поля
recommendedTargetMultiplier

number

Output only. The factor by which we recommend the target to be adjusted by.

currentAverageTargetMicros

string ( int64 format)

Output only. The current average target of the campaign or portfolio targeted by this recommendation.

sharedSet

string

Output only. The shared set resource name of the portfolio bidding strategy where the target is defined. Only populated if the recommendation is portfolio level.

AppBiddingGoal

Represents the goal towards which the bidding strategy, of an app campaign, should optimize for.

Enums
UNSPECIFIED Не указан.
UNKNOWN Represents value unknown in this version of the API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME The bidding strategy of the app campaign should aim to maximize installation of the app.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME The bidding strategy of the app campaign should aim to maximize the selected in-app conversions' volume.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION The bidding strategy of the app campaign should aim to maximize just the selected in-app conversion's volume, while achieving or exceeding target cost per in-app conversion.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions while achieving or exceeding target return on advertising spend.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI This bidding strategy of the app campaign should aim to maximize installation of the app without advertiser-provided target cost-per-install.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME This bidding strategy of the app campaign should aim to maximize pre-registration of the app.

LowerTargetRoasRecommendation

Recommendation to lower Target ROAS.

JSON representation
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Поля
targetAdjustment

object ( TargetAdjustmentInfo )

Output only. The relevant information describing the recommended target adjustment.

PerformanceMaxOptInRecommendation

This type has no fields.

The Performance Max Opt In recommendation.

ImprovePerformanceMaxAdStrengthRecommendation

Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating.

JSON representation
{
  "assetGroup": string
}
Поля
assetGroup

string

Output only. The asset group resource name.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

The Dynamic Search Ads to Performance Max migration recommendation.

JSON representation
{
  "applyLink": string
}
Поля

SearchTermView

A search term view with metrics aggregated by search term at the ad group level.

JSON representation
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
Поля
resourceName

string

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

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}

status

enum ( SearchTermTargetingStatus )

Output only. Indicates whether the search term is currently one of your targeted or excluded keywords.

searchTerm

string

Output only. The search term.

adGroup

string

Output only. The ad group the search term served in.

SearchTermTargetingStatus

Indicates whether the search term is one of your targeted or excluded keywords.

Enums
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ADDED Search term is added to targeted keywords.
EXCLUDED Search term matches a negative keyword.
ADDED_EXCLUDED Search term has been both added and excluded.
NONE Search term is neither targeted nor excluded.

ShoppingPerformanceView

Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

A Smart campaign search term view.

JSON representation
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
Поля
resourceName

string

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

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}

searchTerm

string

Output only. The search term.

campaign

string

Output only. The Smart campaign the search term served in.

TopicView

A topic view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

Output only. The resource name of the topic view. Topic view resource names have the form:

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

TravelActivityGroupView

A travel activity group view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

Output only. The resource name of the travel activity group view. Travel Activity Group view resource names have the form:

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

TravelActivityPerformanceView

A travel activity performance view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

Output only. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form:

customers/{customerId}/travelActivityPerformanceView

UserInterest

A user interest: a particular interest-based vertical to be targeted.

JSON representation
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
Поля
resourceName

string

Output only. The resource name of the user interest. User interest resource names have the form:

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum ( UserInterestTaxonomyType )

Output only. Taxonomy type of the user interest.

availabilities[]

object ( CriterionCategoryAvailability )

Output only. Availability information of the user interest.

userInterestId

string ( int64 format)

Output only. The ID of the user interest.

name

string

Output only. The name of the user interest.

userInterestParent

string

Output only. The parent of the user interest.

launchedToAll

boolean

Output only. True if the user interest is launched to all channels and locales.

UserInterestTaxonomyType

Enum containing the possible UserInterestTaxonomyTypes.

Enums
UNSPECIFIED Не указан.
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.

Случай из жизни

A life event: a particular interest-based vertical to be targeted to reach users when they are in the midst of important life milestones.

JSON representation
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Поля
resourceName

string

Output only. The resource name of the life event. Life event resource names have the form:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string ( int64 format)

Output only. The ID of the life event.

name

string

Output only. The name of the life event, for example,"Recently Moved"

parent

string

Output only. The parent of the lifeEvent.

launchedToAll

boolean

Output only. True if the life event is launched to all channels and locales.

availabilities[]

object ( CriterionCategoryAvailability )

Output only. Availability information of the life event.

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

JSON representation
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Поля
resourceName

string

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

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string ( int64 format)

Output only. Criterion Id for the country.

targetingLocation

boolean

Output only. Indicates whether location was targeted or not.

TopicConstant

Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").

JSON representation
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
Поля
resourceName

string

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

topicConstants/{topic_id}

path[]

string

Output only. The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, {"Pets & Animals", "Pets", "Dogs"} represents the "Pets & Animals/Pets/Dogs" category. List of available topic categories at https://developers.google.com/google-ads/api/reference/data/verticals

id

string ( int64 format)

Output only. The ID of the topic.

topicConstantParent

string

Output only. Resource name of parent of the topic constant.

видео

Видео.

JSON representation
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
Поля
resourceName

string

Output only. The resource name of the video. Video resource names have the form:

customers/{customerId}/videos/{videoId}

id

string

Output only. The ID of the video.

channelId

string

Output only. The owner channel id of the video.

durationMillis

string ( int64 format)

Output only. The duration of the video in milliseconds.

title

string

Output only. The title of the video.

WebpageView

A webpage view.

JSON representation
{
  "resourceName": string
}
Поля
resourceName

string

Output only. The resource name of the webpage view. Webpage view resource names have the form:

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

LeadFormSubmissionData

Data from lead form submissions.

JSON representation
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
Поля
resourceName

string

Output only. The resource name of the lead form submission data. Lead form submission data resource names have the form:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

Output only. ID of this lead form submission.

asset

string

Output only. Asset associated with the submitted lead form.

campaign

string

Output only. Campaign associated with the submitted lead form.

leadFormSubmissionFields[]

object ( LeadFormSubmissionField )

Output only. Submission data associated with a lead form.

customLeadFormSubmissionFields[]

object ( CustomLeadFormSubmissionField )

Output only. Submission data associated with a custom lead form.

adGroup

string

Output only. AdGroup associated with the submitted lead form.

adGroupAd

string

Output only. AdGroupAd associated with the submitted lead form.

gclid

string

Output only. Google Click Id associated with the submissed lead form.

submissionDateTime

string

Output only. The date and time at which the lead form was submitted. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", for example, "2019-01-01 12:32:45-08:00".

LeadFormSubmissionField

Fields in the submitted lead form.

JSON representation
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
Поля
fieldType

enum ( LeadFormFieldUserInputType )

Output only. Field type for lead form fields.

fieldValue

string

Output only. Field value for lead form fields.

CustomLeadFormSubmissionField

Fields in the submitted custom question

JSON representation
{
  "questionText": string,
  "fieldValue": string
}
Поля
questionText

string

Output only. Question text for custom question, maximum number of characters is 300.

fieldValue

string

Output only. Field value for custom question response, maximum number of characters is 70.

Метрики

Metrics data.

JSON representation
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number
}
Поля
allConversionsValueByConversionDate

number

The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 .

allConversionsByConversionDate

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 .

conversionsValueByConversionDate

number

The value of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 .

conversionsByConversionDate

number

The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 .

historicalCreativeQualityScore

enum ( QualityScoreBucket )

The creative historical quality score.

historicalLandingPageQualityScore

enum ( QualityScoreBucket )

The quality of historical landing page experience.

historicalSearchPredictedCtr

enum ( QualityScoreBucket )

The historical search predicted click through rate (CTR).

interactionEventTypes[]

enum ( InteractionEventType )

The types of payable and free interactions.

skAdNetworkConversions

string ( int64 format)

The number of iOS Store Kit Ad Network conversions.

publisherPurchasedClicks

string ( int64 format)

Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity

publisherOrganicClicks

string ( int64 format)

Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity

publisherUnknownClicks

string ( int64 format)

Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic"

absoluteTopImpressionPercentage

number

Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.

activeViewCpm

number

Average cost of viewable impressions ( activeViewImpressions ).

activeViewCtr

number

Active view measurable clicks divided by active view viewable impressions.

This metric is reported only for the Display Network.

activeViewImpressions

string ( int64 format)

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

activeViewMeasurability

number

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

activeViewMeasurableCostMicros

string ( int64 format)

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

activeViewMeasurableImpressions

string ( int64 format)

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

activeViewViewability

number

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

allConversionsFromInteractionsRate

number

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

allConversionsValue

number

The value of all conversions.

allNewCustomerLifetimeValue

number

All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "allConversionsValue". See https://support.google.com/google-ads/answer/12080169 for more details.

allConversions

number

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

allConversionsValuePerCost

number

The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).

allConversionsFromClickToCall

number

The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls.

This metric applies to feed items only.

allConversionsFromDirections

number

The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad.

This metric applies to feed items only.

allConversionsFromInteractionsValuePerInteraction

number

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

allConversionsFromMenu

number

The number of times people clicked a link to view a store's menu after clicking an ad.

This metric applies to feed items only.

allConversionsFromOrder

number

The number of times people placed an order at a store after clicking an ad.

This metric applies to feed items only.

allConversionsFromOtherEngagement

number

The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad.

This metric applies to feed items only.

allConversionsFromStoreVisit

number

Estimated number of times people visited a store after clicking an ad.

This metric applies to feed items only.

allConversionsFromStoreWebsite

number

The number of times that people were taken to a store's URL after clicking an ad.

This metric applies to feed items only.

auctionInsightSearchAbsoluteTopImpressionPercentage

number

This metric is part of the Auction Insights report, and tells how often the ads of another participant showed in the most prominent position on the search results page. This percentage is computed only over the auctions that you appeared in the page.

This metric is not publicly available.

auctionInsightSearchImpressionShare

number

This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999.

This metric is not publicly available.

auctionInsightSearchOutrankingShare

number

This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999.

This metric is not publicly available.

auctionInsightSearchOverlapRate

number

This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression.

This metric is not publicly available.

auctionInsightSearchPositionAboveRate

number

This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page.

This metric is not publicly available.

auctionInsightSearchTopImpressionPercentage

number

This metric is part of the Auction Insights report, and tells how often the ads of another participant showed adjacent to the top organic search results. This percentage is computed only over the auctions that you appeared in the page.

This metric is not publicly available.

averageCost

number

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

averageCpc

number

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

averageCpe

number

The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.

averageCpm

number

Average cost-per-thousand impressions (CPM).

averageCpv

number

The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.

averagePageViews

number

Average number of pages viewed per session.

averageTimeOnSite

number

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

benchmarkAverageMaxCpc

number

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

biddableAppInstallConversions

number

Number of app installs.

biddableAppPostInstallConversions

number

Number of in-app actions.

benchmarkCtr

number

An indication on how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad click on it.

bounceRate

number

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

clicks

string ( int64 format)

The number of clicks.

combinedClicks

string ( int64 format)

The number of times your ad or your site's listing in the unpaid results was clicked. See the help page at https://support.google.com/google-ads/answer/3097241 for details.

combinedClicksPerQuery

number

The number of times your ad or your site's listing in the unpaid results was clicked (combinedClicks) divided by combinedQueries. See the help page at https://support.google.com/google-ads/answer/3097241 for details.

combinedQueries

string ( int64 format)

The number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See the help page at https://support.google.com/google-ads/answer/3097241 for details.

contentBudgetLostImpressionShare

number

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

contentImpressionShare

number

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

conversionLastReceivedRequestDateTime

string

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

conversionLastConversionDate

string

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

contentRankLostImpressionShare

number

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

conversionsFromInteractionsRate

number

Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

conversionsValue

number

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

newCustomerLifetimeValue

number

New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversionsValue" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details.

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

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

conversions

number

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

costMicros

string ( int64 format)

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

costPerAllConversions

number

The cost of ad interactions divided by all conversions.

costPerConversion

number

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

costPerCurrentModelAttributedConversion

number

The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

crossDeviceConversions

number

Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in allConversions.

ctr

number

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

currentModelAttributedConversions

number

Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

currentModelAttributedConversionsFromInteractionsRate

number

Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

currentModelAttributedConversionsValue

number

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

currentModelAttributedConversionsValuePerCost

number

The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

engagementRate

number

How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.

engagements

string ( int64 format)

The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.

hotelAverageLeadValueMicros

number

Average lead value based on clicks.

hotelCommissionRateMicros

string ( int64 format)

Commission bid rate in micros. A 20% commission is represented as 200,000.

hotelExpectedCommissionCost

number

Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency.

hotelPriceDifferencePercentage

number

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

hotelEligibleImpressions

string ( int64 format)

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

historicalQualityScore

string ( int64 format)

The historical quality score.

gmailForwards

string ( int64 format)

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

gmailSaves

string ( int64 format)

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

gmailSecondaryClicks

string ( int64 format)

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

impressionsFromStoreReach

string ( int64 format)

The number of times a store's location-based ad was shown.

This metric applies to feed items only.

impressions

string ( int64 format)

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

interactionRate

number

How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.

interactions

string ( int64 format)

The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.

invalidClickRate

number

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

invalidClicks

string ( int64 format)

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

messageChats

string ( int64 format)

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

messageImpressions

string ( int64 format)

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

messageChatRate

number

Number of message chats initiated (messageChats) divided by the number of message impressions (messageImpressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression.

mobileFriendlyClicksPercentage

number

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

optimizationScoreUplift

number

Total optimization score uplift of all recommendations.

optimizationScoreUrl

string

URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign , and can be segmented by segments.recommendation_type . For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendationType) combination.

organicClicks

string ( int64 format)

The number of times someone clicked your site's listing in the unpaid results for a particular query. See the help page at https://support.google.com/google-ads/answer/3097241 for details.

organicClicksPerQuery

number

The number of times someone clicked your site's listing in the unpaid results (organicClicks) divided by the total number of searches that returned pages from your site (organicQueries). See the help page at https://support.google.com/google-ads/answer/3097241 for details.

organicImpressions

string ( int64 format)

The number of listings for your site in the unpaid search results. See the help page at https://support.google.com/google-ads/answer/3097241 for details.

organicImpressionsPerQuery

number

The number of times a page from your site was listed in the unpaid search results (organicImpressions) divided by the number of searches returning your site's listing in the unpaid results (organicQueries). See the help page at https://support.google.com/google-ads/answer/3097241 for details.

organicQueries

string ( int64 format)

The total number of searches that returned your site's listing in the unpaid results. See the help page at https://support.google.com/google-ads/answer/3097241 for details.

percentNewVisitors

number

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

phoneCalls

string ( int64 format)

Number of offline phone calls.

phoneImpressions

string ( int64 format)

Number of offline phone impressions.

phoneThroughRate

number

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

relativeCtr

number

Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites.

searchAbsoluteTopImpressionShare

number

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

searchBudgetLostAbsoluteTopImpressionShare

number

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

searchBudgetLostImpressionShare

number

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

searchBudgetLostTopImpressionShare

number

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

searchClickShare

number

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

searchExactMatchImpressionShare

number

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

searchImpressionShare

number

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

searchRankLostAbsoluteTopImpressionShare

number

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

searchRankLostImpressionShare

number

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

searchRankLostTopImpressionShare

number

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

searchTopImpressionShare

number

The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

Top ads are generally above the top organic results, although they may show below the top organic results on certain queries.

searchVolume

object ( SearchVolumeRange )

Search volume range for a search term insight category.

speedScore

string ( int64 format)

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

averageTargetCpaMicros

string ( int64 format)

The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA).

averageTargetRoas

number

The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS).

topImpressionPercentage

number

The percent of your ad impressions that are shown adjacent to the top organic search results.

validAcceleratedMobilePagesClicksPercentage

number

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

valuePerAllConversions

number

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

valuePerAllConversionsByConversionDate

number

The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 .

valuePerConversion

number

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

valuePerConversionsByConversionDate

number

The value of conversions divided by the number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009 .

valuePerCurrentModelAttributedConversion

number

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

videoQuartileP100Rate

number

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

videoQuartileP25Rate

number

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

videoQuartileP50Rate

number

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

videoQuartileP75Rate

number

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

videoViewRate

number

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

videoViews

string ( int64 format)

The number of times your video ads were viewed.

viewThroughConversions

string ( int64 format)

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

allConversionsFromLocationAssetClickToCall

number

Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.

allConversionsFromLocationAssetDirections

number

Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.

allConversionsFromLocationAssetMenu

number

Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.

allConversionsFromLocationAssetOrder

number

Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.

allConversionsFromLocationAssetOtherEngagement

number

Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.

allConversionsFromLocationAssetStoreVisits

number

Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location.

allConversionsFromLocationAssetWebsite

number

Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.

eligibleImpressionsFromLocationAssetStoreReach

string ( int64 format)

Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetClickToCall

number

Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetDirections

number

Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetMenu

number

Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetOrder

number

Number of order clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetOtherEngagement

number

Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetStoreVisits

number

Estimated number of visits to the store after an impression. This measure is coming from Asset based location.

viewThroughConversionsFromLocationAssetWebsite

number

Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location.

InteractionEventType

Enum describing possible types of payable and free interactions.

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

SearchVolumeRange

Search volume range. Actual search volume falls within this range.

JSON representation
{
  "min": string,
  "max": string
}
Поля
min

string ( int64 format)

Lower bound of search volume.

max

string ( int64 format)

Upper bound of search volume.

Сегменты

Segment only fields.

JSON representation
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Поля
adDestinationType

enum ( AdDestinationType )

Ad Destination type.

adNetworkType

enum ( AdNetworkType )

Ad network type.

budgetCampaignAssociationStatus

object ( BudgetCampaignAssociationStatus )

Budget campaign association status.

clickType

enum ( ClickType )

Click type.

conversionActionCategory

enum ( ConversionActionCategory )

Conversion action category.

conversionAttributionEventType

enum ( ConversionAttributionEventType )

Conversion attribution event type.

conversionLagBucket

enum ( ConversionLagBucket )

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

conversionOrAdjustmentLagBucket

enum ( ConversionOrAdjustmentLagBucket )

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

dayOfWeek

enum ( DayOfWeek )

Day of the week, for example, MONDAY.

device

enum ( Device )

Device to which metrics apply.

externalConversionSource

enum ( ExternalConversionSource )

External conversion source.

hotelCheckInDayOfWeek

enum ( DayOfWeek )

Hotel check-in day of week.

hotelDateSelectionType

enum ( HotelDateSelectionType )

Hotel date selection type.

hotelRateType

enum ( HotelRateType )

Hotel rate type.

hotelPriceBucket

enum ( HotelPriceBucket )

Hotel price bucket.

keyword

object ( Keyword )

Keyword criterion.

monthOfYear

enum ( MonthOfYear )

Month of the year, for example, January.

placeholderType

enum ( PlaceholderType )

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

productChannel

enum ( ProductChannel )

Channel of the product.

productChannelExclusivity

enum ( ProductChannelExclusivity )

Channel exclusivity of the product.

productCondition

enum ( ProductCondition )

Condition of the product.

recommendationType

enum ( RecommendationType )

Recommendation type.

searchEngineResultsPageType

enum ( SearchEngineResultsPageType )

Type of the search engine results page.

searchTermMatchType

enum ( SearchTermMatchType )

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

slot

enum ( Slot )

Position of the ad.

conversionValueRulePrimaryDimension

enum ( ConversionValueRulePrimaryDimension )

Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied.

skAdNetworkUserType

enum ( SkAdNetworkUserType )

iOS Store Kit Ad Network user type.

skAdNetworkAdEventType

enum ( SkAdNetworkAdEventType )

iOS Store Kit Ad Network ad event type.

skAdNetworkAttributionCredit

enum ( SkAdNetworkAttributionCredit )

iOS Store Kit Ad Network attribution credit

newVersusReturningCustomers

enum ( ConvertingUserPriorEngagementTypeAndLtvBucket )

This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal.

activityAccountId

string ( int64 format)

Activity account ID.

activityRating

string ( int64 format)

Activity rating.

externalActivityId

string

Advertiser supplied activity ID.

adGroup

string

Resource name of the ad group.

assetGroup

string

Resource name of the asset group.

auctionInsightDomain

string

Domain (visible URL) of a participant in the Auction Insights report.

campaign

string

Resource name of the campaign.

conversionAction

string

Resource name of the conversion action.

conversionActionName

string

Conversion action name.

conversionAdjustment

boolean

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

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

geoTargetAirport

string

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

geoTargetCanton

string

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

geoTargetCity

string

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

geoTargetCountry

string

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

geoTargetCounty

string

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

geoTargetDistrict

string

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

geoTargetMetro

string

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

geoTargetMostSpecificLocation

string

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

geoTargetPostalCode

string

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

geoTargetProvince

string

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

geoTargetRegion

string

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

geoTargetState

string

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

hotelBookingWindowDays

string ( int64 format)

Hotel booking window in days.

hotelCenterId

string ( int64 format)

Hotel center ID.

hotelCheckInDate

string

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

hotelCity

string

Hotel city.

hotelClass

integer

Hotel class.

hotelCountry

string

Hotel country.

hotelLengthOfStay

integer

Hotel length of stay.

hotelRateRuleId

string

Hotel rate rule ID.

hotelState

string

Hotel state.

hour

integer

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

interactionOnThisExtension

boolean

Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.

month

string

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

partnerHotelId

string

Partner hotel ID.

productAggregatorId

string ( int64 format)

Aggregator ID of the product.

productBiddingCategoryLevel1

string

Bidding category (level 1) of the product.

productBiddingCategoryLevel2

string

Bidding category (level 2) of the product.

productBiddingCategoryLevel3

string

Bidding category (level 3) of the product.

productBiddingCategoryLevel4

string

Bidding category (level 4) of the product.

productBiddingCategoryLevel5

string

Bidding category (level 5) of the product.

productBrand

string

Brand of the product.

productCountry

string

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

productCustomAttribute0

string

Custom attribute 0 of the product.

productCustomAttribute1

string

Custom attribute 1 of the product.

productCustomAttribute2

string

Custom attribute 2 of the product.

productCustomAttribute3

string

Custom attribute 3 of the product.

productCustomAttribute4

string

Custom attribute 4 of the product.

productFeedLabel

string

Feed label of the product.

productItemId

string

Item ID of the product.

productLanguage

string

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

productMerchantId

string ( int64 format)

Merchant ID of the product.

productStoreId

string

Store ID of the product.

productTitle

string

Title of the product.

productTypeL1

string

Type (level 1) of the product.

productTypeL2

string

Type (level 2) of the product.

productTypeL3

string

Type (level 3) of the product.

productTypeL4

string

Type (level 4) of the product.

productTypeL5

string

Type (level 5) of the product.

quarter

string

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

searchSubcategory

string

A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory.

searchTerm

string

A search term.

webpage

string

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

week

string

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

year

integer

Year, formatted as yyyy.

skAdNetworkConversionValue

string ( int64 format)

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

skAdNetworkSourceApp

object ( SkAdNetworkSourceApp )

App where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple.

assetInteractionTarget

object ( AssetInteractionTarget )

Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interactionOnThisAsset is true, it means the interactions are on this specific asset and when interactionOnThisAsset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with.

AdDestinationType

Enumerates Google Ads destination types

Enums
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
NOT_APPLICABLE Ads that don't intend to drive users off from ads to other destinations
WEBSITE Веб-сайт
APP_STORE iOS App Store or Play Store
PHONE_CALL Call Dialer
MAP_DIRECTIONS Map App
LOCATION_LISTING Location Dedicated Page
MESSAGE Текстовое сообщение
LEAD_FORM Lead Generation Form
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS Ad Destination for Conversions with keys unknown

AdNetworkType

Enumerates Google Ads network types.

Enums
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
SEARCH Поиск Гугл.
SEARCH_PARTNERS Search partners.
CONTENT Display Network.
YOUTUBE_WATCH YouTube видео
MIXED Cross-network.

BudgetCampaignAssociationStatus

A BudgetCampaignAssociationStatus segment.

JSON representation
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
Поля
status

enum ( BudgetCampaignAssociationStatus )

Budget campaign association status.

campaign

string

The campaign resource name.

BudgetCampaignAssociationStatus

Possible statuses of the association between the Budget and the Campaign.

Enums
UNSPECIFIED Не указан.
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 Не указан.
UNKNOWN The value is unknown in this version.
BREADCRUMBS Панировочные сухари.
BROADBAND_PLAN Broadband Plan.
CALL_TRACKING Manually dialed phone calls.
CALLS Телефонные звонки.
CLICK_ON_ENGAGEMENT_AD Click on engagement ad.
GET_DIRECTIONS Driving direction.
LOCATION_EXPANSION Get location details.
LOCATION_FORMAT_CALL Вызов.
LOCATION_FORMAT_DIRECTIONS Направления.
LOCATION_FORMAT_IMAGE Изображений).
LOCATION_FORMAT_LANDING_PAGE Go to landing page.
LOCATION_FORMAT_MAP Карта.
LOCATION_FORMAT_STORE_INFO Go to store info.
LOCATION_FORMAT_TEXT Текст.
MOBILE_CALL_TRACKING Mobile phone calls.
OFFER_PRINTS Print offer.
OTHER Другой.
PRODUCT_EXTENSION_CLICKS Product plusbox offer.
PRODUCT_LISTING_AD_CLICKS Shopping - Product - Online.
STORE_LOCATOR Show nearby locations.
URL_CLICKS Заголовок.
VIDEO_APP_STORE_CLICKS Магазин приложений.
VIDEO_CALL_TO_ACTION_CLICKS Call-to-Action overlay.
VIDEO_CARD_ACTION_HEADLINE_CLICKS Карты.
VIDEO_END_CAP_CLICKS Торцевая крышка.
VIDEO_WEBSITE_CLICKS Веб-сайт.
WIRELESS_PLAN Wireless Plan.
PRODUCT_LISTING_AD_LOCAL Shopping - Product - Local.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL Shopping - Product - MultiChannel Local.
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE Shopping - Product - MultiChannel Online.
PRODUCT_LISTING_ADS_COUPON Shopping - Product - Coupon.
PRODUCT_LISTING_AD_TRANSACTABLE Shopping - Product - Sell on Google.
PROMOTION_EXTENSION Promotion Extension.
HOTEL_PRICE Hotel price.
PRICE_EXTENSION Price Extension.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Book on Google hotel room selection.
SHOPPING_COMPARISON_LISTING Shopping - Comparison Listing.
CROSS_NETWORK Cross-network. From Performance Max and Discovery Campaigns.

ConversionAttributionEventType

The event type of conversions that are attributed to.

Enums
UNSPECIFIED Не указан.
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 Не указан.
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 Не указан.
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 Не указан.
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 Не указан.
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 Не указан.
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 representation
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Поля
info

object ( KeywordInfo )

Keyword info.

adGroupCriterion

string

The AdGroupCriterion resource name.

SearchEngineResultsPageType

The type of the search engine results page.

Enums
UNSPECIFIED Не указан.
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 Не указан.
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 Не указан.
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 Не указан.
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 Не указан.
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 Не указан.
UNKNOWN The value is unknown in this version.
UNAVAILABLE The value was not present in the postback or we do not have this data for other reasons.
INTERACTION The user interacted with the ad.
VIEW The user viewed the ad.

SkAdNetworkSourceApp

A SkAdNetworkSourceApp segment.

JSON representation
{
  "skAdNetworkSourceAppId": string
}
Поля
skAdNetworkSourceAppId

string

App id where the ad that drove the iOS Store Kit Ad Network install was shown.

SkAdNetworkAttributionCredit

Enumerates SkAdNetwork attribution credits.

Enums
UNSPECIFIED Значение по умолчанию. This value is equivalent to null.
UNKNOWN The value is unknown in this API version. The true enum value cannot be returned in this API version or is not supported yet.
UNAVAILABLE The value was not present in the postback or we do not have this data for other reasons.
WON Google was the ad network that won ad attribution.
CONTRIBUTED Google qualified for attribution, but didn't win.

AssetInteractionTarget

An AssetInteractionTarget segment.

JSON representation
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Поля
asset

string

The asset resource name.

interactionOnThisAsset

boolean

Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.

ConvertingUserPriorEngagementTypeAndLtvBucket

Enumerates converting user prior engagement types and lifetime-value bucket

Enums
UNSPECIFIED Не указан.
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.