- 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 |
Wymagane. Wyświetlana nazwa kreacji. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
entityStatus |
Wymagane. Określa, czy kreacja może zostać wyświetlona. Akceptowane wartości:
|
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 „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
createTime |
Tylko dane wyjściowe. Sygnatura czasowa utworzenia kreacji. Przypisana przez system. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
creativeType |
Wymagane. Stałe. Typ kreacji. |
hostingSource |
Wymagane. Wskazuje miejsce hostowania kreacji. |
dynamic |
Tylko dane wyjściowe. Wskazuje, czy kreacja jest dynamiczna. |
dimensions |
Wymagane. Podstawowe wymiary kreacji. Dotyczy wszystkich typów kreacji. Wartość
|
additionalDimensions[] |
Dodatkowe wymiary. Ma zastosowanie, gdy
Jeśli to pole jest określone, wymagane są zarówno pola |
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[] |
Wymagane. Zasoby powiązane z tą kreacją. |
exitEvents[] |
Wymagane. Zdarzenia wyjściowe tej kreacji. Wyjście (nazywane też tagiem kliknięcia) to dowolny obszar w kreacji, który użytkownik może kliknąć, by otworzyć stronę docelową reklamodawcy. Każda kreacja musi zawierać co najmniej 1 wyjście. Wyjście możesz dodać do kreacji w dowolny z tych sposobów:
|
timerEvents[] |
Licznik zdarzeń niestandardowych w kreacji multimedialnej. Liczniki czasu służą do śledzenia czasu, w którym użytkownik wyświetla określoną część kreacji multimedialnej i wchodzi z nią w interakcję. Kreacja może zawierać wiele zdarzeń licznika czasu, a czas każdego z nich może być mierzony oddzielnie. W przypadku kreacji zawierających tylko komponenty z obrazem pozostaw to pole puste lub nieskonfigurowane. |
counterEvents[] |
Zdarzenia licznika w kreacji multimedialnej. Liczniki zdarzeń rejestrują liczbę określonych interakcji użytkownika z dowolną częścią kreacji multimedialnej – takich jak najechanie kursorem na reklamę, wyjechanie poza nią, kliknięcie, wczytanie danych, użycie klawiatury itp. Każde zdarzenie przechwytywane w kreacji można rejestrować za pomocą licznika. W przypadku kreacji zawierających tylko komponenty z obrazem pozostaw to pole puste lub nieskonfigurowane. |
appendedTag |
Tag śledzenia HTML firmy zewnętrznej, który ma zostać dołączony do tagu kreacji. |
integrationCode |
Informacje o identyfikatorze używane do połączenia tej kreacji z systemem zewnętrznym. Musi być zakodowany w formacie UTF-8 o długości nie większej niż 10 000 znaków. |
notes |
Uwagi użytkownika dotyczące tej kreacji. Musi być zakodowany w formacie UTF-8 o długości nie większej niż 20 000 znaków. |
iasCampaignMonitoring |
Wskazuje, czy monitorowanie kampanii Integral Ad Science (IAS) jest włączone. Aby włączyć tę funkcję dla kreacji, upewnij się, że |
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 wokół odtwarzacza wideo wydawcy. Elementy 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 zliczeniem 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 firm zewnętrznych 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[] |
Adresy URL śledzenia dla dostawców usług analitycznych i zewnętrznych dostawców technologii reklamowych. Adresy URL muszą zaczynać się od https (z wyjątkiem zasobów reklamowych, które nie wymagają zgodności z protokołem SSL). Jeśli w adresach URL stosujesz makra, używaj tylko makr obsługiwanych przez Display & Video 360. Można używać tylko standardowych adresów URL, a nie tagów IMG czy SCRIPT. To pole można zapisać tylko w
|
jsTrackerUrl |
Adres URL do pomiaru JavaScriptu od obsługiwanych zewnętrznych dostawców systemów weryfikacji (ComScore, DoubleVerify, IAS, Moat). Tagi skryptu HTML nie są obsługiwane. To pole można zapisać tylko w
|
cmTrackingAd |
Reklama śledząca Campaign Managera 360 powiązana z kreacją. Opcjonalny w przypadku elementów
Dane wyjściowe tylko w przypadku innych przypadków. |
obaIcon |
Określa ikonę 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 tagiem firm zewnętrznych. Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te
w połączeniu z
|
requireMraid |
Opcjonalnie. Wskazuje, że kreacja wymaga MRAID (systemu definicji interfejsu reklam mobilnych rich media). Ustaw tę opcję, jeśli interakcja z kreacją wymaga użycia gestów charakterystycznych dla urządzeń mobilnych, takich jak przesuwanie palcem lub dotykanie. Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem usług zewnętrznych. Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te
w połączeniu z
|
requireHtml5 |
Opcjonalnie. Wskazuje, że do prawidłowego renderowania kreacja wykorzystuje HTML5. Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem usług zewnętrznych. Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te
w połączeniu z
|
requirePingForAttribution |
Opcjonalnie. Wskazuje, że kreacja będzie czekać na ping zwrotny na potrzeby atrybucji. Tej formuły można użyć tylko w przypadku reklamy śledzącej Campaign Managera 360 z parametrem serwera reklamowego firmy zewnętrznej i makrem ${DC_DBM_TOKEN}. Opcjonalne i prawidłowe tylko w przypadku kreacji z tagiem firmy zewnętrznej i kreacji z tagiem VAST firm zewnętrznych. Kreacje z tagiem firmy zewnętrznej to kreacje, które mają te
w połączeniu z
Kreacje z tagiem VAST firm zewnętrznych to kreacje, których
w połączeniu z
|
expandingDirection |
Opcjonalnie. Określa kierunek rozwijania kreacji. Wymagane i prawidłowe tylko w przypadku kreacji rozwijanych innych firm. Kreacje rozwijane firmy zewnętrznej to kreacje z takim źródłem hostingu:
w połączeniu z
|
expandOnHover |
Opcjonalnie. Wskazuje, że kreacja automatycznie się rozwinie, gdy najedziesz na nią kursorem. Opcjonalny i prawidłowy tylko w przypadku kreacji rozwijanych innych firm. Kreacje rozwijane firmy zewnętrznej to kreacje z takim źródłem hostingu:
w połączeniu z
|
vastTagUrl |
Opcjonalnie. Adres URL tagu VAST innej firmy z tagiem VAST. Wymagane i prawidłowe tylko w przypadku kreacji z tagiem VAST innych firm. Kreacje z tagiem VAST firm zewnętrznych to kreacje, których
w połączeniu z
|
vpaid |
Tylko dane wyjściowe. Wskazuje, że kreacja z tagiem VAST innej firmy wymaga VPAID (Digital Video Player-Ad Interface). Obowiązuje tylko w przypadku kreacji z tagiem VAST innych firm i tylko w przypadku kreacji wyjściowych. Kreacje z tagiem VAST firm zewnętrznych to kreacje, których
w połączeniu z
|
html5Video |
Tylko dane wyjściowe. Wskazuje, że kreacja z tagiem VAST firmy zewnętrznej wymaga obsługi wideo w formacie HTML5. Obowiązuje tylko w przypadku kreacji z tagiem VAST innych firm i tylko w przypadku kreacji wyjściowych. Kreacje z tagiem VAST firm zewnętrznych to kreacje, których
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 elementu |
mp3Audio |
Tylko dane wyjściowe. Wskazuje, że kreacja audio firmy zewnętrznej obsługuje format MP3. Tylko dane wyjściowe i działają tylko w przypadku kreacji audio firm zewnętrznych. Kreacje audio firm zewnętrznych to kreacje, które mają te
w połączeniu z
|
oggAudio |
Tylko dane wyjściowe. Wskazuje, że kreacja audio firmy zewnętrznej obsługuje format OGG. Tylko dane wyjściowe i działają tylko w przypadku kreacji audio firm zewnętrznych. Kreacje audio firm zewnętrznych to kreacje, które mają te
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 aktualizacji nie są obsługiwane w przypadku tego typu hostingu. |
HOSTING_SOURCE_THIRD_PARTY |
Kreacja hostowana na serwerze reklamowym firmy zewnętrznej (3PAS). Metody tworzenia i aktualizacji są obsługiwane w przypadku tego typu hostingu, jeśli
|
HOSTING_SOURCE_HOSTED |
Kreacja utworzona w DV360 i hostowana w usłudze Campaign Manager 360. Metody tworzenia i aktualizacji są obsługiwane w przypadku tego typu hostingu, jeśli
|
HOSTING_SOURCE_RICH_MEDIA |
Kreacja multimedialna utworzona w Studio i hostowana w usłudze Campaign Manager 360. Metody tworzenia i aktualizacji nie są obsługiwane w przypadku tego typu hostingu. |
CreativeAttribute
Możliwe atrybuty kreacji.
Wartości w polu enum | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
Atrybut kreacji nie jest określony lub jest nieznany w tej wersji. |
CREATIVE_ATTRIBUTE_VAST |
Kreacja to VAST. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
Jest to linearna kreacja VPAID. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
Jest to nielinearna kreacja VPAID. |
ReviewStatusInfo
Sprawdź stany kreacji.
Zapis JSON |
---|
{ "approvalStatus": enum ( |
Pola | |
---|---|
approvalStatus |
Reprezentuje podstawowe zatwierdzenie wymagane do rozpoczęcia wyświetlania kreacji. Podsumowanie: |
creativeAndLandingPageReviewStatus |
Stan weryfikacji kreacji i strony docelowej. |
contentAndPolicyReviewStatus |
Stan weryfikacji treści i zgodności kreacji z zasadami. |
exchangeReviewStatuses[] |
Stany weryfikacji kreacji przez giełdy. |
publisherReviewStatuses[] |
Stany weryfikacji kreacji przez wydawcę. Ostrzeżenie: to pole zostanie wycofane 26 czerwca 2024 r. Po tej dacie to pole będzie puste. Więcej informacji znajdziesz w naszym ogłoszeniu o wycofaniu funkcji. |
ApprovalStatus
Możliwe typy stanu zatwierdzenia. To jest podsumowanie funkcji creativeAndLandingPageReviewStatus
i contentAndPolicyReviewStatus
.
Wartości w polu enum | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
Wartość typu nie jest określona lub jest nieznana w tej wersji. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
Kreacja jest nadal w trakcie sprawdzania i nie można jej wyświetlać. |
APPROVAL_STATUS_PENDING_SERVABLE |
Kreacja przeszła weryfikację kreacji i strony docelowej oraz można ją wyświetlać, ale oczekuje na dodatkową weryfikację treści i zgodności z zasadami. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Zatwierdzono weryfikację kreacji i strony docelowej oraz weryfikację treści i zasad. Kreacja jest możliwa do wyświetlania. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
Występuje problem z kreacją, który trzeba rozwiązać, zanim zostanie ona dopuszczona do wyświetlania. |
ReviewStatus
Możliwe typy stanu sprawdzenia.
Wartości w polu enum | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
Wartość typu nie jest określona lub jest nieznana w tej wersji. |
REVIEW_STATUS_APPROVED |
Kreacja została zatwierdzona. |
REVIEW_STATUS_REJECTED |
Kreacja została odrzucona. |
REVIEW_STATUS_PENDING |
Kreacja oczekuje na sprawdzenie. |
ExchangeReviewStatus
Stan weryfikacji kreacji przez giełdę.
Zapis JSON |
---|
{ "exchange": enum ( |
Pola | |
---|---|
exchange |
Giełda sprawdzają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. do 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 usługach (
|
ASSET_ROLE_LONG_HEADLINE |
Długi nagłówek kreacji natywnej.
Ta rola jest obsługiwana tylko w tych usługach (
|
ASSET_ROLE_BODY |
Tekst główny kreacji natywnej.
Ta rola jest obsługiwana tylko w tych usługach (
|
ASSET_ROLE_LONG_BODY |
Długi tekst główny kreacji natywnej.
Ta rola jest obsługiwana tylko w tych usługach (
|
ASSET_ROLE_CAPTION_URL |
Krótka, prostsza wersja adresu URL strony docelowej wyświetlana w kreacji. Adres ten informuje użytkowników, na jaką stronę trafią po kliknięciu kreacji.
Jeśli np. adres URL strony docelowej to „http://www.example.com/strona”, adresem URL napisów może być „example.com”. Protokół (http://) jest opcjonalny, ale URL nie może zawierać spacji ani znaków specjalnych. Ta rola jest obsługiwana tylko w tych usługach (
|
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 usługach (
|
ASSET_ROLE_ADVERTISER_NAME |
Tekst, który określa nazwę reklamodawcy lub marki.
Ta rola jest obsługiwana tylko w tych usługach (
|
ASSET_ROLE_PRICE |
Cena aplikacji w Sklepie Google Play lub sklepie z aplikacjami na iOS (na przykład 5, 99 USD). Pamiętaj, że ta wartość nie jest automatycznie synchronizowana z rzeczywistą wartością podaną w sklepie. Jest to zawsze wartość podana podczas zapisywania kreacji.
Zasoby z tą rolą są tylko do odczytu. |
ASSET_ROLE_ANDROID_APP_ID |
Identyfikator aplikacji na Androida w sklepie Google Play. Znajdziesz go w adresie URL aplikacji w Sklepie Google Play po fragmencie „id”. Na przykład w adresie https://play.google.com/store/apps/details?id=com.company.appname identyfikator to com.firma.nazwaaplikacji. Zasoby z tą rolą są tylko do odczytu. |
ASSET_ROLE_IOS_APP_ID |
Identyfikator aplikacji na iOS w sklepie Apple App Store. Ten numer identyfikacyjny można znaleźć w adresie URL sklepu Apple App Store jako ciąg cyfr, który znajduje się bezpośrednio po elemencie „id”. Na przykład w adresie https://apps.apple.com/us/app/gmail-email-by-google/id422689480 identyfikator to 422689480. Zasoby z tą rolą są tylko do odczytu. |
ASSET_ROLE_RATING |
Ocena aplikacji w Sklepie Google Play lub w sklepie z aplikacjami na iOS. Pamiętaj, że ta wartość nie jest automatycznie synchronizowana z rzeczywistą oceną w sklepie. Jest to zawsze wartość podana podczas zapisywania kreacji. Zasoby z tą rolą są tylko do odczytu. |
ASSET_ROLE_ICON |
Ikona kreacji. Ta rola jest obsługiwana i wymagana tylko w tych usługach (
|
ASSET_ROLE_COVER_IMAGE |
Obraz okładki natywnej kreacji wideo. Ta rola jest obsługiwana i wymagana tylko w tych usługach (
|
ExitEvent
Zdarzenie wyjściowe kreacji.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Wymagane. Typ zdarzenia wyjściowego. |
url |
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 w tej wersji nieznany. |
EXIT_EVENT_TYPE_DEFAULT |
Zdarzenie wyjściowe jest tym domyślnym. |
EXIT_EVENT_TYPE_BACKUP |
Zdarzenie wyjściowe to zapasowe zdarzenie wyjściowe. Kreacja może zawierać wiele zapasowych zdarzeń wyjściowych. |
TimerEvent
Zdarzenie licznika czasu kreacji.
Zapis JSON |
---|
{ "name": string, "reportingName": string } |
Pola | |
---|---|
name |
Wymagane. Nazwa zdarzenia licznika czasu. |
reportingName |
Wymagane. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach. |
CounterEvent
Zdarzenie licznika kreacji.
Zapis JSON |
---|
{ "name": string, "reportingName": string } |
Pola | |
---|---|
name |
Wymagane. Nazwa zdarzenia licznika. |
reportingName |
Wymagane. Nazwa używana do identyfikowania tego zdarzenia licznika w raportach. |
AudioVideoOffset
Długość odtwarzania dźwięku lub filmu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy offset . Wartość przesunięcia. offset może być tylko jedną z tych wartości: |
|
percentage |
Przesunięcie w procentach czasu trwania dźwięku lub wideo. |
seconds |
Opóźnienie (w sekundach) od początku ścieżki audio lub wideo. |
UniversalAdId
Unikalny identyfikator kreacji podawany przez rejestr na wszystkich platformach. Są one częścią standardu VAST 4.0.
Zapis JSON |
---|
{
"id": string,
"registry": enum ( |
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 Universal Ads jest nieokreślony lub nieznany w tej wersji. |
UNIVERSAL_AD_REGISTRY_OTHER |
Użyj dostawcy niestandardowego, aby podać uniwersalny identyfikator reklamy. |
UNIVERSAL_AD_REGISTRY_AD_ID |
Użyj identyfikatora reklamy, aby podać uniwersalny identyfikator reklamy. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
Użyj pola Clearcast.co.uk, aby podać uniwersalny identyfikator reklamy. |
UNIVERSAL_AD_REGISTRY_DV360 |
Podaj uniwersalny identyfikator reklamy, korzystając z Display & Video 360. |
UNIVERSAL_AD_REGISTRY_CM |
Podaj uniwersalny identyfikator reklamy w usłudze Campaign Manager 360. |
ThirdPartyUrl
Linki monitorujące firm zewnętrznych do śledzenia interakcji z kreacjami audio i wideo.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ interakcji musi być śledzony za pomocą linku monitorującego. |
url |
Link monitorujący używany do śledzenia interakcji. Podaj adres URL ze ścieżką lub ciągiem zapytania rozpoczynają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 zliczenia wyświetleń kreacji po zakończeniu buforowania dźwięku lub obrazu. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
Dane służą do śledzenia kliknięć ścieżki dźwiękowej lub wideo przez użytkowników. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Służy do śledzenia, ile razy użytkownik włączył odtwarzanie dźwięku lub filmu. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
Służy do śledzenia liczby odtworzeń dźwięku lub wideo do 25% jego długości. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
Służy do śledzenia liczby odtworzeń dźwięku lub wideo do 50% jego długości. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
Służy do śledzenia liczby odtworzeń dźwięku lub wideo do 75% jego długości. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
Służy do śledzenia liczby odtworzeń dźwięku lub wideo do końca. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
Służy do śledzenia, ile razy użytkownik wyciszył dźwięk lub obraz. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
Służy do śledzenia, ile razy użytkownik wstrzymał odtwarzanie dźwięku lub obrazu. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
Dane służą do śledzenia, ile razy użytkownik ponownie odtworzył dźwięk lub film. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
Służy do śledzenia, ile razy użytkownik podczas oglądania filmu włączył tryb pełnoekranowy. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
Służy do śledzenia, ile razy użytkownik zatrzymał odtwarzanie dźwięku lub obrazu. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
Służy do śledzenia liczby kliknięć niestandardowych wykonanych przez użytkownika, takich jak kliknięcie ciekawego miejsca w filmie. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
Służy do śledzenia liczby pominięć dźwięku lub obrazu. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
Służy do śledzenia liczby odtworzeń dźwięku lub wideo z dokładnością określoną przez progressOffset . |
Transkoduj
Reprezentuje informacje o transkodowanym pliku audio lub wideo.
Zapis JSON |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
Pola | |
---|---|
name |
Nazwa transkodowanego pliku. |
mimeType |
Typ MIME transkodowanego pliku. |
transcoded |
Wskazuje, czy transkodowanie się udało. |
dimensions |
Wymiary transkodowanego filmu. |
bitRateKbps |
Szybkość transmisji bitów transkodowanego filmu (jako liczba kilobitów na sekundę). |
frameRate |
Liczba klatek transkodowanego filmu (w klatkach na sekundę). |
audioBitRateKbps |
Szybkość transmisji bitów 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 filmu lub częstotliwość próbkowania transkodowanego audio podana w hercach. |
fileSizeBytes |
Rozmiar transkodowanego pliku (w bajtach). |
CmTrackingAd
Reklama śledząca w usłudze Campaign Manager 360.
Zapis JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Pola | |
---|---|
cmPlacementId |
Identyfikator miejsca docelowego reklamy śledzącej Campaign Managera 360. |
cmCreativeId |
Identyfikator kreacji reklamy śledzącej w usłudze Campaign Manager 360. |
cmAdId |
Identyfikator reklamy śledzącej w usłudze Menedżer kampanii 360. |
ObaIcon
Ikona 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 |
Pozycja ikony OBA w kreacji. |
dimensions |
Wymiary ikony OBA. |
program |
Program ikony OBA. na przykład: „Informacja”. |
landingPageUrl |
Wymagane. Adres URL strony docelowej ikony OBA. Dozwolone są tylko adresy URL następujących domen: |
clickTrackingUrl |
Wymagane. Link monitorujący kliknięcia ikony OBA. Dozwolone są tylko adresy URL następujących domen: |
viewTrackingUrl |
Wymagane. Link monitorujący wyświetlenia ikony OBA. Dozwolone są tylko adresy URL następujących domen: |
ObaIconPosition
Pozycja ikony OBA w kreacji.
Wartości w polu enum | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
Pozycja ikony programu OBA nie jest określona. |
OBA_ICON_POSITION_UPPER_RIGHT |
W prawym górnym rogu kreacji. |
OBA_ICON_POSITION_UPPER_LEFT |
W lewym górnym rogu kreacji. |
OBA_ICON_POSITION_LOWER_RIGHT |
W prawym dolnym rogu kreacji. |
OBA_ICON_POSITION_LOWER_LEFT |
W lewym dolnym rogu kreacji. |
ExpandingDirection
Kierunek rozwijania kreacji rozwijanej firmy zewnętrznej.
Wartości w polu enum | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
Kierunek rozwijania nie jest określony. |
EXPANDING_DIRECTION_NONE |
Nie rozwija się w żadnym kierunku. |
EXPANDING_DIRECTION_UP |
Rozwija się w górę. |
EXPANDING_DIRECTION_DOWN |
Rozwija się w dół. |
EXPANDING_DIRECTION_LEFT |
Rozwija się w lewo. |
EXPANDING_DIRECTION_RIGHT |
Rozwija się w prawo. |
EXPANDING_DIRECTION_UP_AND_LEFT |
Rozwija się w górę i w lewo. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
Rozwija się w górę i w prawo. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
Rozwinie się w dół i w lewo. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
Rozwinie się w dół i w prawo. |
EXPANDING_DIRECTION_UP_OR_DOWN |
Rozwija się w górę lub w dół. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
Rozwija się w lewo lub w prawo. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
Można ją rozwijać w dowolnym kierunku po przekątnej. |
Metody |
|
---|---|
|
Tworzy nową kreację. |
|
Usuwa kreację. |
|
Generuje kreację. |
|
Wyświetla listę kreacji reklamodawcy. |
|
Aktualizuje istniejącą kreację. |