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)
  }
}
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 Eindeutige ID der Position 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. Steuert, ob die Werbebuchung ihr Budget ausgeben und auf Inventar bieten kann.

  • Für die Methode lineItems.create ist nur ENTITY_STATUS_DRAFT zulässig. Verwenden Sie zum Aktivieren einer Werbebuchung die Methode lineItems.patch und aktualisieren Sie den Status nach der Erstellung auf ENTITY_STATUS_ACTIVE.
  • Der Status einer Werbebuchung kann nicht von einem anderen Status in den Status "ENTITY_STATUS_DRAFT" geändert werden.
  • Wenn der übergeordnete Anzeigenauftrag der Werbebuchung nicht aktiv ist, kann das Budget der Werbebuchung auch dann nicht ausgegeben werden, wenn ihr eigener Status ENTITY_STATUS_ACTIVE ist.
updateTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel des Zeitpunkts, zu dem die Werbebuchung zuletzt aktualisiert wurde. Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

Die mit der Position verbundenen Partnerkosten.

Ist diese Angabe in der lineItems.create-Methode nicht vorhanden oder leer, übernimmt die neu erstellte Werbebuchung die Partnerkosten vom übergeordneten Anzeigenauftrag.
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 Geschwindigkeit der Budgetausgabe der Werbebuchung.
frequencyCap

object (FrequencyCap)

Erforderlich. Die Einstellungen für das Frequency Capping der Impressionen der Werbebuchung

Wenn Sie eine begrenzte Obergrenze zuweisen, muss das Feld „maxImpressions“ in diesem Einstellungsobjekt verwendet werden.
partnerRevenueModel

object (PartnerRevenueModel)

Erforderlich. Das ist 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 mit automatischer Gebotseinstellung und einem einschließenden Targeting auf infrage kommende Zielgruppenlisten.
warningMessages[]

enum (LineItemWarningMessage)

Nur Ausgabe Die Warnmeldungen der Werbebuchung. Diese Warnungen verhindern nicht das Speichern der Werbebuchung, einige könnten jedoch die Ausführung der Werbebuchung verhindern.
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 Position.
excludeNewExchanges

boolean

Gibt an, ob die Werbebuchung auf neuen Anzeigenplattformen automatisch ausgerichtet werden soll. Der Standardwert für dieses Feld ist „false“.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Nur Ausgabe Spezifische Einstellungen für YouTube- und Partner-Werbebuchungen.

LineItemType

Mögliche Werbebuchungstypen

Der Typ der Werbebuchung bestimmt, welche Einstellungen und Optionen angewendet werden, etwa das Anzeigenformat oder die Targeting-Optionen.

Enums
LINE_ITEM_TYPE_UNSPECIFIED

Typwert ist nicht angegeben oder in dieser Version unbekannt.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der 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 mehr App-Installationen erzielt werden sollen
LINE_ITEM_TYPE_VIDEO_DEFAULT Videoanzeigen, die auf CPM-Basis für verschiedene Umgebungen verkauft werden
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Mit Videoanzeigen lassen sich mehr App-Installationen erzielen.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Displayanzeigen, die im Inventar in mobilen Apps ausgeliefert werden.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Videoanzeigen, die im Inventar in mobilen Apps ausgeliefert werden.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_AUDIO_DEFAULT RTB-Audioanzeigen, die für verschiedene 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 insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

YouTube-Videoanzeigen zur Förderung von Conversions.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der 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 deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

YouTube-Videoanzeigen, bei denen eine Story in einer bestimmten Sequenz gezeigt wird und in denen verschiedene Formate kombiniert werden.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube-Audioanzeigen

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

YouTube-Videoanzeigen mit Optimierung, um mehr einzelne Nutzer zu geringeren Kosten zu erreichen. Kann Bumper-Anzeigen, überspringbare In-Stream-Anzeigen oder verschiedene Typen enthalten.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Standard-YouTube-Videoanzeigen

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

YouTube-Videoanzeigen für internetfähige Fernseher (bis zu 15 Sekunden), die nicht übersprungen werden können.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

YouTube-Videoanzeigen für internetfähige Fernseher (CTV) mit Optimierung, um mehr einzelne Nutzer zu geringeren Kosten zu erreichen. Kann Bumper-Anzeigen, überspringbare In-Stream-Anzeigen oder verschiedene Typen enthalten.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Standard-YouTube-Videoanzeigen für internetfähige Fernseher Schließen Sie nur das In-Stream-Anzeigenformat ein.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Das Ziel dieses Werbebuchungstyps ist es, dass die YouTube-Anzeigen demselben Nutzer in einem bestimmten Zeitraum möglichst oft präsentiert werden.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

