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
}
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 mit dem Creative verknüpften Campaign Manager 360-Placements. 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 sind:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Nur Ausgabe Zeitstempel für die letzte Aktualisierung des Creatives durch den Nutzer oder das System (z. B. Creative-Überprüfung) Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel, zu dem das Creative erstellt wurde. Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
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. Die primären 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)

Zusätzliche Dimensionen. Anwendbar, wenn creativeType einen der folgenden Werte hat:

  • 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 wird, sind widthPixels und heightPixels beide erforderlich und müssen größer oder gleich 0 sein.
mediaDuration

string (Duration format)

Nur Ausgabe Mediendauer des Creatives Anwendbar, wenn creativeType einen der folgenden Werte hat:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Nur Ausgabe Eine vom System generierte Liste der Attribute des Creatives.
reviewStatus

object (ReviewStatusInfo)

Nur Ausgabe Der aktuelle Status des Creative-Überprüfungsprozesses.
assets[]

object (AssetAssociation)

Erforderlich. Mit diesem Creative verknüpfte Assets.
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 ein Nutzer klicken oder tippen kann, um die Landingpage eines Werbetreibenden zu öffnen. Jedes Creative muss mindestens einen Exit enthalten. Sie haben folgende Möglichkeiten, einen Exit zu Ihrem Creative hinzuzufügen:

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

object (TimerEvent)

Benutzerdefinierte Timer-Ereignisse für ein Rich Media-Creative Timer erfassen die Zeit, während der ein Nutzer einen bestimmten Teil eines Rich Media-Creatives ansieht und damit interagiert. Ein Creative kann über mehrere Timer-Ereignisse verfügen, die zeitlich getrennt erfasst werden. Lassen Sie das Feld leer oder legen Sie keine Einstellung für Creatives fest, die nur Bild-Assets enthalten.
counterEvents[]

object (CounterEvent)

Zählerereignisse für ein Rich Media-Creative Mit Zählern wird erfasst, wie oft ein Nutzer auf eine bestimmte Art und Weise mit einem beliebigen Teil eines Rich Media-Creatives interagiert (z. B. Mouse-Overs, Mouse-Outs, Klicks, Tippen, Laden von Daten oder Tastatureingaben). Jedes Ereignis, das im Creative erfasst werden kann, kann als Zähler aufgezeichnet werden. Lassen Sie das Feld leer oder legen Sie keine Einstellung für Creatives fest, die nur Bild-Assets enthalten.
appendedTag

string

Das HTML-Tracking-Tag eines Drittanbieters, das an das Creative-Tag angehängt wird.
integrationCode

string

ID-Informationen, die verwendet werden, um dieses Creative mit einem externen System zu verknüpfen. Er muss UTF-8-codiert sein und darf höchstens 10.000 Zeichen lang sein.
notes

string

Nutzerhinweise für dieses Creative. Er muss UTF-8-codiert sein und darf höchstens 20.000 Zeichen lang sein.
iasCampaignMonitoring

boolean

Gibt an, ob die Kampagnenüberwachung von Integral Ad Science (IAS) aktiviert ist. Um diese Funktion für das Creative zu aktivieren, muss Advertiser.creative_config.ias_client_id auf Ihre IAS-Client-ID gesetzt sein.
companionCreativeIds[]

string (int64 format)

Die IDs der 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 sollen. Companions werden um den Videoplayer herum angezeigt, während das Video abgespielt wird, und bleiben auf der Seite, nachdem das Video vollständig wiedergegeben wurde.

Creatives mit dem Inhalt „additional dimensions“ können keine Companion-Creatives sein.

Dieses Feld wird nur für folgende creativeType unterstützt:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

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)

Zeit, die das Video wiedergegeben wird, bevor die Schaltfläche „Ü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)

Die Zeit, die das Video wiedergegeben wird, bevor 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 von einer Registry bereitgestellte optionale Creative-ID, die auf allen Plattformen eindeutig ist.

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

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

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

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:

