REST Resource: advertisers.creatives

Zasób: Reklama

Pojedyncza kreacja.

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu kreacji.
advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy kreacja.
creativeId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator kreacji. Przypisana przez system.
cmPlacementId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator miejsca docelowego w usłudze Campaign Manager 360 powiązanego z kreacją. To pole dotyczy tylko kreacji synchronizowanych z Campaign Managera.
displayName

string

To pole jest wymagane. Wyświetlana nazwa kreacji.

Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów.
entityStatus

enum (EntityStatus)

To pole jest wymagane. Określa, czy kreacja może zostać wyświetlona.

Akceptowane wartości:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji kreacji przez użytkownika lub system (np. podczas sprawdzania kreacji). Przypisana przez system.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa utworzenia kreacji. Przypisana przez system.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
creativeType

enum (CreativeType)

To pole jest wymagane. Stałe. Typ kreacji.
hostingSource

enum (HostingSource)

To pole jest wymagane. Wskazuje miejsce hostowania kreacji.
dynamic

boolean

Tylko dane wyjściowe. Wskazuje, czy kreacja jest dynamiczna.
dimensions

object (Dimensions)

To pole jest wymagane. Podstawowe wymiary kreacji. Dotyczy wszystkich typów kreacji. Wartość widthPixels i heightPixels przyjmuje domyślnie wartość 0, gdy creativeType jest jedną z tych wartości:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Dodatkowe wymiary. Ma zastosowanie, gdy creativeType należy do:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Jeśli to pole jest określone, wymagane są zarówno pola widthPixels, jak i heightPixels. Ich wartość nie może być mniejsza niż 0.
mediaDuration

string (Duration format)

Tylko dane wyjściowe. Czas trwania multimediów kreacji. Ma zastosowanie, gdy creativeType należy do:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Tylko dane wyjściowe. Lista atrybutów kreacji wygenerowana przez system.
reviewStatus

object (ReviewStatusInfo)

Tylko dane wyjściowe. Bieżący stan procesu sprawdzania kreacji.
assets[]

object (AssetAssociation)

To pole jest wymagane. Zasoby powiązane z tą kreacją.
exitEvents[]

object (ExitEvent)

To pole jest wymagane. Zdarzenia wyjściowe tej kreacji. Wyjście (nazywane też tagiem kliknięcia) to dowolny obszar w kreacji, który użytkownik może kliknąć, by otworzyć stronę docelową reklamodawcy. Każda kreacja musi zawierać co najmniej 1 wyjście. Wyjście możesz dodać do kreacji w dowolny z tych sposobów:

  • Użyj obszaru kliknięcia w narzędziu Google Web Designer.
  • Zdefiniuj zmienną JavaScript o nazwie „clickTag”.
  • Użyj komponentu Enabler (Enabler.exit()), by śledzić wyjścia w formatach rich media.
timerEvents[]

object (TimerEvent)

Licznik zdarzeń niestandardowych w kreacji multimedialnej. Liczniki czasu służą do śledzenia czasu, w którym użytkownik wyświetla określoną część kreacji multimedialnej i wchodzi z nią w interakcję. Kreacja może zawierać wiele zdarzeń licznika czasu, a czas każdego z nich może być mierzony oddzielnie. W przypadku kreacji zawierających tylko komponenty z obrazem pozostaw to pole puste lub nieskonfigurowane.
counterEvents[]

object (CounterEvent)

Zdarzenia licznika w kreacji multimedialnej. Liczniki zdarzeń rejestrują liczbę określonych interakcji użytkownika z dowolną częścią kreacji multimedialnej – takich jak najechanie kursorem na reklamę, wyjechanie poza nią, kliknięcie, wczytanie danych, użycie klawiatury itp. Każde zdarzenie przechwytywane w kreacji można rejestrować za pomocą licznika. W przypadku kreacji zawierających tylko komponenty z obrazem pozostaw to pole puste lub nieskonfigurowane.
appendedTag

string

Tag śledzenia HTML firmy zewnętrznej, który ma zostać dołączony do tagu kreacji.
integrationCode

string

Informacje o identyfikatorze używane do połączenia tej kreacji z systemem zewnętrznym. Musi być zakodowany w formacie UTF-8 o długości nie większej niż 10 000 znaków.
notes

string

Uwagi użytkownika dotyczące tej kreacji. Musi być zakodowany w formacie UTF-8 o długości nie większej niż 20 000 znaków.
iasCampaignMonitoring

