- Zasób: Kreacja
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- Zasób
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- Transkodować
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- Metody
Zasób: Reklama
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. Przypisana 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 Managera. |
displayName |
To pole jest wymagane. Wyświetlana nazwa kreacji. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
entityStatus |
To pole jest wymagane. Określa, czy kreacja może się wyświetlać. Akceptowane wartości to:
|
updateTime |
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 RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
createTime |
Tylko dane wyjściowe. Sygnatura czasowa utworzenia kreacji. Przypisana przez system. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
creativeType |
To pole jest wymagane. Niezmienne. Typ kreacji. |
hostingSource |
To pole jest wymagane. Wskazuje miejsce hostowania kreacji. |
dynamic |
Tylko dane wyjściowe. Wskazuje, czy kreacja jest dynamiczna. |
dimensions |
To pole jest wymagane. Podstawowe wymiary kreacji. Dotyczy wszystkich typów kreacji. Wartość
|
additionalDimensions[] |
Dodatkowe wymiary. Ma zastosowanie, gdy
Jeśli to pole jest określone, zarówno pole |
mediaDuration |
Tylko dane wyjściowe. Czas trwania multimediów kreacji. Ma zastosowanie, gdy
Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
creativeAttributes[] |
Tylko dane wyjściowe. Lista atrybutów kreacji wygenerowana przez system. |
reviewStatus |
Tylko dane wyjściowe. Bieżący stan procesu sprawdzania kreacji. |
assets[] |
To pole jest wymagane. Zasoby powiązane z tą kreacją. |
exitEvents[] |
To pole jest wymagane. Zdarzenia wyjściowe tej kreacji. Wyjście (nazywane też tagiem kliknięcia) to dowolny obszar w obrębie 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:
|
timerEvents[] |
Zdarzenia niestandardowe licznika czasu w kreacji multimedialnej. Liczniki czasu śledzą czas, 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[] |
Licznik zdarzeń w kreacji multimedialnej. Liczniki zdarzeń wskazują, ile razy użytkownik w określony sposób wchodzi w interakcję z dowolną częścią kreacji multimedialnej (najechanie kursorem myszy 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 |
Tag śledzenia HTML firmy zewnętrznej, który ma zostać dołączony do tagu kreacji. |
integrationCode |
Identyfikator użyty do połączenia tej kreacji z systemem zewnętrznym. Musi być zakodowany w formacie UTF-8 i nie może mieć więcej niż 10 000 znaków. |
notes |
Uwagi użytkownika dotyczące tej kreacji. Musi być zakodowany w formacie UTF-8 i nie może mieć więcej niż 20 000 znaków. |
iasCampaignMonitoring |
Wskazuje, czy monitorowanie kampanii Integral Ad Science (IAS) jest włączone. Aby włączyć tę funkcję dla kreacji, upewnij się, że parametr |
companionCreativeIds[] |
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 w pobliżu odtwarzacza wideo wydawcy. Reklamy towarzyszące wyświetlają się podczas odtwarzania filmu i po jego zakończeniu. Kreacje zawierające To pole jest obsługiwane tylko w przypadku
|
skippable |
Określa, czy użytkownik może pominąć kreację wideo. To pole jest obsługiwane tylko w przypadku
|
skipOffset |
Czas odtwarzania filmu do momentu wyświetlenia przycisku pominięcia. To pole jest wymagane, gdy To pole jest obsługiwane tylko w przypadku
|
progressOffset |
Czas odtwarzania filmu przed zaliczeniem wyświetlenia. To pole jest wymagane, gdy To pole jest obsługiwane tylko w przypadku
|
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
|
thirdPartyUrls[] |
Linki monitorujące firmy zewnętrznej służące do śledzenia interakcji z kreacjami wideo. To pole jest obsługiwane tylko w przypadku
|
transcodes[] |
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
|
trackerUrls[] |
Linki monitorujące dla dostawców rozwiązań 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 zapisywać tylko w
|
jsTrackerUrl |
Adres URL do pomiaru JavaScriptu pochodzący od obsługiwanych zewnętrznych dostawców weryfikacji (ComScore, DoubleVerify, IAS, Moat). Tagi skryptu HTML nie są obsługiwane. To pole można zapisywać tylko w
|
cmTrackingAd |
Reklama śledząca Campaign Managera 360 powiązana z kreacją. Opcjonalne w przypadku elementów
Dane wyjściowe tylko w innych przypadkach. |
obaIcon |
Określa ikonę programu OBA na potrzeby kreacji wideo. To pole jest obsługiwane tylko w
|
thirdPartyTag |
Opcjonalnie. Pierwotny tag firmy zewnętrznej użyty w kreacji. Wymagane i prawidłowe tylko w przypadku kreacji z tagami usług zewnętrznych. Kreacje z tagiem usługi zewnętrznej to kreacje z tymi
w połączeniu z
|
requireMraid |
Opcjonalnie. Wskazuje, że kreacja wymaga MRAID (systemu definicji interfejsu reklam mobilnych Rich Media Ad Interface). 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 usługi zewnętrznej to kreacje z tymi
w połączeniu z
|
requireHtml5 |
Opcjonalnie. Wskazuje, że do prawidłowego renderowania kreacja wymaga kodu HTML5. Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem usług zewnętrznych. Kreacje z tagiem usługi zewnętrznej to kreacje z tymi
w połączeniu z
|
requirePingForAttribution |
Opcjonalnie. Wskazuje, że kreacja będzie czekać na ping zwrotny dotyczący 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 firm zewnętrznych i kreacji z tagiem VAST firm zewnętrznych. Kreacje z tagiem usługi zewnętrznej to kreacje z tymi
w połączeniu z
Kreacje z tagiem VAST firm zewnętrznych to kreacje z tymi parametrami (
w połączeniu z
|
expandingDirection |
Opcjonalnie. Określa kierunek rozwijania kreacji. Wymagany i działa tylko w przypadku kreacji rozwijanych innych firm. Kreacje rozwijane firmy zewnętrznej to kreacje, które mają te źródła hostingu:
w połączeniu z
|
expandOnHover |
Opcjonalnie. Wskazuje, że kreacja będzie automatycznie rozwijać się po najechaniu kursorem. Opcjonalne i prawidłowe tylko w przypadku kreacji rozwijanych innych firm. Kreacje rozwijane firmy zewnętrznej to kreacje, które mają te źródła hostingu:
w połączeniu z
|
vastTagUrl |
Opcjonalnie. Adres URL tagu VAST kreacji z tagiem VAST firmy zewnętrznej. Wymagane i prawidłowe tylko w przypadku kreacji z tagiem VAST innych firm. Kreacje z tagiem VAST firm zewnętrznych to kreacje z tymi parametrami (
w połączeniu z
|
vpaid |
Tylko dane wyjściowe. Wskazuje, że kreacja z tagiem VAST innej firmy wymaga VPAID (ang. Digital Video Player-Ad Interface). Tylko dane wyjściowe i działają tylko w przypadku kreacji z tagiem VAST innych firm. Kreacje z tagiem VAST firm zewnętrznych to kreacje z tymi parametrami (
w połączeniu z
|
html5Video |
Tylko dane wyjściowe. Wskazuje, że kreacja z tagiem VAST innej firmy wymaga obsługi wideo HTML5. Tylko dane wyjściowe i działają tylko w przypadku kreacji z tagiem VAST innych firm. Kreacje z tagiem VAST firm zewnętrznych to kreacje z tymi parametrami (
w połączeniu z
|
lineItemIds[] |
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 zasady |
mp3Audio |
Tylko dane wyjściowe. Wskazuje, że kreacja audio firmy zewnętrznej obsługuje MP3. Tylko dane wyjściowe i działają tylko w przypadku kreacji audio innych firm. Kreacje audio firm zewnętrznych to kreacje, które zawierają te
w połączeniu z
|
oggAudio |
Tylko dane wyjściowe. Wskazuje, że kreacja audio firmy zewnętrznej obsługuje OGG. Tylko dane wyjściowe i działają tylko w przypadku kreacji audio innych firm. Kreacje audio firm zewnętrznych to kreacje, które zawierają te
w połączeniu z
|
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 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 hostingu, 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 hostingu, jeśli
|
HOSTING_SOURCE_RICH_MEDIA |
Kreacja multimedialna 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 został określony lub jest nieznany w tej wersji. |
CREATIVE_ATTRIBUTE_VAST |
Jest to kreacja VAST. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
Kreacja to liniowa kreacja VPAID. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
Jest to nielinearna kreacja VPAID. |
ReviewStatusInfo
Sprawdź stany kreacji.
Zapis JSON |
---|
{ "approvalStatus": enum ( |
Pola | |
---|---|
approvalStatus |
Oznacza podstawowe zatwierdzenie wymagane do rozpoczęcia wyświetlania kreacji. Podsumowanie: |
creativeAndLandingPageReviewStatus |
Stan weryfikacji kreacji i strony docelowej kreacji. |
contentAndPolicyReviewStatus |
Stan weryfikacji treści i zgodności kreacji z zasadami reklamowymi. |
exchangeReviewStatuses[] |
Stan weryfikacji kreacji przez giełdę. |
publisherReviewStatuses[] |
o stanie weryfikacji kreacji przez wydawcę. |
ApprovalStatus
Możliwe typy stanu zatwierdzenia. To jest podsumowanie danych 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 została sprawdzona i przeszła weryfikację pod kątem zgodności z zasadami. Można ją wyświetlać, ale oczekuje na dodatkową weryfikację treści i zgodności z zasadami. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Weryfikacja kreacji i stron docelowych oraz weryfikacja treści i zgodności z zasadami została zatwierdzona. 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 typy stanu sprawdzania.
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łdy.
Zapis JSON |
---|
{ "exchange": enum ( |
Pola | |
---|---|
exchange |
Giełda oceniająca kreację. |
status |
Stan weryfikacji giełdy. |
PublisherReviewStatus
Stan weryfikacji kreacji przez wydawcę.
Zapis JSON |
---|
{
"publisherName": string,
"status": enum ( |
Pola | |
---|---|
publisherName |
Wydawca sprawdzający kreację. |
status |
Stan sprawdzania przez wydawcę. |
AssetAssociation
Powiązanie zasobu kreacji.
Zapis JSON |
---|
{ "asset": { object ( |
Pola | |
---|---|
asset |
Powiązany zasób. |
role |
Rola tego zasobu w kreacji. |
Zasób
Jeden zasób.
Zapis JSON |
---|
{ "mediaId": string, "content": string } |
Pola | |
---|---|
mediaId |
Identyfikator mediów przesłanego zasobu. Jest to unikalny identyfikator zasobu. Można go przekazywać do innych wywołań interfejsu API, np. 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 |
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.
Ta rola jest obsługiwana tylko w tych rolach (
|
ASSET_ROLE_LONG_HEADLINE |
Długi nagłówek kreacji natywnej.
Ta rola jest obsługiwana tylko w tych rolach (
|
ASSET_ROLE_BODY |
Tekst główny kreacji natywnej.
Ta rola jest obsługiwana tylko w tych rolach (
|
ASSET_ROLE_LONG_BODY |
Długi tekst główny kreacji natywnej.
Ta rola jest obsługiwana tylko w tych rolach (
|
ASSET_ROLE_CAPTION_URL |
Krótka, prostsza wersja adresu URL strony docelowej wyświetlana w kreacji. Dzięki niemu użytkownicy wiedzą, na jaką stronę trafią po kliknięciu kreacji.
Jeśli np. URL strony docelowej to „http://www.example.com/strona”, adresem URL napisów może być „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 rolach (
|
ASSET_ROLE_CALL_TO_ACTION |
Tekst wyświetlany na przycisku wezwania do działania w kreacji natywnej.
Ta rola jest obsługiwana tylko w tych rolach (
|
ASSET_ROLE_ADVERTISER_NAME |
Tekst określający nazwę reklamodawcy lub marki.
Ta rola jest obsługiwana tylko w tych rolach (
|
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 ona zawsze widoczna przy zapisywaniu kreacji.
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 Sklepie Google Play po fragmencie „id”. Na przykład na stronie https://play.google.com/store/apps/details?id=com.company.appname identyfikator to „com.firma.nazwa_aplikacji”. Zasoby tej roli 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 bezpośrednio po fragmencie „id”. Na przykład w adresie 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 sklepie z aplikacjami na iOS. Pamiętaj, że ta wartość nie jest automatycznie synchronizowana z rzeczywistą oceną w sklepie. Jest ona zawsze widoczna przy zapisywaniu kreacji. Zasoby tej roli są tylko do odczytu. |
ASSET_ROLE_ICON |
Ikona kreacji. Ta rola jest obsługiwana i wymagana tylko w tych rolach (
|
ASSET_ROLE_COVER_IMAGE |
Obraz okładki natywnej kreacji wideo. Ta rola jest obsługiwana i wymagana tylko w tych rolach (
|
ExitEvent
Zdarzenie wyjściowe kreacji.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
To pole jest wymagane. Typ zdarzenia wyjściowego. |
url |
To pole jest wymagane. Docelowy URL zdarzenia wyjściowego. Jest to wymagane, gdy
|
name |
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 |
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 nieznany w tej wersji. |
EXIT_EVENT_TYPE_DEFAULT |
Jest to zdarzenie wyjściowe. |
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 |
To pole jest wymagane. Nazwa zdarzenia licznika czasu. |
reportingName |
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 |
To pole jest wymagane. Nazwa zdarzenia licznika. |
reportingName |
To pole jest wymagane. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach. |
AudioVideoOffset
Czas odtwarzania dźwięku lub filmu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy offset . Wartość przesunięcia. offset może mieć tylko jedną z tych wartości: |
|
percentage |
Wartość procentowa przesunięcia dźwięku lub wideo. |
seconds |
Opóźnienie w sekundach od początku ścieżki dźwiękowej lub filmu. |
UniversalAdId
Unikalny identyfikator kreacji podawany przez rejestr na wszystkich platformach. Jest to część standardu VAST 4.0.
Zapis JSON |
---|
{
"id": string,
"registry": enum ( |
Pola | |
---|---|
id |
Unikalny identyfikator kreacji. |
registry |
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 reklam Universal Ad jest nieokreślony lub nieznany w tej wersji. |
UNIVERSAL_AD_REGISTRY_OTHER |
Użyj niestandardowego dostawcy, aby podać uniwersalny identyfikator reklamy. |
UNIVERSAL_AD_REGISTRY_AD_ID |
Aby podać uniwersalny identyfikator reklamy, użyj identyfikatora reklamy. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
Użyj parametru 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 firmy zewnętrznej służące do śledzenia interakcji z kreacjami audio lub wideo.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ interakcji musi być śledzony za pomocą linku monitorującego. |
url |
Link monitorujący używany do śledzenia interakcji. Podaj adres URL z opcjonalną ścieżką lub ciągiem zapytania zaczynającym się od |
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 zliczania wyświetleń kreacji po zakończeniu buforowania dźwięku lub obrazu. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
Służy do śledzenia kliknięć reklam audio lub wideo przez użytkowników. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Służy do śledzenia, ile razy użytkownik uruchomił 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 filmu do 25% jego długości. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
Służy do śledzenia liczby odtworzeń dźwięku lub filmu 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 filmu 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 |
Służy do śledzenia, ile razy użytkownik ponownie odtworzył dźwięk lub obraz. |
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 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 obrazu z przesunięciem określonym przez progressOffset . |
Transkoduj
Zawiera informacje o transkodowanym pliku audio lub wideo.
Zapis JSON |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
Pola | |
---|---|
name |
Nazwa transkodowanego pliku. |
mimeType |
Typ MIME transkodowanego pliku. |
transcoded |
Wskazuje, czy transkodowanie zakończyło się powodzeniem. |
dimensions |
Wymiary transkodowanego filmu. |
bitRateKbps |
Szybkość transmisji bitów transkodowania filmu (jako liczba kilobitów na sekundę). |
frameRate |
Liczba klatek po transkodowaniu filmu (w klatkach na sekundę). |
audioBitRateKbps |
Szybkość transmisji strumienia audio transkodowanego wideo lub szybkość transmisji bitów transkodowanego dźwięku (jako liczba kilobitów na sekundę). |
audioSampleRateHz |
Częstotliwość próbkowania strumienia audio transkodowanego wideo lub częstotliwość próbkowania dla transkodowanego dźwięku (w hercach). |
fileSizeBytes |
Rozmiar transkodowanego pliku podany w bajtach. |
CmTrackingAd
Reklama śledząca Campaign Managera 360.
Zapis JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Pola | |
---|---|
cmPlacementId |
Identyfikator miejsca docelowego reklamy śledzącej Campaign Managera 360. |
cmCreativeId |
Identyfikator kreacji reklamy śledzącej Campaign Managera 360. |
cmAdId |
Identyfikator reklamy śledzącej w usłudze Menedżer kampanii 360. |
ObaIcon
Ikona programu OBA dla kreacji
Zapis JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
Pola | |
---|---|
resourceUrl |
Adres URL zasobu ikony OBA. |
resourceMimeType |
Typ MIME zasobu ikony OBA. |
position |
Położenie ikony OBA w kreacji. |
dimensions |
Wymiary ikony OBA. |
program |
Program ikony OBA. Na przykład: „Informacja”. |
landingPageUrl |
To pole jest wymagane. Adres URL strony docelowej ikony OBA. Dozwolone są tylko adresy URL następujących domen: |
clickTrackingUrl |
To pole jest wymagane. Link monitorujący kliknięcia ikony OBA. Dozwolone są tylko adresy URL następujących domen: |
viewTrackingUrl |
To pole jest wymagane. Link monitorujący wyświetlenia ikony OBA. Dozwolone są tylko adresy URL następujących domen: |
ObaIconPosition
Położenie ikony OBA w kreacji.
Wartości w polu enum | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
Nie określono pozycji ikony programu 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 określono kierunku rozwijania. |
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 |
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 się w górę lub w dół. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
Rozwija się w lewo lub w prawo. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
Możliwość rozwijania w dowolnym kierunku po przekątnej. |
Metody |
|
---|---|
|
Tworzy nową kreację. |
|
Usuwa kreację. |
|
Pobiera kreację. |
|
Wyświetla listę kreacji reklamodawcy. |
|
Aktualizuje istniejącą kreację. |