YouTube-Videoanzeigen, mit denen mit verschiedenen Anzeigenformaten mehr Aufrufe erzielt werden sollen

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Displayanzeigen, die auf digitalem Inventar für Außenwerbung ausgeliefert werden.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Videoanzeigen, die auf digitalem Inventar für Außenwerbung ausgeliefert werden.

Werbebuchungen dieses Typs und deren Targeting können nicht mit der API erstellt oder aktualisiert werden.

LineItemFlight

Einstellungen zur Steuerung der aktiven Dauer einer Werbebuchung.

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 Werbebuchung Sie werden relativ zur Zeitzone des übergeordneten Werbetreibenden aufgelöst.

  • Erforderlich, wenn flightDateType den Wert LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM hat. Ansonsten nur Ausgabe.
  • Wenn Sie einen neuen Flight erstellen, müssen startDate und endDate in der Zukunft liegen.
  • Ein vorhandener Flight mit einem startDate in der Vergangenheit hat eine änderbare endDate, aber eine unveränderliche startDate.
  • endDate muss startDate oder ein späteres Datum sein, beide vor dem Jahr 2037.

LineItemFlightDateType

Mögliche Typen der Laufzeit einer Werbebuchung.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED 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 werden eigene benutzerdefinierte Laufzeiten verwendet.

LineItemBudget

Einstellungen, die die Budgetzuweisung steuern.

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

enum (LineItemBudgetAllocationType)

Erforderlich. Die Art der Budgetzuweisung.

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

enum (BudgetUnit)

Nur Ausgabe Die Budgeteinheit gibt an, ob das Budget auf einer Währung oder auf Impressionen basiert. 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 gleich:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC: Dieses Feld ist unveränderlich und wird vom System festgelegt.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, wenn budgetUnit gleich:
    • BUDGET_UNIT_CURRENCY: Dieses Feld gibt den maximalen auszugebenden Budgetbetrag in Mikros in der Währung des Werbetreibenden an. Beispiel: 1.500.000 steht für 1, 5 Standardeinheiten der Währung.
    • BUDGET_UNIT_IMPRESSIONS. In diesem Feld wird die maximale Anzahl der Impressionen angegeben, die ausgeliefert werden sollen.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED hat, ist dieses Feld nicht anwendbar und wird vom System ignoriert.

LineItemBudgetAllocationType

Mögliche Typen der Budgetzuweisung.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED 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 Der Werbebuchung wird ein fester maximaler Budgetbetrag zugewiesen.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Für die Werbebuchung gilt kein Budgetlimit.

PartnerRevenueModel

Einstellungen, die festlegen, wie der Partnerumsatz berechnet wird.

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

enum (PartnerRevenueModelMarkupType)

Erforderlich. Der Markup-Typ des Partner-Umsatzmodells.
markupAmount

string (int64 format)

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

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

PartnerRevenueModelMarkupType

Mögliche Markup-Typen für das Partner-Umsatzmodell.

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

Berechnen Sie den Partnerumsatz anhand eines prozentualen Aufschlags auf die Mediakosten.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Berechnen Sie den Partnerumsatz anhand eines prozentualen Aufschlags auf die gesamten Mediakosten, der alle Partner- und Datenkosten umfasst.

ConversionCountingConfig

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

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

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

string (int64 format)

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

Legen Sie beispielsweise einen Wert von 50.000 fest, wenn Sie 50% der Post-Klick-Conversions erfassen möchten.
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.

TrackingFloodlightActivityConfig

Einstellungen, mit denen das Verhalten einer einzelnen Floodlight-Aktivitätskonfiguration gesteuert wird.

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

string (int64 format)

Erforderlich. ID der Floodlight-Aktivität.
postClickLookbackWindowDays

integer

Erforderlich. Gibt an, wie viele Tage nach einem Anzeigenklick eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 (jeweils einschließlich) liegen.
postViewLookbackWindowDays

integer

Erforderlich. Dieser Wert gibt an, wie viele Tage nach dem Ansehen einer Anzeige eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 (jeweils einschließlich) liegen.

LineItemWarningMessage

