Method: customers.generateKeywordForecastMetrics

Gibt Messwerte (wie Impressionen, Klicks, Gesamtkosten) einer Keyword-Prognose für die jeweilige Kampagne zurück.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Die ID des Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Felder
forecastPeriod

object (DateRange)

Der Zeitraum für die Prognose. Das Startdatum muss in der Zukunft und das Enddatum darf nicht mehr als ein Jahr nach dem heutigen Datum liegen. Als Referenzzeitzone wird die Zeitzone des Google Ads-Kontos des Kunden verwendet. Ist die Richtlinie nicht konfiguriert, wird der Standardzeitraum vom nächsten Sonntag bis zum folgenden Samstag verwendet.
campaign

object (CampaignToForecast)

Erforderlich. Die in der Prognose verwendete Kampagne.
currencyCode

string

Die für die Wechselkursumrechnung verwendete Währung. Standardmäßig wird die Kontowährung des Kunden verwendet. Legen Sie dieses Feld nur fest, wenn sich die Währung von der Kontowährung unterscheidet. Eine Liste der gültigen Währungscodes finden Sie unter https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

Antworttext

Antwortnachricht für [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Felder
campaignForecastMetrics

object (KeywordForecastMetrics)

Ergebnisse der Kampagnenprognose.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CampaignToForecast

Kampagne für eine Keyword-Kampagnenprognose

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

string

Die Liste der Ressourcennamen der gewünschten Sprachen. Der Ressourcenname hat das Format „languageConstants/{criterionId}“. Eine Liste der Sprachkriteriencodes finden Sie unter https://developers.google.com/google-ads/api/data/codes-formats#languages.
geoModifiers[]

object (CriterionBidModifier)

Zielregionen. Standorte müssen eindeutig sein.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Erforderlich. Das für das Targeting verwendete Netzwerk.
negativeKeywords[]

object (KeywordInfo)

Die Liste der auszuschließenden Keywords, die in der Kampagne bei der Prognose verwendet werden sollen.
biddingStrategy

object (CampaignBiddingStrategy)

Erforderlich. Die Gebotsstrategie für die Kampagne.
adGroups[]

object (ForecastAdGroup)

Die Anzeigengruppen in der neuen Kampagne, für die eine Prognose erstellt werden soll
conversionRate

number

Die erwartete Conversion-Rate (Anzahl der Conversions geteilt durch die Gesamtzahl der Klicks), die vom Nutzer definiert wird. Dieser Wert wird als Dezimalwert ausgedrückt.Eine erwartete Conversion-Rate von 2% sollte daher mit 0, 02 eingegeben werden. Wenn Sie das Feld leer lassen, wird eine geschätzte Conversion-Rate verwendet.

CriterionBidModifier

Gebotsanpassung für Standortkriterium

JSON-Darstellung 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
Felder
geoTargetConstant

string

Der Ressourcenname des geografischen Standorts für die Ausrichtung. Der Ressourcenname hat das Format „geoTargetConstants/{criterionId}“.
bidModifier

number

Der zugehörige Multiplikator für die Kriteriums-ID. Wenn dieser Wert festgelegt ist, darf er nicht 0 sein.

CampaignBiddingStrategy

Unterstützte Gebotsstrategien für neue Kampagnenprognosen.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld bidding_strategy. Gebotsstrategien: Für bidding_strategy ist nur einer der folgenden Werte zulässig:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Verwenden Sie für Prognosen die manuelle CPC-Gebotsstrategie.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

Verwenden Sie für Prognosen die Gebotsstrategie "Klicks maximieren".
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

Verwenden Sie für Prognosen die Gebotsstrategie „Conversions maximieren“.

ManualCpcBiddingStrategy

Manuelle CPC-Gebotsstrategie

JSON-Darstellung 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
Felder
maxCpcBidMicros

string (int64 format)

Erforderlich. Ein Gebot in Mikros, das auf Anzeigengruppen innerhalb der Kampagne für eine manuelle CPC-Gebotsstrategie angewendet wird.
dailyBudgetMicros

string (int64 format)

Budget auf Kampagnenebene in Mikroeinheiten. Falls festgelegt, wird ein Mindestwert für die lokale Währung der Kampagne erzwungen. Wenn der Wert für das Feld zu niedrig ist, wird der Mindestwert nicht angezeigt.

MaximizeClicksBiddingStrategy

Gebotsstrategie „Klicks maximieren“

JSON-Darstellung 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
Felder
dailyTargetSpendMicros

string (int64 format)

Erforderlich. Die täglichen Zielausgaben in Mikroeinheiten, die für die Schätzung verwendet werden sollen. Für die lokale Währung, die in der Kampagne verwendet wird, wird ein Mindestwert erzwungen. Wenn der Wert für das Feld zu niedrig ist, wird der Mindestwert nicht angezeigt.
maxCpcBidCeilingMicros

string (int64 format)

Höchstgrenze für max. CPC-Gebote in Mikros.

MaximizeConversionsBiddingStrategy

Gebotsstrategie „Conversions maximieren“.

JSON-Darstellung 
{
  "dailyTargetSpendMicros": string
}
Felder
dailyTargetSpendMicros

string (int64 format)

Erforderlich. Die täglichen Zielausgaben in Mikroeinheiten, die für die Schätzung verwendet werden sollen. Dieser Wert muss größer als null sein.

ForecastAdGroup

Anzeigengruppe, die zu einer Kampagne gehört, für die eine Prognose erstellt werden soll

JSON-Darstellung 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
Felder
biddableKeywords[]

object (BiddableKeyword)

Erforderlich. Die Liste der gebotsfähigen Keywords, die in der Anzeigengruppe bei der Prognose verwendet werden sollen. Erfordert mindestens ein Keyword.
negativeKeywords[]

object (KeywordInfo)

Die Details des Keywords. Geben Sie sowohl den Keyword-Text als auch die Keyword-Option an.
maxCpcBidMicros

string (int64 format)

Der maximale CPC, der für die Anzeigengruppe beim Generieren des prognostizierten Traffics verwendet werden soll. Dieser Wert überschreibt den in der Gebotsstrategie festgelegten max. CPC-Wert. Geben Sie dieses Feld nur für Gebotsstrategien mit max. CPC-Werten an.

BiddableKeyword

Ein gebotsfähiges Keyword-Teil einer Anzeigengruppe.

JSON-Darstellung 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Felder
keyword

object (KeywordInfo)

Erforderlich. Keyword. Text und Keyword-Option müssen angegeben werden.
maxCpcBidMicros

string (int64 format)

Ein maximales CPC-Gebot in Mikroeinheiten, das das maximale CPC-Gebot auf Anzeigengruppenebene in der Prognosesimulation überschreibt Dieser Wert überschreibt den Wert für den max. CPC, der in der Gebotsstrategie und Anzeigengruppe festgelegt wurde. Geben Sie dieses Feld nur für Gebotsstrategien an, die maximale CPC-Werte unterstützen.

KeywordForecastMetrics

Die Prognosemesswerte für die planlose Keyword-Kampagne.

JSON-Darstellung 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
Felder
impressions

number

Die Gesamtzahl der Impressionen.
clickThroughRate

number

Die durchschnittliche Klickrate Nur verfügbar, wenn die Anzahl der Impressionen größer als 0 ist.
averageCpcMicros

string (int64 format)

Das durchschnittliche CPC-Gebot Nur verfügbar, wenn die Anzahl der Klicks größer als 0 ist.
clicks

number

Die Gesamtzahl der Klicks.
costMicros

string (int64 format)

Die Gesamtkosten
conversions

number

Prognostizierte Anzahl der Conversions: Klicks × Conversion-Rate.
conversionRate

number

Prognostizierte Conversion-Rate.
averageCpaMicros

string (int64 format)

Der durchschnittliche Cost-per-Acquisition wird als costMicros / Conversions berechnet.