BiddingStrategy

Einstellungen, mit denen die Gebotsstrategie gesteuert wird. Die Gebotsstrategie bestimmt den Gebotspreis.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
Felder
Erforderlich. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
fixedBid

object (FixedBidStrategy)

Eine Strategie, bei der ein fester Gebotspreis verwendet wird.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Eine Strategie, bei der das Gebot automatisch so angepasst wird, dass die Leistung im Hinblick auf Ihr Ziel optimiert wird, während das gesamte Budget ausgegeben wird.

Auf Anzeigenauftragsebene kann die markupType von Werbebuchungen nicht auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM festgelegt werden.

Außerdem bestimmt der einem Anzeigenauftrag zugewiesene performanceGoalType-Wert die möglichen lineItemType-Werte, die für Werbebuchungen unter diesem Anzeigenauftrag verfügbar sind:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC und BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED sind nur für LINE_ITEM_TYPE_DISPLAY_DEFAULT- oder LINE_ITEM_TYPE_VIDEO_DEFAULT-Werbebuchungen zulässig.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA und BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN lassen nur LINE_ITEM_TYPE_VIDEO_DEFAULT-Werbebuchungen zu.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH lässt nur LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Werbebuchungen zu.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Eine Strategie, bei der das Gebot automatisch so angepasst wird, dass ein bestimmtes Leistungsziel erreicht oder übertroffen wird. Sie darf nur für eine Werbebuchungsentität verwendet werden.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Eine Gebotsstrategie, die von YouTube- und Partnerressourcen verwendet wird.

Sie kann nur für eine „YouTube und Partner“-Werbebuchung oder -Anzeigengruppe verwendet werden.
demandGenBid

object (DemandGenBiddingStrategy)

Eine Gebotsstrategie, die von Demand Gen-Ressourcen verwendet wird.

Sie kann nur für eine Demand Gen-Werbebuchung oder -Anzeigengruppe verwendet werden.
Ende der sich gegenseitig ausschließenden Felder.

FixedBidStrategy

Eine Strategie, bei der ein fester Gebotspreis verwendet wird.

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

string (int64 format)

Der feste Gebotsbetrag in Mikros der Währung des Werbetreibenden. Für die Anzeigenauftragsentität sollte bidAmountMicros auf 0 gesetzt werden. Für die Werbebuchungsentität muss bidAmountMicros größer oder gleich der abrechenbaren Einheit der angegebenen Währung und kleiner oder gleich der Obergrenze von 1.000.000.000 sein.

Beispiel: 1500000 entspricht 1, 5 Standardeinheiten der Währung.

MaximizeSpendBidStrategy

Eine Strategie, bei der das Gebot automatisch angepasst wird, um ein bestimmtes Leistungsziel zu optimieren und gleichzeitig das gesamte Budget auszugeben.

JSON-Darstellung 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Felder
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Erforderlich. Der Typ des Leistungsziels, das die Gebotsstrategie zu minimieren versucht, während das gesamte Budget ausgegeben wird. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM wird für diese Strategie nicht unterstützt.
maxAverageCpmBidAmountMicros

string (int64 format)

Der maximale durchschnittliche CPM, der geboten werden kann, in Millionstel der Währung des Werbetreibenden. Muss größer oder gleich einer abrechenbaren Einheit der angegebenen Währung sein.

Beispiel: 1500000 entspricht 1, 5 Standardeinheiten der Währung.
raiseBidForDeals

boolean

Gibt an, ob die Strategie Mindestpreise für Deals berücksichtigt.
customBiddingAlgorithmId

string (int64 format)

Die ID des Algorithmus für benutzerdefinierte Gebote, der von dieser Strategie verwendet wird. Gilt nur, wenn performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO festgelegt ist.

Wenn Sie einen Algorithmus für benutzerdefinierte Gebote zuweisen, der Floodlight-Aktivitäten verwendet, die nicht in floodlightActivityConfigs identifiziert wurden, wird ein Fehler zurückgegeben.

BiddingStrategyPerformanceGoalType