boolean

Wskazuje, czy monitorowanie kampanii Integral Ad Science (IAS) jest włączone. Aby włączyć tę funkcję dla kreacji, upewnij się, że Advertiser.creative_config.ias_client_id ma ustawiony identyfikator klienta IAS.
companionCreativeIds[]

string (int64 format)

Identyfikatory kreacji towarzyszących danej kreacji wideo.

Możesz przypisać istniejące kreacje displayowe (z zasobami graficznymi lub HTML5), które będą wyświetlane wokół odtwarzacza wideo wydawcy. Reklamy towarzyszące wyświetlają się podczas odtwarzania filmu i po jego zakończeniu.

Kreacje zawierające additional dimensions nie mogą być kreacjami towarzyszącymi.

To pole jest obsługiwane tylko w przypadku creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Określa, czy użytkownik może pominąć kreację wideo.

To pole jest obsługiwane tylko w przypadku creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Czas odtwarzania filmu do momentu wyświetlenia przycisku pominięcia.

To pole jest wymagane, gdy skippable ma wartość prawda.

To pole jest obsługiwane tylko w przypadku creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Czas odtwarzania filmu przed zliczeniem wyświetlenia.

To pole jest wymagane, gdy skippable ma wartość prawda.

To pole jest obsługiwane tylko w przypadku creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Opcjonalnie. Opcjonalny identyfikator kreacji podawany przez rejestr, który jest unikalny na wszystkich platformach.

Uniwersalny identyfikator reklamy jest częścią standardu VAST 4.0. Można ją zmienić po utworzeniu kreacji.

To pole jest obsługiwane tylko w przypadku creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Linki monitorujące firm zewnętrznych do śledzenia interakcji z kreacjami wideo.

To pole jest obsługiwane tylko w przypadku creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Tylko dane wyjściowe. Transkodowane pliki audio/wideo.

Transkoduje główny zasób do kilku wersji dodatkowych, które mają inny format lub zmienione właściwości (rozdzielczość oraz szybkość transmisji bitów obrazu i dźwięku) dobrane pod kątem określonych odtwarzaczy wideo lub przepustowości.

Dzięki temu system wydawcy ma więcej możliwości do wyboru podczas wyświetlania filmu. Możesz mieć pewność, że wyświetli się odpowiedni plik dopasowany do połączenia, z którego korzysta użytkownik, oraz rozmiaru ekranu.

To pole jest obsługiwane tylko w creativeType:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Adresy URL śledzenia dla dostawców usług analitycznych i zewnętrznych dostawców technologii reklamowych.

Adresy URL muszą zaczynać się od https (z wyjątkiem zasobów reklamowych, które nie wymagają zgodności z protokołem SSL). Jeśli w adresach URL stosujesz makra, używaj tylko makr obsługiwanych przez Display & Video 360.

Można używać tylko standardowych adresów URL, a nie tagów IMG czy SCRIPT.

To pole można zapisać tylko w creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Adres URL do pomiaru JavaScriptu od obsługiwanych zewnętrznych dostawców systemów weryfikacji (ComScore, DoubleVerify, IAS, Moat). Tagi skryptu HTML nie są obsługiwane.

To pole można zapisać tylko w creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Reklama śledząca Campaign Managera 360 powiązana z kreacją.

Opcjonalny w przypadku elementów creativeType utworzonych przez reklamodawcę, który korzysta zarówno z Campaign Managera 360, jak i wyświetlania reklam przez firmy zewnętrzne:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Dane wyjściowe tylko w przypadku innych przypadków.
obaIcon

object (ObaIcon)

Określa ikonę OBA na potrzeby kreacji wideo.

To pole jest obsługiwane tylko w creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Opcjonalnie. Pierwotny tag firmy zewnętrznej użyty w kreacji.

Wymagane i prawidłowe tylko w przypadku kreacji z tagiem firm zewnętrznych.

Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Opcjonalnie. Wskazuje, że kreacja wymaga MRAID (systemu definicji interfejsu reklam mobilnych rich media).

Ustaw tę opcję, jeśli interakcja z kreacją wymaga użycia gestów charakterystycznych dla urządzeń mobilnych, takich jak przesuwanie palcem lub dotykanie.

Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem usług zewnętrznych.

Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Opcjonalnie. Wskazuje, że do prawidłowego renderowania kreacja wykorzystuje HTML5.

Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem usług zewnętrznych. Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Opcjonalnie. Wskazuje, że kreacja będzie czekać na ping zwrotny na potrzeby atrybucji.

