- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- CampaignToForecast
- CriterionBidModifier
- CampaignBiddingStrategy
- ManualCpcBiddingStrategy
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- KeywordForecastMetrics
- Prova!
Restituisce le metriche (come impressioni, clic, costo totale) di una previsione di una parola chiave per la campagna specifica.
Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordForecastMetrics
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
L'ID del cliente. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "forecastPeriod": { object ( |
Campi | |
---|---|
forecastPeriod |
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 il criterio non viene impostato, verrà utilizzato un intervallo di date predefinito dalla domenica successiva al sabato successivo. |
campaign |
obbligatorio. La campagna utilizzata nella previsione. |
currencyCode |
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.GenerateKeywordPredictionMetrics].
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"campaignForecastMetrics": {
object ( |
Campi | |
---|---|
campaignForecastMetrics |
Risultati della previsione della campagna. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/adwords
Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
CampaignToForecast
Una campagna per eseguire una previsione della campagna basata su parole chiave.
Rappresentazione JSON |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
Campi | |
---|---|
languageConstants[] |
L'elenco dei nomi delle risorse delle lingue da scegliere come target. Il formato del nome della risorsa è "languageConstants/{criterionId}". Consulta la pagina https://developers.google.com/google-ads/api/data/codes-formats#languages per l'elenco dei codici dei criteri relativi alle lingue. |
geoModifiers[] |
Località da scegliere come target. Le località devono essere univoche. |
keywordPlanNetwork |
obbligatorio. La rete utilizzata per il targeting. |
negativeKeywords[] |
L'elenco di parole chiave escluse da utilizzare nella campagna quando si esegue la previsione. |
biddingStrategy |
obbligatorio. La strategia di offerta per la campagna. |
adGroups[] |
I gruppi di annunci nella nuova campagna da prevedere. |
conversionRate |
Il tasso di conversione previsto (numero di conversioni diviso per il numero totale di clic) come definito dall'utente. Questo valore è espresso come 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 criterio di località.
Rappresentazione JSON |
---|
{ "geoTargetConstant": string, "bidModifier": number } |
Campi | |
---|---|
geoTargetConstant |
Il nome della risorsa della località geografica da scegliere come target. Il formato del nome della risorsa è "geoTargetConstants/{criterionId}". |
bidModifier |
Il moltiplicatore associato per il criterioId. Se impostato, questo valore non può essere 0. |
CampaignBiddingStrategy
Strategie di offerta supportate per le previsioni di nuove campagne.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione bidding_strategy . Strategie di offerta: bidding_strategy può essere solo uno dei seguenti: |
|
manualCpcBiddingStrategy |
Utilizza la strategia di offerta manuale basata su CPC per le previsioni. |
maximizeClicksBiddingStrategy |
Utilizza la strategia di offerta Massimizza i clic per le previsioni. |
maximizeConversionsBiddingStrategy |
Utilizza la strategia di offerta Massimizza le conversioni per le previsioni. |
ManualCpcBiddingStrategy
Strategia di offerta manuale basata su CPC.
Rappresentazione JSON |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
Campi | |
---|---|
maxCpcBidMicros |
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 |
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 che mostra il valore minimo. |
MaximizeClicksBiddingStrategy
strategia di offerta Massimizza i clic.
Rappresentazione JSON |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
Campi | |
---|---|
dailyTargetSpendMicros |
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 che mostra il valore minimo. |
maxCpcBidCeilingMicros |
Massimo sulle offerte CPC max in micro. |
MaximizeConversionsBiddingStrategy
la strategia di offerta Massimizza le conversioni.
Rappresentazione JSON |
---|
{ "dailyTargetSpendMicros": string } |
Campi | |
---|---|
dailyTargetSpendMicros |
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 ( |
Campi | |
---|---|
biddableKeywords[] |
obbligatorio. L'elenco di parole chiave disponibili per le offerte da utilizzare nel gruppo di annunci durante l'esecuzione della previsione. Richiede almeno una parola chiave. |
negativeKeywords[] |
I dettagli della parola chiave. Devi specificare sia il testo della parola chiave sia il tipo di corrispondenza. |
maxCpcBidMicros |
Il CPC massimo da utilizzare per il gruppo di annunci quando viene generato il traffico previsto. Questo valore sostituisce il valore del CPC massimo impostato nella strategia di offerta. Specifica questo campo solo per le strategie di offerta che raggiungono i valori del CPC massimo. |
BiddableKeyword
Una parola chiave disponibile per l'offerta di un gruppo di annunci.
Rappresentazione JSON |
---|
{
"keyword": {
object ( |
Campi | |
---|---|
keyword |
obbligatorio. Parola chiave. Deve avere testo e tipo di corrispondenza. |
maxCpcBidMicros |
Un'offerta CPC max in micro che sostituisce l'offerta CPC max a livello di gruppo di annunci nella simulazione della previsione. Questo valore sostituisce il valore del CPC massimo impostato nella strategia di offerta e nel gruppo di annunci. Specifica questo campo solo per le strategie di offerta che supportano i valori del CPC massimo. |
KeywordForecastMetrics
Le metriche di previsione per la campagna basata su parole chiave senza pianificazione.
Rappresentazione JSON |
---|
{ "impressions": number, "clickThroughRate": number, "averageCpcMicros": string, "clicks": number, "costMicros": string, "conversions": number, "conversionRate": number, "averageCpaMicros": string } |
Campi | |
---|---|
impressions |
Il numero totale di impressioni. |
clickThroughRate |
La percentuale di clic media. Disponibile solo se le impressioni sono maggiori di 0. |
averageCpcMicros |
Il CPC medio. Disponibile solo se i clic sono maggiori di 0. |
clicks |
Il numero totale di clic. |
costMicros |
Il costo totale. |
conversions |
Numero previsto di conversioni: clic * tasso di conversione. |
conversionRate |
Tasso di conversione previsto. |
averageCpaMicros |
Costo per acquisizione medio calcolato come costoMicro / conversioni. |