REST Resource: curators.curatedPackages

Ressource: CuratedPackage

Stellt ein ausgewähltes Inventarpaket dar, das von einem Kurator erstellt und verwaltet wird.

JSON-Darstellung
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Felder
name

string

ID. Der eindeutige Ressourcenname für das kuratierte Paket. Format: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Erforderlich. Der Anzeigename, der dem ausgewählten Paket vom Kurator zugewiesen wurde. Kann zum Filtern der Antwort der Methode curatedPackages.list verwendet werden.

description

string

Optional. Eine vom Kurator bereitgestellte Beschreibung des kuratierten Pakets.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für den Zeitpunkt, zu dem das kuratierte Paket erstellt wurde. Kann zum Filtern der Antwort der Methode curatedPackages.list verwendet werden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann das kuratierte Paket zuletzt aktualisiert wurde. Kann zum Filtern der Antwort der Methode curatedPackages.list verwendet werden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

Optional. Der Mindest-CPM, den ein Käufer bieten muss, um an Auktionen für Inventar in diesem kuratierten Paket teilzunehmen. Kann zum Filtern der Antwort der Methode curatedPackages.list verwendet werden.

state

enum (State)

Nur Ausgabe. Der Status des kuratierten Pakets. Kann zum Filtern der Antwort der Methode curatedPackages.list verwendet werden.

accessSettings

object (AccessControlSettings)

Erforderlich. Einstellungen zum Steuern des Zugriffs auf das ausgewählte Paket.

Der Zugriff auf dieses ausgewählte Paket ist auf die Media-Planer auf der Zulassungsliste und den Creator beschränkt. Käufer und Bieter können nicht auf die Zulassungsliste für diese Ressource gesetzt werden und haben keinen direkten Zugriff darauf.

targeting

object (PackageTargeting)

Optional. Targeting-Kriterien für das kuratierte Paket.

curationFeeVisibility

enum (CurationFeeVisibility)

Optional. Nicht veränderbar. Die Sichtbarkeit der kombinierten Gebühr für das Kuratierungspaket und der Gebühren für das Datensegment (die Gesamtgebühr für die Kuratierung).

Gebühr, die dem Kurator für dieses Paket gezahlt wird. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
feeCpm

object (Money)

Optional. Die CPM-Gebühr, die der Kurator Käufern in Rechnung stellt, die dieses kuratierte Paket verwenden. Kann zum Filtern der Antwort der Methode curatedPackages.list verwendet werden.

millipercentOfMediaFee

string (int64 format)

Optional. Die Gebühr wird als Prozentsatz der Impressionskosten berechnet und in Milliprozent angegeben. Beispiel: 1 % wird als 1000 dargestellt.

Ende der sich gegenseitig ausschließenden Felder.

Bundesland

Der Status des kuratierten Pakets.

Enums
STATE_UNSPECIFIED Standardwert.
ACTIVE Das kuratierte Paket ist aktiv.
INACTIVE Das ausgewählte Paket ist inaktiv.

AccessControlSettings

Einstellungen zum Steuern des Zugriffs auf ein ausgewähltes Paket.

JSON-Darstellung
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Felder
allowlistedMediaPlanners[]

string

Erforderlich. Nicht veränderbar. Die Liste der Mediaplaner, denen explizit Zugriff auf das ausgewählte Paket gewährt wurde. Infrage kommende Mediaplaner finden Sie in der Methode mediaPlanners.list. Derzeit kann nur ein einzelner Mediaplaner auf die Zulassungsliste gesetzt werden.

Format: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Targeting-Kriterien für kuratierte und Auktionspakete.

JSON-Darstellung
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Felder
includedDeviceTypes[]

enum (DeviceType)

Optional. Die Liste der eingeschlossenen Gerätetypen, auf die die Ausrichtung erfolgen soll. Wenn das Feld leer ist, wird die Ausrichtung auf alle Gerätetypen vorgenommen.

includedEnvironment

enum (Environment)

Optional. Die Zielumgebung. Wenn nicht angegeben, wird die Ausrichtung auf alle Umgebungen vorgenommen.

includedCreativeFormat

enum (CreativeFormat)

Optional. Das Creative-Format, auf das das Targeting erfolgen soll. Wenn keine Angabe erfolgt, wird das Targeting auf alle Creative-Markup-Typen angewendet.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

