Method: customers.generateKeywordForecastMetrics

Zwraca dane (np. wyświetlenia, kliknięcia, łączny koszt) prognozy słów kluczowych dla danej kampanii.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Pola
forecastPeriod

object (DateRange)

Zakres dat prognozy. Data rozpoczęcia musi być w przyszłości, a data zakończenia nie później niż rok od dzisiaj. Użyta strefa czasowa to konto Google Ads należące do klienta. Jeśli zasada nie jest skonfigurowana, używany jest domyślny zakres dat od następnej niedzieli do następnej soboty.
campaign

object (CampaignToForecast)

To pole jest wymagane. Kampania użyta w prognozie.
currencyCode

string

Waluta używana do przeliczania kursu wymiany. Domyślnie używana jest waluta konta klienta. Ustaw to pole tylko wtedy, gdy waluta jest inna niż waluta konta. Listę prawidłowych kodów walut można znaleźć na stronie https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

Treść odpowiedzi

Odpowiedź na pytanie [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Pola
campaignForecastMetrics

object (KeywordForecastMetrics)

Wyniki prognozy kampanii.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

CampaignToForecast

Kampania, która ma wygenerować prognozę dla kampanii opartej na słowach kluczowych.

Zapis JSON 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
Pola
languageConstants[]

string

Lista nazw zasobów języków, na które mają być kierowane reklamy. Nazwa zasobu ma format „languageConstants/{criterionId}”. Listę kodów kryteriów języka znajdziesz na stronie https://developers.google.com/google-ads/api/data/codes-formats#languages.
geoModifiers[]

object (CriterionBidModifier)

Lokalizacje, na które mają być kierowane reklamy. Lokalizacje muszą być niepowtarzalne.
keywordPlanNetwork

enum (KeywordPlanNetwork)

To pole jest wymagane. Sieć używana do kierowania.
negativeKeywords[]

object (KeywordInfo)

Lista wykluczających słów kluczowych, które mają być użyte w kampanii podczas wykonywania prognozy.
biddingStrategy

object (CampaignBiddingStrategy)

To pole jest wymagane. Strategia ustalania stawek w kampanii.
adGroups[]

object (ForecastAdGroup)

Grupy reklam w nowej kampanii, które mają być objęte prognozą.
conversionRate

number

Oczekiwany współczynnik konwersji (liczba konwersji podzielona przez łączną liczbę kliknięć) określony przez użytkownika. Ta wartość jest wyrażona jako wartość dziesiętna, więc oczekiwany współczynnik konwersji równy 2% należy wpisać jako 0,02. Jeśli pozostawisz to pole puste, zostanie użyty szacowany współczynnik konwersji.

CriterionBidModifier

Kryterium lokalizacji – modyfikator stawek.

Zapis JSON 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
Pola
geoTargetConstant

string

Nazwa zasobu lokalizacji geograficznej, na którą chcesz kierować reklamy. Nazwa zasobu ma format „geoTargetConstants/{criterionId}”.
bidModifier

number

Mnożnik powiązany z identyfikatorem kryterium. Jeśli zasada jest ustawiona, wartość nie może wynosić 0.

CampaignBiddingStrategy

Strategie ustalania stawek obsługiwane na potrzeby nowych prognoz kampanii.

Zapis 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.
}
Pola
Pole sumy bidding_strategy. Strategie ustalania stawek. bidding_strategy może mieć tylko jedną z tych wartości:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Użyj strategii samodzielnego ustawiania stawek CPC do prognozowania.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

Użyj strategii ustalania stawek pod kątem maksymalizacji liczby kliknięć do prognozowania.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

Użyj strategii ustalania stawek pod kątem maksymalizacji liczby konwersji do prognozowania.

ManualCpcBiddingStrategy

Strategia samodzielnego ustawiania stawek CPC.

Zapis JSON 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
Pola
maxCpcBidMicros

string (int64 format)

