Ad

reklama,

Zapis JSON
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
Pola
resourceName

string

Niezmienna. Nazwa zasobu reklamy. Nazwy zasobów reklam mają postać:

customers/{customerId}/ads/{ad_id}

finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami w reklamie.

finalAppUrls[]

object (FinalAppUrl)

Lista końcowych adresów URL aplikacji, które będą używane na urządzeniach mobilnych, jeśli użytkownik ma zainstalowaną konkretną aplikację.

finalMobileUrls[]

string

Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach w różnych domenach dla reklamy.

urlCustomParameters[]

object (CustomParameter)

Lista mapowań, które można wykorzystać do zastąpienia tagów parametrów niestandardowych w tagu trackingUrlTemplate, finalUrls lub mobile_final_urls. W przypadku operacji typu mutates używaj operacji dotyczących parametrów niestandardowych adresu URL.

type

enum (AdType)

Tylko dane wyjściowe. Typ reklamy.

devicePreference

enum (Device)

Ustawienie urządzenia dla reklamy. Możesz określić preferencję tylko dla urządzeń mobilnych. Gdy to ustawienie jest włączone, reklama będzie preferowana przed innymi reklamami podczas wyświetlania na urządzeniu mobilnym. Reklama może się nadal wyświetlać na innych typach urządzeń, np. gdy nie ma innych reklam dostępnych. Jeśli nie określono inaczej (brak preferencji urządzenia), reklamy będą kierowane na wszystkie urządzenia. Ta funkcja jest obsługiwana tylko w przypadku niektórych typów reklam.

urlCollections[]

object (UrlCollection)

dodatkowe adresy URL reklamy otagowane unikalnym identyfikatorem, na który można się powoływać z innych pól reklamy;

systemManagedResourceSource

enum (SystemManagedResourceSource)

Tylko dane wyjściowe. Jeśli reklama jest zarządzana przez system, to pole wskazuje źródło. To pole jest tylko do odczytu.

id

string (int64 format)

Tylko dane wyjściowe. Identyfikator reklamy.

trackingUrlTemplate

string

Szablon adresu URL służący do tworzenia linku monitorującego.

finalUrlSuffix

string

Sufiks, którego należy używać podczas tworzenia końcowego adresu URL.

displayUrl

string

Adres URL widoczny w opisie reklamy w przypadku niektórych formatów reklam.

addedByGoogleAds

boolean

Tylko dane wyjściowe. Wskazuje, czy reklama została dodana automatycznie przez Google Ads, a nie przez użytkownika. Może się tak zdarzyć, gdy reklamy są tworzone automatycznie jako propozycje nowych reklam na podstawie skuteczności dotychczasowych reklam.

name

string

Niezmienna. Nazwa reklamy. Służy on tylko do identyfikacji reklamy. Nie musi być niepowtarzalna i nie wpływa na wyświetlaną reklamę. Pole name jest obecnie obsługiwane tylko w przypadku reklam typu DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd.

Pole unii ad_data. Szczegóły dotyczące typu reklamy. Musisz podać dokładnie jedną wartość. ad_data może być tylko jednym z tych elementów:
textAd

object (TextAdInfo)

Niezmienna. Szczegóły dotyczące reklamy tekstowej.

expandedTextAd

object (ExpandedTextAdInfo)

Szczegóły dotyczące rozszerzonej reklamy tekstowej.

callAd

object (CallAdInfo)

Szczegóły dotyczące reklamy generującej połączenia.

expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

Niezmienna. Szczegóły dotyczące rozszerzonej dynamicznej reklamy w wyszukiwarce. W przypadku tego typu reklam nagłówek, końcowe adresy URL i wyświetlany URL są generowane automatycznie w momencie wyświetlenia na podstawie informacji o nazwie domeny dostarczonych przez dynamicSearchAdsSetting połączone na poziomie kampanii.

hotelAd

object (HotelAdInfo)

Szczegóły dotyczące reklamy hotelu.

shoppingSmartAd

object (ShoppingSmartAdInfo)

Szczegóły dotyczące reklamy produktowej w kampanii inteligentnej.

shoppingProductAd

object (ShoppingProductAdInfo)

Szczegóły dotyczące reklamy produktowej.

imageAd

object (ImageAdInfo)

Niezmienna. Szczegóły dotyczące reklamy graficznej.

videoAd

object (VideoAdInfo)

Szczegóły dotyczące reklamy wideo.

videoResponsiveAd

object (VideoResponsiveAdInfo)

Szczegóły dotyczące elastycznej reklamy wideo.

responsiveSearchAd

object (ResponsiveSearchAdInfo)

Szczegóły dotyczące elastycznej reklamy w wyszukiwarce.

legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

Szczegóły dotyczące starszej elastycznej reklamy displayowej.

appAd

object (AppAdInfo)

Szczegóły dotyczące reklamy aplikacji.

legacyAppInstallAd

object (LegacyAppInstallAdInfo)

Niezmienna. Szczegóły dotyczące starszej reklamy promującej instalacje aplikacji.

responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

Szczegóły dotyczące elastycznej reklamy displayowej.

localAd

object (LocalAdInfo)

Szczegóły dotyczące reklamy lokalnej.

displayUploadAd

object (DisplayUploadAdInfo)

Szczegóły dotyczące reklamy przesłanej do wyświetlania w sieci reklamowej.

appEngagementAd

object (AppEngagementAdInfo)

Szczegóły dotyczące reklamy angażującej w aplikację.

shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

Szczegóły dotyczące reklamy produktowej z porównaniem produktów.

smartCampaignAd

object (SmartCampaignAdInfo)