Optional. Der Typ der AMP-Zielseite. Wenn nicht festgelegt, wird das Inventar unabhängig vom AMP-Status ausgewählt.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

Optional. Die Liste der enthaltenen Status für autorisierte Verkäufer, auf die das Targeting angewendet wird. Wenn das Feld leer ist, wird das Inventar unabhängig vom Verkäuferstatus berücksichtigt.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

Optional. Die nativen Inventartypen, auf die das Targeting erfolgt. Wenn das Feld leer ist, wird das Targeting auf Inventar unabhängig vom nativen Inventartyp angewendet.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

Optional. Die Liste der Open Measurement-Typen, auf die das Targeting erfolgt. Wenn das Feld leer ist, wird das Inventar unabhängig von der Unterstützung von Open Measurement angesprochen.

includedRestrictedCategories[]

enum (RestrictedCategory)

Optional. Die Liste der eingeschränkten Kategorien, auf die das Targeting angewendet wird. Wenn das Feld leer ist, wird das Targeting auf Inventar unabhängig von eingeschränkten Kategorien angewendet.

includedRewardedType

enum (RewardedType)

Optional. Der Typ der Prämie, auf die die Anzeige ausgerichtet ist. Wenn nicht festgelegt, wird das Inventar unabhängig vom Typ der Anzeige mit Prämie ausgewählt.

videoTargeting

object (PackageVideoTargeting)

Optional. Videospezifische Targeting-Kriterien.

minimumPredictedViewabilityPercentage

string (int64 format)

Optional. Der angestrebte Mindestprozentsatz für die prognostizierte Sichtbarkeit.

Dieser Wert muss ein Vielfaches von 10 zwischen 10 und 90 (einschließlich) sein. Beispiel: 10 ist gültig, 0, 15 und 100 sind jedoch nicht gültig. Ein Wert von 10 bedeutet, dass die Konfiguration nur auf Anzeigenflächen angewendet wird, für die wir eine Sichtbarkeit von mindestens 10 % prognostizieren.

Wenn kein Wert festgelegt ist, wird das Inventar unabhängig von der vorhergesagten Sichtbarkeit angesprochen.

languageTargeting

object (StringTargetingDimension)

Optional. Die Sprachen, auf die die Anzeigen ausgerichtet werden sollen. Wenn keine Angabe erfolgt, wird das Inventar unabhängig von der Sprache ausgewählt. Eine Liste der unterstützten Sprachcodes finden Sie unter https://developers.google.com/google-ads/api/data/codes-formats#languages.

includedAdSizes[]

object (AdSize)

Optional. Die Liste der Anzeigengrößen, auf die das Targeting erfolgen soll. Wenn nicht festgelegt, wird das Targeting auf Inventar unabhängig von der Anzeigengröße vorgenommen.

In kuratierten Paketen werden die Anzeigengrößen PIXEL und INTERSTITIAL unterstützt.

publisherTargeting

object (StringTargetingDimension)

Optional. Die Ziel-Publisher. Wenn nicht festgelegt, wird das Targeting auf Inventar unabhängig vom Publisher vorgenommen. Publisher werden anhand ihrer Publisher-ID aus der ads.txt- oder app-ads.txt-Datei identifiziert. Weitere Informationen finden Sie unter https://iabtechlab.com/ads-txt/ und https://iabtechlab.com/app-ads-txt/.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

Optional. Die angestrebte minimale prognostizierte Klickrate im Bereich [10, 10000] (0, 01 % bis 10 %). Ein Wert von 50 bedeutet, dass die Konfiguration nur auf Anzeigenflächen angewendet wird, für die wir eine Klickrate von mindestens 0,05 % prognostizieren.

Wenn kein Wert festgelegt ist, wird das Inventar unabhängig von der prognostizierten Klickrate angesprochen.

verticalTargeting

object (CriteriaTargeting)

Optional. Die ein- oder ausgeschlossenen Branchen, wie unter https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals definiert. Wenn keine Angabe erfolgt, wird das Inventar unabhängig von der Branche ausgewählt.

geoTargeting

object (CriteriaTargeting)

Optional. Die IDs der geografischen Kriterien, die ein- oder ausgeschlossen werden sollen, wie unter https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv definiert. Wenn nicht festgelegt, wird das Inventar unabhängig vom geografischen Standort ausgerichtet.

