REST Resource: advertisers.lineItems

Ressource: Werbebuchung

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 Position 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. 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 festgelegt, ob das Budget der Werbebuchung ausgegeben und auf Inventar geboten werden kann.

  • Für die lineItems.create-Methode 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 dem Erstellen auf ENTITY_STATUS_ACTIVE.
  • Der Status einer Werbebuchung kann nicht von einem anderen Status in den Status ENTITY_STATUS_DRAFT zurückverändert 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 lautet.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Position zuletzt aktualisiert wurde. Vom System zugewiesen.

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

object (PartnerCost)

Die Partnerkosten, die mit der Position verknüpft sind.

Wenn das Attribut in der lineItems.create-Methode fehlt oder leer ist, werden die Partnerkosten für die neu erstellte Werbebuchung aus dem ü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 Geschwindigkeit der Budgetausgaben der Werbebuchung.
frequencyCap

object (FrequencyCap)

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

Das Feld maxImpressions in diesem Einstellungsobjekt muss verwendet werden, wenn ein begrenztes Limit 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, bei denen die automatische Gebotseinstellung verwendet wird und die ein Targeting auf aktive Zielgruppenlisten haben.
warningMessages[]

enum (LineItemWarningMessage)

Nur Ausgabe. Die Warnmeldungen, die von der Werbebuchung generiert wurden. Durch diese Warnungen wird das Speichern der Werbebuchung nicht blockiert, aber einige verhindern möglicherweise die Ausführung der Werbebuchung.
mobileApp

object (MobileApp)

Die mobile App, die durch die 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 der Werbebuchung ausgeschlossen werden sollen. Dieses Feld ist standardmäßig auf „false“ gesetzt.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Nur Ausgabe. Einstellungen speziell für Werbebuchungen für YouTube und Partner

LineItemType

Mögliche Typen einer Werbebuchung.

Der Typ der Werbebuchung bestimmt, welche Einstellungen und Optionen gelten, z. B. das Anzeigenformat oder die Targeting-Optionen.

Enums
LINE_ITEM_TYPE_UNSPECIFIED

Der Typwert ist in dieser Version nicht angegeben oder 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 wird
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, mit denen die Anzahl der Installationen einer App gesteigert werden soll
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Displayanzeigen, die in Inventar in mobilen Apps 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 Inventar in mobilen Apps 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 werden für verschiedene Umgebungen verkauft.
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 von insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

YouTube-Videoanzeigen, mit denen Conversions erzielt werden sollen.

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 mit einer Länge von 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 verschiedenen 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, mit denen Sie mehr einzelne Nutzer zu geringeren Kosten erreichen. Dazu können Bumper-Anzeigen, überspringbare In-Stream-Anzeigen oder eine Kombination aus verschiedenen Typen gehören.

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

Standardmäßige 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 (bis zu 15 Sekunden) auf internetfähigen Fernsehern

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, mit denen Sie mehr einzelne Nutzer zu geringeren Kosten erreichen. Dazu können Bumper-Anzeigen, überspringbare In-Stream-Anzeigen oder eine Kombination aus verschiedenen Typen gehören.

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

Standard-YouTube-Videoanzeigen auf internetfähigen Fernsehern Schließen Sie nur das In-Stream-Anzeigenformat ein.

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

Ziel dieses Werbebuchungstyps ist es, derselben Person in einem bestimmten Zeitraum die angestrebte Anzahl von YouTube-Anzeigen 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 mit verschiedenen Anzeigenformaten mehr Aufrufe erzielen möchten.

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 auf digitalem Inventar für 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 auf Inventar für digitale Außenwerbung ausgeliefert werden

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

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 flightDateType den Wert LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM hat. Andernfalls wird nur ausgegeben.
  • Beim Erstellen eines neuen Flugs müssen sowohl startDate als auch endDate in der Zukunft liegen.
  • Ein vorhandener Flug mit einer startDate in der Vergangenheit hat eine veränderbare endDate, aber eine unveränderliche startDate.
  • endDate muss das Jahr startDate oder ein späteres Jahr sein, das vor dem Jahr 2037 liegt.

LineItemFlightDateType

Mögliche Arten der Laufzeit einer Werbebuchung

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Der Typwert ist in dieser Version nicht angegeben oder 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 festlegen, 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 ist nur dann gültig, wenn die automatische Budgetzuweisung für den übergeordneten Anzeigenauftrag aktiviert ist.
budgetUnit

enum (BudgetUnit)

