Method: customers.generateKeywordForecastMetrics

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

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

Żądanie HTTP

POST https://googleads.googleapis.com/v17/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 nie może być późniejsza niż rok od dzisiaj. Użyta strefa czasowa to strefa czasowa ustawiona na koncie Google Ads należącym 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)

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

Komunikat z odpowiedzią na temat usługi [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, dla której chcesz utworzyć 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 dla języków, które mają być docelowe. 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 będą kierowane reklamy. Lokalizacje muszą być niepowtarzalne.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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)

Wymagane. Strategia ustalania stawek w kampanii.
adGroups[]

object (ForecastAdGroup)

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

number

Przewidywany współczynnik konwersji (liczba konwersji podzielona przez łączną liczbę kliknięć) zdefiniowany przez użytkownika. Jest to wartość dziesiętna, więc oczekiwany współczynnik konwersji równy 2% należy wpisać jako 0,02. Jeśli pozostawisz to pole puste, używany będzie szacowany 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/{kryteriumId}”.
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 w nowych prognozach 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)

Do prognozowania użyj strategii samodzielnego określania stawek CPC.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

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

object (MaximizeConversionsBiddingStrategy)

Do prognozowania użyj strategii ustalania stawek Maksymalizacja liczby konwersji.

ManualCpcBiddingStrategy

Strategia samodzielnego określania stawek CPC.

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

string (int64 format)

Wymagane. Stawka w mikro, która zostanie zastosowana 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 ustawiony, obowiązuje minimalna wartość w walucie lokalnej używanej w kampanii. Jeśli wartość w tym polu jest zbyt niska, wystąpi 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)

Wymagane. Dzienne docelowe wydatki w mikrosekundach używane do szacowania. W przypadku waluty lokalnej używanej w kampanii obowiązuje minimalna wartość. Jeśli wartość w tym polu jest zbyt niska, wystąpi błąd związany z minimalną wartością.
maxCpcBidCeilingMicros

string (int64 format)

Limit maks. stawek CPC w mikro.

MaximizeConversionsBiddingStrategy

Strategia ustalania stawek pod kątem maksymalizacji liczby konwersji.

Zapis JSON 
{
  "dailyTargetSpendMicros": string
}
Pola
dailyTargetSpendMicros

string (int64 format)

Wymagane. Dzienne docelowe wydatki w mikrosekundach używane do szacowania. Ta wartość musi być większa niż 0.

ForecastAdGroup

Grupa reklam wchodząca w skład kampanii, której dotyczy prognoza.

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

object (BiddableKeyword)

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

object (KeywordInfo)

Szczegóły słowa kluczowego. Należy podać zarówno tekst słowa kluczowego, jak i typ dopasowania.
maxCpcBidMicros

string (int64 format)

Maksymalny CPC grupy reklam używany do generowania prognozowanego ruchu. Ta wartość zastąpi maksymalną wartość CPC ustawioną w strategii ustalania stawek. Wypełnij to pole tylko w przypadku strategii ustalania stawek, które określają maks. CPC.

BiddableKeyword

Słowo kluczowe z możliwością określenia stawki, należące do grupy reklam.

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

object (KeywordInfo)

Wymagane. Słowo kluczowe. Musi zawierać tekst i typ dopasowania.
maxCpcBidMicros

string (int64 format)

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

KeywordForecastMetrics

Dane prognozy dla bezplanowej 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 wyświetlenia: > 0.
averageCpcMicros

string (int64 format)

Średni CPC. Dostępne tylko po kliknięciu > 0.
clicks

number

Łączna liczba kliknięć.
costMicros

string (int64 format)

Całkowity koszt.
conversions

number

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

number

Prognozowany współczynnik konwersji.
averageCpaMicros

string (int64 format)

Średni koszt pozyskania obliczany według wzoru: costMicros / konwersje.