REST Resource: advertisers.creatives

Ressource: Creative

Ein einzelnes Creative.

JSON-Darstellung 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname des Creatives.
advertiserId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem das Creative gehört.
creativeId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Creatives. Vom System zugewiesen.
cmPlacementId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Campaign Manager 360-Placements, das mit dem Creative verknüpft ist. Dieses Feld gilt nur für Creatives, die aus Campaign Manager synchronisiert werden.
displayName

string

Erforderlich. Der Anzeigename des Creatives.

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

enum (EntityStatus)

Erforderlich. Steuert, ob das Creative ausgeliefert werden kann.

Zulässige Werte:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann das Creative zuletzt vom Nutzer oder vom System (z.B. im Rahmen der Creative-Überprüfung) aktualisiert wurde. Vom System zugewiesen.

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"
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für den Zeitpunkt, zu dem das Creative erstellt wurde. Vom System zugewiesen.

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"
creativeType

enum (CreativeType)

Erforderlich. Nicht veränderbar. Der Typ des Creatives.
hostingSource

enum (HostingSource)

Erforderlich. Gibt an, wo das Creative gehostet wird.
dynamic

boolean

Nur Ausgabe. Gibt an, ob das Creative dynamisch ist.
dimensions

object (Dimensions)

Erforderlich. Primäre Abmessungen des Creatives. Gilt für alle Creative-Typen. Der Wert von widthPixels und heightPixels ist standardmäßig 0, wenn creativeType einer der folgenden Werte ist:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Optional. Zusätzliche Dimensionen Gilt, wenn creativeType einer der folgenden Werte ist:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Wenn dieses Feld angegeben ist, sind sowohl widthPixels als auch heightPixels erforderlich und müssen größer oder gleich 0 sein.
mediaDuration

string (Duration format)

Nur Ausgabe. Die Media-Dauer des Creatives. Gilt, wenn creativeType einer der folgenden Werte ist:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Nur Ausgabe. Eine Liste der Attribute des Creatives, die vom System generiert wird.
reviewStatus

object (ReviewStatusInfo)

Nur Ausgabe. Der aktuelle Status des Überprüfungsprozesses für Creatives.
assets[]

object (AssetAssociation)

Erforderlich. Assets, die mit diesem Creative verknüpft sind.
exitEvents[]

object (ExitEvent)

Erforderlich. Exit-Ereignisse für dieses Creative. Ein Exit (auch als „Klick-Tag“ bezeichnet) ist ein Bereich in Ihrem Creative, auf den Nutzer klicken oder tippen können, um die Landingpage eines Werbetreibenden zu öffnen. Jedes Creative muss mindestens einen Exit enthalten. Sie haben folgende Möglichkeiten, Ihrem Creative einen Exit hinzuzufügen:

  • Verwenden Sie die Interaktionsfläche von Google Web Designer.
  • Definieren Sie eine JavaScript-Variable mit dem Namen „clickTag“.
  • Verwenden Sie den Enabler (Enabler.exit()), um Exits in Rich Media-Formaten zu erfassen.
timerEvents[]

object (TimerEvent)

Optional. Benutzerdefinierte Timer-Ereignisse für ein Rich Media-Creative. Mit Zeitmessungen wird die Zeit erfasst, in der ein Nutzer einen bestimmten Teil eines Rich Media-Creatives sieht und damit interagiert. Ein Creative kann mehrere Timerereignisse haben, die zeitlich getrennt erfasst werden. Lassen Sie das Feld leer oder legen Sie es nicht fest, wenn das Creative nur Bild-Assets enthält.
counterEvents[]

object (CounterEvent)

Optional. Zählerereignisse für ein Rich Media-Creative. Mit Zählern wird die Anzahl der Interaktionen eines Nutzers mit einem beliebigen Bereich eines Rich Media-Creatives auf bestimmte Weise erfasst (z. B. Mouseovers, Mouseouts, Klicks, Taps, Datenladevorgänge und Tastatureingaben). Alle Ereignisse, die sich im Creative erfassen lassen, können als Zähler aufgezeichnet werden. Lassen Sie das Feld leer oder legen Sie es nicht fest, wenn das Creative nur Bild-Assets enthält.
appendedTag

string