Mögliche Arten von Leistungszielen für die Gebotsstrategie.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED Der Typwert ist nicht angegeben oder in dieser Version unbekannt.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Cost-per-Action.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Cost-per-Click (CPC)
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM Sichtbarer CPM
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Algorithmus für die benutzerdefinierte Gebotseinstellung
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Abgeschlossen (hör- und sichtbar)
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Aufrufe mit einer Sichtbarkeit von mehr als 10 Sekunden.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Sichtbare Impressionen
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Reichweite maximieren

PerformanceGoalBidStrategy

Eine Strategie, bei der das Gebot automatisch so angepasst wird, dass ein bestimmtes Leistungsziel erreicht oder übertroffen wird.

JSON-Darstellung 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Felder
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Erforderlich. Der Typ des Leistungsziels, das mit der Gebotsstrategie erreicht oder übertroffen werden soll.

Für die Verwendung auf Werbebuchungsebene muss der Wert einer der folgenden sein:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

Erforderlich. Das Leistungsziel, das mit der Gebotsstrategie erreicht oder übertroffen werden soll, in Mikroeinheiten der Währung des Werbetreibenden oder in Mikroeinheiten des ROAS-Werts (Return on Advertising Spend), der ebenfalls auf der Währung des Werbetreibenden basiert. Muss größer oder gleich einer abrechenbaren Einheit der angegebenen Währung und kleiner oder gleich der Obergrenze sein. Jeder performanceGoalType hat eine Obergrenze:

  • Wenn performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA ist, beträgt die Obergrenze 10.000,00 $.
  • Wenn performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC ist, beträgt die Obergrenze 1.000,00 $.
  • Wenn performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM ist, beträgt die Obergrenze 1.000,00 $.
  • Wenn performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO ist, beträgt die Obergrenze 1.000,00 und die Untergrenze 0,01.

Beispiel: Wenn Sie BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM festlegen, basiert der Gebotspreis auf der Wahrscheinlichkeit, dass jede verfügbare Impression sichtbar ist. Wenn das Ziel für den sichtbaren CPM beispielsweise 2 € beträgt und die Wahrscheinlichkeit einer sichtbaren Impression 40% beträgt, wird ein Gebot von 0, 80 € festgelegt (40% von 2 €).

Beispiel: 1500000 entspricht 1, 5 Standardeinheiten der Währung oder des ROAS-Werts.
maxAverageCpmBidAmountMicros

string (int64 format)

Der maximale durchschnittliche CPM, der geboten werden kann, in Millionstel der Währung des Werbetreibenden. Muss größer oder gleich einer abrechenbaren Einheit der angegebenen Währung sein. Nicht zutreffend, wenn performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM festgelegt ist.

Beispiel: 1500000 entspricht 1, 5 Standardeinheiten der Währung.
customBiddingAlgorithmId

string (int64 format)

Die ID des Algorithmus für benutzerdefinierte Gebote, der von dieser Strategie verwendet wird. Gilt nur, wenn performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO festgelegt ist.

Wenn Sie einen Algorithmus für benutzerdefinierte Gebote zuweisen, der Floodlight-Aktivitäten verwendet, die nicht in floodlightActivityConfigs identifiziert wurden, wird ein Fehler zurückgegeben.

YoutubeAndPartnersBiddingStrategy

Einstellungen, mit denen die Gebotsstrategie für YouTube- und Partnerressourcen gesteuert wird.

JSON-Darstellung 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Felder
type

enum (YoutubeAndPartnersBiddingStrategyType)

Der Typ der Gebotsstrategie.
value

string (int64 format)

Der von der Gebotsstrategie verwendete Wert.

Wenn die Gebotsstrategie auf Ebene der Werbebuchung zugewiesen wird, ist dieses Feld nur für die folgenden Strategietypen relevant:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Wenn die Gebotsstrategie auf Anzeigengruppenebene zugewiesen wird, ist dieses Feld nur für die folgenden Strategietypen relevant:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Wenn Sie keine entsprechende Strategie verwenden, ist der Wert dieses Felds „0“.
adGroupEffectiveTargetCpaValue

string (int64 format)

Nur Ausgabe. Der effektive Ziel-CPA für die Anzeigengruppe in Mikroeinheiten der Währung des Werbetreibenden.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven Ziel-CPA-Werts für die Anzeigengruppe.