Nur Ausgabe. Die Budgeteinheit gibt an, ob das Budget währungs- oder impressionbasiert 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:

  • 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 kann, in Mikros der Währung des Werbetreibenden. 1500000 steht beispielsweise für 1,5 Standardeinheiten der Währung.
    • BUDGET_UNIT_IMPRESSIONS enthält dieses Feld die maximale Anzahl der Impressionen, die ausgeliefert werden sollen.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, dieses Feld ist nicht zutreffend und wird vom System ignoriert.

LineItemBudgetAllocationType

Mögliche Arten der Budgetzuweisung.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Der Typwert ist in dieser Version nicht angegeben oder 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 festes maximales Budget zugewiesen.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Auf die Werbebuchung wird kein Budgetlimit angewendet.

PartnerRevenueModel

Einstellungen, mit denen gesteuert wird, wie der Partnerumsatz berechnet wird.

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

enum (PartnerRevenueModelMarkupType)

Erforderlich. Der Aufschlagstyp des Partner-Umsatzmodells.
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, wird in diesem Feld der CPM-Aufschlag in Mikros der Währung des Werbetreibenden angegeben. 1500000 steht beispielsweise für 1,5 Standardeinheiten der Währung.
  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP festgelegt ist, gibt dieses Feld den prozentualen Aufschlag der Mediakosten in Millisekunden an. 100 steht beispielsweise für 0,1 % (dezimal 0,001).
  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP festgelegt ist, gibt dieses Feld den prozentualen Aufschlag der Mediagesamtkosten in Millisekunden an. 100 steht beispielsweise für 0,1 % (dezimal 0,001).

PartnerRevenueModelMarkupType

Mögliche Markup-Typen des Partner-Umsatzmodells.

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

Der Partnerumsatz wird anhand eines prozentualen Zuschlags auf die Mediakosten berechnet.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Der Partnerumsatz wird anhand eines prozentualen Aufschlags auf die Mediagesamtkosten berechnet, einschließlich aller Partner- und Datenkosten.

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 Prozentwert 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 von einem Prozent). Der Wert muss zwischen 0 und 100.000 liegen (jeweils einschließlich).

Wenn Sie beispielsweise 50 % der Conversions nach dem Klick erfassen möchten, geben Sie den Wert 50.000 ein.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Die Konfigurationen der Floodlight-Aktivitäten, die zum Erfassen von Conversions verwendet werden.

Die Anzahl der gezählten Conversions ist die Summe aller Conversions, die über alle 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. Die ID der Floodlight-Aktivität.
postClickLookbackWindowDays

integer

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

integer

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

LineItemWarningMessage

Die von einer Werbebuchung generierten Warnmeldungen. Diese Warnungen verhindern nicht das Speichern einer Werbebuchung, aber möglicherweise die Ausführung.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Nicht angegeben oder unbekannt.
INVALID_FLIGHT_DATES Diese Werbebuchung hat eine ungültige Laufzeit. Die Werbebuchung wird nicht ausgeliefert.
EXPIRED Das Enddatum dieser Position liegt in der Vergangenheit.
PENDING_FLIGHT Die Auslieferung dieser Werbebuchung beginnt in der 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 enthält keine mobilen Apps. Für den Typ dieser Werbebuchung müssen Sie mobile Apps in den Channel, die Websiteliste oder das 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 den Typ dieser Werbebuchung ist ein Targeting auf eine Nutzerliste mit Nutzern von Mobilgeräten erforderlich. 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. Diese Einstellung wird eingestellt und ist nach dem 25. März 2023 nicht mehr verfügbar.

Aktualisieren Sie Ihre API-Integration vor dem 25. März 2023, um eigene Zielgruppen mit Zielgruppen-Targeting direkt auszuschließen, da das Feld excludeFirstPartyAudience eingestellt wird.

MobileApp

Eine mobile App, die über eine App-Installations-Werbebuchung 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 durch die Paket-ID identifiziert, die vom Android 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 Keine Plattform 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 Werbebuchung „YouTube und Partner“.
viewFrequencyCap

object (FrequencyCap)

Die Einstellungen für das Frequency Capping der Werbebuchung.

Das Feld maxViews in diesem Einstellungsobjekt muss verwendet werden, wenn ein begrenztes Limit zugewiesen wird.
thirdPartyMeasurementSettings

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

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

object (YoutubeAndPartnersInventorySourceConfig)

Einstellungen, mit denen gesteuert wird, auf welches Inventar von YouTube und Partnern die Werbebuchung ausgerichtet ist.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Die Art der Inhalte, bei denen die Anzeigen von YouTube und Partnern ausgeliefert werden.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Nur Ausgabe. Die Inhaltskategorie, die bei der Auslieferung der Werbebuchung gilt. Wenn die Contentkategorie sowohl auf Werbebuchungs- als auch auf Werbetreibendenebene festgelegt ist, wird bei der Auslieferung der Werbebuchung die strengere Kategorie angewendet.
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 die Anzeige in der YouTube App auf Mobilgeräten wiedergegeben wird.
leadFormId