includedDataSegments[]

string

Optional. Die aktiven Datensegmente, auf die das Targeting erfolgen soll. Wenn die Option nicht festgelegt ist, wird das Targeting auf Inventar unabhängig von Datensegmenten vorgenommen. Format: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Optional. Informationen zum Placement-Targeting, z. B. URL, mobile Apps.

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

Optional. Die vom Publisher bereitgestellten Signale, auf die das Targeting erfolgen soll. Wenn diese Option nicht festgelegt ist, erfolgt das Targeting auf Inventar unabhängig von den vom Publisher bereitgestellten Signalen.

DeviceType

Der allgemeine Gerätetyp, auf den die Ausrichtung erfolgen soll.

Enums
DEVICE_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
DEVICE_TYPE_PERSONAL_COMPUTER Ausrichtung auf Desktop- oder Laptop-Computer.
DEVICE_TYPE_CONNECTED_TV Ausrichtung auf internetfähige Fernseher: Geräte, die TV-Inhalte streamen, einschließlich Smart-TVs, Spielekonsolen und Streaming-Boxen/-Sticks.
DEVICE_TYPE_PHONE Ausrichtung auf High-End-Mobilgeräte.
DEVICE_TYPE_TABLET Targeting auf Tablets.

Umgebung

Die Zielumgebung.

Enums
ENVIRONMENT_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
ENVIRONMENT_SITE Ausrichtung auf Inventar, das auf einer werbeunterstützten Website gerendert wird.
ENVIRONMENT_APP Targeting auf Inventar in einer mobilen App.

CreativeFormat

Das Creative-Format, auf das das Targeting ausgerichtet werden kann.

Enums
CREATIVE_FORMAT_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
CREATIVE_FORMAT_DISPLAY Anzeigenflächen für HTML-Display-Creatives werden als Ziel ausgewählt.
CREATIVE_FORMAT_VIDEO Anzeigenflächen für Video-Creatives werden als Ziel ausgewählt.
CREATIVE_FORMAT_AUDIO Anzeigenflächen für Audio-Creatives werden als Ziel ausgewählt.

AcceleratedMobilePageType

Der Typ der AMP-Implementierung (Accelerated Mobile Page), auf die das Targeting erfolgen soll.

Enums
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP Targeting auf Inventar auf Standardwebseiten, die kein AMP-Framework verwenden.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Das Targeting erfolgt auf Inventar auf Seiten, die mit dem AMP-HTML-Framework erstellt wurden.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Hiermit wird Inventar auf Seiten mit dem AMP-Story-Format (STAMP) angesprochen, das für visuelles Storytelling optimiert ist (z.B. antippbare Vollbildinhalte).

AuthorizedSellerStatus

Stellt die Beziehung zwischen dem Publisher und dem Verkäufer dar, wie sie in einer ads.txt- oder app-ads.txt-Datei deklariert ist.

Enums
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
AUTHORIZED_SELLER_STATUS_DIRECT Es wird Inventar angesprochen, bei dem der Verkäufer als „DIRECT“ deklariert ist. Das bedeutet, dass der Publisher (Rechteinhaber) direkte Kontrolle über das Verkäuferkonto hat und für dieses Konto einen direkten Geschäftsvertrag mit dem Werbesystem geschlossen hat.
AUTHORIZED_SELLER_STATUS_RESELLER Es wird Inventar angesprochen, bei dem der Verkäufer als „RESELLER“ deklariert ist. Das bedeutet, dass der Publisher ein anderes Rechtssubjekt autorisiert hat, das aufgeführte Verkäuferkonto zu verwalten und seine Werbefläche weiterzuverkaufen.

NativeInventoryType

Gibt den Typ des Creative-Renderings an, der von einer Anzeigenfläche unterstützt wird, insbesondere in Bezug auf native Anzeigen.

Enums
NATIVE_INVENTORY_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Ausrichtung auf Anzeigenflächen, auf denen nur native Anzeigen akzeptiert und gerendert werden.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Anzeigenflächen, die entweder native Anzeigen oder Banneranzeigen akzeptieren und rendern.

OpenMeasurementType

Der Typ der Open Measurement Interface Definition (OMID), auf den das Targeting erfolgen soll.

Enums
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
OPEN_MEASUREMENT_TYPE_OMID_V1 Inventar, das die Open Measurement Interface Definition (OMID) v1 unterstützt.

