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)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "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)
  },
  "campaignLifecycleGoal": {
    object (CampaignLifecycleGoal)
  },
  "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)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "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)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productCategoryConstant": {
    object (ProductCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "productLinkInvitation": {
    object (ProductLinkInvitation)
  },
  "recommendation": {
    object (Recommendation)
  },
  "recommendationSubscription": {
    object (RecommendationSubscription)
  },
  "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)
  },
  "localServicesLead": {
    object (LocalServicesLead)
  },
  "localServicesLeadConversation": {
    object (LocalServicesLeadConversation)
  },
  "androidPrivacySharedKeyGoogleAdGroup": {
    object (AndroidPrivacySharedKeyGoogleAdGroup)
  },
  "androidPrivacySharedKeyGoogleCampaign": {
    object (AndroidPrivacySharedKeyGoogleCampaign)
  },
  "androidPrivacySharedKeyGoogleNetworkType": {
    object (AndroidPrivacySharedKeyGoogleNetworkType)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
Поля
account Budget

object ( AccountBudget )

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

account Budget Proposal

object ( AccountBudgetProposal )

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

ad Group

object ( AdGroup )

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

ad Group Ad

object ( AdGroupAd )

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

ad Group Ad Asset Combination View

object ( AdGroupAdAssetCombinationView )

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

ad Group Ad Asset View

object ( AdGroupAdAssetView )

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

ad Group Ad Label

object ( AdGroupAdLabel )

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

ad Group Asset

object ( AdGroupAsset )

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

ad Group Asset Set

object ( AdGroupAssetSet )

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

ad Group Audience View

object ( AdGroupAudienceView )

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

ad Group Bid Modifier

object ( AdGroupBidModifier )

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

ad Group Criterion

object ( AdGroupCriterion )

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

ad Group Criterion Customizer

object ( AdGroupCriterionCustomizer )

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

ad Group Criterion Label

object ( AdGroupCriterionLabel )

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

ad Group Criterion Simulation

object ( AdGroupCriterionSimulation )

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

ad Group Customizer

object ( AdGroupCustomizer )

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

ad Group Extension Setting

object ( AdGroupExtensionSetting )

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

ad Group Feed

object ( AdGroupFeed )

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

ad Group Label

object ( AdGroupLabel )

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

ad Group Simulation

object ( AdGroupSimulation )

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

ad Parameter

object ( AdParameter )

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

age Range View

object ( AgeRangeView )

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

ad Schedule View

object ( AdScheduleView )

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

domain Category

object ( DomainCategory )

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

asset

object ( Asset )

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

asset Field Type View

object ( AssetFieldTypeView )

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

asset Group Asset

object ( AssetGroupAsset )

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

asset Group Signal

object ( AssetGroupSignal )

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

asset Group Listing Group Filter

object ( AssetGroupListingGroupFilter )

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

asset Group Product Group View

object ( AssetGroupProductGroupView )

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

asset Group Top Combination View

object ( AssetGroupTopCombinationView )

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

asset Group

object ( AssetGroup )

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

asset Set Asset

object ( AssetSetAsset )

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

asset Set

object ( AssetSet )

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

asset Set Type View

object ( AssetSetTypeView )

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

batch Job

object ( BatchJob )

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

bidding Data Exclusion

object ( BiddingDataExclusion )

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

bidding Seasonality Adjustment

object ( BiddingSeasonalityAdjustment )

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

bidding Strategy

object ( BiddingStrategy )

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

bidding Strategy Simulation

object ( BiddingStrategySimulation )

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

billing Setup

object ( BillingSetup )

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

call View

object ( CallView )

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

campaign Budget

object ( CampaignBudget )

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

campaign

object ( Campaign )

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

campaign Asset

object ( CampaignAsset )

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

campaign Asset Set

object ( CampaignAssetSet )

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

campaign Audience View

object ( CampaignAudienceView )

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

campaign Bid Modifier

object ( CampaignBidModifier )

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

campaign Conversion Goal

object ( CampaignConversionGoal )

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

campaign Criterion

object ( CampaignCriterion )

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

campaign Customizer

object ( CampaignCustomizer )

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

campaign Draft

object ( CampaignDraft )

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

campaign Extension Setting

object ( CampaignExtensionSetting )

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

campaign Feed

object ( CampaignFeed )

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

campaign Group

object ( CampaignGroup )

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

campaign Label

object ( CampaignLabel )

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

campaign Lifecycle Goal

object ( CampaignLifecycleGoal )

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

campaign Search Term Insight

object ( CampaignSearchTermInsight )

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

campaign Shared Set

object ( CampaignSharedSet )

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

campaign Simulation

object ( CampaignSimulation )

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

carrier Constant

object ( CarrierConstant )

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

change Event

object ( ChangeEvent )

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

change Status

object ( ChangeStatus )

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

combined Audience

object ( CombinedAudience )

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

audience

object ( Audience )

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

conversion Action

object ( ConversionAction )

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

conversion Custom Variable

object ( ConversionCustomVariable )

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

conversion Goal Campaign Config

object ( ConversionGoalCampaignConfig )

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

conversion Value Rule

object ( ConversionValueRule )

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

conversion Value Rule Set

object ( ConversionValueRuleSet )

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

click View

object ( ClickView )

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

currency Constant

object ( CurrencyConstant )

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

custom Audience

object ( CustomAudience )

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

custom Conversion Goal

object ( CustomConversionGoal )

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

custom Interest

object ( CustomInterest )

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

customer

object ( Customer )

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

customer Asset

object ( CustomerAsset )

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

customer Asset Set

object ( CustomerAssetSet )

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

accessible Bidding Strategy

object ( AccessibleBiddingStrategy )

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

customer Customizer

object ( CustomerCustomizer )

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

customer Client

object ( CustomerClient )

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

customer Conversion Goal

object ( CustomerConversionGoal )

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

customer Extension Setting

object ( CustomerExtensionSetting )

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

customer Feed

object ( CustomerFeed )

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

customer Label

object ( CustomerLabel )

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

customer Lifecycle Goal

object ( CustomerLifecycleGoal )

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

customer Negative Criterion

object ( CustomerNegativeCriterion )

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

customer Search Term Insight

object ( CustomerSearchTermInsight )

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

customer User Access

object ( CustomerUserAccess )

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

customer User Access Invitation

object ( CustomerUserAccessInvitation )

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

customizer Attribute

object ( CustomizerAttribute )

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

detail Placement View

object ( DetailPlacementView )

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

detailed Demographic

object ( DetailedDemographic )

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

display Keyword View

object ( DisplayKeywordView )

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

distance View

object ( DistanceView )

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

dynamic Search Ads Search Term View

object ( DynamicSearchAdsSearchTermView )

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

expanded Landing Page View

object ( ExpandedLandingPageView )

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

extension Feed Item

object ( ExtensionFeedItem )

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

feed

object ( Feed )

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

feed Item

object ( FeedItem )

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

feed Item Set

object ( FeedItemSet )

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

feed Item Target

object ( FeedItemTarget )

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

feed Mapping

object ( FeedMapping )

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

feed Placeholder View

object ( FeedPlaceholderView )

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

gender View

object ( GenderView )

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

geo Target Constant

object ( GeoTargetConstant )

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

geographic View

object ( GeographicView )

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

group Placement View

object ( GroupPlacementView )

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

hotel Group View

object ( HotelGroupView )

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

hotel Performance View

object ( HotelPerformanceView )

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

hotel Reconciliation

object ( HotelReconciliation )

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

income Range View

object ( IncomeRangeView )

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

keyword View

object ( KeywordView )

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

keyword Plan

object ( KeywordPlan )

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

keyword Plan Campaign

object ( KeywordPlanCampaign )

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

keyword Plan Campaign Keyword

object ( KeywordPlanCampaignKeyword )

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

keyword Plan Ad Group

object ( KeywordPlanAdGroup )

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

keyword Plan Ad Group Keyword

object ( KeywordPlanAdGroupKeyword )

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

keyword Theme Constant

object ( KeywordThemeConstant )

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

label

object ( Label )

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

landing Page View

object ( LandingPageView )

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

language Constant

object ( LanguageConstant )

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

location View

object ( LocationView )

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

managed Placement View

object ( ManagedPlacementView )

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

media File

object ( MediaFile )

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

local Services Employee

object ( LocalServicesEmployee )

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

local Services Verification Artifact

object ( LocalServicesVerificationArtifact )

Артефакт проверки локальных служб, указанный в запросе.

mobile App Category Constant

object ( MobileAppCategoryConstant )

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

mobile Device Constant

object ( MobileDeviceConstant )

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

offline Conversion Upload Client Summary

object ( OfflineConversionUploadClientSummary )

Сводная информация о загрузке офлайн-конверсий на уровне клиента.

offline User Data Job

object ( OfflineUserDataJob )

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

operating System Version Constant

object ( OperatingSystemVersionConstant )

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

paid Organic Search Term View

object ( PaidOrganicSearchTermView )

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

qualifying Question

object ( QualifyingQuestion )

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

parental Status View

object ( ParentalStatusView )

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

per Store View

object ( PerStoreView )

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

product Category Constant

object ( ProductCategoryConstant )

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

product Group View

object ( ProductGroupView )

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

recommendation

object ( Recommendation )

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

recommendation Subscription

object ( RecommendationSubscription )

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

search Term View

object ( SearchTermView )

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

shared Criterion

object ( SharedCriterion )

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

shared Set

object ( SharedSet )

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

smart Campaign Setting

object ( SmartCampaignSetting )

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

shopping Performance View

object ( ShoppingPerformanceView )

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

smart Campaign Search Term View

object ( SmartCampaignSearchTermView )

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

topic View

object ( TopicView )

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

travel Activity Group View

object ( TravelActivityGroupView )

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

travel Activity Performance View

object ( TravelActivityPerformanceView )

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

experiment

object ( Experiment )

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

experiment Arm

object ( ExperimentArm )

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

user Interest

object ( UserInterest )

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

life Event

object ( LifeEvent )

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

user List

object ( UserList )

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

user Location View

object ( UserLocationView )

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

remarketing Action

object ( RemarketingAction )

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

topic Constant

object ( TopicConstant )

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

video

object ( Video )

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

webpage View

object ( WebpageView )

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

lead Form Submission Data

object ( LeadFormSubmissionData )

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

local Services Lead

object ( LocalServicesLead )

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

local Services Lead Conversation

object ( LocalServicesLeadConversation )

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

android Privacy Shared Key Google Ad Group

object ( AndroidPrivacySharedKeyGoogleAdGroup )

Группа объявлений Google с общим ключом конфиденциальности Android, указанная в запросе.

android Privacy Shared Key Google Campaign

object ( AndroidPrivacySharedKeyGoogleCampaign )

Кампания Google с общим ключом конфиденциальности Android, упомянутая в запросе.

android Privacy Shared Key Google Network Type

object ( AndroidPrivacySharedKeyGoogleNetworkType )

Тип сети Google общего ключа конфиденциальности Android, указанный в запросе.

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.
}
Поля
resource Name

string

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

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum ( AccountBudgetStatus )

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

total Adjustments Micros

string ( int64 format)

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

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

amount Served Micros

string ( int64 format)

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

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

pending Proposal

object ( PendingAccountBudgetProposal )

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

id

string ( int64 format)

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

billing Setup

string

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

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

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

proposed Start Date Time

string

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

approved Start Date Time

string

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

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

purchase Order Number

string

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

notes

string

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

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

string

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

proposed End Time Type

