REST Resource: advertisers.creatives

Zasób: Creative

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. Przypisany 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 Managerem.

displayName

string

Wymagany. Wyświetlana nazwa kreacji.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.

entityStatus

enum (EntityStatus)

Wymagany. Określa, czy kreacja może się wyświetlać.

Akceptowane wartości:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy kreacja została ostatnio zaktualizowana przez użytkownika lub system (np. podczas sprawdzania kreacji). Przypisany przez system.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

createTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

creativeType

enum (CreativeType)

Wymagany. Niezmienna. Typ kreacji.

hostingSource

enum (HostingSource)

Wymagany. Wskazuje, gdzie jest hostowana kreacja.

dynamic

boolean

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

dimensions

object (Dimensions)

Wymagany. Podstawowe wymiary kreacji. Dotyczy wszystkich typów kreacji. Wartość parametrów widthPixels i heightPixels jest domyślnie ustawiona na 0, gdy parametr creativeType ma jedną z tych wartości:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Opcjonalnie: dodatkowe wymiary; Dotyczy, gdy creativeType jest jedną z tych wartości:

  • 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ą wartości widthPixels i heightPixels, które muszą być większe lub równe 0.

mediaDuration

string (Duration format)

Tylko dane wyjściowe. Czas trwania multimediów kreacji. Dotyczy, gdy creativeType jest jedną z tych wartości:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

creativeAttributes[]

enum (CreativeAttribute)

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

reviewStatus

object (ReviewStatusInfo)

Tylko dane wyjściowe. Aktualny stan procesu sprawdzania kreacji.

assets[]

object (AssetAssociation)

Wymagany. Komponenty powiązane z tą kreacją.

exitEvents[]

object (ExitEvent)

Wymagany. Zdarzenia wyjścia z tej kreacji. Wyjście (nazywane też tagiem kliknięcia) to dowolny obszar w obrębie kreacji, który użytkownik może kliknąć, aby 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()), aby śledzić wyjścia w formatach rich media.
timerEvents[]

object (TimerEvent)

Opcjonalnie: Niestandardowe zdarzenia licznika czasu w kreacji multimedialnej. Liczniki czasu rejestrują czas, przez jaki użytkownik oglądał konkretną część kreacji multimedialnej i wchodził z nią w interakcję. Kreacja może zawierać wiele zdarzeń stopera. Czas każdego z nich mierzymy osobno. Pozostaw to pole puste lub niewypełnione w przypadku kreacji zawierających tylko komponenty z obrazem.

counterEvents[]

object (CounterEvent)

Opcjonalnie: Zdarzenia licznika w kreacji multimedialnej. Liczniki śledzą liczbę określonych interakcji użytkownika z dowolną częścią kreacji multimedialnej (najechanie kursorem myszy na reklamę, wyjechanie poza nią, kliknięcie, kliknięcie, wczytanie danych, użycie klawiatury itp.). Za pomocą licznika można rejestrować wszystkie zdarzenia, które da się przechwycić w kreacji. Pozostaw to pole puste lub niewypełnione w przypadku kreacji zawierających tylko komponenty z obrazem.

appendedTag

string

Opcjonalnie: Tag śledzenia HTML innej firmy, który ma zostać dołączony do tagu kreacji.

integrationCode

string

Opcjonalnie: Informacje identyfikacyjne służące do połączenia tej kreacji z zewnętrznym systemem. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 10 tys. znaków.

notes

string

Opcjonalnie: Uwagi użytkownika dotyczące tej kreacji. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 20 000 znaków.

iasCampaignMonitoring

boolean

Opcjonalnie: Wskazuje, czy monitorowanie kampanii Integral Ad Science (IAS) jest włączone. Aby włączyć tę funkcję w przypadku kreacji, upewnij się, że w polu Advertiser.creative_config.ias_client_id jest ustawiony identyfikator klienta IAS.

companionCreativeIds[]

string (int64 format)

Opcjonalnie: Identyfikatory kreacji towarzyszących kreacji wideo.

Możesz przypisać istniejące kreacje displayowe (z komponentami z obrazem lub komponentami HTML5), które będą wyświetlane w odtwarzaczu wydawcy. Kreacje 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 tych creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

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

