- 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 der Wert |
entityStatus |
Erforderlich. Steuert, ob für den Anzeigenauftrag das Budget ausgegeben und Gebote für Inventar abgegeben werden können.
|
updateTime |
Nur Ausgabe Zeitstempel für die letzte 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 verknüpften Partnerkosten. Ist das Feld in der Methode |
pacing |
Erforderlich. Die Einstellung für die Geschwindigkeit der Budgetausgabe 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 angewendet werden, etwa 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 festgelegt wird, wie das Budget des Anzeigenauftrags 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 |
Der Automatisierungstyp, mit dem Gebote und Budgets für den Anzeigenauftrag verwaltet werden. Wenn dieses Feld beim Erstellen nicht angegeben ist, wird standardmäßig der Wert |
budgetSegments[] |
Erforderlich. Die Liste der Budgetsegmente. Mit einem Budgetsegment können Sie für einen bestimmten Zeitraum, in dem ein Anzeigenauftrag ausgeführt wird, ein bestimmtes Budget festlegen. |
InsertionOrderAutomationType
Mögliche Optionen für die Automatisierung von Gebot und Budget für Anzeigenaufträge
Enums | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Die Option für die Automatisierung des Anzeigenauftrags ist nicht angegeben oder in dieser Version unbekannt. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Automatische Budgetzuweisung Erlauben Sie dem System, automatisch das Budget auf die Werbebuchungen zu verlagern, die Eigentümer der Werbebuchungen sind, um die durch „performanceGoal “ definierte Leistung zu optimieren. Keine Automatisierung für 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 |
Erlauben Sie dem System, automatisch Gebote anzupassen und das Budget auf die Werbebuchungen zu verlagern, die Eigentümer der Werbebuchungen sind, 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 die gegebene |
description |
Die Beschreibung des Budgetsegments Sie können damit Auftragsinformationen für jedes Budgetsegment eingeben und auf die Rechnungen drucken. Muss UTF-8-codiert sein. |
dateRange |
Erforderlich. Die Einstellungen für das Start- und Enddatum des Budgetsegments. Sie werden in Bezug auf die 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 |
|
---|---|
|
Listet die zugewiesenen Targeting-Optionen eines Anzeigenauftrags für verschiedene Targeting-Typen auf. |
|
Ein neuer Anzeigenauftrag wird erstellt. |
|
Löscht einen Anzeigenauftrag. |
|
Ruft einen Anzeigenauftrag ab |
|
Listet die Anzeigenaufträge eines Werbetreibenden auf. |
|
Aktualisiert einen vorhandenen Anzeigenauftrag. |