Campaign

Кампания.

JSON-представление 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Поля
resource Name

string

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

customers/{customerId}/campaigns/{campaignId}

primary Status

enum ( CampaignPrimaryStatus )

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

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

primary Status Reasons[]

enum ( CampaignPrimaryStatusReason )

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

Дает представление о том, почему кампания не работает или работает не оптимально. Эти причины объединяются для определения общего CampaignPrimaryStatus.

status

enum ( CampaignStatus )

Статус кампании.

При добавлении новой кампании статус по умолчанию становится ВКЛЮЧЕНО.

serving Status

enum ( CampaignServingStatus )

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

bidding Strategy System Status

enum ( BiddingStrategySystemStatus )

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

ad Serving Optimization Status

enum ( AdServingOptimizationStatus )

Статус оптимизации показа объявлений в кампании.

advertising Channel Type

enum ( AdvertisingChannelType )

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

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

Можно задать только при создании кампаний. После создания кампании поле нельзя изменить.

advertising Channel Sub Type

enum ( AdvertisingChannelSubType )

Неизменяемый. Необязательное уточнение advertisingChannelType . Должен быть допустимым подтипом типа родительского канала.

Можно задать только при создании кампаний. После создания кампании поле нельзя изменить.

url Custom Parameters[]

object ( CustomParameter )

Список сопоставлений, используемых для замены тегов пользовательских параметров в trackingUrlTemplate , finalUrls или mobile_final_urls .

local Services Campaign Settings

object ( LocalServicesCampaignSettings )

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

travel Campaign Settings

object ( TravelCampaignSettings )

Настройки туристической кампании.

demand Gen Campaign Settings

object ( DemandGenCampaignSettings )

Настройки кампании по формированию спроса.

video Campaign Settings

object ( VideoCampaignSettings )

Настройки видеокампании.

real Time Bidding Setting

object ( RealTimeBiddingSetting )

Настройки назначения ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange.

network Settings

object ( NetworkSettings )

Настройки сети для кампании.

hotel Setting

object ( HotelSettingInfo )

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

dynamic Search Ads Setting

object ( DynamicSearchAdsSetting )

Настройка управления динамическими поисковыми объявлениями (DSA).

shopping Setting

object ( ShoppingSetting )

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

targeting Setting

object ( TargetingSetting )

Настройка таргетинга на связанные функции.

geo Target Type Setting

object ( GeoTargetTypeSetting )

Настройка геотаргетинга объявлений.

local Campaign Setting

object ( LocalCampaignSetting )

Настройка локальной кампании.

app Campaign Setting

object ( AppCampaignSetting )

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

labels[]

string

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

experiment Type

enum ( CampaignExperimentType )

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

bidding Strategy Type

enum ( BiddingStrategyType )

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

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

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

accessible Bidding Strategy

string

Только вывод. Имя ресурса AccessibleBiddingStrategy — доступное только для чтения представление неограниченных атрибутов прикрепленной портфельной стратегии назначения ставок, идентифицированной как «biddingStrategy». Пусто, если в кампании не используется портфельная стратегия. Неограниченные атрибуты стратегии доступны всем клиентам, которым предоставлен общий доступ к стратегии, и считываются из ресурса AccessibleBiddingStrategy. Напротив, ограниченные атрибуты доступны только владельцу стратегии и его менеджерам. Атрибуты с ограниченным доступом можно прочитать только из ресурса BiddingStrategy.

frequency Caps[]

object ( FrequencyCapEntry )

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

video Brand Safety Suitability

enum ( BrandSafetySuitability )

Настройка безопасности бренда на уровне отдельной кампании. Позволяет выбрать тип инвентаря для показа рекламы на контенте, который подходит вашему бренду. См. https://support.google.com/google-ads/answer/7515513 .

vanity Pharma

object ( VanityPharma )

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

selective Optimization

object ( SelectiveOptimization )

Настройка выборочной оптимизации для этой кампании, которая включает в себя набор действий-конверсий для оптимизации этой кампании. Эта функция применима только к кампаниям для приложений, в которых MULTI_CHANNEL используется в качестве типа AdvertisingChannelType и APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT в качестве AdvertisingChannelSubType.

optimization Goal Setting

object ( OptimizationGoalSetting )

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

tracking Setting

object ( TrackingSetting )

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

payment Mode

enum ( PaymentMode )

Режим оплаты кампании.

excluded Parent Asset Field Types[]

enum ( AssetFieldType )

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

excluded Parent Asset Set Types[]

enum ( AssetSetType )