Szczegóły dotyczące reklamy w kampanii inteligentnej.

appPreRegistrationAd

object (AppPreRegistrationAdInfo)

Szczegóły dotyczące reklamy promującej wcześniejszą rejestrację w aplikacji.

demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

Szczegóły dotyczące reklamy z wieloma komponentami w kampanii generującej popyt.

demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

Szczegóły dotyczące elastycznej reklamy wideo generującej popyt.

demandGenProductAd

object (DemandGenProductAdInfo)

Szczegóły dotyczące reklamy produktowej generującej popyt.

travelAd

object (TravelAdInfo)

Szczegóły dotyczące reklamy dotyczącej podróży.

FinalAppUrl

Adres URL prowadzący do aplikacji w danym systemie operacyjnym.

Zapis JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Pola
osType

enum (AppUrlOperatingSystemType)

System operacyjny objęty kierowaniem przez ten adres URL. Wymagany.

url

string

Adres URL precyzyjnego linku do aplikacji. Precyzyjne linki wskazują miejsce w aplikacji odpowiadające treści, którą chcesz wyświetlić. Powinny mieć format {schemat}://{host_path}. Schemat wskazuje, którą aplikację otworzyć. W przypadku aplikacji możesz użyć schematu niestandardowego, który zaczyna się od nazwy aplikacji. Host i ścieżka określają unikalną lokalizację w aplikacji, w której znajdują się Twoje treści. Przykład: „exampleapp://productid_1234”. Wymagany.

AppUrlOperatingSystemType

System operacyjny

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
IOS System operacyjny Apple iOS.
ANDROID System operacyjny Android.

AdType

Możliwe typy reklam.

Wartości w polu enum
UNSPECIFIED Nie określono żadnej wartości.
UNKNOWN

Otrzymana wartość jest nieznana w tej wersji.

Jest to wartość tylko do odpowiedzi.

TEXT_AD Reklama jest reklamą tekstową.
EXPANDED_TEXT_AD Reklama jest rozszerzoną reklamą tekstową.
EXPANDED_DYNAMIC_SEARCH_AD Reklama jest rozszerzoną dynamiczną reklamą w wyszukiwarce.
HOTEL_AD Reklama jest reklamą hotelu.
SHOPPING_SMART_AD Reklama jest inteligentną reklamą produktową.
SHOPPING_PRODUCT_AD Reklama jest standardową reklamą produktową.
VIDEO_AD Reklama jest reklamą wideo.
IMAGE_AD Ta reklama to reklama graficzna.
RESPONSIVE_SEARCH_AD Reklama jest elastyczną reklamą w wyszukiwarce.
LEGACY_RESPONSIVE_DISPLAY_AD Reklama jest starszą elastyczną reklamą displayową.
APP_AD Reklama jest reklamą aplikacji.
LEGACY_APP_INSTALL_AD Reklama jest reklamą starszego typu promującą instalacje aplikacji.
RESPONSIVE_DISPLAY_AD Reklama jest elastyczną reklamą displayową.
LOCAL_AD Reklama jest reklamą lokalną.
HTML5_UPLOAD_AD Reklama jest reklamą przesyłaną displayową z typem produktu HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Reklama jest reklamą displayową z jednym z typów produktów DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Reklama angażująca w aplikację.
SHOPPING_COMPARISON_LISTING_AD Reklama jest reklamą z porównaniem produktów w Zakupach Google.
VIDEO_BUMPER_AD bumper reklamowy wideo.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Reklama wideo In-Stream niemożliwa do pominięcia.
VIDEO_TRUEVIEW_IN_STREAM_AD Reklama wideo TrueView In-Stream
VIDEO_RESPONSIVE_AD Elastyczna reklama wideo.
SMART_CAMPAIGN_AD Reklama z kampanii inteligentnej.
CALL_AD Reklama generująca połączenia.
APP_PRE_REGISTRATION_AD Uniwersalna reklama promująca aplikację z wcześniejszą rejestracją.
IN_FEED_VIDEO_AD Reklama wideo In-Feed.
DEMAND_GEN_MULTI_ASSET_AD Reklama generująca popyt z wieloma komponentami.
TRAVEL_AD Reklama dotycząca podróży.
DEMAND_GEN_VIDEO_RESPONSIVE_AD Reklama wideo generująca popyt w wersji responsywnej.
DEMAND_GEN_PRODUCT_AD Reklama produktowa generująca popyt.

UrlCollection

Kolekcja adresów URL oznaczonych unikalnym identyfikatorem.

Zapis JSON
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Pola
finalUrls[]

string

lista możliwych końcowych adresów URL;

finalMobileUrls[]

string

Lista możliwych końcowych adresów URL na urządzenia mobilne.

urlCollectionId

string

Unikalny identyfikator tej instancji UrlCollection.

trackingUrlTemplate

string

Szablon adresu URL do tworzenia linku monitorującego.

SystemManagedResourceSource

Enum z listą możliwych źródeł jednostek zarządzanych przez system.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
AD_VARIATIONS Eksperymentalna reklama z wygenerowanymi odmianami reklamy.

TextAdInfo

Reklama tekstowa.

Zapis JSON
{
  "headline": string,
  "description1": string,
  "description2": string
}
Pola
headline

string

Nagłówek reklamy.

description1

string

Pierwszy wiersz tekstu reklamy.

description2

string

Druga linia tekstu reklamy.

ExpandedTextAdInfo

Rozszerzona reklama tekstowa.

Zapis JSON
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Pola
headlinePart1

string

Pierwszy element nagłówka reklamy.

headlinePart2

string

Druga część nagłówka reklamy.