Optional. HTML-Tracking-Tag eines Drittanbieters, das an das Creative-Tag angehängt werden soll.
integrationCode

string

Optional. ID-Informationen, die verwendet werden, um dieses Creative mit einem externen System zu verknüpfen. Muss UTF‑8-codiert sein und darf maximal 10.000 Zeichen lang sein.
notes

string

Optional. Nutzeranmerkungen zu diesem Creative. Muss UTF‑8-codiert sein und darf nicht länger als 20.000 Zeichen sein.
iasCampaignMonitoring

boolean

Optional. Gibt an, ob das Kampagnen-Monitoring von Integral Ad Science (IAS) aktiviert ist. Damit das für das Creative möglich ist, muss Advertiser.creative_config.ias_client_id auf Ihre IAS-Client-ID festgelegt sein.
companionCreativeIds[]

string (int64 format)

Optional. Die IDs von Companion-Creatives für ein Video-Creative.

Sie können vorhandene Display-Creatives mit Bild- oder HTML5-Assets zuweisen, die neben dem Videoplayer des Publishers ausgeliefert werden. Companion-Anzeigen werden während der Videowiedergabe neben dem Videoplayer angezeigt und bleiben auch auf der Seite, nachdem das Video vollständig wiedergegeben wurde.

Creatives mit additional dimensions können keine Companion-Creatives sein.

Dieses Feld wird nur für die folgenden creativeType unterstützt:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Optional. Gibt an, ob der Nutzer ein Video-Creative überspringen kann.

Dieses Feld wird nur für die folgenden creativeType unterstützt:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Optional. Die Videodauer, nach der der Button „Überspringen“ angezeigt wird.

Dieses Feld ist erforderlich, wenn skippable „true“ ist.

Dieses Feld wird nur für die folgenden creativeType unterstützt:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Optional. Die Videodauer, nach der ein Aufruf gezählt wird.

Dieses Feld ist erforderlich, wenn skippable „true“ ist.

Dieses Feld wird nur für die folgenden creativeType unterstützt:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Optional. Eine optionale Creative-Kennung, die von einem Register bereitgestellt wird und auf allen Plattformen eindeutig ist.

Die universelle Anzeigen-ID ist Teil des VAST 4.0-Standards. Sie kann nach der Erstellung des Creatives geändert werden.

Dieses Feld wird nur für die folgenden creativeType unterstützt:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Optional. Tracking-URLs von Drittanbietern, um Interaktionen mit einem Video-Creative zu erfassen.

Dieses Feld wird nur für die folgenden creativeType unterstützt:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Nur Ausgabe. Audio-/Videotranscodierungen

In Display & Video 360 wird das Haupt-Asset in eine Reihe von alternativen Versionen transcodiert, die unterschiedliche Dateiformate oder Eigenschaften (Auflösung, Audio-Bitrate und Video-Bitrate) haben. Jede Version ist für bestimmte Videoplayer oder Bandbreiten vorgesehen.

Durch diese Transcodierungen hat das System des Publishers mehr Optionen für jede Impression in Ihrem Video. So wird dafür gesorgt, dass die richtige Datei basierend auf der Verbindung und Bildschirmgröße des Zuschauers ausgeliefert wird.

Dieses Feld wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Optional. Tracking-URLs für Anbieter von Analysen oder Drittanbieter von Anzeigentechnologie.

Die URLs müssen mit https: beginnen (außer bei Inventar, für das keine SSL-Konformität erforderlich ist). In der URL dürfen nur Makros verwendet werden, die von Display & Video 360 unterstützt werden.

Hier sind nur Standard-URLs zulässig, keine IMG- oder SCRIPT-Tags.

Dieses Feld kann nur in den folgenden creativeType geschrieben werden:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Optional. JavaScript-Mess-URL von unterstützten Drittanbietern für Überprüfungen (ComScore, DoubleVerify, IAS, Moat). HTML-Script-Tags werden nicht unterstützt.

Dieses Feld kann nur in den folgenden creativeType geschrieben werden:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Optional. Die Campaign Manager 360-Tracking-Anzeige, die mit dem Creative verknüpft ist.

Optional für die folgenden creativeType, wenn sie von einem Werbetreibenden erstellt werden, der sowohl Campaign Manager 360 als auch die Anzeigenbereitstellung durch Drittanbieter verwendet:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Nur Ausgabe für andere Fälle.
obaIcon

