REST Resource: advertisers.lineItems

Ressource: LineItem

Eine einzelne Werbebuchung.

JSON-Darstellung 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Werbebuchung.
advertiserId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem die Werbebuchung gehört.
campaignId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Kampagne, zu der die Werbebuchung gehört.
insertionOrderId

string (int64 format)

Erforderlich. Nicht veränderbar. Die eindeutige ID des Anzeigenauftrags, zu dem die Werbebuchung gehört.
lineItemId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Werbebuchung. Wird vom System zugewiesen.
displayName

string

Erforderlich. Der Anzeigename der Werbebuchung.

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.
lineItemType

enum (LineItemType)

Erforderlich. Nicht veränderbar. Der Typ der Werbebuchung.
entityStatus

enum (EntityStatus)

Erforderlich. Damit wird gesteuert, ob das Budget der Werbebuchung ausgegeben und auf Inventar geboten werden kann.

  • Für die Methode lineItems.create ist nur ENTITY_STATUS_DRAFT zulässig. Wenn Sie eine Werbebuchung aktivieren möchten, verwenden Sie die Methode lineItems.patch und aktualisieren Sie den Status nach der Erstellung auf ENTITY_STATUS_ACTIVE.
  • Eine Werbebuchung kann nicht von einem anderen Status in den Status ENTITY_STATUS_DRAFT zurückgesetzt werden.
  • Wenn der übergeordnete Anzeigenauftrag der Werbebuchung nicht aktiv ist, kann das Budget der Werbebuchung nicht ausgegeben werden, auch wenn ihr eigener Status ENTITY_STATUS_ACTIVE ist.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Werbebuchung zuletzt aktualisiert wurde. Wird vom System zugewiesen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

Die mit der Werbebuchung verbundenen Partnerkosten.

Wenn die Methode lineItems.create nicht vorhanden oder leer ist, werden die Partnerkosten für die neu erstellte Werbebuchung vom übergeordneten Anzeigenauftrag übernommen.
flight

object (LineItemFlight)

Erforderlich. Start- und Endzeit der Laufzeit der Werbebuchung.
budget

object (LineItemBudget)

Erforderlich. Die Einstellung für die Budgetzuweisung der Werbebuchung.
pacing

object (Pacing)

Erforderlich. Die Einstellung für die Budgetausgabegeschwindigkeit der Werbebuchung.
frequencyCap

object (FrequencyCap)

Optional. Erforderlich, wenn der Werbebuchungstyp nicht LINE_ITEM_TYPE_DEMAND_GEN ist. Die Einstellungen für das Frequency Capping der Werbebuchung.

Das Feld maxImpressions in diesem Einstellungsobjekt muss verwendet werden, wenn eine begrenzte Obergrenze zugewiesen wird.
partnerRevenueModel

object (PartnerRevenueModel)

Erforderlich. Die Einstellung für das Partner-Umsatzmodell der Werbebuchung.
conversionCounting

object (ConversionCountingConfig)

Die Conversion-Tracking-Einstellung der Werbebuchung.
creativeIds[]

string (int64 format)

Die IDs der Creatives, die mit der Werbebuchung verknüpft sind.
bidStrategy

object (BiddingStrategy)

Erforderlich. Die Gebotsstrategie der Werbebuchung.
integrationDetails

object (IntegrationDetails)

Integrationsdetails der Werbebuchung.
targetingExpansion

object (TargetingExpansionConfig)

Die Einstellungen für das optimierte Targeting der Werbebuchung.

Diese Konfiguration gilt nur für Display-, Video- oder Audiowerbebuchungen, für die die automatische Gebotseinstellung verwendet wird und die auf geeignete Zielgruppenlisten ausgerichtet sind.
warningMessages[]

enum (LineItemWarningMessage)

Nur Ausgabe. Die von der Werbebuchung generierten Warnmeldungen. Diese Warnungen verhindern nicht das Speichern der Werbebuchung, aber einige können die Ausführung der Werbebuchung blockieren.
mobileApp

object (MobileApp)

Die mobile App, die mit der Werbebuchung beworben wird.

Dies gilt nur, wenn lineItemType entweder LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL oder LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL ist.
reservationType

enum (ReservationType)

Nur Ausgabe. Der Reservierungstyp der Werbebuchung.
excludeNewExchanges

boolean