To pole jest obsługiwane tylko w przypadku tych creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

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

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

To pole jest obsługiwane tylko w przypadku tych creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Opcjonalnie: Czas odtwarzania filmu, po którym odliczanie wyświetleń rozpocznie się od nowa.

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

To pole jest obsługiwane tylko w przypadku tych creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

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

Uniwersalny identyfikator reklamy jest częścią standardu VAST 4.0. Po utworzeniu kreacji można ją zmodyfikować.

To pole jest obsługiwane tylko w przypadku tych creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Opcjonalnie: Linki monitorujące firm zewnętrznych służące do śledzenia interakcji z kreacją wideo.

To pole jest obsługiwane tylko w przypadku tych creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Tylko dane wyjściowe. Transkodowanie audio/wideo.

Transkoduje zasób główny 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 do rozmiaru ekranu.

To pole jest obsługiwane tylko w tych creativeType:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Opcjonalnie: linki monitorujące dla dostawców usług analitycznych lub zewnętrznych dostawców technologii reklamowych;

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

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

W tym polu można zapisywać dane tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Opcjonalnie: Adres URL pomiaru JavaScript od obsługiwanych zewnętrznych dostawców usług weryfikacyjnych (ComScore, DoubleVerify, IAS, Moat). Tagi skryptu HTML nie są obsługiwane.

W tym polu można zapisywać dane tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Opcjonalnie: Reklama śledząca w usłudze Campaign Manager 360 powiązana z elementem kreacji.

Opcjonalne w przypadku tych elementów creativeType, jeśli zostały utworzone przez reklamodawcę, który korzysta zarówno z Campaign Managera 360, jak i z wyświetlania reklam przez firmy zewnętrzne:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

W innych przypadkach dane wyjściowe.

obaIcon

object (ObaIcon)

Opcjonalnie: Określa ikonę OBA dla kreacji wideo.

To pole jest obsługiwane tylko w tych creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Opcjonalnie: Pierwotny tag usługi zewnętrznej użyty w kreacji.

Wymagane i obowiązujące tylko w przypadku kreacji z tagami innych firm.

Kreacje z tagami innych firm to kreacje z tymi elementami: hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Opcjonalnie: Wskazuje, że kreacja wymaga specyfikacji MRAID (system Mobile Rich Media Ad Interface Definitions).

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

Opcjonalny i dostępny tylko w przypadku kreacji z tagami innych firm.

Kreacje z tagami innych firm to kreacje z tymi elementami: hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Opcjonalnie: Wskazuje, że do prawidłowego renderowania kreacja wymaga kodu HTML5.

Opcjonalny i dostępny tylko w przypadku kreacji z tagami innych firm. Kreacje z tagami innych firm to kreacje z tymi elementami: hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

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

Dozwolone tylko w przypadku reklamy śledzącej Campaign Managera 360 z parametrem serwera reklamowego firmy zewnętrznej i makrem ${DC_DBM_TOKEN}.

Opcjonalny i obowiązuje tylko w przypadku kreacji z tagiem zewnętrznym lub kreacji z tagiem VAST zewnętrznej firmy.

Kreacje z tagami innych firm to kreacje z tymi elementami: hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Kreacje z tagiem VAST firmy zewnętrznej to kreacje z tymi hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Opcjonalnie: Określa kierunek rozwijania kreacji.

Wymagane i obowiązujące tylko w przypadku kreacji rozwijanych innych firm.

Kreacje rozwijane innych firm to kreacje z tym źródłem hostowania:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Opcjonalnie: Wskazuje, że kreacja rozwinie się automatycznie po najechaniu na nią kursorem.

Opcjonalny i obowiązuje tylko w przypadku kreacji rozwijanych innych firm. Kreacje rozwijane innych firm to kreacje z tym źródłem hostowania:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Opcjonalnie: Adres URL tagu VAST dla kreacji tagu VAST firmy zewnętrznej.

Wymagane i obowiązujące tylko w przypadku kreacji z tagiem VAST innej firmy.

Kreacje z tagiem VAST firmy zewnętrznej to kreacje z tymi hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

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

Tylko dane wyjściowe. Dotyczy tylko kreacji z tagiem VAST usługi zewnętrznej.

