Method: customers.generateKeywordForecastMetrics

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

Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Идентификатор клиента.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Поля
forecastPeriod

object ( DateRange )

Диапазон дат для прогноза. Дата начала должна быть в будущем, а дата окончания должна быть в пределах 1 года от сегодняшнего дня. В качестве эталонного часового пояса используется аккаунт Google Рекламы, принадлежащий клиенту. Если этот параметр не установлен, будет использоваться диапазон дат по умолчанию со следующего воскресенья до следующей субботы.

campaign

object ( CampaignToForecast )

Необходимый. Кампания, использованная в прогнозе.

currencyCode

string

Валюта, используемая для конвертации обменного курса. По умолчанию используется валюта счета клиента. Задавайте это поле только в том случае, если валюта отличается от валюты счета. Список действительных кодов валют можно найти по адресу https://developers.google.com/google-ads/api/data/codes-formats#currency-codes .

Тело ответа

Ответное сообщение для [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Поля
campaignForecastMetrics

object ( KeywordForecastMetrics )

Прогноз результатов кампании.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .

КампанияToПрогноз

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

JSON-представление
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
Поля
languageConstants[]

string

Список названий ресурсов на целевых языках. Имя ресурса имеет формат «languageConstants/{criterionId}». Список кодов языковых критериев см. на странице https://developers.google.com/google-ads/api/data/codes-formats#languages .

geoModifiers[]

object ( CriterionBidModifier )

Целевые местоположения. Локации должны быть уникальными.

keywordPlanNetwork

enum ( KeywordPlanNetwork )

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

negativeKeywords[]

object ( KeywordInfo )

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

biddingStrategy

object ( CampaignBiddingStrategy )

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

adGroups[]

object ( ForecastAdGroup )

Группы объявлений в новой кампании для прогнозирования.

conversionRate

number

Ожидаемый коэффициент конверсии (количество конверсий, разделенное на общее количество кликов), определенный пользователем. Это значение выражается в виде десятичной дроби, поэтому ожидаемый коэффициент конверсии 2 % следует ввести как 0,02. Если оставить пустым, будет использоваться расчетный коэффициент конверсии.

КритерийBidModifier

Модификатор ставки для критерия местоположения.

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

string

Имя ресурса географического местоположения для таргетинга. Имя ресурса имеет формат «geoTargetConstants/{criterionId}».

bidModifier

number

Связанный множитель для идентификатора критерия. Если установлено, это значение не может быть равно 0.

КампанияТоргиСтратегия

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

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

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
Поля
Поле объединения bidding_strategy . Стратегии торгов. bidding_strategy может быть только одним из следующих:
manualCpcBiddingStrategy

object ( ManualCpcBiddingStrategy )

Используйте стратегию назначения цен за клик вручную для прогнозирования.

maximizeClicksBiddingStrategy

object ( MaximizeClicksBiddingStrategy )

Используйте стратегию назначения ставок «Максимум кликов» для прогнозирования.

maximizeConversionsBiddingStrategy

object ( MaximizeConversionsBiddingStrategy )

Используйте стратегию назначения ставок «Максимум конверсий» для прогнозирования.

РуководствоCpcBiddingStrategy

Стратегия назначения цен за клик вручную.

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

string ( int64 format)

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

dailyBudgetMicros

string ( int64 format)

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

Максимизация кликовСтратегия ставок

Стратегия назначения ставок «Максимальное количество кликов».

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

string ( int64 format)

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

maxCpcBidCeilingMicros

string ( int64 format)

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

Стратегия максимизации конверсий

Стратегия назначения ставок «Максимальная конверсия».

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

string ( int64 format)

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

Группа прогнозов объявлений

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

JSON-представление
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
Поля
biddableKeywords[]

object ( BiddableKeyword )

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

negativeKeywords[]

object ( KeywordInfo )

Подробности ключевого слова. Вам следует указать как текст ключевого слова, так и тип соответствия.

maxCpcBidMicros

string ( int64 format)

Максимальная цена за клик, используемая для группы объявлений при создании прогнозируемого трафика. Это значение переопределяет значение максимальной цены за клик, установленное в стратегии назначения ставок. Указывайте это поле только для стратегий назначения ставок с максимальными значениями цены за клик.

BiddableКлючевое слово

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

JSON-представление
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Поля
keyword

object ( KeywordInfo )

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

maxCpcBidMicros

string ( int64 format)

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

Ключевое словоПрогнозМетрики

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

JSON-представление
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
Поля
impressions

number

Общее количество показов.

clickThroughRate

number

Средний рейтинг кликов. Доступно, только если количество показов > 0.

averageCpcMicros

string ( int64 format)

Средняя цена за клик. Доступно, только если количество кликов > 0.

clicks

number

Общее количество кликов.

costMicros

string ( int64 format)

Итоговая стоимость.

conversions

number

Прогнозируемое количество конверсий: клики * конверсияRate.

conversionRate

number

Прогнозируемый коэффициент конверсии.

averageCpaMicros

string ( int64 format)

Средняя цена за приобретение рассчитывается как CostMicros / конверсии.