string (int64 format)

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

object (VideoAdSequenceSettings)

Die Einstellungen für VideoAdSequence.

YoutubeAndPartnersThirdPartyMeasurementSettings

Einstellungen, mit denen gesteuert wird, welche Drittanbieter bestimmte Messwerte zu Werbebuchungen messen.

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

object (ThirdPartyVendorConfig)

Die Drittanbieter, die die Sichtbarkeit messen.

Folgende Drittanbieter sind betroffen:

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

Die Drittanbieter, die die Markensicherheit messen.

Folgende Drittanbieter sind betroffen:

  • 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 betroffen:

  • 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 möglich:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

Einstellungen, mit denen gesteuert wird, wie Drittanbieter für Messungen 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 von Drittanbietern 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 von Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

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

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

boolean

Gibt an, ob ein Targeting auf Inventar von Kanälen und Videos auf YouTube sowie auf YouTube-Videos erfolgen soll, die auf anderen Websites eingebettet sind.
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

Ob das Inventar auf eine Sammlung von Partnerwebsites und ‑Apps ausgerichtet werden soll, die denselben Standards der Markensicherheit unterliegen wie 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 Unternehmen geeignet ist. Die Inhalte basieren auf den Richtlinien für werbefreundliche Inhalte von YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Diese Kategorie umfasst alle Inhalte auf YouTube und bei Videopartnern, die den Monetarisierungsstandards entsprechen.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Kategorie mit einer eingeschränkten Auswahl an Inhalten, die höhere Anforderungen erfüllen, insbesondere in Bezug auf anstößige oder unangemessene Sprache und sexuelle Anzüglichkeit.

TargetFrequency

Mit dieser Einstellung wird festgelegt, wie oft die Anzeigen durchschnittlich in einem bestimmten Zeitraum derselben Person präsentiert werden.

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

string (int64 format)

Die durchschnittliche Häufigkeit, mit der die Anzeigen derselben Person im Zeitraum zwischen timeUnit und timeUnitCount präsentiert werden sollen.
timeUnit

enum (TimeUnit)

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

Es gilt die folgende Zeiteinheit:

  • TIME_UNIT_WEEKS
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

VideoAdSequenceSettings

Einstellungen für VideoAdSequence

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

enum (VideoAdSequenceMinimumDuration)

Das minimale Zeitintervall, bevor derselbe Nutzer diese Sequenz noch einmal sieht.
steps[]

object (VideoAdSequenceStep)

Die Schritte, aus denen die Sequenz besteht.

VideoAdSequenceMinimumDuration

Die Aufzählung für die mögliche Mindestzeitspanne, bevor derselbe Nutzer die Videoanzeigensequenz noch einmal 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 Arten der Interaktion bei einem Schritt.

Enums
INTERACTION_TYPE_UNSPECIFIED Nicht angegeben oder unbekannt
INTERACTION_TYPE_PAID_VIEW Ein bezahlter Aufruf
INTERACTION_TYPE_SKIP Vom Zuschauer übersprungen.
INTERACTION_TYPE_IMPRESSION Eine (angeklickte) Anzeigenimpression.
INTERACTION_TYPE_ENGAGED_IMPRESSION Eine Anzeigenimpression, die vom Betrachter nicht sofort übersprungen wurde, aber auch nicht das abrechenbare Ereignis erreicht hat.

Methoden

bulkEditAssignedTargetingOptions

 Mit der Bulk-Bearbeitung können Sie die Targeting-Optionen für mehrere Werbebuchungen gleichzeitig bearbeiten.

bulkListAssignedTargetingOptions

 Hier werden zugewiesene Targeting-Optionen für mehrere Werbebuchungen verschiedener Targeting-Typen aufgelistet.

bulkUpdate

 Mehrere Werbebuchungen werden aktualisiert.

create

 Erstellt eine neue Werbebuchung.

delete

 Löscht eine Werbebuchung.

duplicate

 Dupliziert eine Werbebuchung.

generateDefault

 Erstellt eine neue Werbebuchung mit den vom Anzeigenauftrag übernommenen Einstellungen (einschließlich Targeting) und einer ENTITY_STATUS_DRAFT-entity_status.

get

 Ruft eine Werbebuchung ab.

list

 Listet Werbebuchungen eines Werbetreibenden auf.

patch

 Aktualisiert eine vorhandene Werbebuchung.