headlinePart3

string

Trzecia część nagłówka reklamy.

description

string

Opis reklamy.

description2

string

Drugi opis reklamy.

path1

string

Tekst, który może się wyświetlać obok wyświetlanego adresu URL reklamy.

path2

string

Dodatkowy tekst, który może się wyświetlać obok wyświetlanego adresu URL reklamy.

CallAdInfo

Reklama generująca połączenia.

Zapis JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Pola
countryCode

string

Kod kraju w reklamie.

phoneNumber

string

Numer telefonu w reklamie.

businessName

string

Nazwa firmy w reklamie.

headline1

string

Pierwszy nagłówek w reklamie.

headline2

string

Drugi nagłówek w reklamie.

description1

string

Pierwszy wiersz tekstu reklamy.

description2

string

Druga linia tekstu reklamy.

callTracked

boolean

Czy włączyć śledzenie połączeń w przypadku tej kreacji. Włączenie śledzenia połączeń powoduje też włączenie konwersji telefonicznych.

disableCallConversion

boolean

Określa, czy w przypadku tej kreacji mają być wyłączone konwersje telefoniczne. Jeśli ustawisz wartość true, wyłączysz konwersje telefoniczne, nawet jeśli callTracked ma wartość true. Jeśli callTracked = false, to pole jest ignorowane.

phoneNumberVerificationUrl

string

Adres URL do weryfikacji numeru telefonu.

conversionAction

string

Działanie powodujące konwersję, do którego ma być przypisana konwersja z połączenia. Jeśli nie jest ustawione, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy ustawienie callTracked ma wartość true. W przeciwnym razie to pole jest ignorowane.

conversionReportingState

enum (CallConversionReportingState)

Zachowanie konwersji polegającej na połączeniu z reklamą generującą połączenia. Może ona używać własnego ustawienia konwersji telefonicznej, odziedziczyć ustawienie na poziomie konta lub być wyłączona.

path1

string

Pierwsza część tekstu, którą można dołączyć do adresu URL w reklamie. Opcjonalnie:

path2

string

Druga część tekstu, którą można dołączyć do adresu URL w reklamie. To pole można ustawić tylko wtedy, gdy path1 jest również ustawione. Opcjonalnie:

ExpandedDynamicSearchAdInfo

Rozszerzona dynamiczna reklama w wyszukiwarce

Zapis JSON
{
  "description": string,
  "description2": string
}
Pola
description

string

Opis reklamy.

description2

string

Drugi opis reklamy.

HotelAdInfo

Ten typ nie ma pól.

Reklama hotelu.

ShoppingSmartAdInfo

Ten typ nie ma pól.

Inteligentna reklama produktowa.

ShoppingProductAdInfo

Ten typ nie ma pól.

standardowa reklama produktowa,

ImageAdInfo

Reklama graficzna.

Zapis JSON
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Pola
mimeType

enum (MimeType)

Typ MIME obrazu.

pixelWidth

string (int64 format)

Szerokość obrazu w pełnym rozmiarze (w pikselach).

pixelHeight

string (int64 format)

Wysokość obrazu w pełnym rozmiarze w pikselach.

imageUrl

string

Adres URL obrazu w pełnym rozmiarze.

previewPixelWidth

string (int64 format)

Szerokość w pikselach obrazu w wymiarze podglądu.

previewPixelHeight

string (int64 format)

Wysokość w pikselach obrazu w rozmiarze podglądu.

previewImageUrl

string

Adres URL obrazu w rozmiarze podglądu.

name

string

Nazwa obrazu. Jeśli obraz został utworzony z pliku MediaFile, jest to nazwa pliku MediaFile. Jeśli obraz został utworzony z bajtów, pole jest puste.

Pole unii image. Obraz, na podstawie którego zostanie utworzony ImageAd. Można to zrobić na 2 sposoby. 1. Istniejący zasób MediaFile. 2. Nieprzetworzone dane obrazu w postaci bajtów. image może być tylko jednym z tych elementów:
imageAsset

object (AdImageAsset)

Komponenty graficzne używane w reklamie.

data

string (bytes format)

Nieprzetworzone dane obrazu jako bajty.

Ciąg znaków zakodowany w formacie Base64.

adIdToCopyImageFrom

string (int64 format)

Identyfikator reklamy, z której ma zostać skopiowany obraz.

AdImageAsset

Komponent graficzny używany w reklamie.

Zapis JSON
{
  "asset": string
}
Pola
asset

string

Nazwa zasobu komponentu tego obrazu.

VideoAdInfo

reklama wideo,

Zapis JSON
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Pola
video

object (AdVideoAsset)

komponenty wideo z YouTube użyte w reklamie.

Pole unii format. Schemat dotyczący różnych formatów filmów. format może być tylko jednym z tych elementów:
inStream

object (VideoTrueViewInStreamAdInfo)

Format reklamy wideo TrueView In-Stream.

bumper

object (VideoBumperInStreamAdInfo)

Bumper reklamowy In-Stream.

outStream

object (VideoOutstreamAdInfo)

Format reklamy wideo typu Out-Stream.

nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Format reklamy In-Stream niemożliwej do pominięcia.

inFeed

object (InFeedVideoAdInfo)

Format reklamy wideo In-Feed.

AdVideoAsset

Komponent wideo używany w reklamie.

Zapis JSON
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
Pola
asset

string

Nazwa zasobu komponentu wideo.

adVideoAssetInfo

object (AdVideoAssetInfo)

Zawiera pola informacyjne dotyczące tego zasobu wideo w reklamie.

AdVideoAssetInfo

Zawiera pola informacyjne dotyczące zasobów AdVideoAssets.