object (ObaIcon)

Optional. Gibt das OBA-Symbol für ein Video-Creative an.

Dieses Feld wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Optional. Das ursprüngliche Drittanbieter-Tag, das für das Creative verwendet wurde.

Erforderlich und nur für Creatives mit Drittanbieter-Tags gültig.

Creatives mit Drittanbieter-Tags sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Optional. Gibt an, dass für das Creative MRAID (Mobile Rich Media Ad Interface Definitions) erforderlich ist.

Legen Sie diese Option fest, wenn für das Creative typische Bewegungen für Mobilgeräte erforderlich sind, wie beispielsweise Wischen oder Tippen.

Optional und nur für Drittanbieter-Tag-Creatives gültig.

Creatives mit Drittanbieter-Tags sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Optional. Gibt an, dass HTML5 für die korrekte Darstellung des Creatives erforderlich ist.

Optional und nur für Drittanbieter-Tag-Creatives gültig. Creatives mit Drittanbieter-Tags sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Optional. Gibt an, dass das Creative auf einen Rückgabe-Ping für die Attribution wartet.

Nur gültig, wenn Sie eine Campaign Manager 360-Tracking-Anzeige mit einem Drittanbieter-Ad-Server-Parameter und dem Makro ${DC_DBM_TOKEN} verwenden.

Optional und nur für Drittanbieter-Tag-Creatives oder Drittanbieter-VAST-Tag-Creatives gültig.

Creatives mit Drittanbieter-Tags sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Creatives mit VAST-Tags von Drittanbietern sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Optional. Gibt die Richtung an, in die das Creative maximiert wird.

Erforderlich und nur für maximierbare Creatives von Drittanbietern gültig.

Expandable-Creatives von Drittanbietern sind Creatives mit der folgenden Hosting-Quelle:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Optional. Gibt an, dass das Creative automatisch maximiert wird, wenn der Mauszeiger darauf bewegt wird.

Optional und nur für maximierbare Drittanbieter-Creatives gültig. Expandable-Creatives von Drittanbietern sind Creatives mit der folgenden Hosting-Quelle:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Optional. Die URL des VAST-Tags für ein VAST-Tag-Creative von Drittanbietern.

Erforderlich und nur für Creatives mit VAST-Tags von Drittanbietern gültig.

Creatives mit VAST-Tags von Drittanbietern sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Nur Ausgabe. Gibt an, dass für das Creative des VAST-Tags von Drittanbietern VPAID (Digital Video Player-Ad Interface) erforderlich ist.

Nur Ausgabe und nur für Creatives mit VAST-Tags von Drittanbietern gültig.

Creatives mit VAST-Tags von Drittanbietern sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Nur Ausgabe. Gibt an, dass für das Drittanbieter-VAST-Tag-Creative die Unterstützung von HTML5-Video erforderlich ist.

Nur Ausgabe und nur gültig für Drittanbieter-VAST-Tag-Creatives.

Creatives mit VAST-Tags von Drittanbietern sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Nur Ausgabe. Die IDs der Werbebuchungen, mit denen dieses Creative verknüpft ist.

Verwenden Sie stattdessen LineItem.creative_ids, um ein Creative einer Werbebuchung zuzuordnen.
mp3Audio

boolean

Nur Ausgabe. Gibt an, dass das Audio-Creative des Drittanbieters MP3 unterstützt.

Nur Ausgabe und nur für Audio-Creatives von Drittanbietern gültig.

Drittanbieter-Audio-Creatives sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Nur Ausgabe. Gibt an, dass das Audio-Creative des Drittanbieters OGG unterstützt.

Nur Ausgabe und nur für Audio-Creatives von Drittanbietern gültig.

Drittanbieter-Audio-Creatives sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in Kombination mit den folgenden creativeType:

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

Optional. Gibt an, ob dem Creative ein Label als mit KI erstellt oder bearbeitet hinzugefügt werden soll, wenn es in Regionen mit lokalen KI-Kennzeichnungsvorschriften ausgeliefert wird.

HostingSource

Mögliche Hosting-Quellen für ein Creative. Gibt an, wo ein Creative erstellt und gehostet wird.