RestrictedCategory

Stellt die spezifischen Anzeigenkategorien dar, die gemäß Richtlinien nicht für die Ausrichtung verwendet werden dürfen.

Enums
RESTRICTED_CATEGORY_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
RESTRICTED_CATEGORY_ALCOHOL Targeting auf Inventar, für das der Publisher Anzeigen für alkoholische Getränke zulässt.
RESTRICTED_CATEGORY_GAMBLING Targeting auf Inventar, in dem der Publisher Glücksspielwerbung zulässt.

RewardedType

Definiert Targeting-Kriterien basierend darauf, ob das Anzeigeninventar dem Nutzer eine Prämie für das Ansehen einer Anzeige bietet.

Enums
REWARDED_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
REWARDED_TYPE_NON_REWARDED Ausrichtung auf Inventar, das dem Nutzer KEINE explizite Prämie für das Ansehen der Anzeige oder die Interaktion mit ihr bietet.
REWARDED_TYPE_REWARDED Anzeigenflächen, bei denen der Nutzer eine Prämie erhält, wenn er sich die Anzeige ansieht oder mit ihr interagiert.

PackageVideoTargeting

Videospezifische Targeting-Kriterien.

JSON-Darstellung
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Felder
includedMimeTypes[]

enum (VideoMimeType)