YoutubeAndPartnersBiddingStrategyType

Mögliche Typen von Gebotsstrategien für YouTube- und Partnerressourcen.

Enums
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Der Typ ist nicht angegeben oder unbekannt.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Videoaufruf gezahlt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Impression gezahlt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Eine Gebotsstrategie, bei der Conversions pro Euro automatisch optimiert werden.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Impression gezahlt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Eine Gebotsstrategie für YouTube-Werbebuchungen mit Direktreservierung, bei der ein fester Betrag pro Impression gezahlt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass eine maximale Steigerung erzielt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Eine Gebotsstrategie, mit der die Anzahl der Conversions bei einem bestimmten Tagesbudget automatisch maximiert wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Eine Gebotsstrategie, mit der die Kosten pro Videoaufruf automatisch optimiert werden.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Eine Gebotsstrategie, mit der der Umsatz automatisch maximiert wird, während ein bestimmter Ziel-ROAS (Return on Advertising Spend) gemittelt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Eine Gebotsstrategie, bei der Gebote automatisch so festgelegt werden, dass der Umsatz maximiert wird, während Ihr Budget ausgegeben wird.

BiddingSource

Quelle des Gebotswerts.

Enums
BIDDING_SOURCE_UNSPECIFIED Die Bidding-Quelle ist nicht angegeben oder unbekannt.
BIDDING_SOURCE_LINE_ITEM Der Gebotswert wird von der Werbebuchung übernommen.
BIDDING_SOURCE_AD_GROUP Der Gebotswert wird in der Anzeigengruppe definiert.

DemandGenBiddingStrategy

Einstellungen, die die Gebotsstrategie für Demand Gen-Ressourcen steuern.

JSON-Darstellung 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Felder
type

enum (DemandGenBiddingStrategyType)

Optional. Der Typ der Gebotsstrategie.

Dies kann nur festgelegt werden, wenn die Zuweisung zu einer Werbebuchung erfolgt. Anzeigengruppen übernehmen diesen Wert von ihrer Werbebuchung.
value

string (int64 format)

Optional. Der von der Gebotsstrategie verwendete Wert. Diese Option kann festgelegt werden, wenn die Assets Werbebuchungen oder Anzeigengruppen zugewiesen werden. Dieses Feld gilt nur für die folgenden Strategietypen:

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Der Wert dieses Felds wird in Mikroeinheiten der Währung des Werbetreibenden oder als ROAS-Wert angegeben. Beispiel: 1000000 steht für 1, 0 Standardeinheiten der Währung oder einen ROAS-Wert von 100 %. Wenn Sie keine entsprechende Strategie verwenden, ist der Wert dieses Felds „0“.
effectiveBiddingValue

string (int64 format)

Nur Ausgabe. Der Wert, der von der Gebotsstrategie effektiv verwendet wird. Dieses Feld entspricht value, falls festgelegt. Wenn value nicht festgelegt ist und die Strategie einer Anzeigengruppe zugewiesen ist, wird dieses Feld von der Gebotsstrategie der Werbebuchung übernommen.

Wenn type nicht DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA oder DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS ist, ist dieses Feld 0.
effectiveBiddingValueSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven Gebotswerts.

DemandGenBiddingStrategyType

Mögliche Typen von Gebotsstrategien für Demand Gen-Ressourcen.

Enums
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED Der Typ ist nicht angegeben oder unbekannt.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Eine Gebotsstrategie, mit der Conversions pro Euro automatisch optimiert werden.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Eine Gebotsstrategie, mit der der Umsatz automatisch maximiert wird, während ein bestimmter Ziel-ROAS (Return on Advertising Spend) gemittelt wird.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Eine Gebotsstrategie, mit der die Anzahl der Conversions automatisch maximiert wird
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Eine Gebotsstrategie, mit der der Umsatz automatisch maximiert wird, während Ihr Budget ausgegeben wird.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Eine Gebotsstrategie, bei der die Klicks innerhalb eines bestimmten Budgets automatisch maximiert werden.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Eine Gebotsstrategie, bei der der Cost-per-Click automatisch optimiert wird.