Gibt an, ob neue Anzeigenplattformen vom automatischen Targeting durch die Werbebuchung ausgeschlossen werden sollen. Dieses Feld ist standardmäßig auf „false“ gesetzt.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Optional. Einstellungen speziell für „YouTube und Partner“-Werbebuchungen
demandGenSettings

object (DemandGenSettings)

Optional. Einstellungen speziell für Demand Gen-Werbebuchungen.

Gilt nur für Demand Gen-Werbebuchungen.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Ob mit dieser Werbebuchung politische Werbung in der EU ausgeliefert wird.

Wenn containsEuPoliticalAds im übergeordneten Werbetreibenden auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING festgelegt wurde, wird diesem Feld DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING zugewiesen, sofern nicht anders angegeben. Dieses Feld kann dann über die Benutzeroberfläche, die API oder Dateien mit strukturierten Daten aktualisiert werden.

Dieses Feld muss beim Erstellen einer neuen Werbebuchung zugewiesen werden. Andernfalls schlägt die advertisers.lineItems.create-Anfrage fehl.
optimizeFixedBidding

boolean

Optional. Gibt an, ob die Gebotsoptimierung von DV360 für Werbebuchungen mit festem Gebot aktiviert werden soll.

In DV360 wird Ihr festes Gebot standardmäßig optimiert, indem Gebote für Impressionen, die wahrscheinlich keine gute Leistung erzielen, automatisch gesenkt werden. Diese Optimierung ist standardmäßig aktiviert (Wert ist „true“).

Wenn dieses Feld auf false gesetzt ist, ist diese Optimierung deaktiviert und das Gebot wird aus keinem Grund gesenkt.

Diese Einstellung gilt nur für Werbebuchungen mit einem biddingStrategy vom Typ FIXED_BID.

LineItemType

Mögliche Typen einer Werbebuchung.

Der Typ der Werbebuchung bestimmt, welche Einstellungen und Optionen verfügbar sind, z. B. das Format der Anzeigen oder die Targeting-Optionen.

Enums
LINE_ITEM_TYPE_UNSPECIFIED

Der Typwert ist nicht angegeben oder in dieser Version unbekannt.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_DISPLAY_DEFAULT Bild-, HTML5-, native oder Rich Media-Anzeigen.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Displayanzeigen, mit denen die Anzahl der Installationen einer App gesteigert werden soll.
LINE_ITEM_TYPE_VIDEO_DEFAULT Videoanzeigen, die auf CPM-Basis für eine Vielzahl von Umgebungen verkauft werden.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Videoanzeigen, die zu App-Installationen führen.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Displayanzeigen, die in App-Inventar ausgeliefert werden.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Videoanzeigen, die in App-Inventar ausgeliefert werden.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_AUDIO_DEFAULT RTB-Audioanzeigen, die für eine Vielzahl von Umgebungen verkauft werden.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Over-the-Top-Anzeigen in OTT-Anzeigenaufträgen. Dieser Typ gilt nur für Werbebuchungen mit einem Anzeigenauftrag vom Typ insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

YouTube-Videoanzeigen, mit denen Conversions gefördert werden.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

YouTube-Videoanzeigen (bis zu 15 Sekunden), die nicht übersprungen werden können.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

YouTube-Videoanzeigen, die eine Geschichte in einer bestimmten Reihenfolge mit einer Mischung aus Formaten erzählen.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube-Audioanzeigen

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

YouTube-Videoanzeigen, die so optimiert sind, dass mehr einzelne Nutzer zu niedrigeren Kosten erreicht werden. Kann Bumper-Anzeigen, überspringbare In-Stream-Anzeigen oder eine Kombination dieser Typen enthalten.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Standard-YouTube-Videoanzeigen

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Nicht überspringbare YouTube-Videoanzeigen für internetfähige Fernseher (bis zu 15 Sekunden)

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

YouTube-Videoanzeigen für internetfähige Fernseher, die so optimiert sind, dass mehr einzelne Nutzer zu geringeren Kosten erreicht werden. Kann Bumper-Anzeigen, überspringbare In-Stream-Anzeigen oder eine Kombination dieser Typen enthalten.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Default-YouTube-Videoanzeigen für internetfähige Fernseher Nur In-Stream-Anzeigenformat einbeziehen.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Das Ziel dieses Werbebuchungstyps besteht darin, die YouTube-Anzeigen einer Person in einem bestimmten Zeitraum so oft wie gewünscht zu präsentieren.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