Tej formuły można użyć tylko w przypadku reklamy śledzącej Campaign Managera 360 z parametrem serwera reklamowego firmy zewnętrznej i makrem ${DC_DBM_TOKEN}.

Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem firmy zewnętrznej i kreacji z tagiem VAST firm zewnętrznych.

Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Kreacje z tagiem VAST firm zewnętrznych to kreacje, których hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Opcjonalnie. Określa kierunek rozwijania kreacji.

Wymagane i prawidłowe tylko w przypadku kreacji rozwijanych innych firm.

Kreacje rozwijane firmy zewnętrznej to kreacje z takim źródłem hostingu:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Opcjonalnie. Wskazuje, że kreacja automatycznie się rozwinie, gdy najedziesz na nią kursorem.

Opcjonalny i prawidłowy tylko w przypadku kreacji rozwijanych innych firm. Kreacje rozwijane firmy zewnętrznej to kreacje z takim źródłem hostingu:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Opcjonalnie. Adres URL tagu VAST innej firmy z tagiem VAST.

Wymagane i prawidłowe tylko w przypadku kreacji z tagiem VAST innych firm.

Kreacje z tagiem VAST firm zewnętrznych to kreacje, których hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Tylko dane wyjściowe. Wskazuje, że kreacja z tagiem VAST innej firmy wymaga VPAID (Digital Video Player-Ad Interface).

Obowiązuje tylko w przypadku kreacji z tagiem VAST innych firm i tylko w przypadku kreacji wyjściowych.

Kreacje z tagiem VAST firm zewnętrznych to kreacje, których hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Tylko dane wyjściowe. Wskazuje, że kreacja z tagiem VAST firmy zewnętrznej wymaga obsługi wideo w formacie HTML5.

Obowiązuje tylko w przypadku kreacji z tagiem VAST innych firm i tylko w przypadku kreacji wyjściowych.

Kreacje z tagiem VAST firm zewnętrznych to kreacje, których hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Tylko dane wyjściowe. Identyfikatory elementów zamówienia, z którymi jest powiązana ta kreacja.

Aby powiązać kreację z elementem zamówienia, użyj elementu LineItem.creative_ids.
mp3Audio

boolean

Tylko dane wyjściowe. Wskazuje, że kreacja audio firmy zewnętrznej obsługuje format MP3.

Tylko dane wyjściowe i działają tylko w przypadku kreacji audio firm zewnętrznych.

Kreacje audio firm zewnętrznych to kreacje, które mają te hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Tylko dane wyjściowe. Wskazuje, że kreacja audio firmy zewnętrznej obsługuje format OGG.

Tylko dane wyjściowe i działają tylko w przypadku kreacji audio firm zewnętrznych.

Kreacje audio firm zewnętrznych to kreacje, które mają te hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

Możliwe źródła hostingu kreacji. Wskazuje miejsce tworzenia i hostowania kreacji.

Wartości w polu enum
HOSTING_SOURCE_UNSPECIFIED Źródło hostingu nie jest określone lub jest nieznane w tej wersji.
HOSTING_SOURCE_CM

Kreacja zsynchronizowana z Campaign Managera 360.

Metody tworzenia i aktualizacji nie są obsługiwane w przypadku tego typu hostingu.
HOSTING_SOURCE_THIRD_PARTY

Kreacja hostowana na serwerze reklamowym firmy zewnętrznej (3PAS).

Metody tworzenia i aktualizacji są obsługiwane w przypadku tego typu hostingu, jeśli creativeType jest jednym z tych typów:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Kreacja utworzona w DV360 i hostowana w usłudze Campaign Manager 360.

Metody tworzenia i aktualizacji są obsługiwane w przypadku tego typu hostingu, jeśli creativeType jest jednym z tych typów:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Kreacja multimedialna utworzona w Studio i hostowana w usłudze Campaign Manager 360.

Metody tworzenia i aktualizacji nie są obsługiwane w przypadku tego typu hostingu.

CreativeAttribute

Możliwe atrybuty kreacji.

Wartości w polu enum
CREATIVE_ATTRIBUTE_UNSPECIFIED Atrybut kreacji nie jest określony lub jest nieznany w tej wersji.
CREATIVE_ATTRIBUTE_VAST Kreacja to VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR Jest to linearna kreacja VPAID.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR Jest to nielinearna kreacja VPAID.