Zapis JSON
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
Pola
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

Lista preferencji dotyczących zasobów reklamowych dla tego zasobu reklamowego z filmem. To pole można ustawić tylko w przypadku typu reklamy DiscoveryVideoResponsiveAd. Komponenty wideo z ustawionymi preferencjami komponentów zasobów będą miały pierwszeństwo przed innymi filmami z tej samej reklamy w czasie wyświetlania. Wyobraź sobie na przykład, że ta reklama jest wyświetlana w przypadku określonych zasobów reklamowych. Serwer najpierw spróbuje dopasować odpowiedni film do preferencji dotyczących danego zasobu reklamowego. Filmy bez preferencji są wybierane tylko wtedy, gdy można znaleźć film z pasującymi preferencjami i odpowiednim do danego miejsca na reklamę.

AdVideoAssetInventoryPreferences

Ustawienia komponentów reklam wideo w YouTube.

Zapis JSON
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
Pola
inFeedPreference

boolean

Jeśli to pole ma wartość prawda, podczas wybierania filmu do wyświetlenia w karcie preferowany będzie zasób wideo w YouTube z tym ustawieniem.

inStreamPreference

boolean

Jeśli to ustawienie jest zaznaczone, podczas wybierania filmu do wyświetlania w in-stream preferowany będzie komponent wideo w YouTube z tym ustawieniem preferencji zasobów reklamowych.

shortsPreference

boolean

Jeśli to ustawienie jest zaznaczone, podczas wybierania filmu do wyświetlania w YouTube Shorts preferowany będzie komponent wideo w YouTube z tym ustawieniem.

VideoTrueViewInStreamAdInfo

Przykład formatu reklamy wideo TrueView In-Stream (reklamy wyświetlanej podczas odtwarzania filmu, często na początku, która po kilku sekundach wyświetla przycisk pominięcia).

Zapis JSON
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Pola
actionButtonLabel

string

Etykieta przycisku wezwania do działania, który przekierowuje użytkownika do końcowego adresu URL reklamy wideo. Wymagane w przypadku kampanii TrueView zachęcających do działania, w innych przypadkach opcjonalne.

actionHeadline

string

Dodatkowy tekst wyświetlany z przyciskiem wezwania do działania, który ma na celu kontekstualizację i zachęcenie do kliknięcia przycisku.

companionBanner

object (AdImageAsset)

Komponenty graficzne banera towarzyszącego używanego w reklamie.

VideoBumperInStreamAdInfo

Przykład bumpera reklamowego In-Stream (bardzo krótkiej reklamy wideo niemożliwej do pominięcia).

Zapis JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Pola
companionBanner

object (AdImageAsset)

Komponenty graficzne banera towarzyszącego używanego w reklamie.

actionButtonLabel

string

Etykieta przycisku „Wezwanie do działania”, który przekierowuje użytkownika do końcowego adresu URL reklamy wideo.

actionHeadline

string

Dodatkowy tekst wyświetlany z przyciskiem wezwania do działania, który ma na celu kontekstualizację i zachęcenie do kliknięcia przycisku.

VideoOutstreamAdInfo

Przykład formatu reklamy wideo Out-Stream (reklama wyświetlana obok kanału z automatycznym odtwarzaniem bez dźwięku).

Zapis JSON
{
  "headline": string,
  "description": string
}
Pola
headline

string

Nagłówek reklamy.

description

string

Linia tekstu.

VideoNonSkippableInStreamAdInfo

Przykład reklamy In-Stream niemożliwej do pominięcia (15-sekundowa reklama In-Stream niemożliwa do pominięcia).

Zapis JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Pola
companionBanner

object (AdImageAsset)

Komponenty graficzne banera towarzyszącego używanego w reklamie.

actionButtonLabel

string

Etykieta przycisku „Wezwanie do działania”, który przekierowuje użytkownika do końcowego adresu URL reklamy wideo.

actionHeadline

string

Dodatkowy tekst wyświetlany z przyciskiem „Wezwanie do działania”, aby podać kontekst i zachęcić do kliknięcia przycisku.

InFeedVideoAdInfo

Przykład formatu reklamy wideo In-Feed

Zapis JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Pola
headline

string

Nagłówek reklamy.

description1

string

Pierwszy wiersz tekstu reklamy.

description2

string

Drugi wiersz tekstu reklamy.

thumbnail

enum (VideoThumbnail)

Obraz miniatury filmu do użycia.

VideoThumbnail

Enum z listą możliwych typów miniatur filmów.

Wartości w polu enum
UNSPECIFIED Nie podano typu.
UNKNOWN Otrzymana wartość jest nieznana w tej wersji. Jest to wartość tylko do odpowiedzi.
DEFAULT_THUMBNAIL Domyślna miniatura. mogą być generowane automatycznie lub przesyłane przez użytkowników;
THUMBNAIL_1 Miniatura 1 wygenerowana z filmu.
THUMBNAIL_2 Miniatura 2 wygenerowana z filmu.
THUMBNAIL_3 Miniatura 3 wygenerowana z filmu.

VideoResponsiveAdInfo

Elastyczna reklama wideo.

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych używanych w krótkim nagłówku. Obecnie obsługiwana jest tylko 1 wartość krótkiego nagłówka.

longHeadlines[]

object (AdTextAsset)

Lista komponentów tekstowych użytych w długim nagłówku. Obecnie obsługiwana jest tylko 1 wartość długiego nagłówka.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych użytych w opisie. Obecnie obsługiwana jest tylko 1 wartość opisu.

callToActions[]

object (AdTextAsset)