Типы наборов объектов, которые следует исключить из этой кампании. Ссылки на наборы активов этих типов не будут унаследованы этой кампанией с верхнего уровня. Типы групп местоположений (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP и STATIC_LOCATION_GROUP) являются дочерними типами LOCATION_SYNC. Таким образом, если для этого поля задано значение LOCATION_SYNC, все наборы активов группы местоположений не могут быть связаны с этой кампанией, и все расширения местоположений (LE) и расширения партнерских местоположений (ALE) не будут обслуживаться в рамках этой кампании. В настоящее время поддерживается только LOCATION_SYNC.

performance Max Upgrade

object ( PerformanceMaxUpgrade )

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

asset Automation Settings[]

object ( AssetAutomationSetting )

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

keyword Match Type

enum ( CampaignKeywordMatchType )

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

id

string ( int64 format)

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

name

string

Название кампании.

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

Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD).

tracking Url Template

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

audience Setting

object ( AudienceSetting )

Неизменяемый. Настройка функций, связанных с аудиторией.

base Campaign

string

Только вывод. Имя ресурса базовой кампании проекта или экспериментальной кампании. Для базовых кампаний это значение равно resourceName .

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

campaign Budget

string

Имя ресурса бюджета кампании.

start Date

string

Дата начала кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД.

campaign Group

string

Имя ресурса группы кампаний, к которой принадлежит эта кампания.

end Date

string

Последний день кампании по обслуживанию часового пояса клиента в формате ГГГГ-ММ-ДД. При создании по умолчанию используется 30 декабря 2037 г., что означает, что кампания будет длиться неопределенное время. Чтобы настроить существующую кампанию на неопределенный срок, установите в этом поле значение 30 декабря 2037 г.

final Url Suffix

string

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

optimization Score

number

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

Показатель оптимизации – это оценка эффективности кампании. Он варьируется от 0% (0,0) до 100% (1,0), при этом 100% указывает на то, что кампания работает на полную мощность. Это поле имеет значение null для кампаний без оценки.

См. раздел «О показателе оптимизации» на странице https://support.google.com/google-ads/answer/9061546 .

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

url Expansion Opt Out

boolean

Представляет собой отказ от расширения URL-адресов до более целевых URL-адресов. Если этот параметр отключен (true), таргетингом будут выбраны только конечные URL-адреса в группе объектов или URL-адреса, указанные в Google Merchant Center или фидах бизнес-данных рекламодателя. Если выбрано значение (false), целью будет весь домен. Это поле можно задать только для кампаний с максимальной эффективностью, где значение по умолчанию — false.

hotel Property Asset Set

string

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

listing Type

enum ( ListingType )

Неизменяемый. Листинговый тип объявлений, показанных в этой кампании. Поле запрещено использовать в кампаниях с максимальной эффективностью.

Поле объединения campaign_bidding_strategy . Стратегия назначения ставок для кампании.

Должно быть либо портфолио (созданное с помощью сервиса BiddingStrategy), либо стандартное, встроенное в кампанию. campaign_bidding_strategy может быть только одним из следующих:

bidding Strategy

string

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

commission

object ( Commission )

Комиссия – это стратегия автоматического назначения ставок, при которой рекламодатель платит определенную часть ценности конверсии.

manual Cpa

object ( ManualCpa )

Стандартная стратегия назначения ставок CPA вручную. Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем. Поддерживается только для кампаний "Местные услуги".

manual Cpc

object ( ManualCpc )

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

manual Cpm

object ( ManualCpm )

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

manual Cpv

object ( ManualCpv )

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

maximize Conversions

object ( MaximizeConversions )

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

maximize Conversion Value

object ( MaximizeConversionValue )

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

target Cpa

object ( TargetCpa )

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

target Impression Share

object ( TargetImpressionShare )

Стратегия назначения ставок «Целевой процент полученных показов». Стратегия автоматического назначения ставок, которая устанавливает ставки для достижения выбранного процента показов.

target Roas

object ( TargetRoas )

Стратегия назначения ставок «Стандартная целевая рентабельность инвестиций в рекламу», которая автоматически максимизирует доход, усредняя при этом определенную целевую рентабельность инвестиций в рекламу (ROAS).

target Spend

object ( TargetSpend )

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

percent Cpc

object ( PercentCpc )

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

target Cpm

object ( TargetCpm )

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

fixed Cpm

object ( FixedCpm )

Стратегия назначения ставок вручную с фиксированной ценой за тысячу показов.

target Cpv

object ( TargetCpv )

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

КампанияОсновнойстатус

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ELIGIBLE Кампания допущена к показу.
PAUSED Статус кампании, указанный пользователем, приостановлен.
REMOVED Статус кампании, указанный пользователем, удаляется.
ENDED Указанное пользователем время завершения этой кампании прошло.
PENDING Кампания может послужить в будущем.
MISCONFIGURED Кампания или связанные с ней объекты имеют неправильные настройки, указанные пользователем.
LIMITED Кампания или связанные с ней объекты ограничены заданными пользователем настройками.
LEARNING Система автоматического назначения ставок адаптируется к указанным пользователем изменениям в кампании или связанных с ней объектах.
NOT_ELIGIBLE Кампания не допущена к показу.