Optional. Die Liste der MIME-Typen für Videos, die als Ziel festgelegt sind, mit den von der IANA veröffentlichten MIME-Typ-Strings (https://www.iana.org/assignments/media-types/media-types.xhtml)). Wenn das Feld leer ist, wird das Targeting auf Inventar unabhängig vom MIME-Typ des Videos angewendet.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

Optional. Die angestrebte maximale Dauer der Videoanzeige. Wenn diese Option nicht festgelegt ist, wird das Inventar unabhängig von der maximalen Dauer der Videoanzeige ausgewählt.

includedPositionTypes[]

enum (PositionType)

Optional. Die Typen der Anzeigenpositionen für Videoanzeigen, auf die die Ausrichtung erfolgt. Wenn das Feld leer ist, wird das Inventar unabhängig vom Typ der Videoanzeigenposition ausgewählt.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

Optional. Die Methode für die Auslieferung des Zielvideos. Wenn die Richtlinie nicht konfiguriert ist, wird das Inventar unabhängig von der Videobereitstellungsmethode ausgewählt.

plcmtTargeting

object (VideoPlcmtTargeting)

Optional. Die Typen der ausgewählten Video-Placements. Wenn nicht festgelegt, wird das Targeting auf Inventar unabhängig vom Typ des Video-Placements angewendet.

includedPlaybackMethods[]

enum (PlaybackMethod)

Optional. Die Liste der ausgewählten Videowiedergabe-Methoden. Wenn das Feld leer ist, wird das Inventar unabhängig von der Videowiedergabe-Methode ausgewählt.

minimumPredictedCompletionRatePercentage

string (int64 format)

Optional. Der Prozentsatz der angestrebten minimalen prognostizierten Abschlussrate.

Dieser Wert muss ein Vielfaches von 10 zwischen 10 und 90 (einschließlich) sein. Beispiel: 10 ist gültig, 0, 15 und 100 sind jedoch nicht gültig. Ein Wert von 10 bedeutet, dass die Konfiguration nur auf Anzeigenflächen angewendet wird, für die wir eine Abschlussrate von mindestens 10 % prognostizieren.

Wenn kein Wert festgelegt ist, wird das Inventar unabhängig von der prognostizierten Abschlussrate angesprochen.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

Optional. Die Größe des Videoplayers, auf den die Ausrichtung erfolgt. Wenn nichts festgelegt ist, wird das Targeting auf Inventar unabhängig von der Größe des Videoplayers vorgenommen.

VideoMimeType

Die MIME-Typen für Videos, auf die das Targeting erfolgen soll.

Enums
VIDEO_MIME_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
VIDEO_MIME_TYPE_THREEGPP 3GPP-Containerformat, das auf 3G-Mobiltelefonen verwendet wird.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 MPEG-4-Container, normalerweise mit H.264-Codec.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (für VPAID-Anzeigen verwendet)
VIDEO_MIME_TYPE_WEBM WebM-Container mit VP9-Codec.

MaximumVideoAdDuration

Die Obergrenze für die Dauer des Videoanzeigen-Creatives, auf das das Targeting erfolgen soll. Die Enum-Werte definieren Buckets. Wenn Sie einen Wert auswählen, muss die Dauer des Creatives kleiner oder gleich der angegebenen Zeit sein.

Enums
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS Gilt für Videoanzeigen mit einer Dauer von bis zu 15 Sekunden (0 < Dauer <= 15 Sekunden).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS Gilt für Videoanzeigen mit einer Dauer von bis zu 20 Sekunden (0 < Dauer <= 20 Sekunden).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS Gilt für Videoanzeigen mit einer Dauer von bis zu 30 Sekunden (0 < Dauer <= 30 Sekunden).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS Gilt für Videoanzeigen mit einer Dauer von bis zu 60 Sekunden (0 < Dauer <= 60 Sekunden).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS Gilt für Videoanzeigen mit einer Dauer von bis zu 90 Sekunden (0 < Dauer <= 90 Sekunden).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS Gilt für Videoanzeigen mit einer Dauer von bis zu 120 Sekunden (0 < Dauer <= 120 Sekunden).

PositionType

Die Position der Anzeige in einem Video, auf die ein Targeting möglich ist.

Enums
POSITION_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
POSITION_TYPE_MIDROLL Die Anzeige wird in der Mitte des Videoinhalts abgespielt.
POSITION_TYPE_POSTROLL Die Anzeige wird nach dem Videoinhalt abgespielt.
POSITION_TYPE_PREROLL Die Anzeige wird vor dem Videoinhalt abgespielt.

ContentDeliveryMethod

Targeting-Kriterien basierend auf der Auslieferungsmethode des Videoinhalts.

Enums
CONTENT_DELIVERY_METHOD_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
CONTENT_DELIVERY_METHOD_STREAMING Ausrichtung auf Videoinhalte, die live übertragen werden.
CONTENT_DELIVERY_METHOD_PROGRESSIVE Targeting auf Videoinhalte, die schrittweise übertragen werden, je nachdem, was für die Wiedergabe auf dem Client erforderlich ist.

VideoPlcmtTargeting

Definiert Targeting-Kriterien basierend auf dem Typ des Video-Placements, die oft dem IAB OpenRTB-Feld „plcmt“ entsprechen.

JSON-Darstellung
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Felder
selectionType

enum (SelectionType)

Erforderlich. Der Auswahltyp für die Liste der Video-Placements.

videoPlcmtTypes[]

enum (VideoPlcmtType)

Erforderlich. Die Liste der Typen von Video-Placements, auf die die Ausrichtung erfolgt. Wenn das Feld leer ist, wird das Targeting auf Inventar unabhängig vom Typ des Video-Placements angewendet.

SelectionType

Enum für die möglichen Auswahltypen, die von Targeting-Dimensionen verwendet werden.

Enums
SELECTION_TYPE_UNSPECIFIED Nicht angegebener Auswahltyp. Sollte nicht verwendet werden.
SELECTION_TYPE_INCLUDE Die Werte in der Targeting-Dimension sind enthalten.
SELECTION_TYPE_EXCLUDE Die Werte in der Targeting-Dimension werden ausgeschlossen.

VideoPlcmtType

Gibt den Typ des Video-Placements gemäß den OpenRTB-Standards an.

Enums
VIDEO_PLCMT_TYPE_UNSPECIFIED Standardwert. Sollte nicht in Targeting-Spezifikationen verwendet werden.
INSTREAM Pre-Roll-, Mid-Roll- und Post-Roll-Anzeigen, die vor, während oder nach den vom Nutzer angeforderten Streaming-Videoinhalten wiedergegeben werden. Bei In-Stream-Videos muss der Ton beim Start des Players standardmäßig aktiviert sein oder der Nutzer muss die explizite Nutzerabsicht haben, sich die Videoinhalte anzusehen. Es kann zwar andere Inhalte um den Player herum geben, aber die Videoinhalte müssen im Mittelpunkt des Besuchs des Nutzers stehen. Das Video sollte der Hauptinhalt auf der Seite und der einzige sichtbare Videoplayer sein, der bei der Wiedergabe Ton abspielen kann. Wenn der Player in einen schwebenden/fixierten Player umgewandelt wird, sollten nachfolgende Anzeigenaufrufe die aktualisierte Player-Größe korrekt wiedergeben.
ACCOMPANYING_CONTENT Pre-Roll-, Mid-Roll- und Post-Roll-Anzeigen, die vor, während oder nach gestreamten Videoinhalten wiedergegeben werden. Der Videoplayer wird vor, zwischen oder nach Textabsätzen oder grafischen Inhalten geladen und abgespielt. Die Wiedergabe beginnt erst, wenn er im Darstellungsbereich erscheint. Die Wiedergabe von begleitendem Content sollte erst beginnen, wenn er in den Darstellungsbereich gelangt. Er kann in einen schwebenden/fixierten Player umgewandelt werden, wenn er von der Seite gescrollt wird.
INTERSTITIAL Videoanzeigen, die ohne Videoinhalte wiedergegeben werden. Während der Wiedergabe muss sie der Mittelpunkt der Seite sein, den Großteil des Darstellungsbereichs einnehmen und darf nicht aus dem Sichtfeld gescrollt werden können. Das kann in Placements wie In-App-Videos oder Diashows sein.
NO_CONTENT Videoanzeigen, die ohne gestreamte Videoinhalte wiedergegeben werden. Das kann in Placements wie Diashows, nativen Feeds, In-Content- oder fixierten/schwebenden Anzeigen der Fall sein.

PlaybackMethod

Die Wiedergabemethode, auf die das Targeting erfolgen soll.

Enums
PLAYBACK_METHOD_UNSPECIFIED Nicht angegebene Videowiedergabe-Methode. Sollte nicht verwendet werden.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON Die Wiedergabe beginnt automatisch, wenn die Seite oder der Inhalt geladen wird.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF Die Wiedergabe beginnt automatisch, wenn die Seite oder der Inhalt geladen wird, aber ohne Ton.
PLAYBACK_METHOD_CLICK_TO_PLAY Die Wiedergabe wird durch eine Nutzeraktion (z.B. Klicken auf eine Wiedergabeschaltfläche) gestartet.

VideoPlayerSizeTargeting

Gibt die Größe des Videoplayers an, auf den das Targeting erfolgen kann. Sowohl für die Breite als auch für die Höhe müssen Werte ungleich null festgelegt werden.

JSON-Darstellung
{
  "minimumWidth": string,
  "minimumHeight": string
}
Felder
minimumWidth

string (int64 format)

Erforderlich. Die Mindestbreite des Videoplayers in Pixeln.

minimumHeight

string (int64 format)

Erforderlich. Die Mindesthöhe des Videoplayers in Pixeln.

StringTargetingDimension

Allgemeines Targeting mit Stringwerten.

JSON-Darstellung
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Felder
selectionType

enum (SelectionType)

Erforderlich. Wie die Elemente in dieser Liste ausgerichtet werden sollen.

values[]

string

Erforderlich. Die angegebenen Werte.

AdSize

Stellt die Größe einer einzelnen Anzeigenfläche oder eines Creatives dar.

JSON-Darstellung
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Felder
width

string (int64 format)

Die Breite der Anzeigenfläche in Pixeln. Dieses Feld ist nur vorhanden, wenn der Größentyp PIXEL ist.

height

string (int64 format)

Die Höhe der Anzeigenfläche in Pixeln. Dieses Feld ist nur vorhanden, wenn der Größentyp PIXEL ist.

type

enum (Type)

Der Typ der Größe der Anzeigenfläche.

Typ

Stellt verschiedene Arten von Anzeigenflächen-/Creative-Größen dar.

Enums
TYPE_UNSPECIFIED Ein Platzhalter für einen nicht definierten Größentyp.
PIXEL Anzeigenfläche mit Größe, die durch Höhe und Breite in Pixeln angegeben wird.
INTERSTITIAL Spezielle Größe zur Beschreibung einer Interstitial-Anzeigenfläche.
NATIVE Vom Publisher gerenderte native (mobile) Anzeigen.
FLUID Die Größe von flexiblen (responsiven) Anzeigen kann automatisch an die Umgebung angepasst werden.

CriteriaTargeting

Allgemeines Targeting für Targeting-Dimensionen, das eine Liste mit ein- und ausgeschlossenen numerischen IDs enthält. Dies kann nicht mit der Syntax für Listenfilter gefiltert werden.

JSON-Darstellung
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Felder
targetedCriteriaIds[]

string (int64 format)

Eine Liste der numerischen IDs, die einbezogen werden sollen.

excludedCriteriaIds[]

string (int64 format)

Eine Liste der numerischen IDs, die ausgeschlossen werden sollen.

PackagePlacementTargeting

Targeting, das festlegt, wo die Anzeigen ausgeliefert werden können, z. B. auf bestimmten Websites oder in bestimmten mobilen Apps. Verschiedene Placement-Targeting-Typen werden logisch mit ODER verknüpft.

JSON-Darstellung
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Felder
uriTargeting

object (StringTargetingDimension)

Optional. Die Liste der Ziel- oder ausgeschlossenen URLs. Die Domains sollten ohne „http/https“ angegeben werden (z. B. google.com) und dürfen maximal 5 Pfade pro URL enthalten.

mobileAppTargeting

object (StringTargetingDimension)

Optional. Die Liste der IDs von mobilen Anwendungs-IDs, die Publishern gehören und auf die Anzeigen ausgerichtet oder die ausgeschlossen sind. Derzeit werden nur Android- und Apple-Apps unterstützt.

Die Android-App-ID, z. B. com.google.android.apps.maps, finden Sie in der Google Play Store-URL. Die iOS-App-ID (eine Zahl) finden Sie am Ende der iTunes Store-URL. Mobile Apps von Erstanbietern sind entweder enthalten oder ausgeschlossen.

includedMobileAppCategoryTargeting[]

string (int64 format)

Optional. Die Liste der Ziel-App-Kategorien.

PackagePublisherProvidedSignalsTargeting

Targeting für vom Publisher bereitgestellte Signale. Verschiedene Typen von vom Publisher bereitgestellten Signalen werden logisch mit ODER verknüpft.

JSON-Darstellung
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Felder
audienceTargeting

object (TaxonomyTargeting)

Optional. Die Liste der IDs von Zielgruppen, auf die die Ausrichtung erfolgt oder die ausgeschlossen werden. Basierend auf Version 1.1 der IAB-Taxonomie für Zielgruppen (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

Optional. Die Liste der IDs von Content ID-Inhalten, auf die die Ausrichtung erfolgt oder die ausgeschlossen werden. Basierend auf Version 2.2 der IAB-Taxonomie für Inhalte (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

Optional. Die Liste der IDs für Video- und Audiosignale, die als Targeting-Kriterien festgelegt oder ausgeschlossen wurden. Dies sind zusätzliche Signale, die von vom Publisher bereitgestellten Signalen unterstützt werden.

TaxonomyTargeting

Definiert Targeting-Kriterien für die Verarbeitung des ID-Bereichs der IAB-Taxonomie für Zielgruppen und Inhalte.

JSON-Darstellung
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Felder
targetedTaxonomyIds[]

string

Optional. Die Liste der IDs für die Taxonomie der Inhalte, auf die die Ausrichtung erfolgt.

excludedTaxonomyIds[]

string

Optional. Die Liste der IDs für die Taxonomie ausgeschlossener Inhalte.

CurationFeeVisibility

Die Sichtbarkeit der kombinierten Gebühr für das Kuratierungspaket und der Gebühren für das Datensegment (die Gesamtgebühr für die Kuratierung). Gebühren sind für den Ersteller des Pakets immer sichtbar.

Enums
CURATION_FEE_VISIBILITY_UNSPECIFIED Die Sichtbarkeit der Gesamtgebühr für die Auswahl ist nicht angegeben.
DISCLOSED Die Gesamtgebühr für die Kuratierung ist für alle Käufer sichtbar. Dies ist der Standardwert, wenn er nicht festgelegt ist.
NON_DISCLOSED Die Gesamtgebühr für die Kuratierung ist nicht für alle Käufer sichtbar.

Methoden

activate

Aktiviert ein vorhandenes kuratiertes Paket.

create

Erstellt ein neues kuratiertes Paket.

deactivate

Deaktiviert ein vorhandenes kuratiertes Paket.

get

Ruft ein kuratiertes Paket anhand seines Ressourcennamens ab.

list

Listet kuratierte Pakete auf, die dem angegebenen Kurator gehören.

patch

Aktualisiert ein vorhandenes kuratiertes Paket.