- Ressource: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Platform
- Methoden
Ressource: LineItem
Eine einzelne Werbebuchung.
JSON-Darstellung |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Felder | |
---|---|
name |
Nur Ausgabe Der Ressourcenname der Position. |
advertiserId |
Nur Ausgabe Die eindeutige ID des Werbetreibenden, zu dem die Werbebuchung gehört. |
campaignId |
Nur Ausgabe Eindeutige ID der Kampagne, zu der die Werbebuchung gehört |
insertionOrderId |
Erforderlich. Nicht veränderbar. Die eindeutige ID des Anzeigenauftrags, zu dem die Werbebuchung gehört. |
lineItemId |
Nur Ausgabe Die eindeutige ID der Werbebuchung. Vom System zugewiesen. |
displayName |
Erforderlich. Der Anzeigename der Werbebuchung. Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein. |
lineItemType |
Erforderlich. Nicht veränderbar. Der Typ der Werbebuchung. |
entityStatus |
Erforderlich. Steuert, ob die Werbebuchung ihr Budget ausgeben und auf Inventar bieten kann.
|
updateTime |
Nur Ausgabe Der Zeitstempel, 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: |
partnerCosts[] |
Die mit der Position verbundenen Partnerkosten. Ist das Feld in der |
flight |
Erforderlich. Start- und Endzeit der Laufzeit der Werbebuchung |
budget |
Erforderlich. Die Budgetzuweisungseinstellung der Werbebuchung. |
pacing |
Erforderlich. Die Einstellung für die Budgetausgabegeschwindigkeit der Werbebuchung. |
frequencyCap |
Erforderlich. Die Einstellungen für das Frequency Capping der Impressionen der Werbebuchung Wenn Sie eine begrenzte Obergrenze festlegen, muss das Feld „ |
partnerRevenueModel |
Erforderlich. Die Einstellung für das Partner-Umsatzmodell der Werbebuchung. |
conversionCounting |
Die Conversion-Tracking-Einstellung der Werbebuchung. |
creativeIds[] |
Die IDs der Creatives, die mit der Werbebuchung verknüpft sind. |
bidStrategy |
Erforderlich. Die Gebotsstrategie der Werbebuchung. |
integrationDetails |
Integrationsdetails der Werbebuchung. |
inventorySourceIds[] |
Die IDs der privaten Inventarquellen, die der Werbebuchung zugewiesen sind |
targetingExpansion |
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[] |
Nur Ausgabe Die von der Werbebuchung generierten Warnmeldungen. Diese Warnungen verhindern nicht, dass die Werbebuchung gespeichert wird. Einige Warnungen können jedoch dazu führen, dass die Werbebuchung nicht ausgeführt wird. |
mobileApp |
Die mobile App, die von der Werbebuchung beworben wird Dies gilt nur, wenn |
reservationType |
Nur Ausgabe Der Reservierungstyp der Werbebuchung. |
excludeNewExchanges |
Gibt an, ob neue Anzeigenplattformen vom automatischen Targeting der Werbebuchung ausgeschlossen werden sollen. Der Standardwert für dieses Feld ist „false“. |
LineItemType
Mögliche Werbebuchungstypen
Vom Typ der Werbebuchung hängt ab, welche Einstellungen und Optionen angewendet werden, etwa 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 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 die Anzahl der Installationen einer App gesteigert werden kann |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
Videoanzeigen werden auf CPM-Basis für verschiedene Umgebungen verkauft. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
Videoanzeigen, mit denen mehr App-Installationen erzielt werden |
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 vorhanden. Dieser Typ gilt nur für Werbebuchungen mit einem Anzeigenauftrag von insertionOrderType OVER_THE_TOP . |
LineItemFlight
Einstellungen, mit denen die aktive Dauer einer Werbebuchung gesteuert wird.
JSON-Darstellung |
---|
{ "flightDateType": enum ( |
Felder | |
---|---|
flightDateType |
Erforderlich. Der Typ der Laufzeit der Werbebuchung. |
dateRange |
Start- und Enddatum der Werbebuchung Sie werden in Bezug auf die Zeitzone des übergeordneten Werbetreibenden aufgelöst.
|
triggerId |
Die ID des manuellen Triggers, der der Werbebuchung zugeordnet ist.
Warnung:Werbebuchungen mit manuellen Triggern werden nicht mehr über Display & Video 360 ausgeliefert. Dieses Feld wird am 1. August 2023 eingestellt. Weitere Informationen |
LineItemFlightDateType
Mögliche Arten 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. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
Für die Werbebuchung wird ein Trigger verwendet. Warnung:Werbebuchungen mit manuellen Triggern werden nicht mehr über Display & Video 360 ausgeliefert. Dieser Wert wird am 1. August 2023 eingestellt. Weitere Informationen |
LineItemBudget
Einstellungen, mit denen die Budgetzuweisung gesteuert wird.
JSON-Darstellung |
---|
{ "budgetAllocationType": enum ( |
Felder | |
---|---|
budgetAllocationType |
Erforderlich. Der Typ der Budgetzuweisung.
|
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 |
Der maximale Budgetbetrag, der für die Werbebuchung ausgegeben wird Muss größer als 0 sein. Wenn
|
LineItemBudgetAllocationType
Mögliche Typen 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 |
Der Werbebuchung wird ein fester maximaler Budgetbetrag zugewiesen. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
Für die Werbebuchung wird kein Budgetlimit angewendet. |
PartnerRevenueModel
Einstellungen, mit denen gesteuert wird, wie der Partnerumsatz berechnet wird.
JSON-Darstellung |
---|
{
"markupType": enum ( |
Felder | |
---|---|
markupType |
Erforderlich. Der Markup-Typ des Partner-Umsatzmodells. |
markupAmount |
Erforderlich. Der Aufschlagsbetrag des Partner-Umsatzmodells. muss größer oder gleich 0 sein.
|
PartnerRevenueModelMarkupType
Mögliche Markup-Typen für das Partner-Umsatzmodell.
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 der Grundlage eines festen CPM. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
Berechnen Sie den Partnerumsatz basierend auf einem prozentualen Zuschlag auf seine Mediakosten. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Berechnen Sie den Partnerumsatz auf der Grundlage 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 ( |
Felder | |
---|---|
postViewCountPercentageMillis |
Der Prozentsatz der zu zählenden Post-View-Conversions in Millis (1/1000 %). Der Wert muss zwischen 0 und 100.000 (einschließlich) liegen. Legen Sie beispielsweise den Wert 50.000 fest, um 50% der Post-Klick-Conversions zu erfassen. |
floodlightActivityConfigs[] |
Die Konfigurationen für Floodlight-Aktivitäten, die zum Conversion-Tracking 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 |
Erforderlich. Die ID der Floodlight-Aktivität. |
postClickLookbackWindowDays |
Erforderlich. Gibt an, wie viele Tage nach dem Klick auf eine Anzeige eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 (einschließlich) liegen. |
postViewLookbackWindowDays |
Erforderlich. Die Anzahl der Tage nach der Wiedergabe einer Anzeige, innerhalb der eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 (einschließlich) liegen. |
TargetingExpansionConfig
Einstellungen, über die die Einstellungen für das optimierte Targeting der Werbebuchung gesteuert werden
JSON-Darstellung |
---|
{
"targetingExpansionLevel": enum ( |
Felder | |
---|---|
targetingExpansionLevel |
Erforderlich. Gibt an, ob optimiertes Targeting aktiviert ist. Dieses Feld unterstützt die folgenden Werte:
Wird für dieses Feld ein anderer Wert festgelegt, wird er automatisch auf
|
excludeFirstPartyAudience |
Gibt an, ob Zielgruppen mit selbst erhobenen Daten von der Ausweitung der Ausrichtung ausgeschlossen werden sollen. Dieses Feld wurde mit der Einführung des optimierten Targetings eingestellt. Dieses Feld wird auf |
TargetingExpansionLevel
Einstellung für die optimierte Ausrichtung
Enums | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Die Einstellung für das optimierte Targeting ist nicht angegeben oder in dieser Version unbekannt. |
NO_EXPANSION |
Die optimierte Ausrichtung ist deaktiviert. |
LEAST_EXPANSION |
Die optimierte Ausrichtung ist aktiviert. |
SOME_EXPANSION |
Er wird automatisch auf |
BALANCED_EXPANSION |
Er wird automatisch auf |
MORE_EXPANSION |
Er wird automatisch auf |
MOST_EXPANSION |
Er wird automatisch auf |
LineItemWarningMessage
Die Warnmeldungen, die von einer Werbebuchung generiert werden. Diese Arten von Warnungen verhindern nicht, dass eine Werbebuchung gespeichert wird, möglicherweise aber die Ausführung einer Werbebuchung verhindern.
Enums | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Nicht angegeben oder unbekannt. |
INVALID_FLIGHT_DATES |
Diese Werbebuchung hat eine ungültige Laufzeit. Die Werbebuchung wird nicht ausgeführt. |
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 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 dieser Werbebuchung auf Apps und URLs enthält keine mobilen Apps. Für diesen Werbebuchungstyp müssen Sie mobile Apps in den Channel, die Websiteliste oder das App-Targeting aufnehmen. Die Werbebuchung wird nicht ausgeführt. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Diese Werbebuchung ist nicht auf Nutzer von Mobilgeräten ausgerichtet. Für diesen Werbebuchungstyp müssen Sie ein Targeting auf eine Nutzerliste mit mobilen Nutzern vornehmen. Die Werbebuchung wird nicht ausgeführt. |
NO_VALID_CREATIVE |
Diese Werbebuchung enthält kein gültiges Creative. 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. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Diese Werbebuchung ist auf keine Zielgruppenlisten ausgerichtet. Dadurch könnte Ihr Budget zu schnell erschöpft sein. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Für diese Werbebuchung für die App-Installation sind keine Conversion-Pixel eingerichtet. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Diese Werbebuchung ist auf mindestens eine Nutzerliste ausgerichtet, die nicht mehr verfügbar ist. Zukünftig wird dadurch verhindert, dass die Werbebuchung ausgeliefert wird. Es empfiehlt sich daher, diese Listen aus dem Targeting zu entfernen. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Diese App-Installationswerbebuchung hat keine optimale Gebotsstrategie. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
Für Deals, auf die diese Werbebuchung ausgerichtet ist, sind Creative-Größen zulässig, die nicht verwendet werden. Dies kann die Auslieferung oder Leistung der Werbebuchung beeinträchtigen. |
NO_CREATIVE_FOR_TARGETED_DEALS |
Diese Werbebuchung enthält kein Creative für die ausgewählten Deals. |
TARGETING_DEPRECATED_GEO_TARGET |
Diese Werbebuchung ist auf ein nicht mehr unterstütztes geografisches Ziel ausgerichtet. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Für diese Werbebuchung wird die Einstellung „ Aktualisieren Sie Ihre API-Integration vor dem 25. März 2023, um Zielgruppen mit selbst erhobenen Daten, für die die Ausrichtung auf Zielgruppen verwendet wird, direkt auszuschließen, wenn das Feld |
MobileApp
Eine mobile App, die mit einer Werbebuchung für die Installation einer mobilen App beworben wird.
JSON-Darstellung |
---|
{
"appId": string,
"platform": enum ( |
Felder | |
---|---|
appId |
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. iOS-Apps sind durch eine neunstellige App-ID gekennzeichnet, die im App Store von Apple verwendet wird, z. B. |
platform |
Nur Ausgabe Die App-Plattform. |
displayName |
Nur Ausgabe Der Name der App. |
publisher |
Nur Ausgabe App-Publisher |
Plattform
Mögliche Plattformen für mobile Apps.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
Die Plattform ist nicht angegeben. |
IOS |
iOS-Plattform. |
ANDROID |
Android-Plattform. |
Methoden |
|
---|---|
|
Targeting-Optionen unter einer einzelnen Werbebuchung im Bulk bearbeiten |
|
Listet die zugewiesenen Targeting-Optionen einer Werbebuchung für verschiedene Targeting-Typen auf. |
|
Erstellt eine neue Werbebuchung. |
|
Löscht eine Position. |
|
Erstellt eine neue Werbebuchung mit Einstellungen (einschließlich Targeting), die vom Anzeigenauftrag übernommen wurden, und einem ENTITY_STATUS_DRAFT entity_status . |
|
Ruft eine Werbebuchung ab. |
|
Listet die Werbebuchungen eines Werbetreibenden auf. |
|
Aktualisiert eine vorhandene Werbebuchung. |