ReviewStatusInfo

Sprawdź stany kreacji.

Zapis JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
Pola
approvalStatus

enum (ApprovalStatus)

Reprezentuje podstawowe zatwierdzenie wymagane do rozpoczęcia wyświetlania kreacji. Podsumowanie: creativeAndLandingPageReviewStatus i contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Stan weryfikacji kreacji i strony docelowej.
contentAndPolicyReviewStatus

enum (ReviewStatus)

Stan weryfikacji treści i zgodności kreacji z zasadami.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Stany weryfikacji kreacji przez giełdy.
publisherReviewStatuses[]

object (PublisherReviewStatus)

Stany weryfikacji kreacji przez wydawcę.

ApprovalStatus

Możliwe typy stanu zatwierdzenia. To jest podsumowanie funkcji creativeAndLandingPageReviewStatus i contentAndPolicyReviewStatus.

Wartości w polu enum
APPROVAL_STATUS_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
APPROVAL_STATUS_PENDING_NOT_SERVABLE Kreacja jest nadal w trakcie sprawdzania i nie można jej wyświetlać.
APPROVAL_STATUS_PENDING_SERVABLE Kreacja przeszła weryfikację kreacji i strony docelowej oraz można ją wyświetlać, ale oczekuje na dodatkową weryfikację treści i zgodności z zasadami.
APPROVAL_STATUS_APPROVED_SERVABLE Zatwierdzono weryfikację kreacji i strony docelowej oraz weryfikację treści i zasad. Kreacja jest możliwa do wyświetlania.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Występuje problem z kreacją, który trzeba rozwiązać, zanim zostanie ona dopuszczona do wyświetlania.

ReviewStatus

Możliwe typy stanu sprawdzenia.

Wartości w polu enum
REVIEW_STATUS_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
REVIEW_STATUS_APPROVED Kreacja została zatwierdzona.
REVIEW_STATUS_REJECTED Kreacja została odrzucona.
REVIEW_STATUS_PENDING Kreacja oczekuje na sprawdzenie.

ExchangeReviewStatus

Stan weryfikacji kreacji przez giełdę.

Zapis JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Pola
exchange

enum (Exchange)

Giełda sprawdzająca kreację.
status

enum (ReviewStatus)

Stan weryfikacji giełdy.

PublisherReviewStatus

Stan weryfikacji kreacji przez wydawcę.

Zapis JSON 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
Pola
publisherName

string

Wydawca sprawdzający kreację.
status

enum (ReviewStatus)

Stan sprawdzania przez wydawcę.

AssetAssociation

Powiązanie zasobu kreacji.

Zapis JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Pola
asset

object (Asset)

Powiązany zasób.
role

enum (AssetRole)

Rola tego zasobu w kreacji.

Zasób

Jeden zasób.

Zapis JSON 
{
  "mediaId": string,
  "content": string
}
Pola
mediaId

string (int64 format)

Identyfikator mediów przesłanego zasobu. Jest to unikalny identyfikator zasobu. Można go przekazywać do innych wywołań interfejsu API, np. do creatives.create, by powiązać zasób z kreacją.

Przestrzeń identyfikatorów mediów została zaktualizowana 5 kwietnia 2023 r. Zaktualizuj identyfikatory mediów zapisane w pamięci podręcznej przed 5 kwietnia 2023 r., pobierając nowy identyfikator mediów z powiązanych zasobów kreacji lub ponownie przesyłając zasób.
content

string

Treść zasobu. W przypadku przesyłanych zasobów treść to ścieżka wyświetlania.

AssetRole

Rola tego zasobu w kreacji.

Wartości w polu enum
ASSET_ROLE_UNSPECIFIED Rola zasobu nie jest określona lub jest nieznana w tej wersji.
ASSET_ROLE_MAIN Zasób to główny zasób kreacji.
ASSET_ROLE_BACKUP Jest to zasób zapasowy kreacji.
ASSET_ROLE_POLITE_LOAD Jest to komponent kreacji z kontrolą wczytywania.
ASSET_ROLE_HEADLINE

Nagłówek kreacji natywnej.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 25 znaków.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Długi nagłówek kreacji natywnej.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 50 znaków.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Tekst główny kreacji natywnej.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 90 znaków.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Długi tekst główny kreacji natywnej.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 150 znaków.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Krótka, prostsza wersja adresu URL strony docelowej wyświetlana w kreacji. Adres ten informuje użytkowników, na jaką stronę trafią po kliknięciu kreacji.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 30 znaków.

