- Ressource: Anzeigengruppen-Anzeige
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Thumbnail
- VideoPerformanceAd
- AdUrl
- AdUrlType
- Methoden
Ressource: Anzeigengruppen-Anzeige
Eine einzelne Anzeige, die einer Anzeigengruppe zugeordnet 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 zu einer Anzeigenquelle, die aus einem Display & Video 360-Creative stammt. |
mastheadAd |
Details zu einer im YouTube-Startseitenfeed ausgelieferten Anzeige |
inStreamAd |
Details zu einer In-Stream-Anzeige, die nach fünf Sekunden übersprungen werden kann, die zur Steigerung der Markenbekanntheit oder zum Erreichen von Marketingzielen verwendet wird |
nonSkippableAd |
Details einer nicht überspringbaren kurzen In-Stream-Videoanzeige, die zwischen 6 und 15 Sekunden lang ist und zum Erreichen von Marketingzielen verwendet wird |
bumperAd |
Details einer nicht überspringbaren kurzen Videoanzeige, die maximal sechs 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 ein Video beworben wird, das an Positionen angezeigt wird, die für Nutzer interessant sind. |
videoPerformanceAd |
Details zu einer Anzeige, die in einer Video-Aktionskampagne verwendet wird, um Aktionen 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 Zeitspanne in Millisekunden, nach der die Videowiedergabe des Videos 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 |
Die 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 dem Computer neben der Masthead-Anzeige erscheinen. 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 Rand werden abgeschnitten. |
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 mit der Anzeige erscheint. |
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 |
MIME-Typ des Image-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 mit der Anzeige erscheint. |
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 leistungsorientierten Anzeige für Videoanzeigen
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, die auf dem Call-to-Action-Banner zu sehen sind. |
longHeadlines[] |
Die Liste der einzelnen Anzeigentitel, die auf dem Call-to-Action-Banner zu sehen sind. |
descriptions[] |
Die Liste der 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 |
Domain der angezeigten URL |
videos[] |
Die Liste der YouTube-Video-Assets, die in dieser Anzeige verwendet werden. |
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 Wert des URL-Strings. |
AdUrlType
Mögliche Typen von Anzeigen-URLs.
Enums | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
Unbekannt oder nicht angegeben. |
AD_URL_TYPE_BEACON_IMPRESSION |
Ein 1 x 1-Tracking-Pixel, das angepingt werden soll, wenn eine Impression eines Creatives ausgeliefert wird. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Beacon für Expandable-DCM-Impressionen Bei der Auslieferung werden mehrere Beacons unterstützt. |
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 Anzeigengruppenanzeige ab |
|
Listet Anzeigen der Anzeigengruppe auf. |