Method: customers.generateKeywordForecastMetrics

Zwraca dane (takie jak wyświetlenia, kliknięcia i łą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/v16/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 przypadać w przyszłości, a data zakończenia – w ciągu roku od dzisiaj. Użyta referencyjna strefa czasowa to strefa czasowa konta Google Ads należącego do klienta. Jeśli nie zostanie ustawiony, używany będzie 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 znajdziesz na stronie https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

Treść odpowiedzi

Odpowiedź na pytanie dotyczące [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 omówieniu 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/{kryteriumId}”. 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żywane w kampanii podczas tworzenia 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 liczbę wszystkich kliknięć) określoną przez użytkownika. Wartość jest wyrażona ułamkiem dziesiętnym, więc oczekiwany współczynnik konwersji równy 2% należy wpisać jako 0,02. Jeśli pozostawisz to pole puste, zostanie zastosowany szacunkowy współczynnik konwersji.

CriterionBidModifier

Modyfikator stawek kryterium lokalizacji.

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 jest ustawiona, ta 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 być tylko jedną z tych wartości:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Używaj strategii samodzielnego ustalania 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 ustawione, dla waluty lokalnej w kampanii wymuszana będzie wartość minimalna. Jeśli wartość w tym polu będzie ustawiona zbyt nisko, pojawi się błąd związany z minimalną wartością.

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. Dzienne docelowe wydatki w mikro do użycia do oszacowania. W lokalnej walucie używanej w kampanii obowiązuje wartość minimalna. Jeśli wartość w tym polu będzie ustawiona zbyt nisko, pojawi się błąd związany z minimalną wartością.

maxCpcBidCeilingMicros

string (int64 format)

Pułap maks. stawek CPC w mikro.

MaximizeConversionsBiddingStrategy

Strategia ustalania stawek Maksymalizacja liczby konwersji.

Zapis JSON
{
  "dailyTargetSpendMicros": string
}
Pola
dailyTargetSpendMicros

string (int64 format)

To pole jest wymagane. Dzienne docelowe wydatki w mikro do użycia do oszacowania. Ta wartość musi być większa od zera.

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órych chcesz użyć w grupie reklam podczas wykonywania prognozy. Wymaga co najmniej jednego słowa kluczowego.

negativeKeywords[]

object (KeywordInfo)

Szczegóły słowa kluczowego. Musisz podać 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 wartość maksymalnego CPC ustawioną w strategii ustalania stawek. Stosuj to pole tylko w przypadku strategii ustalania stawek, które maksymalizują wartość 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. Wymagany jest 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 prognozy. Ta wartość zastąpi wartość maksymalnego CPC ustawioną w strategii ustalania stawek i w grupie reklam. Stosuj to pole tylko w przypadku strategii ustalania stawek, które obsługują wartości maks. CPC.

KeywordForecastMetrics

Dane prognozy dla bezplanowanej kampanii opartej na 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. Dostępne tylko wtedy, gdy liczba wyświetleń przekracza 0.

averageCpcMicros

string (int64 format)

Średni CPC. Wartość dostępna 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 jako koszt mikro konwersji / liczba konwersji.