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