Das Haupt-Asset wird in Display & Video 360 in mehrere Versionen transcodiert, die unterschiedliche Dateiformate und Eigenschaften wie Auflösung, Audiobitrate und Videobitrate haben. Diese sind jeweils für bestimmte Videoplayer oder Bandbreiten vorgesehen.

Durch diese Transcodierungen stehen dem System des Publishers mehr Optionen für die einzelnen Impressionen Ihres Videos zur Auswahl. Außerdem wird sichergestellt, dass die entsprechende Datei basierend auf der Verbindung und der Bildschirmgröße des Betrachters ausgeliefert wird.

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

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Tracking-URLs für Analyseanbieter oder Anzeigentechnologie-Drittanbieter

Die URLs müssen mit https beginnen. Eine Ausnahme gilt für Inventar, das keine SSL-Konformität erfordert. In der URL dürfen nur Makros verwendet werden, die von Display & Video 360 unterstützt werden.

Nur Standard-URLs, keine IMG- oder Script-Tags.

Dieses Feld kann nur in folgenden creativeType geschrieben werden:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

JavaScript-Mess-URL von unterstützten Drittanbietern (ComScore, DoubleVerify, IAS, Moat) HTML-Script-Tags werden nicht unterstützt.

Dieses Feld kann nur in folgenden creativeType geschrieben werden:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Die mit dem Creative verknüpfte Campaign Manager 360-Tracking-Anzeige.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Ausgabe nur für andere Fälle.
obaIcon

object (ObaIcon)

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 Drittanbieter-Tag-Creatives gültig.

Drittanbieter-Tag-Creatives sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

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

Legen Sie diesen Wert fest, wenn für das Creative Gesten für Mobilgeräte erforderlich sind, wie Wischen oder Tippen.

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

Drittanbieter-Tag-Creatives sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

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

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

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

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

Nur gültig, wenn eine Campaign Manager 360-Tracking-Anzeige mit einem Parameter für den Ad-Server eines Drittanbieters und dem Makro ${DC_DBM_TOKEN} verwendet wird.

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

Drittanbieter-Tag-Creatives sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

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

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Optional. Gibt die Maximierungsrichtung des Creatives an.

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

Expandable-Creatives von Drittanbietern sind Creatives, die über die folgende Hostingquelle gehostet werden:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Optional. Gibt an, dass das Creative automatisch maximiert wird, wenn der Mauszeiger auf die Anzeige bewegt wird

Optional und nur für erweiterbare Anzeigen von Drittanbietern gültig. Expandable-Creatives von Drittanbietern sind Creatives, die über die folgende Hostingquelle gehostet werden:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Optional. URL des VAST-Tags für ein Drittanbieter-VAST-Tag-Creative

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

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

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Nur Ausgabe Gibt an, dass für das VAST-Tag-Creative eines Drittanbieters HTML5-Video unterstützt werden muss.

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

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

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

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

Wenn Sie ein Creative mit einer Werbebuchung verknüpfen möchten, verwenden Sie stattdessen „LineItem.creative_ids“.
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.

Audio-Creatives von Drittanbietern sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit 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.

Audio-Creatives von Drittanbietern sind Creatives mit folgenden hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

kombiniert mit folgenden creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

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

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

Ein Creative, das aus Campaign Manager 360 synchronisiert wurde

Erstellungs- und Aktualisierungsmethoden werden für diesen Hostingtyp nicht unterstützt.
HOSTING_SOURCE_THIRD_PARTY

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

Erstellungs- und Aktualisierungsmethoden werden für diesen Hostingtyp unterstützt, wenn creativeType einer der folgenden Werte 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.

Erstellungs- und Aktualisierungsmethoden werden für diesen Hostingtyp unterstützt, wenn creativeType einer der folgenden Werte 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 von Campaign Manager 360 gehostet wird.

Erstellungs- und Aktualisierungsmethoden werden für diesen Hostingtyp nicht unterstützt.

CreativeAttribute

Mögliche Attribute eines Creatives.