Die Warnmeldungen, die von einer Werbebuchung generiert werden. Diese Warnungen verhindern nicht das Speichern einer Werbebuchung, sondern können die Ausführung einer Werbebuchung verhindern.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Nicht angegeben oder unbekannt.
INVALID_FLIGHT_DATES Die Laufzeit dieser Werbebuchung ist ungültig. Die Werbebuchung wird nicht ausgeliefert.
EXPIRED Das Enddatum dieser Werbebuchung liegt in der Vergangenheit.
PENDING_FLIGHT Diese Werbebuchung beginnt in Zukunft.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Alle vom Partner aktivierten Plattformen sind vom Targeting augeschlossen. Die Werbebuchung wird nicht ausgeliefert.
INVALID_INVENTORY_SOURCE Es gibt keine Ausrichtung auf aktive Inventarquellen. Die Werbebuchung wird nicht ausgeliefert.
APP_INVENTORY_INVALID_SITE_TARGETING Das Targeting dieser Werbebuchung auf Apps und URLs umfasst keine mobilen Apps. Für diese Werbebuchungsart müssen Sie mobile Apps in Ihr Channel-, Websitelisten- oder App-Targeting aufnehmen. Die Werbebuchung wird nicht ausgeliefert.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Diese Werbebuchung ist nicht auf Nutzer von Mobilgeräten ausgerichtet. Für diese Werbebuchungsart muss das Targeting auf eine Nutzerliste mit mobilen Nutzern ausgerichtet werden. Die Werbebuchung wird nicht ausgeliefert.
NO_VALID_CREATIVE Diese Werbebuchung enthält kein gültiges Creative. Die Werbebuchung wird nicht ausgeliefert.
PARENT_INSERTION_ORDER_PAUSED Der Anzeigenauftrag für diese Werbebuchung wurde pausiert. Die Werbebuchung wird nicht ausgeliefert.
PARENT_INSERTION_ORDER_EXPIRED Das Enddatum des Anzeigenauftrags dieser Werbebuchung liegt in der Vergangenheit. Die Werbebuchung wird nicht ausgeliefert.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

Für diese Werbebuchung wird die Einstellung „excludeFirstPartyAudience“ verwendet, die verworfen wurde und nach dem 25. März 2023 eingestellt wird.

Aktualisieren Sie Ihre API-Integration vor dem 25. März 2023, um Zielgruppen mit selbst erhobenen Daten mithilfe des Zielgruppen-Targetings direkt auszuschließen, um die Einstellung des Felds excludeFirstPartyAudience zu berücksichtigen.

MobileApp

Eine mobile App, die mit einer Werbebuchung für die Installation einer mobilen App beworben wird.

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

string

Erforderlich. Die vom Plattform-Store bereitgestellte ID der App.

Android-Apps werden anhand der Bundle-ID identifiziert, die im Play Store von Android 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 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 
{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
Felder
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Erforderlich. Die Gebotsstrategie der „YouTube und Partner“-Werbebuchung.
viewFrequencyCap

object (FrequencyCap)

Die Einstellungen für das Frequency Capping der Werbebuchung,

Wenn Sie eine begrenzte Obergrenze zuweisen, muss das Feld „maxViews“ in diesem Einstellungsobjekt verwendet werden.
thirdPartyMeasurementSettings

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

Optional. Die Einstellungen der Drittanbieter-Messung der Werbebuchung.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

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

enum (YoutubeAndPartnersContentCategory)

Die Art von Inhalten, in denen YouTube- und Partner-Anzeigen ausgeliefert werden.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Nur Ausgabe Die Inhaltskategorie, die bei der Auslieferung der Werbebuchung gilt. Wenn sowohl für die Werbebuchung als auch für den Werbetreibenden eine Inhaltskategorie festgelegt ist, wird bei der Auslieferung der Werbebuchung die strengere Inhaltskategorie wirksam.
targetFrequency

object (TargetFrequency)

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

string (int64 format)

Die ID des Händlers, die mit der Werbebuchung für den Produktfeed verknüpft ist.
relatedVideoIds[]

string

Die IDs der Videos erscheinen unter der primären Videoanzeige, wenn sie in der YouTube App auf Mobilgeräten wiedergegeben wird.
leadFormId

string (int64 format)

Die ID des Formulars, über das Leads generiert werden.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Die Einstellungen für VideoAdSequence

YoutubeAndPartnersThirdPartyMeasurementSettings

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

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

object (ThirdPartyVendorConfig)

Drittanbieter, die die Sichtbarkeit messen

Folgende 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)

Drittanbieter, die die Markensicherheit messen

Folgende Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Drittanbieter, die die Reichweite messen

Folgende Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Drittanbieter, die die Anzeigenwirkung auf die Markenbekanntheit messen

Folgende Drittanbieter sind zulässig:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

Einstellungen für die Konfiguration durch Drittanbieter für Analysen.

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

enum (ThirdPartyVendor)

Drittanbieter für Messungen
placementId

string