YouTube-Videoanzeigen, mit denen Sie durch verschiedene Anzeigenformate mehr Aufrufe erzielen können.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Displayanzeigen, die im Inventar für digitale Außenwerbung ausgeliefert werden.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Videoanzeigen, die in Inventar für digitale Außenwerbung ausgeliefert werden.

Werbebuchungen dieses Typs und ihr Targeting können nicht über die API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_DEMAND_GEN Demand Gen-Anzeigen

LineItemFlight

Einstellungen, mit denen die aktive Dauer einer Werbebuchung gesteuert wird.

JSON-Darstellung 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Felder
flightDateType

enum (LineItemFlightDateType)

Erforderlich. Der Typ der Laufzeit der Werbebuchung.
dateRange

object (DateRange)

Start- und Enddatum der Laufzeit der Werbebuchung. Sie werden relativ zur Zeitzone des übergeordneten Werbetreibenden aufgelöst.

  • Erforderlich, wenn der flightDateType LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM ist. Andernfalls nur Ausgabe.
  • Beim Erstellen einer neuen Schaltung müssen sowohl startDate als auch endDate in der Zukunft liegen.
  • Ein vorhandener Flug mit einem startDate in der Vergangenheit hat einen veränderlichen endDate, aber einen unveränderlichen startDate.
  • endDate muss der startDate oder später sein, beide vor dem Jahr 2037.

LineItemFlightDateType

Mögliche Typen der Laufzeit einer Werbebuchung.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Der Typwert ist nicht angegeben oder in dieser Version unbekannt.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED Die Laufzeit der Werbebuchung wird vom übergeordneten Anzeigenauftrag übernommen.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM Für die Werbebuchung wird eine eigene benutzerdefinierte Laufzeit verwendet.

LineItemBudget

Einstellungen, mit denen festgelegt wird, wie das Budget zugewiesen wird.

JSON-Darstellung 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Felder
budgetAllocationType

enum (LineItemBudgetAllocationType)

Erforderlich. Der Typ der Budgetzuweisung.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC gilt nur, wenn die automatische Budgetzuweisung für den übergeordneten Anzeigenauftrag aktiviert ist.

Dieses Feld muss für Demand Gen-Werbebuchungen auf LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED festgelegt werden.
budgetUnit

enum (BudgetUnit)

Nur Ausgabe. Die Budgeteinheit gibt an, ob das Budget währungs- oder impressionsbasiert ist. Dieser Wert wird vom übergeordneten Anzeigenauftrag übernommen.
maxAmount

string (int64 format)

Der maximale Budgetbetrag, der für die Werbebuchung ausgegeben wird. Muss größer als 0 sein.

Wenn „budgetAllocationType“ Folgendes ist:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC: Dieses Feld ist unveränderlich und wird vom System festgelegt.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, wenn budgetUnit:
    • BUDGET_UNIT_CURRENCY: Dieses Feld steht für den maximalen Budgetbetrag, der ausgegeben werden soll, in Mikroeinheiten der Währung des Werbetreibenden. Beispiel: 1500000 entspricht 1, 5 Standardeinheiten der Währung.
    • BUDGET_UNIT_IMPRESSIONS: Dieses Feld gibt die maximale Anzahl der auszuliefernden Impressionen an.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED ist dieses Feld nicht zutreffend und wird vom System ignoriert.

LineItemBudgetAllocationType

Mögliche Arten der Budgetzuweisung.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Der Typwert ist nicht angegeben oder in dieser Version unbekannt.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC Die automatische Budgetzuweisung ist für die Werbebuchung aktiviert.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Für die Werbebuchung wird ein fester maximaler Budgetbetrag zugewiesen.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Für die Werbebuchung gilt kein Budgetlimit.

PartnerRevenueModel

Einstellungen, die steuern, wie der Partnerumsatz berechnet wird.

JSON-Darstellung 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Felder
markupType

enum (PartnerRevenueModelMarkupType)

Erforderlich. Der Aufschlagstyp des Partner-Umsatzmodells.

Dieses Feld muss für Demand Gen-Werbebuchungen auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP festgelegt werden.
markupAmount

string (int64 format)