Jeśli np. adres URL strony docelowej to „http://www.example.com/strona”, adresem URL napisów może być „example.com”. Protokół (http://) jest opcjonalny, ale URL nie może zawierać spacji ani znaków specjalnych.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Tekst wyświetlany na przycisku wezwania do działania w kreacji natywnej.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 15 znaków.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Tekst, który określa nazwę reklamodawcy lub marki.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 25 znaków.

Ta rola jest obsługiwana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Cena aplikacji w Sklepie Google Play lub sklepie z aplikacjami na iOS (na przykład 5, 99 USD).

Pamiętaj, że ta wartość nie jest automatycznie synchronizowana z rzeczywistą wartością podaną w sklepie. Jest to zawsze wartość podana podczas zapisywania kreacji.

content musi być zakodowany w formacie UTF-8 o długości nie większej niż 15 znaków.

Zasoby z tą rolą są tylko do odczytu.
ASSET_ROLE_ANDROID_APP_ID

Identyfikator aplikacji na Androida w sklepie Google Play.

Znajdziesz go w adresie URL aplikacji w Sklepie Google Play po fragmencie „id”. Na przykład w adresie https://play.google.com/store/apps/details?id=com.company.appname identyfikator to com.firma.nazwaaplikacji.

Zasoby z tą rolą są tylko do odczytu.
ASSET_ROLE_IOS_APP_ID

Identyfikator aplikacji na iOS w sklepie Apple App Store.

Ten numer identyfikacyjny można znaleźć w adresie URL sklepu Apple App Store jako ciąg cyfr, który znajduje się bezpośrednio po elemencie „id”. Na przykład w adresie https://apps.apple.com/us/app/gmail-email-by-google/id422689480 identyfikator to 422689480.

Zasoby z tą rolą są tylko do odczytu.
ASSET_ROLE_RATING

Ocena aplikacji w Sklepie Google Play lub w sklepie z aplikacjami na iOS.

Pamiętaj, że ta wartość nie jest automatycznie synchronizowana z rzeczywistą oceną w sklepie. Jest to zawsze wartość podana podczas zapisywania kreacji.

Zasoby z tą rolą są tylko do odczytu.
ASSET_ROLE_ICON

Ikona kreacji.

Ta rola jest obsługiwana i wymagana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Obraz okładki natywnej kreacji wideo.

Ta rola jest obsługiwana i wymagana tylko w tych usługach (creativeType):

  • CREATIVE_TYPE_VIDEO

ExitEvent

Zdarzenie wyjściowe kreacji.

Zapis JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Pola
type

enum (ExitEventType)

To pole jest wymagane. Typ zdarzenia wyjściowego.
url

string

To pole jest wymagane. Docelowy URL zdarzenia wyjściowego. Jest to wymagane, gdy type:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Nazwa tagu kliknięcia zdarzenia wyjściowego.

Nazwa musi być niepowtarzalna w obrębie jednej kreacji.

W przypadku kreacji zawierających tylko komponenty z obrazem pozostaw to pole puste lub nieskonfigurowane.
reportingName

string

Nazwa używana do identyfikowania tego zdarzenia w raportach. W przypadku kreacji zawierających tylko komponenty z obrazem pozostaw to pole puste lub nieskonfigurowane.

ExitEventType

Typ zdarzenia wyjściowego.

Wartości w polu enum
EXIT_EVENT_TYPE_UNSPECIFIED Typ zdarzenia wyjściowego nie jest określony lub jest w tej wersji nieznany.
EXIT_EVENT_TYPE_DEFAULT Zdarzenie wyjściowe jest tym domyślnym.
EXIT_EVENT_TYPE_BACKUP Zdarzenie wyjściowe to zapasowe zdarzenie wyjściowe. Kreacja może zawierać wiele zapasowych zdarzeń wyjściowych.

TimerEvent

Zdarzenie licznika czasu kreacji.

Zapis JSON 
{
  "name": string,
  "reportingName": string
}
Pola
name

string

To pole jest wymagane. Nazwa zdarzenia licznika czasu.
reportingName

string

To pole jest wymagane. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach.

CounterEvent

Zdarzenie licznika kreacji.

Zapis JSON 
{
  "name": string,
  "reportingName": string
}
Pola
name

string