Lista komponentów tekstowych użytych na przycisku, np. przycisku „Wezwanie do działania”. Obecnie obsługiwana jest tylko 1 wartość przycisku.

videos[]

object (AdVideoAsset)

Lista komponentów wideo z YouTube użytych w reklamie. Obecnie obsługiwana jest tylko 1 wartość zasobu wideo z YouTube.

companionBanners[]

object (AdImageAsset)

Lista komponentów graficznych używanych w banerze towarzyszącym. Obecnie obsługiwana jest tylko 1 wartość dla zasobu banera towarzyszącego.

breadcrumb1

string

Pierwsza część tekstu, która pojawia się w reklamie wraz z wyświetlanym adresem URL.

breadcrumb2

string

Druga część tekstu, która pojawia się w reklamie z wyświetlanym adresem URL.

ResponsiveSearchAdInfo

Elastyczna reklama w wyszukiwarce

Dzięki elastycznym reklamom w wyszukiwarce możesz tworzyć reklamy, które dostosowują się do wielkości ekranu, co pozwala wyświetlać klientom trafniejsze komunikaty i więcej tekstu. Podczas tworzenia elastycznej reklamy w wyszukiwarce podaj kilka nagłówków i tekstów reklamy. Google Ads będzie automatycznie testować różne zestawienia, by sprawdzić, które są najskuteczniejsze. Dzięki dostosowywaniu treści reklamy do słów wyszukiwanych przez potencjalnych klientów elastyczne reklamy w wyszukiwarce mogą zwiększać skuteczność kampanii.

Więcej informacji znajdziesz tutaj: https://support.google.com/google-ads/answer/7684791

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych do opisów. Gdy reklama się wyświetli, teksty będą wybierane z tej listy.

path1

string

Pierwsza część tekstu, którą można dołączyć do adresu URL w reklamie.

path2

string

Druga część tekstu, którą można dołączyć do adresu URL w reklamie. To pole można ustawić tylko wtedy, gdy path1 jest również ustawione.

LegacyResponsiveDisplayAdInfo

Elastyczna reklama displayowa starszego typu. Reklamy tego typu są oznaczone w interfejsie Google Ads etykietą „Reklamy elastyczne”.

Zapis JSON
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Pola
formatSetting

enum (DisplayAdFormatSetting)

Określa format, w którym reklama będzie się wyświetlać. Wartość domyślna to ALL_FORMATS.

shortHeadline

string

Krótka wersja nagłówka reklamy.

longHeadline

string

Długi nagłówek reklamy.

description

string

Opis reklamy.

businessName

string

Nazwa firmy w reklamie.

allowFlexibleColor

boolean

zgoda reklamodawcy na wybór dowolnego koloru; Jeśli ma wartość true (prawda), reklama może być wyświetlana w innym kolorze, jeśli zajdzie taka potrzeba. Jeśli wartość to false, reklama będzie wyświetlana w określonych kolorach lub w kolorze neutralnym. Wartością domyślną jest true. Musi mieć wartość Prawda, jeśli wartości mainColoraccentColor nie są ustawione.

accentColor

string

Szesnastkowy kod koloru akcentu reklamy, np. #ffffff dla bieli. Jeśli ustawisz jedną z opcji mainColor lub accentColor, druga z nich będzie też wymagana.

mainColor

string

Szesnastkowy kod głównego koloru reklamy, np. #ffffff dla bieli. Jeśli ustawisz jedną z opcji mainColor lub accentColor, druga z nich będzie też wymagana.

callToActionText

string

Tekst wezwania do działania w reklamie.

logoImage

string

Nazwa zasobu MediaFile zawierającego obraz logo używany w reklamie.

squareLogoImage

string

Nazwa zasobu MediaFile zawierającego kwadratowe logo używane w reklamie.

marketingImage

string

Nazwa zasobu MediaFile obrazu marketingowego użytego w reklamie.

squareMarketingImage

string

Nazwa zasobu MediaFile kwadratowego obrazu marketingowego użytego w reklamie.

pricePrefix

string

Prefiks przed ceną. Na przykład „tak tanio jak”.

promoText

string

tekst promocyjny używany w przypadku dynamicznych formatów elastycznych reklam. Na przykład „Bezpłatna dostawa w ciągu 2 dni”.

DisplayAdFormatSetting

Wylicza ustawienia formatu reklamy displayowej.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
ALL_FORMATS Formaty tekstowe, graficzne i natywne.
NON_NATIVE Formaty tekstu i obrazów.
NATIVE Na przykład format natywny, renderowanie formatu, jest kontrolowane przez wydawcę, a nie przez Google.

AppAdInfo

Reklama aplikacji.

Zapis JSON
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
Pola
mandatoryAdText

object (AdTextAsset)

Obowiązkowy tekst reklamy.

headlines[]

object (AdTextAsset)

Lista komponentów tekstowych nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych do opisów. Gdy reklama się wyświetli, teksty będą wybierane z tej listy.

images[]

object (AdImageAsset)

Lista komponentów graficznych, które mogą się wyświetlać w reklamie.

youtubeVideos[]

object (AdVideoAsset)

Lista komponentów wideo w YouTube, które mogą się wyświetlać razem z reklamą.

html5MediaBundles[]

object (AdMediaBundleAsset)

Lista komponentów pakietu multimediów, które mogą być używane w reklamie.

AdMediaBundleAsset

Zasób pakietu multimedialnego używany w reklamie.

Zapis JSON
{
  "asset": string
}
Pola
asset

string

Nazwa zasobu komponentu w tym pakiecie multimediów.

AdAppDeepLinkAsset

Precyzyjny link do aplikacji użyty w reklamie.