Kreacje z tagiem VAST firmy zewnętrznej to kreacje z tymi hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Tylko dane wyjściowe. Wskazuje, że kreacja tagu VAST innej firmy wymaga obsługi wideo HTML5.

Tylko dane wyjściowe. Dotyczy tylko kreacji z tagiem VAST usługi zewnętrznej.

Kreacje z tagiem VAST firmy zewnętrznej to kreacje z tymi hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

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

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

mp3Audio

boolean

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

Dostępne tylko w przypadku kreacji audio pochodzących od innych firm.

Kreacje audio innych firm to kreacje z tymi elementami: hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

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

Dostępne tylko w przypadku kreacji audio pochodzących od innych firm.

Kreacje audio innych firm to kreacje z tymi elementami: hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

w połączeniu z tymi atrybutami creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

Możliwe źródła hostowania kreacji. Wskazuje, gdzie kreacja została utworzona i hostowana.

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 synchronizowana z Campaign Managerem 360.

Metody tworzenia i aktualizowania 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 aktualizowania są obsługiwane w przypadku tego typu hostowania, jeśli creativeType to:

  • 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 aktualizowania są obsługiwane w przypadku tego typu hostowania, jeśli creativeType to:

  • 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 Rich Media utworzona w Studio i hostowana w usłudze Campaign Manager 360.

Metody tworzenia i aktualizowania 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 jest kreacją VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR Kreacja jest linearną kreacją VPAID.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR Kreacja jest nieliniową kreacją 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)

Oznacza podstawowe zatwierdzenie niezbędne do rozpoczęcia wyświetlania kreacji. Podsumowanie creativeAndLandingPageReviewStatuscontentAndPolicyReviewStatus.

creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Stan weryfikacji kreacji i strony docelowej.

contentAndPolicyReviewStatus

enum (ReviewStatus)

Stan weryfikacji treści i zgodności z zasadami reklamowymi.

exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Stany sprawdzania kreacji przez giełdę.

publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Stany sprawdzania kreacji przez wydawcę.

Stan zatwierdzenia

Możliwe typy stanu zatwierdzenia. Jest to podsumowanie creativeAndLandingPageReviewStatuscontentAndPolicyReviewStatus.

Wartości w polu enum
APPROVAL_STATUS_UNSPECIFIED Wartość typu nie została określona lub jest nieznana w tej wersji.
APPROVAL_STATUS_PENDING_NOT_SERVABLE Kreacja jest wciąż sprawdzana i nie może się wyświetlać.
APPROVAL_STATUS_PENDING_SERVABLE Kreacja przeszła weryfikację kreacji i strony docelowej i może być wyświetlana, ale czeka na dodatkową weryfikację zawartości i zgodności z zasadami.
APPROVAL_STATUS_APPROVED_SERVABLE Sprawdzanie kreacji i strony docelowej oraz weryfikacja treści i zgodności z zasadami zostały zatwierdzone. Kreacja może być wyświetlana.
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 stany weryfikacji.

Wartości w polu enum
REVIEW_STATUS_UNSPECIFIED Wartość typu nie została 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 sprawdzania kreacji na giełdzie.

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

enum (Exchange)

Giełda sprawdza kreację.

status

enum (ReviewStatus)

Stan sprawdzania wymiany.

PublisherReviewStatus

Stan sprawdzania kreacji przez wydawcę.

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

string

Wydawca sprawdza kreację.

status

enum (ReviewStatus)

Stan weryfikacji wydawcy.

AssetAssociation

Powiązanie komponentu z kreacją.

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

object (Asset)

Opcjonalnie: Powiązany zasób.

role

enum (AssetRole)

Opcjonalnie: Rola komponentu w kreacji.

Komponent

pojedynczy zasób;

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

string (int64 format)

Identyfikator multimediów przesłanego zasobu. To jest unikalny identyfikator zasobu. Ten identyfikator można przekazywać do innych wywołań interfejsu API, np. creatives.create, aby powiązać komponent z kreacją.

Pole identyfikatora multimediów zostało zaktualizowane 5 kwietnia 2023 r. Zaktualizuj identyfikatory multimediów zapisane w pamięci podręcznej przed 5 kwietnia 2023 r., pobierając nowy identyfikator multimediów z powiązanych zasobów kreacji lub ponownie przesyłając zasób.

