- Zasób: GroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Miniatura
- VideoPerformanceAd
- AdUrl
- AdUrlType
- Metody
Zasób: AdvertiserAd
Pojedyncza reklama powiązana z grupą reklam.
Zapis JSON |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
Pola | |
---|---|
name |
Nazwa zasobu reklamy. |
advertiserId |
Unikalny identyfikator reklamodawcy, do którego należy reklama. |
adGroupAdId |
Unikalny identyfikator reklamy. Przypisana przez system. |
adGroupId |
Unikalny identyfikator grupy reklam, do której należy reklama. |
displayName |
Wyświetlana nazwa reklamy. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 255 bajtów. |
entityStatus |
Stan elementu reklamy. |
adUrls[] |
Lista adresów URL używanych przez reklamę. |
Pole sumy ad_details . Szczegóły reklamy. ad_details może mieć tylko jedną z tych wartości: |
|
displayVideoSourceAd |
Szczegóły reklamy pochodzącej z kreacji Display & Video 360. |
mastheadAd |
Szczegółowe informacje o reklamie wyświetlanej na stronie głównej YouTube. |
inStreamAd |
Szczegóły reklamy In-Stream możliwej do pominięcia po 5 sekundach używanej do celów marketingowych związanych ze świadomością marki lub zasięgiem. |
nonSkippableAd |
Szczegóły krótkiej reklamy wideo In-Stream niemożliwej do pominięcia trwającej od 6 do 15 sekund używanej do osiągania celów marketingowych związanych z zasięgiem. |
bumperAd |
Szczegóły krótkiej reklamy wideo niemożliwej do pominięcia trwającej maksymalnie 6 sekund, która jest używana do określania zasięgu. |
audioAd |
Szczegółowe informacje o reklamie audio używanej na potrzeby celów marketingowych związanych z zasięgiem. |
videoDiscoverAd |
Szczegółowe informacje o reklamie promującej film, która wyświetla się w miejscach, w których użytkownicy odkrywają film. |
videoPerformanceAd |
Szczegółowe informacje o reklamie używanej w kampanii wideo zachęcającej do działania mającej na celu zachęcanie użytkowników do działań związanych z firmą, usługą lub produktem. |
DisplayVideoSourceAd
Reklama pochodzi z kreacji DV360.
Zapis JSON |
---|
{ "creativeId": string } |
Pola | |
---|---|
creativeId |
Identyfikator kreacji źródłowej. |
MastheadAd
Szczegóły reklamy w banerze masthead.
Zapis JSON |
---|
{ "video": { object ( |
Pola | |
---|---|
video |
Film w YouTube użyty w reklamie. |
headline |
Nagłówek reklamy. |
description |
Tekst reklamy. |
videoAspectRatio |
Współczynnik proporcji filmu z YouTube odtwarzanego automatycznie w mastheadzie. |
autoplayVideoStartMillisecond |
Czas (w milisekundach), po którym rozpocznie się odtwarzanie filmu. |
autoplayVideoDuration |
Czas trwania autoodtwarzania filmu. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
callToActionButtonLabel |
Tekst na przycisku wezwania do działania. |
callToActionFinalUrl |
Docelowy adres URL przycisku z wezwaniem do działania. |
callToActionTrackingUrl |
Link monitorujący przycisku wezwania do działania. |
showChannelArt |
Określa, czy tło czy baner wyświetlany u góry strony YouTube. |
companionYoutubeVideos[] |
Filmy wyświetlane obok reklamy w banerze masthead na komputerach. Może być maksymalnie 2 razy. |
YoutubeVideoDetails
Szczegółowe informacje o filmie w YouTube.
Zapis JSON |
---|
{
"id": string,
"unavailableReason": enum ( |
Pola | |
---|---|
id |
Identyfikator filmu w YouTube, który można wyszukać na stronie internetowej YouTube. |
unavailableReason |
Przyczyna, dla której dane filmu są niedostępne. |
VideoAspectRatio
Możliwe formaty obrazu filmu w YouTube.
Wartości w polu enum | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
Nie określono lub nieznany. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
Film zostanie rozciągnięty, a jego górna i dolna część zostaną przycięte. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
Film ma stały format 16:9. |
InStreamAd
Szczegóły reklamy In-Stream.
Zapis JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Pola | |
---|---|
commonInStreamAttribute |
Popularne atrybuty reklam. |
customParameters |
Parametry niestandardowe służące do przekazywania wartości niestandardowych do szablonu linku monitorującego. Obiekt zawierający listę par |
CommonInStreamAttribute
Typowe atrybuty reklam In-Stream, reklam niemożliwych do pominięcia i bumperów reklamowych.
Zapis JSON |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
Pola | |
---|---|
displayUrl |
Adres strony internetowej widoczny w reklamie. |
finalUrl |
Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy. |
trackingUrl |
Adres URL wczytywany w tle na potrzeby śledzenia. |
actionButtonLabel |
Tekst na przycisku wezwania do działania. |
actionHeadline |
Nagłówek banera z wezwaniem do działania. |
video |
Film reklamy w YouTube. |
companionBanner |
Obraz wyświetlany obok reklamy wideo. |
ImageAsset
Metadane komponentu z obrazem.
Zapis JSON |
---|
{
"mimeType": string,
"fullSize": {
object ( |
Pola | |
---|---|
mimeType |
Typ MIME komponentu z obrazem. |
fullSize |
Metadane tego obrazu w oryginalnym rozmiarze. |
fileSize |
Rozmiar pliku komponentu z obrazem w bajtach. |
NonSkippableAd
Szczegóły reklamy niemożliwej do pominięcia.
Zapis JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Pola | |
---|---|
commonInStreamAttribute |
Popularne atrybuty reklam. |
customParameters |
Parametry niestandardowe służące do przekazywania wartości niestandardowych do szablonu linku monitorującego. Obiekt zawierający listę par |
BumperAd
Szczegóły bumpera reklamowego.
Zapis JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Pola | |
---|---|
commonInStreamAttribute |
Popularne atrybuty reklam. |
AudioAd
Szczegóły reklamy audio.
Zapis JSON |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
Pola | |
---|---|
displayUrl |
Adres strony internetowej widoczny w reklamie. |
finalUrl |
Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy. |
trackingUrl |
Adres URL wczytywany w tle na potrzeby śledzenia. |
video |
Film reklamy w YouTube. |
VideoDiscoveryAd
Szczegóły reklamy wideo Discovery.
Zapis JSON |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
Pola | |
---|---|
headline |
Nagłówek reklamy. |
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
video |
Film w YouTube promowany przez reklamę. |
thumbnail |
Miniatura użyta w reklamie. |
miniaturę,
Możliwe opcje miniatur w reklamach wideo Discovery.
Wartości w polu enum | |
---|---|
THUMBNAIL_UNSPECIFIED |
Nieznany lub nieokreślony. |
THUMBNAIL_DEFAULT |
Domyślna miniatura może być wygenerowana automatycznie lub przesłana przez użytkownika. |
THUMBNAIL_1 |
Miniatura 1 wygenerowana na podstawie filmu. |
THUMBNAIL_2 |
Miniatura 2 wygenerowana z filmu. |
THUMBNAIL_3 |
Miniatura 3 wygenerowana na podstawie filmu. |
VideoPerformanceAd
Szczegóły reklamy wideo nastawionej na skuteczność.
Zapis JSON |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
Pola | |
---|---|
finalUrl |
Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy. |
trackingUrl |
Adres URL wczytywany w tle na potrzeby śledzenia. |
actionButtonLabels[] |
Lista komponentów tekstowych widocznych na przycisku z wezwaniem do działania. |
headlines[] |
Lista nagłówków wyświetlana na banerze z wezwaniem do działania. |
longHeadlines[] |
Lista pojedynczych nagłówków wyświetlanych na banerze z wezwaniem do działania. |
descriptions[] |
Lista opisów wyświetlanych na banerze wezwania do działania. |
displayUrlBreadcrumb1 |
Pierwszy element w wyświetlanym adresie URL po domenie. |
displayUrlBreadcrumb2 |
Drugi element w wyświetlanym adresie URL po domenie. |
domain |
Domena wyświetlanego adresu URL. |
videos[] |
Lista komponentów wideo w YouTube używanych przez tę reklamę. |
customParameters |
Parametry niestandardowe służące do przekazywania wartości niestandardowych do szablonu linku monitorującego. Obiekt zawierający listę par |
companionBanners[] |
Lista banerów towarzyszących używanych przez tę reklamę. |
AdUrl
Dodatkowe adresy URL związane z reklamą, w tym obrazy typu beacon.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ adresu URL reklamy. |
url |
Wartość ciągu adresu URL. |
AdUrlType
Możliwe typy adresów URL reklamy.
Wartości w polu enum | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
Nieznany lub nieokreślony. |
AD_URL_TYPE_BEACON_IMPRESSION |
Piksel śledzący 1 x 1 do pingowania po wyświetleniu kreacji. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Rozwijany beacon wyświetleń DCM. Podczas wyświetlania rozszerza się na kilka obrazów typu beacon. |
AD_URL_TYPE_BEACON_CLICK |
Link monitorujący do wywołania ping po wywołaniu zdarzenia kliknięcia. |
AD_URL_TYPE_BEACON_SKIP |
Link monitorujący do pingowania po wywołaniu zdarzenia pominięcia. |
Metody |
|
---|---|
|
Pobiera reklamę z grupy reklam. |
|
Wyświetla listę reklam z grupy reklam. |