- JSON-представление
- АккаунтБюджет
- Статус бюджета аккаунта
- Ожидается предложение по бюджету аккаунта
- Группа объявленийAdAssetCombinationView
- Использование активов
- Группа объявленийAdAssetView
- AdGroupAdAssetPolicySummary
- Группа объявленийАудиторияView
- AdGroupCriterionМоделирование
- Тип моделирования
- Метод Модификации Симуляции
- Цена за кликBidSimulationPointList
- Цена за кликBidSimulationPoint
- ПроцентCpcBidSimulationPointList
- ПроцентCpcBidSimulationPoint
- AdGroupСимуляторы
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- Возрастной диапазонПросмотр
- AdScheduleView
- ДоменКатегория
- Ассетфилдтипевиев
- КаналАгрегатеАсетвиев
- CampaignAggregateAssetView
- AssetGroupProductGroupView
- Ассетгрупптопкомбинатионвиев
- AssetGroupAssetCombinationData
- Ассетсеттипипвиев
- Стратегия торговСимуляторы
- CallView
- Отслеживание вызововОтображениеМестоположение
- Тип вызова
- Статус GoogleVoiceCall
- КампанияАудиторияПросмотр
- КампанияПоискТерминInsight
- КампанияСимуляторы
- TargetImpressionShareSimulationPointList
- TargetImpressionShareSimulationPoint
- Список бюджетных симуляцийPointList
- BudgetSimulationPoint
- ПеревозчикКонстанта
- Изменениесобытия
- Чанжевентресаурцетипе
- Чейнджклиенттипе
- ИзмененныйРесурс
- РесурсЧанжеОперация
- Изменить статус
- Чангестатусресаурцетипе
- ChangeStatusOperation
- Комбинированная аудитория
- Комбинированный статус аудитории
- НажмитеПросмотреть
- НажмитеМестоположение
- ВалютаКонстанта
- Доступная стратегия ставок
- Максимизироватьконверсионвалуе
- Максимизация конверсий
- Целевая цена за конверсию
- Целевая доля показов
- Целевая рентабельность инвестиций в рекламу
- Целевые расходы
- КлиентКлиент
- CustomerSearchTermInsight
- ПодробноРазмещениеПросмотр
- Тип размещения
- ПодробныйДемографический
- КритерийКатегорияДоступность
- КритерийКатегорияКаналДоступность
- КритерийКатегорияКаналДоступностьРежим
- КритерийКатегорияЛокальный стандартДоступность
- КритерийКатегорияLocaleAvailabilityMode
- ДисплейКлючевое словоView
- РасстояниеПросмотр
- РасстояниеВедро
- ДинамическийSearchAdsSearchTermView
- Расширенное представление целевой страницы
- FeedPlaceholderView
- ПолПросмотр
- Географический просмотр
- Тип геотаргетинга
- ГруппаРазмещениеПросмотр
- ОтельГруппаВид
- ОтельПроизводительностьПросмотр
- ОтельПримирение
- ОтельСогласованиеСтатус
- ДоходДиапазонView
- Просмотр ключевых слов
- Целевая страницаView
- ЯзыкКонстанта
- МестоположениеПросмотр
- Управляемое размещениеView
- Медиафайл
- Медиатип
- Медиаизображение
- МедиаБундл
- МедиаАудио
- МедиаВидео
- ЛокальныеУслугиСотрудник
- LocalServicesEmployeeStatus
- LocalServicesEmployeeType
- Высшее образование
- Резидентура
- Стипендия
- LocalServicesVerificationArtifact
- LocalServicesVerificationArtifactStatus
- LocalServicesVerificationArtifactType
- ФонПроверкаПроверкаАртефакт
- СтрахованиеПроверкаАртефакт
- LocalServicesInsuranceRejectionReason
- LocalServicesDocumentReadOnly
- ЛицензияПроверкаАртефакт
- LocalServicesLicenseRejectionReason
- БизнесРегистрацияПроверкаПроверкаАртефакт
- LocalServicesBusinessRegistrationType
- LocalServicesBusinessRegistrationCheckRejectionReason
- Номер регистрации бизнеса
- БизнесРегистрацияДокумент
- MobileAppCategoryКонстанта
- MobileDeviceConstant
- Тип мобильного устройства
- OfflineConversionUploadClientSummary
- Оффлайневентуплоадклиент
- OfflineConversionDiagnosticStatus
- Сводка по офлайн-конверсиям
- ОффлайнКонверсияАлерт
- OfflineConversionError
- КоллекцияSizeError
- ConversionAdjustmentUploadError
- Ошибка конверсииUploadError
- ДатаОшибка
- DistinctError
- ПолеError
- мутатеррор
- Ноталловлистедеррор
- СтрингФорматОррор
- StringLengthError
- Константа версии операционной системы
- ОперационнаяСистемаВерсияОператорТип
- ПлатныйОрганическийПоискTermView
- УточняющийВопрос
- РодительскийстатусView
- Персторевиев
- Категория продуктаКонстанта
- СостояниеКатегорииПродукта
- Категория продуктаЛокализация
- Просмотр группы продуктов
- Поисктермвиев
- Статус SearchTermTargetingStatus
- ПокупкиПроизводительностьПросмотр
- ПокупкиПродукт
- Доступность продукта
- Статус продукта
- Проблема с продуктом
- ПродуктПроблемаСерьезность
- SmartCampaignSearchTermView
- ThirdPartyAppAnalyticsLink
- Просмотр темы
- ПутешествияДеятельностьГруппаПросмотр
- ПутешествияДеятельностьПроизводительностьПросмотр
- Интерес пользователя
- UserInterestTaxonomyType
- Случай из жизни
- Пользовательское местоположениевиев
- ТемаПостоянная
- видео
- Просмотр веб-страницы
- Лидформсумбиссиондата
- Поле LeadFormSubmissionField
- CustomLeadFormSubmissionField
- Руководитель отдела местных услуг
- Контактная информация
- Тип лида
- Лидстатус
- Примечание
- Кредитная информация
- Кредитное состояние
- LocalServicesLeadConversation
- Тип разговора
- Тип участника
- ТелефонЗвонокДетали
- Подробности сообщения
- AndroidPrivacySharedKeyGoogleAdGroup
- AndroidPrivacyInteractionType
- AndroidКонфиденциальностьNetworkType
- AndroidPrivacySharedKeyGoogleCampaign
- AndroidPrivacySharedKeyGoogleNetworkType
- Метрики
- Тип события взаимодействия
- Диапазон поискаVolumeRange
- Сегменты
- Тип назначения объявления
- тип рекламной сети
- Статус бюджетной кампанииAssociation
- Статус бюджетной кампанииAssociation
- Тип клика
- ТипСобытияАтрибуции Конверсии
- КонверсияLagBucket
- КонверсияOrAdjustmentLagBucket
- Экстерналконверсионсаурце
- ОтельТипЦена
- ОтельЦенаВедро
- Ключевое слово
- Тип страницы результатов поиска
- SearchTermMatchType
- Слот
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- Скаднетворкадевенттипе
- SkAdNetworkSourceApp
- SkAdNetworkAttributionCredit
- SkAdNetworkSourceType
- Цель взаимодействия активов
- ПреобразованиеUserPriorEngagementTypeAndLtvBucket
Возвращенная строка из запроса.
JSON-представление |
---|
{ "accountBudget": { object ( |
Поля | |
---|---|
accountBudget | Бюджет аккаунта в запросе. |
accountBudgetProposal | Предложение по бюджету аккаунта, указанное в запросе. |
accountLink | AccountLink, указанный в запросе. |
ad | Объявление, указанное в запросе. |
adGroup | Группа объявлений, указанная в запросе. |
adGroupAd | Объявление, указанное в запросе. |
adGroupAdAssetCombinationView | Представление комбинации рекламных объектов группы объявлений в запросе. |
adGroupAdAssetView | Представление рекламного объекта группы объявлений в запросе. |
adGroupAdLabel | Ярлык объявления группы объявлений, указанный в запросе. |
adGroupAsset | Объект группы объявлений, указанный в запросе. |
adGroupAssetSet | Набор объектов группы объявлений, указанный в запросе. |
adGroupAudienceView | Представление аудитории группы объявлений, указанное в запросе. |
adGroupBidModifier | Модификатор ставки, указанный в запросе. |
adGroupCriterion | Критерий, указанный в запросе. |
adGroupCriterionCustomizer | Модификатор критерия группы объявлений, указанный в запросе. |
adGroupCriterionLabel | Метка критерия группы объявлений, указанная в запросе. |
adGroupCriterionSimulation | Моделирование критерия группы объявлений, указанное в запросе. |
adGroupCustomizer | Модификатор группы объявлений, указанный в запросе. |
adGroupExtensionSetting | Настройка расширения группы объявлений, указанная в запросе. |
adGroupFeed | Фид группы объявлений, указанный в запросе. |
adGroupLabel | Ярлык группы объявлений, указанный в запросе. |
adGroupSimulation | Моделирование группы объявлений, указанное в запросе. |
adParameter | Параметр объявления, указанный в запросе. |
ageRangeView | Представление возрастного диапазона, указанное в запросе. |
adScheduleView | Представление расписания показа объявлений, указанное в запросе. |
domainCategory | Категория домена, указанная в запросе. |
asset | Актив, указанный в запросе. |
assetFieldTypeView | Представление типа поля актива, указанное в запросе. |
channelAggregateAssetView | Представление совокупного ресурса канала, указанное в запросе. |
campaignAggregateAssetView | Представление совокупных активов кампании, указанное в запросе. |
assetGroupAsset | Актив группы активов, указанный в запросе. |
assetGroupSignal | Сигнал группы активов, указанный в запросе. |
assetGroupListingGroupFilter | Фильтр группы списков групп активов, на который ссылается запрос. |
assetGroupProductGroupView | Представление группы продуктов группы активов, указанное в запросе. |
assetGroupTopCombinationView | Представление верхней комбинации группы активов, указанное в запросе. |
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 | Ярлык кампании, указанный в запросе. |
campaignLifecycleGoal | Цель жизненного цикла кампании, указанная в запросе. |
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 | Ярлык клиента, указанный в запросе. |
customerLifecycleGoal | Цель жизненного цикла клиента, указанная в запросе. |
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 | Медиа-файл, указанный в запросе. |
localServicesEmployee | Сотрудник местной службы, указанный в запросе. |
localServicesVerificationArtifact | Артефакт проверки локальных служб, указанный в запросе. |
mobileAppCategoryConstant | Константа категории мобильного приложения, указанная в запросе. |
mobileDeviceConstant | Константа мобильного устройства, указанная в запросе. |
offlineConversionUploadClientSummary | Сводная информация клиента загрузки офлайн-конверсий. |
offlineUserDataJob | Автономное задание пользовательских данных, указанное в запросе. |
operatingSystemVersionConstant | Константа версии операционной системы, указанная в запросе. |
paidOrganicSearchTermView | Просмотр платного обычного поискового запроса, на который ссылается запрос. |
qualifyingQuestion | Уточняющий вопрос, указанный в запросе. |
parentalStatusView | Представление родительского статуса, указанное в запросе. |
perStoreView | Представление каждого магазина, указанное в запросе. |
productCategoryConstant | Категория продукта, указанная в запросе. |
productGroupView | Представление группы продуктов, указанное в запросе. |
productLink | Ссылка на продукт, указанная в запросе. |
productLinkInvitation | Приглашение со ссылкой на продукт в запросе. |
recommendation | Рекомендация, указанная в запросе. |
recommendationSubscription | Подписка на рекомендации, указанная в запросе. |
searchTermView | Представление поискового запроса, указанное в запросе. |
sharedCriterion | Общий набор, указанный в запросе. |
sharedSet | Общий набор, указанный в запросе. |
smartCampaignSetting | Настройка умной кампании, указанная в запросе. |
shoppingPerformanceView | Представление эффективности покупок, указанное в запросе. |
shoppingProduct | Товар для покупок, указанный в запросе. |
smartCampaignSearchTermView | Представление поискового запроса умной кампании, указанное в запросе. |
thirdPartyAppAnalyticsLink | AccountLink, указанный в запросе. |
topicView | Представление темы, указанное в запросе. |
travelActivityGroupView | Представление группы туристических операций, указанное в запросе. |
travelActivityPerformanceView | Представление эффективности поездок, указанное в запросе. |
experiment | Эксперимент, указанный в запросе. |
experimentArm | Группа эксперимента, указанная в запросе. |
userInterest | Интерес пользователя, указанный в запросе. |
lifeEvent | Жизненное событие, указанное в запросе. |
userList | Список пользователей, на который ссылается запрос. |
userListCustomerType | Тип клиента списка пользователей в запросе. |
userLocationView | Представление местоположения пользователя, указанное в запросе. |
remarketingAction | Действие ремаркетинга, указанное в запросе. |
topicConstant | Константа темы, на которую ссылается запрос. |
video | Видео, указанное в запросе. |
webpageView | Представление веб-страницы, указанное в запросе. |
leadFormSubmissionData | Представление пользователя формы для потенциальных клиентов, указанное в запросе. |
localServicesLead | Руководитель местных служб, указанный в запросе. |
localServicesLeadConversation | Местные службы ведут диалог, указанный в запросе. |
androidPrivacySharedKeyGoogleAdGroup | Группа объявлений Google с общим ключом конфиденциальности Android, указанная в запросе. |
androidPrivacySharedKeyGoogleCampaign | Кампания Google с общим ключом конфиденциальности Android, упомянутая в запросе. |
androidPrivacySharedKeyGoogleNetworkType | Тип сети Google общего ключа конфиденциальности Android, указанный в запросе. |
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 | Только вывод. Закрепленное поле. |
source | Только вывод. Источник рекламного объекта группы объявлений. |
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. |
CpcBidSimulationPointList
Контейнер для точек моделирования для моделирования типа 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, "interactions": string, // Union field |
Поля | |
---|---|
requiredBudgetAmountMicros | Прогнозируемый необходимый дневной бюджет, который рекламодатель должен установить для получения расчетного трафика, в микро валютах рекламодателя. |
appInstalls | Прогнозируемое количество установок приложения. |
inAppActions | Прогнозируемое количество действий в приложении. |
biddableConversions | Прогнозируемое количество конверсий, доступных для назначения ставок. |
biddableConversionsValue | Прогнозируемая общая ценность конверсий, доступных для назначения ставок. |
clicks | Прогнозируемое количество кликов. |
costMicros | Ориентировочная стоимость в микронах. |
impressions | Прогнозируемое количество показов. |
topSlotImpressions | Прогнозируемое количество показов на верхних позициях. Это поле поддерживается только для типа канала поисковой рекламы. |
interactions | Прогнозируемое количество взаимодействий. Это поле поддерживается только для типа рекламного канала Discovery. |
Поле объединения 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[] | Прогнозируемые показатели для ряда целевых значений рентабельности инвестиций в рекламу. |
TargetRoasSimulationPoint
Прогнозируемые показатели для определенной целевой рентабельности инвестиций в рекламу.
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 | Прогнозируемое количество показов на верхних позициях. Это поле поддерживается только для типа канала поисковой рекламы. |
Возрастной диапазонПросмотр
Представление о возрастном диапазоне.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют вид: |
AdScheduleView
Представление расписания показа объявлений суммирует эффективность кампаний по критериям AdSchedule.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса представления расписания показа объявлений. Имена ресурсов представления AdSchedule имеют следующий вид: |
ДоменКатегория
Категория, создаваемая автоматически при сканировании домена. Если в кампании используется параметр DynamicSearchAdsSetting, для домена будут созданы категории домена. Категории можно настроить с помощью WebpageConditionInfo. См.: https://support.google.com/google-ads/answer/2471185 .
JSON-представление |
---|
{ "resourceName": string, "campaign": string, "category": string, "languageCode": string, "domain": string, "coverageFraction": number, "categoryRank": string, "hasChildren": boolean, "recommendedCpcBidMicros": string } |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса категории домена. Имена ресурсов категории домена имеют вид: |
campaign | Только вывод. Кампания, для которой рекомендуется данная категория. |
category | Только вывод. Рекомендуемая категория для домена веб-сайта. Например, если у вас есть сайт, посвященный электронике, категориями могут быть «камеры», «телевизоры» и т. д. |
languageCode | Только вывод. Код языка, определяющий язык веб-сайта, например «en» для английского языка. Язык можно указать в настройке DynamicSearchAdsSetting, необходимой для динамических поисковых объявлений. Это язык страниц вашего веб-сайта, на которых Google Реклама должна находить, создавать для них рекламу и сопоставлять результаты поиска. |
domain | Только вывод. Домен для сайта. Домен можно указать в настройке DynamicSearchAdsSetting, необходимой для динамических поисковых объявлений. |
coverageFraction | Только вывод. Доля страниц вашего сайта, соответствующих этой категории. |
categoryRank | Только вывод. Положение этой категории в множестве категорий. Меньшие числа указывают на лучшее соответствие домену. ноль означает, что не рекомендуется. |
hasChildren | Только вывод. Указывает, есть ли у этой категории подкатегории. |
recommendedCpcBidMicros | Только вывод. Рекомендуемая цена за клик для категории. |
Ассетфилдтипевиев
Представление типа поля актива. В этом представлении отображаются непересчитанные показатели для каждого типа поля актива, когда актив используется в качестве расширения.
JSON-представление |
---|
{
"resourceName": string,
"fieldType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса представления типа поля актива. Имена ресурсов представления типа поля актива имеют форму: |
fieldType | Только вывод. Тип поля актива в представлении типа поля актива. |
КаналАгрегатеАсетвиев
Совокупное представление активов на уровне канала, которое показывает, где связан актив, его производительность и статистику.
JSON-представление |
---|
{ "resourceName": string, "advertisingChannelType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса представления совокупного ресурса канала. Имена ресурсов представления совокупных активов канала имеют форму: |
advertisingChannelType | Только вывод. Канал, в котором обслуживался объект. |
asset | Только вывод. Идентификатор актива. |
assetSource | Только вывод. Источник ссылки на актив. |
fieldType | Только вывод. FieldType актива. |
CampaignAggregateAssetView
Совокупное представление на уровне кампании, которое показывает, где связан актив, исполняется актива и статистика.
JSON-представление |
---|
{ "resourceName": string, "campaign": string, "asset": string, "assetSource": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса агрегированной активы. Кампания агрегатная актива имена ресурсов имеют форму: |
campaign | Только вывод. Кампания, в которой послужил актив. |
asset | Только вывод. Идентификатор актива. |
assetSource | Только вывод. Источник ссылки активов. |
fieldType | Только вывод. FieldType актива. |
AssetGroupproductGroupView
Активная группа продукта группы.
JSON-представление |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": string } |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса представления группы продуктов Acset Group. Группа Asset Group Product Group Имена ресурсов имеют форму: |
assetGroup | Только вывод. Группа активов, связанная с фильтром группы листинга. |
assetGroupListingGroupFilter | Только вывод. Название ресурса группы листинга групп активов. |
AssetGrouptOpCombinationView
Взгляд на использование комбинации активов AD Group AD.
JSON-представление |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса в высшей комбинации группы активов. AssetGroup Top Comminate View Имена ресурсов есть форма: `" Clifits/{customer}/assetGrouptopCombinationViews/{asset_group_id} ~ {asset_combination_category} " |
assetGroupTopCombinations[] | Только вывод. Лучшие комбинации активов, которые служили вместе. |
AssetGroupasSetCombinationData
Данные комбинации активов группы активов
JSON-представление |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Поля | |
---|---|
assetCombinationServedAssets[] | Только вывод. Обслуживали активы. |
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, "interactions": string } |
Поля | |
---|---|
budgetAmountMicros | Моделируемый бюджет, на котором основаны прогнозируемые метрики. |
requiredCpcBidCeilingMicros | Прогнозируется, требуется ежедневный потолок ставок CPC, который рекламодатель должен установить для реализации этого моделирования в микросхемах валюты рекламодателя. Только кампании с целевой стратегией расходов на стратегию ставок поддерживают эту область. |
biddableConversions | Прогнозируемое количество преобразований. |
biddableConversionsValue | Прогнозируемая общая стоимость преобразования. |
clicks | Прогнозируемое количество кликов. |
costMicros | Прогнозируемая стоимость в микросхеме. |
impressions | Прогнозируемое количество впечатлений. |
topSlotImpressions | Прогнозируемое количество в верхних слотных впечатлениях. Только поисковый рекламный тип канала поддерживает это поле. |
interactions | Прогнозируемое количество взаимодействий. Только тип рекламного канала Discovery поддерживает это поле. |
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. |
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION | Изменения, внесенные путем подписки на рекомендации Google Ads. |
Изменился
Прото, представляющий все поддерживаемые ресурсы. Будет установлен только ресурс 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 | Удаленный статус - комбинированная аудитория удаляется и не может использоваться для таргетинга. |
ClickView
Просмотр щелчка с метриками, агрегированными на каждом уровне клика, включая как действительные, так и недействительные клики. Для несовместимых кампаний 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 | Только вывод. Имя ресурса представления ключевого слова отображения. Отображать ключевые слова имена ресурсов есть форма: |
Расстояние
Просмотр расстояния с метриками, агрегированным по расстоянию пользователя от расширений местоположения рекламодателя. Каждое расстояние, включающее все впечатления, которые находятся в пределах его расстояния, и одно впечатление будет способствовать показателям для всех расстояний, которые включают расстояние пользователя.
JSON-представление |
---|
{
"resourceName": string,
"distanceBucket": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса вида расстояния. Имена ресурсов на расстоянии имеют форму: |
distanceBucket | Только вывод. Группирование пользовательского расстояния от расширений местоположения. |
metricSystem | Только вывод. Правда, если DistanceBucket использует метрическую систему, в противном случае неверно. |
DistanceBucket
Расстояние ведра для расстояния пользователя от расширения местоположения рекламодателя.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
WITHIN_700M | Пользователь находился в пределах 700 м от места. |
WITHIN_1KM | Пользователь находился в пределах 1 км от места. |
WITHIN_5KM | Пользователь находился в пределах 5 км от места. |
WITHIN_10KM | Пользователь находился в пределах 10 км от места. |
WITHIN_15KM | Пользователь находился в пределах 15 км от места. |
WITHIN_20KM | Пользователь находился в пределах 20 км от места. |
WITHIN_25KM | Пользователь находился в пределах 25 км от места. |
WITHIN_30KM | Пользователь находился в пределах 30 км от места. |
WITHIN_35KM | Пользователь находился в пределах 35 км от места. |
WITHIN_40KM | Пользователь находился в пределах 40 км от места. |
WITHIN_45KM | Пользователь находился в пределах 45 км от места. |
WITHIN_50KM | Пользователь находился в пределах 50 км от места. |
WITHIN_55KM | Пользователь находился в пределах 55 км от места. |
WITHIN_60KM | Пользователь находился в пределах 60 км от места. |
WITHIN_65KM | Пользователь находился в пределах 65 км от места. |
BEYOND_65KM | Пользователь был за пределами 65 км местоположения. |
WITHIN_0_7MILES | Пользователь находился в пределах 0,7 миль от места. |
WITHIN_1MILE | Пользователь находился в пределах 1 мили от места. |
WITHIN_5MILES | Пользователь находился в пределах 5 миль от места. |
WITHIN_10MILES | Пользователь находился в пределах 10 миль от места. |
WITHIN_15MILES | Пользователь находился в пределах 15 миль от места. |
WITHIN_20MILES | Пользователь находился в пределах 20 миль от места. |
WITHIN_25MILES | Пользователь находился в пределах 25 миль от места. |
WITHIN_30MILES | Пользователь находился в пределах 30 миль от места. |
WITHIN_35MILES | Пользователь находился в пределах 35 миль от места. |
WITHIN_40MILES | Пользователь находился в пределах 40 миль от места. |
BEYOND_40MILES | Пользователь превышал 40 миль от места. |
DynamicSearchAdsSearchVermView
Динамический поисковый поисковый просмотр.
JSON-представление |
---|
{ "resourceName": string, "searchTerm": string, "headline": string, "landingPage": string, "pageUrl": string, "hasNegativeKeyword": boolean, "hasMatchingKeyword": boolean, "hasNegativeUrl": boolean } |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса просмотра поиска динамического поиска. Динамический поиск объявлений об поиске термин «Просмотр имен ресурсов» есть форма: |
searchTerm | Только вывод. Искать термин Это поле только для чтения. |
headline | Только вывод. Динамически сгенерированный заголовок динамического поискового объявления. Это поле только для чтения. |
landingPage | Только вывод. Динамически выбранная URL -адрес -страницы впечатления. Это поле только для чтения. |
pageUrl | Только вывод. URL -адрес предмет Feed Pare подается на впечатление. Это поле только для чтения. |
hasNegativeKeyword | Только вывод. Верно, если запрос соответствует отрицательному ключевому слову. Это поле только для чтения. |
hasMatchingKeyword | Только вывод. Верно, если запрос добавлен в целевые ключевые слова. Это поле только для чтения. |
hasNegativeUrl | Только вывод. Правда, если запрос соответствует негативному URL. Это поле только для чтения. |
ExpatedLandingPageview
Вид на целевой странице с метриками, агрегированными на расширенном конечном уровне URL.
JSON-представление |
---|
{ "resourceName": string, "expandedFinalUrl": string } |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса расширенного представления целевой страницы. Расширенная целевая страница имена ресурсов имеют форму: |
expandedFinalUrl | Только вывод. Окончательный URL, на который клики направлен. |
Feedmplaceholderview
Вид на кормовой заполнитель.
JSON-представление |
---|
{
"resourceName": string,
"placeholderType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса представления заполнителя Feed. Feed Placeholder View имена ресурсов имеют форму: |
placeholderType | Только вывод. Тип заполнителя вида заполнителя. |
Genderview
Гендерный вид. Ресурс Genderview отражает эффективное состояние обслуживания, а не то, что были добавлены критерии. Группа AD без гендерных критериев по умолчанию показывает все полов, поэтому все полы появляются в Genderview с статистикой.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса гендерного представления. Гендерное представление имена ресурсов имеют форму: |
GeographyView
Географический взгляд.
Географический взгляд включает в себя все показатели, объединенные на уровне страны, один ряд на страну. Он сообщает метрики в реальном физическом месте пользователя или интересующей области. Если используются другие поля сегмента, вы можете получить более одного ряда на страну.
JSON-представление |
---|
{
"resourceName": string,
"locationType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса географического представления. Географическое представление имена ресурсов имеют форму: |
locationType | Только вывод. Тип гео -таргетинга кампании. |
countryCriterionId | Только вывод. Критерий идентификатор для страны. |
GeotargetingType
Возможные типы таргетинга GEO.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
AREA_OF_INTEREST | Местоположение пользователь заинтересован в том, чтобы сделать запрос. |
LOCATION_OF_PRESENCE | Расположение пользователя, выдавающего запрос. |
GroupplesionView
Групповое представление.
JSON-представление |
---|
{
"resourceName": string,
"placementType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса представления группы размещения. Групповое размещение имена ресурсов имеют форму: |
placementType | Только вывод. Тип размещения, например, веб -сайт, канал YouTube, мобильное приложение. |
placement | Только вывод. Строка автоматического размещения на уровне группы, например, веб -домен, идентификатор мобильного приложения или идентификатор канала YouTube. |
displayName | Только вывод. Доменное имя для веб -сайтов и имени канала YouTube для каналов YouTube. |
targetUrl | Только вывод. URL -адрес группы размещения, например, домена, ссылка на мобильное приложение в App Store или URL -адрес канала YouTube. |
HotelGroupView
Отель Group View.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса View Group Group. Отель Group View Resource Names имеет форму: |
HotelPerformanceView
Вид на отель.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. Название ресурса отеля Performance View. Отель Performance View имена ресурсов имеют форму: |
Отель
Примирение отеля. Он содержит информацию о конверсии от бронирования отелей, чтобы согласовать с рекламодательными записями. Эти ряды могут быть обновлены или отменены до выставления счетов через объемные загрузки.
JSON-представление |
---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"campaign": string,
"hotelCenterId": string,
"hotelId": string,
"checkInDate": string,
"checkOutDate": string,
"reconciledValueMicros": string,
"billed": boolean,
"status": enum ( |
Поля | |
---|---|
resourceName | Неизменный. Название ресурса примирения отеля. Имена ресурсов для примирения отеля имеют форму: |
commissionId | Необходимый. Только вывод. Идентификатор комиссии является идентификатором Google для этого бронирования. Каждому мероприятию бронирования назначается идентификатор комиссии, чтобы помочь вам сопоставить его с гостевым пребыванием. |
orderId | Только вывод. Идентификатор порядка является идентификатором для этого бронирования, как это предусмотрено в параметре «Transaction_id» тега отслеживания преобразования. |
campaign | Только вывод. Название ресурса для кампании, связанной с конверсией. |
hotelCenterId | Только вывод. Идентификатор для учетной записи в отеле, который предоставляет цены на гостиничную кампанию. |
hotelId | Только вывод. Уникальный идентификатор для забронированной недвижимости, как предусмотрено в Feed Center Hotel Center. Идентификатор отеля происходит из параметра «ID» тега отслеживания конверсии. |
checkInDate | Только вывод. Дата регистрации записана при бронировании. Если дата регистрации изменена при примирении, пересмотренная дата займет место исходной даты в этом столбце. Формат yyyy-mm-dd. |
checkOutDate | Только вывод. Дата выхода на работу записана при бронировании. Если дата регистрации изменена при примирении, пересмотренная дата займет место исходной даты в этом столбце. Формат yyyy-mm-dd. |
reconciledValueMicros | Необходимый. Только вывод. Примиренная стоимость - это окончательная стоимость бронирования, оплаченного гостем. 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 | Только вывод. Whether a given booking has been billed. Once billed, a booking can't be modified. |
status | Необходимый. Только вывод. Current status of a booking with regards to reconciliation and billing. Bookings should be reconciled within 45 days after the check-out date. Any booking not reconciled within 45 days will be billed at its original value. |
HotelReconciliationStatus
Status of the hotel booking reconciliation.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
RESERVATION_ENABLED | Bookings are for a future date, or a stay is underway but the check-out date hasn't passed. An active reservation can't be reconciled. |
RECONCILIATION_NEEDED | Check-out has already taken place, or the booked dates have passed without cancellation. Bookings that are not reconciled within 45 days of the check-out date are billed based on the original booking price. |
RECONCILED | These bookings have been reconciled. Reconciled bookings are billed 45 days after the check-out date. |
CANCELED | This booking was marked as canceled. Canceled stays with a value greater than zero (due to minimum stay rules or cancellation fees) are billed 45 days after the check-out date. |
IncomeRangeView
An income range view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the income range view. Income range view resource names have the form: |
KeywordView
A keyword view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the keyword view. Keyword view resource names have the form: |
LandingPageView
A landing page view with metrics aggregated at the unexpanded final URL level.
JSON-представление |
---|
{ "resourceName": string, "unexpandedFinalUrl": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the landing page view. Landing page view resource names have the form: |
unexpandedFinalUrl | Только вывод. The advertiser-specified final URL. |
LanguageConstant
Язык.
JSON-представление |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the language constant. Language constant resource names have the form: |
id | Только вывод. The ID of the language constant. |
code | Только вывод. The language code, for example, "en_US", "en_AU", "es", "fr", etc. |
name | Только вывод. The full name of the language in English, for example, "English (US)", "Spanish", etc. |
targetable | Только вывод. Whether the language is targetable. |
LocationView
A location view summarizes the performance of campaigns by a Location criterion. If no Location criterion is set, no results are returned; instead, use geographicView or userLocationView for visitor location data.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the location view. Location view resource names have the form: |
ManagedPlacementView
A managed placement view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the Managed Placement view. Managed placement view resource names have the form: |
MediaFile
A media file.
JSON-представление |
---|
{ "resourceName": string, "type": enum ( |
Поля | |
---|---|
resourceName | Неизменный. The resource name of the media file. Media file resource names have the form: |
type | Неизменный. Type of the media file. |
mimeType | Только вывод. The mime type of the media file. |
id | Только вывод. The ID of the media file. |
sourceUrl | Неизменный. The URL of where the original media file was downloaded from (or a file name). Only used for media of type AUDIO and IMAGE. |
name | Неизменный. The name of the media file. The name can be used by clients to help identify previously uploaded media. |
fileSize | Только вывод. The size of the media file in bytes. |
Union field mediatype . The specific type of the media file. mediatype can be only one of the following: | |
image | Неизменный. Encapsulates an Image. |
mediaBundle | Неизменный. A ZIP archive media the content of which contains HTML5 assets. |
audio | Только вывод. Encapsulates an Audio. |
video | Неизменный. Encapsulates a Video. |
MediaType
The type of media.
Перечисления | |
---|---|
UNSPECIFIED | The media type has not been specified. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
IMAGE | Static image, used for image ad. |
ICON | Small image, used for map ad. |
MEDIA_BUNDLE | ZIP file, used in fields of template ads. |
AUDIO | Audio file. |
VIDEO | Video file. |
DYNAMIC_IMAGE | Animated image, such as animated GIF. |
MediaImage
Encapsulates an Image.
JSON-представление |
---|
{ "data": string, "fullSizeImageUrl": string, "previewSizeImageUrl": string } |
Поля | |
---|---|
data | Неизменный. Raw image data. Строка в кодировке Base64. |
fullSizeImageUrl | Только вывод. The url to the full size version of the image. |
previewSizeImageUrl | Только вывод. The url to the preview size version of the image. |
MediaBundle
Represents a ZIP archive media the content of which contains HTML5 assets.
JSON-представление |
---|
{ "data": string, "url": string } |
Поля | |
---|---|
data | Неизменный. Raw zipped data. Строка в кодировке Base64. |
url | Только вывод. The url to access the uploaded zipped data. For example, https://tpc.googlesyndication.com/simgad/123 This field is read-only. |
MediaAudio
Encapsulates an Audio.
JSON-представление |
---|
{ "adDurationMillis": string } |
Поля | |
---|---|
adDurationMillis | Только вывод. The duration of the Audio in milliseconds. |
MediaVideo
Encapsulates a Video.
JSON-представление |
---|
{ "adDurationMillis": string, "youtubeVideoId": string, "advertisingIdCode": string, "isciCode": string } |
Поля | |
---|---|
adDurationMillis | Только вывод. The duration of the Video in milliseconds. |
youtubeVideoId | Неизменный. The YouTube video ID (as seen in YouTube URLs). Adding prefix "https://www.youtube.com/watch?v=" to this ID will get the YouTube streaming URL for this video. |
advertisingIdCode | Только вывод. The Advertising Digital Identification code for this video, as defined by the American Association of Advertising Agencies, used mainly for television commercials. |
isciCode | Только вывод. The Industry Standard Commercial Identifier code for this video, used mainly for television commercials. |
LocalServicesEmployee
A local services employee resource.
JSON-представление |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
Поля | |
---|---|
resourceName | Неизменный. The resource name of the Local Services Verification. Local Services Verification resource names have the form: |
creationDateTime | Только вывод. Timestamp of employee creation. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
status | Только вывод. Employee status, such as DELETED or ENABLED. |
type | Только вывод. Employee type. |
universityDegrees[] | Только вывод. A list of degrees this employee has obtained, and wants to feature. |
residencies[] | Только вывод. The institutions where the employee has completed their residency. |
fellowships[] | Только вывод. The institutions where the employee has completed their fellowship. |
languagesSpoken[] | Только вывод. Languages that the employee speaks, represented as language tags from https://developers.google.com/admin-sdk/directory/v1/languages |
categoryIds[] | Только вывод. Category of the employee. A list of Local Services category IDs can be found at https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids . |
id | Только вывод. The ID of the employee. |
jobTitle | Только вывод. Job title for this employee, such as "Senior partner" in legal verticals. |
yearStartedPracticing | Только вывод. The year that this employee started practicing in this field. |
nationalProviderIdNumber | Только вывод. NPI id associated with the employee. |
emailAddress | Только вывод. Email address of the employee. |
firstName | Только вывод. First name of the employee. |
middleName | Только вывод. Middle name of the employee. |
lastName | Только вывод. Last name of the employee. |
LocalServicesEmployeeStatus
Enums describing statuses of a local services employee.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ENABLED | Employee is not removed, and employee status is active. |
REMOVED | Employee is removed. Used to delete an employee from the business. |
LocalServicesEmployeeType
Enums describing types of a local services employee.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
BUSINESS_OWNER | Represents the owner of the business. |
EMPLOYEE | Represents an employee of the business. |
Высшее образование
A list of degrees this employee has obtained, and wants to feature.
JSON-представление |
---|
{ "institutionName": string, "degree": string, "graduationYear": integer } |
Поля | |
---|---|
institutionName | Только вывод. Name of the university at which the degree was obtained. |
degree | Только вывод. Name of the degree obtained. |
graduationYear | Только вывод. Выпускной год. |
Residency
Details about the employee's medical residency. Residency is a stage of graduate medical education in which a qualified medical professional practices under the supervision of a senior clinician.
JSON-представление |
---|
{ "institutionName": string, "completionYear": integer } |
Поля | |
---|---|
institutionName | Только вывод. Name of the institution at which the residency was completed. |
completionYear | Только вывод. Год завершения. |
Fellowship
Details about the employee's medical Fellowship. Fellowship is a period of medical training that the professional undertakes after finishing their residency.
JSON-представление |
---|
{ "institutionName": string, "completionYear": integer } |
Поля | |
---|---|
institutionName | Только вывод. Name of the instutition at which the fellowship was completed. |
completionYear | Только вывод. Год завершения. |
LocalServicesVerificationArtifact
A local services verification resource.
JSON-представление |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
Поля | |
---|---|
resourceName | Неизменный. The resource name of the Local Services Verification. Local Services Verification resource names have the form: |
creationDateTime | Только вывод. The timestamp when this verification artifact was created. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
status | Только вывод. The status of the verification artifact. |
artifactType | Только вывод. The type of the verification artifact. |
id | Только вывод. The ID of the verification artifact. |
Union field artifact_data . The types of verification info. artifact_data can be only one of the following: | |
backgroundCheckVerificationArtifact | Только вывод. A background check verification artifact. |
insuranceVerificationArtifact | Только вывод. An insurance verification artifact. |
licenseVerificationArtifact | Только вывод. A license verification artifact. |
businessRegistrationCheckVerificationArtifact | Только вывод. A business registration check verification artifact. |
LocalServicesVerificationArtifactStatus
Enums describing statuses of a local services verification artifact.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
PASSED | Artifact has passed verification. |
FAILED | Artifact has failed verification. |
PENDING | Artifact is in the process of verification. |
NO_SUBMISSION | Artifact needs user to upload information before it is verified. |
CANCELLED | Artifact has been cancelled by the user. |
LocalServicesVerificationArtifactType
Enums describing possible types of local services verification artifact.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
BACKGROUND_CHECK | Background check verification artifact. |
INSURANCE | Insurance verification artifact. |
LICENSE | License verification artifact. |
BUSINESS_REGISTRATION_CHECK | Business registration check verification artifact. |
BackgroundCheckVerificationArtifact
A proto holding information specific to local services background check.
JSON-представление |
---|
{ "caseUrl": string, "finalAdjudicationDateTime": string } |
Поля | |
---|---|
caseUrl | Только вывод. URL to access background case. |
finalAdjudicationDateTime | Только вывод. The timestamp when this background check case result was adjudicated. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
InsuranceVerificationArtifact
A proto holding information specific to a local services insurance.
JSON-представление |
---|
{ "amountMicros": string, "rejectionReason": enum ( |
Поля | |
---|---|
amountMicros | Только вывод. Insurance amount. This is measured in "micros" of the currency mentioned in the insurance document. |
rejectionReason | Только вывод. Insurance document's rejection reason. |
insuranceDocumentReadonly | Только вывод. The readonly field containing the information for an uploaded insurance document. |
expirationDateTime | Только вывод. The timestamp when this insurance expires. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
LocalServicesInsuranceRejectionReason
Enums describing possible rejection reasons of a local services insurance verification artifact.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
BUSINESS_NAME_MISMATCH | Business name doesn't match business name for the Local Services Ad. |
INSURANCE_AMOUNT_INSUFFICIENT | Insurance amount doesn't meet requirement listed in the legal summaries documentation for that geographic + category ID combination. |
EXPIRED | Insurance document is expired. |
NO_SIGNATURE | Insurance document is missing a signature. |
NO_POLICY_NUMBER | Insurance document is missing a policy number. |
NO_COMMERCIAL_GENERAL_LIABILITY | Commercial General Liability(CGL) box is not marked in the insurance document. |
EDITABLE_FORMAT | Insurance document is in an editable format. |
CATEGORY_MISMATCH | Insurance document does not cover insurance for a particular category. |
MISSING_EXPIRATION_DATE | Insurance document is missing an expiration date. |
POOR_QUALITY | Insurance document is poor quality - blurry images, illegible, etc... |
POTENTIALLY_EDITED | Insurance document is suspected of being edited. |
WRONG_DOCUMENT_TYPE | Insurance document not accepted. For example, documents of insurance proposals, but missing coverages are not accepted. |
NON_FINAL | Insurance document is not final. |
OTHER | Insurance document has another flaw not listed explicitly. |
LocalServicesDocumentReadOnly
A Local Services Document with read only accessible data.
JSON-представление |
---|
{ "documentUrl": string } |
Поля | |
---|---|
documentUrl | URL to access an already uploaded Local Services document. |
LicenseVerificationArtifact
A proto holding information specific to a local services license.
JSON-представление |
---|
{ "licenseType": string, "licenseNumber": string, "licenseeFirstName": string, "licenseeLastName": string, "rejectionReason": enum ( |
Поля | |
---|---|
licenseType | Только вывод. License type / name. |
licenseNumber | Только вывод. Лицензионный номер. |
licenseeFirstName | Только вывод. First name of the licensee. |
licenseeLastName | Только вывод. Last name of the licensee. |
rejectionReason | Только вывод. License rejection reason. |
licenseDocumentReadonly | Только вывод. The readonly field containing the information for an uploaded license document. |
expirationDateTime | Только вывод. The timestamp when this license expires. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
LocalServicesLicenseRejectionReason
Enums describing possible rejection reasons of a local services license verification artifact.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
BUSINESS_NAME_MISMATCH | Business name doesn't match business name for the Local Services Ad. |
UNAUTHORIZED | License is unauthorized or been revoked. |
EXPIRED | License is expired. |
POOR_QUALITY | License is poor quality - blurry images, illegible, etc... |
UNVERIFIABLE | License cannot be verified due to a not legitimate image. |
WRONG_DOCUMENT_OR_ID | License is not the requested document type or contains an invalid ID. |
OTHER | License has another flaw not listed explicitly. |
BusinessRegistrationCheckVerificationArtifact
A proto holding information specific to a local services business registration check.
JSON-представление |
---|
{ "registrationType": enum ( |
Поля | |
---|---|
registrationType | Только вывод. The type of business registration check (number, document). |
checkId | Только вывод. The id of the check, such as vat_tax_id, representing "VAT Tax ID" requirement. |
rejectionReason | Только вывод. Registration document rejection reason. |
Union field business_registration . Registration information for the business registration. It will be one of the following forms based on the requirement from different countries. business_registration can be only one of the following: | |
registrationNumber | Только вывод. Message storing government issued number for the business. |
registrationDocument | Только вывод. Message storing document info for the business. |
LocalServicesBusinessRegistrationType
Enums describing possible registration types of a local services business registration check verification artifact.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
NUMBER | Registration number check type. |
DOCUMENT | Registration document check type. |
LocalServicesBusinessRegistrationCheckRejectionReason
Enums describing possible rejection reasons of a local services business registration check verification artifact.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
BUSINESS_NAME_MISMATCH | Business name doesn't match business name for the Local Services Ad. |
BUSINESS_DETAILS_MISMATCH | Business details mismatch. |
ID_NOT_FOUND | Business registration ID not found. |
POOR_DOCUMENT_IMAGE_QUALITY | Uploaded document not clear, blurry, etc. |
DOCUMENT_EXPIRED | Uploaded document has expired. |
DOCUMENT_INVALID | Document revoked or annuled. |
DOCUMENT_TYPE_MISMATCH | Document type mismatch. |
DOCUMENT_UNVERIFIABLE | Uploaded document could not be verified as legitimate. |
OTHER | The business registration process could not be completed due to an issue. Contact https://support.google.com/localservices to learn more. |
BusinessRegistrationNumber
A proto holding information specific to a local services business registration number.
JSON-представление |
---|
{ "number": string } |
Поля | |
---|---|
number | Только вывод. Government-issued number for the business. |
BusinessRegistrationDocument
A proto holding information specific to a local services business registration document.
JSON-представление |
---|
{
"documentReadonly": {
object ( |
Поля | |
---|---|
documentReadonly | Только вывод. The readonly field containing the information for an uploaded business registration document. |
MobileAppCategoryConstant
A mobile application category constant.
JSON-представление |
---|
{ "resourceName": string, "id": integer, "name": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the mobile app category constant. Mobile app category constant resource names have the form: |
id | Только вывод. The ID of the mobile app category constant. |
name | Только вывод. Mobile app category name. |
MobileDeviceConstant
A mobile device constant.
JSON-представление |
---|
{
"resourceName": string,
"type": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the mobile device constant. Mobile device constant resource names have the form: |
type | Только вывод. The type of mobile device. |
id | Только вывод. The ID of the mobile device constant. |
name | Только вывод. The name of the mobile device. |
manufacturerName | Только вывод. The manufacturer of the mobile device. |
operatingSystemName | Только вывод. The operating system of the mobile device. |
MobileDeviceType
The type of mobile device.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
MOBILE | Мобильные телефоны. |
TABLET | Таблетки. |
OfflineConversionUploadClientSummary
Offline conversion upload client summary.
JSON-представление |
---|
{ "resourceName": string, "client": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the offline conversion upload client summary. Offline conversion upload client summary resource names have the form: |
client | Только вывод. Client type of the upload event. |
status | Только вывод. Overall status for offline conversion client summary. Status is generated from most recent calendar day with upload stats |
totalEventCount | Только вывод. Total count of uploaded events. |
successfulEventCount | Только вывод. Total count of successful uploaded events. |
successRate | Только вывод. Successful rate. |
lastUploadDateTime | Только вывод. Date for the latest upload batch. The format is "yyyy-mm-dd hh:mm:ss", and it's in the time zone of the Google Ads account. |
dailySummaries[] | Только вывод. Summary of history stats by last N days. |
jobSummaries[] | Только вывод. Summary of history stats by last N jobs. |
alerts[] | Только вывод. Details for each error code. Alerts are generated from most recent calendar day with upload stats. |
OfflineEventUploadClient
Type of client.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
GOOGLE_ADS_API | Google Ads API. |
GOOGLE_ADS_WEB_CLIENT | Google Ads web client, which could include multiple sources like Ads UI, SFTP, etc. |
ADS_DATA_CONNECTOR | Connection platform. |
OfflineConversionDiagnosticStatus
Possible statuses of the offline ingestion setup.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
EXCELLENT | Your offline data ingestion setup is active and optimal for downstream processing. |
GOOD | Your offline ingestion setup is active, but there are further improvements you could make. See alerts. |
NEEDS_ATTENTION | Your offline ingestion setup is active, but there are errors that require your attention. See alerts. |
NO_RECENT_UPLOAD | Your offline ingestion setup has not received data in the last 28 days, there may be something wrong. |
OfflineConversionSummary
Historical upload summary, grouped by upload date or job.
JSON-представление |
---|
{ "successfulCount": string, "failedCount": string, // Union field |
Поля | |
---|---|
successfulCount | Только вывод. Total count of successful event. |
failedCount | Только вывод. Total count of failed event. |
Union field dimension_key . Dimension key for summary. dimension_key can be only one of the following: | |
jobId | Только вывод. Dimension key for last N jobs. |
uploadDate | Только вывод. Dimension key for last N days. |
OfflineConversionAlert
Alert for offline conversion client summary.
JSON-представление |
---|
{
"error": {
object ( |
Поля | |
---|---|
error | Только вывод. Error for offline conversion client alert. |
errorPercentage | Только вывод. Percentage of the error, the range of this field should be [0, 1.0]. |
OfflineConversionError
Possible errors for offline conversion client summary.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
Union field error_code . Error with description. error_code can be only one of the following: | |
collectionSizeError | Только вывод. Collection size error. |
conversionAdjustmentUploadError | Только вывод. Conversion adjustment upload error. |
conversionUploadError | Только вывод. Conversion upload error. |
dateError | Только вывод. Date error. |
distinctError | Только вывод. Distinct error. |
fieldError | Только вывод. Field error. |
mutateError | Только вывод. Mutate error. |
notAllowlistedError | Только вывод. Not allowlisted error. |
stringFormatError | Только вывод. String format error. |
stringLengthError | Только вывод. String length error. |
CollectionSizeError
Enum describing possible collection size errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
TOO_FEW | Too few. |
TOO_MANY | Очень много. |
ConversionAdjustmentUploadError
Enum describing possible conversion adjustment upload errors.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
TOO_RECENT_CONVERSION_ACTION | Can't import events to a conversion action that was just created. Try importing again in 6 hours. |
CONVERSION_ALREADY_RETRACTED | The conversion was already retracted. This adjustment was not processed. |
CONVERSION_NOT_FOUND | The conversion for this conversion action and conversion identifier can't be found. Make sure your conversion identifiers are associated with the correct conversion action and try again. |
CONVERSION_EXPIRED | Adjustment can't be made to a conversion that occurred more than 54 days ago. |
ADJUSTMENT_PRECEDES_CONVERSION | Adjustment has an adjustmentDateTime that occurred before the associated conversion. Make sure your adjustmentDateTime is correct and try again. |
MORE_RECENT_RESTATEMENT_FOUND | More recent adjustment adjustmentDateTime has already been reported for the associated conversion. Make sure your adjustment adjustmentDateTime is correct and try again. |
TOO_RECENT_CONVERSION | Adjustment can't be recorded because the conversion occurred too recently. Try adjusting a conversion that occurred at least 24 hours ago. |
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE | Can't make an adjustment to a conversion that is set up to use the default value. Check your conversion action value setting and try again. |
TOO_MANY_ADJUSTMENTS_IN_REQUEST | Try uploading fewer than 2001 adjustments in a single API request. |
TOO_MANY_ADJUSTMENTS | The conversion has already been adjusted the maximum number of times. Make sure you're only making necessary adjustment to existing conversion. |
RESTATEMENT_ALREADY_EXISTS | The conversion has prior a restatement with the same adjustmentDateTime . Make sure your adjustment has the correct and unique adjustmentDateTime and try again. |
DUPLICATE_ADJUSTMENT_IN_REQUEST | Imported adjustment has a duplicate conversion adjustment with same adjustmentDateTime . Make sure your adjustment has the correct adjustmentDateTime and try again. |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS | Make sure you agree to the customer data processing terms in conversion settings and try again. |
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT | Can't use enhanced conversions with the specified conversion action. |
INVALID_USER_IDENTIFIER | Make sure you hash user provided data using SHA-256 and ensure you are normalizing according to the guidelines. |
UNSUPPORTED_USER_IDENTIFIER | Use user provided data such as emails or phone numbers hashed using SHA-256 and try again. |
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET | Cannot set both gclidDateTimePair and orderId. Use only 1 type and try again. |
CONVERSION_ALREADY_ENHANCED | Conversion already has enhancements with the same Order ID and conversion action. Make sure your data is correctly configured and try again. |
DUPLICATE_ENHANCEMENT_IN_REQUEST | Multiple enhancements have the same conversion action and Order ID. Make sure your data is correctly configured and try again. |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT | Enhanced conversions can't be used for this account because of Google customer data policies. Contact your Google representative. |
MISSING_ORDER_ID_FOR_WEBPAGE | Adjustment for website conversion requires Order ID (ie, transaction ID). Make sure your website tags capture Order IDs and you send the same Order IDs with your adjustment. |
ORDER_ID_CONTAINS_PII | Can't use adjustment with Order IDs containing personally-identifiable information (PII). |
INVALID_JOB_ID | The provided job id in the request is not within the allowed range. A job ID must be a positive integer in the range [1, 2^31). |
NO_CONVERSION_ACTION_FOUND | The conversion action specified in the adjustment request cannot be found. Make sure it's available in this account. |
INVALID_CONVERSION_ACTION_TYPE | The type of the conversion action specified in the adjustment request isn't supported for uploading adjustments. A conversion adjustment of type RETRACTION or RESTATEMENT is only permitted for conversion actions of type SALESFORCE , UPLOAD_CLICK or WEBPAGE . A conversion adjustment of type ENHANCEMENT is only permitted for conversion actions of type WEBPAGE . |
ConversionUploadError
Enum describing possible conversion upload errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
TOO_MANY_CONVERSIONS_IN_REQUEST | Upload fewer than 2001 events in a single request. |
UNPARSEABLE_GCLID | The imported gclid could not be decoded. Make sure you have not modified the click IDs. |
CONVERSION_PRECEDES_EVENT | The imported event has a conversionDateTime that precedes the click. Make sure your conversionDateTime is correct and try again. |
EXPIRED_EVENT | The imported event can't be recorded because its click occurred before this conversion's click-through window. Make sure you import the most recent data. |
TOO_RECENT_EVENT | The click associated with the given identifier or iOS URL parameter occurred less than 6 hours ago. Retry after 6 hours have passed. |
EVENT_NOT_FOUND | The imported event could not be attributed to a click. This may be because the event did not come from a Google Ads campaign. |
UNAUTHORIZED_CUSTOMER | The click ID or call is associated with an Ads account you don't have access to. Make sure you import conversions for accounts managed by your manager account. |
TOO_RECENT_CONVERSION_ACTION | Can't import events to a conversion action that was just created. Try importing again in 6 hours. |
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME | At the time of the click, conversion tracking was not enabled in the effective conversion account of the click's Google Ads account. |
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION | The imported event includes external attribution data, but the conversion action isn't set up to use an external attribution model. Make sure the conversion action is correctly configured and try again. |
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION | The conversion action is set up to use an external attribution model, but the imported event is missing data. Make sure imported events include the external attribution credit and all necessary fields. |
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION | Order IDs can't be used for a conversion measured with an external attribution model. Make sure the conversion is correctly configured and imported events include only necessary data and try again. |
ORDER_ID_ALREADY_IN_USE | The imported event includes an order ID that was previously recorded, so the event was not processed. |
DUPLICATE_ORDER_ID | Imported events include multiple conversions with the same order ID and were not processed. Make sure order IDs are unique and try again. |
TOO_RECENT_CALL | Can't import calls that occurred less than 6 hours ago. Try uploading again in 6 hours. |
EXPIRED_CALL | The call can't be recorded because it occurred before this conversion action's lookback window. Make sure your import is configured to get the most recent data. |
CALL_NOT_FOUND | The call or click leading to the imported event can't be found. Make sure your data source is set up to include correct identifiers. |
CONVERSION_PRECEDES_CALL | The call has a conversionDateTime that precedes the associated click. Make sure your conversionDateTime is correct. |
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME | At the time of the imported call, conversion tracking was not enabled in the effective conversion account of the click's Google Ads account. |
UNPARSEABLE_CALLERS_PHONE_NUMBER | Make sure phone numbers are formatted as E.164 (+16502531234), International (+64 3-331 6005), or US national number (6502531234). |
CLICK_CONVERSION_ALREADY_EXISTS | The imported event has the same click and conversionDateTime as an existing conversion. Use a unique conversionDateTime or order ID for each unique event and try again. |
CALL_CONVERSION_ALREADY_EXISTS | The imported call has the same conversionDateTime as an existing conversion. Make sure your conversionDateTime correctly configured and try again. |
DUPLICATE_CLICK_CONVERSION_IN_REQUEST | Multiple events have the same click and conversionDateTime . Make sure your conversionDateTime is correctly configured and try again. |
DUPLICATE_CALL_CONVERSION_IN_REQUEST | Multiple events have the same call and conversionDateTime . Make sure your conversionDateTime is correctly configured and try again. |
CUSTOM_VARIABLE_NOT_ENABLED | Enable the custom variable in your conversion settings and try again. |
CUSTOM_VARIABLE_VALUE_CONTAINS_PII | Can't import events with custom variables containing personally-identifiable information (PII). Remove these variables and try again. |
INVALID_CUSTOMER_FOR_CLICK | The click from the imported event is associated with a different Google Ads account. Make sure you're importing to the correct account. |
INVALID_CUSTOMER_FOR_CALL | The click from the call is associated with a different Google Ads account. Make sure you're importing to the correct account. Query conversionTrackingSetting.google_ads_conversion_customer on Customer to identify the correct account. |
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY | The connversion can't be imported because the conversion source didn't comply with Apple App Transparency Tracking (ATT) policies or because the customer didn't consent to tracking. |
CLICK_NOT_FOUND | The email address or phone number for this event can't be matched to a click. This may be because it didn't come from a Google Ads campaign, and you can safely ignore this warning. If this includes more imported events than is expected, you may need to check your setup. |
INVALID_USER_IDENTIFIER | Make sure you hash user provided data using SHA-256 and ensure you are normalizing according to the guidelines. |
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER | User provided data can't be used with external attribution models. Use a different attribution model or omit user identifiers and try again. |
UNSUPPORTED_USER_IDENTIFIER | The provided user identifiers are not supported. Use only hashed email or phone number and try again. |
GBRAID_WBRAID_BOTH_SET | Can't use both gbraid and wbraid parameters. Use only 1 and try again. |
UNPARSEABLE_WBRAID | Can't parse event import data. Check if your wbraid parameter was not modified and try again. |
UNPARSEABLE_GBRAID | Can't parse event import data. Check if your gbraid parameter was not modified and try again. |
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID | Conversion actions that use one-per-click counting can't be used with gbraid or wbraid parameters. |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS | Enhanced conversions can't be used for this account because of Google customer data policies. Contact your Google representative. |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS | Make sure you agree to the customer data processing terms in conversion settings and try again. You can check your setting by querying conversionTrackingSetting.accepted_customer_data_terms on Customer. |
ORDER_ID_CONTAINS_PII | Can't import events with order IDs containing personally-identifiable information (PII). |
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS | Make sure you've turned on enhanced conversions for leads in conversion settings and try again. You can check your setting by querying conversionTrackingSetting.enhanced_conversions_for_leads_enabled on Customer. |
INVALID_JOB_ID | The provided job id in the request is not within the allowed range. A job ID must be a positive integer in the range [1, 2^31). |
NO_CONVERSION_ACTION_FOUND | The conversion action specified in the upload request cannot be found. Make sure it's available in this account. |
INVALID_CONVERSION_ACTION_TYPE | The conversion action specified in the upload request isn't set up for uploading conversions. |
DateError
Enum describing possible date errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
INVALID_FIELD_VALUES_IN_DATE | Given field values do not correspond to a valid date. |
INVALID_FIELD_VALUES_IN_DATE_TIME | Given field values do not correspond to a valid date time. |
INVALID_STRING_DATE | The string date's format should be yyyy-mm-dd. |
INVALID_STRING_DATE_TIME_MICROS | The string date time's format should be yyyy-mm-dd hh:mm:ss.ssssss. |
INVALID_STRING_DATE_TIME_SECONDS | The string date time's format should be yyyy-mm-dd hh:mm:ss. |
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET | The string date time's format should be yyyy-mm-dd hh:mm:ss+|-hh:mm. |
EARLIER_THAN_MINIMUM_DATE | Date is before allowed minimum. |
LATER_THAN_MAXIMUM_DATE | Date is after allowed maximum. |
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE | Date range bounds are not in order. |
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL | Both dates in range are null. |
DistinctError
Enum describing possible distinct errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
DUPLICATE_ELEMENT | Duplicate element. |
DUPLICATE_TYPE | Duplicate type. |
FieldError
Enum describing possible field errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
REQUIRED | The required field was not present. |
IMMUTABLE_FIELD | The field attempted to be mutated is immutable. |
INVALID_VALUE | The field's value is invalid. |
VALUE_MUST_BE_UNSET | The field cannot be set. |
REQUIRED_NONEMPTY_LIST | The required repeated field was empty. |
FIELD_CANNOT_BE_CLEARED | The field cannot be cleared. |
BLOCKED_VALUE | The field's value is on a deny-list for this field. |
FIELD_CAN_ONLY_BE_CLEARED | The field's value cannot be modified, except for clearing. |
MutateError
Enum describing possible mutate errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
RESOURCE_NOT_FOUND | Requested resource was not found. |
ID_EXISTS_IN_MULTIPLE_MUTATES | Cannot mutate the same resource twice in one request. |
INCONSISTENT_FIELD_VALUES | The field's contents don't match another field that represents the same data. |
MUTATE_NOT_ALLOWED | Mutates are not allowed for the requested resource. |
RESOURCE_NOT_IN_GOOGLE_ADS | The resource isn't in Google Ads. It belongs to another ads system. |
RESOURCE_ALREADY_EXISTS | The resource being created already exists. |
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY | This resource cannot be used with "validateOnly". |
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE | This operation cannot be used with "partialFailure". |
RESOURCE_READ_ONLY | Attempt to write to read-only fields. |
NotAllowlistedError
Enum describing possible not allowlisted errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE | Customer is not allowlisted for accessing this feature. |
StringFormatError
Enum describing possible string format errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
ILLEGAL_CHARS | The input string value contains disallowed characters. |
INVALID_FORMAT | The input string value is invalid for the associated field. |
StringLengthError
Enum describing possible string length errors.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | The received error code is not known in this version. |
EMPTY | The specified field should have a least one non-whitespace character in it. |
TOO_SHORT | Слишком короткий. |
TOO_LONG | Слишком долго. |
OperatingSystemVersionConstant
A mobile operating system version or a range of versions, depending on operatorType
. List of available mobile platforms at https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
JSON-представление |
---|
{
"resourceName": string,
"operatorType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the operating system version constant. Operating system version constant resource names have the form: |
operatorType | Только вывод. Determines whether this constant represents a single version or a range of versions. |
id | Только вывод. The ID of the operating system version. |
name | Только вывод. Name of the operating system. |
osMajorVersion | Только вывод. The OS Major Version number. |
osMinorVersion | Только вывод. The OS Minor Version number. |
OperatingSystemVersionOperatorType
The type of operating system version.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
EQUALS_TO | Equals to the specified version. |
GREATER_THAN_EQUALS_TO | Greater than or equals to the specified version. |
PaidOrganicSearchTermView
A paid organic search term view providing a view of search stats across ads and organic listings aggregated by search term at the ad group level.
JSON-представление |
---|
{ "resourceName": string, "searchTerm": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the search term view. Search term view resource names have the form: |
searchTerm | Только вывод. The search term. |
QualifyingQuestion
Qualifying Questions for Lead Form.
JSON-представление |
---|
{ "resourceName": string, "qualifyingQuestionId": string, "locale": string, "text": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the qualifying question. 'qualifyingQuestions/{qualifyingQuestionId}' |
qualifyingQuestionId | Только вывод. The id of the qualifying question. |
locale | Только вывод. The locale of the qualifying question. |
text | Только вывод. The qualifying question. |
ParentalStatusView
A parental status view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the parental status view. Parental Status view resource names have the form: |
PerStoreView
A per store view. This view provides per store impression reach and local action conversion stats for advertisers.
JSON-представление |
---|
{ "resourceName": string, "placeId": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the per store view. Per Store view resource names have the form: |
placeId | Только вывод. The place ID of the per store view. |
ProductCategoryConstant
A Product Category.
JSON-представление |
---|
{ "resourceName": string, "categoryId": string, "level": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the product category. Product category resource names have the form: |
categoryId | Только вывод. The ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 . |
level | Только вывод. Уровень категории товара. |
state | Только вывод. State of the product category. |
localizations[] | Только вывод. List of all available localizations of the product category. |
productCategoryConstantParent | Только вывод. Resource name of the parent product category. |
ProductCategoryState
Enum describing the state of the product category.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ENABLED | The category is enabled. |
OBSOLETE | The category is obsolete. Used only for reporting purposes. |
ProductCategoryLocalization
Localization for the product category.
JSON-представление |
---|
{ "regionCode": string, "languageCode": string, "value": string } |
Поля | |
---|---|
regionCode | Только вывод. Upper-case two-letter ISO 3166-1 country code of the localized category. |
languageCode | Только вывод. Two-letter ISO 639-1 language code of the localized category. |
value | Только вывод. The name of the category in the specified locale. |
ProductGroupView
A product group view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the product group view. Product group view resource names have the form: |
SearchTermView
A search term view with metrics aggregated by search term at the ad group level.
JSON-представление |
---|
{
"resourceName": string,
"status": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the search term view. Search term view resource names have the form: |
status | Только вывод. Indicates whether the search term is currently one of your targeted or excluded keywords. |
searchTerm | Только вывод. The search term. |
adGroup | Только вывод. The ad group the search term served in. |
SearchTermTargetingStatus
Indicates whether the search term is one of your targeted or excluded keywords.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ADDED | Search term is added to targeted keywords. |
EXCLUDED | Search term matches a negative keyword. |
ADDED_EXCLUDED | Search term has been both added and excluded. |
NONE | Search term is neither targeted nor excluded. |
ShoppingPerformanceView
Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the Shopping performance view. Shopping performance view resource names have the form: |
ShoppingProduct
A shopping product from Google Merchant Center that can be advertised by campaigns.
The resource returns currently existing products from Google Merchant Center accounts linked with the customer. A campaign includes a product by specifying its merchant id (or, if available, the Multi Client Account id of the merchant) in the ShoppingSetting
, and can limit the inclusion to products having a specified feed label. Standard Shopping campaigns can also limit the inclusion through a campaignCriterion.listing_scope
.
Queries to this resource specify a scope: Account: - Filters on campaigns or ad groups are not specified. - All products from the linked Google Merchant Center accounts are returned. - Metrics and some fields (see the per-field documentation) are aggregated across all Shopping and Performance Max campaigns that include a product. Campaign: - An equality filter on campaign
is specified. Supported campaign types are Shopping, Performance Max, Demand Gen, Video. - Only products that are included by the specified campaign are returned. - Metrics and some fields (see the per-field documentation) are restricted to the specified campaign. Ad group: - An equality filter on ad group
and campaign
is specified. Supported campaign types are Shopping, Demand Gen, Video. - Only products that are included by the specified campaign are returned. - Metrics and some fields (see the per-field documentation) are restricted to the specified ad group. Note that segmentation by date segments is not permitted and will return UNSUPPORTED_DATE_SEGMENTATION error. On the other hand, filtering on date segments is allowed.
JSON-представление |
---|
{ "resourceName": string, "merchantCenterId": string, "channel": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the shopping product. Shopping product resource names have the form: |
merchantCenterId | Только вывод. The id of the merchant that owns the product. |
channel | Только вывод. The product channel describing the locality of the product. |
languageCode | Только вывод. The language code as provided by the merchant, in BCP 47 format. |
feedLabel | Только вывод. The product feed label as provided by the merchant. |
itemId | Только вывод. The item id of the product as provided by the merchant. |
targetCountries[] | Только вывод. Upper-case two-letter ISO 3166-1 code of the regions where the product is intended to be shown in ads. |
status | Только вывод. The status that indicates whether the product can show in ads. The value of this field is restricted to the scope specified in the query, see the documentation of the resource. This field can take up to 24 hours to update. |
issues[] | Только вывод. The list of issues affecting whether the product can show in ads. The value of this field is restricted to the scope specified in the query, see the documentation of the resource. This field can take up to 24 hours to update. |
multiClientAccountId | Только вывод. The id of the Multi Client Account of the merchant, if present. |
title | Только вывод. The title of the product as provided by the merchant. |
brand | Только вывод. The brand of the product as provided by the merchant. |
priceMicros | Только вывод. The price of the product in micros as provided by the merchant, in the currency specified in |
currencyCode | Только вывод. The currency code as provided by the merchant, in ISO 4217 format. |
channelExclusivity | Только вывод. The channel exclusivity of the product as provided by the merchant. |
condition | Только вывод. The condition of the product as provided by the merchant. |
availability | Только вывод. The availability of the product as provided by the merchant. |
customAttribute0 | Только вывод. The custom attribute 0 of the product as provided by the merchant. |
customAttribute1 | Только вывод. The custom attribute 1 of the product as provided by the merchant. |
customAttribute2 | Только вывод. The custom attribute 2 of the product as provided by the merchant. |
customAttribute3 | Только вывод. The custom attribute 3 of the product as provided by the merchant. |
customAttribute4 | Только вывод. The custom attribute 4 of the product as provided by the merchant. |
categoryLevel1 | Только вывод. The category level 1 of the product. |
categoryLevel2 | Только вывод. The category level 2 of the product. |
categoryLevel3 | Только вывод. The category level 3 of the product. |
categoryLevel4 | Только вывод. The category level 4 of the product. |
categoryLevel5 | Только вывод. The category level 5 of the product. |
productTypeLevel1 | Только вывод. The product type level 1 as provided by the merchant. |
productTypeLevel2 | Только вывод. The product type level 2 as provided by the merchant. |
productTypeLevel3 | Только вывод. The product type level 3 as provided by the merchant. |
productTypeLevel4 | Только вывод. The product type level 4 as provided by the merchant. |
productTypeLevel5 | Только вывод. The product type level 5 as provided by the merchant. |
effectiveMaxCpcMicros | Только вывод. The effective maximum cost-per-click (effective max. CPC) of the product. This field is available only if the query specifies the campaign or ad group scope, and if the campaign uses manual bidding. The value is the highest bid set for the product in product groups across all enabled ad groups. It represents the most you're willing to pay for a click on the product. This field can take up to 24 hours to update. |
campaign | Только вывод. A campaign that includes the product. This field is selectable only in the campaign scope, which requires an equality filter on |
adGroup | Только вывод. An ad group of a campaign that includes the product. This field is selectable only in the ad group scope, which requires an equality filter on |
Доступность продукта
Доступность продукта.
Перечисления | |
---|---|
UNSPECIFIED | Enum unspecified. |
UNKNOWN | Используется только для возвращаемого значения. Represents values unknown in this version. |
IN_STOCK | The product is in stock. |
OUT_OF_STOCK | The product is out of stock. |
PREORDER | The product can be preordered. |
ProductStatus
Enum describing the status of a product.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Represents values unknown in this version. |
NOT_ELIGIBLE | The product cannot show in ads. |
ELIGIBLE_LIMITED | The product can show in ads but may be limited in where and when it can show due to identified issues. |
ELIGIBLE | The product can show in ads. |
ProductIssue
An issue affecting whether a product can show in ads.
JSON-представление |
---|
{
"errorCode": string,
"adsSeverity": enum ( |
Поля | |
---|---|
errorCode | Только вывод. The error code that identifies the issue. |
adsSeverity | Только вывод. The severity of the issue in Google Ads. |
description | Только вывод. The short description of the issue in English. |
detail | Только вывод. The detailed description of the issue in English. |
documentation | Только вывод. The URL of the Help Center article for the issue. |
affectedRegions[] | Только вывод. List of upper-case two-letter ISO 3166-1 codes of the regions affected by the issue. If empty, all regions are affected. |
attributeName | Только вывод. The name of the product's attribute, if any, that triggered the issue. |
ProductIssueSeverity
Product issue severity.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
WARNING | The issue limits the performance of the product in ads. |
ERROR | The issue prevents the product from showing in ads. |
SmartCampaignSearchTermView
A Smart campaign search term view.
JSON-представление |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the Smart campaign search term view. Smart campaign search term view resource names have the form: |
searchTerm | Только вывод. The search term. |
campaign | Только вывод. The Smart campaign the search term served in. |
ThirdPartyAppAnalyticsLink
A data sharing connection, allowing the import of third party app analytics into a Google Ads Customer.
JSON-представление |
---|
{ "resourceName": string, "shareableLinkId": string } |
Поля | |
---|---|
resourceName | Неизменный. The resource name of the third party app analytics link. Third party app analytics link resource names have the form: |
shareableLinkId | Только вывод. The shareable link ID that should be provided to the third party when setting up app analytics. This is able to be regenerated using regenerate method in the ThirdPartyAppAnalyticsLinkService. |
TopicView
A topic view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the topic view. Topic view resource names have the form: |
TravelActivityGroupView
A travel activity group view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the travel activity group view. Travel Activity Group view resource names have the form: |
TravelActivityPerformanceView
A travel activity performance view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form: |
UserInterest
A user interest: a particular interest-based vertical to be targeted.
JSON-представление |
---|
{ "resourceName": string, "taxonomyType": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the user interest. User interest resource names have the form: |
taxonomyType | Только вывод. Taxonomy type of the user interest. |
availabilities[] | Только вывод. Availability information of the user interest. |
userInterestId | Только вывод. The ID of the user interest. |
name | Только вывод. The name of the user interest. |
userInterestParent | Только вывод. The parent of the user interest. |
launchedToAll | Только вывод. True if the user interest is launched to all channels and locales. |
UserInterestTaxonomyType
Enum containing the possible UserInterestTaxonomyTypes.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
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-представление |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the life event. Life event resource names have the form: |
id | Только вывод. The ID of the life event. |
name | Только вывод. The name of the life event, for example,"Recently Moved" |
parent | Только вывод. The parent of the lifeEvent. |
launchedToAll | Только вывод. True if the life event is launched to all channels and locales. |
availabilities[] | Только вывод. Availability information of the life event. |
UserLocationView
A user location view.
User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.
JSON-представление |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the user location view. UserLocation view resource names have the form: |
countryCriterionId | Только вывод. Criterion Id for the country. |
targetingLocation | Только вывод. Indicates whether location was targeted or not. |
TopicConstant
Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").
JSON-представление |
---|
{ "resourceName": string, "path": [ string ], "id": string, "topicConstantParent": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the topic constant. topic constant resource names have the form: |
path[] | Только вывод. 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 | Только вывод. The ID of the topic. |
topicConstantParent | Только вывод. Resource name of parent of the topic constant. |
видео
Видео.
JSON-представление |
---|
{ "resourceName": string, "id": string, "channelId": string, "durationMillis": string, "title": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the video. Video resource names have the form: |
id | Только вывод. The ID of the video. |
channelId | Только вывод. The owner channel id of the video. |
durationMillis | Только вывод. The duration of the video in milliseconds. |
title | Только вывод. The title of the video. |
WebpageView
A webpage view.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the webpage view. Webpage view resource names have the form: |
LeadFormSubmissionData
Data from lead form submissions.
JSON-представление |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the lead form submission data. Lead form submission data resource names have the form: |
id | Только вывод. ID of this lead form submission. |
asset | Только вывод. Asset associated with the submitted lead form. |
campaign | Только вывод. Campaign associated with the submitted lead form. |
leadFormSubmissionFields[] | Только вывод. Submission data associated with a lead form. |
customLeadFormSubmissionFields[] | Только вывод. Submission data associated with a custom lead form. |
adGroup | Только вывод. AdGroup associated with the submitted lead form. |
adGroupAd | Только вывод. AdGroupAd associated with the submitted lead form. |
gclid | Только вывод. Google Click Id associated with the submissed lead form. |
submissionDateTime | Только вывод. The date and time at which the lead form was submitted. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", for example, "2019-01-01 12:32:45-08:00". |
LeadFormSubmissionField
Fields in the submitted lead form.
JSON-представление |
---|
{
"fieldType": enum ( |
Поля | |
---|---|
fieldType | Только вывод. Field type for lead form fields. |
fieldValue | Только вывод. Field value for lead form fields. |
CustomLeadFormSubmissionField
Fields in the submitted custom question
JSON-представление |
---|
{ "questionText": string, "fieldValue": string } |
Поля | |
---|---|
questionText | Только вывод. Question text for custom question, maximum number of characters is 300. |
fieldValue | Только вывод. Field value for custom question response, maximum number of characters is 70. |
LocalServicesLead
Data from Local Services Lead. Contains details of Lead which is generated when user calls, messages or books service from advertiser. More info: https://ads.google.com/local-services-ads
JSON-представление |
---|
{ "resourceName": string, "id": string, "categoryId": string, "serviceId": string, "contactDetails": { object ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the local services lead data. Local Services Lead resource name have the form |
id | Только вывод. ID of this Lead. |
categoryId | Только вывод. Service category of the lead. For example: |
serviceId | Только вывод. Service for the category. For example: |
contactDetails | Только вывод. Lead's contact details. |
leadType | Только вывод. Type of Local Services lead: phone, message, booking, etc. |
leadStatus | Только вывод. Current status of lead. |
creationDateTime | Только вывод. The date time at which lead was created by Local Services Ads. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
locale | Только вывод. Language used by the Local Services provider linked to lead. See https://developers.google.com/google-ads/api/data/codes-formats#locales |
leadCharged | Только вывод. True if the advertiser was charged for the lead. |
note | Только вывод. Note added by advertiser for the lead. |
creditDetails | Только вывод. Credit details of the lead. |
Контактная информация
Fields containing consumer contact details.
JSON-представление |
---|
{ "phoneNumber": string, "email": string, "consumerName": string } |
Поля | |
---|---|
phoneNumber | Только вывод. Consumer phone number in E164 format. |
email | Только вывод. Consumer email address. |
consumerName | Только вывод. Consumer name if consumer provided name from Message or Booking form on google.com |
LeadType
Possible types of lead.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
MESSAGE | Message lead. |
PHONE_CALL | Lead created by phone call. |
BOOKING | Booking lead. |
LeadStatus
Possible statuses of lead.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
NEW | New lead which hasn't yet been seen by advertiser. |
ACTIVE | Lead that thas been interacted by advertiser. |
BOOKED | Lead has been booked. |
DECLINED | Lead was declined by advertiser. |
EXPIRED | Lead has expired due to inactivity. |
DISABLED | Disabled due to spam or dispute. |
CONSUMER_DECLINED | Consumer declined the lead. |
WIPED_OUT | Personally Identifiable Information of the lead is wiped out. |
Примечание
Represents a note added to a lead by the advertiser. Advertisers can edit notes, which will reset edit time and change description.
JSON-представление |
---|
{ "editDateTime": string, "description": string } |
Поля | |
---|---|
editDateTime | Только вывод. The date time when lead note was edited. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
description | Только вывод. Content of lead note. |
CreditDetails
Represents the credit details of a lead.
JSON-представление |
---|
{
"creditState": enum ( |
Поля | |
---|---|
creditState | Только вывод. Credit state of the lead. |
creditStateLastUpdateDateTime | Только вывод. The date time when the credit state of the lead was last updated. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
CreditState
Possible credit states of a lead.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
PENDING | Credit is pending. |
CREDITED | Credit request is complete. |
LocalServicesLeadConversation
Data from Local Services Lead Conversation. Contains details of Lead Conversation which is generated when user calls, messages or books service from advertiser. These are appended to a Lead. More info: https://ads.google.com/local-services-ads
JSON-представление |
---|
{ "resourceName": string, "id": string, "conversationChannel": enum ( |
Поля | |
---|---|
resourceName | Только вывод. The resource name of the local services lead conversation data. Local Services Lead Conversation resource name have the form |
id | Только вывод. ID of this Lead Conversation. |
conversationChannel | Только вывод. Type of GLS lead conversation, EMAIL, MESSAGE, PHONE_CALL, SMS, etc. |
participantType | Только вывод. Type of participant in the lead conversation, ADVERTISER or CONSUMER. |
lead | Только вывод. Resource name of Lead associated to the Lead Conversation. |
eventDateTime | Только вывод. The date time at which lead conversation was created by Local Services Ads. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" |
phoneCallDetails | Только вывод. Details of phone call conversation in case of PHONE_CALL. |
messageDetails | Только вывод. Details of message conversation in case of EMAIL, MESSAGE or SMS. |
ConversationType
Possible types of lead conversation.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
EMAIL | Email lead conversation. |
MESSAGE | Message lead conversation. |
PHONE_CALL | Phone call lead conversation. |
SMS | SMS lead conversation. |
BOOKING | Booking lead conversation. |
WHATSAPP | WhatsApp lead conversation. |
ADS_API | Lead conversation created through Google Ads API. |
ParticipantType
Possible types of lead conversation participant.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ADVERTISER | Local Services Ads Provider participant. |
CONSUMER | Local Services Ads Consumer participant. |
PhoneCallDetails
Represents details of a phone call conversation.
JSON-представление |
---|
{ "callDurationMillis": string, "callRecordingUrl": string } |
Поля | |
---|---|
callDurationMillis | Только вывод. The duration (in milliseconds) of the phone call (end to end). |
callRecordingUrl | Только вывод. URL to the call recording audio file. |
MessageDetails
Represents details of text message in case of email, message or SMS.
JSON-представление |
---|
{ "text": string, "attachmentUrls": [ string ] } |
Поля | |
---|---|
text | Только вывод. Textual content of the message. |
attachmentUrls[] | Только вывод. URL to the SMS or email attachments. These URLs can be used to download the contents of the attachment by using the developer token. |
AndroidPrivacyInteractionType
Enumerates interaction types
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
CLICK | The physical click interaction type. |
ENGAGED_VIEW | The 10 seconds engaged view interaction type. |
VIEW | The view (ad impression) interaction type. |
AndroidPrivacyNetworkType
Enumerates network types
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
SEARCH | Search Network. |
DISPLAY | Display Network. |
YOUTUBE | YouTube Network. |
Metrics
Metrics data.
JSON-представление |
---|
{ "historicalCreativeQualityScore": enum ( |
Поля | |
---|---|
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. |
skAdNetworkInstalls | The number of iOS Store Kit Ad Network conversions. |
skAdNetworkTotalConversions | The total 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" |
linkedSampleEntities[] | A list of up to 20 sample linked resources in which the asset is used. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
sampleBestPerformanceEntities[] | A list of up to 20 sample linked resources with impressions in the last 30 days where the asset had the AssetPerformanceLabel.BEST performance label. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
sampleGoodPerformanceEntities[] | A list of up to 20 sample linked resources with impressions in the last 30 days where the asset had the AssetPerformanceLabel.GOOD performance label. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
sampleLowPerformanceEntities[] | A list of up to 20 sample linked resources with impressions in the last 30 days where the asset had the AssetPerformanceLabel.LOW performance label. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
sampleLearningPerformanceEntities[] | A list of up to 20 sample linked resources with impressions in the last 30 days where the asset had the AssetPerformanceLabel.LEARNING performance label. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
sampleUnratedPerformanceEntities[] | A list of up to 20 sample linked resources with impressions in the last 30 days where the assets had AssetPerformanceLabel performance label other than BEST, GOOD, LOW, and LEARNING. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
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. |
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 . |
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. |
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 . |
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. |
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 . |
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. |
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 . |
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. |
crossDeviceConversionsValueMicros | The sum of the value of cross-device conversions, in micros. |
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. |
orders | Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. |
averageOrderValueMicros | Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. |
averageCartSize | Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. |
costOfGoodsSoldMicros | Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. |
grossProfitMicros | Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
grossProfitMargin | Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. |
revenueMicros | Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. |
unitsSold | Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. |
crossSellCostOfGoodsSoldMicros | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. |
crossSellGrossProfitMicros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. |
crossSellRevenueMicros | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. |
crossSellUnitsSold | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
leadCostOfGoodsSoldMicros | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. |
leadGrossProfitMicros | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
leadRevenueMicros | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. |
leadUnitsSold | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
uniqueUsers | The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. |
averageImpressionFrequencyPerUser | The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. |
linkedEntitiesCount | Number of linked resources in which the asset is used. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. |
assetPinnedTotalCount | Number of total usages in which the asset is pinned. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetPinnedAsHeadlinePositionOneCount | Number of entities in which the asset is pinned to headline 1. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetPinnedAsHeadlinePositionTwoCount | Number of entities in which the asset is pinned to headline 2. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetPinnedAsHeadlinePositionThreeCount | Number of entities in which the asset is pinned to headline 3. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetPinnedAsDescriptionPositionOneCount | Number of entities in which the asset is pinned to description 1. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetPinnedAsDescriptionPositionTwoCount | Number of entities in which the asset is pinned to description 2. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetBestPerformanceImpressionPercentage | Percentage of impressions the asset received in ads with AssetPerformanceLabel.BEST. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetGoodPerformanceImpressionPercentage | Percentage of impressions the asset received in ads with AssetPerformanceLabel.GOOD. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetLowPerformanceImpressionPercentage | Percentage of impressions the asset received in ads with AssetPerformanceLabel.LOW. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetLearningPerformanceImpressionPercentage | Percentage of impressions the asset received in ads with AssetPerformanceLabel.LEARNING. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetUnratedPerformanceImpressionPercentage | Percentage of impressions the asset received in ads with AssetPerformanceLabel other than BEST, GOOD, LOW, and LEARNING. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. |
assetBestPerformanceCostPercentage | Percentage of cost the asset received in ads with AssetPerformanceLabel.BEST. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Performance Max channel. |
assetGoodPerformanceCostPercentage | Percentage of cost the asset received in ads with AssetPerformanceLabel.GOOD. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Performance Max channel. |
assetLowPerformanceCostPercentage | Percentage of cost the asset received in ads with AssetPerformanceLabel.LOW. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Performance Max channel. |
assetLearningPerformanceCostPercentage | Percentage of cost the asset received in ads with AssetPerformanceLabel.LEARNING. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Performance Max channel. |
assetUnratedPerformanceCostPercentage | Percentage of cost the asset received in ads with AssetPerformanceLabel other than BEST, GOOD, LOW, and LEARNING. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Performance Max channel. |
InteractionEventType
Enum describing possible types of payable and free interactions.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
CLICK | Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events. |
ENGAGEMENT | The user's expressed intent to engage with the ad in-place. |
VIDEO_VIEW | User viewed a video ad. |
NONE | The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (for example, the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions. |
SearchVolumeRange
Search volume range. Actual search volume falls within this range.
JSON-представление |
---|
{ "min": string, "max": string } |
Поля | |
---|---|
min | Lower bound of search volume. |
max | Upper bound of search volume. |
Сегменты
Segment only fields.
JSON-представление |
---|
{ "adDestinationType": enum ( |
Поля | |
---|---|
adDestinationType | Ad Destination type. |
adNetworkType | Ad network type. |
budgetCampaignAssociationStatus | Budget campaign association status. |
clickType | Click type. |
conversionActionCategory | Conversion action category. |
conversionAttributionEventType | Conversion attribution event type. |
conversionLagBucket | An enum value representing the number of days between the impression and the conversion. |
conversionOrAdjustmentLagBucket | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
dayOfWeek | Day of the week, for example, MONDAY. |
device | Device to which metrics apply. |
externalConversionSource | External conversion source. |
hotelCheckInDayOfWeek | Hotel check-in day of week. |
hotelDateSelectionType | Hotel date selection type. |
hotelRateType | Hotel rate type. |
hotelPriceBucket | Hotel price bucket. |
keyword | Keyword criterion. |
monthOfYear | Month of the year, for example, January. |
placeholderType | Placeholder type. This is only used with feed item metrics. |
productChannel | Channel of the product. |
productChannelExclusivity | Channel exclusivity of the product. |
productCondition | Condition of the product. |
recommendationType | Recommendation type. |
searchEngineResultsPageType | Type of the search engine results page. |
searchTermMatchType | Match type of the keyword that triggered the ad, including variants. |
slot | Position of the ad. |
conversionValueRulePrimaryDimension | Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. |
skAdNetworkUserType | iOS Store Kit Ad Network user type. |
skAdNetworkAdEventType | iOS Store Kit Ad Network ad event type. |
skAdNetworkAttributionCredit | iOS Store Kit Ad Network attribution credit |
skAdNetworkCoarseConversionValue | iOS Store Kit Ad Network coarse conversion value. |
skAdNetworkSourceType | The source type where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or neither source domain nor source app were present in any postbacks sent by Apple. |
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. |
activityCity | Город, в котором доступна туристическая деятельность. |
activityCountry | Страна, в которой доступна туристическая деятельность. |
activityRating | Activity rating. |
activityState | Штат, в котором доступна туристическая деятельность. |
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. |
productCategoryLevel1 | Category (level 1) of the product. |
productCategoryLevel2 | Category (level 2) of the product. |
productCategoryLevel3 | Category (level 3) of the product. |
productCategoryLevel4 | Category (level 4) of the product. |
productCategoryLevel5 | Category (level 5) of the product. |
productBrand | Бренд продукта. |
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 | Название продукта. |
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. |
skAdNetworkFineConversionValue | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign. |
skAdNetworkRedistributedFineConversionValue | iOS Store Kit Ad Network redistributed fine conversion value. Google uses modeling on observed conversion values(obtained from Apple) to calculate conversions from SKAN postbacks where NULLs are returned. This column represents the sum of the modeled conversion values and the observed conversion values. See https://support.google.com/google-ads/answer/14892597 to lean more. |
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. |
skAdNetworkSourceDomain | Website where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. |
skAdNetworkPostbackSequenceIndex | iOS Store Kit Ad Network postback sequence index. |
assetInteractionTarget | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interactionOnThisAsset is true, it means the interactions are on this specific asset and when interactionOnThisAsset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with. |
AdDestinationType
Enumerates Google Ads destination types
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
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.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
SEARCH | Поиск Гугл. |
SEARCH_PARTNERS | Search partners. |
CONTENT | Display Network. |
MIXED | Межсетевая. |
YOUTUBE | YouTube |
GOOGLE_TV | Google TV |
BudgetCampaignAssociationStatus
A BudgetCampaignAssociationStatus segment.
JSON-представление |
---|
{
"status": enum ( |
Поля | |
---|---|
status | Budget campaign association status. |
campaign | The campaign resource name. |
BudgetCampaignAssociationStatus
Possible statuses of the association between the Budget and the Campaign.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ENABLED | The campaign is currently using the budget. |
REMOVED | The campaign is no longer using the budget. |
ClickType
Enumerates Google Ads click types.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
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 | Межсетевая. From Performance Max and Discovery Campaigns. |
AD_IMAGE | AD Images. |
ConversionAttributionEventType
The event type of conversions that are attributed to.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Представляет значение, неизвестное в этой версии. |
IMPRESSION | The conversion is attributed to an impression. |
INTERACTION | The conversion is attributed to an interaction. |
ConversionLagBucket
Enum representing the number of days between impression and conversion.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
LESS_THAN_ONE_DAY | Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
ONE_TO_TWO_DAYS | Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
TWO_TO_THREE_DAYS | Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
THREE_TO_FOUR_DAYS | Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
FOUR_TO_FIVE_DAYS | Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
FIVE_TO_SIX_DAYS | Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
SIX_TO_SEVEN_DAYS | Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
SEVEN_TO_EIGHT_DAYS | Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
EIGHT_TO_NINE_DAYS | Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
NINE_TO_TEN_DAYS | Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
TEN_TO_ELEVEN_DAYS | Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
ELEVEN_TO_TWELVE_DAYS | Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
TWELVE_TO_THIRTEEN_DAYS | Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
THIRTEEN_TO_FOURTEEN_DAYS | Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
FOURTEEN_TO_TWENTY_ONE_DAYS | Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
TWENTY_ONE_TO_THIRTY_DAYS | Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
THIRTY_TO_FORTY_FIVE_DAYS | Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
FORTY_FIVE_TO_SIXTY_DAYS | Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
SIXTY_TO_NINETY_DAYS | Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ConversionOrAdjustmentLagBucket
Enum representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
CONVERSION_LESS_THAN_ONE_DAY | Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
CONVERSION_ONE_TO_TWO_DAYS | Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
CONVERSION_TWO_TO_THREE_DAYS | Conversion lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
CONVERSION_THREE_TO_FOUR_DAYS | Conversion lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
CONVERSION_FOUR_TO_FIVE_DAYS | Conversion lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
CONVERSION_FIVE_TO_SIX_DAYS | Conversion lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
CONVERSION_SIX_TO_SEVEN_DAYS | Conversion lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
CONVERSION_SEVEN_TO_EIGHT_DAYS | Conversion lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
CONVERSION_EIGHT_TO_NINE_DAYS | Conversion lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
CONVERSION_NINE_TO_TEN_DAYS | Conversion lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
CONVERSION_TEN_TO_ELEVEN_DAYS | Conversion lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
CONVERSION_ELEVEN_TO_TWELVE_DAYS | Conversion lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
CONVERSION_TWELVE_TO_THIRTEEN_DAYS | Conversion lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS | Conversion lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS | Conversion lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS | Conversion lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS | Conversion lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS | Conversion lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
CONVERSION_SIXTY_TO_NINETY_DAYS | Conversion lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ADJUSTMENT_LESS_THAN_ONE_DAY | Conversion adjustment lag bucket from 0 to 1 day. 0 day is included, 1 day is not. |
ADJUSTMENT_ONE_TO_TWO_DAYS | Conversion adjustment lag bucket from 1 to 2 days. 1 day is included, 2 days is not. |
ADJUSTMENT_TWO_TO_THREE_DAYS | Conversion adjustment lag bucket from 2 to 3 days. 2 days is included, 3 days is not. |
ADJUSTMENT_THREE_TO_FOUR_DAYS | Conversion adjustment lag bucket from 3 to 4 days. 3 days is included, 4 days is not. |
ADJUSTMENT_FOUR_TO_FIVE_DAYS | Conversion adjustment lag bucket from 4 to 5 days. 4 days is included, 5 days is not. |
ADJUSTMENT_FIVE_TO_SIX_DAYS | Conversion adjustment lag bucket from 5 to 6 days. 5 days is included, 6 days is not. |
ADJUSTMENT_SIX_TO_SEVEN_DAYS | Conversion adjustment lag bucket from 6 to 7 days. 6 days is included, 7 days is not. |
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS | Conversion adjustment lag bucket from 7 to 8 days. 7 days is included, 8 days is not. |
ADJUSTMENT_EIGHT_TO_NINE_DAYS | Conversion adjustment lag bucket from 8 to 9 days. 8 days is included, 9 days is not. |
ADJUSTMENT_NINE_TO_TEN_DAYS | Conversion adjustment lag bucket from 9 to 10 days. 9 days is included, 10 days is not. |
ADJUSTMENT_TEN_TO_ELEVEN_DAYS | Conversion adjustment lag bucket from 10 to 11 days. 10 days is included, 11 days is not. |
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS | Conversion adjustment lag bucket from 11 to 12 days. 11 days is included, 12 days is not. |
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS | Conversion adjustment lag bucket from 12 to 13 days. 12 days is included, 13 days is not. |
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS | Conversion adjustment lag bucket from 13 to 14 days. 13 days is included, 14 days is not. |
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS | Conversion adjustment lag bucket from 14 to 21 days. 14 days is included, 21 days is not. |
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS | Conversion adjustment lag bucket from 21 to 30 days. 21 days is included, 30 days is not. |
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS | Conversion adjustment lag bucket from 30 to 45 days. 30 days is included, 45 days is not. |
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS | Conversion adjustment lag bucket from 45 to 60 days. 45 days is included, 60 days is not. |
ADJUSTMENT_SIXTY_TO_NINETY_DAYS | Conversion adjustment lag bucket from 60 to 90 days. 60 days is included, 90 days is not. |
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS | Conversion adjustment lag bucket from 90 to 145 days. 90 days is included, 145 days is not. |
CONVERSION_UNKNOWN | Conversion lag bucket UNKNOWN. This is for dates before conversion lag bucket was available in Google Ads. |
ADJUSTMENT_UNKNOWN | Conversion adjustment lag bucket UNKNOWN. This is for dates before conversion adjustment lag bucket was available in Google Ads. |
ExternalConversionSource
The external conversion source that is associated with a ConversionAction.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Представляет значение, неизвестное в этой версии. |
WEBPAGE | Conversion that occurs when a user navigates to a particular webpage after viewing an ad; Displayed in Google Ads UI as 'Website'. |
ANALYTICS | Conversion that comes from linked Google Analytics goal or transaction; Displayed in Google Ads UI as 'Analytics'. |
UPLOAD | Website conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from clicks'. |
AD_CALL_METRICS | Conversion that occurs when a user clicks on a call extension directly on an ad; Displayed in Google Ads UI as 'Calls from ads'. |
WEBSITE_CALL_METRICS | Conversion that occurs when a user calls a dynamically-generated phone number (by installed javascript) from an advertiser's website after clicking on an ad; Displayed in Google Ads UI as 'Calls from website'. |
STORE_VISITS | Conversion that occurs when a user visits an advertiser's retail store after clicking on a Google ad; Displayed in Google Ads UI as 'Store visits'. |
ANDROID_IN_APP | Conversion that occurs when a user takes an in-app action such as a purchase in an Android app; Displayed in Google Ads UI as 'Android in-app action'. |
IOS_IN_APP | Conversion that occurs when a user takes an in-app action such as a purchase in an iOS app; Displayed in Google Ads UI as 'iOS in-app action'. |
IOS_FIRST_OPEN | Conversion that occurs when a user opens an iOS app for the first time; Displayed in Google Ads UI as 'iOS app install (first open)'. |
APP_UNSPECIFIED | Legacy app conversions that do not have an AppPlatform provided; Displayed in Google Ads UI as 'Mobile app'. |
ANDROID_FIRST_OPEN | Conversion that occurs when a user opens an Android app for the first time; Displayed in Google Ads UI as 'Android app install (first open)'. |
UPLOAD_CALLS | Call conversion that is uploaded through ConversionUploadService; Displayed in Google Ads UI as 'Import from calls'. |
FIREBASE | Conversion that comes from a linked Firebase event; Displayed in Google Ads UI as 'Firebase'. |
CLICK_TO_CALL | Conversion that occurs when a user clicks on a mobile phone number; Displayed in Google Ads UI as 'Phone number clicks'. |
SALESFORCE | Conversion that comes from Salesforce; Displayed in Google Ads UI as 'Salesforce.com'. |
STORE_SALES_CRM | Conversion that comes from in-store purchases recorded by CRM; Displayed in Google Ads UI as 'Store sales (data partner)'. |
STORE_SALES_PAYMENT_NETWORK | Conversion that comes from in-store purchases from payment network; Displayed in Google Ads UI as 'Store sales (payment network)'. |
GOOGLE_PLAY | Codeless Google Play conversion; Displayed in Google Ads UI as 'Google Play'. |
THIRD_PARTY_APP_ANALYTICS | Conversion that comes from a linked third-party app analytics event; Displayed in Google Ads UI as 'Third-party app analytics'. |
GOOGLE_ATTRIBUTION | Conversion that is controlled by Google Attribution. |
STORE_SALES_DIRECT_UPLOAD | Store Sales conversion based on first-party or third-party merchant data uploads. Displayed in Google Ads UI as 'Store sales (direct upload)'. |
STORE_SALES | Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Displayed in Google Ads UI as 'Store sales'. |
SEARCH_ADS_360 | Conversions imported from Search Ads 360 Floodlight data. |
GOOGLE_HOSTED | Conversions that track local actions from Google's products and services after interacting with an ad. |
FLOODLIGHT | Conversions reported by Floodlight tags. |
ANALYTICS_SEARCH_ADS_360 | Conversions that come from Google Analytics specifically for Search Ads 360. Displayed in Google Ads UI as Analytics (SA360). |
FIREBASE_SEARCH_ADS_360 | Conversion that comes from a linked Firebase event for Search Ads 360. |
DISPLAY_AND_VIDEO_360_FLOODLIGHT | Conversion that is reported by Floodlight for DV360. |
HotelRateType
Enum describing possible hotel rate types.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
UNAVAILABLE | Rate type information is unavailable. |
PUBLIC_RATE | Rates available to everyone. |
QUALIFIED_RATE | A membership program rate is available and satisfies basic requirements like having a public rate available. UI treatment will strikethrough the public rate and indicate that a discount is available to the user. For more on Qualified Rates, visit https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates |
PRIVATE_RATE | Rates available to users that satisfy some eligibility criteria, for example, all signed-in users, 20% of mobile users, all mobile users in Canada, etc. |
HotelPriceBucket
Enum describing possible hotel price buckets.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
LOWEST_UNIQUE | Uniquely lowest price. Partner has the lowest price, and no other partners are within a small variance of that price. |
LOWEST_TIED | Tied for lowest price. Partner is within a small variance of the lowest price. |
NOT_LOWEST | Not lowest price. Partner is not within a small variance of the lowest price. |
ONLY_PARTNER_SHOWN | Partner was the only one shown. |
Ключевое слово
A Keyword criterion segment.
JSON-представление |
---|
{
"info": {
object ( |
Поля | |
---|---|
info | Keyword info. |
adGroupCriterion | The AdGroupCriterion resource name. |
SearchEngineResultsPageType
The type of the search engine results page.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ADS_ONLY | Only ads were contained in the search engine results page. |
ORGANIC_ONLY | Only organic results were contained in the search engine results page. |
ADS_AND_ORGANIC | Both ads and organic results were contained in the search engine results page. |
SearchTermMatchType
Possible match types for a keyword triggering an ad, including variants.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
BROAD | Broad match. |
EXACT | Полное совпадение. |
PHRASE | Phrase match. |
NEAR_EXACT | Exact match (close variant). |
NEAR_PHRASE | Phrase match (close variant). |
Slot
Enumerates possible positions of the Ad.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
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 | Межсетевая. |
ConversionValueRulePrimaryDimension
Identifies the primary dimension for conversion value rule stats.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
NO_RULE_APPLIED | For no-value-rule-applied conversions after value rule is enabled. |
ORIGINAL | Below are for value-rule-applied conversions: The original stats. |
NEW_VS_RETURNING_USER | When a new or returning customer condition is satisfied. |
GEO_LOCATION | When a query-time Geo location condition is satisfied. |
DEVICE | When a query-time browsing device condition is satisfied. |
AUDIENCE | When a query-time audience condition is satisfied. |
MULTIPLE | When multiple rules are applied. |
SkAdNetworkUserType
Enumerates SkAdNetwork user types
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
UNAVAILABLE | The value was not present in the postback or we do not have this data for other reasons. |
NEW_INSTALLER | The user installed the app for the first time. |
REINSTALLER | The user has previously installed the app. |
SkAdNetworkAdEventType
Enumerates SkAdNetwork ad event types
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
UNAVAILABLE | The value was not present in the postback or we do not have this data for other reasons. |
INTERACTION | The user interacted with the ad. |
VIEW | The user viewed the ad. |
SkAdNetworkSourceApp
A SkAdNetworkSourceApp segment.
JSON-представление |
---|
{ "skAdNetworkSourceAppId": string } |
Поля | |
---|---|
skAdNetworkSourceAppId | App id where the ad that drove the iOS Store Kit Ad Network install was shown. |
SkAdNetworkAttributionCredit
Enumerates SkAdNetwork attribution credits.
Перечисления | |
---|---|
UNSPECIFIED | Значение по умолчанию. This value is equivalent to null. |
UNKNOWN | The value is unknown in this API version. The true enum value cannot be returned in this API version or is not supported yet. |
UNAVAILABLE | The value was not present in the postback or we do not have this data for other reasons. |
WON | Google was the ad network that won ad attribution. |
CONTRIBUTED | Google qualified for attribution, but didn't win. |
SkAdNetworkSourceType
Enumerates SkAdNetwork source types
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
UNAVAILABLE | The source app ID or source domain was not present in the postback or we do not have this data for other reasons. |
WEBSITE | The ad was shown on a webpage. |
MOBILE_APPLICATION | The ad was shown on an app. |
AssetInteractionTarget
An AssetInteractionTarget segment.
JSON-представление |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Поля | |
---|---|
asset | 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
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
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. |