КампанияОсновнойСтатусПричина

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
CAMPAIGN_REMOVED Статус кампании, указанный пользователем, удаляется.
CAMPAIGN_PAUSED Статус кампании, указанный пользователем, приостановлен.
CAMPAIGN_PENDING Указанное пользователем время запуска этой кампании находится в будущем.
CAMPAIGN_ENDED Указанное пользователем время завершения этой кампании прошло.
CAMPAIGN_DRAFT Кампания является проектом.
BIDDING_STRATEGY_MISCONFIGURED Стратегия назначения ставок имеет неверные пользовательские настройки.
BIDDING_STRATEGY_LIMITED Стратегия назначения ставок ограничена заданными пользователем настройками, такими как отсутствие данных и т.п.
BIDDING_STRATEGY_LEARNING Система автоматического назначения ставок адаптируется к изменениям стратегии назначения ставок, указанным пользователем.
BIDDING_STRATEGY_CONSTRAINED Кампания может повысить ценность конверсий, скорректировав целевые значения цены за конверсию и рентабельности инвестиций в рекламу.
BUDGET_CONSTRAINED Бюджет ограничивает эффективность кампании.
BUDGET_MISCONFIGURED Бюджет имеет неверные пользовательские настройки.
SEARCH_VOLUME_LIMITED Кампания не ориентирована на все релевантные запросы.
AD_GROUPS_PAUSED Все указанные пользователем статусы групп объявлений приостановлены.
NO_AD_GROUPS В этой кампании не существует подходящих групп объявлений.
KEYWORDS_PAUSED Все указанные пользователем статусы ключевых слов приостановлены.
NO_KEYWORDS В этой кампании не существует подходящих ключевых слов.
AD_GROUP_ADS_PAUSED Все статусы объявлений в группах объявлений, заданных пользователем, приостановлены.
NO_AD_GROUP_ADS В этой кампании нет подходящих объявлений группы объявлений.
HAS_ADS_LIMITED_BY_POLICY По крайней мере одно объявление в этой кампании ограничено правилами.
HAS_ADS_DISAPPROVED По крайней мере одно объявление в этой кампании отклонено.
MOST_ADS_UNDER_REVIEW Большинство объявлений в этой кампании ожидают рассмотрения.
MISSING_LEAD_FORM_EXTENSION В кампании есть цель формы для потенциальных клиентов, но расширение формы для потенциальных клиентов отсутствует.
MISSING_CALL_EXTENSION В кампании есть цель звонка, но номер телефона отсутствует.
LEAD_FORM_EXTENSION_UNDER_REVIEW Расширение формы для потенциальных клиентов находится на рассмотрении.
LEAD_FORM_EXTENSION_DISAPPROVED Расширение потенциального клиента отклонено.
CALL_EXTENSION_UNDER_REVIEW Расширение находится на рассмотрении.
CALL_EXTENSION_DISAPPROVED Расширение телефона отклонено.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA В этой кампании не существует подходящих критериев группы объявлений для мобильных приложений.
CAMPAIGN_GROUP_PAUSED Статус группы кампаний, указанной пользователем, приостановлен.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED Указанное пользователем время действия всех групповых бюджетов, связанных с родительской группой кампаний, прошло.
APP_NOT_RELEASED Приложение, связанное с этой кампанией ACi, не выпускается в целевых странах кампании.
APP_PARTIALLY_RELEASED Приложение, связанное с этой кампанией ACi, частично выпущено в целевых странах кампании.
HAS_ASSET_GROUPS_DISAPPROVED По крайней мере одна группа объектов в этой кампании отклонена.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY По крайней мере одна группа объектов в этой кампании ограничена политикой.
MOST_ASSET_GROUPS_UNDER_REVIEW Большинство групп объектов в этой кампании ожидают рассмотрения.
NO_ASSET_GROUPS В этой кампании не существует подходящих групп объектов.
ASSET_GROUPS_PAUSED Все группы объектов в этой кампании приостановлены.

Статус кампании

Возможные статусы кампании.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ENABLED Кампания активна и может показывать рекламу.
PAUSED Кампания приостановлена ​​пользователем.
REMOVED Кампания удалена.

Статус обслуживания кампании

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

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение только для ответа.

SERVING Сервировка.
NONE Никто.
ENDED Закончено.
PENDING В ожидании.
SUSPENDED Приостановленный.

