- Zasób: Reklama
- FinalAppUrl:
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- Urządzenie
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList.
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintList
- CountryConstraint (Ograniczenia kraju)
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- TravelAdInfo
- Metody
Zasób: Reklama
Reklamą.
Zapis JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
Pola | |
---|---|
resourceName |
Stałe. Nazwa zasobu reklamy. Nazwy zasobów reklamowych mają postać:
|
finalUrls[] |
Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami w reklamie. |
finalAppUrls[] |
Lista końcowych adresów URL aplikacji, które będą używane na urządzeniu mobilnym, jeśli użytkownik ma zainstalowaną określoną aplikację. |
finalMobileUrls[] |
Lista możliwych końcowych adresów URL dla urządzeń mobilnych po wszystkich przekierowaniach między domenami w przypadku reklamy. |
urlCustomParameters[] |
Lista mapowań, których można używać do zastępowania tagów parametrów niestandardowych w tagach |
type |
Tylko dane wyjściowe. Typ reklamy. |
devicePreference |
Preferowane urządzenia dla reklamy. To ustawienie możesz określić tylko dla urządzeń mobilnych. Gdy to ustawienie jest włączone, reklama podczas wyświetlania na urządzeniu mobilnym ma pierwszeństwo przed innymi reklamami. Reklama może się nadal wyświetlać na urządzeniach innych typów, np. wtedy, gdy nie są dostępne żadne inne reklamy. Jeśli nie określisz tego ustawienia (brak ustawienia urządzenia), kierowanie będzie na niego kierowane na wszystkie urządzenia. Ta opcja jest obsługiwana tylko przez niektóre typy reklam. |
urlCollections[] |
Dodatkowe adresy URL reklamy, które są oznaczone unikalnym identyfikatorem, do którego można się odwoływać z innych pól w reklamie. |
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 |
Tylko dane wyjściowe. Identyfikator reklamy. |
trackingUrlTemplate |
Szablon adresu URL służący do tworzenia linku monitorującego. |
finalUrlSuffix |
Sufiks, którego należy użyć podczas tworzenia końcowego adresu URL. |
displayUrl |
Adres URL widoczny w tekście reklamy w przypadku niektórych formatów reklam. |
addedByGoogleAds |
Tylko dane wyjściowe. Wskazuje, czy reklama została automatycznie dodana przez Google Ads, a nie przez użytkownika. Może się tak zdarzyć, jeśli reklamy są tworzone automatycznie jako propozycje nowych reklam na podstawie informacji o skuteczności dotychczasowych reklam. |
name |
Stałe. Nazwa reklamy. Dane te służą tylko do identyfikacji reklamy. Nie musi być niepowtarzalna i nie ma wpływu na wyświetlaną reklamę. Pole nazwy jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd. |
Pole sumy ad_data . Szczegóły dotyczące typu reklamy. Musisz ustawić dokładnie jedną wartość. ad_data może być tylko jedną z tych wartości: |
|
textAd |
Stałe. Szczegóły dotyczące reklamy tekstowej. |
expandedTextAd |
Szczegóły dotyczące rozszerzonej reklamy tekstowej. |
callAd |
Szczegóły dotyczące reklamy generującej połączenia. |
expandedDynamicSearchAd |
Stałe. Szczegóły dotyczące rozszerzonej dynamicznej reklamy w wyszukiwarce. Ten typ reklamy ma nagłówek oraz końcowe i wyświetlany adres URL generowane automatycznie podczas wyświetlania zgodnie z informacjami dotyczącymi nazwy domeny podanymi przez usługę |
hotelAd |
Szczegóły dotyczące reklamy hotelu. |
shoppingSmartAd |
Szczegóły dotyczące inteligentnej reklamy produktowej. |
shoppingProductAd |
Szczegóły dotyczące reklamy produktowej. |
imageAd |
Stałe. Szczegóły dotyczące reklamy graficznej. |
videoAd |
Szczegóły dotyczące reklamy wideo. |
videoResponsiveAd |
Szczegóły dotyczące elastycznej reklamy wideo. |
responsiveSearchAd |
Szczegóły elastycznej reklamy w wyszukiwarce. |
legacyResponsiveDisplayAd |
Szczegóły dotyczące starszej elastycznej reklamy displayowej. |
appAd |
Szczegóły reklamy aplikacji. |
legacyAppInstallAd |
Stałe. Szczegóły dotyczące starszej reklamy promującej instalacje aplikacji. |
responsiveDisplayAd |
Szczegóły elastycznej reklamy displayowej. |
localAd |
Szczegóły dotyczące reklamy lokalnej. |
displayUploadAd |
Szczegóły dotyczące przesyłanej reklamy displayowej. |
appEngagementAd |
Szczegóły reklamy angażującej w aplikację. |
shoppingComparisonListingAd |
Szczegóły dotyczące reklamy z porównaniem produktów. |
smartCampaignAd |
Szczegóły dotyczące reklamy z kampanii inteligentnej. |
appPreRegistrationAd |
Szczegóły dotyczące reklamy promującej wcześniejszą rejestrację na aplikację. |
discoveryMultiAssetAd |
Szczegóły dotyczące reklamy Discovery z wieloma komponentami. |
discoveryCarouselAd |
Szczegóły reklamy karuzelowej Discovery. |
discoveryVideoResponsiveAd |
Szczegóły dotyczące elastycznej reklamy wideo Discovery. |
travelAd |
Szczegóły dotyczące reklamy biura podróży. |
FinalAppUrl
Adres URL precyzyjnych linków do aplikacji w danym systemie operacyjnym.
Zapis JSON |
---|
{
"osType": enum ( |
Pola | |
---|---|
osType |
System operacyjny, na który kierowany jest ten adres URL. To pole jest wymagane. |
url |
URL precyzyjnego linku do aplikacji. Precyzyjne linki określają lokalizację w aplikacji odpowiadającą treści, którą chcesz wyświetlać. Schemat powinien mieć postać {schemat}://{ścieżka_hosta}. Schemat wskazuje, którą aplikację należy otworzyć. W przypadku swojej aplikacji możesz użyć schematu niestandardowego, który zaczyna się od jej nazwy. Host i ścieżka określają unikalną lokalizację Twojej treści w aplikacji. Przykład: „przykladowaaplikacja://identyfikatorproduktu_1234”. To pole jest wymagane. |
AppUrlOperatingSystemType
System operacyjny
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
IOS |
System operacyjny Apple iOS. |
ANDROID |
System operacyjny Android. |
CustomParameter
Mapowanie, którego można używać przez tagi parametrów niestandardowych w obrębie trackingUrlTemplate
, finalUrls
lub mobile_final_urls
.
Zapis JSON |
---|
{ "key": string, "value": string } |
Pola | |
---|---|
key |
Klucz pasujący do nazwy tagu parametru. |
value |
Wartość do zastąpienia. |
AdType
Możliwe typy reklamy.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
TEXT_AD |
Jest to reklama tekstowa. |
EXPANDED_TEXT_AD |
Jest to rozszerzona reklama tekstowa. |
EXPANDED_DYNAMIC_SEARCH_AD |
Reklama jest rozszerzoną dynamiczną reklamą w wyszukiwarce. |
HOTEL_AD |
Reklama to reklama hotelu. |
SHOPPING_SMART_AD |
To inteligentna reklama produktowa. |
SHOPPING_PRODUCT_AD |
To standardowa reklama produktowa. |
VIDEO_AD |
Jest to reklama wideo. |
IMAGE_AD |
Ta reklama jest reklamą graficzną. |
RESPONSIVE_SEARCH_AD |
Jest to elastyczna reklama w wyszukiwarce. |
LEGACY_RESPONSIVE_DISPLAY_AD |
To starsza, elastyczna reklama displayowa. |
APP_AD |
Reklama jest reklamą aplikacji. |
LEGACY_APP_INSTALL_AD |
To starsza reklama promująca instalacje aplikacji. |
RESPONSIVE_DISPLAY_AD |
Jest to elastyczna reklama displayowa. |
LOCAL_AD |
Jest to reklama lokalna. |
HTML5_UPLOAD_AD |
Jest to reklama displayowa z typem produktu HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
Jest to reklama displayowa przesyłana 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_OUTSTREAM_AD |
Reklama wideo Out-Stream. |
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. |
DISCOVERY_MULTI_ASSET_AD |
Reklama Discovery z wieloma zasobami. |
DISCOVERY_CAROUSEL_AD |
Reklama karuzelowa Discovery. |
TRAVEL_AD |
Reklama dotycząca podróży. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Elastyczna reklama wideo Discovery. |
Urządzenie
Określa urządzenia Google Ads, na które można kierować reklamy.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
MOBILE |
Komórki wyposażone w przeglądarkę z pełną funkcjonalnością. |
TABLET |
Tablety wyposażone w przeglądarkę z pełną funkcjonalnością. |
DESKTOP |
Komputery. |
CONNECTED_TV |
Telewizory smart TV i konsole do gier |
OTHER |
Inne typy urządzeń. |
UrlCollection
Zbiór adresów URL otagowanych unikalnym identyfikatorem.
Zapis JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
Pola | |
---|---|
finalUrls[] |
Lista możliwych końcowych adresów URL. |
finalMobileUrls[] |
Lista możliwych końcowych adresów URL na urządzenia mobilne. |
urlCollectionId |
Unikalny identyfikator tej instancji UrlCollection. |
trackingUrlTemplate |
Szablon URL do tworzenia linku monitorującego. |
SystemManagedResourceSource
Lista Enum zawierająca listę możliwych źródeł encji zarządzanych przez system.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AD_VARIATIONS |
Wygenerowana reklama eksperymentalna z odmianami reklamy. |
TextAdInfo
Reklama tekstowa.
Zapis JSON |
---|
{ "headline": string, "description1": string, "description2": string } |
Pola | |
---|---|
headline |
Nagłówek reklamy. |
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
ExpandedTextAdInfo
Rozszerzona reklama tekstowa.
Zapis JSON |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
Pola | |
---|---|
headlinePart1 |
Pierwsza część nagłówka reklamy. |
headlinePart2 |
Druga część nagłówka reklamy. |
headlinePart3 |
Trzecia część nagłówka reklamy. |
description |
Opis reklamy. |
description2 |
Drugi tekst reklamy. |
path1 |
Tekst, który może się wyświetlać obok wyświetlanego adresu URL reklamy. |
path2 |
Dodatkowy tekst, który może pojawić się 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 ( |
Pola | |
---|---|
countryCode |
Kod kraju w reklamie. |
phoneNumber |
Numer telefonu w reklamie. |
businessName |
Nazwa firmy w reklamie. |
headline1 |
Pierwszy nagłówek reklamy. |
headline2 |
Drugi nagłówek reklamy. |
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
callTracked |
Określa, czy włączyć śledzenie połączeń dla kreacji. Włączenie śledzenia połączeń powoduje też włączenie konwersji telefonicznych. |
disableCallConversion |
Określa, czy chcesz wyłączyć konwersje telefoniczne dla kreacji. Jeśli zasada ma wartość |
phoneNumberVerificationUrl |
Adres URL do weryfikacji numeru telefonu. |
conversionAction |
Działanie powodujące konwersję, do którego przypisać konwersję telefoniczną. Jeśli zasada jest nieskonfigurowana, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy |
conversionReportingState |
Działanie konwersji telefonicznej w przypadku tej reklamy generującej połączenia. Może używać własnego ustawienia konwersji telefonicznych, dziedziczyć ustawienie z poziomu konta albo być wyłączona. |
path1 |
Pierwsza część tekstu, którą można dołączyć do adresu URL w reklamie. Opcjonalnie. |
path2 |
Druga część tekstu, którą można dołączyć do adresu URL w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiono też |
CallConversionReportingState
Możliwe typy danych dla stanu działania powodującego konwersję telefoniczną.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
DISABLED |
Działanie powodujące konwersję telefoniczną jest wyłączone. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
Działanie powodujące konwersję telefoniczną będzie korzystać z typu konwersji telefonicznej ustawionego na poziomie konta. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
Działanie powodujące konwersję telefoniczną będzie korzystać z typu konwersji telefonicznej określonego na poziomie zasobu (reklamy typu „tylko połączenie” lub rozszerzenia połączeń). |
ExpandedDynamicSearchAdInfo
Rozszerzona dynamiczna reklama w wyszukiwarce.
Zapis JSON |
---|
{ "description": string, "description2": string } |
Pola | |
---|---|
description |
Opis reklamy. |
description2 |
Drugi tekst reklamy. |
HotelAdInfo
Ten typ nie ma żadnych pól.
Reklama hotelu.
ShoppingSmartAdInfo
Ten typ nie ma żadnych pól.
Inteligentna reklama produktowa.
ShoppingProductAdInfo
Ten typ nie ma żadnych pól.
Standardowa reklama produktowa.
ImageAdInfo
Reklama graficzna.
Zapis JSON |
---|
{ "mimeType": enum ( |
Pola | |
---|---|
mimeType |
Typ MIME obrazu. |
pixelWidth |
Szerokość obrazu w pełnym rozmiarze w pikselach. |
pixelHeight |
Wysokość obrazu w pełnym rozmiarze (w pikselach). |
imageUrl |
Adres URL obrazu w pełnym rozmiarze. |
previewPixelWidth |
Szerokość obrazu rozmiaru podglądu w pikselach. |
previewPixelHeight |
Wysokość obrazu rozmiaru podglądu w pikselach. |
previewImageUrl |
Adres URL obrazu rozmiaru podglądu. |
name |
Nazwa obrazu. Jeśli obraz został utworzony na podstawie elementu MediaFile, jest to nazwa elementu MediaFile. Jeśli obraz został utworzony z bajtów, to pole jest puste. |
Pole sumy image . Obraz, na podstawie którego ma zostać utworzona reklama graficzna. Można to określić na 2 sposoby. 1. Istniejący zasób MediaFile. 2. Nieprzetworzone dane obrazu w postaci bajtów. image może być tylko jedną z tych wartości: |
|
imageAsset |
Komponenty z obrazem użyte w reklamie. |
data |
Nieprzetworzone dane obrazu w bajtach. Ciąg zakodowany w standardzie base64. |
adIdToCopyImageFrom |
Identyfikator reklamy, z której chcesz skopiować obraz. |
MimeType
typ MIME.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Typ MIME nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
IMAGE_JPEG |
Typ MIME obrazu/jpeg. |
IMAGE_GIF |
Typ MIME obrazu/GIF-a. |
IMAGE_PNG |
Typ MIME obrazu/png. |
FLASH |
Typ MIME pliku application/x-shockwave-flash. |
TEXT_HTML |
Typ MIME pliku text/html. |
PDF |
Typ MIME aplikacji/pdf. |
MSWORD |
Typ MIME aplikacji/msword. |
MSEXCEL |
Typ MIME pliku application/vnd.ms-excel. |
RTF |
Typ MIME pliku application/rtf. |
AUDIO_WAV |
Typ MIME pliku audio/WAV. |
AUDIO_MP3 |
Typ MIME pliku audio/mp3. |
HTML5_AD_ZIP |
Typ MIME pliku application/x-html5-ad-zip. |
AdImageAsset
Komponent z obrazem używany w reklamie.
Zapis JSON |
---|
{ "asset": string } |
Pola | |
---|---|
asset |
Nazwa zasobu danego obrazu. |
VideoAdInfo
Reklama wideo.
Zapis JSON |
---|
{ "video": { object ( |
Pola | |
---|---|
video |
Komponenty wideo w YouTube użyte w reklamie. |
Pole sumy format . Schemat dla różnych formatów wideo. format może być tylko jedną z tych wartości: |
|
inStream |
Format reklamy wideo TrueView In-Stream. |
bumper |
Format reklamy In-Stream w bumperze wideo. |
outStream |
Format reklamy wideo Out-Stream. |
nonSkippable |
Format reklamy wideo In-Stream niemożliwej do pominięcia. |
inFeed |
Format reklamy wideo In-Feed. |
AdVideoAsset
Komponent wideo używany w reklamie.
Zapis JSON |
---|
{ "asset": string } |
Pola | |
---|---|
asset |
Nazwa zasobu tego filmu. |
VideoTrueViewInStreamAdInfo
Prezentacja formatu reklamy wideo TrueView In-Stream (reklamy wyświetlanej podczas odtwarzania filmu, często na początku, a po kilku sekundach odtwarzania pojawia się przycisk pominięcia).
Zapis JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
Pola | |
---|---|
actionButtonLabel |
Etykieta przycisku wezwania do działania, który przekierowuje użytkownika do końcowego adresu URL reklamy wideo. Wymagane w kampaniach TrueView zachęcających do działania. W przeciwnym razie są opcjonalne. |
actionHeadline |
Dodatkowy tekst z przyciskiem wezwania do działania, który informuje o kontekście i zachęca do kliknięcia przycisku. |
companionBanner |
Komponenty z obrazem banera towarzyszącego użyte w reklamie. |
VideoBumperInStreamAdInfo
Reprezentacja formatu bumpera reklamowego wideo In-Stream (bardzo krótka reklama wideo In-Stream niemożliwa do pominięcia).
Zapis JSON |
---|
{
"companionBanner": {
object ( |
Pola | |
---|---|
companionBanner |
Komponenty z obrazem banera towarzyszącego użyte w reklamie. |
actionButtonLabel |
Etykieta przycisku „Wezwanie do działania”, która przekierowuje użytkownika do końcowego adresu URL reklamy wideo. |
actionHeadline |
Dodatkowy tekst z przyciskiem wezwania do działania, który informuje o kontekście i zachęca do kliknięcia przycisku. |
VideoOutstreamAdInfo
Reprezentacja formatu reklamy wideo typu Out-Stream (reklama wyświetlana obok kanału z automatycznym odtwarzaniem bez dźwięku).
Zapis JSON |
---|
{ "headline": string, "description": string } |
Pola | |
---|---|
headline |
Nagłówek reklamy. |
description |
Linia tekstu. |
VideoNonSkippableInStreamAdInfo
Prezentacja formatu reklamy In-Stream niemożliwej do pominięcia (15-sekundowa reklama wideo In-Stream niemożliwa do pominięcia).
Zapis JSON |
---|
{
"companionBanner": {
object ( |
Pola | |
---|---|
companionBanner |
Komponenty z obrazem banera towarzyszącego użyte w reklamie. |
actionButtonLabel |
Etykieta przycisku „Wezwanie do działania”, która przekierowuje użytkownika do końcowego adresu URL reklamy wideo. |
actionHeadline |
Dodatkowy tekst z przyciskiem „Wezwanie do działania”, który informuje o kontekście i zachęca do kliknięcia przycisku. |
InFeedVideoAdInfo
Przedstawienie formatu reklam wideo In-Feed.
Zapis JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
Pola | |
---|---|
headline |
Nagłówek reklamy. |
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
thumbnail |
Obraz miniatury filmu do użycia. |
VideoThumbnail
Wymienia listę możliwych typów miniatur filmu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono typu. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
DEFAULT_THUMBNAIL |
Domyślna miniatura. Mogą być generowane automatycznie lub przesłane przez użytkownika. |
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 ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych używanych w krótkim nagłówku. Obecnie obsługiwana jest tylko jedna wartość krótkiego nagłówka. |
longHeadlines[] |
Lista komponentów tekstowych używanych w długim nagłówku. Obecnie obsługiwana jest tylko jedna wartość dla długiego nagłówka. |
descriptions[] |
Lista komponentów tekstowych użytych w tekście reklamy. Obecnie obsługiwana jest tylko jedna wartość opisu. |
callToActions[] |
Lista komponentów tekstowych użytych w przypadku tego przycisku, np. przycisku „Wezwanie do działania”. Obecnie obsługiwana jest tylko jedna wartość przycisku. |
videos[] |
Lista komponentów wideo w YouTube użytych w reklamie. Obecnie obsługiwana jest tylko jedna wartość dla zasobu wideo w YouTube. |
companionBanners[] |
Lista komponentów z obrazem użytych w banerze towarzyszącym. Obecnie obsługiwana jest tylko jedna wartość zasobu banera towarzyszącego. |
breadcrumb1 |
Pierwsza część tekstu pojawiającego się w reklamie razem z wyświetlanym adresem URL. |
breadcrumb2 |
Druga część tekstu pojawiająca się w reklamie razem z wyświetlanym adresem URL. |
AdTextAsset
Komponent tekstowy używany w reklamie.
Zapis JSON |
---|
{ "pinnedField": enum ( |
Pola | |
---|---|
pinnedField |
Przypięte pole zasobu. Dzięki temu komponent będzie wyświetlany tylko w tym polu. Do tego samego pola można przypiąć wiele zasobów. Komponent, który jest przypięty lub przypięty do innego pola, nie będzie się wyświetlać w polu, w którym przypięto inny komponent. |
assetPerformanceLabel |
Etykieta skuteczności zasobu tekstowego. |
policySummaryInfo |
Podsumowanie zasad dotyczących tego komponentu tekstowego. |
text |
Tekst komponentu. |
ServedAssetFieldType
Możliwe typy pól zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
HEADLINE_1 |
Komponent jest używany w nagłówku 1. |
HEADLINE_2 |
Komponent jest używany w nagłówku 2. |
HEADLINE_3 |
Komponent jest używany w nagłówku 3. |
DESCRIPTION_1 |
Zasób jest używany w tekście reklamy 1. |
DESCRIPTION_2 |
Zasób jest używany w tekście reklamy 2. |
HEADLINE |
Komponent został użyty w nagłówku. Używaj jej tylko wtedy, gdy reklama ma tylko 1 nagłówek. W przeciwnym razie użyj wyliczeń HEADLINE_1, HEADLINE_2 lub HEADLINE_3 |
HEADLINE_IN_PORTRAIT |
Komponent był używany jako nagłówek w obrazie pionowym. |
LONG_HEADLINE |
Komponent został użyty w długim nagłówku (w reklamie MultiAssetelastycznie). |
DESCRIPTION |
Zasób został użyty w tekście reklamy. Używaj jej tylko wtedy, gdy w reklamie jest tylko 1 tekst reklamy. W przeciwnym razie użyj wyliczeń DESCRIPTION_1 lub DESCRIPTION_@ |
DESCRIPTION_IN_PORTRAIT |
Komponent został użyty jako tekst reklamy w orientacji pionowej. |
BUSINESS_NAME_IN_PORTRAIT |
Komponent został użyty jako nazwa firmy w obrazie pionowym. |
BUSINESS_NAME |
Komponent służył jako nazwa firmy. |
MARKETING_IMAGE |
Komponent został użyty jako obraz marketingowy. |
MARKETING_IMAGE_IN_PORTRAIT |
Komponent został użyty jako obraz marketingowy w orientacji pionowej. |
SQUARE_MARKETING_IMAGE |
Komponent został użyty jako kwadratowy obraz marketingowy. |
PORTRAIT_MARKETING_IMAGE |
Komponent został użyty jako pionowy obraz marketingowy. |
LOGO |
Zasób był używany jako logo. |
LANDSCAPE_LOGO |
Zasób był używany jako logo w orientacji poziomej. |
CALL_TO_ACTION |
Komponent został użyty jako wezwanie do działania. |
YOU_TUBE_VIDEO |
Zasób był używany jako film w YouTube. |
SITELINK |
Ten komponent jest używany jako link do podstrony. |
CALL |
Ten komponent jest używany jako połączenie. |
MOBILE_APP |
Ten komponent jest używany jako aplikacja mobilna. |
CALLOUT |
Ten komponent jest używany jako objaśnienie. |
STRUCTURED_SNIPPET |
Ten komponent jest używany jako rozszerzenie informacji. |
PRICE |
Ten komponent jest używany jako cena. |
PROMOTION |
Ten komponent jest używany jako promocja. |
AD_IMAGE |
Ten komponent jest używany jako obraz. |
LEAD_FORM |
Komponent jest używany jako formularz kontaktowy. |
BUSINESS_LOGO |
Komponent służy jako logo firmy. |
AssetPerformanceLabel
Wartość Enum opisująca możliwe etykiety wydajności zasobu, zwykle obliczane w kontekście połączenia.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
PENDING |
Ten komponent nie zawiera jeszcze żadnych informacji o skuteczności. Być może jest ona w trakcie sprawdzania. |
LEARNING |
Komponent zaczął uzyskiwać wyświetlenia, ale statystyki nie są wystarczająco istotne statystycznie, aby otrzymać etykietę skuteczności. |
LOW |
Najmniej skuteczne komponenty. |
GOOD |
Komponenty o dobrej skuteczności. |
BEST |
Najskuteczniejsze komponenty. |
AdAssetPolicySummary
Zawiera informacje o zasadach dotyczących komponentu w reklamie.
Zapis JSON |
---|
{ "policyTopicEntries": [ { object ( |
Pola | |
---|---|
policyTopicEntries[] |
Lista wyników dotyczących zasad dla tego zasobu. |
reviewStatus |
W którym miejscu w procesie weryfikacji ten komponent |
approvalStatus |
Ogólny stan zatwierdzenia danego zasobu, obliczany na podstawie stanu poszczególnych wpisów tematu zasad. |
PolicyTopicEntry
wyniki dotyczące zasad dołączone do zasobu (np. zasady dotyczące alkoholu na stronie, która sprzedaje alkohol).
Każdy PolicyTopicEntry ma temat, który wskazuje określoną zasadę dotyczącą reklam związaną z danym wpisem oraz typ, który określa wpływ wpisu na wyświetlanie. Opcjonalnie może zawierać co najmniej 1 dowody wskazujące przyczynę danego wyniku. Może też opcjonalnie zawierać jedno lub więcej ograniczeń ze szczegółowymi informacjami na temat ograniczenia wyświetlania.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Opisuje negatywny lub pozytywny wpływ tej zasady na wyświetlanie reklam. |
evidences[] |
dodatkowe informacje wyjaśniające wynik wyszukiwania zasad (np. nazwa marki w przypadku wyniku wyszukiwania); |
constraints[] |
Określa, jak może to wpłynąć na wyświetlanie tego zasobu (np. nie jest on wyświetlany w danym kraju). |
topic |
Temat dotyczący zasad, do którego odnosi się ten wynik. Na przykład „ALCOHOL”, „TRADEMARKS_IN_AD_TEXT” lub „DESTINATION_NOT_WORKING”. Zestaw możliwych tematów zasad nie jest ustalony dla konkretnej wersji interfejsu API i może się zmienić w dowolnym momencie. |
PolicyTopicEntryType
Możliwe typy wpisów tematu zasad.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
PROHIBITED |
Zasób nie będzie udostępniany. |
LIMITED |
W pewnych okolicznościach zasób nie będzie udostępniany. |
FULLY_LIMITED |
Zasób w ogóle nie może się wyświetlać z powodu bieżących kryteriów kierowania. |
DESCRIPTIVE |
Może Cię zainteresować, ale nie ogranicza sposobu udostępniania zasobu. |
BROADENING |
Pokrycie może wykraczać poza normę. |
AREA_OF_INTEREST_ONLY |
Oferta jest ograniczona we wszystkich krajach docelowych, ale może być wyświetlana w innych krajach zgodnie z obszarami zainteresowań. |
PolicyTopicEvidence
Dodatkowe informacje wyjaśniające wynik dotyczący zasad.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy value . informacje o konkretnych dowodach w zależności od typu dowodu; value może być tylko jedną z tych wartości: |
|
websiteList |
Lista stron internetowych połączonych z tym zasobem. |
textList |
Lista dowodów znalezionych w tekście zasobu. |
languageCode |
Język, w którym został wykryty zasób. Jest to tag języka IETF, taki jak „pl-PL”. |
destinationTextList |
Tekst w miejscu docelowym zasobu, który powoduje znalezienie zasady. |
destinationMismatch |
Niezgodność między miejscami docelowymi adresów URL zasobów. |
destinationNotWorking |
Szczegółowe informacje o tym, że miejsce docelowe zwraca kod błędu HTTP lub nie działa w niektórych lokalizacjach na popularnych urządzeniach. |
WebsiteList
Lista witryn, które spowodowały wynik dotyczący zgodności z zasadami. Używana np. w przypadku tematu zasad ONE_WEBSITE_PER_AD_GROUP. Jeśli masz więcej niż 5 witryn, tutaj wymieniona będzie tylko 5 najlepszych (te najczęściej wyświetlane w zasobach).
Zapis JSON |
---|
{ "websites": [ string ] } |
Pola | |
---|---|
websites[] |
Witryny, w których wystąpił problem dotyczący zasad. |
TextList
Lista fragmentów tekstu, które naruszają zasady.
Zapis JSON |
---|
{ "texts": [ string ] } |
Pola | |
---|---|
texts[] |
Fragmenty tekstu z zasobu, które spowodowały znalezienie zasady. |
DestinationTextList
Lista ciągów tekstowych znalezionych na stronie docelowej, które spowodowały wynik dotyczący zasad.
Zapis JSON |
---|
{ "destinationTexts": [ string ] } |
Pola | |
---|---|
destinationTexts[] |
Lista tekstu znalezionego na stronie docelowej zasobu. |
DestinationMismatch
Dowody na niezgodności między adresami URL zasobu.
Zapis JSON |
---|
{
"urlTypes": [
enum ( |
Pola | |
---|---|
urlTypes[] |
Zbiór adresów URL, które nie pasowały do siebie. |
PolicyTopicEvidenceDestinationMismatchUrlType
Możliwe dowody na to, że dany temat zasad jest niezgodny z typami adresów URL docelowych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
DISPLAY_URL |
Wyświetlany adres URL. |
FINAL_URL |
Końcowy URL. |
FINAL_MOBILE_URL |
Końcowy mobilny adres URL. |
TRACKING_URL |
Szablon linku monitorującego z podanym adresem URL na komputery. |
MOBILE_TRACKING_URL |
Szablon linku monitorującego z podstawionym mobilnym adresem URL. |
DestinationNotWorking
Szczegóły dowody na to, że miejsce docelowe zwraca kod błędu HTTP lub nie działa w niektórych lokalizacjach na często używanych urządzeniach.
Zapis JSON |
---|
{ "device": enum ( |
Pola | |
---|---|
device |
Typ urządzenia, na którym nie udało się wczytać adresu URL. |
expandedUrl |
Pełny adres URL, który nie zadziałał. |
lastCheckedDateTime |
Czas ostatniego sprawdzenia adresu URL. Format to „RRRR-MM-DD GG:MM:SS”. Przykłady: „2018-03-05 09:15:00” lub „2018-02-01 14:34:30”. |
Pole sumy reason . Wskazuje przyczynę wyniku dotyczącego zasady DESTINATION_NOT_WORKING. reason może być tylko jedną z tych wartości: |
|
dnsErrorType |
Typ błędu DNS. |
httpErrorCode |
Kod błędu HTTP. |
PolicyTopicEvidenceDestinationNotWorkingDevice
Możliwe, że miejsce docelowe zasad dotyczących tematu zasad nie działa.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
DESKTOP |
Strona docelowa nie działa na komputerach. |
ANDROID |
Strona docelowa nie działa na urządzeniu z Androidem. |
IOS |
Strona docelowa nie działa na urządzeniu z iOS. |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
Możliwe, że miejsce docelowe dowodów dotyczących tematu zasad nie działa poprawnie.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
HOSTNAME_NOT_FOUND |
Podczas pobierania strony docelowej nie znaleziono nazwy hosta w DNS. |
GOOGLE_CRAWLER_DNS_ISSUE |
Wewnętrzny problem z robotem Google podczas komunikacji z DNS. Ten błąd nie oznacza, że strona docelowa nie działa. Google ponownie zindeksuje stronę docelową. |
PolicyTopicConstraint
Opisuje wpływ wpisu tematu zasad na wyświetlanie.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy value . Szczegółowe informacje o ograniczeniu. value może być tylko jedną z tych wartości: |
|
countryConstraintList |
Kraje, w których zasób nie może być wyświetlany. |
resellerConstraint |
Ograniczenie dotyczące sprzedawcy. |
certificateMissingInCountryList |
Kraje, w których do wyświetlania reklam wymagany jest certyfikat. |
certificateDomainMismatchInCountryList |
Kraje, w których domena zasobu nie jest objęta powiązanymi z nim certyfikatami. |
CountryConstraintList
Lista krajów, w których udostępnianie zasobu jest ograniczone.
Zapis JSON |
---|
{
"countries": [
{
object ( |
Pola | |
---|---|
countries[] |
Kraje, w których wyświetlanie jest ograniczone. |
totalTargetedCountries |
Łączna liczba krajów, na które kierowany jest zasób. |
CountryConstraint
Wskazuje, że możliwość wyświetlania zasobu w danym kraju jest ograniczona.
Zapis JSON |
---|
{ "countryCriterion": string } |
Pola | |
---|---|
countryCriterion |
Nazwa stałego zasobu kierowania geograficznego w kraju, w którym wyświetlanie jest ograniczone. |
ResellerConstraint
Ten typ nie ma żadnych pól.
Wskazuje, że dany temat związany z zasadami został ograniczony z powodu odrzucenia witryny ze względu na sprzedawcę.
PolicyReviewStatus
Możliwe stany weryfikacji zgodności z zasadami.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
REVIEW_IN_PROGRESS |
W trakcie sprawdzania. |
REVIEWED |
Podstawowa weryfikacja została zakończona. Inne kontrole mogą być nadal sprawdzane. |
UNDER_APPEAL |
Zasób został ponownie przesłany do zatwierdzenia lub złożono odwołanie od jego decyzji w sprawie zgodności z zasadami. |
ELIGIBLE_MAY_SERVE |
Zasób jest odpowiedni i może wyświetlać reklamy, ale nadal może zostać dokładniej sprawdzony. |
PolicyApprovalStatus
Możliwe stany zatwierdzenia zasad. Jeśli dostępnych jest kilka stanów zatwierdzenia, zastosowany zostanie ten najpoważniejszy. Kolejność ważności: DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED i APPROVED.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
DISAPPROVED |
Nie będzie się wyświetlać. |
APPROVED_LIMITED |
Wyświetlanie z ograniczeniami. |
APPROVED |
Wyświetla się bez ograniczeń. |
AREA_OF_INTEREST_ONLY |
Nie będą wyświetlać reklam w krajach docelowych, ale mogą być wyświetlane użytkownikom wyszukującym informacje o krajach docelowych. |
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 Ci 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, aby 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 na stronie https://support.google.com/google-ads/answer/7684791.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy. |
descriptions[] |
Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy. |
path1 |
Pierwsza część tekstu, którą można dołączyć do adresu URL w reklamie. |
path2 |
Druga część tekstu, którą można dołączyć do adresu URL w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiono też |
LegacyResponsiveDisplayAdInfo
Starsza elastyczna reklama displayowa. Reklamy tego typu są oznaczone w interfejsie Google Ads jako „Reklamy elastyczne”.
Zapis JSON |
---|
{
"formatSetting": enum ( |
Pola | |
---|---|
formatSetting |
Określa format, w jakim reklama będzie wyświetlana. Wartość domyślna to ALL_FORMATS. |
shortHeadline |
Krótka wersja nagłówka reklamy. |
longHeadline |
Długa wersja nagłówka reklamy. |
description |
Opis reklamy. |
businessName |
Nazwa firmy w reklamie. |
allowFlexibleColor |
Zgoda reklamodawcy na wybór dowolnego koloru. Jeśli ma wartość true (prawda), reklama może w razie potrzeby być wyświetlana w innym kolorze. Jeśli ustawisz wartość false (fałsz), reklama będzie wyświetlana w określonych kolorach lub w neutralnym kolorze. Wartością domyślną jest |
accentColor |
Kolor uzupełniający reklamy w postaci liczby szesnastkowej, np. #FF w przypadku białego koloru. Jeśli wartość |
mainColor |
Główny kolor reklamy w zapisie szesnastkowym, np. #FF w przypadku białego koloru. Jeśli wartość |
callToActionText |
Tekst wezwania do działania w reklamie. |
logoImage |
Nazwa zasobu MediaFile obrazu logo użytego w reklamie. |
squareLogoImage |
Nazwa zasobu MediaFile kwadratowego obrazu logo użytego w reklamie. |
marketingImage |
Nazwa zasobu MediaFile obrazu marketingowego użytego w reklamie. |
squareMarketingImage |
Nazwa zasobu MediaFile kwadratowego obrazu marketingowego użytego w reklamie. |
pricePrefix |
Prefiks przed ceną. Na przykład: „jak”. |
promoText |
Tekst promocyjny używany w formatach dynamicznych reklam elastycznych. na przykład „Bezpłatna dostawa w 2 dni”. |
DisplayAdFormatSetting
Wylicza ustawienia formatu reklam displayowych.
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 tekstowe i graficzne. |
NATIVE |
Dotyczy to na przykład formatu natywnego, którym zarządza wydawca, a nie Google. |
AppAdInfo
Reklama aplikacji.
Zapis JSON |
---|
{ "mandatoryAdText": { object ( |
Pola | |
---|---|
mandatoryAdText |
Obowiązkowy tekst reklamy. |
headlines[] |
Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy. |
descriptions[] |
Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy. |
images[] |
Lista komponentów z obrazem, które mogą wyświetlać się w reklamie. |
youtubeVideos[] |
Lista komponentów wideo w YouTube, które mogą wyświetlać się w reklamie. |
html5MediaBundles[] |
Lista zasobów pakietu kreacji multimedialnych, które mogą być używane w reklamie. |
AdMediaBundleAsset
Zasób pakietu kreacji multimedialnych używany w reklamie.
Zapis JSON |
---|
{ "asset": string } |
Pola | |
---|---|
asset |
Nazwa zasobu zasobu tego pakietu kreacji multimedialnych. |
LegacyAppInstallAdInfo
Starsza reklama promująca instalacje aplikacji przeznaczona tylko dla wybranych klientów.
Zapis JSON |
---|
{
"appStore": enum ( |
Pola | |
---|---|
appStore |
Sklep z aplikacjami, w którym dostępna jest aplikacja mobilna. |
appId |
Identyfikator aplikacji mobilnej. |
headline |
Nagłówek reklamy. |
description1 |
Pierwsza linia tekstu reklamy. |
description2 |
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 |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
APPLE_APP_STORE |
Apple iTunes. |
GOOGLE_PLAY |
Google Play. |
WINDOWS_STORE |
Windows Store. |
WINDOWS_PHONE_STORE |
Sklep Windows Phone. |
CN_APP_STORE |
Aplikacja jest dostępna w chińskim sklepie z aplikacjami. |
ResponsiveDisplayAdInfo
Elastyczna reklama displayowa.
Zapis JSON |
---|
{ "marketingImages": [ { object ( |
Pola | |
---|---|
marketingImages[] |
Obrazy marketingowe używane w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 314, a współczynnik proporcji 1,91:1 (+-1%). Wymagany jest co najmniej 1 element |
squareMarketingImages[] |
Kwadratowe obrazy marketingowe do wykorzystania w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 300 × 300, a współczynnik proporcji: 1:1 (+-1%). Wymagany jest co najmniej 1 kwadratowy element |
logoImages[] |
Obrazy logo do wykorzystania w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 512 x 128, a współczynnik proporcji 4:1 (+-1%). Po połączeniu z |
squareLogoImages[] |
Kwadratowe obrazy logo do wykorzystania w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%). Po połączeniu z |
headlines[] |
Krótkie nagłówki reklamy. Maksymalna długość to 30 znaków. Możesz określić od 1 do 5 nagłówków. |
longHeadline |
Wymagany długi nagłówek formatu. Maksymalna długość to 90 znaków. |
descriptions[] |
Opisy reklam. Maksymalna długość to 90 znaków. Możesz określić od 1 do 5 nagłówków. |
youtubeVideos[] |
Opcjonalne filmy w YouTube na potrzeby reklamy. Można określić maksymalnie 5 filmów. |
formatSetting |
Określa format, w jakim reklama będzie wyświetlana. Wartość domyślna to ALL_FORMATS. |
controlSpec |
Specyfikacje różnych ustawień kreacji. |
businessName |
Nazwa reklamodawcy lub marki. Maksymalna szerokość wyświetlacza to 25. |
mainColor |
Główny kolor reklamy w zapisie szesnastkowym, np. #FF w przypadku białego koloru. Jeśli wartość |
accentColor |
Kolor uzupełniający reklamy w postaci liczby szesnastkowej, np. #FF w przypadku białego koloru. Jeśli wartość |
allowFlexibleColor |
Zgoda reklamodawcy na wybór dowolnego koloru. Jeśli ma wartość true (prawda), reklama może w razie potrzeby być wyświetlana w innym kolorze. Jeśli ustawisz wartość false (fałsz), reklama będzie wyświetlana w określonych kolorach lub w neutralnym kolorze. Wartością domyślną jest |
callToActionText |
Tekst wezwania do działania w reklamie. Maksymalna szerokość wyświetlacza to 30. |
pricePrefix |
Prefiks przed ceną. Na przykład: „jak”. |
promoText |
Tekst promocyjny używany w formatach dynamicznych reklam elastycznych. na przykład „Bezpłatna dostawa w 2 dni”. |
ResponsiveDisplayAdControlSpec
Specyfikacja różnych ustawień kreacji elastycznej reklamy displayowej
Zapis JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
Pola | |
---|---|
enableAssetEnhancements |
Określa, czy reklamodawca włączył funkcję ulepszeń komponentów. |
enableAutogenVideo |
Określa, czy reklamodawca włączył funkcję automatycznego generowania filmów. |
LocalAdInfo
Reklama lokalna.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy. Należy określić od 1 do 5 nagłówków. |
descriptions[] |
Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy. Należy określić od 1 do 5 tekstów reklamy. |
callToActions[] |
Lista komponentów tekstowych z wezwaniami do działania. Przy wyświetleniu reklamy będą wybierane z tej listy wezwania do działania. Należy określić od 1 do 5 wezwań do działania. |
marketingImages[] |
Lista komponentów z obrazem marketingowym, które mogą się wyświetlać w reklamie. Obrazy muszą mieć rozmiar 314 x 600 pikseli lub 320 x 320 pikseli. Musisz określić od 1 do 20 komponentów z obrazem. |
logoImages[] |
Lista komponentów z obrazem logo, które mogą wyświetlać się w reklamie. Obrazy muszą mieć wymiary 128 x 128 pikseli i nie mogą być większe niż 120 KB. Musisz określić od 1 do 5 komponentów z obrazem. |
videos[] |
Lista komponentów wideo w YouTube, które mogą wyświetlać się w reklamie. Musisz określić od 1 do 20 komponentów wideo. |
path1 |
Pierwsza część opcjonalnego tekstu, który można dołączyć do adresu URL w reklamie. |
path2 |
Druga część opcjonalnego tekstu, który można dołączyć do adresu URL w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiono też |
DisplayUploadAdInfo
Ogólny typ reklamy displayowej. Dokładny format reklamy zależy od pola displayUploadProductType
, które określa, jakie dane należy umieścić w reklamie.
Zapis JSON |
---|
{ "displayUploadProductType": enum ( |
Pola | |
---|---|
displayUploadProductType |
Typ produktu danej reklamy. Aby uzyskać szczegółowe informacje, zapoznaj się z komentarzami do tej listy. |
Pole sumy media_asset . Dane o komponentach, z których składa się reklama. media_asset może być tylko jedną z tych wartości: |
|
mediaBundle |
Zasób pakietu kreacji multimedialnych używany w reklamie. Informacje o pakiecie kreacji multimedialnych na potrzeby kreacji HTML5_UPLOAD_AD znajdziesz na stronie https://support.google.com/google-ads/answer/1722096 Pakiety kreacji multimedialnych należących do typów produktów dynamicznych mają specjalny format, który trzeba utworzyć w aplikacji Google Web Designer. Więcej informacji znajdziesz na stronie https://support.google.com/webdesigner/answer/7543898. |
DisplayUploadProductType
Wylicza typy produktów do przesłania w sieci reklamowej.
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 send_media_bundle w usłudze DisplayUploadAdInfo. |
DYNAMIC_HTML5_EDUCATION_AD |
Dynamiczna reklama edukacyjna HTML5. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można go używać tylko w kampanii edukacyjnej. |
DYNAMIC_HTML5_FLIGHT_AD |
Dynamiczna reklama HTML5 lotu. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można go używać tylko w kampanii z terminami wyświetlania. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
Dynamiczna reklama HTML5 hotelu i wypożyczalni. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można jej używać tylko w kampanii reklam hoteli. |
DYNAMIC_HTML5_JOB_AD |
Dynamiczna reklama oferty pracy HTML5. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można go używać tylko w kampanii z ofertą pracy. |
DYNAMIC_HTML5_LOCAL_AD |
Dynamiczna reklama lokalna HTML5. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Tego typu strategii można używać tylko w kampanii lokalnej. |
DYNAMIC_HTML5_REAL_ESTATE_AD |
Dynamiczna reklama nieruchomości HTML5. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Może być używana tylko w kampanii nieruchomości. |
DYNAMIC_HTML5_CUSTOM_AD |
Dynamiczna niestandardowa reklama HTML5. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można go używać tylko w kampanii niestandardowej. |
DYNAMIC_HTML5_TRAVEL_AD |
Dynamiczna reklama HTML5 podróży. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można go używać tylko w kampanii dotyczącej podróży. |
DYNAMIC_HTML5_HOTEL_AD |
Dynamiczna reklama hotelu HTML5. Ten typ produktu wymaga ustawienia pola send_media_bundle w usłudze DisplayUploadAdInfo. Można jej 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 lotu. Pozwalają kierować użytkowników do określonej części aplikacji, gdzie mogą łatwiej i szybciej znaleźć to, czego szukają.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy. |
descriptions[] |
Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy. |
images[] |
Lista komponentów z obrazem, które mogą wyświetlać się w reklamie. |
videos[] |
Lista komponentów wideo, które mogą wyświetlać się z reklamą. |
ShoppingComparisonListingAdInfo
Reklama z porównaniem informacji o produkcie w Zakupach Google.
Zapis JSON |
---|
{ "headline": string } |
Pola | |
---|---|
headline |
Nagłówek reklamy. To pole jest wymagane. Maksymalna dozwolona długość to 25–45 znaków. |
SmartCampaignAdInfo
Reklama z kampanii inteligentnej.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych, z których każdy odpowiada nagłówkowi, gdy reklama jest wyświetlana. Lista zawiera od 3 do 15 komponentów tekstowych. |
descriptions[] |
Lista komponentów tekstowych, z których każdy odpowiada opisowi podczas wyświetlania reklamy. Lista zawiera od 2 do 4 komponentów tekstowych. |
AppPreRegistrationAdInfo
Reklamy promujące wcześniejszą rejestrację na aplikację zawierają link do informacji o aplikacji lub grze w Google Play. Mogą się wyświetlać w Google Play, YouTube (tylko reklamy In-Stream) oraz w innych aplikacjach i witrynach mobilnych w sieci reklamowej. Pomoże to wzbudzić zainteresowanie użytkowników Twoją aplikacją lub grą i zdobyć na tyle wczesną liczbę instalacji przed jej opublikowaniem.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych dla nagłówków. Przy wyświetlaniu reklamy nagłówki zostaną wybrane z tej listy. |
descriptions[] |
Lista komponentów tekstowych do tekstów reklam. Podczas wyświetlania reklamy zostaną wybrane teksty reklamy z tej listy. |
images[] |
Lista identyfikatorów komponentów z obrazem, których obrazy mogą wyświetlać się w reklamach. |
youtubeVideos[] |
Lista identyfikatorów komponentów wideo w YouTube, których filmy mogą być wyświetlane z reklamą. |
DiscoveryMultiAssetAdInfo
Reklama Discovery z wieloma komponentami.
Zapis JSON |
---|
{ "marketingImages": [ { object ( |
Pola | |
---|---|
marketingImages[] |
Komponenty z obrazem marketingowym, które mają zostać użyte w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 600 x 314, a współczynnik proporcji 1,91:1 (+-1%). Wymagany, jeśli nie ma elementu SquareMarketingImages. Suma wartości |
squareMarketingImages[] |
Kwadratowe komponenty z obrazem marketingowym, które zostaną użyte w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 300 × 300, a współczynnik proporcji: 1:1 (+-1%). Wymagany, jeśli nie ma elementu marketingImages. Suma wartości |
portraitMarketingImages[] |
Komponenty z pionowym obrazem marketingowym, które zostaną użyte w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 480 × 600, a współczynnik proporcji 4:5 (+-1%). Suma wartości |
logoImages[] |
Komponenty z obrazem logo do użycia w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%). Można określić od 1 do 5 obrazów logo. |
headlines[] |
Komponent tekstowy nagłówka reklamy. Maksymalna szerokość wyświetlacza to 30. Możesz określić od 1 do 5 nagłówków. |
descriptions[] |
Tekst opisowy reklamy. Maksymalna szerokość wyświetlacza to 90. Możesz określić od 1 do 5 tekstów reklamy. |
businessName |
Nazwa reklamodawcy lub marki. Maksymalna szerokość wyświetlacza to 25. To pole jest wymagane. |
callToActionText |
Tekst wezwania do działania. |
leadFormOnly |
Opcja logiczna wskazująca, czy reklama musi być wyświetlana z formularzem kontaktowym. |
DiscoveryCarouselAdInfo
Reklama karuzelowa Discovery.
Zapis JSON |
---|
{ "businessName": string, "logoImage": { object ( |
Pola | |
---|---|
businessName |
To pole jest wymagane. Nazwa reklamodawcy lub marki. |
logoImage |
To pole jest wymagane. Obraz logo do użycia w reklamie. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%). |
headline |
To pole jest wymagane. Nagłówek reklamy. |
description |
To pole jest wymagane. Tekst opisowy reklamy. |
callToActionText |
Tekst wezwania do działania. |
carouselCards[] |
To pole jest wymagane. Karty karuzeli, które będą się wyświetlać wraz z reklamą. Min. 2 maks. 10 |
AdDiscoveryCarouselCardAsset
Zasób karty karuzeli Discovery używany w reklamie.
Zapis JSON |
---|
{ "asset": string } |
Pola | |
---|---|
asset |
Nazwa zasobu tej karty karuzeli Discovery. |
DiscoveryVideoResponsiveAdInfo
Elastyczna reklama wideo Discovery.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych używanych w krótkim nagłówku. |
longHeadlines[] |
Lista komponentów tekstowych używanych w długim nagłówku. |
descriptions[] |
Lista komponentów tekstowych użytych w tekście reklamy. |
videos[] |
Lista komponentów wideo w YouTube użytych w reklamie. |
logoImages[] |
Obraz logo do użycia w reklamie. Prawidłowe typy zdjęć to GIF, JPEG i PNG. Minimalny rozmiar to 128 x 128, a współczynnik proporcji: 1:1 (+-1%). |
breadcrumb1 |
Pierwsza część tekstu pojawiającego się w reklamie razem z wyświetlanym adresem URL. |
breadcrumb2 |
Druga część tekstu pojawiająca się w reklamie razem z wyświetlanym adresem URL. |
businessName |
To pole jest wymagane. Nazwa reklamodawcy lub marki. |
callToActions[] |
Komponenty typu CallToActionAsset, które są używane na potrzeby przycisku „Wezwania do działania”. |
AdCallToActionAsset
Komponent z wezwaniem do działania używany w reklamie.
Zapis JSON |
---|
{ "asset": string } |
Pola | |
---|---|
asset |
Nazwa zasobu tego zasobu z wezwaniem do działania. |
TravelAdInfo
Ten typ nie ma żadnych pól.
Reklama podróży.
Metody |
|
---|---|
|
Wyświetla pełną żądaną reklamę. |
|
Aktualizuje reklamy. |