- Ressource: Anzeigenauftrag
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- 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 beim Erstellen nicht angegeben ist, wird standardmäßig |
entityStatus |
Erforderlich. Steuert, ob der Anzeigenauftrag sein Budget ausgeben und auf Inventar bieten kann.
|
updateTime |
Nur Ausgabe Zeitstempel der letzten Aktualisierung des Anzeigenauftrags. Vom System zugewiesen. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
partnerCosts[] |
Die mit dem Anzeigenauftrag verbundenen Partnerkosten. Ist diese Angabe in der |
pacing |
Erforderlich. Die Einstellung für die Geschwindigkeit der Budgetausgaben 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 Typen von Anzeigenaufträgen.
Der Typ des Anzeigenauftrags bestimmt, welche Einstellungen und Optionen verwendet werden, etwa das Anzeigenformat 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 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 beim Erstellen nicht angegeben ist, wird standardmäßig |
budgetSegments[] |
Erforderlich. Die Liste der Budgetsegmente. Mit einem Budgetsegment können Sie ein spezifisches Budget für einen bestimmten Zeitraum festlegen, für das ein Anzeigenauftrag ausgeführt wird. |
InsertionOrderAutomationType
Mögliche Optionen zum Automatisieren von Gebot und Budget für Anzeigenaufträge.
Enums | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Die Option zur Automatisierung des Anzeigenauftrags ist nicht angegeben oder in dieser Version unbekannt. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Automatische Budgetzuweisung. Erlauben Sie dem System, das Budget automatisch auf die eigenen Werbebuchungen umzuverteilen, um die durch performanceGoal definierte Leistung zu optimieren. Keine Automatisierung der Gebotseinstellungen. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Gebote oder Budgets auf Ebene des Anzeigenauftrags sind nicht automatisiert. Gebot und Budget müssen auf Werbebuchungsebene manuell konfiguriert werden. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Lassen Sie zu, dass das System Gebote automatisch anpasst und das Budget auf die Werbebuchungen des Eigentümers 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, den der Anzeigenauftrag für den angegebenen |
description |
Die Beschreibung des Budgetsegments Damit können Sie Auftragsinformationen für jedes Budgetsegment eingeben und diese Informationen auf die Rechnungen drucken. Muss UTF-8-codiert sein. |
dateRange |
Erforderlich. Die Einstellungen für das Start- und Enddatum des Budgetsegments. Sie werden relativ zur 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 Impression. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Pay-per-Click. |
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 verschiedene Targeting-Typen auf. |
|
Aktualisiert einen vorhandenen Anzeigenauftrag. |