REST Resource: advertisers.lineItems

Ressource: Werbebuchung

Eine einzelne Werbebuchung.

JSON-Darstellung
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Werbebuchung.

advertiserId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem die Werbebuchung gehört.

campaignId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Kampagne, zu der die Werbebuchung gehört

insertionOrderId

string (int64 format)

Erforderlich. Nicht veränderbar. Die eindeutige ID des Anzeigenauftrags, zu dem die Werbebuchung gehört

lineItemId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Position. Vom System zugewiesen.

displayName

string

Erforderlich. Der Anzeigename der Werbebuchung

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.

lineItemType

enum (LineItemType)

Erforderlich. Nicht veränderbar. Der Typ der Werbebuchung.

entityStatus

enum (EntityStatus)

Erforderlich. Steuert, ob die Werbebuchung ihr Budget ausgeben und auf Inventar bieten kann.

  • Für die Methode lineItems.create ist nur ENTITY_STATUS_DRAFT zulässig. Wenn Sie eine Werbebuchung aktivieren möchten, verwenden Sie die Methode lineItems.patch und aktualisieren Sie den Status nach dem Erstellen auf ENTITY_STATUS_ACTIVE.
  • Eine Werbebuchung kann von keinem anderen Status in den ENTITY_STATUS_DRAFT-Status zurückversetzt werden.
  • Wenn der übergeordnete Anzeigenauftrag der Werbebuchung nicht aktiv ist, kann das Budget der Werbebuchung nicht ausgegeben werden, auch wenn ihr eigener Status ENTITY_STATUS_ACTIVE lautet.
updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

partnerCosts[]

object (PartnerCost)

Die Partnerkosten, die mit der Position verknüpft sind.

Falls in der Methode lineItems.create fehlt oder leer ist, übernimmt die neu erstellte Werbebuchung die Partnerkosten vom übergeordneten Anzeigenauftrag.

flight

object (LineItemFlight)

Erforderlich. Start- und Endzeit der Laufzeit der Werbebuchung.

budget

object (LineItemBudget)

Erforderlich. Die Einstellung für die Budgetzuweisung der Werbebuchung.

pacing

object (Pacing)

Erforderlich. Die Einstellung für die Geschwindigkeit der Budgetausgaben der Werbebuchung.

frequencyCap

