Od
8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej
stronie dotyczącej wycofania.
Załącznik: mapowanie pól interfejsu na pola interfejsu API według typu kreacji
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tabela poniżej zawiera mapowanie pól interfejsu na odpowiednie pola interfejsu API, rozdzielone według typu kreacji. Pamiętaj, że niektóre pola interfejsu API wymagają dalszego określenia za pomocą przypisanej roli lub typu zasobu.
Standardowa kreacja graficzna z obrazem
| Typ kreacji: CREATIVE_TYPE_STANDARD |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Komponent kreacji
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Dołączony tag śledzenia HTML
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: appendedTag
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Kreacja HTML5
| Typ kreacji: CREATIVE_TYPE_STANDARD |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Komponent kreacji
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Obrazy zapasowe
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_BACKUP
|
|
|
Adres URL zapasowej strony docelowej
|
|
Opcjonalny
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_BACKUP
|
|
|
Etykieta raportowania zapasowych zdarzeń wyjściowych
|
|
Opcjonalny
|
|
Nazwa pola API: exitEvents[].reportingName
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_BACKUP
|
|
|
Obrazy kontroli wczytywania
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_POLITE_LOAD
|
|
|
Wyjścia
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[]
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Liczniki
|
|
Opcjonalny
|
|
Nazwa pola API: counterEvents[]
|
|
|
Liczniki czasu
|
|
Opcjonalny
|
|
Nazwa pola API: timerEvents[]
|
|
|
Dołączony tag śledzenia HTML
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: appendedTag
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Opcjonalny
|
|
Nazwa pola API: reviewStatus
|
|
Kreacja displayowa firmy zewnętrznej
| Typ kreacji: CREATIVE_TYPE_STANDARD |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Wymiary
|
|
Wymagany
|
|
Nazwa pola API: wymiary
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Wymaga MRAID
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requireMraid
|
|
|
Wymaga HTML5
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requireHtml5
|
|
|
Tag usługi zewnętrznej
|
|
Wymagany
|
|
Nazwa pola API: thirdPartyTag
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola API: requirePingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Kreacja rozwijana innej firmy
| Typ kreacji: CREATIVE_TYPE_EXPANDABLE |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Wymiary
|
|
Wymagany
|
|
Nazwa pola API: wymiary
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Wymaga MRAID
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requireMraid
|
|
|
Wymaga HTML5
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requireHtml5
|
|
|
Kierunek rozwijania
|
|
Wymagany
|
|
Nazwa pola API: expandingDirection
|
|
|
Rozwija się po najechaniu
|
|
Opcjonalny
|
|
Nazwa pola API: expandOnHover
|
|
|
Inna firma
|
|
Wymagany
|
|
Nazwa pola API: thirdPartyTag
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola API: requirePingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Kreacja wideo firmy zewnętrznej
| Typ kreacji: CREATIVE_TYPE_VIDEO |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Adres URL tagu VAST
|
|
Wymagany
|
|
Nazwa pola interfejsu API: vastTagUrl
|
|
|
VPAID
|
|
Tylko do odczytu
|
|
Nazwa pola API: vpaid
|
|
|
Film wideo HTML5
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: html5Video
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola API: requirePingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Zewnętrzna kreacja audio
| Typ kreacji: CREATIVE_TYPE_AUDIO |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Adres URL tagu VAST
|
|
Wymagany
|
|
Nazwa pola interfejsu API: vastTagUrl
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola API: requirePingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Wideo reklamowe
| Typ kreacji: CREATIVE_TYPE_VIDEO |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Plik źródłowy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Dołącz przycisk pominięcia
|
|
Opcjonalny
|
|
Nazwa pola API: skippable
|
|
|
Opóźnienie pominięcia
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: skipOffset
|
|
|
Opóźnienie odtworzenia
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: progressOffset
|
|
|
Uniwersalny identyfikator reklamy
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: universalAdId
|
|
|
OBA
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: obaIcon
|
|
|
Kreacje towarzyszące
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: companionCreativeIds
|
|
|
Plik do wyświetlenia
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transcodes
|
|
|
Adresy URL firm zewnętrznych
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: thirdPartyUrls
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Kreacja audio
| Typ kreacji: CREATIVE_TYPE_AUDIO |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Plik źródłowy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Komponent dodatkowy (przesyłanie lub przypisywanie)
|
|
Wymagany
|
|
Nazwa pola interfejsu API: companionCreativeIds
|
|
|
Nazwa pliku do wyświetlenia
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transcodes[].name
|
|
|
Typ wyświetlanego pliku
|
|
Tylko do odczytu
|
|
Nazwa pola API: transcodes[].mimeType
|
|
|
Szybkość transmisji bitów pliku audio
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transcodes[].audioBitRateKbps
|
|
|
Częstotliwość próbkowania audio pliku
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transcodes[].audioSampleRateHz
|
|
|
Adresy URL firm zewnętrznych
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: thirdPartyUrls
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Natywne kreacje displayowe
| Typ kreacji: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
status
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Logo
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_ICON
|
|
|
Obraz / obraz kwadratowy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Nagłówek
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_HEADLINE
|
|
|
Długi nagłówek
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_LONG_HEADLINE
|
|
|
Tekst główny
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_BODY
|
|
|
Długi tekst główny
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_LONG_BODY
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
URL napisów
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_CAPTION_URL
|
|
|
Wezwanie do działania
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_CALL_TO_ACTION
|
|
|
Reklama śledząca Campaign Managera 360
|
|
Opcjonalny
|
|
Nazwa pola API: cmTrackingAd
|
|
|
Link monitorujący wyświetlenia 1
|
|
Opcjonalny
|
|
Nazwa pola API: trackingUrls[]
|
|
|
Link monitorujący wyświetlenia 2
|
|
Opcjonalny
|
|
Nazwa pola API: trackingUrls[]
|
|
|
Link monitorujący JavaScript
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: jsTrackerUrl
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
Natywne kreacje wideo
| Typ kreacji: CREATIVE_TYPE_NATIVE_VIDEO |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
Nazwa pola API: wyświetlana nazwa
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Logo
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_ICON
|
|
|
Wideo
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Zdjęcie okładki
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_COVER_IMAGE
|
|
|
Nazwa reklamodawcy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_ADVERTISER_NAME
|
|
|
Nagłówek
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_HEADLINE
|
|
|
Długi nagłówek
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_LONG_HEADLINE
|
|
|
Tekst główny
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_BODY
|
|
|
Długi tekst główny
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_LONG_BODY
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola API: exitEvents[].url
|
|
Typ zdarzenia wyjściowego: EXIT_EVENT_TYPE_DEFAULT
|
|
|
URL napisów
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_CAPTION_URL
|
|
|
Wezwanie do działania
|
|
Wymagany
|
|
Nazwa pola interfejsu API: assets
|
|
Rola zasobu: ASSET_ROLE_CALL_TO_ACTION
|
|
|
Link monitorujący wyświetlenia 1
|
|
Opcjonalny
|
|
Nazwa pola API: trackingUrls[]
|
|
|
Link monitorujący wyświetlenia 2
|
|
Opcjonalny
|
|
Nazwa pola API: trackingUrls[]
|
|
|
Link monitorujący JavaScript
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: jsTrackerUrl
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
Nazwa pola API: notes
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
Nazwa pola API: reviewStatus
|
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThis document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video.\u003c/p\u003e\n"],["\u003cp\u003eEach creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]