content

string

Treść zasobu. W przypadku przesłanych zasobów treścią jest ścieżka wyświetlania.

AssetRole

Rola komponentu w kreacji.

Wartości w polu enum
ASSET_ROLE_UNSPECIFIED W tej wersji nie określono roli komponentu lub jest ona nieznana.
ASSET_ROLE_MAIN Zasób jest głównym zasobem kreacji.
ASSET_ROLE_BACKUP Zasób jest komponentem zapasowym kreacji.
ASSET_ROLE_POLITE_LOAD Zasób jest komponentem kreacji z łagodnym wczytywaniem.
ASSET_ROLE_HEADLINE

Nagłówek kreacji natywnej.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 25 znaków.

Ta rola jest obsługiwana tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Długi nagłówek kreacji natywnej.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 50 znaków.

Ta rola jest obsługiwana tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Tekst główny kreacji natywnej.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 90 znaków.

Ta rola jest obsługiwana tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Długi tekst główny kreacji natywnej.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 150 znaków.

Ta rola jest obsługiwana tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Krótka, prosta wersja adresu URL strony docelowej, która będzie się wyświetlać w kreacji. Ten adres URL informuje użytkowników, na jaką stronę trafią po kliknięciu kreacji.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 30 znaków.

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

Ta rola jest obsługiwana tylko w tych 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 kreacji natywnej.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 15 znaków.

Ta rola jest obsługiwana tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Tekst określający reklamodawcę lub nazwę marki.

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 25 znaków.

Ta rola jest obsługiwana tylko w tych creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Cena zakupu aplikacji w sklepie Google Play lub sklepie z aplikacjami na iOS (np.5, 99 PLN).

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

Wartość content musi być zakodowana w formacie UTF-8 i mieć maksymalnie 15 znaków.

Zasoby tej roli są tylko do odczytu.

ASSET_ROLE_ANDROID_APP_ID

Identyfikator aplikacji na Androida w Sklepie Google Play.

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

Zasoby tej roli są tylko do odczytu.

ASSET_ROLE_IOS_APP_ID

Identyfikator aplikacji na iOS w sklepie Apple App Store.

Ten numer identyfikacyjny znajdziesz w adresie URL Apple App Store jako ciąg cyfr bezpośrednio po fragmencie „id”. Na przykład w https://apps.apple.com/us/app/gmail-email-by-google/id422689480 identyfikator to 422689480.

Zasoby tej roli są tylko do odczytu.

ASSET_ROLE_RATING

Ocena aplikacji w Sklepie Google Play lub w App Store na iOS.

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

Zasoby tej roli są tylko do odczytu.

ASSET_ROLE_ICON

Ikona kreacji.

Ta rola jest obsługiwana i wymagana tylko w tych 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 creativeType:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Główny kolor do użycia w kreacji.

Ta rola jest obsługiwana i wymagana tylko w tych creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Kolor akcentu, który ma być używany w kreacji.

Ta rola jest obsługiwana i wymagana tylko w tych creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Określa, czy kreacja musi zawierać komponent z obrazem.

Ta rola jest obsługiwana i wymagana tylko w tych creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Określa, czy w kreacji można stosować ulepszenia komponentów.

Ta rola jest obsługiwana i wymagana tylko w tych creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Zdarzenie wyjściowe kreacji.

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

enum (ExitEventType)

Wymagany. Typ zdarzenia wyjściowego.

url

string

Wymagany. Docelowy URL zdarzenia wyjściowego. Jest to wymagane, gdy type ma wartość:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Opcjonalnie: Nazwa tagu kliknięcia zdarzenia wyjściowego.

Nazwa musi być niepowtarzalna w ramach jednej kreacji.

Pozostaw to pole puste lub niewypełnione w przypadku kreacji zawierających tylko komponenty z obrazem.

reportingName

string

Opcjonalnie: Nazwa, która pozwala zidentyfikować to zdarzenie w raportach. Pozostaw to pole puste lub niewypełnione w przypadku kreacji zawierających tylko komponenty z obrazem.

ExitEventType

Typ zdarzenia wyjściowego.