Enums
HOSTING_SOURCE_UNSPECIFIED Die Hostingquelle ist in dieser Version nicht angegeben oder unbekannt.
HOSTING_SOURCE_CM

Ein Creative, das aus Campaign Manager 360 synchronisiert wurde.

Die Methoden zum Erstellen und Aktualisieren werden für diesen Hostingtyp nicht unterstützt.
HOSTING_SOURCE_THIRD_PARTY

Ein Creative, das von einem Ad-Server eines Drittanbieters gehostet wird.

Die Methoden zum Erstellen und Aktualisieren werden für diesen Hostingtyp unterstützt, wenn creativeType eine der folgenden Optionen ist:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Ein in DV360 erstelltes und von Campaign Manager 360 gehostetes Creative.

Die Methoden zum Erstellen und Aktualisieren werden für diesen Hostingtyp unterstützt, wenn creativeType eine der folgenden Optionen ist:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Ein Rich Media-Creative, das in Studio erstellt und in Campaign Manager 360 gehostet wird.

Die Methoden zum Erstellen und Aktualisieren werden für diesen Hostingtyp nicht unterstützt.

CreativeAttribute

Mögliche Attribute eines Creatives.

Enums
CREATIVE_ATTRIBUTE_UNSPECIFIED Das Creative-Attribut ist in dieser Version nicht angegeben oder unbekannt.
CREATIVE_ATTRIBUTE_VAST Das Creative ist ein VAST-Creative.
CREATIVE_ATTRIBUTE_VPAID_LINEAR Das Creative ist ein lineares VPAID-Creative.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR Das Creative ist ein nicht lineares VPAID-Creative.

ReviewStatusInfo

Überprüfungsstatus für das Creative.

JSON-Darstellung 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
Felder
approvalStatus

enum (ApprovalStatus)

Stellt die grundlegende Genehmigung dar, die für die Auslieferung eines Creatives erforderlich ist. Zusammenfassung von creativeAndLandingPageReviewStatus und contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Der Überprüfungsstatus des Creatives und der Landingpage für das Creative.
contentAndPolicyReviewStatus

enum (ReviewStatus)

Status der Überprüfung von Inhalten und Richtlinien für das Creative.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Überprüfungsstatus des Creatives für die Anzeigenplattform.

Genehmigungsstatus

Mögliche Arten von Freigabestatus. Es ist die Zusammenfassung von creativeAndLandingPageReviewStatus und contentAndPolicyReviewStatus.

Enums
APPROVAL_STATUS_UNSPECIFIED Der Typwert ist in dieser Version nicht angegeben oder unbekannt.
APPROVAL_STATUS_PENDING_NOT_SERVABLE Das Creative wird noch überprüft und kann nicht ausgeliefert werden.
APPROVAL_STATUS_PENDING_SERVABLE Das Creative hat die Überprüfung von Creative und Landingpage bestanden und kann ausgeliefert werden. Es steht jedoch noch eine zusätzliche Überprüfung von Inhalten und Richtlinien aus.
APPROVAL_STATUS_APPROVED_SERVABLE Sowohl die Überprüfung von Creative und Landingpage als auch die Überprüfung von Inhalten und Richtlinien wurden genehmigt. Das Creative kann ausgeliefert werden.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Bevor das Creative ausgeliefert werden darf, muss ein Problem behoben werden.

ReviewStatus

Mögliche Arten von Überprüfungsstatus.

Enums
REVIEW_STATUS_UNSPECIFIED Der Typwert ist in dieser Version nicht angegeben oder unbekannt.
REVIEW_STATUS_APPROVED Das Creative wurde genehmigt.
REVIEW_STATUS_REJECTED Das Creative wird abgelehnt.
REVIEW_STATUS_PENDING Die Überprüfung des Creatives steht noch aus.

ExchangeReviewStatus

Überprüfungsstatus des Creatives für die Anzeigenplattform.

JSON-Darstellung 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Felder
exchange

enum (Exchange)

Die Anzeigenplattform, die das Creative überprüft.
status

enum (ReviewStatus)

Status der Überprüfung der Anzeigenplattform.

AssetAssociation

Asset-Zuweisung für das Creative.

JSON-Darstellung 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Felder
asset

object (Asset)