Enums
CREATIVE_ATTRIBUTE_UNSPECIFIED Das Creative-Attribut ist nicht angegeben oder in dieser Version 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üfen Sie die Status für das Creative.

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

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

Status der Inhalts- und Richtlinienüberprüfung für das Creative.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Anzeigenplattform-Überprüfungsstatus für das Creative.
publisherReviewStatuses[]

object (PublisherReviewStatus)

Überprüfungsstatus des Publishers durch den Publisher

ApprovalStatus

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

Enums
APPROVAL_STATUS_UNSPECIFIED Der Typwert ist nicht angegeben oder in dieser Version 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 des Creatives und der Landingpage bestanden und kann ausgeliefert werden, muss aber noch eine zusätzliche Inhalts- und Richtlinienüberprüfung durchlaufen.
APPROVAL_STATUS_APPROVED_SERVABLE Sowohl die Creative- und Landingpage-Überprüfung als auch die Content- und Richtlinienüberprüfung sind genehmigt. Das Creative kann ausgeliefert werden.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Es gibt ein Problem mit dem Creative, das behoben werden muss, bevor es ausgeliefert werden kann.

ReviewStatus

Mögliche Arten von Überprüfungsstatus.

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

ExchangeReviewStatus

Überprüfungsstatus der Anzeigenplattform für das Creative.

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 durch Anzeigenplattform.

PublisherReviewStatus

Der Überprüfungsstatus des Creatives durch den Publisher.

JSON-Darstellung 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
Felder
publisherName

string

Der Publisher, der das Creative überprüft
status

enum (ReviewStatus)

Status der Überprüfung durch den Publisher.

AssetAssociation

Asset-Verknüpfung für das Creative.

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

object (Asset)

Das verknüpfte Asset.
role

enum (AssetRole)

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 weitergegeben werden, z.B. creatives.create, um das Asset mit einem Creative zu verknüpfen.

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

string

Der Asset-Inhalt. Bei hochgeladenen Assets ist der Inhalt der Pfad für die Auslieferung.

AssetRole

Die Rolle dieses Assets für das Creative.

Enums
ASSET_ROLE_UNSPECIFIED Die Asset-Rolle ist nicht angegeben oder in dieser Version unbekannt.
ASSET_ROLE_MAIN Das Asset ist das wichtigste Asset des Creatives.
ASSET_ROLE_BACKUP Das Asset ist ein Reserveasset 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 nicht mehr als 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

content muss UTF-8-codiert sein und darf nicht mehr als 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

content muss UTF-8-codiert sein und darf nicht mehr als 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

content muss UTF-8-codiert sein und darf nicht mehr als 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, nutzerfreundliche Version der Landingpage-URL, die im Creative erscheint. Diese URL vermittelt Nutzern eine Vorstellung davon, wohin sie weitergeleitet werden, wenn sie auf das Creative klicken.

content muss UTF-8-codiert sein und darf nicht mehr als 30 Zeichen lang sein.

Lautet die Landingpage-URL beispielsweise „http://www.beispiel.de/seite“, kann die Untertitel-URL „beispiel.de“ lauten. Die Angabe des Protokolls (http://) ist optional, aber die URL darf 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

Das ist der Text, der auf der Call-to-Action-Schaltfläche eines nativen Creatives verwendet werden soll.

content muss UTF-8-codiert sein und darf nicht mehr als 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 zur Identifizierung des Werbetreibenden- oder Markennamens.

content muss UTF-8-codiert sein und darf nicht mehr als 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 synchronisiert, der im Store angezeigt wird. Es ist immer diejenige, die beim Speichern des Creatives angegeben wird.

content muss UTF-8-codiert sein und darf nicht mehr als 15 Zeichen lang sein.

Assets mit 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“. In https://play.google.com/store/apps/details?id=com.company.appname lautet sie beispielsweise „com.company.appname“.

Assets mit dieser Rolle sind schreibgeschützt.
ASSET_ROLE_IOS_APP_ID

