AdGroupCriterion

Критерий группы объявлений. Отчет adGroupCriterion возвращает только те критерии, которые были явно добавлены в группу объявлений.

JSON-представление
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Поля
resourceName

string

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

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

displayName

string

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

Это поле игнорируется для мутаций.

status

enum ( AdGroupCriterionStatus )

Статус критерия.

Это статус объекта критерия группы объявлений, установленный клиентом. Примечание. Отчеты пользовательского интерфейса могут включать дополнительную информацию, влияющую на возможность применения критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, все равно может отображаться в пользовательском интерфейсе как включенный. Например, кампании по умолчанию показываются пользователям всех возрастных диапазонов, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку они имеют право видеть рекламу; но в AdGroupCriterion.status будет указано «удалено», поскольку положительный критерий не был добавлен.

qualityInfo

object ( QualityInfo )

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

type

enum ( CriterionType )

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

systemServingStatus

enum ( CriterionSystemServingStatus )

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

approvalStatus

enum ( AdGroupCriterionApprovalStatus )

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

disapprovalReasons[]

string

Только вывод. Перечень причин неодобрения критерия.

Различные причины отклонения критерия можно найти здесь: https://support.google.com/adspolicy/answer/6008942.

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

labels[]

string

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

effectiveCpcBidSource

enum ( BiddingSource )

Только вывод. Источник эффективной цены за клик.

effectiveCpmBidSource

enum ( BiddingSource )

Только вывод. Источник эффективной цены за тысячу показов.

effectiveCpvBidSource

enum ( BiddingSource )

Только вывод. Источник эффективной цены за просмотр.

effectivePercentCpcBidSource

enum ( BiddingSource )

Только вывод. Источник эффективной ставки в процентах CPC.

positionEstimates

object ( PositionEstimates )

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

finalUrls[]

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления.

finalMobileUrls[]

string

Список возможных конечных мобильных URL-адресов после всех междоменных перенаправлений.

urlCustomParameters[]

object ( CustomParameter )

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

criterionId

string ( int64 format)

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

Это поле игнорируется для мутаций.

adGroup

string

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

negative

boolean

Неизменный. Нацеливать ( false ) или исключать ( true ) критерий.

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

bidModifier

number

Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Большинство типов таргетируемых критериев поддерживают модификаторы.

cpcBidMicros

string ( int64 format)

Ставка CPC (цена за клик).

cpmBidMicros

string ( int64 format)

Ставка CPM (цена за тысячу показов в видимой области экрана).

cpvBidMicros

string ( int64 format)

Ставка CPV (цена за просмотр).

percentCpcBidMicros

string ( int64 format)

Сумма ставки CPC, выраженная как доля рекламируемой цены на какой-либо товар или услугу. Допустимый диапазон дроби — [0,1), а хранимое здесь значение — 1 000 000 * [фракция].

effectiveCpcBidMicros

string ( int64 format)

Только вывод. Эффективная ставка CPC (цена за клик).

effectiveCpmBidMicros

string ( int64 format)

Только вывод. Эффективная ставка CPM (цена за тысячу показов в видимой области экрана).

effectiveCpvBidMicros

string ( int64 format)

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

effectivePercentCpcBidMicros

string ( int64 format)

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

finalUrlSuffix

string

Шаблон URL-адреса для добавления параметров к конечному URL-адресу.

trackingUrlTemplate

string

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

criterion поля объединения. Критерий группы объявлений.

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

keyword

object ( KeywordInfo )

Неизменный. Ключевое слово.

placement

object ( PlacementInfo )

Неизменный. Размещение.

mobileAppCategory

object ( MobileAppCategoryInfo )

Неизменный. Категория мобильного приложения.

mobileApplication

object ( MobileApplicationInfo )

Неизменный. Мобильное приложение.

listingGroup

object ( ListingGroupInfo )

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

ageRange

object ( AgeRangeInfo )

Неизменный. Возрастной диапазон.

gender

object ( GenderInfo )

Неизменный. Пол.

incomeRange

object ( IncomeRangeInfo )

Неизменный. Диапазон доходов.

parentalStatus

object ( ParentalStatusInfo )

Неизменный. Родительский статус.

userList

object ( UserListInfo )

Неизменный. Список пользователей.

youtubeVideo

object ( YouTubeVideoInfo )

Неизменный. YouTube видео.

youtubeChannel

object ( YouTubeChannelInfo )

Неизменный. YouTube канал.

topic

object ( TopicInfo )

Неизменный. Тема.

userInterest

object ( UserInterestInfo )

Неизменный. Интерес пользователя.

webpage

object ( WebpageInfo )

Неизменный. Веб-страница

appPaymentModel

object ( AppPaymentModelInfo )

Неизменный. Модель оплаты приложения.

customAffinity

object ( CustomAffinityInfo )

Неизменный. Пользовательская близость.

customIntent

object ( CustomIntentInfo )

Неизменный. Пользовательское намерение.

customAudience

object ( CustomAudienceInfo )

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

combinedAudience

object ( CombinedAudienceInfo )

Неизменный. Комбинированная аудитория.

audience

object ( AudienceInfo )

Неизменный. Аудитория.

location

object ( LocationInfo )

Неизменный. Расположение.

language

object ( LanguageInfo )

Неизменный. Язык.

Статус критерия группы объявлений

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

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

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

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

ENABLED Критерий группы объявлений включен.
PAUSED Критерий группы объявлений приостановлен.
REMOVED Критерий группы объявлений удален.

Информация о качестве

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

JSON-представление
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Поля
creativeQualityScore

enum ( QualityScoreBucket )

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

postClickQualityScore

enum ( QualityScoreBucket )

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

searchPredictedCtr

enum ( QualityScoreBucket )

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

qualityScore

integer

Только вывод. Показатель качества.

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

КритерийSystemServingStatus

Перечисляет статусы обслуживания системы критериев.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
ELIGIBLE Имеющий право.
RARELY_SERVED Низкий объем поиска.

AdGroupCriterionApprovalStatus

Перечисляет статусы утверждения AdGroupCriterion.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
APPROVED Одобренный.
DISAPPROVED Отклонено.
PENDING_REVIEW Ожидает оценки.
UNDER_REVIEW На рассмотрении.

ПозицияОценки

Оценки критериальных ставок на различных позициях.

JSON-представление
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Поля
firstPageCpcMicros

string ( int64 format)

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

firstPositionCpcMicros

string ( int64 format)

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

topOfPageCpcMicros

string ( int64 format)

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

estimatedAddClicksAtFirstPositionCpc

string ( int64 format)

Только вывод. Оцените, сколько кликов в неделю вы можете получить, изменив ставку ключевого слова на значение в firstPositionCpcMicros.

estimatedAddCostAtFirstPositionCpc

string ( int64 format)

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

ЛистингГруппаИнформация

Критерий группы листинга.

JSON-представление
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Поля
type

enum ( ListingGroupType )

Тип группы объявлений.

caseValue

object ( ListingDimensionInfo )

Значение параметра, с помощью которого эта группа объявлений уточняет своего родительского элемента. Не определено для корневой группы.

parentAdGroupCriterion

string

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

path

object ( ListingDimensionPath )

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

Тип группы листинга

Тип группы объявлений.

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

ЛистингDimensionPath

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

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

object ( ListingDimensionInfo )

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

AppPaymentModelInfo

Критерий модели оплаты приложения.

JSON-представление
{
  "type": enum (AppPaymentModelType)
}
Поля
type

enum ( AppPaymentModelType )

Тип модели оплаты приложения.

AppPaymentModelType

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

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

Кастоминтентинфо

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

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

string

Имя ресурса CustomInterest.