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 von sich gegenseitig ausschließenden Feldern. 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)

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

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, die für die zugehörigen Werbebuchungen verfügbar sind:

  • 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.
  • Bei BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA und BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN sind nur LINE_ITEM_TYPE_VIDEO_DEFAULT-Werbebuchungen zulässig.
  • In BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH sind nur LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP-Werbebuchungen zulässig.
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.
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 Mikroeinheiten der Währung des Werbetreibenden. Für den Anzeigenauftrag sollte bidAmountMicros auf 0 festgelegt werden. Für die Zeilenitem-Einheit muss bidAmountMicros größer oder gleich der abrechenbaren Einheit der angegebenen Währung und kleiner oder gleich der Obergrenze 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 benutzerdefinierten Gebotsalgorithmus, der von dieser Strategie verwendet wird. Gilt nur, wenn performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO festgelegt ist.

Wenn Sie einen benutzerdefinierten Gebotsalgorithmus zuweisen, in dem Floodlight-Aktivitäten verwendet werden, die nicht in floodlightActivityConfigs angegeben sind, 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 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 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 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 gleich BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA ist, liegt die Obergrenze bei 10.000,00 $.
  • Wenn performanceGoalType = BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, beträgt die Obergrenze 1.000,00 $.
  • Wenn performanceGoalType gleich BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM ist, beträgt die Obergrenze 1.000,00 $.
  • Wenn performanceGoalType gleich 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 %, 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 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 eingestellt ist.

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

string (int64 format)

Die ID des benutzerdefinierten Gebotsalgorithmus, der von dieser Strategie verwendet wird. Gilt nur, wenn performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO festgelegt ist.

Wenn Sie einen benutzerdefinierten Gebotsalgorithmus zuweisen, in dem Floodlight-Aktivitäten verwendet werden, die nicht in floodlightActivityConfigs angegeben sind, 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, gilt dieses Feld nur für die folgenden Strategietypen:

  • 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-Lift maximiert 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) im Durchschnitt erreicht 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, 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.

Dieser Wert kann nur festgelegt werden, wenn er einer Werbebuchung zugewiesen ist. Anzeigengruppen übernehmen diesen Wert aus ihrer Werbebuchung.
value

string (int64 format)

Optional. Der von der Gebotsstrategie verwendete Wert. Diese Option kann festgelegt werden, wenn sie Werbebuchungen oder Anzeigengruppen zugewiesen wird. 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 entspricht 1, 0 Standardeinheiten der Währung oder einem 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 tatsächlich von der Gebotsstrategie 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 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 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 ein bestimmter Ziel-ROAS (Return on Advertising Spend) im Durchschnitt erreicht 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.