- Zasób: kreacja
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- Zasób
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- Transkodowanie
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- Metody
Zasób: Creative
pojedyncza kreacja,
Zapis JSON |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu kreacji. |
advertiserId |
Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy kreacja. |
creativeId |
Tylko dane wyjściowe. Unikalny identyfikator kreacji. Przypisany przez system. |
cmPlacementId |
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 |
Wymagany. Wyświetlana nazwa kreacji. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. |
entityStatus |
Wymagany. Określa, czy kreacja może się wyświetlać. Akceptowane wartości:
|
updateTime |
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: |
createTime |
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: |
creativeType |
Wymagany. Niezmienna. Typ kreacji. |
hostingSource |
Wymagany. Wskazuje, gdzie jest hostowana kreacja. |
dynamic |
Tylko dane wyjściowe. Wskazuje, czy kreacja jest dynamiczna. |
dimensions |
Wymagany. Podstawowe wymiary kreacji. Dotyczy wszystkich typów kreacji. Wartość parametrów
|
additionalDimensions[] |
Opcjonalnie: dodatkowe wymiary; Dotyczy, gdy
Jeśli to pole jest określone, wymagane są wartości |
mediaDuration |
Tylko dane wyjściowe. Czas trwania multimediów kreacji. Dotyczy, gdy
Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
creativeAttributes[] |
Tylko dane wyjściowe. Lista atrybutów kreacji wygenerowanych przez system. |
reviewStatus |
Tylko dane wyjściowe. Aktualny stan procesu sprawdzania kreacji. |
assets[] |
Wymagany. Komponenty powiązane z tą kreacją. |
exitEvents[] |
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:
|
timerEvents[] |
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[] |
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 |
Opcjonalnie: Tag śledzenia HTML innej firmy, który ma zostać dołączony do tagu kreacji. |
integrationCode |
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 |
Opcjonalnie: Uwagi użytkownika dotyczące tej kreacji. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 20 000 znaków. |
iasCampaignMonitoring |
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 |
companionCreativeIds[] |
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 To pole jest obsługiwane tylko w przypadku tych
|
skippable |
Opcjonalnie: Określa, czy użytkownik może pominąć kreację wideo. To pole jest obsługiwane tylko w przypadku tych
|
skipOffset |
Opcjonalnie: Czas odtwarzania filmu do momentu wyświetlenia przycisku pominięcia. To pole jest wymagane, gdy To pole jest obsługiwane tylko w przypadku tych
|
progressOffset |
Opcjonalnie: Czas odtwarzania filmu, po którym odliczanie wyświetleń rozpocznie się od nowa. To pole jest wymagane, gdy To pole jest obsługiwane tylko w przypadku tych
|
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
|
thirdPartyUrls[] |
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
|
transcodes[] |
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
|
trackerUrls[] |
Opcjonalnie: linki monitorujące dla dostawców usług analitycznych lub zewnętrznych dostawców technologii reklamowych; Adresy URL muszą zaczynać się od 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
|
jsTrackerUrl |
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
|
cmTrackingAd |
Opcjonalnie: Reklama śledząca w usłudze Campaign Manager 360 powiązana z elementem kreacji. Opcjonalne w przypadku tych elementów
W innych przypadkach dane wyjściowe. |
obaIcon |
Opcjonalnie: Określa ikonę OBA dla kreacji wideo. To pole jest obsługiwane tylko w tych
|
thirdPartyTag |
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:
w połączeniu z tymi atrybutami
|
requireMraid |
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:
w połączeniu z tymi atrybutami
|
requireHtml5 |
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:
w połączeniu z tymi atrybutami
|
requirePingForAttribution |
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:
w połączeniu z tymi atrybutami
Kreacje z tagiem VAST firmy zewnętrznej to kreacje z tymi
w połączeniu z tymi atrybutami
|
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:
w połączeniu z tymi atrybutami
|
expandOnHover |
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:
w połączeniu z tymi atrybutami
|
vastTagUrl |
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
w połączeniu z tymi atrybutami
|
vpaid |
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
w połączeniu z tymi atrybutami
|
html5Video |
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
w połączeniu z tymi atrybutami
|
lineItemIds[] |
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 |
mp3Audio |
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:
w połączeniu z tymi atrybutami
|
oggAudio |
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:
w połączeniu z tymi atrybutami
|
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
|
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
|
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 ( |
Pola | |
---|---|
approvalStatus |
Oznacza podstawowe zatwierdzenie niezbędne do rozpoczęcia wyświetlania kreacji. Podsumowanie |
creativeAndLandingPageReviewStatus |
Stan weryfikacji kreacji i strony docelowej. |
contentAndPolicyReviewStatus |
Stan weryfikacji treści i zgodności z zasadami reklamowymi. |
exchangeReviewStatuses[] |
Stany sprawdzania kreacji przez giełdę. |
publisherReviewStatuses[] |
Stany sprawdzania kreacji przez wydawcę. |
Stan zatwierdzenia
Możliwe typy stanu zatwierdzenia. Jest to podsumowanie creativeAndLandingPageReviewStatus
i contentAndPolicyReviewStatus
.
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 ( |
Pola | |
---|---|
exchange |
Giełda sprawdza kreację. |
status |
Stan sprawdzania wymiany. |
PublisherReviewStatus
Stan sprawdzania kreacji przez wydawcę.
Zapis JSON |
---|
{
"publisherName": string,
"status": enum ( |
Pola | |
---|---|
publisherName |
Wydawca sprawdza kreację. |
status |
Stan weryfikacji wydawcy. |
AssetAssociation
Powiązanie komponentu z kreacją.
Zapis JSON |
---|
{ "asset": { object ( |
Pola | |
---|---|
asset |
Opcjonalnie: Powiązany zasób. |
role |
Opcjonalnie: Rola komponentu w kreacji. |
Komponent
pojedynczy zasób;
Zapis JSON |
---|
{ "mediaId": string, "content": string } |
Pola | |
---|---|
mediaId |
Identyfikator multimediów przesłanego zasobu. To jest unikalny identyfikator zasobu. Ten identyfikator można przekazywać do innych wywołań interfejsu API, np. 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 |
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ść Ta rola jest obsługiwana tylko w tych
|
ASSET_ROLE_LONG_HEADLINE |
Długi nagłówek kreacji natywnej. Wartość Ta rola jest obsługiwana tylko w tych
|
ASSET_ROLE_BODY |
Tekst główny kreacji natywnej. Wartość Ta rola jest obsługiwana tylko w tych
|
ASSET_ROLE_LONG_BODY |
Długi tekst główny kreacji natywnej. Wartość Ta rola jest obsługiwana tylko w tych
|
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ść 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
|
ASSET_ROLE_CALL_TO_ACTION |
Tekst wyświetlany na przycisku wezwania do działania kreacji natywnej. Wartość Ta rola jest obsługiwana tylko w tych
|
ASSET_ROLE_ADVERTISER_NAME |
Tekst określający reklamodawcę lub nazwę marki. Wartość Ta rola jest obsługiwana tylko w tych
|
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ść 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 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 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
|
ASSET_ROLE_COVER_IMAGE |
Obraz okładki natywnej kreacji wideo. Ta rola jest obsługiwana i wymagana tylko w tych
|
ASSET_ROLE_BACKGROUND_COLOR |
Główny kolor do użycia w kreacji. Ta rola jest obsługiwana i wymagana tylko w tych
|
ASSET_ROLE_ACCENT_COLOR |
Kolor akcentu, który ma być używany w kreacji. Ta rola jest obsługiwana i wymagana tylko w tych
|
ASSET_ROLE_REQUIRE_LOGO |
Określa, czy kreacja musi zawierać komponent logo. Ta rola jest obsługiwana i wymagana tylko w tych
|
ASSET_ROLE_REQUIRE_IMAGE |
Określa, czy kreacja musi zawierać komponent z obrazem. Ta rola jest obsługiwana i wymagana tylko w tych
|
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
|
ExitEvent
Zdarzenie wyjściowe kreacji.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Wymagany. Typ zdarzenia wyjściowego. |
url |
Wymagany. Docelowy URL zdarzenia wyjściowego. Jest to wymagane, gdy
|
name |
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 |
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 |
Wymagany. Nazwa zdarzenia związanego z licznikiem czasu. |
reportingName |
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 |
Wymagany. Nazwa zdarzenia związanego z licznikiem. |
reportingName |
Wymagany. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach. |
AudioVideoOffset
Długość odtworzonego dźwięku lub filmu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole unii offset . Wartość przesunięcia. offset może być tylko jednym z tych elementów: |
|
percentage |
Opcjonalnie: Opóźnienie w procentach czasu trwania dźwięku lub filmu. |
seconds |
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 ( |
Pola | |
---|---|
id |
Opcjonalnie: Unikalny identyfikator kreacji. |
registry |
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 ( |
Pola | |
---|---|
type |
Opcjonalnie: Typ interakcji musi być śledzony przez link monitorujący |
url |
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 |
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 ( |
Pola | |
---|---|
name |
Opcjonalnie: Nazwa przetranskodowanego pliku. |
mimeType |
Opcjonalnie: Typ MIME przetranskodowanego pliku. |
transcoded |
Opcjonalnie: Wskazuje, czy transkodowanie zostało przeprowadzone. |
dimensions |
Opcjonalnie: Wymiary transkodowanego filmu. |
bitRateKbps |
Opcjonalnie: Szybkość transmisji bitów transkodowanego filmu (w kilobitach na sekundę). |
frameRate |
Opcjonalnie: Liczba klatek w transkodowanym filmie (w klatkach na sekundę). |
audioBitRateKbps |
Opcjonalnie: Szybkość transmisji bitów strumienia audio transkodowanego wideo lub szybkość transmisji bitów transkodowanego audio (w kilobitach na sekundę). |
audioSampleRateHz |
Opcjonalnie: Częstotliwość próbkowania strumienia audio transkodowanego wideo lub częstotliwość próbkowania transkodowanego dźwięku w hercach. |
fileSizeBytes |
Opcjonalnie: Rozmiar przekonwertowanego pliku (w bajtach). |
CmTrackingAd
Reklama śledząca Campaign Managera 360.
Zapis JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Pola | |
---|---|
cmPlacementId |
Opcjonalnie: Identyfikator miejsca docelowego w reklamie śledzącej w usłudze Campaign Manager 360. |
cmCreativeId |
Opcjonalnie: Identyfikator kreacji w reklamie śledzącej w usłudze Campaign Manager 360. |
cmAdId |
Opcjonalnie: Identyfikator reklamy śledzącej w Campaign Managerze 360. |
ObaIcon
Ikona programu OBA dla kreacji
Zapis JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
Pola | |
---|---|
resourceUrl |
Opcjonalnie: Adres URL zasobu ikony OBA. |
resourceMimeType |
Opcjonalnie: Typ MIME zasobu ikony programu OBA. |
position |
Opcjonalnie: Pozycja ikony OBA na kreacji. |
dimensions |
Opcjonalnie: Wymiary ikony OBA. |
program |
Opcjonalnie: Program, do którego należy ikona OBA. Na przykład: „AdChoices”. |
landingPageUrl |
Wymagany. Adres URL strony docelowej ikony OBA. Dozwolone są tylko adresy URL z tych domen:
|
clickTrackingUrl |
Wymagany. Link monitorujący kliknięcia ikony OBA. Dozwolone są tylko adresy URL z tych domen:
|
viewTrackingUrl |
Wymagany. Link monitorujący wyświetlenia ikony OBA. Dozwolone są tylko adresy URL z tych domen:
|
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 |
|
---|---|
|
Tworzy nową kreację. |
|
Usuwa kreację. |
|
Pobiera kreację. |
|
Lista kreacji reklamodawcy. |
|
aktualizuje istniejącą kreację. |