Die ID einer iOS-App im Apple App Store.

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

Assets mit dieser Rolle sind schreibgeschützt.
ASSET_ROLE_RATING

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

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

Assets mit dieser Rolle sind schreibgeschützt.
ASSET_ROLE_ICON

Das Symbol eines Creatives.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Das Titelbild eines nativen Video-Creatives.

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

  • CREATIVE_TYPE_VIDEO

ExitEvent

Exit-Ereignis des Creatives.

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

enum (ExitEventType)

Erforderlich. Der Typ 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

Name des Klick-Tags des Exit-Ereignisses

Der Name muss innerhalb eines Creatives eindeutig sein.

Lassen Sie das Feld leer oder legen Sie keine Einstellung für Creatives fest, die nur Bild-Assets enthalten.
reportingName

string

Der Name, mit dem dieses Ereignis in Berichten identifiziert wird. Lassen Sie das Feld leer oder legen Sie keine Einstellung für Creatives fest, die nur Bild-Assets enthalten.

ExitEventType

Der Typ eines Exit-Ereignisses.

Enums
EXIT_EVENT_TYPE_UNSPECIFIED Der Exit-Ereignistyp ist nicht angegeben oder in dieser Version unbekannt.
EXIT_EVENT_TYPE_DEFAULT Das Exit-Ereignis ist das Standardereignis.
EXIT_EVENT_TYPE_BACKUP Das Exit-Ereignis ist ein Backup-Exit-Ereignis. Ein Creative kann mehrere Reserve-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 Timer-Ereignis 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

Gibt an, wie lange ein Audio- oder Videomaterial abgespielt wurde.

JSON-Darstellung 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Felder
Union-Feld offset. Der Wert des Versatzes. Für offset ist nur einer der folgenden Werte zulässig:
percentage

string (int64 format)

Der Offset in Prozent der Audio- oder Videodauer.
seconds

string (int64 format)

Der Abstand in Sekunden vom Beginn der Audio- oder Videowiedergabe.

UniversalAdId

Eine von einer Registry bereitgestellte Creative-ID, die auf allen Plattformen eindeutig ist. Das ist Teil des VAST 4.0-Standards.

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

string

Die eindeutige Creative-ID.
registry

enum (UniversalAdRegistry)

Die Registry stellt eindeutige Creative-IDs bereit.

UniversalAdRegistry

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

Enums
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Die Registry für universelle Anzeigen ist in dieser Version nicht angegeben oder unbekannt.
UNIVERSAL_AD_REGISTRY_OTHER Verwenden Sie einen benutzerdefinierten Anbieter, um die universelle Anzeigen-ID anzugeben.
UNIVERSAL_AD_REGISTRY_AD_ID Verwenden Sie die Anzeigen-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)

Die Art der Interaktion muss über die Tracking-URL erfasst werden.
url

string

Tracking-URL, die zum Erfassen der Interaktion verwendet wird.

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

ThirdPartyUrlType

Die Art der Interaktion muss über die 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 nach vollständiger Audio- oder Video-Pufferung zu zählen.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Wird verwendet, um Nutzerklicks auf die Audio- oder Videoinhalte zu verfolgen.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer die Audio- oder Videowiedergabe startet.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Mit dieser Option wird die Häufigkeit verfolgt, mit der das Audio oder Video bis zu 25% seiner Länge abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Mit dieser Option wird nachverfolgt, wie häufig das Audio oder Video bis zu 50% seiner Länge abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Mit dieser Option wird die Häufigkeit verfolgt, mit der das Audio oder Video bis zu 75% seiner Länge abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Mit dieser Option wird die Häufigkeit verfolgt, mit der das Audio oder Video bis zum Ende abgespielt wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer den Ton oder das Video stummschaltet.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer das Audio oder Video pausiert.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer die Audio- oder Videowiedergabe wiederholt.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Mit dieser Option wird erfasst, wie oft der Player von einem Nutzer im Vollbildmodus aufgerufen wird.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer das Audio oder Video anhält.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer einen benutzerdefinierten Klick ausführt, also z. B. auf einen Videohotspot klickt.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Mit dieser Option wird nachverfolgt, wie häufig das Audio- oder Videomaterial übersprungen wurde.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Mit dieser Option wird die Häufigkeit verfolgt, mit der das Audio oder Video bis zu einem durch progressOffset festgelegten Offset wiedergegeben wird.

