- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CampaignToForecast
- CriterionBidModifier
- CampaignBiddingStrategy
- ManualCpcBiddingStrategy
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- KeywordForecastMetrics
- Testen!
Gibt Messwerte wie Impressionen, Klicks, Gesamtkosten für eine Keyword-Prognose für die betreffende Kampagne zurück.
Liste der ausgelösten Fehler: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP-Anfrage
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordForecastMetrics
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
customerId |
Die ID des Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "forecastPeriod": { object ( |
Felder | |
---|---|
forecastPeriod |
Der Zeitraum für die Prognose. Das Startdatum muss in der Zukunft liegen und das Enddatum darf maximal 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 |
Erforderlich. Die in der Prognose verwendete Kampagne. |
currencyCode |
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.GenerateKeywordPrognoseMetrics].
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"campaignForecastMetrics": {
object ( |
Felder | |
---|---|
campaignForecastMetrics |
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
Eine Kampagne, um eine Keyword-Kampagnenprognose zu erstellen.
JSON-Darstellung |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
Felder | |
---|---|
languageConstants[] |
Die Liste der Ressourcennamen der Zielsprachen. Der Ressourcenname hat das Format „languageConstants/{criterionId}“. Eine Liste der Codes für Sprachkriterien finden Sie unter https://developers.google.com/google-ads/api/data/codes-formats#languages. |
geoModifiers[] |
Standorte für die Ausrichtung. Standorte müssen eindeutig sein. |
keywordPlanNetwork |
Erforderlich. Das für das Targeting verwendete Werbenetzwerk. |
negativeKeywords[] |
Die Liste der auszuschließenden Keywords, die in der Kampagne für die Prognose verwendet werden sollen. |
biddingStrategy |
Erforderlich. Die Gebotsstrategie für die Kampagne. |
adGroups[] |
Die Anzeigengruppen in der neuen Kampagne, für die eine Prognose erstellt werden soll. |
conversionRate |
Die erwartete Conversion-Rate (Anzahl der Conversions geteilt durch die Gesamtzahl der Klicks) gemäß Definition des Nutzers. Dieser Wert wird als Dezimalwert ausgedrückt.Eine erwartete Conversion-Rate von 2% sollte also als 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 |
Der Ressourcenname des geografischen Standorts für die Ausrichtung. Der Ressourcenname hat das Format „geoTargetConstants/{criterionId}“. |
bidModifier |
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 |
Felder | |
---|---|
Union-Feld bidding_strategy . Gebotsstrategien: Für bidding_strategy ist nur einer der folgenden Werte zulässig: |
|
manualCpcBiddingStrategy |
Verwenden Sie für Prognosen die manuelle CPC-Gebotsstrategie. |
maximizeClicksBiddingStrategy |
Die Gebotsstrategie „Klicks maximieren“ für Prognosen verwenden |
maximizeConversionsBiddingStrategy |
Die Gebotsstrategie „Conversions maximieren“ für Prognosen verwenden |
ManualCpcBiddingStrategy
Manuelle CPC-Gebotsstrategie.
JSON-Darstellung |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
Felder | |
---|---|
maxCpcBidMicros |
Erforderlich. Ein Gebot in Mikroeinheiten, das im Rahmen einer manuellen CPC-Gebotsstrategie auf Anzeigengruppen innerhalb der Kampagne angewendet wird. |
dailyBudgetMicros |
Budget auf Kampagnenebene in Mikroeinheiten. Wenn festgelegt, wird ein Mindestwert für die Landeswährung der Kampagne erzwungen. Wenn der Wert für das Feld zu niedrig ist, wird ein Fehler mit dem Mindestwert angezeigt. |
MaximizeClicksBiddingStrategy
Gebotsstrategie „Klicks maximieren“ verwenden.
JSON-Darstellung |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
Felder | |
---|---|
dailyTargetSpendMicros |
Erforderlich. Die täglichen Zielausgaben in Mikroeinheiten, die für die Schätzung verwendet werden sollen. Für die in der Kampagne verwendete Landeswährung wird ein Mindestwert erzwungen. Wenn der Wert für das Feld zu niedrig ist, wird ein Fehler mit dem Mindestwert angezeigt. |
maxCpcBidCeilingMicros |
Höchstgrenze bei max. CPC-Geboten in Mikros. |
MaximizeConversionsBiddingStrategy
Gebotsstrategie „Conversions maximieren“ aus.
JSON-Darstellung |
---|
{ "dailyTargetSpendMicros": string } |
Felder | |
---|---|
dailyTargetSpendMicros |
Erforderlich. Die täglichen Zielausgaben in Mikroeinheiten, die für die Schätzung verwendet werden sollen. Dieser Wert muss größer als 0 sein. |
ForecastAdGroup
Anzeigengruppe, die zu einer Kampagne gehört, für die Prognosen erstellt werden sollen
JSON-Darstellung |
---|
{ "biddableKeywords": [ { object ( |
Felder | |
---|---|
biddableKeywords[] |
Erforderlich. Die Liste der gebotsfähigen Keywords, die bei der Prognose in der Anzeigengruppe verwendet werden. Erfordert mindestens ein Keyword. |
negativeKeywords[] |
Die Details des Keywords. Sie sollten sowohl den Keyword-Text als auch die Keyword-Option angeben. |
maxCpcBidMicros |
Das maximale CPC-Gebot, das für die Anzeigengruppe verwendet werden soll, wenn prognostizierte Zugriffe generiert werden. Dieser Wert überschreibt den in der Gebotsstrategie festgelegten maximalen CPC-Wert. Geben Sie dieses Feld nur für Gebotsstrategien an, die CPC-Werte maximieren. |
BiddableKeyword
Ein gebotsfähiges Keyword ist Teil einer Anzeigengruppe.
JSON-Darstellung |
---|
{
"keyword": {
object ( |
Felder | |
---|---|
keyword |
Erforderlich. Keyword Muss Text und Keyword-Option enthalten. |
maxCpcBidMicros |
Ein maximales CPC-Gebot in Mikroeinheiten, das das maximale CPC-Gebot auf Anzeigengruppenebene in der Prognosesimulation überschreibt Dieser Wert überschreibt den in der Gebotsstrategie und Anzeigengruppe festgelegten maximalen CPC-Wert. 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 |
Die Gesamtzahl der Impressionen. |
clickThroughRate |
Die durchschnittliche Klickrate. Nur verfügbar, wenn Impressionen > 0 sind. |
averageCpcMicros |
Das durchschnittliche CPC-Gebot Nur verfügbar, wenn die Anzahl der Klicks größer als 0 ist. |
clicks |
Die Gesamtzahl der Klicks. |
costMicros |
Die Gesamtkosten |
conversions |
Prognostizierte Anzahl der Conversions: Klicks * conversionRate. |
conversionRate |
Prognostizierte Conversion-Rate. |
averageCpaMicros |
Der durchschnittliche Cost-per-Acquisition wird als costMicros / Conversions berechnet. |