Wartości w polu enum
EXIT_EVENT_TYPE_UNSPECIFIED Typ zdarzenia wyjściowego nie jest określony lub jest nieznany w tej wersji.
EXIT_EVENT_TYPE_DEFAULT Zdarzenie wyjściowe jest zdarzeniem domyślnym.
EXIT_EVENT_TYPE_BACKUP Zdarzenie wyjściowe jest zdarzeniem wyjściowym zapasowym. W kreacji może występować kilka zapasowych zdarzeń wyjściowych.

TimerEvent

Zdarzenie licznika czasu kreacji.

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

string

Wymagany. Nazwa zdarzenia związanego z licznikiem czasu.

reportingName

string

Wymagany. Nazwa używana do identyfikowania tego zdarzenia związanego ze stoperem w raportach.

CounterEvent

Zdarzenie licznika kreacji.

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

string

Wymagany. Nazwa zdarzenia związanego z licznikiem.

reportingName

string

Wymagany. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach.

AudioVideoOffset

Długość odtworzonego 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 unii offset. Wartość przesunięcia. offset może być tylko jednym z tych elementów:
percentage

string (int64 format)

Opcjonalnie: Opóźnienie w procentach czasu trwania dźwięku lub filmu.

seconds

string (int64 format)

Opcjonalnie: Opóźnienie w sekundach od początku dźwięku lub filmu.

UniversalAdId

Identyfikator kreacji podany przez rejestr, który jest unikalny na wszystkich platformach. Jest to część standardu VAST 4.0.

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

string

Opcjonalnie: Unikalny identyfikator kreacji.

registry

enum (UniversalAdRegistry)

Opcjonalnie: Rejestr zawiera unikalne identyfikatory kreacji.

UniversalAdRegistry

Rejestr zawiera unikalne identyfikatory kreacji w uniwersalnym identyfikatorze reklamy.

Wartości w polu enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Rejestr uniwersalnych reklam jest w tej wersji nieokreślony lub nieznany.
UNIVERSAL_AD_REGISTRY_OTHER Aby podać uniwersalny identyfikator reklamy, użyj niestandardowego dostawcy.
UNIVERSAL_AD_REGISTRY_AD_ID Aby podać uniwersalny identyfikator reklamy, użyj identyfikatora wyświetlania reklam.
UNIVERSAL_AD_REGISTRY_CLEARCAST Aby podać uniwersalny identyfikator reklamy, skorzystaj z witryny clearcast.co.uk.
UNIVERSAL_AD_REGISTRY_DV360 Aby podać identyfikator reklamy uniwersalnej, użyj Display & Video 360.
UNIVERSAL_AD_REGISTRY_CM Aby podać identyfikator reklamy uniwersalnej, użyj Campaign Managera 360.

ThirdPartyUrl

Linki monitorujące pochodzące od firm zewnętrznych, które służą do śledzenia interakcji z kreacją audio lub wideo.

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

enum (ThirdPartyUrlType)

Opcjonalnie: Typ interakcji musi być śledzony przez link monitorujący

url

string

Opcjonalnie: Link monitorujący służący do śledzenia interakcji.

Podaj adres URL z opcjonalną ścieżką lub ciągiem zapytania, który zaczyna się od https:. na przykład https://www.example.com/path.

ThirdPartyUrlType

Typ interakcji musi być śledzony przez link monitorujący firmy zewnętrznej.

Wartości w polu enum
THIRD_PARTY_URL_TYPE_UNSPECIFIED W tej wersji nie określono typu adresu URL strony zewnętrznej lub jest on nieznany.
THIRD_PARTY_URL_TYPE_IMPRESSION Służy do zliczania wyświetleń kreacji po zakończeniu buforowania dźwięku lub filmu.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Służy do śledzenia kliknięć użytkownika w audio lub filmie.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Służy do śledzenia, ile razy użytkownik rozpoczął odtwarzanie zasobu audio lub wideo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Służy do śledzenia liczby odtworzeń zasobu audio lub wideo do 25% jego długości.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Służy do śledzenia liczby odtworzeń zasobu audio lub wideo do 50% jego długości.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Służy do śledzenia liczby odtworzeń zasobu audio lub wideo do 75% jego długości.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Służy do śledzenia liczby odtworzeń zasobu audio 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 zasobu audio lub wideo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Służy do śledzenia, ile razy użytkownik odtworzył zasób audio lub wideo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Służy do śledzenia, ile razy użytkownik rozwinął odtwarzacz do pełnego ekranu.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Służy do śledzenia, ile razy użytkownik zatrzymał odtwarzanie zasobu audio lub wideo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Służy do śledzenia, ile razy użytkownik wykonał kliknięcie niestandardowe, takie jak kliknięcie ciekawego miejsca w filmie.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Służy do śledzenia, ile razy użytkownik pominął odtwarzanie zasobu audio lub wideo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Służy do śledzenia liczby odtworzeń zasobu audio lub wideo do wartości offsetu określonej przez parametr progressOffset.