To pole jest wymagane. Stawka w mikro stosowana do grup reklam w kampanii w przypadku strategii samodzielnego określania stawek CPC.
dailyBudgetMicros

string (int64 format)

Budżet na poziomie kampanii w mikro. Jeśli jest skonfigurowana, minimalna wartość jest wymuszana w walucie lokalnej używanej w kampanii. Jeśli wartość w tym polu będzie za niska, wystąpi błąd podczas wyświetlania wartości minimalnej.

MaximizeClicksBiddingStrategy

Strategia ustalania stawek pod kątem maksymalizacji liczby kliknięć.

Zapis JSON 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
Pola
dailyTargetSpendMicros

string (int64 format)

To pole jest wymagane. Docelowe dzienne wydatki w mikro do oszacowania. W przypadku waluty lokalnej używanej w kampanii obowiązuje wartość minimalna. Jeśli wartość w tym polu będzie za niska, wystąpi błąd podczas wyświetlania wartości minimalnej.
maxCpcBidCeilingMicros

string (int64 format)

Pułap maksymalnych stawek CPC w mikro.

MaximizeConversionsBiddingStrategy

Strategia ustalania stawek Maksymalizacja liczby konwersji.

Zapis JSON 
{
  "dailyTargetSpendMicros": string
}
Pola
dailyTargetSpendMicros

string (int64 format)

To pole jest wymagane. Docelowe dzienne wydatki w mikro do oszacowania. Ta wartość musi być większa niż 0.

ForecastAdGroup

Grupa reklam będąca częścią kampanii, której dotyczy prognoza.

Zapis JSON 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
Pola
biddableKeywords[]

object (BiddableKeyword)

To pole jest wymagane. Lista słów kluczowych z możliwością określenia stawki, które mają zostać użyte w grupie reklam podczas wykonywania prognozy. Wymaga co najmniej jednego słowa kluczowego.
negativeKeywords[]

object (KeywordInfo)

Szczegóły słowa kluczowego. Podaj zarówno tekst, jak i typ dopasowania słowa kluczowego.
maxCpcBidMicros

string (int64 format)

Maksymalny CPC używany przez grupę reklam podczas generowania prognozowanego ruchu. Ta wartość zastąpi maksymalną wartość CPC ustawioną w strategii ustalania stawek. Wykorzystuj to pole tylko w przypadku strategii ustalania stawek, które maksymalizują wartości CPC.

BiddableKeyword

Część grupy reklam zawierająca słowo kluczowe z możliwością określenia stawki.

Zapis JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Pola
keyword

object (KeywordInfo)

To pole jest wymagane. Słowo kluczowe. Musi zawierać tekst i typ dopasowania.
maxCpcBidMicros

string (int64 format)

Maksymalna stawka CPC w mikro, która zastępuje maks. stawkę CPC na poziomie grupy reklam w symulacji. Ta wartość zastąpi maksymalną wartość CPC ustawioną na poziomie strategii ustalania stawek i grupy reklam. Określaj to pole tylko w przypadku strategii ustalania stawek, które obsługują maksymalne wartości CPC.

KeywordForecastMetrics

Dane prognozowane dla kampanii opartej na nieplanowanych słowach kluczowych.

Zapis JSON 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
Pola
impressions

number

Łączna liczba wyświetleń.
clickThroughRate

number

Średni współczynnik klikalności. Wartość dostępna tylko wtedy, gdy liczba wyświetleń przekracza 0.
averageCpcMicros

string (int64 format)

Średni CPC. Dostępne tylko wtedy, gdy liczba kliknięć przekracza 0.
clicks

number

Łączna liczba kliknięć.
costMicros

string (int64 format)

Łączny koszt.
conversions

number

Prognozowana liczba konwersji: kliknięcia * współczynnik konwersji.
conversionRate

number

Prognozowany współczynnik konwersji.
averageCpaMicros

string (int64 format)

Średni koszt pozyskania obliczony według wzoru: costMicros / Konwersje.