Стратегия ставок, статус системы

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

Перечисления
UNSPECIFIED Сигнализирует о том, что произошла непредвиденная ошибка, например, не найден тип стратегии назначения ставок или не найдена информация о статусе.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ENABLED Стратегия назначения ставок активна, и AdWords не может обнаружить с ней какие-либо конкретные проблемы.
LEARNING_NEW Стратегия назначения ставок находится в стадии обучения, поскольку она была недавно создана или недавно повторно активирована.
LEARNING_SETTING_CHANGE Стратегия назначения ставок находится в процессе обучения из-за недавнего изменения настроек.
LEARNING_BUDGET_CHANGE Стратегия назначения ставок находится в процессе обучения из-за недавнего изменения бюджета.
LEARNING_COMPOSITION_CHANGE Стратегия назначения ставок обучается из-за недавних изменений в количестве связанных с ней кампаний, групп объявлений или ключевых слов.
LEARNING_CONVERSION_TYPE_CHANGE Стратегия назначения ставок зависит от отчетов о конверсиях и от недавно измененных клиентом типов конверсий, соответствующих стратегии назначения ставок.
LEARNING_CONVERSION_SETTING_CHANGE Стратегия назначения ставок зависит от отчетов о конверсиях, и клиент недавно изменил свои настройки конверсий.
LIMITED_BY_CPC_BID_CEILING Стратегия ставок ограничена потолком ставки.
LIMITED_BY_CPC_BID_FLOOR Стратегия ставок ограничена минимальной ставкой.
LIMITED_BY_DATA Стратегия назначения ставок ограничена, поскольку за последние недели было недостаточно трафика конверсий.
LIMITED_BY_BUDGET Значительная часть ключевых слов в этой стратегии назначения ставок ограничена бюджетом.
LIMITED_BY_LOW_PRIORITY_SPEND Стратегия назначения ставок не может достичь целевого показателя расходов, поскольку ее приоритеты снижены.
LIMITED_BY_LOW_QUALITY Значительная часть ключевых слов в этой стратегии назначения ставок имеет низкий показатель качества.
LIMITED_BY_INVENTORY Стратегия назначения ставок не может полностью израсходовать свой бюджет из-за узкого таргетинга.
MISCONFIGURED_ZERO_ELIGIBILITY Отсутствует отслеживание конверсий (отсутствуют пинги) и/или списки ремаркетинга для SSC.
MISCONFIGURED_CONVERSION_TYPES Стратегия назначения ставок зависит от отчетов о конверсиях, и у клиента нет типов конверсий, о которых можно было бы сообщить в соответствии с этой стратегией.
MISCONFIGURED_CONVERSION_SETTINGS Стратегия назначения ставок зависит от отчетов о конверсиях, а настройки конверсий клиента настроены неправильно.
MISCONFIGURED_SHARED_BUDGET Существуют кампании, не входящие в стратегию назначения ставок, бюджет которых совпадает с бюджетом кампаний, включенных в стратегию.
MISCONFIGURED_STRATEGY_TYPE Кампания имеет недопустимый тип стратегии и не работает.
PAUSED Стратегия назначения ставок не активна. Либо к стратегии назначения ставок не привязаны активные кампании, группы объявлений или ключевые слова. Или к стратегии назначения ставок не подключены активные бюджеты.
UNAVAILABLE Эта стратегия назначения ставок в настоящее время не поддерживает отчеты о статусе.
MULTIPLE_LEARNING За рассматриваемый период для этой стратегии назначения ставок было несколько системных статусов LEARNING_*.
MULTIPLE_LIMITED За рассматриваемый период для этой стратегии назначения ставок было несколько системных статусов LIMITED_*.
MULTIPLE_MISCONFIGURED За рассматриваемый период для этой стратегии назначения ставок было несколько системных статусов MISCONFIGURED_*.
MULTIPLE За рассматриваемый период для этой стратегии назначения ставок было несколько системных статусов.

Статус оптимизации показа рекламы

Перечисление, описывающее возможные статусы обслуживания.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение только для ответа.

OPTIMIZE Показ объявлений оптимизируется на основе CTR кампании.
CONVERSION_OPTIMIZE Показ объявлений оптимизируется на основе CTR * Конверсия для кампании. Если кампания не включена в стратегию назначения ставок Оптимизатора конверсий, по умолчанию ей будет присвоено значение ОПТИМИЗИРОВАННАЯ.
ROTATE Объявления чередуются равномерно в течение 90 дней, а затем оптимизируются по количеству кликов.
ROTATE_INDEFINITELY Показывайте менее эффективные объявления более равномерно с более эффективными объявлениями и не оптимизируйте их.
UNAVAILABLE Статус оптимизации показа объявлений недоступен.

