- JSON-представление
- Статус критерия группы объявлений
- Информация о качестве
- КритерийSystemServingStatus
- AdGroupCriterionApprovalStatus
- ПозицияОценки
- Информация о группе
- Тип группы листинга
- ЛистингDimensionPath
- AppPaymentModelInfo
- AppPaymentModelType
- Кастоминтентинфо
Критерий группы объявлений. Отчет adGroupCriterion возвращает только те критерии, которые были явно добавлены в группу объявлений.
JSON-представление |
---|
{ "resourceName": string, "displayName": string, "status": enum ( |
Поля | |
---|---|
resourceName | Неизменный. Имя ресурса критерия группы объявлений. Названия ресурсов критерия группы объявлений имеют следующий вид: |
displayName | Только вывод. Отображаемое имя критерия. Это поле игнорируется для мутаций. |
status | Статус критерия. Это статус объекта критерия группы объявлений, установленный клиентом. Примечание. Отчеты пользовательского интерфейса могут включать дополнительную информацию, влияющую на возможность применения критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, все равно может отображаться в пользовательском интерфейсе как включенный. Например, кампании по умолчанию показываются пользователям всех возрастных диапазонов, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку они имеют право видеть рекламу; но в AdGroupCriterion.status будет указано «удалено», поскольку положительный критерий не был добавлен. |
qualityInfo | Только вывод. Информация о качестве критерия. |
type | Только вывод. Тип критерия. |
systemServingStatus | Только вывод. Статус обслуживания критерия. |
approvalStatus | Только вывод. Статус утверждения критерия. |
disapprovalReasons[] | Только вывод. Перечень причин неодобрения критерия. Различные причины отклонения критерия можно найти здесь: https://support.google.com/adspolicy/answer/6008942. Это поле доступно только для чтения. |
labels[] | Только вывод. Имена ресурсов ярлыков, прикрепленных к этому критерию группы объявлений. |
effectiveCpcBidSource | Только вывод. Источник эффективной цены за клик. |
effectiveCpmBidSource | Только вывод. Источник эффективной цены за тысячу показов. |
effectiveCpvBidSource | Только вывод. Источник эффективной цены за просмотр. |
effectivePercentCpcBidSource | Только вывод. Источник эффективной ставки в процентах CPC. |
positionEstimates | Только вывод. Оценки критериальных ставок на различных позициях. |
finalUrls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления. |
finalMobileUrls[] | Список возможных конечных мобильных URL-адресов после всех междоменных перенаправлений. |
urlCustomParameters[] | Список сопоставлений, используемых для замены тегов пользовательских параметров в |
criterionId | Только вывод. Идентификатор критерия. Это поле игнорируется для мутаций. |
adGroup | Неизменный. Группа объявлений, к которой относится критерий. |
negative | Неизменный. Нацеливать ( Это поле неизменяемо. Чтобы переключить критерий с положительного на отрицательный, удалите его, а затем добавьте заново. |
bidModifier | Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Большинство типов таргетируемых критериев поддерживают модификаторы. |
cpcBidMicros | Ставка CPC (цена за клик). |
cpmBidMicros | Ставка CPM (цена за тысячу показов в видимой области экрана). |
cpvBidMicros | Ставка CPV (цена за просмотр). |
percentCpcBidMicros | Сумма ставки CPC, выраженная как доля рекламируемой цены на какой-либо товар или услугу. Допустимый диапазон дроби — [0,1), а хранимое здесь значение — 1 000 000 * [фракция]. |
effectiveCpcBidMicros | Только вывод. Эффективная ставка CPC (цена за клик). |
effectiveCpmBidMicros | Только вывод. Эффективная ставка CPM (цена за тысячу показов в видимой области экрана). |
effectiveCpvBidMicros | Только вывод. Эффективная ставка CPV (цена за просмотр). |
effectivePercentCpcBidMicros | Только вывод. Эффективная сумма ставки в процентах CPC. |
finalUrlSuffix | Шаблон URL-адреса для добавления параметров к конечному URL-адресу. |
trackingUrlTemplate | Шаблон URL-адреса для создания URL-адреса отслеживания. |
Должен быть установлен именно один. | |
keyword | Неизменный. Ключевое слово. |
placement | Неизменный. Размещение. |
mobileAppCategory | Неизменный. Категория мобильного приложения. |
mobileApplication | Неизменный. Мобильное приложение. |
listingGroup | Неизменный. Группа листингов. |
ageRange | Неизменный. Возрастной диапазон. |
gender | Неизменный. Пол. |
incomeRange | Неизменный. Диапазон доходов. |
parentalStatus | Неизменный. Родительский статус. |
userList | Неизменный. Список пользователей. |
youtubeVideo | Неизменный. YouTube видео. |
youtubeChannel | Неизменный. YouTube канал. |
topic | Неизменный. Тема. |
userInterest | Неизменный. Интерес пользователя. |
webpage | Неизменный. Веб-страница |
appPaymentModel | Неизменный. Модель оплаты приложения. |
customAffinity | Неизменный. Пользовательская близость. |
customIntent | Неизменный. Пользовательское намерение. |
customAudience | Неизменный. Пользовательская аудитория. |
combinedAudience | Неизменный. Комбинированная аудитория. |
audience | Неизменный. Аудитория. |
location | Неизменный. Расположение. |
language | Неизменный. Язык. |
Статус критерия группы объявлений
Возможные статусы AdGroupCriterion.
Перечисления | |
---|---|
UNSPECIFIED | Значение не указано. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
ENABLED | Критерий группы объявлений включен. |
PAUSED | Критерий группы объявлений приостановлен. |
REMOVED | Критерий группы объявлений удален. |
Информация о качестве
Контейнер для информации о качестве критериев группы объявлений.
JSON-представление |
---|
{ "creativeQualityScore": enum ( |
Поля | |
---|---|
creativeQualityScore | Только вывод. Эффективность объявления по сравнению с другими рекламодателями. |
postClickQualityScore | Только вывод. Показатель качества целевой страницы. |
searchPredictedCtr | Только вывод. Рейтинг кликов по сравнению с показателями других рекламодателей. |
qualityScore | Только вывод. Показатель качества. Это поле может быть не заполнено, если у 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 | Только вывод. Оценка ставки CPC, необходимой для показа объявления на первой странице результатов поиска. |
firstPositionCpcMicros | Только вывод. Оценка ставки CPC, необходимой для показа объявления на первой позиции вверху первой страницы результатов поиска. |
topOfPageCpcMicros | Только вывод. Расчетная ставка CPC, необходимая для показа объявления вверху первой страницы результатов поиска. |
estimatedAddClicksAtFirstPositionCpc | Только вывод. Оцените, сколько кликов в неделю вы можете получить, изменив ставку ключевого слова на значение в firstPositionCpcMicros. |
estimatedAddCostAtFirstPositionCpc | Только вывод. Оцените, как могут измениться ваши затраты в неделю при изменении ставки ключевого слова на значение в firstPositionCpcMicros. |
ЛистингГруппаИнформация
Критерий группы листинга.
JSON-представление |
---|
{ "type": enum ( |
Поля | |
---|---|
type | Тип группы объявлений. |
caseValue | Значение параметра, с помощью которого эта группа объявлений уточняет своего родительского элемента. Не определено для корневой группы. |
parentAdGroupCriterion | Название ресурса критерия группы объявлений, который является подразделением родительской группы объявлений. Нуль для корневой группы. |
path | Путь измерений, определяющих эту группу списков. |
Тип группы листинга
Тип группы объявлений.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
SUBDIVISION | Подразделение продуктов по некоторым параметрам листинга. Эти узлы не используются для целевых записей списка, а предназначены исключительно для определения структуры дерева. |
UNIT | Единица группы листинга, определяющая ставку. |
ЛистингDimensionPath
Путь измерений, определяющих группу списков.
JSON-представление |
---|
{
"dimensions": [
{
object ( |
Поля | |
---|---|
dimensions[] | Полный путь измерений в иерархии группы списков от корня (исключая сам корень) до этой группы списков. |
AppPaymentModelInfo
Критерий модели оплаты приложения.
JSON-представление |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Тип модели оплаты приложения. |
AppPaymentModelType
Перечисление, описывающее возможные модели оплаты приложения.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
PAID | Представляет платные приложения. |
Кастоминтентинфо
Пользовательский критерий намерения. Критерий этого типа является только целевым.
JSON-представление |
---|
{ "customIntent": string } |
Поля | |
---|---|
customIntent | Имя ресурса CustomInterest. |