- JSON-представление
- КампанияОсновнойстатус
- КампанияОсновнойСтатусПричина
- Статус кампании
- Статус обслуживания кампании
- Стратегия ставок, статус системы
- Статус оптимизации показа рекламы
- LocalServicesCampaignSettings
- КатегорияСтавка
- Настройки Кампании Путешествия
- Настройки кампании Discovery
- Настройка ставок в реальном времени
- Настройки сети
- Информация об отеле
- Настройка динамической поисковой рекламы
- ПокупкиНастройки
- Настройка аудитории
- Настройка геотаржеттипесеттинг
- ПозитивГеоТаржетТип
- Негативеотаржеттипе
- Настройка локальной кампании
- МестоположениеИсточникТип
- Настройка AppCampaignSetting
- AppCampaignBiddingStrategyGoalType
- AppCampaignAppStore
- Тип кампанииЭксперимент
- Частота ограничения ввода
- ЧастотаCapKey
- Уровень ограничения частоты
- ЧастотаКапЭвентТип
- БрендБезопасностьПригодность
- VanityPharma
- VanityPharmaDisplayUrlMode
- ТщеславиеФарматекст
- ВыборочнаяОптимизация
- ОптимизацияНастройка целей
- Тип цели оптимизации
- Настройка отслеживания
- Режим оплаты
- Обновление PerformanceMax
- Статус PerformanceMaxUpgrade
- Тип листинга
- Комиссия
- Ручная цена за конверсию
- Ручная цена за клик
- Ручная цена за тысячу показов
- Ручная цена за просмотр
- Процент цены за клик
- Целевая цена за тысячу показов
- TargetCpmTargetFrequencyGoal
- TargetFrequencyTimeUnit
Кампания.
JSON-представление |
---|
{ "resourceName": string, "primaryStatus": enum ( |
Поля | |
---|---|
resourceName | Неизменный. Имя ресурса кампании. Имена ресурсов кампании имеют вид: |
primaryStatus | Только вывод. Основной статус кампании. Дает представление о том, почему кампания не работает или работает не оптимально. Прежде чем изменения в кампании и связанных с ней объектах отразятся в этом статусе, может потребоваться некоторое время. |
primaryStatusReasons[] | Только вывод. Основные статусные причины кампании. Дает представление о том, почему кампания не работает или работает не оптимально. Эти причины объединяются для определения общего CampaignPrimaryStatus. |
status | Статус кампании. При добавлении новой кампании статус по умолчанию становится ВКЛЮЧЕНО. |
servingStatus | Только вывод. Статус показа объявлений в кампании. |
biddingStrategySystemStatus | Только вывод. Системный статус стратегии назначения ставок кампании. |
adServingOptimizationStatus | Статус оптимизации показа объявлений в кампании. |
advertisingChannelType | Неизменный. Основная цель показа объявлений в рамках кампании. Параметры таргетинга можно уточнить в Это поле является обязательным и не должно быть пустым при создании новых кампаний. Можно задать только при создании кампаний. После создания кампании поле нельзя изменить. |
advertisingChannelSubType | Неизменный. Необязательное уточнение Можно задать только при создании кампаний. После создания кампании поле нельзя изменить. |
urlCustomParameters[] | Список сопоставлений, используемых для замены тегов пользовательских параметров в |
localServicesCampaignSettings | Настройки, связанные с Кампанией местных услуг. |
travelCampaignSettings | Настройки туристической кампании. |
discoveryCampaignSettings | Настройки кампании Discovery. |
realTimeBiddingSetting | Настройки назначения ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange. |
networkSettings | Настройки сети для кампании. |
hotelSetting | Неизменный. Место проведения кампании в отеле. |
dynamicSearchAdsSetting | Настройка управления динамическими поисковыми объявлениями (DSA). |
shoppingSetting | Настройка управления торговыми кампаниями. |
targetingSetting | Настройка таргетинга на связанные функции. |
geoTargetTypeSetting | Настройка геотаргетинга объявлений. |
localCampaignSetting | Настройка локальной кампании. |
appCampaignSetting | Настройка, связанная с кампанией для приложений. |
labels[] | Только вывод. Названия ресурсов ярлыков, прикрепленных к этой кампании. |
experimentType | Только вывод. Тип кампании: обычная, черновая или экспериментальная. |
biddingStrategyType | Только вывод. Тип стратегии назначения ставок. Стратегию назначения ставок можно создать, задав либо схему назначения ставок для создания стандартной стратегии назначения ставок, либо поле Это поле доступно только для чтения. |
accessibleBiddingStrategy | Только вывод. Имя ресурса AccessibleBiddingStrategy — доступное только для чтения представление неограниченных атрибутов прикрепленной портфельной стратегии назначения ставок, идентифицированной как «biddingStrategy». Пусто, если в кампании не используется портфельная стратегия. Неограниченные атрибуты стратегии доступны всем клиентам, которым предоставлен общий доступ к стратегии, и считываются из ресурса AccessibleBiddingStrategy. Напротив, ограниченные атрибуты доступны только владельцу стратегии и его менеджерам. Атрибуты с ограниченным доступом можно прочитать только из ресурса BiddingStrategy. |
frequencyCaps[] | Список, ограничивающий частоту просмотра рекламы этой кампании каждым пользователем. |
videoBrandSafetySuitability | Только вывод. Настройка безопасности бренда на уровне отдельной кампании. Позволяет выбрать тип инвентаря для показа рекламы на контенте, который подходит вашему бренду. См. https://support.google.com/google-ads/answer/7515513 . |
vanityPharma | Описывает, как будет отображаться реклама фармацевтической продукции без бренда. |
selectiveOptimization | Настройка выборочной оптимизации для этой кампании, которая включает в себя набор действий-конверсий для оптимизации этой кампании. Эта функция применима только к кампаниям для приложений, которые используют MULTI_CHANNEL в качестве типа AdvertisingChannelType и APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT в качестве AdvertisingChannelSubType. |
optimizationGoalSetting | Настройка цели оптимизации для этой кампании, которая включает набор типов целей оптимизации. |
trackingSetting | Только вывод. Настройки на уровне кампании для отслеживания информации. |
paymentMode | Режим оплаты кампании. |
excludedParentAssetFieldTypes[] | Типы полей активов, которые следует исключить из этой кампании. Ссылки на активы с этими типами полей не будут унаследованы этой кампанией с верхнего уровня. |
excludedParentAssetSetTypes[] | Типы наборов объектов, которые следует исключить из этой кампании. Ссылки на наборы активов этих типов не будут унаследованы этой кампанией с верхнего уровня. Типы групп местоположений (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP и STATIC_LOCATION_GROUP) являются дочерними типами LOCATION_SYNC. Таким образом, если для этого поля задано значение LOCATION_SYNC, все наборы активов группы местоположений не могут быть связаны с этой кампанией, и все расширения местоположений (LE) и расширения партнерских местоположений (ALE) не будут обслуживаться в рамках этой кампании. В настоящее время поддерживается только LOCATION_SYNC. |
performanceMaxUpgrade | Только вывод. Информация о кампаниях, которые будут переведены на эффективность с максимальной эффективностью. |
id | Только вывод. Идентификатор кампании. |
name | Название кампании. Это поле является обязательным и не должно быть пустым при создании новых кампаний. Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD). |
trackingUrlTemplate | Шаблон URL-адреса для создания URL-адреса отслеживания. |
audienceSetting | Неизменный. Настройка функций, связанных с аудиторией. |
baseCampaign | Только вывод. Имя ресурса базовой кампании проекта или экспериментальной кампании. Для базовых кампаний это значение равно Это поле доступно только для чтения. |
campaignBudget | Бюджет кампании. |
startDate | Дата начала кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД. |
campaignGroup | Группа кампаний, к которой принадлежит эта кампания. |
endDate | Последний день кампании по обслуживанию часового пояса клиента в формате ГГГГ-ММ-ДД. При создании по умолчанию используется 30 декабря 2037 г., что означает, что кампания будет длиться неопределенное время. Чтобы настроить существующую кампанию на неопределенный срок, установите в этом поле значение 30 декабря 2037 г. |
finalUrlSuffix | Суффикс, используемый для добавления параметров запроса к целевым страницам, которые обслуживаются с помощью параллельного отслеживания. |
optimizationScore | Только вывод. Показатель оптимизации кампании. Показатель оптимизации – это оценка эффективности кампании. Он варьируется от 0% (0,0) до 100% (1,0), при этом 100% указывает на то, что кампания работает на полную мощность. Это поле имеет значение null для кампаний без оценки. См. раздел «О показателе оптимизации» на странице https://support.google.com/google-ads/answer/9061546 . Это поле доступно только для чтения. |
urlExpansionOptOut | Представляет собой отказ от расширения URL-адресов до более целевых URL-адресов. Если этот параметр отключен (true), таргетингом будут выбраны только конечные URL-адреса в группе объектов или URL-адреса, указанные в Google Merchant Center или фидах бизнес-данных рекламодателя. Если выбрано значение (false), целью будет весь домен. Это поле можно задать только для кампаний с максимальной эффективностью, где значение по умолчанию — false. |
hotelPropertyAssetSet | Неизменный. Набор объектов отелей для кампаний с максимальной эффективностью для целей путешествий. |
listingType | Неизменный. Листинговый тип объявлений, показанных в этой кампании. Поле запрещено использовать в кампаниях с максимальной эффективностью. |
Поле объединения Должно быть либо портфолио (созданное с помощью сервиса BiddingStrategy), либо стандартное, встроенное в кампанию. | |
biddingStrategy | Пакетная стратегия назначения ставок, используемая кампанией. |
commission | Комиссия – это стратегия автоматического назначения ставок, при которой рекламодатель платит определенную часть ценности конверсии. |
manualCpa | Стандартная стратегия назначения ставок CPA вручную. Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем. Поддерживается только для кампаний "Местные услуги". |
manualCpc | Стандартная стратегия назначения цен за клик вручную. Назначение ставок вручную на основе кликов, при котором пользователь платит за клик. |
manualCpm | Стандартная стратегия назначения ставок вручную с ценой за тысячу показов. Назначение ставок вручную на основе показов, при котором пользователь платит за тысячу показов. |
manualCpv | Стратегия назначения ставок, при которой выплачивается настраиваемая сумма за просмотр видео. |
maximizeConversions | Стандартная стратегия назначения ставок "Максимум конверсий", которая автоматически увеличивает количество конверсий при расходе бюджета. |
maximizeConversionValue | Стандартная стратегия назначения ставок "Максимальная ценность конверсии", которая автоматически назначает ставки, чтобы максимизировать доход при расходовании бюджета. |
targetCpa | Стандартная стратегия назначения ставок «Целевая цена за конверсию», которая автоматически назначает ставки, чтобы получить как можно больше конверсий по заданной вами целевой цене за конверсию. |
targetImpressionShare | Стратегия назначения ставок «Целевой процент полученных показов». Стратегия автоматического назначения ставок, которая устанавливает ставки для достижения выбранного процента показов. |
targetRoas | Стратегия назначения ставок «Стандартная целевая рентабельность инвестиций в рекламу», которая автоматически максимизирует доход, усредняя при этом определенную целевую рентабельность инвестиций в рекламу (ROAS). |
targetSpend | Стандартная стратегия назначения ставок с целевыми расходами, которая автоматически устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета. |
percentCpc | Стандартная стратегия назначения ставок в виде процента за клик, при которой ставки представляют собой долю рекламируемой цены на какой-либо товар или услугу. |
targetCpm | Стратегия назначения ставок, которая автоматически оптимизирует цену за тысячу показов. |
КампанияОсновнойстатус
Перечисление, описывающее возможный основной статус кампании. Дает представление о том, почему кампания не работает или работает не оптимально. Прежде чем изменения в кампании и связанных с ней объектах отразятся в этом статусе, может потребоваться некоторое время.
Перечисления | |
---|---|
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 | Большинство групп объектов в этой кампании ожидают рассмотрения. |
Статус кампании
Возможные статусы кампании.
Перечисления | |
---|---|
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 ( |
Поля | |
---|---|
categoryBids[] | Ставки категориального уровня, связанные со стратегией назначения ставок MANUAL_CPA. |
КатегорияСтавка
Ставки по категориям в LocalServicesReportingCampaignSettings.
JSON-представление |
---|
{ "categoryId": string, "manualCpaBidMicros": string } |
Поля | |
---|---|
categoryId | Категория, к которой будет относиться ставка. Например, xcat:service_area_business_plumber. |
manualCpaBidMicros | Ручная установка цены за конверсию для категории. Ставка должна быть выше резервной цены, связанной с этой категорией. Стоимость указана в микромикронах и в валюте рекламодателя. |
Настройки кампании Путешествия
Настройки туристической кампании.
JSON-представление |
---|
{ "travelAccountId": string } |
Поля | |
---|---|
travelAccountId | Неизменный. Идентификатор учетной записи Travel, связанный с кампанией Travel. |
Настройки кампании Discovery
Настройки кампании Discovery.
JSON-представление |
---|
{ "upgradedTargeting": boolean } |
Поля | |
---|---|
upgradedTargeting | Неизменный. Указывает, использует ли эта кампания обновленные параметры таргетинга. Если для этого поля установлено значение |
Настройка ставок в реальном времени
Настройки назначения ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange.
JSON-представление |
---|
{ "optIn": boolean } |
Поля | |
---|---|
optIn | Включено ли в кампании назначение ставок в реальном времени. |
Настройки сети
Настройки сети для кампании.
JSON-представление |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Поля | |
---|---|
targetGoogleSearch | Будет ли реклама показываться в результатах поиска google.com. |
targetSearchNetwork | Будут ли показываться объявления на партнерских сайтах в поисковой сети Google (требуется, чтобы |
targetContentNetwork | Будет ли реклама показываться на определенных местах размещения в контекстно-медийной сети Google. Места размещения определяются с использованием критерия Placement. |
targetPartnerSearchNetwork | Будут ли показываться объявления в партнерской сети Google. Это доступно только для некоторых учетных записей партнеров Google. |
Информация об отеле
Настройки на уровне кампании для рекламы отелей.
JSON-представление |
---|
{ "hotelCenterId": string } |
Поля | |
---|---|
hotelCenterId | Неизменный. Связанная учетная запись Hotel Center. |
Настройка динамической поисковой рекламы
Настройка управления динамическими поисковыми объявлениями (DSA).
JSON-представление |
---|
{ "domainName": string, "languageCode": string, "feeds": [ string ], "useSuppliedUrlsOnly": boolean } |
Поля | |
---|---|
domainName | Необходимый. Имя домена Интернета, которое представляет этот параметр, например «google.com» или «www.google.com». |
languageCode | Необходимый. Код языка, определяющий язык домена, например «en». |
feeds[] | Список каналов страниц, связанных с кампанией. |
useSuppliedUrlsOnly | Используются ли в кампании исключительно URL-адреса, предоставленные рекламодателем. |
ПокупкиНастройки
Настройка торговых кампаний. Определяет набор продуктов, которые могут рекламироваться в рамках кампании, а также то, как эта кампания взаимодействует с другими торговыми кампаниями.
JSON-представление |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "advertisingPartnerIds": [ string ], "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Поля | |
---|---|
feedLabel | Ярлыки фида продуктов, которые нужно включить в кампанию. Можно установить только одно из значений: FeedLabel или SalesCountry. Если используется вместо salesCountry, полеfeedLabel принимает коды стран в том же формате, например: «XX». В противном случае это может быть любая строка, используемая для метки фида в Google Merchant Center. |
useVehicleInventory | Неизменный. Следует ли ориентироваться на инвентарь в списке транспортных средств. Это поле поддерживается только в умных торговых кампаниях. Чтобы настроить инвентарь для объявлений о транспортных средствах в кампаниях с максимальной эффективностью, используйте вместо него |
advertisingPartnerIds[] | Неизменный. Идентификаторы рекламных аккаунтов рекламных партнеров, сотрудничающих в рамках кампании. |
merchantId | Неизменный. Идентификатор аккаунта Merchant Center. Это поле является обязательным для операций создания. Это поле является неизменным для торговых кампаний. |
salesCountry | Страна продаж продуктов, которые будут включены в кампанию. Можно установить только одно из значений: FeedLabel или SalesCountry. Поле неизменяемо, за исключением очистки. Как только это поле будет очищено, вы должны будете использоватьfeedLabel, если хотите установить страну продаж. |
campaignPriority | Приоритет кампании. Кампании с более высоким приоритетом имеют приоритет над кампаниями с более низким приоритетом. Это поле обязательно для торговых кампаний со значениями от 0 до 2 включительно. Это поле является необязательным для умных торговых кампаний, но если оно установлено, оно должно быть равно 3. |
enableLocal | Включать ли местные продукты. |
Настройка аудитории
Настройки таргетинга аудитории.
JSON-представление |
---|
{ "useAudienceGrouped": boolean } |
Поля | |
---|---|
useAudienceGrouped | Неизменный. Если это правда, эта кампания использует ресурс «Аудитория» для таргетинга на аудиторию. Если значение равно false, в этой кампании вместо этого могут использоваться критерии сегмента аудитории. |
Настройка геотаржеттипесеттинг
Представляет собой набор настроек, связанных с геотаргетингом объявлений.
JSON-представление |
---|
{ "positiveGeoTargetType": enum ( |
Поля | |
---|---|
positiveGeoTargetType | Настройка, используемая для позитивного геотаргетинга в этой конкретной кампании. |
negativeGeoTargetType | Настройка, используемая для негативного геотаргетинга в этой конкретной кампании. |
ПозитивГеоТаржетТип
Возможные типы положительных географических целей.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
PRESENCE_OR_INTEREST | Указывает, что объявление активируется, если пользователь находится в целевых местоположениях рекламодателя или проявляет к ним интерес. |
SEARCH_INTEREST | Указывает, что объявление активируется, если пользователь ищет целевые местоположения рекламодателя. Эту функцию можно использовать только в поисковых и стандартных торговых кампаниях. |
PRESENCE | Указывает, что объявление активируется, если пользователь находится или регулярно посещает целевые местоположения рекламодателя. |
Негативеотаржеттипе
Возможные типы исключенных географических целей.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
PRESENCE_OR_INTEREST | Указывает, что пользователь не может видеть рекламу, если он находится в исключенных местоположениях рекламодателя или проявляет к ним интерес. |
PRESENCE | Указывает, что пользователь не может видеть рекламу, если он находится в исключенных местоположениях рекламодателя. |
Настройка локальной кампании
Настройка кампании для локальных кампаний.
JSON-представление |
---|
{
"locationSourceType": enum ( |
Поля | |
---|---|
locationSourceType | Тип источника местоположения для этой локальной кампании. |
МестоположениеИсточникТип
Возможные типы источника местоположения.
Перечисления | |
---|---|
UNSPECIFIED | Значение не указано. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
GOOGLE_MY_BUSINESS | Местоположение, связанное со связанным бизнес-профилем клиента. |
AFFILIATE | Адреса филиальных (сетевых) магазинов. Например, адреса магазинов Best Buy. |
Настройка AppCampaignSetting
Настройки на уровне кампании для кампаний для приложений.
JSON-представление |
---|
{ "biddingStrategyGoalType": enum ( |
Поля | |
---|---|
biddingStrategyGoalType | Обозначает цель, для достижения которой должна оптимизироваться стратегия назначения ставок в этой кампании для приложений. |
appStore | Неизменный. Магазин приложений, распространяющий это конкретное приложение. |
appId | Неизменный. Строка, которая однозначно идентифицирует мобильное приложение. |
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 ( |
Поля | |
---|---|
key | Ключ определенного ограничения частоты показов. Для одного и того же ключа не может быть более одного ограничения частоты показов. |
cap | Максимальное количество событий, разрешенное в течение периода времени, установленного этим ограничением. |
ЧастотаCapKey
Группа полей, используемых в качестве ключей для ограничения частоты показов. Для одного и того же ключа не может быть более одного ограничения частоты показов.
JSON-представление |
---|
{ "level": enum ( |
Поля | |
---|---|
level | Уровень, на котором должно применяться ограничение (например, объявление группы объявлений, группа объявлений). Ограничение применяется ко всем сущностям этого уровня. |
eventType | Тип события, к которому применяется ограничение (например, показ). |
timeUnit | Единица времени, в которой определяется ограничение (например, день, неделя). |
timeLength | Количество единиц времени, в течение которых действует ограничение. |
Уровень ограничения частоты
Уровень, на котором должно применяться ограничение (например, объявление группы объявлений, группа объявлений). Ограничение применяется ко всем ресурсам этого уровня.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
AD_GROUP_AD | Ограничение применяется на уровне объявления группы объявлений. |
AD_GROUP | Ограничение применяется на уровне группы объявлений. |
CAMPAIGN | Ограничение применяется на уровне кампании. |
ЧастотаКапЭвентТип
Тип события, к которому применяется ограничение (например, показ).
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
IMPRESSION | Ограничение применяется к показам объявлений. |
VIDEO_VIEW | Ограничение распространяется на просмотры видеорекламы. |
БрендБезопасностьПригодность
Трехуровневый контроль соответствия безопасности бренда.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
EXPANDED_INVENTORY | Этот параметр позволяет показывать рекламу на всех ресурсах YouTube и видеопартнеров, которые соответствуют нашим стандартам монетизации. Этот вариант может быть подходящим выбором для брендов, которым нужен максимальный доступ ко всему спектру видеороликов, подходящих для рекламы, включая, например, видеоролики, содержащие сильную ненормативную лексику в контексте комедии или документального фильма, или чрезмерное насилие, как в видеоиграх. . |
STANDARD_INVENTORY | Этот параметр позволяет показывать рекламу в широком спектре контента, подходящем для большинства брендов, например в популярных музыкальных клипах, документальных фильмах и трейлерах к фильмам. Контент, в котором вы можете показывать рекламу, основан на рекомендациях YouTube по созданию контента, ориентированных на рекламодателей, которые учитывают, например, силу или частоту ненормативной лексики или уместность темы, например деликатные события. Объявления не будут показываться, например, в контенте, содержащем повторяющуюся грубую ненормативную лексику, откровенный сексуальный контент или изображения насилия. |
LIMITED_INVENTORY | Эта опция позволяет показывать рекламу в ограниченном диапазоне контента, подходящем для брендов с особенно строгими правилами в отношении ненормативной лексики и сексуального содержания; сверх того, что указано в правилах YouTube по созданию контента, ориентированного на рекламодателей. Видео, доступные в этой деликатной категории, отвечают повышенным требованиям, особенно в отношении ненормативной лексики и сексуального содержания. Например, ваша реклама будет исключена из показа в некоторых самых популярных музыкальных клипах YouTube и другом контенте, посвященном поп-культуре, на YouTube и видеопартнерах Google. |
VanityPharma
Описывает, как будет отображаться реклама фармацевтической продукции без бренда.
JSON-представление |
---|
{ "vanityPharmaDisplayUrlMode": enum ( |
Поля | |
---|---|
vanityPharmaDisplayUrlMode | Режим отображения URL-адресов косметических фармацевтических компаний. |
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 ] } |
Поля | |
---|---|
conversionActions[] | Выбранный набор действий-конверсий для оптимизации данной кампании. |
ОптимизацияНастройка целей
Настройка цели оптимизации для этой кампании, которая включает набор типов целей оптимизации.
JSON-представление |
---|
{
"optimizationGoalTypes": [
enum ( |
Поля | |
---|---|
optimizationGoalTypes[] | Список типов целей оптимизации. |
Тип цели оптимизации
Тип цели оптимизации
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только как возвращаемое значение. Представляет значение, неизвестное в этой версии. |
CALL_CLICKS | Оптимизируйте клики по звонкам. Конверсии по кликам по телефону – это случаи, когда люди выбирали вариант "Позвонить", чтобы связаться с магазином после просмотра рекламы. |
DRIVING_DIRECTIONS | Оптимизация маршрутов движения. Конверсии по маршрутам движения – это случаи, когда люди выбирали вариант "Проложить маршрут", чтобы добраться до магазина после просмотра рекламы. |
APP_PRE_REGISTRATION | Оптимизация для предварительной регистрации. Конверсии по предварительной регистрации – это количество подписок, выполненных предварительной регистрацией, для получения уведомления о выпуске приложения. |
Настройка отслеживания
Настройки на уровне кампании для отслеживания информации.
JSON-представление |
---|
{ "trackingUrl": string } |
Поля | |
---|---|
trackingUrl | Только вывод. 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 ( |
Поля | |
---|---|
performanceMaxCampaign | Только вывод. Указывает, до какой кампании с максимальной эффективностью обновляется кампания. |
preUpgradeCampaign | Только вывод. Указывает на устаревшую кампанию, обновленную до кампании с максимальной эффективностью. |
status | Только вывод. Статус обновления кампании, которую требуется повысить до эффективности с максимальной эффективностью. |
Статус PerformanceMaxUpgrade
Перечисление статуса обновления с максимальной эффективностью для кампании.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
UPGRADE_ELIBIGLE | Кампанию можно преобразовать в кампанию с максимальной эффективностью. |
UPGRADE_IN_PROGRESS | Выполняется переход на кампанию с максимальной эффективностью. |
UPGRADE_COMPLETE | Переход на кампанию с максимальной эффективностью завершен. |
UPGRADE_FAILED | Обновление до кампании Max Max провалилось. Кампания все еще будет послужить до того, как была предпринята попытка обновления. |
ListingType
Возможные типы листинга.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
VEHICLES | Эта кампания обслуживает рекламу автомобилей. |
Комиссия
Комиссия - это автоматическая стратегия торгов, в которой рекламодатель платит определенную часть конверсионной стоимости.
Представление JSON |
---|
{ "commissionRateMicros": string } |
Поля | |
---|---|
commissionRateMicros | Комиссионная ставка определяет часть конверсионной стоимости, которую рекламодатель будет выставлен. Комиссионная ставка X должна быть передана в эту область как (x 1 000 000). Например, 106 000 представляют ставку комиссии 0,106 (10,6%). |
Manualcpa
Этот тип не имеет полей.
Стратегия ручной торговли, которая позволяет рекламодателю установить предложение на предложение по рекламодателю.
Manualcpc
Руководство на основе кликов, где пользователь оплачивает за клик.
Представление JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Поля | |
---|---|
enhancedCpcEnabled | Должны ли предложения быть улучшенными на основе данных оптимизатора конверсии. |
Manualcpm
Этот тип не имеет полей.
Ручные впечатления, основанные на торгах, где пользователь платит за тысячу впечатлений.
Manualcpv
Этот тип не имеет полей.
Просмотр торгов, где пользователь платит за видео.
Процент CPC
Стратегия торгов, где ставки - это часть рекламируемой цены на что -то хорошее или услуги.
Представление JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Поля | |
---|---|
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией ставки. Это необязательное поле, введенное рекламодателем и указанное в локальных Micros. Примечание. Нулевое значение интерпретируется так же, как и BID_CEILINE не определен. |
enhancedCpcEnabled | Регулирует ставку для каждого аукциона вверх или вниз, в зависимости от вероятности конверсии. Индивидуальные предложения могут превышать CPCBidceIlingMicros, но средняя сумма предложения для кампании не должна. |
TargetCpm
Целевой CPM (стоимость за тысячу показов) - это автоматическая стратегия ставок, которая устанавливает ставки для оптимизации производительности, учитывая целевую CPM, которую вы устанавливаете.
Представление JSON |
---|
{ // Union field |
Поля | |
---|---|
Полевой goal Союза. Дополнительная информация, связанная с целью торгов. goal может быть только одной из следующих: | |
targetFrequencyGoal | Целевая частотная ставка детали цели. |
TargetCpmTargetFrequencyGoal
Целевая частотная ставка детали цели.
Представление JSON |
---|
{
"targetCount": string,
"timeUnit": enum ( |
Поля | |
---|---|
targetCount | Целевое количество частот, представляющее, сколько раз вы хотите достичь одного пользователя. |
timeUnit | Временное окно, выражающее период, в течение которого вы хотите добраться до указанной TargetCount. |
TargetFrequenceTimeUnit
Enum описывает временное окно, над которым мы хотим достичь целевой частоты.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
WEEKLY | Оптимизируйте ставки на достижение целевой частоты через неделю. |