Załącznik: mapowanie pól interfejsu na pola interfejsu API według typu kreacji

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