Die ID, die vom Drittanbieter auf der Plattform 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 Wassergraben.
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 von Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

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

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

boolean

Gibt an, ob das Targeting auf das Inventar von Kanälen und Videos auf YouTube sowie auf YouTube-Videos, die auf anderen Websites eingebettet sind, erfolgen soll.
includeGoogleTv

boolean

Optional. Gibt an, ob ein Targeting auf Inventar in Video-Apps erfolgen soll, die für Google TV verfügbar sind.
includeYoutubeVideoPartners

boolean

Gibt an, ob das Targeting auf Inventar einer Reihe von Partnerwebsites und -Apps durchgeführt werden soll, die denselben Standards der Markensicherheit entsprechen wie auf YouTube.

YoutubeAndPartnersContentCategory

Kategorien zur Markensicherheit für YouTube- und Partnerinhalte

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 mit einer breiten Palette von Inhalten, die für die meisten Marken geeignet ist. Die Inhalte entsprechen den Richtlinien für werbefreundliche Inhalte von YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Eine Kategorie, die sämtliche Inhalte auf YouTube und bei Videopartnern umfasst und den Monetarisierungsstandards entspricht.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Eine Kategorie mit einer eingeschränkten Auswahl an Inhalten, die strengere Anforderungen erfüllt, insbesondere in Bezug auf anstößige oder unangemessene Sprache und sexuelle Anzüglichkeit.

TargetFrequency

Mit dieser Einstellung wird festgelegt, wie oft die Anzeigen im Durchschnitt über einen bestimmten Zeitraum für dieselbe Person ausgeliefert werden.

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

string (int64 format)

Die angestrebte Häufigkeit, mit der die Anzeigen im Durchschnitt derselben Person innerhalb des durch timeUnit und timeUnitCount festgelegten Zeitraums präsentiert werden.
timeUnit

enum (TimeUnit)

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

Die folgende Zeiteinheit gilt:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Die Anzahl von timeUnit, die die angestrebte Häufigkeit erreicht.

Die folgenden Einschränkungen gelten basierend auf dem Wert von timeUnit:

  • TIME_UNIT_WEEKS – muss 1 sein

VideoAdSequenceSettings

Einstellungen für VideoAdSequence.

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

enum (VideoAdSequenceMinimumDuration)

Das Mindestintervall, bis zu dem dieser Nutzer diese Sequenz noch einmal sieht.
steps[]

object (VideoAdSequenceStep)

Die Schritte, aus denen die Sequenz besteht.

VideoAdSequenceMinimumDuration

Aufzählung für die mögliche minimale Intervallzeit, bis dieselbe VideoAdSequence wieder demselben Nutzer präsentiert wird

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

Das Detail eines einzelnen Schritts in einer VideoAdSequence

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. Für den ersten Schritt gibt es keinen vorherigen.
interactionType

enum (InteractionType)

Die Interaktion im vorherigen Schritt, die den Zuschauer zu diesem Schritt führt. Der erste Schritt hat nicht „InteractionType“.

InteractionType

Die Arten der Interaktion bei einem Schritt.

Enums
INTERACTION_TYPE_UNSPECIFIED Nicht angegeben oder unbekannt
INTERACTION_TYPE_PAID_VIEW Bezahlte Ansicht
INTERACTION_TYPE_SKIP Vom Betrachter übersprungen.
INTERACTION_TYPE_IMPRESSION Eine (gesehene) Anzeigenimpression
INTERACTION_TYPE_ENGAGED_IMPRESSION Eine Anzeigenimpression, die vom Nutzer nicht sofort übersprungen wurde, aber auch nicht das abrechenbare Ereignis erreicht hat.

Methoden

bulkEditAssignedTargetingOptions

 Sie können Targeting-Optionen für mehrere Werbebuchungen gleichzeitig bearbeiten.

bulkListAssignedTargetingOptions

 Listet die zugewiesenen Targeting-Optionen für mehrere Werbebuchungen und Targeting-Typen auf.

bulkUpdate

 Aktualisiert mehrere Werbebuchungen

create

 Erstellt eine neue Werbebuchung.

delete

 Löscht eine Position.

duplicate

 Dupliziert eine Werbebuchung.

generateDefault

 Erstellt eine neue Werbebuchung mit Einstellungen (einschließlich Targeting) aus dem Anzeigenauftrag und einem ENTITY_STATUS_DRAFT-entity_status.

get

 Ruft eine Werbebuchung ab.

list

 Listet die Werbebuchungen eines Werbetreibenden auf.

patch

 Aktualisiert eine vorhandene Werbebuchung.