CampaignBudget

Kampagnenbudget

JSON-Darstellung 
{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Kampagnenbudgets. Ressourcennamen für Kampagnenbudgets haben das Format:

customers/{customerId}/campaignBudgets/{campaign_budget_id}
status

enum (BudgetStatus)

Nur Ausgabe. Der Status des Kampagnenbudgets. Dieses Feld ist schreibgeschützt.
deliveryMethod

enum (BudgetDeliveryMethod)

Die Bereitstellungsmethode, mit der festgelegt wird, mit welcher Rate das Kampagnenbudget ausgegeben wird.

Der Standardwert ist STANDARD, wenn bei einem Erstellungsvorgang nichts angegeben ist.
period

enum (BudgetPeriod)

Nicht veränderbar. Zeitraum, in dem das Budget ausgegeben werden kann. Der Standardwert ist DAILY, wenn nicht angegeben.
type

enum (BudgetType)

Nicht veränderbar. Der Typ des Kampagnenbudgets.
alignedBiddingStrategyId

string (int64 format)

Die ID der Portfolio-Gebotsstrategie, mit der dieses gemeinsame Kampagnenbudget verknüpft ist. Wenn eine Gebotsstrategie und ein Kampagnenbudget übereinstimmen, werden sie denselben Kampagnen zugewiesen. Nachdem ein Kampagnenbudget an eine Gebotsstrategie angepasst wurde, müssen Kampagnen, die dem Kampagnenbudget hinzugefügt werden, ebenfalls die angepasste Gebotsstrategie verwenden.
id

string (int64 format)

Nur Ausgabe. Die ID des Kampagnenbudgets.

Ein Kampagnenbudget wird mit dem CampaignBudgetService-Erstellungsvorgang erstellt und einer Budget-ID zugewiesen. Eine Budget-ID kann von verschiedenen Kampagnen gemeinsam genutzt werden. Das System verteilt das Kampagnenbudget dann auf verschiedene Kampagnen, um die optimalen Ergebnisse zu erzielen.
name

string

Der Name des Kampagnenbudgets.

Beim Erstellen eines Kampagnenbudgets über CampaignBudgetService muss jedes explizit freigegebene Kampagnenbudget einen Namen haben, der nicht null und nicht leer ist. Kampagnenbudgets, die nicht explizit freigegeben werden, werden aus dem Namen der angehängten Kampagne abgeleitet.

Die Länge des Strings muss zwischen 1 und 255 (einschließlich) in UTF-8-Byte (ausgeschnitten) liegen.
amountMicros

string (int64 format)

Der Betrag des Budgets in der lokalen Währung des Kontos. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht. Die monatlichen Ausgaben sind auf das 30,4-Fache dieses Betrags beschränkt.
totalAmountMicros

string (int64 format)

Lebensdauer des Budgets in der lokalen Währung des Kontos. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht.
explicitlyShared

boolean

Gibt an, ob das Budget explizit freigegeben wird. Standardwert ist "true", wenn in einem Erstellungsvorgang nichts angegeben ist.

Wenn dies der Fall ist, wurde das Budget zum Zweck der Freigabe für eine oder mehrere Kampagnen erstellt.

Wenn "false", wurde das Budget mit der Absicht erstellt, nur mit einer einzelnen Kampagne verwendet zu werden. Name und Status des Budgets werden mit dem Namen und Status der Kampagne synchronisiert. Der Versuch, dieses Budget mit einer zweiten Kampagne zu teilen, führt zu einem Fehler.

Ein nicht freigegebenes Budget kann aber explizit freigegeben werden. Bei demselben Vorgang muss dem Budget auch ein Name zugewiesen werden.

Ein gemeinsames Kampagnenbudget kann nie nicht freigegeben werden.
referenceCount

string (int64 format)

Nur Ausgabe. Die Anzahl der Kampagnen, die das Budget aktiv nutzen.

Dieses Feld ist schreibgeschützt.
recommendedBudgetAmountMicros

string (int64 format)

Nur Ausgabe. Der empfohlene Budgetbetrag. Wenn keine Empfehlung verfügbar ist, wird dieser Budgetbetrag festgelegt. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht.

Dieses Feld ist schreibgeschützt.
recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

Nur Ausgabe. Die geschätzte Änderung der wöchentlichen Klicks bei Anwendung des empfohlenen Budgets.

Dieses Feld ist schreibgeschützt.
recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

Nur Ausgabe. Die geschätzte Änderung der wöchentlichen Kosten in Mikros, wenn das empfohlene Budget angewendet wird. Eine Million entspricht einer Währungseinheit.

Dieses Feld ist schreibgeschützt.
recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

Nur Ausgabe. Die geschätzte Änderung der wöchentlichen Interaktionen bei Anwendung des empfohlenen Budgets.

Dieses Feld ist schreibgeschützt.
recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

Nur Ausgabe. Die geschätzte Änderung der wöchentlichen Aufrufe, wenn das empfohlene Budget angewendet wird.

Dieses Feld ist schreibgeschützt.

BudgetStatus

Mögliche Status eines Budgets.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
ENABLED Das Budget ist aktiviert.
REMOVED Das Budget wird entfernt.

BudgetDeliveryMethod

Mögliche Auslieferungsmethoden für ein Budget.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
STANDARD Der Budgetserver drosselt die Auslieferung gleichmäßig über den gesamten Zeitraum.
ACCELERATED Die Auslieferung wird vom Budgetserver nicht gedrosselt und Anzeigen werden so schnell wie möglich ausgeliefert.

BudgetPeriod

Möglicher Zeitraum eines Budgets.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
DAILY Tagesbudget:
CUSTOM_PERIOD Benutzerdefiniertes Budget, in Version 5 wieder hinzugefügt Mit dem benutzerdefinierten Budget und dem Attribut „total_amount“ lässt sich das Lifetime-Budgetlimit festlegen. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/6385083.

BudgetType

Mögliche Budgettypen

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
STANDARD Budgettyp für die standardmäßige Verwendung von Google Ads. Die täglichen Ausgaben werden auf das Doppelte des angegebenen Budgetbetrags begrenzt. Weitere Informationen: https://support.google.com/google-ads/answer/6385083
FIXED_CPA

Budgettyp mit einem festen Cost-per-Acquisition (Conversion). Weitere Informationen: https://support.google.com/google-ads/answer/7528254

Dieser Typ wird nur von Kampagnen mit den folgenden Parametern unterstützt: AdvertisingChannelType.DISPLAY (außer AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA und PaymentMode.CONVERSIONS.
SMART_CAMPAIGN

Budgettyp für smarte Kampagne. Weitere Informationen: https://support.google.com/google-ads/answer/7653509

Dieser Typ wird nur von Kampagnen mit AdvertisingChannelType.SMART und AdvertisingChannelSubType.SMART_CAMPAIGN unterstützt.
LOCAL_SERVICES

Budgettyp für eine Kampagne für lokale Dienstleistungen. Weitere Informationen: https://support.google.com/localservices/answer/7434558

Dieser Typ wird nur von Kampagnen mit AdvertisingChannelType.LOCAL_SERVICES unterstützt.