Erforderlich. Der Aufschlag des Partner-Umsatzmodells. muss größer oder gleich 0 sein.

  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM festgelegt ist, stellt dieses Feld den CPM-Aufschlag in Mikros der Währung des Werbetreibenden dar. Beispiel: 1500000 entspricht 1, 5 Standardeinheiten der Währung.
  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP festgelegt ist, steht dieses Feld für den prozentualen Aufschlag auf die Mediakosten in Millis. Beispiel: 100 entspricht 0,1% (Dezimalwert 0,001).
  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP festgelegt ist, entspricht dieses Feld dem prozentualen Aufschlag auf die Mediagesamtkosten in Millis. Beispiel: 100 entspricht 0,1% (Dezimalwert 0,001).

PartnerRevenueModelMarkupType

Mögliche Aufschlagstypen des Partner-Umsatzmodells.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED Der Typwert ist nicht angegeben oder in dieser Version unbekannt.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Berechnen Sie den Partnerumsatz auf Grundlage eines festen CPM.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Berechnen Sie den Partnerumsatz basierend auf einem prozentualen Aufschlag auf die Mediakosten.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Der Partnerumsatz wird anhand eines prozentualen Aufschlags auf die Mediagesamtkosten berechnet, die alle Partner- und Datenkosten umfassen.

ConversionCountingConfig

Einstellungen, mit denen festgelegt wird, wie Conversions gezählt werden.

Alle Post-Klick-Conversions werden gezählt. Für die Zählung von Post-View-Conversions kann ein Prozentwert festgelegt werden.

JSON-Darstellung 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
Felder
postViewCountPercentageMillis

string (int64 format)

Der Prozentsatz der zu zählenden Post-View-Conversions in Millis (1/1.000 %). Der Wert muss zwischen 0 und 100.000 (einschließlich) liegen.

Wenn Sie beispielsweise 50% der Post-Klick-Conversions erfassen möchten, legen Sie den Wert auf 50000 fest.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Die Floodlight-Aktivitätskonfigurationen, die zum Erfassen von Conversions verwendet werden.

Die Anzahl der gezählten Conversions ist die Summe aller Conversions, die von allen in diesem Feld angegebenen Floodlight-Aktivitäts-IDs gezählt wurden.

Dieses Feld kann nicht aktualisiert werden, wenn der Werbebuchung ein Algorithmus für benutzerdefinierte Gebote zugewiesen ist. Wenn Sie dieses Feld festlegen und in derselben Anfrage einen Algorithmus für benutzerdefinierte Gebote zuweisen, müssen die Floodlight-Aktivitäten mit denen des Algorithmus für benutzerdefinierte Gebote übereinstimmen.
primaryAttributionModelId

string (int64 format)

Optional. Das Attributionsmodell, das für die Conversion-Analyse verwendet werden soll. Mit diesem Attributionsmodell wird festgelegt, wie Conversions gezählt werden. Sie können das primäre Modell für eine Floodlight-Konfiguration oder -Gruppe festlegen. Weitere Informationen

Gilt nur für Demand Gen-Werbebuchungen.

TrackingFloodlightActivityConfig

Einstellungen, die das Verhalten einer einzelnen Floodlight-Aktivitätskonfiguration steuern.

JSON-Darstellung 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Felder
floodlightActivityId

string (int64 format)

Erforderlich. Die ID der Floodlight-Aktivität.
postClickLookbackWindowDays

integer

Erforderlich. Die Anzahl der Tage nach dem Klick auf eine Anzeige, in denen eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 (einschließlich) liegen.
postViewLookbackWindowDays

integer

Erforderlich. Die Anzahl der Tage nach dem Aufruf einer Anzeige, in denen eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 (einschließlich) liegen.

LineItemWarningMessage