Zapis JSON
{
  "asset": string
}
Pola
asset

string

Nazwa zasobu aplikacji w komponencie precyzyjnego linku do aplikacji.

LegacyAppInstallAdInfo

starsza reklama instalacji aplikacji, której mogą używać tylko wybrani klienci.

Zapis JSON
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Pola
appStore

enum (LegacyAppInstallAdAppStore)

Sklep z aplikacjami, w którym jest dostępna aplikacja mobilna.

appId

string

Identyfikator aplikacji mobilnej.

headline

string

Nagłówek reklamy.

description1

string

Pierwszy wiersz tekstu reklamy.

description2

string

Druga linia tekstu reklamy.

LegacyAppInstallAdAppStore

Typ sklepu z aplikacjami w starszej reklamie promującej instalacje aplikacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Sklep Windows.
WINDOWS_PHONE_STORE Sklep Windows Phone.
CN_APP_STORE Aplikacja jest hostowana w chińskim sklepie z aplikacjami.

ResponsiveDisplayAdInfo

Elastyczna reklama displayowa

Zapis JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Pola
marketingImages[]

object (AdImageAsset)

obrazy marketingowe, które mają być używane w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 314, a współczynnik proporcji musi wynosić 1,91:1 (+-1%). Wymagany jest co najmniej 1 marketingImage. W połączeniu z squareMarketingImages maksymalna liczba to 15.

squareMarketingImages[]

object (AdImageAsset)

Kwadratowe obrazy marketingowe, które mają być używane w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 300 x 300, a proporcje muszą wynosić 1:1 (+-1%). Wymagane jest co najmniej 1 kwadrat marketingImage. W połączeniu z marketingImages maksymalna liczba to 15.

logoImages[]

object (AdImageAsset)

obrazy logo, które będą się wyświetlać w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 512 x 128, a współczynnik proporcji musi wynosić 4:1 (+-1%). W połączeniu z kampanią squareLogoImages maksymalna liczba to 5.

squareLogoImages[]

object (AdImageAsset)

kwadratowe obrazy logo, które będą się wyświetlać w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji musi wynosić 1:1 (+-1%). W połączeniu z kampanią logoImages maksymalna liczba to 5.

headlines[]

object (AdTextAsset)

Nagłówki reklamy w krótkim formacie. Maksymalna długość to 30 znaków. Możesz określić co najmniej 1 i maksymalnie 5 nagłówków.

longHeadline

object (AdTextAsset)

Wymagany długi nagłówek. Maksymalna długość to 90 znaków.

descriptions[]

object (AdTextAsset)

Teksty opisowe reklamy. Maksymalna długość to 90 znaków. Możesz określić co najmniej 1 i maksymalnie 5 nagłówków.

youtubeVideos[]

object (AdVideoAsset)

Opcjonalne filmy w YouTube do reklamy. Możesz określić maksymalnie 5 filmów.

formatSetting

enum (DisplayAdFormatSetting)

Określa format, w którym reklama będzie się wyświetlać. Wartość domyślna to ALL_FORMATS.

controlSpec

object (ResponsiveDisplayAdControlSpec)

Specyfikacja różnych opcji kreacji.

businessName

string

Nazwa reklamodawcy lub marki. Maksymalna szerokość wyświetlacza to 25.

mainColor

string

Szesnastkowy kod głównego koloru reklamy, np. #ffffff dla bieli. Jeśli ustawisz jedną z opcji mainColor lub accentColor, druga z nich będzie też wymagana.

accentColor

string

Szesnastkowy kod koloru akcentu reklamy, np. #ffffff dla bieli. Jeśli ustawisz jedną z opcji mainColor lub accentColor, druga z nich będzie też wymagana.

allowFlexibleColor

boolean

zgoda reklamodawcy na wybór dowolnego koloru; Jeśli ma wartość true (prawda), reklama może być wyświetlana w innym kolorze, jeśli zajdzie taka potrzeba. Jeśli wartość to false, reklama będzie wyświetlana w określonych kolorach lub w kolorze neutralnym. Wartością domyślną jest true. Musi mieć wartość Prawda, jeśli wartości mainColoraccentColor nie są ustawione.

callToActionText

string

Tekst wezwania do działania w reklamie. Maksymalna szerokość wyświetlania to 30.

pricePrefix

string

Prefiks przed ceną. Na przykład „tak tanio jak”.

promoText

string

tekst promocyjny używany w przypadku dynamicznych formatów elastycznych reklam. Na przykład „Bezpłatna dostawa w ciągu 2 dni”.

ResponsiveDisplayAdControlSpec

Specyfikacja różnych ustawień kreacji w elastycznych reklamach displayowych.

Zapis JSON
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Pola
enableAssetEnhancements

boolean

Czy reklamodawca włączył funkcję ulepszania komponentów.

enableAutogenVideo

boolean

Czy reklamodawca korzysta z funkcji automatycznego generowania filmów.

LocalAdInfo

reklama lokalna,

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy. Musisz podać co najmniej 1 i maksymalnie 5 nagłówków.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych do opisów. Gdy reklama się wyświetli, teksty będą wybierane z tej listy. Należy określić co najmniej 1 i maksymalnie 5 tekstów reklamy.

callToActions[]

object (AdTextAsset)

Lista komponentów tekstowych z wezwaniami do działania. Gdy reklama zostanie wyświetlona, wezwania do działania zostaną wybrane z tej listy. Należy określić co najmniej 1 i maksymalnie 5 wezwania do działania.

marketingImages[]

object (AdImageAsset)