Transkodowanie

Zawiera informacje o przetworzonym 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

Opcjonalnie: Nazwa przetranskodowanego pliku.

mimeType

string

Opcjonalnie: Typ MIME przetranskodowanego pliku.

transcoded

boolean

Opcjonalnie: Wskazuje, czy transkodowanie zostało przeprowadzone.

dimensions

object (Dimensions)

Opcjonalnie: Wymiary transkodowanego filmu.

bitRateKbps

string (int64 format)

Opcjonalnie: Szybkość transmisji bitów transkodowanego filmu (w kilobitach na sekundę).

frameRate

number

Opcjonalnie: Liczba klatek w transkodowanym filmie (w klatkach na sekundę).

audioBitRateKbps

string (int64 format)

Opcjonalnie: Szybkość transmisji bitów strumienia audio transkodowanego wideo lub szybkość transmisji bitów transkodowanego audio (w kilobitach na sekundę).

audioSampleRateHz

string (int64 format)

Opcjonalnie: Częstotliwość próbkowania strumienia audio transkodowanego wideo lub częstotliwość próbkowania transkodowanego dźwięku w hercach.

fileSizeBytes

string (int64 format)

Opcjonalnie: Rozmiar przekonwertowanego pliku (w bajtach).

CmTrackingAd

Reklama śledząca Campaign Managera 360.

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

string (int64 format)

Opcjonalnie: Identyfikator miejsca docelowego w reklamie śledzącej w usłudze Campaign Manager 360.

cmCreativeId

string (int64 format)

Opcjonalnie: Identyfikator kreacji w reklamie śledzącej w usłudze Campaign Manager 360.

cmAdId

string (int64 format)

Opcjonalnie: Identyfikator reklamy śledzącej w Campaign Managerze 360.

ObaIcon

Ikona programu 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

Opcjonalnie: Adres URL zasobu ikony OBA.

resourceMimeType

string

Opcjonalnie: Typ MIME zasobu ikony programu OBA.

position

enum (ObaIconPosition)

Opcjonalnie: Pozycja ikony OBA na kreacji.

dimensions

object (Dimensions)

Opcjonalnie: Wymiary ikony OBA.

program

string

Opcjonalnie: Program, do którego należy ikona OBA. Na przykład: „AdChoices”.

landingPageUrl

string

Wymagany. Adres URL strony docelowej ikony OBA.

Dozwolone są tylko adresy URL z tych domen:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

Wymagany. Link monitorujący kliknięcia ikony OBA.

Dozwolone są tylko adresy URL z tych domen:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

Wymagany. Link monitorujący wyświetlenia ikony OBA.

Dozwolone są tylko adresy URL z tych domen:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

Pozycja ikony OBA na kreacji.

Wartości w polu enum
OBA_ICON_POSITION_UNSPECIFIED Nie określono pozycji ikony OBA.
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 Nie podano kierunku rozwijania.
EXPANDING_DIRECTION_NONE nie rozszerza się w żaden sposób;
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 Rozwija się w dół i w lewo.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Rozwija się w dół i w prawo.
EXPANDING_DIRECTION_UP_OR_DOWN Rozwija w górę lub w dół.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Rozwija się w lewo lub w prawo.
EXPANDING_DIRECTION_ANY_DIAGONAL Może się rozszerzać w dowolnym kierunku po przekątnej.

Metody

create

Tworzy nową kreację.

delete

Usuwa kreację.

get

Pobiera kreację.

list

Lista kreacji reklamodawcy.

patch

aktualizuje istniejącą kreację.