BiddingStrategy

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

JSON-Darstellung 
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
Felder
Union-Feld bid_strategy_scheme Erforderlich. Für bid_strategy_scheme ist nur einer der folgenden Werte zulässig:
fixedBid

object (FixedBidStrategy)

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

object (MaximizeSpendBidStrategy)

Bei dieser Strategie wird das Gebot automatisch angepasst, um Ihr Leistungsziel zu optimieren und gleichzeitig das gesamte Budget auszugeben.

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

Außerdem bestimmt der einer Insertion Order zugewiesene performanceGoalType-Wert die möglichen lineItemType-Werte für die zugehörigen Zeilenartikel:

  • Bei BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC und BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED sind nur 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 sind nur für LINE_ITEM_TYPE_VIDEO_DEFAULT-Werbebuchungen verfügbar.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH unterstützt nur LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP-Werbebuchungen.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Eine Strategie, bei der das Gebot automatisch angepasst wird, um ein bestimmtes Leistungsziel zu erreichen oder zu übertreffen. Sie darf nur für eine Werbebuchung 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 eine 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 eine Anzeigengruppe verwendet werden.

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 muss bidAmountMicros auf 0 gesetzt werden. Für die Zeilenitem-Einheit muss bidAmountMicros größer oder gleich der abrechenbaren Einheit der angegebenen Währung und kleiner oder gleich dem oberen Grenzwert 1.000.000.000 sein.

Beispiel: 1500000 steht für 1, 5 Standardeinheiten der Währung.

MaximizeSpendBidStrategy

Bei dieser Strategie wird das Gebot automatisch angepasst, 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 mit der Gebotsstrategie minimiert werden soll, 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 darf, in Mikroeinheiten der Währung des Werbetreibenden. Muss größer oder gleich einer abrechenbaren Einheit der angegebenen Währung sein.

Beispiel: 1500000 steht für 1, 5 Standardeinheiten der Währung.
raiseBidForDeals

boolean

Gibt an, ob bei der Strategie Mindestpreise für Deals berücksichtigt werden.
customBiddingAlgorithmId

string (int64 format)

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

Wenn Sie einen benutzerdefinierten Gebotsalgorithmus 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 Gebotsstrategien.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED Der Typwert ist in dieser Version nicht angegeben oder unbekannt.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Cost-per-Action
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Cost-per-Click.
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 Sichtbarkeitsdauer 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 angepasst wird, um ein bestimmtes Leistungsziel zu erreichen oder zu übertreffen.

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.

Bei der Nutzung 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 gleich BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA ist, liegt die Obergrenze bei 10.000,00 $.
  • Wenn performanceGoalType gleich BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC ist, liegt die Obergrenze bei 1.000,00 $.
  • Wenn performanceGoalType gleich BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM ist, liegt die Obergrenze bei 1.000,00 $.
  • Wenn performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO ist, ist die Obergrenze 1.000,00 und die Untergrenze 0,01.

Beispiel: Wenn die Einstellung BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM lautet, 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 € für den CPM abgegeben (40% von 2 €).

Der Wert 1500000 entspricht beispielsweise 1, 5 Standardeinheiten des Währungs- oder ROAS-Werts.
maxAverageCpmBidAmountMicros

string (int64 format)

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

Beispiel: 1500000 steht für 1, 5 Standardeinheiten der Währung.
customBiddingAlgorithmId

string (int64 format)

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

Wenn Sie einen benutzerdefinierten Gebotsalgorithmus 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 Arten 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 bezahlt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Impression bezahlt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Bei dieser Gebotsstrategie werden die Conversions pro Euro automatisch optimiert.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Impression bezahlt 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 der Kampagnen-Uplift maximiert wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Bei dieser Gebotsstrategie wird die Anzahl der Conversions automatisch im Rahmen eines Tagesbudgets maximiert.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Eine Gebotsstrategie, mit der der Cost-per-View automatisch optimiert wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Eine Gebotsstrategie, mit der der Umsatz automatisch maximiert wird, während gleichzeitig ein bestimmter Ziel-ROAS (Return on Advertising Spend) erzielt wird.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Eine Gebotsstrategie, bei der Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget möglichst viel Umsatz erzielen.

BiddingSource

Quelle des Gebotswerts.

Enums
BIDDING_SOURCE_UNSPECIFIED Die Gebotsquelle 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, mit denen die Gebotsstrategie für Demand Gen-Ressourcen gesteuert wird.

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

enum (DemandGenBiddingStrategyType)

Optional. Der Typ der Gebotsstrategie.

Diese Einstellung kann nur festgelegt werden, wenn das Creative einer Werbebuchung zugewiesen ist. Anzeigengruppen übernehmen diesen Wert von ihrer Werbebuchung.
value

string (int64 format)

Optional. Der von der Gebotsstrategie verwendete Wert. Diese Einstellung kann festgelegt werden, wenn sie 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 anwendbare Strategie verwenden, ist der Wert dieses Felds 0.
effectiveBiddingValue

string (int64 format)

Nur Ausgabe. Der Wert, der von der Gebotsstrategie tatsächlich verwendet wird. Dieses Feld entspricht value, sofern es festgelegt ist. Wenn value nicht festgelegt ist und die Strategie einer Anzeigengruppe zugewiesen wird, 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 Gebotsstrategietypen 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 Bei dieser Gebotsstrategie werden die Conversions pro Euro automatisch optimiert.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Eine Gebotsstrategie, mit der der Umsatz automatisch maximiert wird, während gleichzeitig ein bestimmter Ziel-ROAS (Return on Advertising Spend) erzielt 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, mit der der Cost-per-Click automatisch optimiert wird.