- Ressource: Anzeigenauftrag
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- InsertionOrderType
- InsertionOrderBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- BillableOutcome
- Methoden
Ressource: Anzeigenauftrag
Ein einzelner Anzeigenauftrag.
JSON-Darstellung |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Felder | |
---|---|
name |
Nur Ausgabe. Der Ressourcenname des Anzeigenauftrags. |
advertiserId |
Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem der Anzeigenauftrag gehört. |
campaignId |
Erforderlich. Nicht veränderbar. Die eindeutige ID der Kampagne, zu der der Anzeigenauftrag gehört. |
insertionOrderId |
Nur Ausgabe. Die eindeutige ID des Anzeigenauftrags. Vom System zugewiesen. |
displayName |
Erforderlich. Der Anzeigename des Anzeigenauftrags. Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein. |
insertionOrderType |
Der Typ des Anzeigenauftrags. Wenn dieses Feld bei der Erstellung nicht angegeben wird, wird standardmäßig |
entityStatus |
Erforderlich. Damit wird gesteuert, ob für den Anzeigenauftrag das zugehörige Budget ausgegeben und Gebote für Inventar abgegeben werden können.
|
updateTime |
Nur Ausgabe. Der Zeitstempel, der angibt, wann der Anzeigenauftrag 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: |
partnerCosts[] |
Die Partnerkosten, die mit dem Anzeigenauftrag verknüpft sind. Wenn diese Angabe in der Methode |
pacing |
Erforderlich. Die Einstellung für die Budgetausgabegeschwindigkeit des Anzeigenauftrags. |
frequencyCap |
Erforderlich. Die Einstellung für das Frequency Capping des Anzeigenauftrags. |
integrationDetails |
Zusätzliche Integrationsdetails des Anzeigenauftrags. |
performanceGoal |
Erforderlich. Leistungsziel des Anzeigenauftrags. |
budget |
Erforderlich. Die Einstellungen für die Budgetzuweisung des Anzeigenauftrags. |
bidStrategy |
Die Gebotsstrategie des Anzeigenauftrags. Standardmäßig ist |
reservationType |
Nur Ausgabe. Der Reservierungstyp des Anzeigenauftrags. |
billableOutcome |
Nicht veränderbar. Das abrechenbare Ergebnis des Anzeigenauftrags. Ergebnisbasierte Käufe wurden eingestellt. |
InsertionOrderType
Mögliche Arten eines Anzeigenauftrags.
Der Typ des Anzeigenauftrags bestimmt, welche Einstellungen und Optionen anwendbar sind, z. B. das Format der Anzeigen oder die Targeting-Optionen.
Enums | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Der Typ des Anzeigenauftrags ist nicht angegeben oder unbekannt. |
RTB |
Echtzeitgebote |
OVER_THE_TOP |
Over-the-Top. |
InsertionOrderBudget
Einstellungen, mit denen gesteuert wird, wie das Budget für Anzeigenaufträge zugewiesen wird.
JSON-Darstellung |
---|
{ "budgetUnit": enum ( |
Felder | |
---|---|
budgetUnit |
Erforderlich. Nicht veränderbar. Die Budgeteinheit gibt an, ob das Budget auf einer Währung oder auf Impressionen basiert. |
automationType |
Die Art der Automatisierung, die zur Verwaltung von Gebot und Budget für den Anzeigenauftrag verwendet wird. Wenn dieses Feld bei der Erstellung nicht angegeben wird, wird standardmäßig |
budgetSegments[] |
Erforderlich. Die Liste der Budgetsegmente. Mit einem Budgetsegment können Sie ein bestimmtes Budget für einen bestimmten Zeitraum angeben, in dem ein Anzeigenauftrag aktiv ist. |
InsertionOrderAutomationType
Mögliche Optionen zur Automatisierung von Gebot und Budget für Anzeigenaufträge
Enums | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Die Automatisierungsoption für Anzeigenaufträge ist in dieser Version nicht angegeben oder unbekannt. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Automatische Budgetzuweisung Lassen Sie das System das Budget automatisch auf die Inhaber der Werbebuchungen umverteilen, um die durch performanceGoal definierte Leistung zu optimieren. Keine Automatisierung für Gebotseinstellungen. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Gebote oder Budgets werden auf Anzeigenauftragsebene nicht automatisiert. Gebot und Budget müssen manuell auf Werbebuchungsebene konfiguriert werden. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Lassen Sie zu, dass das System automatisch Gebote anpasst und das Budget auf eigene Werbebuchungen verlagert, um die durch performanceGoal definierte Leistung zu optimieren. |
InsertionOrderBudgetSegment
Einstellungen, mit denen das Budget eines einzelnen Budgetsegments gesteuert wird.
JSON-Darstellung |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Felder | |
---|---|
budgetAmountMicros |
Erforderlich. Der Budgetbetrag, der für den Anzeigenauftrag für den angegebenen |
description |
Die Beschreibung des Budgetsegments. Sie können damit Auftragsinformationen für jedes Budgetsegment eingeben und auf die Rechnungen gedruckt lassen. Muss UTF-8-codiert sein. |
dateRange |
Erforderlich. Die Einstellungen für das Start- und Enddatum des Budgetsegments. Sie werden in Abhängigkeit von der Zeitzone des übergeordneten Werbetreibenden aufgelöst.
|
campaignBudgetId |
Die |
BillableOutcome
Mögliche abrechenbare Ergebnisse für einen Anzeigenauftrag.
Enums | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Nicht angegebenes abrechenbares Ergebnis. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Sie zahlen pro Impressionen. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Sie zahlen pro Klick. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Sie zahlen pro Active View. |
Methoden |
|
---|---|
|
Erstellt einen neuen Anzeigenauftrag. |
|
Löscht einen Anzeigenauftrag. |
|
Ruft einen Anzeigenauftrag ab. |
|
Listet die Anzeigenaufträge eines Werbetreibenden auf. |
|
Listet die zugewiesenen Targeting-Optionen eines Anzeigenauftrags für alle Targeting-Typen auf. |
|
Aktualisiert einen vorhandenen Anzeigenauftrag. |