Method: customers.generateKeywordForecastMetrics

Restituisce le metriche (come impressioni, clic, costo totale) di una previsione di parole chiave per la campagna specifica.

Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

L'ID del cliente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Campi
forecastPeriod

object (DateRange)

L'intervallo di date per la previsione. La data di inizio deve essere una data futura e la data di fine deve essere entro un anno da oggi. Il fuso orario di riferimento utilizzato è quello dell'account Google Ads appartenente al cliente. Se non viene configurato, verrà utilizzato un intervallo di date predefinito dalla domenica successiva al sabato successivo.
campaign

object (CampaignToForecast)

Obbligatorio. La campagna utilizzata nella previsione.
currencyCode

string

La valuta utilizzata per la conversione del tasso di cambio. Per impostazione predefinita, viene utilizzata la valuta dell'account del cliente. Imposta questo campo solo se la valuta è diversa da quella dell'account. L'elenco dei codici valuta validi è disponibile all'indirizzo https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

Corpo della risposta

Messaggio di risposta per [KeywordPlanIdeaService.GeneraKeyword ForecastMetrics].

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Campi
campaignForecastMetrics

object (KeywordForecastMetrics)

Risultati della previsione della campagna.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

CampaignToForecast

Una campagna per eseguire una previsione della campagna basata su parole chiave.

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

string

L'elenco dei nomi delle risorse delle lingue da scegliere come target. Il formato del nome della risorsa è "languageCosts/{criterionId}". Consulta la pagina https://developers.google.com/google-ads/api/data/codes-formats#languages per consultare l'elenco dei codici dei criteri relativi alle lingue.
geoModifiers[]

object (CriterionBidModifier)

Località target. Le località devono essere univoche.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Obbligatorio. La rete utilizzata per il targeting.
negativeKeywords[]

object (KeywordInfo)

L'elenco di parole chiave escluse da utilizzare nella campagna quando si esegue la previsione.
biddingStrategy

object (CampaignBiddingStrategy)

Obbligatorio. La strategia di offerta per la campagna.
adGroups[]

object (ForecastAdGroup)

I gruppi di annunci nella nuova campagna da prevedere.
conversionRate

number

Il tasso di conversione previsto (numero di conversioni diviso per il numero totale di clic) come definito dall'utente. Questo valore è espresso come valore decimale, quindi un tasso di conversione previsto del 2% deve essere inserito come 0,02. Se il campo viene lasciato vuoto, verrà utilizzato un tasso di conversione stimato.

CriterionBidModifier

Modificatore di offerta per il criterio di località.

Rappresentazione JSON 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
Campi
geoTargetConstant

string

Il nome della risorsa della geolocalizzazione da scegliere come target. Il formato del nome della risorsa è "geoTargetCosts/{criterionId}".
bidModifier

number

Il moltiplicatore associato per criterioId. Se impostato, questo valore non può essere 0.

CampaignBiddingStrategy

Strategie di offerta supportate per le previsioni di nuove campagne.

Rappresentazione 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.
}
Campi
Campo di unione bidding_strategy. Strategie di offerta: bidding_strategy può essere solo uno dei seguenti:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Utilizza la strategia di offerta manuale basata su CPC per effettuare previsioni.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

Utilizza la strategia di offerta Massimizza i clic per effettuare previsioni.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

Utilizza la strategia di offerta Massimizza le conversioni per effettuare previsioni.

ManualCpcBiddingStrategy

Strategia di offerta manuale basata su CPC.

Rappresentazione JSON 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
Campi
maxCpcBidMicros

string (int64 format)

Obbligatorio. Un'offerta in micro da applicare ai gruppi di annunci all'interno della campagna per una strategia di offerta manuale basata su CPC.
dailyBudgetMicros

string (int64 format)

Budget a livello di campagna in micro. Se impostato, viene applicato un valore minimo per la valuta locale utilizzata nella campagna. Se questo campo è impostato su un valore troppo basso, si verifica un errore nella visualizzazione del valore minimo.

MaximizeClicksBiddingStrategy

strategia di offerta Massimizza i clic.

Rappresentazione JSON 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
Campi
dailyTargetSpendMicros

string (int64 format)

Obbligatorio. La spesa target giornaliera in micro da utilizzare per la stima. Viene applicato un valore minimo per la valuta locale utilizzata nella campagna. Se questo campo è impostato su un valore troppo basso, si verifica un errore nella visualizzazione del valore minimo.
maxCpcBidCeilingMicros

string (int64 format)

Massimo sulle offerte CPC max in micro.

MaximizeConversionsBiddingStrategy

strategia di offerta Massimizza le conversioni.

Rappresentazione JSON 
{
  "dailyTargetSpendMicros": string
}
Campi
dailyTargetSpendMicros

string (int64 format)

Obbligatorio. La spesa target giornaliera in micro da utilizzare per la stima. Questo valore deve essere maggiore di zero.

ForecastAdGroup

Un gruppo di annunci che fa parte di una campagna di cui eseguire la previsione.

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

object (BiddableKeyword)

Obbligatorio. L'elenco di parole chiave per cui è possibile fare offerte da utilizzare nel gruppo di annunci quando si esegue la previsione. Richiede almeno una parola chiave.
negativeKeywords[]

object (KeywordInfo)

I dettagli della parola chiave. Devi specificare sia il testo della parola chiave sia il tipo di corrispondenza.
maxCpcBidMicros

string (int64 format)

Il CPC max da utilizzare per il gruppo di annunci durante la generazione del traffico previsto. Questo valore sostituirà il valore del CPC massimo impostato nella strategia di offerta. Specifica questo campo solo per strategie di offerta che utilizzano i valori del CPC massimo.

BiddableKeyword

Una parola chiave disponibile per l'offerta che fa parte di un gruppo di annunci.

Rappresentazione JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Campi
keyword

object (KeywordInfo)

Obbligatorio. Parola chiave. Deve contenere testo e tipo di corrispondenza.
maxCpcBidMicros

string (int64 format)

Un'offerta CPC max in micro che sostituisce l'offerta CPC max a livello di gruppo di annunci nella simulazione di previsione. Questo valore sostituirà il valore del CPC massimo impostato nella strategia di offerta e nel gruppo di annunci. Specifica questo campo solo per strategie di offerta che supportano i valori del CPC massimo.

KeywordForecastMetrics

Le metriche di previsione per la campagna basata su parole chiave senza piano.

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

number

Il numero totale di impressioni.
clickThroughRate

number

La percentuale di clic media. Disponibile solo se le impressioni sono > 0.
averageCpcMicros

string (int64 format)

Il CPC medio Disponibile solo se il numero di clic è maggiore di 0.
clicks

number

Il numero totale di clic.
costMicros

string (int64 format)

Il costo totale.
conversions

number

Numero previsto di conversioni: clic * tasso di conversione.
conversionRate

number

Tasso di conversione previsto.
averageCpaMicros

string (int64 format)

Costo per acquisizione medio calcolato come micro di costo / conversioni.