Optional. Das zugehörige Asset.
role

enum (AssetRole)

Optional. Die Rolle dieses Assets für das Creative.

Asset

Ein einzelnes Asset.

JSON-Darstellung 
{
  "mediaId": string,
  "content": string
}
Felder
mediaId

string (int64 format)

Media-ID des hochgeladenen Assets. Dies ist eine eindeutige Kennung für das Asset. Diese ID kann an andere API-Aufrufe übergeben werden, z.B. an creatives.create, um das Asset einem Creative zuzuordnen.

Der Media-ID-Bereich wurde am 5. April 2023 aktualisiert. Aktualisieren Sie Media-IDs, die vor dem 5. April 2023 im Cache gespeichert wurden, indem Sie die neue Media-ID aus den zugehörigen verknüpften Creatives abrufen oder das Asset noch einmal hochladen.
content

string

Der Inhalt des Assets. Bei hochgeladenen Assets ist der Inhalt der Bereitstellungspfad.

AssetRole

Die Rolle dieses Assets für das Creative.

Enums
ASSET_ROLE_UNSPECIFIED Die Asset-Rolle ist in dieser Version nicht angegeben oder unbekannt.
ASSET_ROLE_MAIN Das Asset ist das Haupt-Asset des Creatives.
ASSET_ROLE_BACKUP Das Asset ist ein Reserve-Asset des Creatives.
ASSET_ROLE_POLITE_LOAD Das Asset ist ein Polite Load-Asset des Creatives.
ASSET_ROLE_HEADLINE

Der Anzeigentitel eines nativen Creatives.

content muss UTF-8-codiert sein und darf maximal 25 Zeichen lang sein.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Langer Anzeigentitel eines nativen Creatives.

Die content muss UTF‑8-codiert sein und darf maximal 50 Zeichen lang sein.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Text eines nativen Creatives.

Der content muss UTF-8-codiert sein und darf maximal 90 Zeichen lang sein.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Langer Anzeigentext eines nativen Creatives.

Der content muss UTF-8-codiert sein und darf maximal 150 Zeichen lang sein.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Eine kurze, optimierte Version der Landingpage-URL, die im Creative angezeigt wird. Anhand dieser URL können Nutzer erkennen, wohin sie weitergeleitet werden, wenn sie auf das Creative klicken.

Der content muss UTF‑8-codiert sein und darf maximal 30 Zeichen lang sein.

Wenn die Landingpage-URL beispielsweise „http://www.beispiel.de/seite“ lautet, kann die Untertitel-URL „beispiel.de“ sein. Das Protokoll (http://) ist optional, die URL darf aber keine Leerzeichen oder Sonderzeichen enthalten.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Der Text, der auf dem Call-to-Action-Button eines nativen Creatives verwendet werden soll.

content muss UTF-8-codiert sein und darf maximal 15 Zeichen lang sein.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Der Text, mit dem der Name des Werbetreibenden oder der Marke angegeben wird.

content muss UTF-8-codiert sein und darf maximal 25 Zeichen lang sein.

Diese Rolle wird nur in den folgenden creativeType unterstützt:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Der Kaufpreis Ihrer App im Google Play Store oder iOS App Store (z. B. 5, 99 €).

Hinweis: Dieser Wert wird nicht automatisch mit dem tatsächlichen Wert im Geschäft synchronisiert. Es ist immer das, das beim Speichern des Creatives angegeben wurde.

content muss UTF-8-codiert sein und darf maximal 15 Zeichen lang sein.

Assets dieser Rolle sind schreibgeschützt.
ASSET_ROLE_ANDROID_APP_ID

Die ID einer Android-App im Google Play Store.

Sie finden diese ID in der Google Play Store-URL der App nach „id“. Im Beispiel https://play.google.com/store/apps/details?id=com.company.appname ist die Kennung „com.company.appname“.

Assets dieser Rolle sind schreibgeschützt.
ASSET_ROLE_IOS_APP_ID

Die ID einer iOS-App im Apple App Store.

Diese ID-Nummer finden Sie in der Apple App Store-URL als die Zahlenfolge direkt nach „id“. In https://apps.apple.com/us/app/gmail-email-by-google/id422689480 lautet die ID beispielsweise 422689480.