Lista komponentów z obrazem marketingowym, które mogą się wyświetlać razem z reklamą. Obrazy muszą mieć wymiary 314 x 600 pikseli lub 320 x 320 pikseli. Musisz określić co najmniej 1 i maksymalnie 20 komponentów z obrazem.

logoImages[]

object (AdImageAsset)

Lista komponentów z obrazem logo, które mogą być wyświetlane w reklamie. Obrazy muszą mieć wymiary 128 x 128 pikseli i nie mogą zajmować więcej niż 120 KB. Musisz określić co najmniej 1 i maksymalnie 5 komponentów z obrazem.

videos[]

object (AdVideoAsset)

Lista komponentów wideo w YouTube, które mogą się wyświetlać razem z reklamą. Musisz określić co najmniej 1 i maksymalnie 20 plików wideo.

path1

string

Pierwszy fragment opcjonalnego tekstu, który można dołączyć do adresu URL w reklamie.

path2

string

Druga część opcjonalnego tekstu, który można dołączyć do adresu URL w reklamie. To pole można ustawić tylko wtedy, gdy path1 jest również ustawione.

DisplayUploadAdInfo

Ogólny typ reklamy displayowej. Dokładny format reklamy jest kontrolowany przez pole displayUploadProductType, które określa, jakie dane muszą się w niej znaleźć.

Zapis JSON
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Pola
displayUploadProductType

enum (DisplayUploadProductType)

Typ produktu tej reklamy. Szczegółowe informacje znajdziesz w komentarzach dotyczących tego typu.

Pole unii media_asset. Dane komponentów tworzących reklamę. media_asset może być tylko jednym z tych elementów:
mediaBundle

object (AdMediaBundleAsset)

Zasób pakietu kreacji multimedialnych do użycia w reklamie. Informacje o pakiecie multimediów HTML5_UPLOAD_AD znajdziesz na stronie https://support.google.com/google-ads/answer/1722096. Pakiety multimediów, które są częścią dynamicznych typów produktów, używają specjalnego formatu, który musi zostać utworzony w Google Web Designer. Więcej informacji znajdziesz na stronie https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

Wypisuje typy produktów do wyświetlania.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
HTML5_UPLOAD_AD Przesyłana reklama HTML5. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD Dynamiczna reklama HTML5: edukacja. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii edukacyjnej.
DYNAMIC_HTML5_FLIGHT_AD Dynamiczna reklama HTML5 dotycząca lotów. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w ramach kampanii z ograniczonym czasem emisji.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Dynamiczna reklama HTML5: hotele i wynajem. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii reklam hoteli.
DYNAMIC_HTML5_JOB_AD Dynamiczna reklama HTML5: oferty pracy. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii o ofercie pracy.
DYNAMIC_HTML5_LOCAL_AD Dynamiczna lokalna reklama HTML5. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii lokalnej.
DYNAMIC_HTML5_REAL_ESTATE_AD Dynamiczna reklama HTML5: nieruchomości. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii dotyczącej nieruchomości.
DYNAMIC_HTML5_CUSTOM_AD Dynamiczna niestandardowa reklama HTML5. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii niestandardowej.
DYNAMIC_HTML5_TRAVEL_AD Dynamiczna reklama HTML5 biura podróży. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii dotyczącej podróży.
DYNAMIC_HTML5_HOTEL_AD Dynamiczna reklama HTML5 hotelu. Ten typ produktu wymaga ustawienia pola upload_media_bundle w pliku DisplayUploadAdInfo. Można go używać tylko w kampanii reklam hoteli.

AppEngagementAdInfo

W reklamach angażujących w aplikację możesz stosować tekst zachęcający do podejmowania określonych działań w aplikacji, takich jak rejestracja, dokonanie zakupu albo zarezerwowanie biletu. Umożliwiają one wysyłanie użytkowników do określonej części aplikacji, w której mogą szybciej i łatwiej znaleźć to, czego szukają.

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych do opisów. Gdy reklama się wyświetli, teksty będą wybierane z tej listy.

images[]

object (AdImageAsset)

Lista komponentów graficznych, które mogą się wyświetlać w reklamie.

videos[]

object (AdVideoAsset)

Lista komponentów wideo, które mogą się wyświetlać w reklamie.

ShoppingComparisonListingAdInfo

Reklama z porównaniem produktów w Zakupach Google

Zapis JSON
{
  "headline": string
}
Pola
headline

string

Nagłówek reklamy. To pole jest wymagane. Dozwolona długość to 25–45 znaków.

AppPreRegistrationAdInfo

Reklamy wstępnej rejestracji aplikacji zawierają link do informacji o grze lub aplikacji w Google Play. Reklamy te mogą się pojawiać w Google Play, YouTube (tylko reklamy In-Stream) oraz w innych aplikacjach i witrynach mobilnych w sieci reklamowej. Pomoże Ci to w zainteresowaniu użytkowników Twoją grą lub aplikacją i zdobędziesz grono odbiorców jeszcze przed jej opublikowaniem.

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych do opisów. Gdy reklama się wyświetli, teksty będą wybierane z tej listy.

images[]

object (AdImageAsset)

Lista identyfikatorów komponentów z obrazem, których obrazy mogą być wyświetlane w reklamie.

youtubeVideos[]

object (AdVideoAsset)

Lista identyfikatorów komponentów filmów w YouTube, które mogą być wyświetlane razem z reklamą.

DemandGenMultiAssetAdInfo

Reklama generująca popyt zawierająca wiele komponentów.

Zapis JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Pola
marketingImages[]

object (AdImageAsset)

