- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- КампанияToПрогноз
- КритерийBidModifier
- КампанияТоргиСтратегия
- РуководствоCpcBiddingStrategy
- Максимизация кликовСтратегия ставок
- Стратегия максимизации конверсий
- Группа прогнозов объявлений
- BiddableКлючевое слово
- Ключевое словоПрогнозМетрики
- Попробуй это!
Возвращает показатели прогноза по ключевому слову для данной кампании (такие как показы, клики, общая стоимость).
Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Идентификатор клиента. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "forecastPeriod": { object ( |
Поля | |
---|---|
forecastPeriod | Диапазон дат для прогноза. Дата начала должна быть в будущем, а дата окончания должна быть в пределах 1 года от сегодняшнего дня. В качестве эталонного часового пояса используется аккаунт Google Рекламы, принадлежащий клиенту. Если этот параметр не установлен, будет использоваться диапазон дат по умолчанию со следующего воскресенья до следующей субботы. |
campaign | Необходимый. Кампания, использованная в прогнозе. |
currencyCode | Валюта, используемая для конвертации обменного курса. По умолчанию используется валюта счета клиента. Задавайте это поле только в том случае, если валюта отличается от валюты счета. Список действительных кодов валют можно найти по адресу https://developers.google.com/google-ads/api/data/codes-formats#currency-codes . |
Тело ответа
Ответное сообщение для [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"campaignForecastMetrics": {
object ( |
Поля | |
---|---|
campaignForecastMetrics | Прогноз результатов кампании. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
КампанияToПрогноз
Кампания для прогнозирования кампании по ключевым словам.
JSON-представление |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
Поля | |
---|---|
languageConstants[] | Список названий ресурсов на целевых языках. Имя ресурса имеет формат «languageConstants/{criterionId}». Список кодов языковых критериев см. на странице https://developers.google.com/google-ads/api/data/codes-formats#languages . |
geoModifiers[] | Целевые местоположения. Локации должны быть уникальными. |
keywordPlanNetwork | Необходимый. Сеть, используемая для таргетинга. |
negativeKeywords[] | Список минус-слов, которые будут использоваться в кампании при составлении прогноза. |
biddingStrategy | Необходимый. Стратегия назначения ставок для кампании. |
adGroups[] | Группы объявлений в новой кампании для прогнозирования. |
conversionRate | Ожидаемый коэффициент конверсии (количество конверсий, разделенное на общее количество кликов), определенный пользователем. Это значение выражается в виде десятичной дроби, поэтому ожидаемый коэффициент конверсии 2 % следует ввести как 0,02. Если оставить пустым, будет использоваться расчетный коэффициент конверсии. |
КритерийBidModifier
Модификатор ставки для критерия местоположения.
JSON-представление |
---|
{ "geoTargetConstant": string, "bidModifier": number } |
Поля | |
---|---|
geoTargetConstant | Имя ресурса географического местоположения для таргетинга. Имя ресурса имеет формат «geoTargetConstants/{criterionId}». |
bidModifier | Связанный множитель для идентификатора критерия. Если установлено, это значение не может быть равно 0. |
КампанияТоргиСтратегия
Поддерживаемые стратегии назначения ставок для прогнозов новых кампаний.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
Поле объединения bidding_strategy . Стратегии торгов. bidding_strategy может быть только одним из следующих: | |
manualCpcBiddingStrategy | Используйте стратегию назначения цен за клик вручную для прогнозирования. |
maximizeClicksBiddingStrategy | Используйте стратегию назначения ставок «Максимум кликов» для прогнозирования. |
maximizeConversionsBiddingStrategy | Используйте стратегию назначения ставок «Максимум конверсий» для прогнозирования. |
РуководствоCpcBiddingStrategy
Стратегия назначения цен за клик вручную.
JSON-представление |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
Поля | |
---|---|
maxCpcBidMicros | Необходимый. Ставка в микромикронах, которая будет применяться к группам объявлений в рамках кампании для стратегии назначения цены за клик вручную. |
dailyBudgetMicros | Бюджет на уровне кампании в микро. Если этот параметр установлен, для местной валюты, используемой в кампании, применяется минимальное значение. Если в этом поле установлено слишком низкое значение, возникнет ошибка при отображении минимального значения. |
Максимизация кликовСтратегия ставок
Стратегия назначения ставок «Максимальное количество кликов».
JSON-представление |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
Поля | |
---|---|
dailyTargetSpendMicros | Необходимый. Для оценки будут использоваться ежедневные целевые расходы в микромикронах. Для местной валюты, используемой в кампании, установлено минимальное значение. Если в этом поле установлено слишком низкое значение, возникнет ошибка при отображении минимального значения. |
maxCpcBidCeilingMicros | Потолок максимальной цены за клик в микро. |
Стратегия максимизации конверсий
Стратегия назначения ставок «Максимальная конверсия».
JSON-представление |
---|
{ "dailyTargetSpendMicros": string } |
Поля | |
---|---|
dailyTargetSpendMicros | Необходимый. Для оценки будут использоваться ежедневные целевые расходы в микромикронах. Это значение должно быть больше нуля. |
Группа прогнозов объявлений
Группа объявлений, которая является частью прогнозируемой кампании.
JSON-представление |
---|
{ "biddableKeywords": [ { object ( |
Поля | |
---|---|
biddableKeywords[] | Необходимый. Список ключевых слов с возможностью назначения ставок, которые будут использоваться в группе объявлений при составлении прогноза. Требуется хотя бы одно ключевое слово. |
negativeKeywords[] | Подробности ключевого слова. Вам следует указать как текст ключевого слова, так и тип соответствия. |
maxCpcBidMicros | Максимальная цена за клик, используемая для группы объявлений при создании прогнозируемого трафика. Это значение переопределяет значение максимальной цены за клик, установленное в стратегии назначения ставок. Указывайте это поле только для стратегий назначения ставок с максимальными значениями цены за клик. |
BiddableКлючевое слово
Ключевое слово с возможностью назначения ставок, входящее в группу объявлений.
JSON-представление |
---|
{
"keyword": {
object ( |
Поля | |
---|---|
keyword | Необходимый. Ключевое слово. Должен содержать текст и тип соответствия. |
maxCpcBidMicros | Максимальная цена за клик в микросчетах, которая переопределяет максимальную цену за клик на уровне группы объявлений в моделировании прогноза. Это значение переопределит значение максимальной цены за клик, установленное в стратегии назначения ставок и группе объявлений. Указывайте это поле только для стратегий назначения ставок, которые поддерживают значения максимальной цены за клик. |
Ключевое словоПрогнозМетрики
Прогнозируемые показатели для бесплановой кампании по ключевым словам.
JSON-представление |
---|
{ "impressions": number, "clickThroughRate": number, "averageCpcMicros": string, "clicks": number, "costMicros": string, "conversions": number, "conversionRate": number, "averageCpaMicros": string } |
Поля | |
---|---|
impressions | Общее количество показов. |
clickThroughRate | Средний рейтинг кликов. Доступно, только если количество показов > 0. |
averageCpcMicros | Средняя цена за клик. Доступно, только если количество кликов > 0. |
clicks | Общее количество кликов. |
costMicros | Итоговая стоимость. |
conversions | Прогнозируемое количество конверсий: клики * конверсияRate. |
conversionRate | Прогнозируемый коэффициент конверсии. |
averageCpaMicros | Средняя цена за приобретение рассчитывается как CostMicros / конверсии. |