Die von einer Werbebuchung generierten Warnmeldungen. Diese Warnungen verhindern nicht das Speichern einer Werbebuchung, können aber dazu führen, dass sie nicht ausgeliefert wird.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Nicht angegeben oder unbekannt.
INVALID_FLIGHT_DATES Die Laufzeit dieser Werbebuchung ist ungültig. Die Werbebuchung wird nicht ausgeführt.
EXPIRED Das Enddatum dieser Werbebuchung liegt in der Vergangenheit.
PENDING_FLIGHT Diese Werbebuchung wird in Zukunft ausgeführt.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Alle vom Partner aktivierten Plattformen sind vom Targeting augeschlossen. Die Werbebuchung wird nicht ausgeführt.
INVALID_INVENTORY_SOURCE Es gibt keine Ausrichtung auf aktive Inventarquellen. Die Werbebuchung wird nicht ausgeführt.
APP_INVENTORY_INVALID_SITE_TARGETING Das Targeting auf Apps und URLs dieser Werbebuchung umfasst keine mobilen Apps. Für diesen Werbebuchungstyp müssen Sie mobile Apps in das Targeting auf Channels, Websitelisten oder Apps einbeziehen. Die Werbebuchung wird nicht ausgeführt.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Diese Werbebuchung ist nicht auf mobile Nutzer ausgerichtet. Für diesen Werbebuchungstyp müssen Sie eine Nutzerliste mit mobilen Nutzern als Ziel festlegen. Die Werbebuchung wird nicht ausgeführt.
NO_VALID_CREATIVE Diese Werbebuchung enthält keine gültigen Creatives. Die Werbebuchung wird nicht ausgeführt.
PARENT_INSERTION_ORDER_PAUSED Der Anzeigenauftrag für diese Werbebuchung wurde pausiert. Die Werbebuchung wird nicht ausgeführt.
PARENT_INSERTION_ORDER_EXPIRED Das Enddatum des Anzeigenauftrags dieser Werbebuchung liegt in der Vergangenheit. Die Werbebuchung wird nicht ausgeführt.

MobileApp

Eine mobile App, die über eine Werbebuchung für App-Installationsanzeigen beworben wird.

JSON-Darstellung 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Felder
appId

string

Erforderlich. Die ID der App, die vom Plattform-Shop bereitgestellt wird.

Android-Apps werden durch die Paket-ID identifiziert, die im Google Play Store verwendet wird, z. B. com.google.android.gm.

iOS-Apps werden durch eine neunstellige App-ID identifiziert, die im App Store von Apple verwendet wird, z. B. 422689480.
platform

enum (Platform)

Nur Ausgabe. Die App-Plattform.
displayName

string

Nur Ausgabe. Der Name der App.
publisher

string

Nur Ausgabe. Der App-Publisher.

Plattform

Mögliche Plattformen für mobile Apps.

Enums
PLATFORM_UNSPECIFIED Plattform ist nicht angegeben.
IOS iOS-Plattform
ANDROID Android-Plattform

YoutubeAndPartnersSettings

Einstellungen für „YouTube und Partner“-Werbebuchungen

JSON-Darstellung 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Felder
viewFrequencyCap

object (FrequencyCap)

Die Einstellungen für das Frequency Capping der Werbebuchung.

Das Feld maxViews in diesem Einstellungsobjekt muss verwendet werden, wenn eine begrenzte Obergrenze zugewiesen wird.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Optional. Die Konfigurationen für Analysen durch Drittanbieter der Werbebuchung.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Einstellungen, mit denen festgelegt wird, auf welches YouTube- und Partnerinventar die Werbebuchung ausgerichtet wird.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Nur Ausgabe. Die Art der Inhalte, bei denen die YouTube- und Partneranzeigen ausgeliefert werden.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Nur Ausgabe. Die Inhaltskategorie, die bei der Auslieferung der Werbebuchung wirksam wird. Wenn die Inhaltskategorie sowohl in der Werbebuchung als auch beim Werbetreibenden festgelegt ist, wird bei der Auslieferung der Werbebuchung die strengere Einstellung angewendet.

Für neue Werbebuchungen wird nur die Einstellung auf Werbetreibendenebene übernommen.
targetFrequency

object (TargetFrequency)

Optional. Die durchschnittliche Anzahl der Male, mit der Anzeigen aus dieser Werbebuchung derselben Person über einen bestimmten Zeitraum präsentiert werden sollen.
linkedMerchantId

string (int64 format)

Optional. Die ID des Merchant Center-Kontos, das für die Bereitstellung eines Produktfeeds verwendet wird.

Dieses Merchant Center-Konto muss bereits mit dem Werbetreibenden verknüpft sein.
relatedVideos[]

object (RelatedVideo)

Optional. Die ähnlichen Videos für die Werbebuchung. Diese Videos werden unter der primären Videoanzeige angezeigt, wenn sie in der YouTube App auf Mobilgeräten wiedergegeben wird.
leadFormId

string (int64 format)

Optional. Die ID des Formulars, mit dem Leads generiert werden sollen.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Optional. Die Einstellungen für VideoAdSequence.
videoAdInventoryControl