komponenty obrazów marketingowych, które mają być używane w reklamie; Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 314, a współczynnik proporcji musi wynosić 1,91:1 (+-1%). Wymagane, jeśli nie ma obrazu squareMarketingImages. W połączeniu z squareMarketingImages, portraitMarketingImages i tallPortraitMarketingImages maksymalna liczba to 20.

squareMarketingImages[]

object (AdImageAsset)

kwadratowe komponenty z obrazem marketingowym, które będą się wyświetlać w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 300 x 300, a proporcje muszą wynosić 1:1 (+-1%). Wymagany, jeśli marketingImages jest pusty. W połączeniu z marketingImages, portraitMarketingImages i tallPortraitMarketingImages maksymalna liczba to 20.

portraitMarketingImages[]

object (AdImageAsset)

Komponenty z obrazem marketingowym w orientacji pionowej do wykorzystania w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 480 x 600, a współczynnik proporcji musi wynosić 4:5 (+-1%). W połączeniu z marketingImages, squareMarketingImages i tallPortraitMarketingImages maksymalna liczba to 20.

tallPortraitMarketingImages[]

object (AdImageAsset)

wysokie obrazy marketingowe w orientacji pionowej, które mają być używane w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 1067, a współczynnik proporcji musi wynosić 9:16 (+-1%). W połączeniu z marketingImages, squareMarketingImages i portraitMarketingImages maksymalna liczba to 20.

logoImages[]

object (AdImageAsset)

Zasoby graficzne logo, które mają być używane w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji musi wynosić 1:1 (+-1%). Można określić co najmniej 1 i maksymalnie 5 obrazów logo.

headlines[]

object (AdTextAsset)

Komponent tekstowy nagłówka reklamy. Maksymalna szerokość wyświetlania to 30. Możesz określić co najmniej 1 i maksymalnie 5 nagłówków.

descriptions[]

object (AdTextAsset)

Tekst reklamy. Maksymalna szerokość wyświetlania to 90. Można określić co najmniej 1 i maksymalnie 5 tekstów reklamy.

businessName

string

Nazwa reklamodawcy lub marki. Maksymalna szerokość wyświetlacza to 25. Wymagany.

callToActionText

string

Tekst wezwania do działania.

leadFormOnly

boolean

Wartość logiczna wskazująca, czy reklama musi być wyświetlana z formularzem kontaktowym.

DemandGenCarouselAdInfo

Reklama karuzelowa generująca popyt

Zapis JSON
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
Pola
businessName

string

Wymagany. Nazwa reklamodawcy lub marki.

logoImage

object (AdImageAsset)

Wymagany. obraz logo, który ma być używany w reklamie. Minimalny rozmiar to 128 x 128, a współczynnik proporcji musi wynosić 1:1 (+-1%).

headline

object (AdTextAsset)

Wymagany. Nagłówek reklamy.

description

object (AdTextAsset)

Wymagany. Tekst reklamy.

callToActionText

string

Tekst wezwania do działania.

carouselCards[]

object (AdDemandGenCarouselCardAsset)

Wymagany. Karty karuzeli, które będą wyświetlane razem z reklamą. Minimalna liczba to 2, a maksymalna – 10.

AdDemandGenCarouselCardAsset

Komponent karty karuzeli generującej popyt użyty w reklamie.

Zapis JSON
{
  "asset": string
}
Pola
asset

string

Nazwa zasobu komponentu karty karuzeli Discovery.

DemandGenVideoResponsiveAdInfo

Reklama wideo generująca popyt w wersji responsywnej.

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych używanych w krótkim nagłówku.

longHeadlines[]

object (AdTextAsset)

Lista komponentów tekstowych użytych w długim nagłówku.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych użytych w opisie.

videos[]

object (AdVideoAsset)

Lista komponentów wideo z YouTube użytych w reklamie.

logoImages[]

object (AdImageAsset)

obraz logo, który ma być używany w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji musi wynosić 1:1 (+-1%).

breadcrumb1

string

Pierwsza część tekstu, która pojawia się w reklamie wraz z wyświetlanym adresem URL.

breadcrumb2

string

Druga część tekstu, która pojawia się w reklamie z wyświetlanym adresem URL.

businessName

object (AdTextAsset)

Wymagany. Nazwa reklamodawcy lub marki.

callToActions[]

object (AdCallToActionAsset)

Komponenty typu CallToActionAsset używane na przycisku „Wezwanie do działania”.

AdCallToActionAsset

Komponent wezwania do działania używany w reklamie.

Zapis JSON
{
  "asset": string
}
Pola
asset

string

Nazwa zasobu komponentu z wezwaniem do działania.

DemandGenProductAdInfo

Reklama produktowa generująca popyt

Zapis JSON
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
Pola
breadcrumb1

string

Pierwsza część tekstu, która pojawia się w reklamie wraz z wyświetlanym adresem URL.

breadcrumb2

string

Druga część tekstu, która pojawia się w reklamie z wyświetlanym adresem URL.

businessName

object (AdTextAsset)

Wymagany. Nazwa reklamodawcy lub marki.

headline

object (AdTextAsset)

Wymagany. Komponent tekstowy używany do krótkiego nagłówka.

description

object (AdTextAsset)

Wymagany. Komponent tekstowy użyty w opisie.

logoImage

object (AdImageAsset)

Wymagany. obraz logo, który ma być używany w reklamie. Prawidłowe typy obrazów to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji musi wynosić 1:1 (+-1%).

callToAction

object (AdCallToActionAsset)

Komponent typu „CallToActionAsset” używany na przycisku „Wezwanie do działania”.

TravelAdInfo

Ten typ nie ma pól.

Reklama dotycząca podróży.