- Ressource: Werbebuchung
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- LineItemType
- LineItemFlight
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- LineItemFlightDateType
- LineItemBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- LineItemBudgetAllocationType
- PartnerRevenueModel
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TrackingFloodlightActivityConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TargetingExpansionConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Plattform
- Methoden
Ressource: Werbebuchung
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 Werbebuchung. |
advertiserId |
Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem die Werbebuchung gehört. |
campaignId |
Nur Ausgabe. Die 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 Position. 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 der letzten Aktualisierung der Werbebuchung. Vom System zugewiesen. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
partnerCosts[] |
Die Partnerkosten, die mit der Position verknüpft sind. Falls in der Methode |
flight |
Erforderlich. Start- und Endzeit der Laufzeit der Werbebuchung. |
budget |
Erforderlich. Die Einstellung für die Budgetzuweisung der Werbebuchung. |
pacing |
Erforderlich. Die Einstellung für die Geschwindigkeit der Budgetausgaben der Werbebuchung. |
frequencyCap |
Erforderlich. Die Einstellungen für das Frequency Capping für Impressionen der Werbebuchung Wenn Sie eine eingeschränkte Begrenzung zuweisen möchten, 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, bei denen die automatische Gebotseinstellung verwendet wird und die ein Targeting auf aktive Zielgruppenlisten haben. |
warningMessages[] |
Nur Ausgabe. Die von der Werbebuchung generierten Warnmeldungen. Durch diese Warnungen wird das Speichern der Werbebuchung nicht blockiert, aber einige verhindern möglicherweise die Ausführung der Werbebuchung. |
mobileApp |
Die mobile App, die durch die 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 in diesem Feld ist „false“. |
LineItemType
Mögliche Arten von Werbebuchungen
Der Typ der Werbebuchung bestimmt, welche Einstellungen und Optionen anwendbar sind, etwa das Format der Anzeigen 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 werden auf CPM-Basis für verschiedene Umgebungen verkauft. |
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 . |
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 Abhängigkeit von der Zeitzone des übergeordneten Werbetreibenden aufgelöst.
|
triggerId |
ID des manuellen Triggers, der der Werbebuchung zugeordnet ist
Warnung:Werbebuchungen mit manuellen Triggern werden nicht mehr in Display- und Video 360 Dieses Feld wird am 1. August 2023 eingestellt. Weitere Informationen finden Sie in unserer Ankündigung zur Einstellung von Funktionen. |
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 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 in Display- und Video 360 Dieser Wert wird am 1. August 2023 eingestellt. Weitere Informationen finden Sie in unserer Ankündigung zur Einstellung von Funktionen. |
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 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 ( |
Felder | |
---|---|
markupType |
Erforderlich. Der Aufschlagstyp des Partner-Umsatzmodells. |
markupAmount |
Erforderlich. Der Aufschlagsbetrag des Partner-Umsatzmodells. muss größer oder gleich 0 sein.
|
PartnerRevenueModelMarkupType
Mögliche Aufschlägestypen 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 |
Berechnen Sie den Partnerumsatz basierend auf einem prozentualen Zuschlag seiner Mediakosten. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Berechnen Sie den Partnerertrag auf der Grundlage eines prozentualen Zuschlags seiner gesamten Mediakosten, der alle Partnerkosten 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 Prozentwert festgelegt werden.
JSON-Darstellung |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Felder | |
---|---|
postViewCountPercentageMillis |
Der Prozentsatz der zu zählenden Post-View-Conversions in Millisekunden (1/1000 %) Der Wert muss zwischen 0 und 100.000 liegen (jeweils einschließlich). Legen Sie beispielsweise den Wert 50.000 fest, wenn Sie beispielsweise 50% der Post-Klick-Conversions erfassen möchten. |
floodlightActivityConfigs[] |
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 |
Erforderlich. Die ID der Floodlight-Aktivität. |
postClickLookbackWindowDays |
Erforderlich. Die Anzahl der Tage, nach denen eine Conversion gezählt werden kann, nachdem auf eine Anzeige geklickt wurde. Der Wert muss zwischen 0 und 90 liegen. |
postViewLookbackWindowDays |
Erforderlich. Die Anzahl der Tage nach dem Ansehen einer Anzeige, in denen eine Conversion gezählt werden kann. Der Wert muss zwischen 0 und 90 liegen. |
TargetingExpansionConfig
Einstellungen, mit denen die Einstellungen für das optimierte Targeting der Werbebuchung gesteuert werden
JSON-Darstellung |
---|
{
"targetingExpansionLevel": enum ( |
Felder | |
---|---|
targetingExpansionLevel |
Erforderlich. Gibt an, ob die optimierte Ausrichtung aktiviert ist. Dieses Feld unterstützt die folgenden Werte:
Ist dieses Feld auf einen anderen Wert festgelegt, wird es automatisch auf
|
excludeFirstPartyAudience |
Gibt an, ob Zielgruppen mit selbst erhobenen Daten bei der Ausweitung der Ausrichtung ausgeschlossen werden sollen. Dieses Feld wurde mit der Einführung der optimierten Ausrichtung eingestellt. Dieses Feld wird auf |
TargetingExpansionLevel
Die Einstellung „Optimierte Ausrichtung“
Enums | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Die Einstellung für das optimierte Targeting ist in dieser Version nicht festgelegt oder unbekannt. |
NO_EXPANSION |
Optimierte Ausrichtung ist deaktiviert. |
LEAST_EXPANSION |
Optimierte Ausrichtung ist aktiviert. |
SOME_EXPANSION |
Wird bei Verwendung automatisch auf |
BALANCED_EXPANSION |
Wird bei Verwendung automatisch auf |
MORE_EXPANSION |
Wird bei Verwendung automatisch auf |
MOST_EXPANSION |
Wird bei Verwendung automatisch auf |
LineItemWarningMessage
Die von einer Werbebuchung generierten Warnmeldungen. Bei diesen Warnungen wird das Speichern einer Werbebuchung nicht blockiert, sie kann jedoch 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 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 |
Die Apps und Das URL-Targeting umfasst keine mobilen Apps. Bei diesem Werbebuchungstyp 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 Werbebuchungstyp müssen Sie ein Targeting auf eine Nutzerliste mit Nutzern von Mobilgeräten vornehmen. 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. |
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. In Zukunft wird die Werbebuchung dann nicht mehr ausgeliefert. Es empfiehlt sich daher, diese Listen aus Ihrem Targeting zu entfernen. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Diese App-Installationswerbebuchung hat keine optimale Gebotsstrategie. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
Deals, auf die diese Werbebuchung ausgerichtet ist, akzeptieren Creative-Größen, 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 eigene Zielgruppen mit Zielgruppen-Targeting direkt auszuschließen, da das Feld |
MobileApp
Eine mobile App, die durch eine 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 durch die Paket-ID identifiziert, die vom Android Play Store verwendet wird, z. B. iOS-Apps werden durch eine neunstellige App-ID identifiziert, 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. Der App-Publisher |
Plattform
Mögliche Plattformen für mobile Apps.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
Keine Plattform angegeben. |
IOS |
iOS-Plattform. |
ANDROID |
Android-Plattform. |
Methoden |
|
---|---|
|
Bulk-Bearbeitung der Targeting-Optionen unter einer einzelnen Werbebuchung |
|
Listet zugewiesene Targeting-Optionen einer Werbebuchung für alle Targeting-Typen auf. |
|
Erstellt eine neue Werbebuchung. |
|
Löscht eine Werbebuchung. |
|
Erstellt eine neue Werbebuchung mit den vom Anzeigenauftrag übernommenen Einstellungen (einschließlich Targeting) und einer ENTITY_STATUS_DRAFT -entity_status . |
|
Ruft eine Werbebuchung ab. |
|
Listet die Werbebuchungen eines Werbetreibenden auf. |
|
Aktualisiert eine vorhandene Werbebuchung. |