object (VideoAdInventoryControl)

Optional. Die Einstellungen, mit denen festgelegt wird, welches Inventar für diese Werbebuchung zulässig ist.

ThirdPartyMeasurementConfigs

Einstellungen, mit denen festgelegt wird, welche Drittanbieter bestimmte Messwerte für Werbebuchungen messen.

JSON-Darstellung 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Felder
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Optional. Die Drittanbieter, die die Sichtbarkeit messen.

Die folgenden Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Optional. Die Drittanbieter, die die Markensicherheit analysieren.

Die folgenden Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Optional. Die Drittanbieter, die die Reichweite messen.

Die folgenden Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Optional. Die Drittanbieter, die die Anzeigenwirkung auf die Markenbekanntheit messen.

Die folgenden Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Einstellungen, mit denen festgelegt wird, wie Drittanbieter für Analysen konfiguriert werden.

JSON-Darstellung 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Felder
vendor

enum (ThirdPartyVendor)

Der Drittanbieter für Analysen.
placementId

string

Die ID, die von der Plattform des Drittanbieters verwendet wird, um die Werbebuchung zu identifizieren.

ThirdPartyVendor

Anbieter, die Analysen durch Drittanbieter durchführen.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED Unbekannter Drittanbieter.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Telemetrie.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN Herkunft des Dokuments ermitteln und feststellen kann, dass es von dir stammt.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video-Amp
THIRD_PARTY_VENDOR_ISPOT_TV Ispot-TV
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

Einstellungen, mit denen festgelegt wird, auf welches YouTube-bezogene Inventar die „YouTube und Partner“-Werbebuchung ausgerichtet wird.

JSON-Darstellung 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Felder
includeYoutube

boolean

Optional. Gibt an, ob Inventar auf YouTube einbezogen werden soll. Das gilt für die Suche, Kanäle und Videos.
includeGoogleTv

boolean

Optional. Gibt an, ob Inventar in Video-Apps, die für Google TV verfügbar sind, einbezogen werden soll.
includeYoutubeVideoPartners

boolean

Ob das Targeting auf Inventar auf einer Sammlung von Partnerwebsites und ‑Apps erfolgen soll, die denselben Standards der Markensicherheit unterliegen wie YouTube.

YoutubeAndPartnersContentCategory

Kategorien zur Markensicherheit für Inhalte auf YouTube und Partnerwebsites.

Enums
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Die Inhaltskategorie ist in dieser Version nicht angegeben oder unbekannt.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Eine Kategorie, die eine breite Palette von Inhalten umfasst, die für die meisten Unternehmen geeignet sind. Die Inhalte basieren auf den Richtlinien für werbefreundliche Inhalte von YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Eine Kategorie, die alle Inhalte auf YouTube und bei Videopartnern umfasst, die den Monetarisierungsstandards entsprechen.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Eine Kategorie, die eine reduzierte Auswahl an Inhalten umfasst, die gehobene Anforderungen erfüllen, insbesondere in Bezug auf anstößige oder unangemessene Sprache und sexuelle Anzüglichkeiten.

TargetFrequency

Mit dieser Einstellung wird festgelegt, wie oft die Anzeigen im Durchschnitt innerhalb eines bestimmten Zeitraums für dieselbe Person ausgeliefert werden.

JSON-Darstellung 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Felder
targetCount

string (int64 format)

Die Zielanzahl, wie oft die Anzeigen im Durchschnitt derselben Person in der Zeitspanne, die durch timeUnit und timeUnitCount vorgegeben ist, präsentiert werden sollen.
timeUnit

enum (TimeUnit)

Die Zeiteinheit, in der die angestrebte Häufigkeit angewendet wird.

Die folgende Zeiteinheit ist anwendbar:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

Die Anzahl der timeUnit, für die die angestrebte Häufigkeit gilt.

Je nach Wert von timeUnit gelten die folgenden Einschränkungen:

  • TIME_UNIT_WEEKS – muss 1 sein
  • TIME_UNIT_MONTHS – muss 1 sein

RelatedVideo

Stellt einen Eintrag für ein ähnliches Video dar.

JSON-Darstellung 
{
  "videoId": string,
  "videoAssetId": string
}
Felder
videoId

string

Nur Ausgabe. Die YouTube-Video-ID des ähnlichen Videos.
videoAssetId