LocalServicesCampaignSettings

Настройки подресурса LocalServicesCampaign.

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

object ( CategoryBid )

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

КатегорияСтавка

Ставки по категориям в LocalServicesReportingCampaignSettings.

JSON-представление 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
Поля
category Id

string

Категория, с которой будет связана ставка. Например, xcat:service_area_business_plumber.

manual Cpa Bid Micros

string ( int64 format)

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

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

Настройки туристической кампании.

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

string ( int64 format)

Неизменяемый. Идентификатор учетной записи Travel, связанный с кампанией Travel.

Настройки кампаниигенерации спроса

Настройки кампании по формированию спроса.

JSON-представление 
{
  "upgradedTargeting": boolean
}
Поля
upgraded Targeting

boolean

Неизменяемый. Указывает, использует ли эта кампания обновленные параметры таргетинга. Если для этого поля установлено значение true , вы можете использовать таргетинг на местоположение и язык на уровне группы объявлений, а не на стандартном таргетинге на уровне кампании. По умолчанию это поле имеет значение false и может быть установлено только при создании кампании.

Настройки видеокампании

Настройки видеокампании.

JSON-представление 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Поля
video Ad Inventory Control

object ( VideoAdInventoryControl )

Управление запасами для адаптивных рекламных контейнеров в охватных кампаниях.

ВидеоAdInventoryControl

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

JSON-представление 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Поля
allow In Stream

boolean

Определите, можно ли использовать VideoResponsiveAds для видеообъявлений In-Stream.

allow In Feed

boolean

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

allow Shorts

boolean

Определите, можно ли использовать VideoResponsiveAds в качестве формата коротких видео.

Настройка ставок в реальном времени

Настройки назначения ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange.

JSON-представление 
{
  "optIn": boolean
}
Поля
opt In

boolean

Включено ли в кампании назначение ставок в реальном времени.

Настройки сети

Настройки сети для кампании.

JSON-представление 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
Поля
target Search Network

boolean

Будут ли показываться объявления на партнерских сайтах в поисковой сети Google (требуется, чтобы targetGoogleSearch также имел значение true ).

target Content Network

boolean

Будет ли реклама показываться на определенных местах размещения в контекстно-медийной сети Google. Места размещения определяются с использованием критерия Placement.

target Partner Search Network

boolean

Будут ли показываться объявления в партнерской сети Google. Это доступно только для некоторых учетных записей партнеров Google.

target Youtube

boolean

Будет ли показываться реклама на YouTube.

target Google Tv Network

boolean

Будет ли показываться реклама в сети Google TV.

Информация об отеле

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

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

string ( int64 format)

Неизменяемый. Связанная учетная запись Hotel Center.

Настройка динамической поисковой рекламы

Настройка управления динамическими поисковыми объявлениями (DSA).

JSON-представление 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
Поля
domain Name

string

Необходимый. Имя интернет-домена, которое представляет этот параметр, например «google.com» или «www.google.com».

language Code

string

Необходимый. Код языка, определяющий язык домена, например «en».

feeds[]

string

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

use Supplied Urls Only

boolean

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

ПокупкиНастройки

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

JSON-представление 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
Поля
feed Label

string

Ярлыки продуктов, которые нужно включить в кампанию. Можно установить только одно из значенийfeedLabel или sales_country. Если используется вместо sales_country, полеfeedLabel принимает коды стран в том же формате, например: «XX». В противном случае это может быть любая строка, используемая для метки фида в Google Merchant Center.

use Vehicle Inventory

boolean

Неизменяемый. Следует ли использовать таргетинг на инвентарь в списке транспортных средств. Это поле поддерживается только в умных торговых кампаниях. Чтобы настроить инвентарь для объявлений о транспортных средствах в кампаниях с максимальной эффективностью, используйте вместо этого listingType .

advertising Partner Ids[]

string ( int64 format)

Неизменяемый. Идентификаторы рекламных аккаунтов рекламных партнеров, сотрудничающих в рамках кампании.

merchant Id

string ( int64 format)

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

campaign Priority

integer

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

enable Local

boolean

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

disable Product Feed

boolean

Отключите дополнительный фид товаров. В настоящее время это поле поддерживается только для кампаний по формированию спроса. См . https://support.google.com/google-ads/answer/13721750, чтобы узнать больше об этой функции.

Настройка аудитории

Настройки таргетинга аудитории.

JSON-представление 
{
  "useAudienceGrouped": boolean
}
Поля
use Audience Grouped

boolean

Неизменяемый. Если это правда, эта кампания использует ресурс «Аудитория» для таргетинга на аудиторию. Если значение равно false, в этой кампании вместо этого могут использоваться критерии сегмента аудитории.

