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