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)
  }
  // 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 gilt Folgendes, wenn performanceGoalType einer der folgenden Werte ist:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ,

Die lineItemType der Anzeigenauftrags-Werbebuchungen muss eine der folgenden Optionen sein:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

und wenn performanceGoalType eine der folgenden Optionen ist:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

Die lineItemType der Anzeigenauftrags-Werbebuchungen muss LINE_ITEM_TYPE_VIDEO_DEFAULT sein.

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.

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 die Anzeigenauftrag-Entität sollte 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 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 Sichtbarkeitsdauer von mehr als 10 Sekunden.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Sichtbare Impressionen

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 gleich BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO ist, ist die Obergrenze 1.000,00 und die Untergrenze 0,01.

Beispiel: Wenn der Wert auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM festgelegt ist, 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 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, 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 anwendbare 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 der Umsatz maximiert wird, während Ihr Budget ausgegeben wird.

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.