Załącznik: mapowanie pól interfejsu na pola interfejsu API według typu kreacji
Tabela poniżej mapuje pola interfejsu na odpowiednie pola interfejsu API rozdzielone według typu kreacji. Niektóre pola interfejsu API wymagają bardziej szczegółowych specyfikacji przez przypisaną rolę lub typ dla udostępnionego zasobu.
Standardowa kreacja graficzna
| Typ kreacji: CREATIVE_TYPE_STANDARD |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Komponent kreacji
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Dołączony tag śledzenia HTML
|
|
Opcjonalny
|
|
API Field Name: (Nazwa pola interfejsu API): dołączony tag
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Kreacja HTML5
| Typ kreacji: CREATIVE_TYPE_STANDARD |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Komponent kreacji
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Obrazy zapasowe
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_BACKUP
|
|
|
Zapasowy URL strony docelowej
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_BACKUP
|
|
|
Etykieta raportowania zdarzenia zapasowego
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API:ExitEvents[].reportingName
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_BACKUP
|
|
|
Obrazy kontroli wczytywania
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_POLITE_LOAD
|
|
|
Wyjścia
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[]
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
Liczniki
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: CounterEvents[]
|
|
|
Liczniki czasu
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: timerEvents[]
|
|
|
Dołączony tag śledzenia HTML
|
|
Opcjonalny
|
|
API Field Name: (Nazwa pola interfejsu API): dołączony tag
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Reklama displayowa firmy zewnętrznej
| Typ kreacji: CREATIVE_TYPE_STANDARD |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Wymiary
|
|
Wymagany
|
|
Nazwa pola interfejsu API: wymiary
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
Wymaga MRAID
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementsMraid
|
|
|
Wymaga HTML5
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementshtml5
|
|
|
Tag usługi zewnętrznej
|
|
Wymagany
|
|
Nazwa pola interfejsu API: thirdPartyTag
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementsPingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Kreacja rozwijana firmy zewnętrznej
| Typ kreacji: CREATIVE_TYPE_EXPANDABLE |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Wymiary
|
|
Wymagany
|
|
Nazwa pola interfejsu API: wymiary
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
Wymaga MRAID
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementsMraid
|
|
|
Wymaga HTML5
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementshtml5
|
|
|
Kierunek rozwijania
|
|
Wymagany
|
|
Nazwa pola interfejsu API: expandDirection
|
|
|
Rozwiń po najechaniu
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: expandOnHover
|
|
|
Inna firma
|
|
Wymagany
|
|
Nazwa pola interfejsu API: thirdPartyTag
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementsPingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Kreacja wideo firmy zewnętrznej
| Typ kreacji: CREATIVE_TYPE_VIDEO |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
URL tagu VAST
|
|
Wymagany
|
|
Nazwa pola interfejsu API: vastTagUrl
|
|
|
VPAID
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: vpaid
|
|
|
Film wideo HTML5
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: html5Video
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementsPingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Kreacja audio innej firmy
| Typ kreacji: CREATIVE_TYPE_AUDIO |
| Źródło hostingu: HOSTING_SOURCE_THIRD_PARTY |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
URL tagu VAST
|
|
Wymagany
|
|
Nazwa pola interfejsu API: vastTagUrl
|
|
|
Do atrybucji jest wymagany ping
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: requirementsPingForAttribution
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Kreacja wideo
| Typ kreacji: CREATIVE_TYPE_VIDEO |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Plik źródłowy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
Dołącz przycisk pominięcia
|
|
Opcjonalny
|
|
API Field Name: (Nazwa pola interfejsu API): możliwe do pominięcia
|
|
|
Opóźnienie pominięcia
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: sendOffset
|
|
|
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
|
|
API Field Name: (Nazwa pola interfejsu API): transkodowane
|
|
|
Adresy URL firm zewnętrznych
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: thirdPartyUrls
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Kreacja audio
| Typ kreacji: CREATIVE_TYPE_AUDIO |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Plik źródłowy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
Zasób dodatkowy (prześlij lub przypisz)
|
|
Wymagany
|
|
Nazwa pola interfejsu API:CompanionCreativeIds
|
|
|
Nazwa pliku do wyświetlenia
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transkoduje [].name
|
|
|
Typ pliku do wyświetlenia
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transkodowanie[].mimeType
|
|
|
Szybkość transmisji bitów dźwięku wyświetlanego pliku
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transkodowanie[].audioBitRateKbps
|
|
|
Częstotliwość próbkowania audio w wyświetlanym pliku
|
|
Tylko do odczytu
|
|
Nazwa pola interfejsu API: transkodowanie[].audioSampleRateHz
|
|
|
Adresy URL firm zewnętrznych
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: thirdPartyUrls
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Natywna kreacja displayowa
| Typ kreacji: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_square |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
status
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Logo
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_ICON
|
|
|
Obraz / obraz kwadratowy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Nagłówek
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_HEADLINE
|
|
|
Długi nagłówek
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_LONG_HEADLINE
|
|
|
Tekst główny
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_BODY
|
|
|
Długi tekst główny
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_LONG_BODY
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
URL napisów
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_CAPTION_URL
|
|
|
Wezwanie do działania
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_CALL_TO_ACTION
|
|
|
Reklama śledząca w usłudze Campaign Manager 360
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: cmTrackingAd
|
|
|
Link monitorujący wyświetlenia 1
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: trackingUrls[]
|
|
|
Link monitorujący wyświetlenia 2
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: trackingUrls[]
|
|
|
Link monitorujący JavaScript
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: jsTrackerUrl
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu API): reviewStatus
|
|
Natywna kreacja wideo
| Typ kreacji: CREATIVE_TYPE_NATIVE_VIDEO |
| Źródło hostingu: HOSTING_SOURCE_HOSTED |
|
Nazwa
|
|
Wymagany
|
|
API Field Name (Nazwa pola interfejsu API): displayName
|
|
|
Stan
|
|
Wymagany
|
|
Nazwa pola interfejsu API: entityStatus
|
|
|
Logo
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_ICON
|
|
|
Wideo
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_MAIN
|
|
|
Zdjęcie okładki
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_COVER_IMAGE
|
|
|
Nazwa reklamodawcy
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_ADVERTISER_NAME
|
|
|
Nagłówek
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_HEADLINE
|
|
|
Długi nagłówek
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_LONG_HEADLINE
|
|
|
Tekst główny
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_BODY
|
|
|
Długi tekst główny
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_LONG_BODY
|
|
|
Adres URL strony docelowej
|
|
Wymagany
|
|
Nazwa pola interfejsu API:ExitEvents[].url
|
|
Typ zdarzenia wyjściowego: Exit_EVENT_TYPE_DEFAULT
|
|
|
URL napisów
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_CAPTION_URL
|
|
|
Wezwanie do działania
|
|
Wymagany
|
|
Nazwa pola interfejsu API: zasoby
|
|
Rola zasobu: ASSET_ROLE_CALL_TO_ACTION
|
|
|
Link monitorujący wyświetlenia 1
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: trackingUrls[]
|
|
|
Link monitorujący wyświetlenia 2
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: trackingUrls[]
|
|
|
Link monitorujący JavaScript
|
|
Opcjonalny
|
|
Nazwa pola interfejsu API: jsTrackerUrl
|
|
|
Kod integracji
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): integrationCode
|
|
|
Uwagi
|
|
Opcjonalny
|
|
API Field Name (Nazwa pola interfejsu API): uwagi.
|
|
|
Stan kontroli
|
|
Tylko do odczytu
|
|
API Field Name (Nazwa pola interfejsu 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: 2023-12-01 UTC.
[null,null,["Ostatnia aktualizacja: 2023-12-01 UTC."],[[["This 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."],["Each 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."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