Assets dieser Rolle sind schreibgeschützt.
ASSET_ROLE_RATING

Die Bewertung einer App im Google Play Store oder im iOS App Store.

Dieser Wert wird nicht automatisch mit der tatsächlichen Bewertung im Store synchronisiert. Es ist immer das, das beim Speichern des Creatives angegeben wurde.

Assets dieser Rolle sind schreibgeschützt.
ASSET_ROLE_ICON

Das Symbol eines Creatives.

Diese Rolle wird nur in den folgenden creativeType unterstützt und ist dort erforderlich:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Das Titelbild einer nativen Videoanzeige.

Diese Rolle wird nur in den folgenden creativeType unterstützt und ist dort erforderlich:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Die Hauptfarbe, die in einem Creative verwendet werden soll.

Diese Rolle wird nur in den folgenden creativeType unterstützt und ist dort erforderlich:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Die Akzentfarbe, die in einem Creative verwendet werden soll.

Diese Rolle wird nur in den folgenden creativeType unterstützt und ist dort erforderlich:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Gibt an, ob für das Creative ein Bild-Asset verwendet werden muss.

Diese Rolle wird nur in den folgenden creativeType unterstützt und ist dort erforderlich:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Gibt an, ob Asset-Optimierungen auf das Creative angewendet werden können.

Diese Rolle wird nur in den folgenden creativeType unterstützt und ist dort erforderlich:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Exit-Ereignis des Creatives.

JSON-Darstellung 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Felder
type

enum (ExitEventType)

Erforderlich. Die Art des Exit-Ereignisses.
url

string

Erforderlich. Die Klick-URL des Exit-Ereignisses. Dies ist erforderlich, wenn type Folgendes ist:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Optional. Der Name des Klick-Tags des Exit-Ereignisses.

Der Name darf innerhalb eines Creatives nur einmal vorkommen.

Lassen Sie das Feld leer oder legen Sie es nicht fest, wenn das Creative nur Bild-Assets enthält.
reportingName

string

Optional. Der Name, mit dem dieses Ereignis in Berichten identifiziert wird. Lassen Sie das Feld leer oder legen Sie es nicht fest, wenn das Creative nur Bild-Assets enthält.

ExitEventType

Der Typ eines Exit-Ereignisses.

Enums
EXIT_EVENT_TYPE_UNSPECIFIED Der Ereignistyp für den Ausstieg ist in dieser Version nicht angegeben oder unbekannt.
EXIT_EVENT_TYPE_DEFAULT Das Exit-Ereignis ist das Standardereignis.
EXIT_EVENT_TYPE_BACKUP Das Exit-Ereignis ist ein Reserve-Exit-Ereignis. Ein Creative kann mehrere Backup-Exit-Ereignisse enthalten.

TimerEvent

Timer-Ereignis des Creatives.

JSON-Darstellung 
{
  "name": string,
  "reportingName": string
}
Felder
name

string

Erforderlich. Der Name des Timer-Ereignisses.
reportingName

string

Erforderlich. Der Name, mit dem dieses Zeitgeberereignis in Berichten identifiziert wird.

CounterEvent

Zählerereignis des Creatives.

JSON-Darstellung 
{
  "name": string,
  "reportingName": string
}
Felder
name

string

Erforderlich. Der Name des Zählerereignisses.
reportingName

string

Erforderlich. Der Name, mit dem dieses Zählerereignis in Berichten identifiziert wird.

AudioVideoOffset

Die Länge, die ein Audio oder Video wiedergegeben wurde.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
Felder
Der Wert des Offsets. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
percentage

string (int64 format)

Optional. Der Versatz in Prozent der Audio- oder Videolänge.
seconds

string (int64 format)

Optional. Der Versatz in Sekunden ab dem Beginn des Audio- oder Videoinhalts.
Ende der sich gegenseitig ausschließenden Felder.

UniversalAdId

Eine Creative-Kennung, die von einem Register bereitgestellt wird und plattformübergreifend eindeutig ist. Dies ist Teil des VAST 4.0-Standards.

JSON-Darstellung 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Felder
id

string

Optional. Die eindeutige Creative-Kennung.
registry

enum (UniversalAdRegistry)

Optional. Die Registry stellt eindeutige Creative-IDs bereit.

UniversalAdRegistry

