- Ressource: YouTubeAnzeigengruppenAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Thumbnail
- VideoPerformanceAd
- AdUrl
- AdUrlType
- Methoden
Ressource: YouTubeAnzeigengruppenAd
Eine einzelne Anzeige, die mit einer YouTube-Anzeigengruppe verknüpft ist.
JSON-Darstellung |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
Felder | |
---|---|
name |
Der Ressourcenname der Anzeige. |
advertiserId |
Die eindeutige ID des Werbetreibenden, zu dem die Anzeige gehört. |
adGroupAdId |
Die eindeutige ID der Anzeige. Vom System zugewiesen. |
adGroupId |
Die eindeutige ID der Anzeigengruppe, zu der die Anzeige gehört. |
displayName |
Der Anzeigename der Anzeige. Muss UTF-8-codiert sein und darf maximal 255 Byte groß sein. |
entityStatus |
Der Entitätsstatus der Anzeige. |
adUrls[] |
Liste der von der Anzeige verwendeten URLs. |
Union-Feld ad_details . Die Details der Anzeige. Für ad_details ist nur einer der folgenden Werte zulässig: |
|
displayVideoSourceAd |
Details einer Anzeige, die aus einem Display & Video 360-Creative stammt. |
mastheadAd |
Details zu einer Anzeige, die im YouTube-Startseitenfeed ausgeliefert wurde |
inStreamAd |
Details zu nach 5 Sekunden überspringbaren In-Stream-Anzeigen, die zur Steigerung der Markenbekanntheit oder Reichweite für Marketingziele verwendet werden |
nonSkippableAd |
Details zu einer nicht überspringbaren kurzen In-Stream-Videoanzeige, die zwischen 6 und 15 Sekunden lang ist und für Marketingziele vom Typ „Reichweite“ verwendet wird. |
bumperAd |
Details zu einer nicht überspringbaren kurzen Videoanzeige, die maximal 6 Sekunden lang ist und für die Reichweite verwendet wird. |
audioAd |
Details zu einer Audioanzeige, die zum Erreichen von Marketingzielen verwendet wird |
videoDiscoverAd |
Details zu einer Anzeige, in der für ein Video geworben wird, das an Positionen präsentiert wird, die für Nutzer von Interesse sind. |
videoPerformanceAd |
Details zu einer Anzeige, die in einer Video-Aktionskampagne verwendet wird, um Interaktionen für das Unternehmen, die Dienstleistung oder das Produkt zu fördern |
DisplayVideoSourceAd
Die Anzeige aus einem DV360-Creative.
JSON-Darstellung |
---|
{ "creativeId": string } |
Felder | |
---|---|
creativeId |
Die ID des Quell-Creatives. |
MastheadAd
Details zu einer Masthead-Anzeige
JSON-Darstellung |
---|
{ "video": { object ( |
Felder | |
---|---|
video |
Das von der Anzeige verwendete YouTube-Video. |
headline |
Den Anzeigentitel der Anzeige. |
description |
Die Beschreibung der Anzeige. |
videoAspectRatio |
Das Seitenverhältnis des automatisch wiedergegebenen YouTube-Videos im Masthead. |
autoplayVideoStartMillisecond |
Die Zeit in Millisekunden, nach der die Videowiedergabe beginnt. |
autoplayVideoDuration |
Die Dauer, während der das Video automatisch wiedergegeben wird. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
callToActionButtonLabel |
Text auf der Call-to-Action-Schaltfläche |
callToActionFinalUrl |
Die Ziel-URL für die Call-to-Action-Schaltfläche |
callToActionTrackingUrl |
Tracking-URL für die Call-to-Action-Schaltfläche |
showChannelArt |
Gibt an, ob ein Hintergrund oder ein Banner oben auf einer YouTube-Seite angezeigt werden soll. |
companionYoutubeVideos[] |
Die Videos, die auf Computern neben der Masthead-Anzeige zu sehen sind. Darf nicht mehr als zwei sein. |
YoutubeVideoDetails
Details zu einem YouTube-Video.
JSON-Darstellung |
---|
{
"id": string,
"unavailableReason": enum ( |
Felder | |
---|---|
id |
Die YouTube-Video-ID, nach der auf der YouTube-Webseite gesucht werden kann |
unavailableReason |
Der Grund, warum die Videodaten nicht verfügbar sind. |
VideoAspectRatio
Mögliche Seitenverhältnisse für ein YouTube-Video.
Enums | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
Nicht angegeben oder unbekannt. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
Das Video wird gestreckt und der obere und untere Bereich sind zugeschnitten. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
Das Video hat ein festes Seitenverhältnis von 16:9. |
InStreamAd
Details zu einer In-Stream-Anzeige
JSON-Darstellung |
---|
{
"commonInStreamAttribute": {
object ( |
Felder | |
---|---|
commonInStreamAttribute |
Gängige Anzeigenattribute. |
customParameters |
Die benutzerdefinierten Parameter, mit denen benutzerdefinierte Werte an die Tracking-URL-Vorlage übergeben werden. Ein Objekt, das eine Liste von |
CommonInStreamAttribute
Allgemeine Attribute für In-Stream-, nicht überspringbare und Bumper-Anzeigen
JSON-Darstellung |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
Felder | |
---|---|
displayUrl |
Die Adresse der Webseite, die in der Anzeige zu sehen ist. |
finalUrl |
Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
actionButtonLabel |
Text auf der Call-to-Action-Schaltfläche |
actionHeadline |
Der Anzeigentitel des Call-to-Action-Banners. |
video |
Das YouTube-Video der Anzeige. |
companionBanner |
Das Bild, das neben der Videoanzeige zu sehen ist. |
ImageAsset
Metadaten eines Bild-Assets
JSON-Darstellung |
---|
{
"mimeType": string,
"fullSize": {
object ( |
Felder | |
---|---|
mimeType |
Der MIME-Typ des Bild-Assets. |
fullSize |
Metadaten für dieses Bild in Originalgröße. |
fileSize |
Dateigröße des Bild-Assets in Byte. |
NonSkippableAd
Details zu nicht überspringbaren Anzeigen
JSON-Darstellung |
---|
{
"commonInStreamAttribute": {
object ( |
Felder | |
---|---|
commonInStreamAttribute |
Gängige Anzeigenattribute. |
customParameters |
Die benutzerdefinierten Parameter, mit denen benutzerdefinierte Werte an die Tracking-URL-Vorlage übergeben werden. Ein Objekt, das eine Liste von |
BumperAd
Details für eine Bumper-Anzeige
JSON-Darstellung |
---|
{
"commonInStreamAttribute": {
object ( |
Felder | |
---|---|
commonInStreamAttribute |
Gängige Anzeigenattribute. |
AudioAd
Details zu einer Audioanzeige.
JSON-Darstellung |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
Felder | |
---|---|
displayUrl |
Die Adresse der Webseite, die in der Anzeige zu sehen ist. |
finalUrl |
Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
video |
Das YouTube-Video der Anzeige. |
VideoDiscoveryAd
Details zu einer Video Discovery-Anzeige
JSON-Darstellung |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
Felder | |
---|---|
headline |
Der Anzeigentitel der Anzeige. |
description1 |
Erste Textzeile für die Anzeige. |
description2 |
Zweite Textzeile für die Anzeige |
video |
Das YouTube-Video, für das die Anzeige wirbt. |
thumbnail |
Das in der Anzeige verwendete Thumbnail. |
Thumbnail
Mögliche Thumbnail-Optionen in Video Discovery-Anzeigen.
Enums | |
---|---|
THUMBNAIL_UNSPECIFIED |
Unbekannt oder nicht angegeben. |
THUMBNAIL_DEFAULT |
Das Standard-Thumbnail kann automatisch generiert oder von Nutzern hochgeladen werden. |
THUMBNAIL_1 |
Aus dem Video generiertes Thumbnail 1. |
THUMBNAIL_2 |
Aus dem Video generiertes Thumbnail 2. |
THUMBNAIL_3 |
Aus dem Video generiertes Thumbnail 3. |
VideoPerformanceAd
Details zu einer Videoanzeige für die Videoleistung
JSON-Darstellung |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
Felder | |
---|---|
finalUrl |
Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
actionButtonLabels[] |
Die Liste der Text-Assets, die auf der Call-to-Action-Schaltfläche zu sehen sind |
headlines[] |
Die Liste der Anzeigentitel auf dem Call-to-Action-Banner. |
longHeadlines[] |
Die Liste der einzelnen Anzeigentitel, die auf dem Call-to-Action-Banner zu sehen sind. |
descriptions[] |
Die Liste mit Beschreibungen auf dem Call-to-Action-Banner. |
displayUrlBreadcrumb1 |
Der erste Teil nach der Domain in der angezeigten URL. |
displayUrlBreadcrumb2 |
Der zweite Teil nach der Domain in der angezeigten URL |
domain |
Die Domain der angezeigten URL |
videos[] |
Die Liste der von dieser Anzeige verwendeten YouTube-Video-Assets. |
customParameters |
Die benutzerdefinierten Parameter, mit denen benutzerdefinierte Werte an die Tracking-URL-Vorlage übergeben werden. Ein Objekt, das eine Liste von |
companionBanners[] |
Die Liste der Companion-Banner, die von dieser Anzeige verwendet werden. |
AdUrl
Zusätzliche URLs, die sich auf die Anzeige beziehen, einschließlich Beacons
JSON-Darstellung |
---|
{
"type": enum ( |
Felder | |
---|---|
type |
Der Typ der Anzeigen-URL. |
url |
Der URL-Stringwert. |
AdUrlType
Mögliche Typen von Anzeigen-URLs.
Enums | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
Unbekannt oder nicht angegeben. |
AD_URL_TYPE_BEACON_IMPRESSION |
Ein 1x1-Tracking-Pixel, das angepingt wird, wenn eine Impression eines Creatives geliefert wird. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Beacon für erweiterbare DCM-Impressionen Bei der Auslieferung wird das Creative auf mehrere Beacons erweitert. |
AD_URL_TYPE_BEACON_CLICK |
Tracking-URL, die angepingt werden soll, wenn das Klickereignis ausgelöst wird. |
AD_URL_TYPE_BEACON_SKIP |
Tracking-URL, die angepingt werden soll, wenn das Ereignis „Überspringen“ ausgelöst wird. |
Methoden |
|
---|---|
|
Ruft eine YouTube-Anzeigengruppenanzeige ab. |
|
Listet Anzeigen der YouTube-Anzeigengruppe auf. |