string (int64 format)

Erforderlich. Die adAssetId der AdAsset-Ressource für das YouTube-Video.

VideoAdSequenceSettings

Einstellungen für Videoanzeigensequenzen.

JSON-Darstellung 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Felder
minimumDuration

enum (VideoAdSequenceMinimumDuration)

Der Mindestzeitraum, bevor derselbe Nutzer diese Sequenz wieder sieht.
steps[]

object (VideoAdSequenceStep)

Die Schritte, aus denen die Sequenz besteht.

VideoAdSequenceMinimumDuration

Die Aufzählung für das mögliche Mindestintervall, bevor derselbe Nutzer die Videoanzeigensequenz wieder sieht.

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Nicht angegeben oder unbekannt.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 Tage
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 Tage.

VideoAdSequenceStep

Die Details eines einzelnen Schritts in einer Videoanzeigensequenz.

JSON-Darstellung 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Felder
stepId

string (int64 format)

Die ID des Schritts.
adGroupId

string (int64 format)

Die ID der entsprechenden Anzeigengruppe des Schritts.
previousStepId

string (int64 format)

Die ID des vorherigen Schritts. Der erste Schritt hat keinen vorherigen Schritt.
interactionType

enum (InteractionType)

Die Interaktion im vorherigen Schritt, die den Zuschauer zu diesem Schritt führt. Der erste Schritt hat keinen interactionType.

InteractionType

Die Typen der Interaktion bei einem Schritt.

Enums
INTERACTION_TYPE_UNSPECIFIED Nicht angegeben oder unbekannt
INTERACTION_TYPE_PAID_VIEW Ein Aufruf der bezahlten Inhalte.
INTERACTION_TYPE_SKIP Vom Zuschauer übersprungen.
INTERACTION_TYPE_IMPRESSION Eine (angesehene) Anzeigenimpression.
INTERACTION_TYPE_ENGAGED_IMPRESSION Eine Anzeigenimpression, die vom Zuschauer nicht sofort übersprungen wurde, aber auch nicht das abrechnungsfähige Ereignis erreicht hat.

VideoAdInventoryControl

Die Steuerung des Videoanzeigeninventars, die in bestimmten YouTube-Werbebuchungstypen verwendet wird.

JSON-Darstellung 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
Felder
allowInStream

boolean

Optional. Gibt an, ob Anzeigen im In-Stream-Format ausgeliefert werden können.
allowInFeed

boolean

Optional. Gibt an, ob Anzeigen im In-Feed-Format ausgeliefert werden können.
allowShorts

boolean

Optional. Gibt an, ob Anzeigen im Shorts-Format ausgeliefert werden können.
allowNonSkippableInStream

boolean

Optional. Gibt an, ob Anzeigen im nicht überspringbaren In-Stream-Format ausgeliefert werden können.

DemandGenSettings

Einstellungen für Demand Gen-Werbebuchungen

JSON-Darstellung 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Felder
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Optional. Die Einstellungen für die Messung durch Drittanbieter für die Demand Gen-Werbebuchung.
linkedMerchantId

string (int64 format)

Optional. Die ID des Merchant Center-Kontos, das für die Bereitstellung eines Produktfeeds verwendet wird.

Dieses Merchant Center-Konto muss bereits mit dem Werbetreibenden verknüpft sein.
geoLanguageTargetingEnabled

boolean

Optional. Nicht veränderbar. Gibt an, ob das Targeting auf Region und Sprachen auf Werbebuchungsebene festgelegt werden kann. Andernfalls müssen die relevanten Targeting-Typen direkt den Anzeigengruppen zugewiesen werden.

Methoden

bulkEditAssignedTargetingOptions

 Targeting-Optionen für mehrere Werbebuchungen gleichzeitig bearbeiten

bulkListAssignedTargetingOptions

 Hier werden die zugewiesenen Targeting-Optionen für mehrere Werbebuchungen und Targeting-Typen aufgeführt.

bulkUpdate

 Aktualisiert mehrere Werbebuchungen.

create

 Erstellt eine neue Werbebuchung.

delete

 Löscht eine Werbebuchung.

duplicate

 Dupliziert eine Werbebuchung.

get

 Ruft eine Werbebuchung ab.

list

 Listet Werbebuchungen eines Werbetreibenden auf.

patch

 Aktualisiert eine vorhandene Werbebuchung.