enum ( TimeType )

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

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

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

approved End Date Time

string

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

approved End Time Type

enum ( TimeType )

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

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

string ( int64 format)

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

proposed Spending Limit Type

enum ( SpendingLimitType )

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

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

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

approved Spending Limit Micros

string ( int64 format)

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

approved Spending Limit Type

enum ( SpendingLimitType )

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

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

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

adjusted Spending Limit Micros

string ( int64 format)

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

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

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

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

adjusted Spending Limit Type

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.
}
Поля
proposal Type

enum ( AccountBudgetProposalType )

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

account Budget Proposal

string

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

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

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

start Date Time

string

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

purchase Order Number

string

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

notes

string

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

creation Date Time

string

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

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

string

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

end Time Type

enum ( TimeType )

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

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

string ( int64 format)

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

spending Limit Type

enum ( SpendingLimitType )

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

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

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

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

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}

served Assets[]

object ( AssetUsage )

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

enabled

boolean

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

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

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

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

string

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

served Asset Field Type

enum ( ServedAssetFieldType )

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

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

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

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

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}

field Type

enum ( AssetFieldType )

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

policy Summary

object ( AdGroupAdAssetPolicySummary )

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

performance Label

enum ( AssetPerformanceLabel )

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

pinned Field

enum ( ServedAssetFieldType )

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

source

enum ( AssetSource )

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

ad Group Ad

string

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

asset

string

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

enabled

boolean

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

AdGroupAdAssetPolicySummary

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

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

object ( PolicyTopicEntry )

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

review Status

enum ( PolicyReviewStatus )

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

approval Status

enum ( PolicyApprovalStatus )

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

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

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

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

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.
}
Поля
resource Name

string

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

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

type

enum ( SimulationType )

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

modification Method

enum ( SimulationModificationMethod )

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

ad Group Id

string ( int64 format)

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

criterion Id

string ( int64 format)

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

start Date

string

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

end Date

string

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

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

object ( CpcBidSimulationPointList )

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

percent Cpc Bid Point List

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.

CpcBidSimulationPointList

Контейнер для точек моделирования для моделирования типа 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.
}
Поля
required Budget Amount Micros

string ( int64 format)

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

biddable Conversions

number

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

biddable Conversions Value

number

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

clicks

string ( int64 format)

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

cost Micros

string ( int64 format)

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

impressions

string ( int64 format)

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

top Slot Impressions

string ( int64 format)

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

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

string ( int64 format)

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

cpc Bid Scaling Modifier

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
}
Поля
percent Cpc Bid Micros

string ( int64 format)

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

biddable Conversions

number

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

biddable Conversions Value

number

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

clicks

string ( int64 format)

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

cost Micros

string ( int64 format)

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

impressions

string ( int64 format)

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

top Slot Impressions

string ( int64 format)

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

AdGroupСимуляторы

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

  1. ПОИСК – CPC_BID – ПО УМОЛЧАНИЮ
  2. ПОИСК – CPC_BID – UNIFORM
  3. ПОИСК – TARGET_CPA – UNIFORM
  4. ПОИСК – TARGET_ROAS – UNIFORM
  5. ДИСПЛЕЙ – 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.
}
Поля
resource Name

string

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

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

type

enum ( SimulationType )

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

modification Method

enum ( SimulationModificationMethod )

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

ad Group Id

string ( int64 format)

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

start Date

string

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

end Date

string

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

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

object ( CpcBidSimulationPointList )

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

cpv Bid Point List

object ( CpvBidSimulationPointList )

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

target Cpa Point List

object ( TargetCpaSimulationPointList )

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

target Roas Point List

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
}
Поля
cpv Bid Micros

string ( int64 format)

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

cost Micros

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,
  "interactions": 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.
}
Поля
required Budget Amount Micros

string ( int64 format)

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

app Installs

number

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

in App Actions

number

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

biddable Conversions

number

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

biddable Conversions Value

number

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

clicks

string ( int64 format)

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

cost Micros

string ( int64 format)

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

impressions

string ( int64 format)

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

top Slot Impressions

string ( int64 format)

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

interactions

string ( int64 format)

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

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

string ( int64 format)

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

target Cpa Scaling Modifier

number

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

TargetRoasSimulationPointList

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

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

object ( TargetRoasSimulationPoint )

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

TargetRoasSimulationPoint

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

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

string ( int64 format)

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

target Roas

number

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

biddable Conversions

number

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

biddable Conversions Value

number

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

clicks

string ( int64 format)

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

cost Micros

string ( int64 format)

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

impressions

string ( int64 format)

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

top Slot Impressions

string ( int64 format)

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

Возрастной диапазонПросмотр

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

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

string

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

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

AdScheduleView

Представление расписания показа объявлений суммирует эффективность кампаний по критериям AdSchedule.

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

string

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

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

ДоменКатегория

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

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

string

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

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

campaign

string

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

category

string

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

language Code

string

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

domain

string

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

coverage Fraction

number

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

category Rank

string ( int64 format)

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

has Children

boolean

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

recommended Cpc Bid Micros

string ( int64 format)

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

Ассетфилдтипевиев

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

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

string

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

customers/{customerId}/assetFieldTypeViews/{fieldType}

field Type

enum ( AssetFieldType )

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

AssetGroupProductGroupView

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

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

string

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

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

asset Group

string

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

asset Group Listing Group Filter

string

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

Ассетгрупптопкомбинатионвиев

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

JSON-представление 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Поля
resource Name

string

