- Ressource: Creative
- HostingSource
- CreativeAttribute
- ReviewStatusInfo (Informationen zum Überprüfungsstatus)
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus (ExchangeReviewStatus)
- PublisherReviewStatus (PublisherReviewStatus)
- AssetAssociation
- Asset
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- Transcodieren
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- Methoden
Ressource: Creative
Ein einzelnes Creative.
JSON-Darstellung |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
Felder | |
---|---|
name |
Nur Ausgabe. Der Ressourcenname des Creatives. |
advertiserId |
Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem das Creative gehört. |
creativeId |
Nur Ausgabe. Die eindeutige ID des Creatives. Vom System zugewiesen. |
cmPlacementId |
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 |
Erforderlich. Der Anzeigename des Creatives. Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein. |
entityStatus |
Erforderlich. Steuert, ob das Creative ausgeliefert werden kann. Zulässige Werte sind:
|
updateTime |
Nur Ausgabe. Zeitstempel für die letzte Aktualisierung des Creatives, entweder vom Nutzer oder vom System (z. B. Creative-Überprüfung) Vom System zugewiesen. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
createTime |
Nur Ausgabe. Zeitstempel für die Erstellung des Creatives Vom System zugewiesen. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
creativeType |
Erforderlich. Nicht veränderbar. Der Typ des Creatives. |
hostingSource |
Erforderlich. Gibt an, wo das Creative gehostet wird. |
dynamic |
Nur Ausgabe. Gibt an, ob das Creative dynamisch ist. |
dimensions |
Erforderlich. Primäre Abmessungen des Creatives Gilt für alle Creative-Typen. Der Wert von
|
additionalDimensions[] |
Zusätzliche Dimensionen. Anwendbar, wenn
Wenn dieses Feld angegeben wird, sind |
mediaDuration |
Nur Ausgabe. Die Mediendauer des Creatives. Anwendbar, wenn
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
creativeAttributes[] |
Nur Ausgabe. Eine vom System generierte Liste mit Attributen des Creatives. |
reviewStatus |
Nur Ausgabe. Der aktuelle Status des Creative-Überprüfungsprozesses. |
assets[] |
Erforderlich. Mit diesem Creative verknüpfte Assets. |
exitEvents[] |
Erforderlich. Exit-Ereignisse für dieses Creative Ein Exit (auch als Klick-Tag bezeichnet) ist ein Bereich in Ihrem Creative, auf den jemand klicken oder tippen kann, 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:
|
timerEvents[] |
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 mit diesem interagiert. Ein Creative kann über mehrere Timer-Ereignisse verfügen, die zeitlich unterschiedlich erfasst werden. Lassen Sie das Feld leer oder legen Sie keine Einstellung für Creatives fest, die nur Bild-Assets enthalten. |
counterEvents[] |
Zählerereignisse für ein Rich Media-Creative Zähler erfassen die Häufigkeit, mit der ein Nutzer mit einem beliebigen Teil eines Rich Media-Creatives auf eine bestimmte Art und Weise interagiert (z. B. Mouseovers, Mouseouts, Klicks, Tippen, Laden von Daten, 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 |
HTML-Tracking-Tag eines Drittanbieters, das an das Creative-Tag angehängt wird |
integrationCode |
ID-Informationen zur Verknüpfung dieses Creatives mit einem externen System. Muss UTF-8-codiert sein und darf nicht länger als 10.000 Zeichen sein. |
notes |
Nutzernotizen für dieses Creative. Muss UTF-8-codiert sein und darf nicht länger als 20.000 Zeichen sein. |
iasCampaignMonitoring |
Gibt an, ob die Kampagnenüberwachung von Integral Ad Science (IAS) aktiviert ist. Wenn Sie diese Option für das Creative aktivieren möchten, muss |
companionCreativeIds[] |
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. Companions werden während der Videowiedergabe rund um den Videoplayer angezeigt und bleiben auf der Seite, nachdem das Video vollständig wiedergegeben wurde. Creatives mit dem Inhalt „ Dieses Feld wird nur für folgende
|
skippable |
Gibt an, ob der Nutzer ein Video-Creative überspringen kann. Dieses Feld wird nur für den folgenden
|
skipOffset |
Die Zeit, die das Video wiedergegeben wird, bevor die Schaltfläche „Überspringen“ erscheint. Dieses Feld ist erforderlich, wenn Dieses Feld wird nur für den folgenden
|
progressOffset |
Die Zeit, die das Video abgespielt wird, bevor ein Aufruf gezählt wird. Dieses Feld ist erforderlich, wenn Dieses Feld wird nur für den folgenden
|
universalAdId |
Optional. Eine optionale, von einer Registry bereitgestellte Creative-ID, die plattformübergreifend eindeutig ist. Die universelle Anzeigen-ID ist Teil des VAST 4.0-Standards. Sie kann auch nach dem Erstellen des Creatives geändert werden. Dieses Feld wird nur für den folgenden
|
thirdPartyUrls[] |
Tracking-URLs von Drittanbietern, um Interaktionen mit einem Video-Creative zu erfassen Dieses Feld wird nur für den folgenden
|
transcodes[] |
Nur Ausgabe. Audio-/Video-Transcodierungen Das Haupt-Asset wird in Display & Video 360 in mehrere Versionen mit unterschiedlichen Dateiformaten und Eigenschaften (Auflösung, Audiobitrate und Videobitrate) umgewandelt. 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 im folgenden
|
trackerUrls[] |
Tracking-URLs für Analyseanbieter oder Anzeigentechnologie-Drittanbieter Die URLs müssen mit https beginnen, außer bei Inventar, das keine SSL-Konformität verlangt. 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 folgendem
|
jsTrackerUrl |
JavaScript-Mess-URL von unterstützten Drittanbietern (ComScore, DoubleVerify, IAS, Moat) HTML-Script-Tags werden nicht unterstützt. Dieses Feld kann nur in folgendem
|
cmTrackingAd |
Die mit dem Creative verknüpfte Campaign Manager 360-Tracking-Anzeige. Optional für die folgenden
Ausgabe nur für andere Fälle. |
obaIcon |
Gibt das OBA-Symbol für ein Video-Creative an. Dieses Feld wird nur im folgenden
|
thirdPartyTag |
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 folgendem
mit folgenden
|
requireMraid |
Optional. Gibt an, dass für das Creative MRAID (Mobile Rich Media Ad Interface Definitions-System) erforderlich ist. 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 folgendem
mit folgenden
|
requireHtml5 |
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 folgendem
mit folgenden
|
requirePingForAttribution |
Optional. Gibt an, dass das Creative für die Attribution auf einen Ping wartet. Nur gültig bei Verwendung einer Campaign Manager 360-Tracking-Anzeige mit einem Ad-Server-Parameter eines Drittanbieters und dem Makro ${DC_DBM_TOKEN}. Optional und nur gültig für Drittanbieter-Tag-Creatives oder Drittanbieter-VAST-Tag-Creatives. Drittanbieter-Tag-Creatives sind Creatives mit folgendem
mit folgenden
VAST-Tag-Creatives von Drittanbietern sind Creatives mit folgenden
mit folgenden
|
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 mit folgender Hostingquelle:
mit folgenden
|
expandOnHover |
Optional. Gibt an, dass das Creative automatisch maximiert wird, wenn der Mauszeiger auf das Creative bewegt wird. Optional und nur gültig für Expandable-Creatives von Drittanbietern. Expandable-Creatives von Drittanbietern sind Creatives mit folgender Hostingquelle:
mit folgenden
|
vastTagUrl |
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
mit folgenden
|
vpaid |
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
mit folgenden
|
html5Video |
Nur Ausgabe. Gibt an, dass für das Drittanbieter-VAST-Tag-Creative 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
mit folgenden
|
lineItemIds[] |
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 |
mp3Audio |
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
mit folgenden
|
oggAudio |
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
mit folgenden
|
HostingSource
Mögliche Hostingquellen für ein Creative. Gibt an, wo ein Creative erstellt und gehostet wird.
Enums | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
Hosting-Quelle ist nicht angegeben oder in dieser Version unbekannt. |
HOSTING_SOURCE_CM |
Ein aus Campaign Manager 360 synchronisiertes Creative 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
|
HOSTING_SOURCE_HOSTED |
Ein Creative, das in DV360 erstellt und von Campaign Manager 360 gehostet wird. Erstellungs- und Aktualisierungsmethoden werden für diesen Hostingtyp unterstützt, wenn
|
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 ( |
Felder | |
---|---|
approvalStatus |
Stellt die grundlegende Genehmigung dar, die erforderlich ist, damit ein Creative ausgeliefert wird. Zusammenfassung für |
creativeAndLandingPageReviewStatus |
Überprüfungsstatus des Creatives und der Landingpage für das Creative. |
contentAndPolicyReviewStatus |
Content- und Richtlinienüberprüfungsstatus für das Creative. |
exchangeReviewStatuses[] |
Anzeigenplattform-Überprüfungsstatus für das Creative. |
publisherReviewStatuses[] |
Der Publisher-Überprüfungsstatus für das Creative. Warnung:Dieses Feld wird am 26. Juni 2024 eingestellt. Nach diesem Datum ist dieses Feld leer. Weitere Informationen finden Sie in unserer Mitteilung zur Einstellung von Funktionen. |
ApprovalStatus
Mögliche Arten von Freigabestatus. Es ist die Zusammenfassung von creativeAndLandingPageReviewStatus
und contentAndPolicyReviewStatus
.
Enums | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
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 Creative- und Landingpage-Überprüfung bestanden und kann ausgeliefert werden, muss aber noch eine weitere Inhalts- und Richtlinienüberprüfung durchlaufen. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Sowohl die Creative- als auch die Landingpage-Überprüfung sowie die Inhalts- 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, damit es ausgeliefert werden kann. |
ReviewStatus
Mögliche Arten von Überprüfungsstatus.
Enums | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
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 des Creatives auf der Anzeigenplattform.
JSON-Darstellung |
---|
{ "exchange": enum ( |
Felder | |
---|---|
exchange |
Die Anzeigenplattform, die das Creative überprüft. |
status |
Status der Überprüfung durch den Anzeigenplattform. |
PublisherReviewStatus
Der Überprüfungsstatus des Creatives durch den Publisher
JSON-Darstellung |
---|
{
"publisherName": string,
"status": enum ( |
Felder | |
---|---|
publisherName |
Der Publisher, der das Creative überprüft |
status |
Status der Überprüfung durch den Publisher. |
AssetAssociation
Asset-Verknüpfung für das Creative.
JSON-Darstellung |
---|
{ "asset": { object ( |
Felder | |
---|---|
asset |
Das verknüpfte Asset. |
role |
Die Rolle dieses Assets für das Creative. |
Asset
Ein einzelnes Asset.
JSON-Darstellung |
---|
{ "mediaId": string, "content": string } |
Felder | |
---|---|
mediaId |
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. Der Media-ID-Bereich wurde am 5. April 2023 aktualisiert. Aktualisieren Sie die vor dem 5. April 2023 im Cache gespeicherten Media-IDs, indem Sie die neue Media-ID aus den verknüpften Creative-Ressourcen abrufen oder das Asset noch einmal hochladen. |
content |
Der Inhalt des Assets. Bei hochgeladenen Assets dient der Content als Auslieferungspfad. |
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 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.
Diese Rolle wird nur in den folgenden
|
ASSET_ROLE_LONG_HEADLINE |
Langer Anzeigentitel eines nativen Creatives.
Diese Rolle wird nur in den folgenden
|
ASSET_ROLE_BODY |
Text eines nativen Creatives
Diese Rolle wird nur in den folgenden
|
ASSET_ROLE_LONG_BODY |
Langer Text eines nativen Creatives.
Diese Rolle wird nur in den folgenden
|
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.
Lautet die Landingpage-URL beispielsweise „http://www.beispiel.de/seite“, kann die Untertitel-URL „beispiel.de“ sein. Das Protokoll (http://) ist optional, aber die URL darf keine Leerzeichen oder Sonderzeichen enthalten. Diese Rolle wird nur in den folgenden
|
ASSET_ROLE_CALL_TO_ACTION |
Der Text, der auf der Call-to-Action-Schaltfläche eines nativen Creatives verwendet werden soll.
Diese Rolle wird nur in den folgenden
|
ASSET_ROLE_ADVERTISER_NAME |
Der Text zur Identifizierung des Werbetreibenden- oder Markennamens.
Diese Rolle wird nur in den folgenden
|
ASSET_ROLE_PRICE |
Der Kaufpreis Ihrer App im Google Play Store oder iOS App Store, z. B. 5,99 €. Dieser Wert wird nicht automatisch mit dem tatsächlichen Wert im Store synchronisiert. Diese ist immer diejenige, die beim Speichern des Creatives angegeben wird.
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 die ID 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 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. Diese 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
|
ASSET_ROLE_COVER_IMAGE |
Das Titelbild eines nativen Video-Creatives. Diese Rolle wird nur in den folgenden
|
ExitEvent
Exit-Ereignis des Creatives.
JSON-Darstellung |
---|
{
"type": enum ( |
Felder | |
---|---|
type |
Erforderlich. Der Typ des Exit-Ereignisses. |
url |
Erforderlich. Die Klick-URL des Exit-Ereignisses. Dies ist erforderlich, wenn
|
name |
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 keine Einstellung für Creatives fest, die nur Bild-Assets enthalten. |
reportingName |
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 Backup-Exit-Ereignisse enthalten. |
TimerEvent
Timer-Ereignis des Creatives.
JSON-Darstellung |
---|
{ "name": string, "reportingName": string } |
Felder | |
---|---|
name |
Erforderlich. Der Name des Timer-Ereignisses. |
reportingName |
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 |
Erforderlich. Der Name des Zählerereignisses. |
reportingName |
Erforderlich. Der Name, mit dem dieses Zählerereignis in Berichten identifiziert wird |
AudioVideoOffset
Gibt an, wie lang ein Audio- oder Videomaterial abgespielt wurde.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld offset . Der Wert des Offsets. Für offset ist nur einer der folgenden Werte zulässig: |
|
percentage |
Prozentualer Offset der Audio- oder Videodauer |
seconds |
Der Versatz in Sekunden ab Beginn des Audio- oder Videofeeds. |
UniversalAdId
Eine von einer Registry bereitgestellte Creative-ID, die plattformübergreifend eindeutig ist. Das ist Teil des VAST 4.0-Standards.
JSON-Darstellung |
---|
{
"id": string,
"registry": enum ( |
Felder | |
---|---|
id |
Die eindeutige Creative-ID. |
registry |
Die Registry stellt eindeutige Creative-IDs bereit. |
UniversalAdRegistry
Die Registry stellt eindeutige Creative-IDs in einer universellen Anzeigen-ID 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 ( |
Felder | |
---|---|
type |
Der Interaktionstyp muss über die Tracking-URL erfasst werden. |
url |
Tracking-URL, mit der die Interaktion erfasst wird. Geben Sie eine URL mit optionalem Pfad oder Abfragestring an, die mit |
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 zum Zählen von Impressionen des Creatives nach vollständiger Zwischenspeicherung von Audio oder Video verwendet. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
Wird verwendet, um Nutzerklicks auf die Audio- oder Videowiedergabe zu verfolgen. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Mit dieser Option wird erfasst, wie oft 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 die Häufigkeit verfolgt, mit der 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 erfasst, wie oft Audio oder Video bis zum Ende abgespielt wird. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
Mit dieser Option wird erfasst, wie oft ein Nutzer die Audio- oder Videowiedergabe stummschaltet. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
Mit dieser Option wird erfasst, wie oft ein Nutzer die Audio- oder Videowiedergabe 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 erfasst, wie oft ein Nutzer die Audio- oder Videowiedergabe anhält. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
Mit dieser Option wird nachverfolgt, wie häufig ein Nutzer einen benutzerdefinierten Klick ausführt, z. B. auf einen Videohotspot. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
Mit dieser Option wird erfasst, wie oft die Audio- oder Videoinhalte übersprungen wurden. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
Mit dieser Option wird nachverfolgt, wie häufig das Audio oder Video bis zu einem durch den progressOffset festgelegten Offset abgespielt wird. |
Transcodieren
Informationen zur transkodierten Audio- oder Videodatei
JSON-Darstellung |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
Felder | |
---|---|
name |
Der Name der transkodierten Datei. |
mimeType |
Der MIME-Typ der umgewandelten Datei. |
transcoded |
Gibt an, ob die Transcodierung erfolgreich war. |
dimensions |
Die Abmessungen des transkodierten Videos. |
bitRateKbps |
Die Transkodierungs-Bitrate des transkodierten Videos in Kilobit pro Sekunde. |
frameRate |
Die Framerate des transkodierten Videos in Bildern pro Sekunde. |
audioBitRateKbps |
Die Bitrate für den Audiostream des transcodierten Videos oder die Bitrate für das transcodierte Audio in Kilobit pro Sekunde. |
audioSampleRateHz |
Die Abtastrate für den Audiostream des transkodierten Videos oder die Abtastrate für die transkodierten Audioinhalte in Hertz. |
fileSizeBytes |
Die Größe der transkodierten Datei in Byte. |
CmTrackingAd
Campaign Manager 360-Tracking-Anzeige
JSON-Darstellung |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Felder | |
---|---|
cmPlacementId |
Die Placement-ID der Campaign Manager 360-Tracking-Anzeige. |
cmCreativeId |
Die Creative-ID der Campaign Manager 360-Tracking-Anzeige. |
cmAdId |
Die Anzeigen-ID der Campaign Manager 360-Tracking-Anzeige. |
ObaIcon
OBA-Symbol für ein Creative
JSON-Darstellung |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
Felder | |
---|---|
resourceUrl |
Die URL der OBA-Symbolressource. |
resourceMimeType |
Der MIME-Typ der OBA-Symbolressource. |
position |
Die Position des OBA-Symbols im Creative. |
dimensions |
Die Abmessungen des OBA-Symbols |
program |
Das Programm des OBA-Symbols. Beispiel: „Datenschutzinfo“. |
landingPageUrl |
Erforderlich. Die Landingpage-URL des OBA-Symbols. Es sind nur URLs der folgenden Domains zulässig: |
clickTrackingUrl |
Erforderlich. Die Klick-Tracking-URL des OBA-Symbols. Es sind nur URLs der folgenden Domains zulässig: |
viewTrackingUrl |
Erforderlich. Ansicht-Tracking-URL des OBA-Symbols Es sind nur URLs der folgenden Domains 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
Die Maximierungsrichtung des Expandable-Creatives des Drittanbieters.
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 |
Maximiert nach unten |
EXPANDING_DIRECTION_LEFT |
Wird nach links erweitert. |
EXPANDING_DIRECTION_RIGHT |
Wird nach rechts erweitert. |
EXPANDING_DIRECTION_UP_AND_LEFT |
Wird nach oben und nach links erweitert. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
Wird nach oben und auf die rechte Seite erweitert. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
Wird nach unten und zur linken Seite maximiert. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
Wird nach unten und auf die rechte Seite maximiert. |
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 |
Kann in jede diagonale Richtung erweitert werden. |
Methoden |
|
---|---|
|
Erstellt ein neues Creative. |
|
Löscht ein Creative. |
|
Ruft ein Creative ab. |
|
Listet die Creatives eines Werbetreibenden auf. |
|
Aktualisiert ein vorhandenes Creative. |