Die Registry stellt eindeutige Creative-Kennungen in einer universellen Anzeigen-ID bereit.

Enums
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Die Universal Ad Registry ist in dieser Version nicht angegeben oder unbekannt.
UNIVERSAL_AD_REGISTRY_OTHER Verwenden Sie einen benutzerdefinierten Anbieter, um die universelle Anzeigen-ID bereitzustellen.
UNIVERSAL_AD_REGISTRY_AD_ID Verwenden Sie Ad-ID, um die universelle Anzeigen-ID anzugeben.
UNIVERSAL_AD_REGISTRY_CLEARCAST Verwenden Sie clearcast.co.uk, um die universelle Anzeigen-ID anzugeben.
UNIVERSAL_AD_REGISTRY_DV360 Verwenden Sie Display & Video 360, um die Universelle Anzeigen-ID anzugeben.
UNIVERSAL_AD_REGISTRY_CM Verwenden Sie Campaign Manager 360, um die Universelle Anzeigen-ID anzugeben.

ThirdPartyUrl

Tracking-URLs von Drittanbietern, um Interaktionen mit einem Audio- oder Video-Creative zu erfassen.

JSON-Darstellung 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Felder
type

enum (ThirdPartyUrlType)

Optional. Der Interaktionstyp muss über die Tracking-URL erfasst werden.
url

string

Optional. Tracking-URL, mit der die Interaktion erfasst wird.

Geben Sie eine URL mit optionalem Pfad oder optionalem Abfragestring an, die mit https: beginnt. z. B. https://www.example.com/path.

ThirdPartyUrlType

Der Interaktionstyp muss von der Drittanbieter-Tracking-URL erfasst werden.

Enums
THIRD_PARTY_URL_TYPE_UNSPECIFIED Der Typ der Drittanbieter-URL ist nicht angegeben oder in dieser Version unbekannt.
THIRD_PARTY_URL_TYPE_IMPRESSION Wird verwendet, um Impressionen des Creatives zu zählen, nachdem das Audio oder Video vollständig gepuffert wurde.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Wird verwendet, um Nutzerklicks auf das Audio oder Video zu erfassen.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Wird verwendet, um zu erfassen, wie oft ein Nutzer die Audio- oder Videowiedergabe startet.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Wird verwendet, um zu erfassen, wie oft das Audio oder Video bis zu 25% seiner Länge wiedergegeben wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Wird verwendet, um zu erfassen, wie oft der Audio- oder Videoinhalt bis zu 50% seiner Länge abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Wird verwendet, um zu erfassen, wie oft der Audio- oder Videoinhalt bis zu 75% seiner Länge abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Wird verwendet, um zu erfassen, wie oft der Audio- oder Videoinhalt bis zum Ende abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Wird verwendet, um zu erfassen, wie oft ein Nutzer Audio oder Video stummschaltet.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Wird verwendet, um zu erfassen, wie oft ein Nutzer die Audio- oder Videowiedergabe pausiert.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Wird verwendet, um zu erfassen, wie oft ein Nutzer das Audio oder Video noch einmal abspielt.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Wird verwendet, um zu erfassen, wie oft der Player von einem Nutzer im Vollbildmodus aufgerufen wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Wird verwendet, um zu erfassen, wie oft ein Nutzer die Audio- oder Videowiedergabe beendet.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Wird verwendet, um die Häufigkeit zu erfassen, mit der ein Nutzer einen benutzerdefinierten Klick ausführt, z. B. auf einen Videohotspot.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Wird verwendet, um zu erfassen, wie oft das Audio oder Video übersprungen wurde.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Wird verwendet, um die Häufigkeit zu erfassen, mit der der Audio- oder Videoinhalt bis zu einem durch progressOffset bestimmten Offset wiedergegeben wird.

Transcodieren

Stellt Informationen zur transcodierten Audio- oder Videodatei dar.

JSON-Darstellung 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Felder
name

string

Optional. Der Name der transcodierten Datei.
mimeType

string

Optional. Der MIME-Typ der transcodierten Datei.
transcoded

boolean

Optional. Gibt an, ob die Transcodierung erfolgreich war.
dimensions

object (Dimensions)

Optional. Die Abmessungen des transcodierten Videos.
bitRateKbps