To pole jest wymagane. Nazwa zdarzenia licznika.
reportingName

string

To pole jest wymagane. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach.

AudioVideoOffset

Długość odtwarzania dźwięku lub filmu.

Zapis JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Pola
Pole sumy offset. Wartość przesunięcia. offset może być tylko jedną z tych wartości:
percentage

string (int64 format)

Przesunięcie w procentach czasu trwania dźwięku lub wideo.
seconds

string (int64 format)

Opóźnienie (w sekundach) od początku ścieżki audio lub wideo.

UniversalAdId

Unikalny identyfikator kreacji podawany przez rejestr na wszystkich platformach. Są one częścią standardu VAST 4.0.

Zapis JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Pola
id

string

Unikalny identyfikator kreacji.
registry

enum (UniversalAdRegistry)

Rejestr udostępnia unikalne identyfikatory kreacji.

UniversalAdRegistry

Rejestr zawiera unikalne identyfikatory kreacji w uniwersalnym identyfikatorze reklamy.

Wartości w polu enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Rejestr Universal Ads jest nieokreślony lub nieznany w tej wersji.
UNIVERSAL_AD_REGISTRY_OTHER Użyj dostawcy niestandardowego, aby podać uniwersalny identyfikator reklamy.
UNIVERSAL_AD_REGISTRY_AD_ID Użyj identyfikatora reklamy, aby podać uniwersalny identyfikator reklamy.
UNIVERSAL_AD_REGISTRY_CLEARCAST Użyj pola Clearcast.co.uk, aby podać uniwersalny identyfikator reklamy.
UNIVERSAL_AD_REGISTRY_DV360 Podaj uniwersalny identyfikator reklamy, korzystając z Display & Video 360.
UNIVERSAL_AD_REGISTRY_CM Podaj uniwersalny identyfikator reklamy w usłudze Campaign Manager 360.

ThirdPartyUrl

Linki monitorujące firm zewnętrznych do śledzenia interakcji z kreacjami audio i wideo.

Zapis JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Pola
type

enum (ThirdPartyUrlType)

Typ interakcji musi być śledzony za pomocą linku monitorującego.
url

string

Link monitorujący używany do śledzenia interakcji.

Podaj adres URL ze ścieżką lub ciągiem zapytania rozpoczynającym się od https:. np. https://www.example.com/path.

ThirdPartyUrlType

Typ interakcji musi być śledzony za pomocą linku monitorującego firmy zewnętrznej.

Wartości w polu enum
THIRD_PARTY_URL_TYPE_UNSPECIFIED Typ adresu URL firmy zewnętrznej jest nieokreślony lub nieznany w tej wersji.
THIRD_PARTY_URL_TYPE_IMPRESSION Służy do zliczenia wyświetleń kreacji po zakończeniu buforowania dźwięku lub obrazu.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Dane służą do śledzenia kliknięć ścieżki dźwiękowej lub wideo przez użytkowników.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Służy do śledzenia, ile razy użytkownik włączył odtwarzanie dźwięku lub filmu.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Służy do śledzenia liczby odtworzeń dźwięku lub wideo do 25% jego długości.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Służy do śledzenia liczby odtworzeń dźwięku lub wideo do 50% jego długości.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Służy do śledzenia liczby odtworzeń dźwięku lub wideo do 75% jego długości.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Służy do śledzenia liczby odtworzeń dźwięku lub wideo do końca.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Służy do śledzenia, ile razy użytkownik wyciszył dźwięk lub obraz.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Służy do śledzenia, ile razy użytkownik wstrzymał odtwarzanie dźwięku lub obrazu.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Dane służą do śledzenia, ile razy użytkownik ponownie odtworzył dźwięk lub film.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Służy do śledzenia, ile razy użytkownik podczas oglądania filmu włączył tryb pełnoekranowy.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Służy do śledzenia, ile razy użytkownik zatrzymał odtwarzanie dźwięku lub obrazu.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Służy do śledzenia liczby kliknięć niestandardowych wykonanych przez użytkownika, takich jak kliknięcie ciekawego miejsca w filmie.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Służy do śledzenia liczby pominięć dźwięku lub obrazu.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Służy do śledzenia liczby odtworzeń dźwięku lub wideo z dokładnością określoną przez progressOffset.

Transkoduj

Reprezentuje informacje o transkodowanym pliku audio lub wideo.

Zapis JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Pola
name

string

Nazwa transkodowanego pliku.
mimeType