Настройка геотаржеттипесеттинг

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

JSON-представление 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Поля
positive Geo Target Type

enum ( PositiveGeoTargetType )

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

negative Geo Target Type

enum ( NegativeGeoTargetType )

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

ПозитивГеоТаржетТип

Возможные типы положительных географических целей.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
PRESENCE_OR_INTEREST Указывает, что объявление активируется, если пользователь находится в целевых местоположениях рекламодателя или проявляет к ним интерес.
SEARCH_INTEREST Указывает, что объявление активируется, если пользователь ищет целевые местоположения рекламодателя. Эту функцию можно использовать только в поисковых и стандартных торговых кампаниях.
PRESENCE Указывает, что объявление активируется, если пользователь находится или регулярно посещает целевые местоположения рекламодателя.

Негативеотаржеттипе

Возможные типы исключенных географических целей.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
PRESENCE_OR_INTEREST Указывает, что пользователь не может видеть рекламу, если он находится в исключенных местоположениях рекламодателя или проявляет к ним интерес.
PRESENCE Указывает, что пользователь не может видеть рекламу, если он находится в исключенных местоположениях рекламодателя.

Настройка локальной кампании

Настройка кампании для локальных кампаний.

JSON-представление 
{
  "locationSourceType": enum (LocationSourceType)
}
Поля
location Source Type

enum ( LocationSourceType )

Тип источника местоположения для этой локальной кампании.

МестоположениеИсточникТип

Возможные типы источника местоположения.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
GOOGLE_MY_BUSINESS Местоположение, связанное со связанным бизнес-профилем клиента.
AFFILIATE Адреса филиальных (сетевых) магазинов. Например, адреса магазинов Best Buy.

Настройка AppCampaignSetting

Настройки на уровне кампании для кампаний для приложений.

JSON-представление 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
Поля
bidding Strategy Goal Type

enum ( AppCampaignBiddingStrategyGoalType )

Обозначает цель, для достижения которой должна оптимизироваться стратегия назначения ставок в этой кампании для приложений.

app Store

enum ( AppCampaignAppStore )

Неизменяемый. Магазин приложений, распространяющий это конкретное приложение.

app Id

string

Неизменяемый. Строка, уникально идентифицирующая мобильное приложение.

AppCampaignBiddingStrategyGoalType

Тип цели кампании для приложений BiddingStrategy.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Стремитесь максимизировать количество установок приложения. Ставка CPA – это целевая цена за установку.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST Стремитесь максимизировать количество выбранных внутриигровых конверсий в результате установок приложения в долгосрочной перспективе. Ставка CPA – это целевая цена за установку.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST Стремитесь максимизировать количество выбранных внутриигровых конверсий в результате установок приложения в долгосрочной перспективе. Ставка CPA – это целевая цена за конверсию в приложении. Обратите внимание, что на первый взгляд фактическая цена за конверсию может показаться выше целевой, поскольку долгосрочные конверсии еще не произошли.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Стремитесь максимизировать ценность всех конверсий, например установки и выбранные конверсии в приложении, одновременно достигая или превышая целевую рентабельность инвестиций в рекламу.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Стремитесь максимально увеличить предварительную регистрацию приложения.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Стремитесь максимизировать установку приложения без целевой цены за установку.

AppCampaignAppStore

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
APPLE_APP_STORE Магазин приложений Apple.
GOOGLE_APP_STORE Гугл плей.

Тип кампанииЭксперимент

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
BASE Это обычная кампания.
DRAFT Это черновая версия кампании. В нее внесены некоторые изменения по сравнению с базовой кампанией, но она не отображает и не накапливает показатели.
EXPERIMENT Это экспериментальная версия кампании. В нее внесены некоторые изменения по сравнению с базовой кампанией, и часть трафика перенаправляется из БАЗОВОЙ кампании в эту экспериментальную кампанию.

Частота ограничения ввода

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

JSON-представление 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
Поля
key

object ( FrequencyCapKey )

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

cap

integer

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

ЧастотаCapKey

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

JSON-представление 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
Поля
level

enum ( FrequencyCapLevel )

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

event Type

enum ( FrequencyCapEventType )

Тип события, к которому применяется ограничение (например, показ).

time Unit

enum ( FrequencyCapTimeUnit )

Единица времени, в которой определяется ограничение (например, день, неделя).

time Length

integer

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

Уровень ограничения частоты

Уровень, на котором должно применяться ограничение (например, объявление группы объявлений, группа объявлений). Ограничение применяется ко всем ресурсам этого уровня.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
AD_GROUP_AD Ограничение применяется на уровне объявления группы объявлений.
AD_GROUP Ограничение применяется на уровне группы объявлений.
CAMPAIGN Ограничение применяется на уровне кампании.