Transcodieren

Informationen zur transcodierten Audio- oder Videodatei.

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

string

Der Name der transcodierten Datei.
mimeType

string

Der MIME-Typ der transcodierten Datei.
transcoded

boolean

Gibt an, ob die Transcodierung erfolgreich war.
dimensions

object (Dimensions)

Die Abmessungen des transcodierten Videos.
bitRateKbps

string (int64 format)

Die Transcodierungs-Bitrate des transcodierten Videos in Kilobit pro Sekunde.
frameRate

number

Die Framerate des transcodierten Videos in Bildern pro Sekunde.
audioBitRateKbps

string (int64 format)

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

string (int64 format)

Die Abtastrate für den Audiostream des transcodierten Videos oder die Abtastrate für die transcodierten Audioinhalte in Hertz.
fileSizeBytes

string (int64 format)

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)

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

string (int64 format)

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

string (int64 format)

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

Die URL der OBA-Symbolressource.
resourceMimeType

string

Der MIME-Typ der OBA-Symbolressource.
position

enum (ObaIconPosition)

Die Position des OBA-Symbols im Creative.
dimensions

object (Dimensions)

Die Abmessungen des OBA-Symbols
program

string

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

string

Erforderlich. Die Landingpage-URL des OBA-Symbols.

Nur URLs der folgenden Domains sind zulässig:
clickTrackingUrl

string

Erforderlich. Klick-Tracking-URL des OBA-Symbols

Nur URLs der folgenden Domains sind zulässig:
viewTrackingUrl

string

Erforderlich. Ansicht-Tracking-URL des OBA-Symbols

Nur URLs der folgenden Domains sind zulässig:

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 Oben rechts im Creative
OBA_ICON_POSITION_UPPER_LEFT Oben links im Creative.
OBA_ICON_POSITION_LOWER_RIGHT Unten rechts im Creative
OBA_ICON_POSITION_LOWER_LEFT Unten links im Creative

ExpandingDirection

Das ist die Maximierungsrichtung des Expandable-Creatives von Drittanbietern.

Enums
EXPANDING_DIRECTION_UNSPECIFIED Die Maximierungsrichtung ist nicht angegeben.
EXPANDING_DIRECTION_NONE Es wird in keine Richtung maximiert.
EXPANDING_DIRECTION_UP Wird nach oben erweitert.
EXPANDING_DIRECTION_DOWN Wird nach unten erweitert.
EXPANDING_DIRECTION_LEFT Wird nach links maximiert.
EXPANDING_DIRECTION_RIGHT Wird nach rechts erweitert.
EXPANDING_DIRECTION_UP_AND_LEFT Wird nach oben und zur linken Seite erweitert
EXPANDING_DIRECTION_UP_AND_RIGHT Wird nach oben und zur rechten Seite erweitert.
EXPANDING_DIRECTION_DOWN_AND_LEFT Wird nach unten und zur linken Seite erweitert.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Wird nach unten und zur rechten Seite erweitert.
EXPANDING_DIRECTION_UP_OR_DOWN Wird nach oben oder unten erweitert.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Wird entweder in die linke oder die rechte Seite erweitert.
EXPANDING_DIRECTION_ANY_DIAGONAL Eine Maximierung in jede diagonale Richtung ist möglich.

Methoden

create

 Erstellt ein neues Creative.

delete

 Löscht ein Creative.

get

 Ruft ein Creative ab.

list

 Listet die Creatives eines Werbetreibenden auf.

patch

 Aktualisiert ein vorhandenes Creative.