string

Typ MIME transkodowanego pliku.
transcoded

boolean

Wskazuje, czy transkodowanie się udało.
dimensions

object (Dimensions)

Wymiary transkodowanego filmu.
bitRateKbps

string (int64 format)

Szybkość transmisji bitów transkodowanego filmu (jako liczba kilobitów na sekundę).
frameRate

number

Liczba klatek transkodowanego filmu (w klatkach na sekundę).
audioBitRateKbps

string (int64 format)

Szybkość transmisji bitów strumienia audio transkodowanego wideo lub szybkość transmisji bitów transkodowanego dźwięku (jako liczba kilobitów na sekundę).
audioSampleRateHz

string (int64 format)

Częstotliwość próbkowania strumienia audio transkodowanego filmu lub częstotliwość próbkowania transkodowanego audio podana w hercach.
fileSizeBytes

string (int64 format)

Rozmiar transkodowanego pliku (w bajtach).

CmTrackingAd

Reklama śledząca w usłudze Campaign Manager 360.

Zapis JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Pola
cmPlacementId

string (int64 format)

Identyfikator miejsca docelowego reklamy śledzącej Campaign Managera 360.
cmCreativeId

string (int64 format)

Identyfikator kreacji reklamy śledzącej w usłudze Campaign Manager 360.
cmAdId

string (int64 format)

Identyfikator reklamy śledzącej w usłudze Menedżer kampanii 360.

ObaIcon

Ikona OBA dla kreacji

Zapis JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Pola
resourceUrl

string

Adres URL zasobu ikony OBA.
resourceMimeType

string

Typ MIME zasobu ikony OBA.
position

enum (ObaIconPosition)

Pozycja ikony OBA w kreacji.
dimensions

object (Dimensions)

Wymiary ikony OBA.
program

string

Program ikony OBA. na przykład: „Informacja”.
landingPageUrl

string

To pole jest wymagane. Adres URL strony docelowej ikony OBA.

Dozwolone są tylko adresy URL następujących domen:
clickTrackingUrl

string

To pole jest wymagane. Link monitorujący kliknięcia ikony OBA.

Dozwolone są tylko adresy URL następujących domen:
viewTrackingUrl

string

To pole jest wymagane. Link monitorujący wyświetlenia ikony OBA.

Dozwolone są tylko adresy URL następujących domen:

ObaIconPosition

Pozycja ikony OBA w kreacji.

Wartości w polu enum
OBA_ICON_POSITION_UNSPECIFIED Pozycja ikony programu OBA nie jest określona.
OBA_ICON_POSITION_UPPER_RIGHT W prawym górnym rogu kreacji.
OBA_ICON_POSITION_UPPER_LEFT W lewym górnym rogu kreacji.
OBA_ICON_POSITION_LOWER_RIGHT W prawym dolnym rogu kreacji.
OBA_ICON_POSITION_LOWER_LEFT W lewym dolnym rogu kreacji.

ExpandingDirection

Kierunek rozwijania kreacji rozwijanej firmy zewnętrznej.

Wartości w polu enum
EXPANDING_DIRECTION_UNSPECIFIED Kierunek rozwijania nie jest określony.
EXPANDING_DIRECTION_NONE Nie rozwija się w żadnym kierunku.
EXPANDING_DIRECTION_UP Rozwija się w górę.
EXPANDING_DIRECTION_DOWN Rozwija się w dół.
EXPANDING_DIRECTION_LEFT Rozwija się w lewo.
EXPANDING_DIRECTION_RIGHT Rozwija się w prawo.
EXPANDING_DIRECTION_UP_AND_LEFT Rozwija się w górę i w lewo.
EXPANDING_DIRECTION_UP_AND_RIGHT Rozwija się w górę i w prawo.
EXPANDING_DIRECTION_DOWN_AND_LEFT Rozwinie się w dół i w lewo.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Rozwinie się w dół i w prawo.
EXPANDING_DIRECTION_UP_OR_DOWN Rozwija się w górę lub w dół.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Rozwija się w lewo lub w prawo.
EXPANDING_DIRECTION_ANY_DIAGONAL Można ją rozwijać w dowolnym kierunku po przekątnej.

Metody

create

 Tworzy nową kreację.

delete

 Usuwa kreację.

get

 Generuje kreację.

list

 Wyświetla listę kreacji reklamodawcy.

patch

 Aktualizuje istniejącą kreację.