object (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 maxImpressions in diesem Einstellungsobjekt verwendet werden.

partnerRevenueModel

object (PartnerRevenueModel)

Erforderlich. Die Einstellung für das Partner-Umsatzmodell der Werbebuchung.

conversionCounting

object (ConversionCountingConfig)

Die Conversion-Tracking-Einstellung der Werbebuchung.

creativeIds[]

string (int64 format)

Die IDs der Creatives, die mit der Werbebuchung verknüpft sind.

bidStrategy

object (BiddingStrategy)

Erforderlich. Die Gebotsstrategie der Werbebuchung.

integrationDetails

object (IntegrationDetails)

Integrationsdetails der Werbebuchung.

inventorySourceIds[]

string (int64 format)

Die IDs der privaten Inventarquellen, die der Werbebuchung zugewiesen sind.

targetingExpansion

object (TargetingExpansionConfig)

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[]

enum (LineItemWarningMessage)

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

object (MobileApp)

Die mobile App, die durch die Werbebuchung beworben wird.

Dies gilt nur, wenn lineItemType entweder LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL oder LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL ist.

reservationType

enum (ReservationType)

Nur Ausgabe. Der Reservierungstyp der Werbebuchung.

excludeNewExchanges

boolean

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 (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
Felder
flightDateType

enum (LineItemFlightDateType)

Erforderlich. Der Typ der Laufzeit der Werbebuchung.

dateRange

object (DateRange)

Start- und Enddatum der Werbebuchung Sie werden in Abhängigkeit von der Zeitzone des übergeordneten Werbetreibenden aufgelöst.

  • Erforderlich, wenn flightDateType den Wert LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM hat. Andernfalls wird nur ausgegeben.
  • Wenn Sie einen neuen Flight erstellen, müssen sowohl startDate als auch endDate in der Zukunft liegen.
  • Ein vorhandener Flug mit einem startDate in der Vergangenheit hat eine änderbare endDate, aber eine unveränderliche startDate.
  • endDate muss das startDate oder ein späteres Datum sein, beide vor dem Jahr 2037.
triggerId

string (int64 format)

ID des manuellen Triggers, der der Werbebuchung zugeordnet ist

  • Erforderlich, wenn flightDateType den Wert LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER hat. Darf nicht anderweitig festgelegt werden.
  • Wenn dies festgelegt ist, werden die Laufzeiten der Werbebuchung vom übergeordneten Anzeigenauftrag übernommen.
  • Für aktive Werbebuchungen werden Ausgaben ausgegeben, wenn der ausgewählte Trigger innerhalb der Laufzeit des übergeordneten Anzeigenauftrags aktiviert wird.

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 (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Felder
budgetAllocationType

enum (LineItemBudgetAllocationType)

Erforderlich. Der Typ der Budgetzuweisung.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC ist nur anwendbar, wenn die automatische Budgetzuweisung für den übergeordneten Anzeigenauftrag aktiviert ist.

budgetUnit

enum (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

string (int64 format)

Der maximale Budgetbetrag, der für die Werbebuchung ausgegeben wird. Muss größer als 0 sein.

Wenn budgetAllocationType:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC – dieses Feld ist unveränderlich und wird vom System festgelegt.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, wenn budgetUnit gleich: <ph type="x-smartling-placeholder">
      </ph>
    • BUDGET_UNIT_CURRENCY: Dieses Feld steht für den maximalen Budgetbetrag, der ausgegeben werden kann, in Mikros der Währung des Werbetreibenden. Beispiel: 1500000 steht für 1, 5 Standardeinheiten der Währung.
    • BUDGET_UNIT_IMPRESSIONS enthält dieses Feld die maximale Anzahl der Impressionen, die ausgeliefert werden sollen.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, dieses Feld ist nicht zutreffend und wird vom System ignoriert.

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 (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Felder
markupType

enum (PartnerRevenueModelMarkupType)

Erforderlich. Der Aufschlagstyp des Partner-Umsatzmodells.

markupAmount

string (int64 format)

Erforderlich. Der Aufschlagsbetrag des Partner-Umsatzmodells. muss größer oder gleich 0 sein.

  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM festgelegt ist, wird in diesem Feld der CPM-Aufschlag in Mikros der Währung des Werbetreibenden angegeben. Beispiel: 1500000 steht für 1, 5 Standardeinheiten der Währung.
  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP festgelegt ist, gibt dieses Feld den prozentualen Aufschlag der Mediakosten in Millisekunden an. Beispiel: 100 steht für 0,1% (Dezimalzahl 0,001).
  • Wenn markupType auf PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP festgelegt ist, gibt dieses Feld den prozentualen Aufschlag der Mediagesamtkosten in Millisekunden an. Beispiel: 100 steht für 0,1% (Dezimalzahl 0,001).

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 (TrackingFloodlightActivityConfig)
    }
  ]
}
Felder
postViewCountPercentageMillis

string (int64 format)

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[]

object (TrackingFloodlightActivityConfig)

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

string (int64 format)

Erforderlich. Die ID der Floodlight-Aktivität.

postClickLookbackWindowDays

integer

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

integer

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 (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
Felder
targetingExpansionLevel

enum (TargetingExpansionLevel)

Erforderlich. Gibt an, ob die optimierte Ausrichtung aktiviert ist.

Dieses Feld unterstützt die folgenden Werte:

  • NO_EXPANSION: optimierte Ausrichtung ist deaktiviert
  • LEAST_EXPANSION: optimierte Ausrichtung ist aktiviert

Ist dieses Feld auf einen anderen Wert festgelegt, wird es automatisch auf LEAST_EXPANSION gesetzt.

NO_EXPANSION ist der Standardwert für das Feld und wird automatisch zugewiesen, wenn Sie das Feld nicht konfigurieren.

excludeFirstPartyAudience
(deprecated)

boolean

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 false festgelegt. Wenn dieses Feld nach der Einstellung auf true gesetzt ist, wird das gesamte Targeting auf Zielgruppen mit selbst erhobenen Daten, das dieser Werbebuchung zugewiesen ist, durch ein auszuschließendes Targeting für dieselben Zielgruppen mit selbst erhobenen Daten ersetzt, damit diese Zielgruppen weiterhin ausgeschlossen werden.

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 LEAST_EXPANSION festgelegt.

BALANCED_EXPANSION

Wird bei Verwendung automatisch auf LEAST_EXPANSION festgelegt.

MORE_EXPANSION

Wird bei Verwendung automatisch auf LEAST_EXPANSION festgelegt.

MOST_EXPANSION

Wird bei Verwendung automatisch auf LEAST_EXPANSION festgelegt.

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 excludeFirstPartyAudience verwendet, die eingestellt wurde und nach dem 25. März 2023 eingestellt wird.

Aktualisieren Sie Ihre API-Integration vor dem 25. März 2023, um eigene Zielgruppen mit Zielgruppen-Targeting direkt auszuschließen, da das Feld excludeFirstPartyAudience eingestellt wird.

MobileApp

Eine mobile App, die durch eine Werbebuchung für die Installation einer mobilen App beworben wird

JSON-Darstellung
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Felder
appId

string

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. com.google.android.gm.

iOS-Apps werden durch eine neunstellige App-ID identifiziert, die im App Store von Apple verwendet wird, z. B. 422689480.

platform

enum (Platform)

Nur Ausgabe. Die App-Plattform.

displayName

string

Nur Ausgabe. Der Name der App.

publisher

string

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

bulkEditLineItemAssignedTargetingOptions

Bulk-Bearbeitung der Targeting-Optionen unter einer einzelnen Werbebuchung

bulkListLineItemAssignedTargetingOptions

Listet zugewiesene Targeting-Optionen einer Werbebuchung für alle Targeting-Typen auf.

create

Erstellt eine neue Werbebuchung.

delete

Löscht eine Werbebuchung.

generateDefault

Erstellt eine neue Werbebuchung mit den vom Anzeigenauftrag übernommenen Einstellungen (einschließlich Targeting) und einer ENTITY_STATUS_DRAFT-entity_status.

get

Ruft eine Werbebuchung ab.

list

Listet die Werbebuchungen eines Werbetreibenden auf.

patch

Aktualisiert eine vorhandene Werbebuchung.