ЧастотаКапЭвентТип

Тип события, к которому применяется ограничение (например, показ).

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

VanityPharma

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

JSON-представление 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
Поля
vanity Pharma Display Url Mode

enum ( VanityPharmaDisplayUrlMode )

Режим отображения URL-адресов косметических фармацевтических компаний.

vanity Pharma Text

enum ( VanityPharmaText )

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

VanityPharmaDisplayUrlMode

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
MANUFACTURER_WEBSITE_URL Замените URL-адрес Vanity Pharma URL-адресом веб-сайта производителя.
WEBSITE_DESCRIPTION Замените URL-адрес Vanity Pharma описанием веб-сайта.

ТщеславиеФарматекст

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
PRESCRIPTION_TREATMENT_WEBSITE_EN Веб-сайт рецептурного лечения с содержанием на английском языке.
PRESCRIPTION_TREATMENT_WEBSITE_ES Веб-сайт рецептурного лечения с контентом на испанском языке (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN Веб-сайт рецептурных устройств с содержанием на английском языке.
PRESCRIPTION_DEVICE_WEBSITE_ES Веб-сайт рецептурных устройств с содержанием на испанском языке (Sitio de dispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN Веб-сайт медицинского оборудования с содержанием на английском языке.
MEDICAL_DEVICE_WEBSITE_ES Веб-сайт медицинского оборудования с содержанием на испанском языке (Sitio de dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN Веб-сайт профилактического лечения с содержанием на английском языке.
PREVENTATIVE_TREATMENT_WEBSITE_ES Веб-сайт профилактического лечения с содержанием веб-сайта на испанском языке (Sitio de tratamientos preventivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN Веб-сайт, посвященный противозачаточным средствам, отпускаемым по рецепту, с содержанием на английском языке.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES Веб-сайт по рецептурным противозачаточным средствам с содержанием на испанском языке (Sitio de anticonceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN Веб-сайт рецептурных вакцин с содержанием на английском языке.
PRESCRIPTION_VACCINE_WEBSITE_ES Веб-сайт рецептурных вакцин с содержанием на испанском языке (Sitio de vacunas con receta).

ВыборочнаяОптимизация

Настройка выборочной оптимизации для этой кампании, которая включает в себя набор действий-конверсий для оптимизации этой кампании. Эта функция применима только к кампаниям для приложений, в которых MULTI_CHANNEL используется в качестве типа AdvertisingChannelType и APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT в качестве AdvertisingChannelSubType.

JSON-представление 
{
  "conversionActions": [
    string
  ]
}
Поля
conversion Actions[]

string

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

ОптимизацияНастройка целей

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

JSON-представление 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Поля
optimization Goal Types[]

enum ( OptimizationGoalType )

Список типов целей оптимизации.

Тип цели оптимизации

Тип цели оптимизации

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только как возвращаемое значение. Представляет значение, неизвестное в этой версии.
CALL_CLICKS Оптимизируйте клики по звонкам. Конверсии по кликам по телефону — это случаи, когда люди выбирали вариант "Позвонить", чтобы связаться с магазином после просмотра рекламы.
DRIVING_DIRECTIONS Оптимизация маршрутов движения. Конверсии по маршрутам движения – это случаи, когда люди выбирали вариант "Проложить маршрут", чтобы добраться до магазина после просмотра рекламы.
APP_PRE_REGISTRATION Оптимизация для предварительной регистрации. Конверсии по предварительной регистрации – это количество подписок, выполненных предварительной регистрацией, для получения уведомления о выпуске приложения.

Настройка отслеживания

Настройки на уровне кампании для отслеживания информации.

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

string

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

Режим оплаты

Перечисление, описывающее возможные способы оплаты.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
CLICKS Оплата за взаимодействие.
CONVERSION_VALUE Плата за ценность конверсии. Этот режим поддерживается только кампаниями с типами AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION и BudgetType.STANDARD.
CONVERSIONS Платите за конверсию. Этот режим поддерживается только кампаниями с AdvertisingChannelType.DISPLAY (за исключением AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA и BudgetType.FIXED_CPA. Клиент также должен иметь право на этот режим. Подробности см. в разделе Customer.eligibility_failure_reasons.
GUEST_STAY Оплата за стоимость проживания гостя. Этот режим поддерживается только кампаниями с типами AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION и BudgetType.STANDARD.

Обновление PerformanceMax

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

JSON-представление 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
Поля
performance Max Campaign

string

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

pre Upgrade Campaign

string

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

status

enum ( PerformanceMaxUpgradeStatus )

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

Статус PerformanceMaxUpgrade

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
UPGRADE_IN_PROGRESS Выполняется переход на кампанию с максимальной эффективностью.
UPGRADE_COMPLETE Переход на кампанию с максимальной эффективностью завершен.
UPGRADE_FAILED Не удалось перейти на кампанию с максимальной эффективностью. Кампания по-прежнему будет работать так же, как и до попытки обновления.
UPGRADE_ELIGIBLE Кампанию можно преобразовать в кампанию с максимальной эффективностью.

Тип листинга

Возможные типы листинга.

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

Настройка автоматизации активов

Настройка автоматизации активов содержит пару AssetAutomationType и статус включения/отключения автоматизации активов.

JSON-представление 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
Поля
asset Automation Type

enum ( AssetAutomationType )

Рекламодатель типа автоматизации объектов хочет дать свое согласие или отказ.

asset Automation Status

enum ( AssetAutomationStatus )

Статус согласия или отказа для типа автоматизации активов.

Активатоматионтип

Тип автоматизации активов.

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

Статус активаавтоматизации

Статус автоматизации активов.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только как возвращаемое значение. Представляет значение, неизвестное в этой версии.
OPTED_IN Согласие позволит создавать и обслуживать тип автоматизации активов.
OPTED_OUT Отказ от участия приведет к прекращению создания и обслуживания типа автоматизации объектов.

КампанияКлючевое словоТип соответствия

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

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
BROAD Широкое соответствие на уровне кампании.

Комиссия

Комиссия – это стратегия автоматического назначения ставок, при которой рекламодатель платит определенную часть ценности конверсии.

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

string ( int64 format)

Ставка комиссии определяет часть стоимости конверсии, за которую будет выставлен счет рекламодателю. Ставку комиссии x следует передать в это поле как (x * 1 000 000). Например, 106 000 представляет собой комиссионную ставку 0,106 (10,6%).

Ручная цена за конверсию

Этот тип не имеет полей.

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

Ручная цена за клик

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

JSON-представление 
{
  "enhancedCpcEnabled": boolean
}
Поля
enhanced Cpc Enabled

boolean

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

Ручная цена за тысячу показов

Этот тип не имеет полей.

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

Ручная цена за просмотр

Этот тип не имеет полей.

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

Процент цены за клик

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

JSON-представление 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Поля
cpc Bid Ceiling Micros

string ( int64 format)

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

enhanced Cpc Enabled

boolean

Корректирует ставку для каждого аукциона в сторону увеличения или уменьшения в зависимости от вероятности конверсии. Отдельные ставки могут превышать cpcBidCeilingMicros, но средняя сумма ставки для кампании не должна превышать.

Целевая цена за тысячу показов

Целевая цена за тысячу показов (стоимость за тысячу показов) – это стратегия автоматического назначения ставок, которая устанавливает ставки для оптимизации эффективности с учетом установленной вами целевой цены за тысячу показов.

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

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
Поля
goal с игры Союза. Дополнительная информация, связанная с целью ставок. goal может быть только одной из следующих:
target Frequency Goal

object ( TargetCpmTargetFrequencyGoal )

Сведения о цели назначения ставок по целевой частоте.

TargetCpmTargetFrequencyGoal

Сведения о цели назначения ставок по целевой частоте.

JSON-представление 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
Поля
target Count

string ( int64 format)

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

time Unit

enum ( TargetFrequencyTimeUnit )

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

Фиксированная цена за тысячу показов

Стратегия назначения ставок с фиксированной ценой за тысячу показов (стоимость за тысячу показов). Стратегия назначения ставок вручную с фиксированной ценой за тысячу показов.

JSON-представление 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
Поля
goal

enum ( FixedCpmGoal )

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

Поле объединения goal_info . Дополнительная информация, связанная с целью ставок. goal_info может быть только одним из следующих:
target Frequency Info

object ( FixedCpmTargetFrequencyGoalInfo )

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

Цель с фиксированной ценой за тысячу показов

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
REACH Максимальный охват, то есть количество пользователей, увидевших рекламу в этой кампании.
TARGET_FREQUENCY Участник назначения ставок с целевой частотой и ценой за тысячу показов. Оптимизируйте ставки, чтобы охватить одного пользователя с запрошенной частотой.

ФиксированнаяCpmTargetFrequencyGoalInfo

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

JSON-представление 
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
Поля
target Count

string ( int64 format)

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

time Unit

enum ( FixedCpmTargetFrequencyTimeUnit )

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

ФиксированныйCpmTargetFrequencyTimeUnit

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

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

Целевая цена за просмотр

Этот тип не имеет полей.

Стратегия назначения ставок «Целевая цена за просмотр». Стратегия автоматического назначения ставок, которая устанавливает ставки для оптимизации эффективности с учетом заданной вами целевой цены за просмотр.