string (int64 format)

Optional. Die Transcodierungsbitrate des transcodierten Videos in Kilobit pro Sekunde.
frameRate

number

Optional. Die Framerate des transcodierten Videos in Bildern pro Sekunde.
audioBitRateKbps

string (int64 format)

Optional. Die Bitrate für den Audiostream des transcodierten Videos oder die Bitrate für den transcodierten Audioinhalt in Kilobit pro Sekunde.
audioSampleRateHz

string (int64 format)

Optional. Die Abtastrate für den Audiostream des transcodierten Videos oder die Abtastrate für das transcodierte Audio in Hertz.
fileSizeBytes

string (int64 format)

Optional. Die Größe der transcodierten Datei in Byte.

CmTrackingAd

Eine Campaign Manager 360-Tracking-Anzeige.

JSON-Darstellung 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Felder
cmPlacementId

string (int64 format)

Optional. Die Placement-ID der Campaign Manager 360-Tracking-Anzeige.
cmCreativeId

string (int64 format)

Optional. Die Creative-ID der Campaign Manager 360-Tracking-Anzeige.
cmAdId

string (int64 format)

Optional. Die Anzeigen-ID der Campaign Manager 360-Tracking-Anzeige.

ObaIcon

OBA-Symbol für ein Creative

JSON-Darstellung 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Felder
resourceUrl

string

Optional. Die URL der OBA-Symbolressource.
resourceMimeType

string

Optional. Der MIME-Typ der OBA-Symbolressource.
position

enum (ObaIconPosition)

Optional. Die Position des OBA-Symbols im Creative.
dimensions

object (Dimensions)

Optional. Die Abmessungen des OBA-Symbols.
program

string

Optional. Das Programm des OBA-Symbols. Beispiel: „AdChoices“
landingPageUrl

string

Erforderlich. Die Landingpage-URL des OBA-Symbols.

Es sind nur URLs der folgenden Domains zulässig:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

Erforderlich. Die Klick-Tracking-URL des OBA-Symbols.

Es sind nur URLs der folgenden Domains zulässig:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

Erforderlich. Die Ansicht-Tracking-URL des OBA-Symbols.

Es sind nur URLs der folgenden Domains zulässig:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

Die Position des OBA-Symbols im Creative.

Enums
OBA_ICON_POSITION_UNSPECIFIED Die Position des OBA-Symbols ist nicht angegeben.
OBA_ICON_POSITION_UPPER_RIGHT Rechts oben im Creative.
OBA_ICON_POSITION_UPPER_LEFT Links oben im Creative.
OBA_ICON_POSITION_LOWER_RIGHT Rechts unten im Creative.
OBA_ICON_POSITION_LOWER_LEFT Unten links im Creative.

ExpandingDirection

Die Maximierungsrichtung des Expandable-Creatives des Drittanbieters.

Enums
EXPANDING_DIRECTION_UNSPECIFIED Die Richtung der Erweiterung ist nicht angegeben.
EXPANDING_DIRECTION_NONE Wird in keiner Richtung erweitert.
EXPANDING_DIRECTION_UP Wird nach oben erweitert.
EXPANDING_DIRECTION_DOWN Wird nach unten erweitert.
EXPANDING_DIRECTION_LEFT Wird nach links erweitert.
EXPANDING_DIRECTION_RIGHT Wird nach rechts maximiert.
EXPANDING_DIRECTION_UP_AND_LEFT Wird nach oben und links erweitert.
EXPANDING_DIRECTION_UP_AND_RIGHT Wird nach oben und rechts maximiert.
EXPANDING_DIRECTION_DOWN_AND_LEFT Wird nach unten und links erweitert.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Wird nach unten und rechts erweitert.
EXPANDING_DIRECTION_UP_OR_DOWN Wird entweder nach oben oder nach unten erweitert.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Wird entweder auf der linken oder auf der rechten Seite maximiert.
EXPANDING_DIRECTION_ANY_DIAGONAL Kann in jede diagonale Richtung erweitert werden.

Methoden

create

 Erstellt ein neues Creative.

delete

 Löscht ein Creative.

get

 Ruft ein Creative ab.

list

 Listet Creatives in einem Werbetreibenden auf.

patch

 Aktualisiert ein vorhandenes Creative.