Только вывод. Имя ресурса верхнего комбинированного представления группы активов. AssetGroup Top Comminate View Имена ресурсов имеет форму: `" Customs/{customer}/assetGrouptopCombinationViews/{AssetGroupid} ~ {asset_combination_category} "

asset Group Top Combinations[]

object ( AssetGroupAssetCombinationData )

Только вывод. Лучшие комбинации активов, которые служили вместе.

AssetGroupasSetCombinationData

Данные комбинации активов группы активов

JSON-представление 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Поля
asset Combination Served Assets[]

object ( AssetUsage )

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

AssetSetTyPeview

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

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

string

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

customers/{customerId}/assetSetTypeViews/{assetSetType}

asset Set Type

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.
}
Поля
resource Name

string

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

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

bidding Strategy Id

string ( int64 format)

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

type

enum ( SimulationType )

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

modification Method

enum ( SimulationModificationMethod )

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

start Date

string

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

end Date

string

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

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

object ( TargetCpaSimulationPointList )

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

target Roas Point List

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)
}
Поля
resource Name

string

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

customers/{customerId}/callViews/{call_detail_id}

caller Country Code

string

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

caller Area Code

string

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

call Duration Seconds

string ( int64 format)

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

start Call Date Time

string

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

end Call Date Time

string

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

call Tracking Display Location

enum ( CallTrackingDisplayLocation )

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

type

enum ( CallType )

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

call Status

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
}
Поля
resource Name

string

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

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

Campaignsearchminsight

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

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

string

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

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

category Label

string

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

id

string ( int64 format)

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

campaign Id

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.
}
Поля
resource Name

string

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

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

campaign Id

string ( int64 format)

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

type

enum ( SimulationType )

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

modification Method

enum ( SimulationModificationMethod )

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

start Date

string

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

end Date

string

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

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

object ( CpcBidSimulationPointList )

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

target Cpa Point List

object ( TargetCpaSimulationPointList )

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

target Roas Point List

object ( TargetRoasSimulationPointList )

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

target Impression Share Point List

object ( TargetImpressionShareSimulationPointList )

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

budget Point List

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
}
Поля
target Impression Share Micros

string ( int64 format)

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

required Cpc Bid Ceiling Micros

string ( int64 format)

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

required Budget Amount Micros

string ( int64 format)

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

biddable Conversions

number

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

biddable Conversions Value

number

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

clicks

string ( int64 format)

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

cost Micros

string ( int64 format)

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

impressions

string ( int64 format)

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

top Slot Impressions

string ( int64 format)

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

absolute Top Impressions

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,
  "interactions": string
}
Поля
budget Amount Micros

string ( int64 format)

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

required Cpc Bid Ceiling Micros

string ( int64 format)

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

biddable Conversions

number

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

biddable Conversions Value

number

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

clicks

string ( int64 format)

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

cost Micros

string ( int64 format)

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

impressions

string ( int64 format)

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

top Slot Impressions

string ( int64 format)

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

interactions

string ( int64 format)

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

CarrierConstant

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

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

string

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

carrierConstants/{criterionId}

id

string ( int64 format)

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

name

string

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

country Code

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
}
Поля
resource Name

string

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

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

change Date Time

string

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

change Resource Type

enum ( ChangeEventResourceType )

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

change Resource Name

string

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

client Type

enum ( ChangeClientType )

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

user Email

string

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

old Resource

object ( ChangedResource )

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

new Resource

object ( ChangedResource )

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

resource Change Operation

enum ( ResourceChangeOperation )

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

changed Fields

string ( FieldMask format)

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

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

campaign

string

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

ad Group

string

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

feed

string

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

feed Item

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.
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION Изменения, внесенные путем подписки на рекомендации Google Ads.

Изменился

Прото, представляющий все поддерживаемые ресурсы. Будет установлен только ресурс 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.

ad Group

object ( AdGroup )

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

ad Group Criterion

object ( AdGroupCriterion )

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

campaign

object ( Campaign )

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

campaign Budget

object ( CampaignBudget )

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

ad Group Bid Modifier

object ( AdGroupBidModifier )

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

campaign Criterion

object ( CampaignCriterion )

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

feed

object ( Feed )

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

feed Item

object ( FeedItem )

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

campaign Feed

object ( CampaignFeed )

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

ad Group Feed

object ( AdGroupFeed )

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

ad Group Ad

object ( AdGroupAd )

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

asset

object ( Asset )

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

customer Asset

object ( CustomerAsset )

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

campaign Asset

object ( CampaignAsset )

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

ad Group Asset

object ( AdGroupAsset )

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

asset Set

object ( AssetSet )

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

asset Set Asset

object ( AssetSetAsset )

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

campaign Asset Set

object ( CampaignAssetSet )

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

ResourceCechangeOperation

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

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

Changestatus

Описывает статус возвращаемого ресурса. 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
}
Поля
resource Name

string

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

customers/{customerId}/changeStatus/{change_status_id}

resource Type

enum ( ChangeStatusResourceType )

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

resource Status

enum ( ChangeStatusOperation )

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

shared Set

string

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

campaign Shared Set

string

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

asset

string

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

customer Asset

string

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

campaign Asset

string

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

ad Group Asset

string

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

combined Audience

string

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

last Change Date Time

string

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

campaign

string

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

ad Group

string

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

ad Group Ad

string

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

ad Group Criterion

string

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

campaign Criterion

string

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

feed

string

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

feed Item

string

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

ad Group Feed

string

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

campaign Feed

string

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

ad Group Bid Modifier

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
}
Поля
resource Name

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 Удаленный статус - комбинированная аудитория удаляется и не может использоваться для таргетинга.

ClickView

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

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

string

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

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

area Of Interest

object ( ClickLocation )

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

location Of Presence

object ( ClickLocation )

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

keyword

string

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

keyword Info

object ( KeywordInfo )

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

gclid

string

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

page Number

string ( int64 format)

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

ad Group Ad

string

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

campaign Location Target

string

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

user List

string

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

Clicklocation

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

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

string

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

country

string

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

metro

string

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

most Specific

string

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

region

string

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

CurrencyConstant

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

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

string

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

currencyConstants/{code}

code

string

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

name

string

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

symbol

string

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

billable Unit Micros

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.
}
Поля
resource Name

string

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

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string ( int64 format)

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

name

string

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

type

enum ( BiddingStrategyType )

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

owner Customer Id

string ( int64 format)

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

owner Descriptive Name

string

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

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

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

maximize Conversion Value

object ( MaximizeConversionValue )

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

maximize Conversions

object ( MaximizeConversions )

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

target Cpa

object ( TargetCpa )

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

target Impression Share

object ( TargetImpressionShare )

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

target Roas

object ( TargetRoas )

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

target Spend

object ( TargetSpend )

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

MaximizeConversionValue

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

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

number

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

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

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

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

string ( int64 format)

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

TargetCpa

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

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

string ( int64 format)

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

TargetImpressionShare

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

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

enum ( TargetImpressionShareLocation )

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

location Fraction Micros

string ( int64 format)

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

cpc Bid Ceiling Micros

string ( int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string ( int64 format)

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

cpc Bid Ceiling Micros

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
}
Поля
resource Name

string

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

applied Labels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum ( CustomerStatus )

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

client Customer

string

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

hidden

boolean

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

level

string ( int64 format)

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

time Zone

string

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

test Account

boolean

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

manager

boolean

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

descriptive Name

string

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

currency Code

string

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

id

string ( int64 format)

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

CustomereShermInsight

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

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

string

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

customers/{customerId}/customerSearchTermInsights/{categoryId}

category Label

string

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

id

string ( int64 format)

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

DetailPlacewiew

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

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

string

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

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

placement Type

enum ( PlacementType )

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

placement

string

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

display Name

string

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

group Placement Target Url

string

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

target Url

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)
    }
  ]
}
Поля
resource Name

string

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

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string ( int64 format)

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

name

string

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

parent

string

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

launched To All

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
}
Поля
availability Mode

enum ( CriterionCategoryChannelAvailabilityMode )

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

advertising Channel Type

enum ( AdvertisingChannelType )

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

advertising Channel Sub Type[]

enum ( AdvertisingChannelSubType )

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

include Default Channel Sub Type

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
}
Поля
availability Mode

enum ( CriterionCategoryLocaleAvailabilityMode )

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

country Code

string

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

language Code

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
}
Поля
resource Name

string

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

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

Расстояние

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

JSON-представление 
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
Поля
resource Name

string

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

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

distance Bucket

enum ( DistanceBucket )

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

metric System

boolean

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

DistanceBucket

Расстояние ведра для расстояния пользователя от расширения местоположения рекламодателя.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии.
WITHIN_700M Пользователь находился в пределах 700 м от места.
WITHIN_1KM Пользователь находился в пределах 1 км от места.
WITHIN_5KM Пользователь находился в пределах 5 км от места.
WITHIN_10KM Пользователь находился в пределах 10 км от места.
WITHIN_15KM Пользователь находился в пределах 15 км от места.
WITHIN_20KM Пользователь находился в пределах 20 км от места.
WITHIN_25KM Пользователь находился в пределах 25 км от места.
WITHIN_30KM Пользователь находился в пределах 30 км от места.
WITHIN_35KM Пользователь находился в пределах 35 км от места.
WITHIN_40KM Пользователь находился в пределах 40 км от места.
WITHIN_45KM Пользователь находился в пределах 45 км от места.
WITHIN_50KM Пользователь находился в пределах 50 км от места.
WITHIN_55KM Пользователь находился в пределах 55 км от места.
WITHIN_60KM Пользователь находился в пределах 60 км от места.
WITHIN_65KM Пользователь находился в пределах 65 км от места.
BEYOND_65KM Пользователь был за пределами 65 км местоположения.
WITHIN_0_7MILES Пользователь находился в пределах 0,7 миль от места.
WITHIN_1MILE Пользователь находился в пределах 1 мили от места.
WITHIN_5MILES Пользователь находился в пределах 5 миль от места.
WITHIN_10MILES Пользователь находился в пределах 10 миль от места.
WITHIN_15MILES Пользователь находился в пределах 15 миль от места.
WITHIN_20MILES Пользователь находился в пределах 20 миль от места.
WITHIN_25MILES Пользователь находился в пределах 25 миль от места.
WITHIN_30MILES Пользователь находился в пределах 30 миль от места.
WITHIN_35MILES Пользователь находился в пределах 35 миль от места.
WITHIN_40MILES Пользователь находился в пределах 40 миль от места.
BEYOND_40MILES Пользователь превышал 40 миль от места.

DynamicSearchAdsSearchVermView

Динамический поисковый поисковый просмотр.

JSON-представление 
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
Поля
resource Name

string

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

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

search Term

string

Только вывод. Поисковый запрос

Это поле только для чтения.

headline

string

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

Это поле только для чтения.

landing Page

string

Только вывод. Динамически выбранная URL -адрес -страницы впечатления.

Это поле только для чтения.

page Url

string

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

Это поле только для чтения.

has Negative Keyword

boolean

Только вывод. Верно, если запрос соответствует отрицательному ключевому слову.

Это поле только для чтения.

has Matching Keyword

boolean

Только вывод. Верно, если запрос добавлен в целевые ключевые слова.

Это поле только для чтения.

has Negative Url

boolean

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

Это поле только для чтения.

ExpatedLandingPageview

Вид на целевой странице с метриками, агрегированными на расширенном конечном уровне URL.

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

string

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

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expanded Final Url

string

Только вывод. Окончательный URL, на который клики направлен.

Feedmplaceholderview

Вид на кормовой заполнитель.

JSON-представление 
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
Поля
resource Name

string

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

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholder Type

enum ( PlaceholderType )

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

Genderview

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

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

string

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

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

GeographyView

Географический взгляд.

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

JSON-представление 
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
Поля
resource Name

string

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

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

location Type

enum ( GeoTargetingType )

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

country Criterion Id

string ( int64 format)

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

GeotargetingType

Возможные типы таргетинга GEO.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Значение неизвестно в этой версии.
AREA_OF_INTEREST Местоположение пользователь заинтересован в том, чтобы сделать запрос.
LOCATION_OF_PRESENCE Расположение пользователя, выдавающего запрос.

GroupplesionView

Групповое представление.

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

string

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

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

placement Type

enum ( PlacementType )

Только вывод. 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.

display Name

string

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

target Url

string

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

HotelGroupView

A hotel group view.

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

string

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

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

HotelPerformanceView

A hotel performance view.

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

string

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

customers/{customerId}/hotelPerformanceView

HotelReconciliation

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

JSON-представление 
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
Поля
resource Name

string

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

customers/{customerId}/hotelReconciliations/{commissionId}

commission Id

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.

order Id

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.

hotel Center Id

string ( int64 format)

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

hotel Id

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.

check In Date

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.

check Out Date

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.

reconciled Value Micros

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.

Перечисления
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-представление 
{
  "resourceName": string
}
Поля
resource Name

string

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

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

KeywordView

A keyword view.

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

string

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

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

LandingPageView

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

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

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}

unexpanded Final Url

string

Output only. The advertiser-specified final URL.

LanguageConstant

A language.

JSON-представление 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Поля
resource Name

string

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

languageConstants/{criterionId}

id

string ( int64 format)

Output only. The ID of the language constant.

code

string

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

name

string

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

targetable

boolean

Output only. Whether the language is targetable.

LocationView

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

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

string

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

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

ManagedPlacementView

A managed placement view.

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

string

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

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

MediaFile

A media file.

JSON-представление 
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
Поля
resource Name

string

Immutable. The resource name of the media file. Media file resource names have the form:

customers/{customerId}/mediaFiles/{media_file_id}

type

enum ( MediaType )

Immutable. Type of the media file.

mime Type

enum ( MimeType )

Output only. The mime type of the media file.

id

string ( int64 format)

Только вывод. The ID of the media file.

source Url

string

Immutable. The URL of where the original media file was downloaded from (or a file name). Only used for media of type AUDIO and IMAGE.

name

string

Immutable. The name of the media file. The name can be used by clients to help identify previously uploaded media.

file Size

string ( int64 format)

Output only. The size of the media file in bytes.

Union field mediatype . The specific type of the media file. mediatype can be only one of the following:
image

object ( MediaImage )

Immutable. Encapsulates an Image.

media Bundle

object ( MediaBundle )

Immutable. A ZIP archive media the content of which contains HTML5 assets.

audio

object ( MediaAudio )

Output only. Encapsulates an Audio.

video

object ( MediaVideo )

Immutable. Encapsulates a Video.

MediaType

The type of media.

Перечисления
UNSPECIFIED The media type has not been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

IMAGE Static image, used for image ad.
ICON Small image, used for map ad.
MEDIA_BUNDLE ZIP file, used in fields of template ads.
AUDIO Аудио файл.
VIDEO Видео файл.
DYNAMIC_IMAGE Animated image, such as animated GIF.

MediaImage

Encapsulates an Image.

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

string ( bytes format)

Immutable. Raw image data.

A base64-encoded string.

full Size Image Url

string

Output only. The url to the full size version of the image.

preview Size Image Url

string

Только вывод. The url to the preview size version of the image.

MediaBundle

Represents a ZIP archive media the content of which contains HTML5 assets.

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

string ( bytes format)

Immutable. Raw zipped data.

A base64-encoded string.

url

string

Output only. The url to access the uploaded zipped data. For example, https://tpc.googlesyndication.com/simgad/123 This field is read-only.

MediaAudio

Encapsulates an Audio.

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

string ( int64 format)

Output only. The duration of the Audio in milliseconds.

MediaVideo

Encapsulates a Video.

JSON-представление 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
Поля
ad Duration Millis

string ( int64 format)

Output only. The duration of the Video in milliseconds.

youtube Video Id

string

Immutable. The YouTube video ID (as seen in YouTube URLs). Adding prefix "https://www.youtube.com/watch?v=" to this ID will get the YouTube streaming URL for this video.

advertising Id Code

string

Output only. The Advertising Digital Identification code for this video, as defined by the American Association of Advertising Agencies, used mainly for television commercials.

isci Code

string

Output only. The Industry Standard Commercial Identifier code for this video, used mainly for television commercials.

LocalServicesEmployee

A local services employee resource.

JSON-представление 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
Поля
resource Name

string

Immutable. The resource name of the Local Services Verification. Local Services Verification resource names have the form:

customers/{customerId}/localServicesEmployees/{gls_employee_id}

creation Date Time

string

Output only. Timestamp of employee creation. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

status

enum ( LocalServicesEmployeeStatus )

Output only. Employee status, such as DELETED or ENABLED.

type

enum ( LocalServicesEmployeeType )

Output only. Employee type.

university Degrees[]

object ( UniversityDegree )

Output only. A list of degrees this employee has obtained, and wants to feature.

residencies[]

object ( Residency )

Output only. The institutions where the employee has completed their residency.

fellowships[]

object ( Fellowship )

Output only. The institutions where the employee has completed their fellowship.

languages Spoken[]

string

Output only. Languages that the employee speaks, represented as language tags from https://developers.google.com/admin-sdk/directory/v1/languages

category Ids[]

string

Output only. Category of the employee. A list of Local Services category IDs can be found at https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids .

id

string ( int64 format)

Output only. The ID of the employee.

job Title

string

Output only. Job title for this employee, such as "Senior partner" in legal verticals.

year Started Practicing

integer

Output only. The year that this employee started practicing in this field.

national Provider Id Number

string

Output only. NPI id associated with the employee.

email Address

string

Output only. Email address of the employee.

first Name

string

Output only. First name of the employee.

middle Name

string

Output only. Middle name of the employee.

last Name

string

Output only. Last name of the employee.

LocalServicesEmployeeStatus

Enums describing statuses of a local services employee.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Employee is not removed, and employee status is active.
REMOVED Employee is removed. Used to delete an employee from the business.

LocalServicesEmployeeType

Enums describing types of a local services employee.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BUSINESS_OWNER Represents the owner of the business.
EMPLOYEE Represents an employee of the business.

UniversityDegree

A list of degrees this employee has obtained, and wants to feature.

JSON-представление 
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
Поля
institution Name

string

Только вывод. Name of the university at which the degree was obtained.

degree

string

Output only. Name of the degree obtained.

graduation Year

integer

Output only. Year of graduation.

Резидентура

Details about the employee's medical residency. Residency is a stage of graduate medical education in which a qualified medical professional practices under the supervision of a senior clinician.

JSON-представление 
{
  "institutionName": string,
  "completionYear": integer
}
Поля
institution Name

string

Output only. Name of the institution at which the residency was completed.

completion Year

integer

Output only. Year of completion.

Стипендия

Details about the employee's medical Fellowship. Fellowship is a period of medical training that the professional undertakes after finishing their residency.

JSON-представление 
{
  "institutionName": string,
  "completionYear": integer
}
Поля
institution Name

string

Output only. Name of the instutition at which the fellowship was completed.

completion Year

integer

Output only. Year of completion.

LocalServicesVerificationArtifact

A local services verification resource.

JSON-представление 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  },
  "businessRegistrationCheckVerificationArtifact": {
    object (BusinessRegistrationCheckVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
Поля
resource Name

string

Immutable. The resource name of the Local Services Verification. Local Services Verification resource names have the form:

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}

creation Date Time

string

Output only. The timestamp when this verification artifact was created. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

status

enum ( LocalServicesVerificationArtifactStatus )

Output only. The status of the verification artifact.

artifact Type

enum ( LocalServicesVerificationArtifactType )

Output only. The type of the verification artifact.

id

string ( int64 format)

Output only. The ID of the verification artifact.

Union field artifact_data . The types of verification info. artifact_data can be only one of the following:
background Check Verification Artifact

object ( BackgroundCheckVerificationArtifact )

Output only. A background check verification artifact.

insurance Verification Artifact

object ( InsuranceVerificationArtifact )

Output only. An insurance verification artifact.

license Verification Artifact

object ( LicenseVerificationArtifact )

Output only. A license verification artifact.

business Registration Check Verification Artifact

object ( BusinessRegistrationCheckVerificationArtifact )

Output only. A business registration check verification artifact.

LocalServicesVerificationArtifactStatus

Enums describing statuses of a local services verification artifact.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
PASSED Artifact has passed verification.
FAILED Artifact has failed verification.
PENDING Artifact is in the process of verification.
NO_SUBMISSION Artifact needs user to upload information before it is verified.
CANCELLED Artifact has been cancelled by the user.

LocalServicesVerificationArtifactType

Enums describing possible types of local services verification artifact.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BACKGROUND_CHECK Background check verification artifact.
INSURANCE Insurance verification artifact.
LICENSE License verification artifact.
BUSINESS_REGISTRATION_CHECK Business registration check verification artifact.

BackgroundCheckVerificationArtifact

A proto holding information specific to local services background check.

JSON-представление 
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
Поля
case Url

string

Output only. URL to access background case.

final Adjudication Date Time

string

Только вывод. The timestamp when this background check case result was adjudicated. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

InsuranceVerificationArtifact

A proto holding information specific to a local services insurance.

JSON-представление 
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Поля
amount Micros

string ( int64 format)

Output only. Insurance amount. This is measured in "micros" of the currency mentioned in the insurance document.

rejection Reason

enum ( LocalServicesInsuranceRejectionReason )

Output only. Insurance document's rejection reason.

insurance Document Readonly

object ( LocalServicesDocumentReadOnly )

Output only. The readonly field containing the information for an uploaded insurance document.

LocalServicesInsuranceRejectionReason

Enums describing possible rejection reasons of a local services insurance verification artifact.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BUSINESS_NAME_MISMATCH Business name doesn't match business name for the Local Services Ad.
INSURANCE_AMOUNT_INSUFFICIENT Insurance amount doesn't meet requirement listed in the legal summaries documentation for that geographic + category ID combination.
EXPIRED Insurance document is expired.
NO_SIGNATURE Insurance document is missing a signature.
NO_POLICY_NUMBER Insurance document is missing a policy number.
NO_COMMERCIAL_GENERAL_LIABILITY Commercial General Liability(CGL) box is not marked in the insurance document.
EDITABLE_FORMAT Insurance document is in an editable format.
CATEGORY_MISMATCH Insurance document does not cover insurance for a particular category.
MISSING_EXPIRATION_DATE Insurance document is missing an expiration date.
POOR_QUALITY Insurance document is poor quality - blurry images, illegible, etc...
POTENTIALLY_EDITED Insurance document is suspected of being edited.
WRONG_DOCUMENT_TYPE Insurance document not accepted. For example, documents of insurance proposals, but missing coverages are not accepted.
NON_FINAL Insurance document is not final.
OTHER Insurance document has another flaw not listed explicitly.

LocalServicesDocumentReadOnly

A Local Services Document with read only accessible data.

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

string

URL to access an already uploaded Local Services document.

LicenseVerificationArtifact

A proto holding information specific to a local services license.

JSON-представление 
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Поля
license Type

string

Output only. License type / name.

license Number

string

Output only. Номер лицензии.

licensee First Name

string

Output only. First name of the licensee.

licensee Last Name

string

Output only. Last name of the licensee.

rejection Reason

enum ( LocalServicesLicenseRejectionReason )

Output only. License rejection reason.

license Document Readonly

object ( LocalServicesDocumentReadOnly )

Output only. The readonly field containing the information for an uploaded license document.

LocalServicesLicenseRejectionReason

Enums describing possible rejection reasons of a local services license verification artifact.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BUSINESS_NAME_MISMATCH Business name doesn't match business name for the Local Services Ad.
UNAUTHORIZED License is unauthorized or been revoked.
EXPIRED License is expired.
POOR_QUALITY License is poor quality - blurry images, illegible, etc...
UNVERIFIABLE License cannot be verified due to a not legitimate image.
WRONG_DOCUMENT_OR_ID License is not the requested document type or contains an invalid ID.
OTHER License has another flaw not listed explicitly.

BusinessRegistrationCheckVerificationArtifact

A proto holding information specific to a local services business registration check.

JSON-представление 
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
Поля
registration Type

enum ( LocalServicesBusinessRegistrationType )

Output only. The type of business registration check (number, document).

check Id

string

Output only. The id of the check, such as vat_tax_id, representing "VAT Tax ID" requirement.

rejection Reason

enum ( LocalServicesBusinessRegistrationCheckRejectionReason )

Output only. Registration document rejection reason.

Union field business_registration . Registration information for the business registration. It will be one of the following forms based on the requirement from different countries. business_registration can be only one of the following:
registration Number

object ( BusinessRegistrationNumber )

Output only. Message storing government issued number for the business.

registration Document

object ( BusinessRegistrationDocument )

Только вывод. Message storing document info for the business.

LocalServicesBusinessRegistrationType

Enums describing possible registration types of a local services business registration check verification artifact.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
NUMBER Registration number check type.
DOCUMENT Registration document check type.

LocalServicesBusinessRegistrationCheckRejectionReason

Enums describing possible rejection reasons of a local services business registration check verification artifact.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BUSINESS_NAME_MISMATCH Business name doesn't match business name for the Local Services Ad.
BUSINESS_DETAILS_MISMATCH Business details mismatch.
ID_NOT_FOUND Business registration ID not found.
POOR_DOCUMENT_IMAGE_QUALITY Uploaded document not clear, blurry, etc.
DOCUMENT_EXPIRED Uploaded document has expired.
DOCUMENT_INVALID Document revoked or annuled.
DOCUMENT_TYPE_MISMATCH Document type mismatch.
DOCUMENT_UNVERIFIABLE Uploaded document could not be verified as legitimate.
OTHER The business registration process could not be completed due to an issue. Contact https://support.google.com/localservices to learn more.

BusinessRegistrationNumber

A proto holding information specific to a local services business registration number.

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

string

Output only. Government-issued number for the business.

BusinessRegistrationDocument

A proto holding information specific to a local services business registration document.

JSON-представление 
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Поля
document Readonly

object ( LocalServicesDocumentReadOnly )

Output only. The readonly field containing the information for an uploaded business registration document.

MobileAppCategoryConstant

A mobile application category constant.

JSON-представление 
{
  "resourceName": string,
  "id": integer,
  "name": string
}
Поля
resource Name

string

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

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

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

name

string

Output only. Mobile app category name.

MobileDeviceConstant

A mobile device constant.

JSON-представление 
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
Поля
resource Name

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.

manufacturer Name

string

Output only. The manufacturer of the mobile device.

operating System Name

string

Output only. The operating system of the mobile device.

MobileDeviceType

The type of mobile device.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
MOBILE Мобильные телефоны.
TABLET Таблетки.

OfflineConversionUploadClientSummary

Offline conversion upload summary at customer level.

JSON-представление 
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
Поля
resource Name

string

Output only. The resource name of the offline conversion upload summary at customer level. Offline conversion upload client summary resource names have the form:

customers/{customerId}/offlineConversionUploadClientSummaries/{client}

client

enum ( OfflineEventUploadClient )

Output only. Client type of the upload event.

status

enum ( OfflineConversionDiagnosticStatus )

Output only. Overall status for offline conversion client summary. Status is generated from most recent calendar day with upload stats.

total Event Count

string ( int64 format)

Output only. Total count of uploaded events.

successful Event Count

string ( int64 format)

Output only. Total count of successful uploaded events.

success Rate

number

Output only. Successful rate.

last Upload Date Time

string

Output only. Date for the latest upload batch. The format is "yyyy-mm-dd hh:mm:ss", and it's in the time zone of the Google Ads account.

daily Summaries[]

object ( OfflineConversionSummary )

Output only. Summary of history stats by last N days.

job Summaries[]

object ( OfflineConversionSummary )

Output only. Summary of history stats by last N jobs.

alerts[]

object ( OfflineConversionAlert )

Output only. Details for each error code. Alerts are generated from most recent calendar day with upload stats.

OfflineEventUploadClient

Type of client.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
GOOGLE_ADS_API Google Ads API.
GOOGLE_ADS_WEB_CLIENT Google Ads web client, which could include multiple sources like Ads UI, SFTP, etc.
ADS_DATA_CONNECTOR Connection platform.

OfflineConversionDiagnosticStatus

Possible statuses of the offline ingestion setup.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
EXCELLENT Your offline data ingestion setup is active and optimal for downstream processing.
GOOD Your offline ingestion setup is active, but there are further improvements you could make. See alerts.
NEEDS_ATTENTION Your offline ingestion setup is active, but there are errors that require your attention. See alerts.
NO_RECENT_UPLOAD Your offline ingestion setup has not received data in the last 28 days, there may be something wrong.

OfflineConversionSummary

Historical upload summary, grouped by upload date or job.

JSON-представление 
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
Поля
successful Count

string ( int64 format)

Только вывод. Total count of successful event.

failed Count

string ( int64 format)

Output only. Total count of failed event.

Union field dimension_key . Dimension key for summary. dimension_key can be only one of the following:
job Id

string ( int64 format)

Output only. Dimension key for last N jobs.

upload Date

string

Output only. Dimension key for last N days.

OfflineConversionAlert

Alert for offline conversion client summary.

JSON-представление 
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
Поля
error

object ( OfflineConversionError )

Output only. Error for offline conversion client alert.

error Percentage

number

Output only. Percentage of the error, the range of this field should be [0, 1.0].

OfflineConversionError

Possible errors for offline conversion client summary.

JSON-представление 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
Поля
Union field error_code . Error with description. error_code can be only one of the following:
collection Size Error

enum ( CollectionSizeError )

Output only. Collection size error.

conversion Adjustment Upload Error

enum ( ConversionAdjustmentUploadError )

Output only. Conversion adjustment upload error.

conversion Upload Error

enum ( ConversionUploadError )

Output only. Conversion upload error.

date Error

enum ( DateError )

Output only. Date error.

distinct Error

enum ( DistinctError )

Output only. Distinct error.

field Error

enum ( FieldError )

Output only. Field error.

mutate Error

enum ( MutateError )

Output only. Mutate error.

not Allowlisted Error

enum ( NotAllowlistedError )

Output only. Not allowlisted error.

string Format Error

enum ( StringFormatError )

Output only. String format error.

string Length Error

enum ( StringLengthError )

Output only. String length error.

CollectionSizeError

Enum describing possible collection size errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
TOO_FEW Слишком мало.
TOO_MANY Слишком много.

ConversionAdjustmentUploadError

Enum describing possible conversion adjustment upload errors.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
TOO_RECENT_CONVERSION_ACTION Can't import events to a conversion action that was just created. Try importing again in 6 hours.
CONVERSION_ALREADY_RETRACTED The conversion was already retracted. This adjustment was not processed.
CONVERSION_NOT_FOUND The conversion for this conversion action and conversion identifier can't be found. Make sure your conversion identifiers are associated with the correct conversion action and try again.
CONVERSION_EXPIRED Adjustment can't be made to a conversion that occurred more than 54 days ago.
ADJUSTMENT_PRECEDES_CONVERSION Adjustment has an adjustmentDateTime that occurred before the associated conversion. Make sure your adjustmentDateTime is correct and try again.
MORE_RECENT_RESTATEMENT_FOUND More recent adjustment adjustmentDateTime has already been reported for the associated conversion. Make sure your adjustment adjustmentDateTime is correct and try again.
TOO_RECENT_CONVERSION Adjustment can't be recorded because the conversion occurred too recently. Try adjusting a conversion that occurred at least 24 hours ago.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE Can't make an adjustment to a conversion that is set up to use the default value. Check your conversion action value setting and try again.
TOO_MANY_ADJUSTMENTS_IN_REQUEST Try uploading fewer than 2001 adjustments in a single API request.
TOO_MANY_ADJUSTMENTS The conversion has already been adjusted the maximum number of times. Make sure you're only making necessary adjustment to existing conversion.
RESTATEMENT_ALREADY_EXISTS The conversion has prior a restatement with the same adjustmentDateTime . Make sure your adjustment has the correct and unique adjustmentDateTime and try again.
DUPLICATE_ADJUSTMENT_IN_REQUEST Imported adjustment has a duplicate conversion adjustment with same adjustmentDateTime . Make sure your adjustment has the correct adjustmentDateTime and try again.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Make sure you agree to the customer data processing terms in conversion settings and try again.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Can't use enhanced conversions with the specified conversion action.
INVALID_USER_IDENTIFIER Make sure you hash user provided data using SHA-256 and ensure you are normalizing according to the guidelines.
UNSUPPORTED_USER_IDENTIFIER Use user provided data such as emails or phone numbers hashed using SHA-256 and try again.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET Cannot set both gclidDateTimePair and orderId. Use only 1 type and try again.
CONVERSION_ALREADY_ENHANCED Conversion already has enhancements with the same Order ID and conversion action. Make sure your data is correctly configured and try again.
DUPLICATE_ENHANCEMENT_IN_REQUEST Multiple enhancements have the same conversion action and Order ID. Make sure your data is correctly configured and try again.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT Enhanced conversions can't be used for this account because of Google customer data policies. Contact your Google representative.
MISSING_ORDER_ID_FOR_WEBPAGE Adjustment for website conversion requires Order ID (ie, transaction ID). Make sure your website tags capture Order IDs and you send the same Order IDs with your adjustment.
ORDER_ID_CONTAINS_PII Can't use adjustment with Order IDs containing personally-identifiable information (PII).
INVALID_JOB_ID The provided job id in the request is not within the allowed range. A job ID must be a positive integer in the range [1, 2^31).
NO_CONVERSION_ACTION_FOUND The conversion action specified in the adjustment request cannot be found. Make sure it's available in this account.
INVALID_CONVERSION_ACTION_TYPE The type of the conversion action specified in the adjustment request isn't supported for uploading adjustments. A conversion adjustment of type RETRACTION or RESTATEMENT is only permitted for conversion actions of type SALESFORCE , UPLOAD_CLICK or WEBPAGE . A conversion adjustment of type ENHANCEMENT is only permitted for conversion actions of type WEBPAGE .

ConversionUploadError

Enum describing possible conversion upload errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN Used for return value only. Represents value unknown in this version.
TOO_MANY_CONVERSIONS_IN_REQUEST Upload fewer than 2001 events in a single request.
UNPARSEABLE_GCLID The imported gclid could not be decoded. Make sure you have not modified the click IDs.
CONVERSION_PRECEDES_EVENT The imported event has a conversionDateTime that precedes the click. Make sure your conversionDateTime is correct and try again.
EXPIRED_EVENT The imported event can't be recorded because its click occurred before this conversion's click-through window. Make sure you import the most recent data.
TOO_RECENT_EVENT The click associated with the given identifier or iOS URL parameter occurred less than 6 hours ago. Retry after 6 hours have passed.
EVENT_NOT_FOUND The imported event could not be attributed to a click. This may be because the event did not come from a Google Ads campaign.
UNAUTHORIZED_CUSTOMER The click ID or call is associated with an Ads account you don't have access to. Make sure you import conversions for accounts managed by your manager account.
TOO_RECENT_CONVERSION_ACTION Can't import events to a conversion action that was just created. Try importing again in 6 hours.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME At the time of the click, conversion tracking was not enabled in the effective conversion account of the click's Google Ads account.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION The imported event includes external attribution data, but the conversion action isn't set up to use an external attribution model. Make sure the conversion action is correctly configured and try again.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION The conversion action is set up to use an external attribution model, but the imported event is missing data. Make sure imported events include the external attribution credit and all necessary fields.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Order IDs can't be used for a conversion measured with an external attribution model. Make sure the conversion is correctly configured and imported events include only necessary data and try again.
ORDER_ID_ALREADY_IN_USE The imported event includes an order ID that was previously recorded, so the event was not processed.
DUPLICATE_ORDER_ID Imported events include multiple conversions with the same order ID and were not processed. Make sure order IDs are unique and try again.
TOO_RECENT_CALL Can't import calls that occurred less than 6 hours ago. Try uploading again in 6 hours.
EXPIRED_CALL The call can't be recorded because it occurred before this conversion action's lookback window. Make sure your import is configured to get the most recent data.
CALL_NOT_FOUND The call or click leading to the imported event can't be found. Make sure your data source is set up to include correct identifiers.
CONVERSION_PRECEDES_CALL The call has a conversionDateTime that precedes the associated click. Make sure your conversionDateTime is correct.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME At the time of the imported call, conversion tracking was not enabled in the effective conversion account of the click's Google Ads account.
UNPARSEABLE_CALLERS_PHONE_NUMBER Make sure phone numbers are formatted as E.164 (+16502531234), International (+64 3-331 6005), or US national number (6502531234).
CLICK_CONVERSION_ALREADY_EXISTS The imported event has the same click and conversionDateTime as an existing conversion. Use a unique conversionDateTime or order ID for each unique event and try again.
CALL_CONVERSION_ALREADY_EXISTS The imported call has the same conversionDateTime as an existing conversion. Make sure your conversionDateTime correctly configured and try again.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Multiple events have the same click and conversionDateTime . Make sure your conversionDateTime is correctly configured and try again.
DUPLICATE_CALL_CONVERSION_IN_REQUEST Multiple events have the same call and conversionDateTime . Make sure your conversionDateTime is correctly configured and try again.
CUSTOM_VARIABLE_NOT_ENABLED Enable the custom variable in your conversion settings and try again.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Can't import events with custom variables containing personally-identifiable information (PII). Remove these variables and try again.
INVALID_CUSTOMER_FOR_CLICK The click from the imported event is associated with a different Google Ads account. Make sure you're importing to the correct account.
INVALID_CUSTOMER_FOR_CALL The click from the call is associated with a different Google Ads account. Make sure you're importing to the correct account. Query conversionTrackingSetting.google_ads_conversion_customer on Customer to identify the correct account.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY The connversion can't be imported because the conversion source didn't comply with Apple App Transparency Tracking (ATT) policies or because the customer didn't consent to tracking.
CLICK_NOT_FOUND The email address or phone number for this event can't be matched to a click. This may be because it didn't come from a Google Ads campaign, and you can safely ignore this warning. If this includes more imported events than is expected, you may need to check your setup.
INVALID_USER_IDENTIFIER Make sure you hash user provided data using SHA-256 and ensure you are normalizing according to the guidelines.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER User provided data can't be used with external attribution models. Use a different attribution model or omit user identifiers and try again.
UNSUPPORTED_USER_IDENTIFIER The provided user identifiers are not supported. Use only hashed email or phone number and try again.
GBRAID_WBRAID_BOTH_SET Can't use both gbraid and wbraid parameters. Use only 1 and try again.
UNPARSEABLE_WBRAID Can't parse event import data. Check if your wbraid parameter was not modified and try again.
UNPARSEABLE_GBRAID Can't parse event import data. Check if your gbraid parameter was not modified and try again.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID Conversion actions that use one-per-click counting can't be used with gbraid or wbraid parameters.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Enhanced conversions can't be used for this account because of Google customer data policies. Contact your Google representative.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Make sure you agree to the customer data processing terms in conversion settings and try again. You can check your setting by querying conversionTrackingSetting.accepted_customer_data_terms on Customer.
ORDER_ID_CONTAINS_PII Can't import events with order IDs containing personally-identifiable information (PII).
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Make sure you've turned on enhanced conversions for leads in conversion settings and try again. You can check your setting by querying conversionTrackingSetting.enhanced_conversions_for_leads_enabled on Customer.
INVALID_JOB_ID The provided job id in the request is not within the allowed range. A job ID must be a positive integer in the range [1, 2^31).
NO_CONVERSION_ACTION_FOUND The conversion action specified in the upload request cannot be found. Make sure it's available in this account.
INVALID_CONVERSION_ACTION_TYPE The conversion action specified in the upload request isn't set up for uploading conversions.

DateError

Enum describing possible date errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_FIELD_VALUES_IN_DATE Given field values do not correspond to a valid date.
INVALID_FIELD_VALUES_IN_DATE_TIME Given field values do not correspond to a valid date time.
INVALID_STRING_DATE The string date's format should be yyyy-mm-dd.
INVALID_STRING_DATE_TIME_MICROS The string date time's format should be yyyy-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS The string date time's format should be yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET The string date time's format should be yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE Date is before allowed minimum.
LATER_THAN_MAXIMUM_DATE Date is after allowed maximum.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Date range bounds are not in order.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL Both dates in range are null.

DistinctError

Enum describing possible distinct errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
DUPLICATE_ELEMENT Duplicate element.
DUPLICATE_TYPE Duplicate type.

FieldError

Enum describing possible field errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
REQUIRED The required field was not present.
IMMUTABLE_FIELD The field attempted to be mutated is immutable.
INVALID_VALUE The field's value is invalid.
VALUE_MUST_BE_UNSET The field cannot be set.
REQUIRED_NONEMPTY_LIST The required repeated field was empty.
FIELD_CANNOT_BE_CLEARED The field cannot be cleared.
BLOCKED_VALUE The field's value is on a deny-list for this field.
FIELD_CAN_ONLY_BE_CLEARED The field's value cannot be modified, except for clearing.

MutateError

Enum describing possible mutate errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
RESOURCE_NOT_FOUND Requested resource was not found.
ID_EXISTS_IN_MULTIPLE_MUTATES Cannot mutate the same resource twice in one request.
INCONSISTENT_FIELD_VALUES The field's contents don't match another field that represents the same data.
MUTATE_NOT_ALLOWED Mutates are not allowed for the requested resource.
RESOURCE_NOT_IN_GOOGLE_ADS The resource isn't in Google Ads. It belongs to another ads system.
RESOURCE_ALREADY_EXISTS The resource being created already exists.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY This resource cannot be used with "validateOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE This operation cannot be used with "partialFailure".
RESOURCE_READ_ONLY Attempt to write to read-only fields.

NotAllowlistedError

Enum describing possible not allowlisted errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Customer is not allowlisted for accessing this feature.

StringFormatError

Enum describing possible string format errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
ILLEGAL_CHARS The input string value contains disallowed characters.
INVALID_FORMAT The input string value is invalid for the associated field.

StringLengthError

Enum describing possible string length errors.

Перечисления
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
EMPTY The specified field should have a least one non-whitespace character in it.
TOO_SHORT Слишком короткий.
TOO_LONG Слишком долго.

OperatingSystemVersionConstant

A mobile operating system version or a range of versions, depending on operatorType . List of available mobile platforms at https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

JSON-представление 
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
Поля
resource Name

string

Только вывод. The resource name of the operating system version constant. Operating system version constant resource names have the form:

operatingSystemVersionConstants/{criterionId}

operator Type

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.

os Major Version

integer

Output only. The OS Major Version number.

os Minor Version

integer

Output only. The OS Minor Version number.

OperatingSystemVersionOperatorType

The type of operating system version.

Перечисления
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-представление 
{
  "resourceName": string,
  "searchTerm": string
}
Поля
resource Name

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}

search Term

string

Output only. The search term.

QualifyingQuestion

Qualifying Questions for Lead Form.

JSON-представление 
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
Поля
resource Name

string

Output only. The resource name of the qualifying question.

'qualifyingQuestions/{qualifyingQuestionId}'

qualifying Question Id

string ( int64 format)

Output only. The id of the qualifying question.

locale

string

Output only. The locale of the qualifying question.

text

string

Output only. The qualifying question.

ParentalStatusView

A parental status view.

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

string

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

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

PerStoreView

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

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

string

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

customers/{customerId}/perStoreViews/{placeId}

place Id

string

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

ProductCategoryConstant

A Product Category.

JSON-представление 
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
Поля
resource Name

string

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

productCategoryConstants/{level}~{categoryId}

category Id

string ( int64 format)

Output only. The ID of the product category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 .

level

enum ( ProductCategoryLevel )

Output only. Level of the product category.

state

enum ( ProductCategoryState )

Output only. State of the product category.

localizations[]

object ( ProductCategoryLocalization )

Output only. List of all available localizations of the product category.

product Category Constant Parent

string

Output only. Resource name of the parent product category.

ProductCategoryState

Enum describing the state of the product category.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED The category is enabled.
OBSOLETE The category is obsolete. Used only for reporting purposes.

ProductCategoryLocalization

Localization for the product category.

JSON-представление 
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
Поля
region Code

string

Output only. Upper-case two-letter ISO 3166-1 country code of the localized category.

language Code

string

Output only. Two-letter ISO 639-1 language code of the localized category.

value

string

Output only. The name of the category in the specified locale.

ProductGroupView

A product group view.

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

string

Только вывод. The resource name of the product group view. Product group view resource names have the form:

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

SearchTermView

A search term view with metrics aggregated by search term at the ad group level.

JSON-представление 
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
Поля
resource Name

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.

search Term

string

Output only. The search term.

ad Group

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.

Перечисления
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-представление 
{
  "resourceName": string
}
Поля
resource Name

string

Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

A Smart campaign search term view.

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

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}

search Term

string

Только вывод. The search term.

campaign

string

Output only. The Smart campaign the search term served in.

TopicView

A topic view.

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

string

Output only. The resource name of the topic view. Topic view resource names have the form:

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

TravelActivityGroupView

A travel activity group view.

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

string

Output only. The resource name of the travel activity group view. Travel Activity Group view resource names have the form:

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

TravelActivityPerformanceView

A travel activity performance view.

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

string

Output only. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form:

customers/{customerId}/travelActivityPerformanceView

UserInterest

A user interest: a particular interest-based vertical to be targeted.

JSON-представление 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
Поля
resource Name

string

Output only. The resource name of the user interest. User interest resource names have the form:

customers/{customerId}/userInterests/{userInterestId}

taxonomy Type

enum ( UserInterestTaxonomyType )

Output only. Taxonomy type of the user interest.

availabilities[]

object ( CriterionCategoryAvailability )

Output only. Availability information of the user interest.

user Interest Id

string ( int64 format)

Output only. The ID of the user interest.

name

string

Output only. The name of the user interest.

user Interest Parent

string

Только вывод. The parent of the user interest.

launched To All

boolean

Output only. True if the user interest is launched to all channels and locales.

UserInterestTaxonomyType

Enum containing the possible UserInterestTaxonomyTypes.

Перечисления
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.

LifeEvent

A life event: a particular interest-based vertical to be targeted to reach users when they are in the midst of important life milestones.

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

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.

launched To All

boolean

Output only. True if the life event is launched to all channels and locales.

availabilities[]

object ( CriterionCategoryAvailability )

Output only. Availability information of the life event.

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

JSON-представление 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Поля
resource Name

string

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

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

country Criterion Id

string ( int64 format)

Output only. Criterion Id for the country.

targeting Location

boolean

Output only. Indicates whether location was targeted or not.

TopicConstant

Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").

JSON-представление 
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
Поля
resource Name

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.

topic Constant Parent

string

Output only. Resource name of parent of the topic constant.

Видео

Видео.

JSON-представление 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
Поля
resource Name

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.

channel Id

string

Output only. The owner channel id of the video.

duration Millis

string ( int64 format)

Output only. The duration of the video in milliseconds.

title

string

Output only. The title of the video.

WebpageView

A webpage view.

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

string

Output only. The resource name of the webpage view. Webpage view resource names have the form:

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

LeadFormSubmissionData

Data from lead form submissions.

JSON-представление 
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
Поля
resource Name

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.

lead Form Submission Fields[]

object ( LeadFormSubmissionField )

Output only. Submission data associated with a lead form.

custom Lead Form Submission Fields[]

object ( CustomLeadFormSubmissionField )

Output only. Submission data associated with a custom lead form.

ad Group

string

Output only. AdGroup associated with the submitted lead form.

ad Group Ad

string

Output only. AdGroupAd associated with the submitted lead form.

gclid

string

Output only. Google Click Id associated with the submissed lead form.

submission Date Time

string

Output only. The date and time at which the lead form was submitted. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", for example, "2019-01-01 12:32:45-08:00".

LeadFormSubmissionField

Fields in the submitted lead form.

JSON-представление 
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
Поля
field Type

enum ( LeadFormFieldUserInputType )

Output only. Field type for lead form fields.

field Value

string

Output only. Field value for lead form fields.

CustomLeadFormSubmissionField

Fields in the submitted custom question

JSON-представление 
{
  "questionText": string,
  "fieldValue": string
}
Поля
question Text

string

Output only. Question text for custom question, maximum number of characters is 300.

field Value

string

Output only. Field value for custom question response, maximum number of characters is 70.

LocalServicesLead

Data from Local Services Lead. Contains details of Lead which is generated when user calls, messages or books service from advertiser. More info: https://ads.google.com/local-services-ads

JSON-представление 
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
Поля
resource Name

string

Output only. The resource name of the local services lead data. Local Services Lead resource name have the form

customers/{customerId}/localServicesLead/{local_services_lead_id}

id

string ( int64 format)

Output only. ID of this Lead.

category Id

string

Output only. Service category of the lead. For example: xcat:service_area_business_hvac , xcat:service_area_business_real_estate_agent , etc. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids

service Id

string

Output only. Service for the category. For example: buyer_agent , seller_agent for the category of xcat:service_area_business_real_estate_agent .

contact Details

object ( ContactDetails )

Output only. Lead's contact details.

lead Type

enum ( LeadType )

Output only. Type of Local Services lead: phone, message, booking, etc.

lead Status

enum ( LeadStatus )

Output only. Current status of lead.

creation Date Time

string

Output only. The date time at which lead was created by Local Services Ads. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

locale

string

Output only. Language used by the Local Services provider linked to lead. See https://developers.google.com/google-ads/api/data/codes-formats#locales

lead Charged

boolean

Output only. True if the advertiser was charged for the lead.

note

object ( Note )

Output only. Note added by advertiser for the lead.

credit Details

object ( CreditDetails )

Output only. Credit details of the lead.

ContactDetails

Fields containing consumer contact details.

JSON-представление 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
Поля
phone Number

string

Output only. Consumer phone number in E164 format.

email

string

Output only. Consumer email address.

consumer Name

string

Output only. Consumer name if consumer provided name from Message or Booking form on google.com

LeadType

Possible types of lead.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
MESSAGE Message lead.
PHONE_CALL Lead created by phone call.
BOOKING Booking lead.

LeadStatus

Possible statuses of lead.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
NEW New lead which hasn't yet been seen by advertiser.
ACTIVE Lead that thas been interacted by advertiser.
BOOKED Lead has been booked.
DECLINED Lead was declined by advertiser.
EXPIRED Lead has expired due to inactivity.
DISABLED Disabled due to spam or dispute.
CONSUMER_DECLINED Consumer declined the lead.
WIPED_OUT Personally Identifiable Information of the lead is wiped out.

Примечание

Represents a note added to a lead by the advertiser. Advertisers can edit notes, which will reset edit time and change description.

JSON-представление 
{
  "editDateTime": string,
  "description": string
}
Поля
edit Date Time

string

Output only. The date time when lead note was edited. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

description

string

Output only. Content of lead note.

CreditDetails

Represents the credit details of a lead.

JSON-представление 
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
Поля
credit State

enum ( CreditState )

Output only. Credit state of the lead.

credit State Last Update Date Time

string

Output only. The date time when the credit state of the lead was last updated. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

CreditState

Possible credit states of a lead.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
PENDING A credit has been filed and is being processed by Ads backend, but has not been applied to the account yet.
CREDITED The credit has been issued to the Ads account.

LocalServicesLeadConversation

Data from Local Services Lead Conversation. Contains details of Lead Conversation which is generated when user calls, messages or books service from advertiser. These are appended to a Lead. More info: https://ads.google.com/local-services-ads

JSON-представление 
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
Поля
resource Name

string

Output only. The resource name of the local services lead conversation data. Local Services Lead Conversation resource name have the form

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}

id

string ( int64 format)

Output only. ID of this Lead Conversation.

conversation Channel

enum ( ConversationType )

Output only. Type of GLS lead conversation, EMAIL, MESSAGE, PHONE_CALL, SMS, etc.

participant Type

enum ( ParticipantType )

Output only. Type of participant in the lead conversation, ADVERTISER or CONSUMER.

lead

string

Output only. Resource name of Lead associated to the Lead Conversation.

event Date Time

string

Output only. The date time at which lead conversation was created by Local Services Ads. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

phone Call Details

object ( PhoneCallDetails )

Output only. Details of phone call conversation in case of PHONE_CALL.

message Details

object ( MessageDetails )

Output only. Details of message conversation in case of EMAIL, MESSAGE or SMS.

ConversationType

Possible types of lead conversation.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
EMAIL Email lead conversation.
MESSAGE Message lead conversation.
PHONE_CALL Phone call lead conversation.
SMS SMS lead conversation.
BOOKING Booking lead conversation.

Тип участника

Possible types of lead conversation participant.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ADVERTISER Local Services Ads Provider participant.
CONSUMER Local Services Ads Consumer participant.

PhoneCallDetails

Represents details of a phone call conversation.

JSON-представление 
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
Поля
call Duration Millis

string ( int64 format)

Output only. The duration (in milliseconds) of the phone call (end to end).

call Recording Url

string

Output only. URL to the call recording audio file.

MessageDetails

Represents details of text message in case of email, message or SMS.

JSON-представление 
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
Поля
text

string

Output only. Textual content of the message.

attachment Urls[]

string

Output only. URL to the SMS or email attachments. These URLs can be used to download the contents of the attachment by using the developer token.

AndroidPrivacySharedKeyGoogleAdGroup

An Android privacy shared key view for Google ad group key.

JSON-представление 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
Поля
resource Name

string

Output only. The resource name of the Android privacy shared key. Android privacy shared key resource names have the form:

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaign Id

string ( int64 format)

Output only. The campaign ID used in the share key encoding.

android Privacy Interaction Type

enum ( AndroidPrivacyInteractionType )

Только вывод. The interaction type enum used in the share key encoding.

android Privacy Interaction Date

string

Output only. The interaction date used in the shared key encoding in the format of "YYYY-MM-DD" in UTC timezone.

android Privacy Network Type

enum ( AndroidPrivacyNetworkType )

Output only. The network type enum used in the share key encoding.

ad Group Id

string ( int64 format)

Output only. The ad group ID used in the share key encoding.

shared Ad Group Key

string

Output only. 128 bit hex string of the encoded shared ad group key, including a '0x' prefix. This key can be used to do a bitwise OR operator with the aggregate conversion key to create a full aggregation key to retrieve the Aggregate API Report in Android Privacy Sandbox.

AndroidPrivacyInteractionType

Enumerates interaction types

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
CLICK The physical click interaction type.
ENGAGED_VIEW The 10 seconds engaged view interaction type.
VIEW The view (ad impression) interaction type.

AndroidPrivacyNetworkType

Enumerates network types

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
SEARCH Search Network.
DISPLAY Display Network.
YOUTUBE YouTube Network.

AndroidPrivacySharedKeyGoogleCampaign

An Android privacy shared key view for Google campaign key.

JSON-представление 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
Поля
resource Name

string

Output only. The resource name of the Android privacy shared key. Android privacy shared key resource names have the form:

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaign Id

string ( int64 format)

Output only. The campaign ID used in the share key encoding.

android Privacy Interaction Type

enum ( AndroidPrivacyInteractionType )

Output only. The interaction type enum used in the share key encoding.

android Privacy Interaction Date

string

Output only. The interaction date used in the shared key encoding in the format of "YYYY-MM-DD" in UTC timezone.

shared Campaign Key

string

Output only. 128 bit hex string of the encoded shared campaign key, including a '0x' prefix. This key can be used to do a bitwise OR operator with the aggregate conversion key to create a full aggregation key to retrieve the Aggregate API Report in Android Privacy Sandbox.

AndroidPrivacySharedKeyGoogleNetworkType

An Android privacy shared key view for Google network type key.

JSON-представление 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
Поля
resource Name

string

Output only. The resource name of the Android privacy shared key. Android privacy shared key resource names have the form:

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaign Id

string ( int64 format)

Output only. The campaign ID used in the share key encoding.

android Privacy Interaction Type

enum ( AndroidPrivacyInteractionType )

Output only. The interaction type enum used in the share key encoding.

android Privacy Interaction Date

string

Output only. The interaction date used in the shared key encoding in the format of "YYYY-MM-DD" in UTC timezone.

android Privacy Network Type

enum ( AndroidPrivacyNetworkType )

Output only. The network type enum used in the share key encoding.

shared Network Type Key

string

Output only. 128 bit hex string of the encoded shared network type key, including a '0x' prefix. This key can be used to do a bitwise OR operator with the aggregate conversion key to create a full aggregation key to retrieve the Aggregate API Report in Android Privacy Sandbox.

Метрики

Metrics data.

JSON-представление 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": 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,
  "crossDeviceConversionsValueMicros": string,
  "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,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Поля
all Conversions Value By Conversion Date

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 .

all Conversions By Conversion Date

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 .

conversions Value By Conversion Date

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 .

conversions By Conversion Date

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 .

historical Creative Quality Score

enum ( QualityScoreBucket )

The creative historical quality score.

historical Landing Page Quality Score

enum ( QualityScoreBucket )

The quality of historical landing page experience.

historical Search Predicted Ctr

enum ( QualityScoreBucket )

The historical search predicted click through rate (CTR).

interaction Event Types[]

enum ( InteractionEventType )

The types of payable and free interactions.

sk Ad Network Installs

string ( int64 format)

The number of iOS Store Kit Ad Network conversions.

sk Ad Network Total Conversions

string ( int64 format)

The total number of iOS Store Kit Ad Network conversions.

publisher Purchased Clicks

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

publisher Organic Clicks

string ( int64 format)

Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity

publisher Unknown Clicks

string ( int64 format)

Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic"

absolute Top Impression Percentage

number

Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.

active View Cpm

number

Average cost of viewable impressions ( activeViewImpressions ).

active View Ctr

number

Active view measurable clicks divided by active view viewable impressions.

This metric is reported only for the Display Network.

active View Impressions

string ( int64 format)

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

active View Measurability

number

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

active View Measurable Cost Micros

string ( int64 format)

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

active View Measurable Impressions

string ( int64 format)

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

active View Viewability

number

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

all Conversions From Interactions Rate

number

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

all Conversions Value

number

The value of all conversions.

all New Customer Lifetime Value

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.

all Conversions

number

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

all Conversions Value Per Cost

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).

all Conversions From Click To Call

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.

all Conversions From Directions

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.

all Conversions From Interactions Value Per Interaction

number

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

all Conversions From Menu

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.

all Conversions From Order

number

The number of times people placed an order at a store after clicking an ad.

This metric applies to feed items only.

all Conversions From Other Engagement

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.

all Conversions From Store Visit

number

Estimated number of times people visited a store after clicking an ad.

This metric applies to feed items only.

all Conversions From Store Website

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.

auction Insight Search Absolute Top Impression Percentage

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.

auction Insight Search Impression Share

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.

auction Insight Search Outranking Share

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.

auction Insight Search Overlap Rate

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.

auction Insight Search Position Above Rate

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.

auction Insight Search Top Impression Percentage

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.

average Cost

number

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

average Cpc

number

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

average Cpe

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.

average Cpm

number

Average cost-per-thousand impressions (CPM).

average Cpv

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.

average Page Views

number

Average number of pages viewed per session.

average Time On Site

number

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

benchmark Average Max Cpc

number

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

biddable App Install Conversions

number

Number of app installs.

biddable App Post Install Conversions

number

Number of in-app actions.

benchmark Ctr

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.

bounce Rate

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.

combined Clicks

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.

combined Clicks Per Query

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.

combined Queries

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.

content Budget Lost Impression Share

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.

content Impression Share

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.

conversion Last Received Request Date Time

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.

conversion Last Conversion Date

string

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

content Rank Lost Impression Share

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.

conversions From Interactions Rate

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.

conversions Value

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.

new Customer Lifetime Value

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.

conversions Value Per Cost

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.

conversions From Interactions Value Per Interaction

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.

cost Micros

string ( int64 format)

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

cost Per All Conversions

number

The cost of ad interactions divided by all conversions.

cost Per Conversion

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.

cost Per Current Model Attributed Conversion

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.

cross Device Conversions

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.

cross Device Conversions Value Micros

string ( int64 format)

The sum of the value of cross-device conversions, in micros.

ctr

number

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

current Model Attributed Conversions

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.

current Model Attributed Conversions From Interactions Rate

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.

current Model Attributed Conversions From Interactions Value Per Interaction

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.

current Model Attributed Conversions Value

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.

current Model Attributed Conversions Value Per Cost

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.

engagement Rate

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.

hotel Average Lead Value Micros

number

Average lead value based on clicks.

hotel Commission Rate Micros

string ( int64 format)

Commission bid rate in micros. A 20% commission is represented as 200,000.

hotel Expected Commission Cost

number

Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency.

hotel Price Difference Percentage

number

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

hotel Eligible Impressions

string ( int64 format)

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

historical Quality Score

string ( int64 format)

The historical quality score.

gmail Forwards

string ( int64 format)

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

gmail Saves

string ( int64 format)

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

gmail Secondary Clicks

string ( int64 format)

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

impressions From Store Reach

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.

interaction Rate

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.

invalid Click Rate

number

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

invalid Clicks

string ( int64 format)

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

message Chats

string ( int64 format)

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

message Impressions

string ( int64 format)

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

message Chat Rate

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.

mobile Friendly Clicks Percentage

number

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

optimization Score Uplift

number

Total optimization score uplift of all recommendations.

optimization Score Url

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.

organic Clicks

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.

organic Clicks Per Query

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.

organic Impressions

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.

organic Impressions Per Query

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.

organic Queries

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.

percent New Visitors

number

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

phone Calls

string ( int64 format)

Number of offline phone calls.

phone Impressions

string ( int64 format)

Number of offline phone impressions.

phone Through Rate

number

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

relative Ctr

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.

search Absolute Top Impression Share

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.

search Budget Lost Absolute Top Impression Share

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.

search Budget Lost Impression Share

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.

search Budget Lost Top Impression Share

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.

search Click Share

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.

search Exact Match Impression Share

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.

search Impression Share

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.

search Rank Lost Absolute Top Impression Share

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.

search Rank Lost Impression Share

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.

search Rank Lost Top Impression Share

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.

search Top Impression Share

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.

search Volume

object ( SearchVolumeRange )

Search volume range for a search term insight category.

speed Score

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.

average Target Cpa Micros

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).

average Target Roas

number

The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS).

top Impression Percentage

number

The percent of your ad impressions that are shown adjacent to the top organic search results.

valid Accelerated Mobile Pages Clicks Percentage

number

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

value Per All Conversions

number

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

value Per All Conversions By Conversion Date

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 .

value Per Conversion

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.

value Per Conversions By Conversion Date

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 .

value Per Current Model Attributed Conversion

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.

video Quartile P100 Rate

number

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

video Quartile P25 Rate

number

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

video Quartile P50 Rate

number

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

video Quartile P75 Rate

number

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

video View Rate

number

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

video Views

string ( int64 format)

The number of times your video ads were viewed.

view Through Conversions

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.

all Conversions From Location Asset Click To Call

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.

all Conversions From Location Asset Directions

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.

all Conversions From Location Asset Menu

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.

all Conversions From Location Asset Order

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.

all Conversions From Location Asset Other Engagement

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.

all Conversions From Location Asset Store Visits

number

Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location.

all Conversions From Location Asset Website

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.

eligible Impressions From Location Asset Store Reach

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.

view Through Conversions From Location Asset Click To Call

number

Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location.

view Through Conversions From Location Asset Directions

number

Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location.

view Through Conversions From Location Asset Menu

number

Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location.

view Through Conversions From Location Asset Order

number

Number of order clicks on any location surface after an impression. This measure is coming from Asset based location.

view Through Conversions From Location Asset Other Engagement

number

Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location.

view Through Conversions From Location Asset Store Visits

number

Estimated number of visits to the store after an impression. This measure is coming from Asset based location.

view Through Conversions From Location Asset Website

number

Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location.

orders

number

Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data.

average Order Value Micros

string ( int64 format)

Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data.

average Cart Size

number

Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data.

cost Of Goods Sold Micros

string ( int64 format)

Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data.

gross Profit Micros

string ( int64 format)

Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data.

gross Profit Margin

number

Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data.

revenue Micros

string ( int64 format)

Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data.

units Sold

number

Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data.

cross Sell Cost Of Goods Sold Micros

string ( int64 format)

Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data.

cross Sell Gross Profit Micros

string ( int64 format)

Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data.

cross Sell Revenue Micros

string ( int64 format)

Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data.

cross Sell Units Sold

number

Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.

lead Cost Of Goods Sold Micros

string ( int64 format)

Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data.

lead Gross Profit Micros

string ( int64 format)

Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data.

lead Revenue Micros

string ( int64 format)

Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data.

lead Units Sold

number

Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.

unique Users

string ( int64 format)

The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

average Impression Frequency Per User

number

The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

InteractionEventType

Enum describing possible types of payable and free interactions.

Перечисления
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-представление 
{
  "min": string,
  "max": string
}
Поля
min

string ( int64 format)

Lower bound of search volume.

max

string ( int64 format)

Upper bound of search volume.

Сегменты

Segment only fields.

JSON-представление 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": 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,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": 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)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Поля
ad Destination Type

enum ( AdDestinationType )

Ad Destination type.

ad Network Type

enum ( AdNetworkType )

Ad network type.

budget Campaign Association Status

object ( BudgetCampaignAssociationStatus )

Budget campaign association status.

click Type

enum ( ClickType )

Click type.

conversion Action Category

enum ( ConversionActionCategory )

Conversion action category.

conversion Attribution Event Type

enum ( ConversionAttributionEventType )

Conversion attribution event type.

conversion Lag Bucket

enum ( ConversionLagBucket )

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

conversion Or Adjustment Lag Bucket

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.

day Of Week

enum ( DayOfWeek )

Day of the week, for example, MONDAY.

device

enum ( Device )

Device to which metrics apply.

external Conversion Source

enum ( ExternalConversionSource )

External conversion source.

hotel Check In Day Of Week

enum ( DayOfWeek )

Hotel check-in day of week.

hotel Date Selection Type

enum ( HotelDateSelectionType )

Hotel date selection type.

hotel Rate Type

enum ( HotelRateType )

Hotel rate type.

hotel Price Bucket

enum ( HotelPriceBucket )

Hotel price bucket.

keyword

object ( Keyword )

Keyword criterion.

month Of Year

enum ( MonthOfYear )

Month of the year, for example, January.

placeholder Type

enum ( PlaceholderType )

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

product Channel

enum ( ProductChannel )

Channel of the product.

product Channel Exclusivity

enum ( ProductChannelExclusivity )

Channel exclusivity of the product.

product Condition

enum ( ProductCondition )

Condition of the product.

recommendation Type

enum ( RecommendationType )

Recommendation type.

search Engine Results Page Type

enum ( SearchEngineResultsPageType )

Type of the search engine results page.

search Term Match Type

enum ( SearchTermMatchType )

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

slot

enum ( Slot )

Position of the ad.

conversion Value Rule Primary Dimension

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.

sk Ad Network User Type

enum ( SkAdNetworkUserType )

iOS Store Kit Ad Network user type.

sk Ad Network Ad Event Type

enum ( SkAdNetworkAdEventType )

iOS Store Kit Ad Network ad event type.

sk Ad Network Attribution Credit

enum ( SkAdNetworkAttributionCredit )

iOS Store Kit Ad Network attribution credit

sk Ad Network Coarse Conversion Value

enum ( SkAdNetworkCoarseConversionValue )

iOS Store Kit Ad Network coarse conversion value.

sk Ad Network Source Type

enum ( SkAdNetworkSourceType )

The source type 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 neither source domain nor source app were present in any postbacks sent by Apple.

new Versus Returning Customers

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.

activity Account Id

string ( int64 format)

Activity account ID.

activity City

string

The city where the travel activity is available.

activity Country

string

The country where the travel activity is available.

activity Rating

string ( int64 format)

Activity rating.

activity State

string

The state where the travel activity is available.

external Activity Id

string

Advertiser supplied activity ID.

ad Group

string

Resource name of the ad group.

asset Group

string

Resource name of the asset group.

auction Insight Domain

string

Domain (visible URL) of a participant in the Auction Insights report.

campaign

string

Resource name of the campaign.

conversion Action

string

Resource name of the conversion action.

conversion Action Name

string

Conversion action name.

conversion Adjustment

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.

geo Target Airport

string

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

geo Target Canton

string

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

geo Target City

string

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

geo Target Country

string

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

geo Target County

string

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

geo Target District

string

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

geo Target Metro

string

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

geo Target Most Specific Location

string

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

geo Target Postal Code

string

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

geo Target Province

string

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

geo Target Region

string

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

geo Target State

string

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

hotel Booking Window Days

string ( int64 format)

Hotel booking window in days.

hotel Center Id

string ( int64 format)

Hotel center ID.

hotel Check In Date

string

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

hotel City

string

Hotel city.

hotel Class

integer

Hotel class.

hotel Country

string

Hotel country.

hotel Length Of Stay

integer

Hotel length of stay.

hotel Rate Rule Id

string

Hotel rate rule ID.

hotel State

string

Hotel state.

hour

integer

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

interaction On This Extension

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.

partner Hotel Id

string

Partner hotel ID.

product Aggregator Id

string ( int64 format)

Aggregator ID of the product.

product Category Level1

string

Category (level 1) of the product.

product Category Level2

string

Category (level 2) of the product.

product Category Level3

string

Category (level 3) of the product.

product Category Level4

string

Category (level 4) of the product.

product Category Level5

string

Category (level 5) of the product.

product Brand

string

Brand of the product.

product Country

string

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

product Custom Attribute0

string

Custom attribute 0 of the product.

product Custom Attribute1

string

Custom attribute 1 of the product.

product Custom Attribute2

string

Custom attribute 2 of the product.

product Custom Attribute3

string

Custom attribute 3 of the product.

product Custom Attribute4

string

Custom attribute 4 of the product.

product Feed Label

string

Feed label of the product.

product Item Id

string

Item ID of the product.

product Language

string

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

product Merchant Id

string ( int64 format)

Merchant ID of the product.

product Store Id

string

Store ID of the product.

product Title

string

Title of the product.

product Type L1

string

Type (level 1) of the product.

product Type L2

string

Type (level 2) of the product.

product Type L3

string

Type (level 3) of the product.

product Type L4

string

Type (level 4) of the product.

product Type L5

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.

search Subcategory

string

A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory.

search Term

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.

sk Ad Network Conversion Value

string ( int64 format)

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

sk Ad Network Source App

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.

sk Ad Network Source Domain

string

Website 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.

sk Ad Network Postback Sequence Index

string ( int64 format)

iOS Store Kit Ad Network postback sequence index.

asset Interaction Target

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

Перечисления
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 Ютуб
UNMODELED_FOR_CONVERSIONS Ad Destination for Conversions with keys unknown

AdNetworkType

Enumerates Google Ads network types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
SEARCH Google search.
SEARCH_PARTNERS Search partners.
CONTENT Display Network.
MIXED Cross-network.
YOUTUBE Ютуб
GOOGLE_TV Гугл ТВ

BudgetCampaignAssociationStatus

A BudgetCampaignAssociationStatus segment.

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

enum ( BudgetCampaignAssociationStatus )

Budget campaign association status.

campaign

string

The campaign resource name.

BudgetCampaignAssociationStatus

Possible statuses of the association between the Budget and the Campaign.

Перечисления
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.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
BREADCRUMBS Панировочные сухари.
BROADBAND_PLAN Broadband Plan.
CALL_TRACKING Manually dialed phone calls.
CALLS Phone calls.
CLICK_ON_ENGAGEMENT_AD Click on engagement ad.
GET_DIRECTIONS Driving direction.
LOCATION_EXPANSION Get location details.
LOCATION_FORMAT_CALL Вызов.
LOCATION_FORMAT_DIRECTIONS Направления.
LOCATION_FORMAT_IMAGE Image(s).
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 Распечатать предложение.
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 App store.
VIDEO_CALL_TO_ACTION_CLICKS Call-to-Action overlay.
VIDEO_CARD_ACTION_HEADLINE_CLICKS Карты.
VIDEO_END_CAP_CLICKS End cap.
VIDEO_WEBSITE_CLICKS Веб-сайт.
WIRELESS_PLAN Wireless Plan.
PRODUCT_LISTING_AD_LOCAL Shopping - Product - Local.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL Shopping - Product - MultiChannel Local.
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE Shopping - Product - MultiChannel Online.
PRODUCT_LISTING_ADS_COUPON Shopping - Product - Coupon.
PRODUCT_LISTING_AD_TRANSACTABLE Shopping - Product - Sell on Google.
PROMOTION_EXTENSION Promotion Extension.
HOTEL_PRICE Hotel price.
PRICE_EXTENSION Price Extension.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Book on Google hotel room selection.
SHOPPING_COMPARISON_LISTING Shopping - Comparison Listing.
CROSS_NETWORK Cross-network. From Performance Max and Discovery Campaigns.

ConversionAttributionEventType

The event type of conversions that are attributed to.

Перечисления
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.

Перечисления
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.

Перечисления
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.

Перечисления
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.

Перечисления
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.

Перечисления
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-представление 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Поля
info

object ( KeywordInfo )

Keyword info.

ad Group Criterion

string

The AdGroupCriterion resource name.

SearchEngineResultsPageType

The type of the search engine results page.

Перечисления
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.

Перечисления
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.

Перечисления
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.

Перечисления
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

Перечисления
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

Перечисления
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-представление 
{
  "skAdNetworkSourceAppId": string
}
Поля
sk Ad Network Source App Id

string

App id where the ad that drove the iOS Store Kit Ad Network install was shown.

SkAdNetworkAttributionCredit

Enumerates SkAdNetwork attribution credits.

Перечисления
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.

SkAdNetworkSourceType

Enumerates SkAdNetwork source types

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
UNAVAILABLE The source app ID or source domain was not present in the postback or we do not have this data for other reasons.
WEBSITE The ad was shown on a webpage.
MOBILE_APPLICATION The ad was shown on an app.

AssetInteractionTarget

An AssetInteractionTarget segment.

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

string

The asset resource name.

interaction On This Asset

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

Перечисления
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.