Blok reklamowy dynamicznego wstawiania reklam wyświetlający aktywny interfejs API

Interfejs Dynamic Ad Insertion API umożliwia żądanie transmisji na żywo z dynamicznym wstawianiem reklam i ich śledzenie.

Usługa: dai.google.com

Wszystkie identyfikatory URI są ustawiane względem adresu https://dai.google.com.

Metoda: strumień

Metody
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Rejestruje blok DAI z dynamicznym wstawianiem reklam w sesji transmisji na żywo.

Żądanie HTTP

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Parametry ścieżki

Parametry
network_code string

Kod sieci Google Ad Managera wydawcy.

custom_asset_key string

Identyfikator niestandardowy powiązany z tym zdarzeniem w Google Ad Manager.

Treść żądania

Treść żądania jest typu application/x-www-form-urlencoded i zawiera te parametry:

Parametry
Parametry kierowania DFP Opcjonalnie Dodatkowe parametry kierowania.
Zastępowanie parametrów strumienia Opcjonalnie Zastąp domyślne wartości parametru tworzenia strumienia.
Uwierzytelnianie HMAC Opcjonalnie Uwierzytelnianie za pomocą tokena opartego na HMAC.

Treść odpowiedzi

Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierać nowy obiekt Stream.

Open Measurement

Interfejs DAI API zawiera informacje do weryfikacji Open Measurement w polu Verifications. To pole zawiera co najmniej 1 element Verification, który zawiera listę zasobów i metadanych wymaganych do wykonania kodu pomiarowego firmy zewnętrznej w celu weryfikacji odtwarzania kreacji. Obsługiwana jest tylko wartość JavaScriptResource. Więcej informacji znajdziesz w specyfikacji IAB Tech Lab i specyfikacji VAST 4.1.

Metoda: pod segment

Metody
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Tworzy strumień DAI dla podanego identyfikatora zdarzenia.

Żądanie HTTP

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Parametry ścieżki

Parametry
network_code string

Kod sieci Google Ad Managera wydawcy.

custom_asset_key string

Identyfikator niestandardowy powiązany z tym zdarzeniem w Google Ad Manager.

pod_identifier

Obsługiwane formaty:

pod/{integer}

Numeryczny identyfikator bieżącej przerwy na reklamę. Identyfikatory podsegmentów reklamy są przypisywane stopniowo do każdego zdarzenia przerwy na reklamę, zaczynając od 1.

ad_break_id/{string}

Identyfikator ciągu znaków bieżącej przerwy na reklamę.
profile_name string

Nazwa żądanego profilu kodującego Google Ad Managera DAI. Profil kodujący musi być jednym ze skonfigurowanych profili kodowania dla wybranego zdarzenia.

segment_number integer

Indeks żądanego segmentu w bieżącym pliku pod, zaczynając od 0.
segment_format string

Rozszerzenie pliku powiązane z żądanym formatem segmentu. Akceptowane rozszerzenia to: ts, mp4, vtt, aac, ac3 lub eac3.

Parametry zapytania

Parametry
stream_id wymagany string

Identyfikator strumienia dla bieżącej sesji użytkownika. Ta wartość jest zwracana przez zakończone powodzeniem żądanie do punktu końcowego stream.
sd required1 integer

Czas trwania żądanego segmentu (w milisekundach).
so opcjonalnie

Odsunięcie żądanego segmentu w bloku reklamowym w milisekundach. Jeśli pominiesz parametr so, zostanie on obliczony przez pomnożenie czasu trwania segmentu przez jego numer.
pd wymagane2 integer

Czas trwania bloku reklamowego w milisekundach.
auth-token wymagany string

Podpisany, zakodowany w adresie URL token HMAC dla bieżącego bloku reklamowego.
last opcjonalnie boolean

Wskazuje ostatni segment w przerwie na reklamę. Pomiń ten parametr we wszystkich pozostałych segmentach.
scte35 opcjonalnie string

Sygnał SCTE-35 zakodowany w formacie base64 dla tej przerwy na reklamę.
cust_params opcjonalnie string

Zestaw par klucz-wartość używany do kierowania kampanii Ad Managera. Te pary muszą być reprezentowane jako ciąg znaków zapytań zakodowany w formacie URL.

Przykład:
Parametry
  • section = sports
  • strona = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Przypisy

  1. sd nie jest wymagany w przypadku segmentów inicjalizacji. ↩
  2. W przypadku zdarzeń z włączonymi przerwami reklamowymi bez czasu trwania tag pd nie jest wymagany. ↩

Przykład

GET https://dai.google.com/linear/linear/linear/pods/v1/seg/network/network/sandbox_sandbox_dev/custom_asset/pod określonymi-segredirect-custom-custom-custom-key-key/custom_asset/podwaj-segredirect-custom-custom-custom-key-key/ad_break_break_ Abygoogle.google.com/ https://dai.google.com/ 4348048048488888888cf79343f08004888888888cf79343f080048888888888cf793 43f080048488888888cf79343

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd0pcbd603

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi będzie zawierać odtwarzalny segment strumienia odpowiadający formatowi i parametrom określonym w żądaniu.

Metoda: plik manifestu poda HLS

Pobiera manifest podreklamy HLS transmisji na żywo, który jest gotowy do załadowania i odtworzenia przez klienta odtwarzacza wideo.

Metody
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/pod/{pod_id}.m3u8;

Interfejs API do pobierania playlisty z wieloma wariantami HLS na potrzeby bloku reklamowego.

Żądanie HTTP

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}.m3u8?stream_id={stream_id}&pd={pod_duration}

Parametry ścieżki

Parametry
network_code string

Kod sieci Google Ad Managera wydawcy.
custom_asset_key string

Identyfikator niestandardowy powiązany z tym zdarzeniem w Google Ad Managerze
pod_id integer

Numeryczny identyfikator bieżącej przerwy na reklamę. Identyfikatory podsegmentów reklamy są przypisywane stopniowo do każdego zdarzenia przerwy na reklamę, zaczynając od 1.

Parametry zapytania

Parametry
stream_id Wymagany string

Identyfikator strumienia dla bieżącej sesji użytkownika. Ta wartość jest zwracana przez żądanie wysłane do punktu końcowego stream.
pd Wymagany integer

Czas trwania bloku reklamowego (w milisekundach).
scte35 opcjonalnie string

Sygnał SCTE-35 zakodowany w formacie base64 dla tej przerwy na reklamę.
cust_params opcjonalnie string

Zestaw par klucz-wartość używany do kierowania kampanii Ad Managera. Te pary muszą być reprezentowane jako ciąg znaków zapytań zakodowany w formacie URL.

Przykład:
Parametry
  • section = sports
  • strona = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie playlistą z wieloma wariantami HLS.

Metoda: manifest DASH pod blokiem reklamowym

Pobiera plik manifestu bloku reklamowego MPEG-DASH transmisji na żywo, który jest gotowy do załadowania i odtworzenia przez odtwarzacz wideo klienta.

Metody
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

Interfejs API do pobierania playlisty mpd MPEG-DASH dla bloku reklamowego.

Żądanie HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

Parametry ścieżki

Parametry
network_code string

Kod sieci Google Ad Managera wydawcy.
custom_asset_key string

Identyfikator niestandardowy powiązany z tym zdarzeniem w Google Ad Managerze
stream_id string

Identyfikator strumienia bieżącego użytkownika w sesji bieżącego użytkownika. Ta wartość jest zwracana przez żądanie wysłane do punktu końcowego stream.
pod_id integer

Numeryczny identyfikator bieżącej przerwy na reklamę. Identyfikatory podsegmentów reklamy są przypisywane stopniowo do każdego zdarzenia przerwy na reklamę, zaczynając od 1.

Parametry zapytania

Parametry
pd Wymagany integer

Czas trwania bloku reklamowego (w milisekundach).
scte35 opcjonalnie string

Sygnał SCTE-35 zakodowany w formacie base64 dla tej przerwy na reklamę.
cust_params opcjonalnie string

Zestaw par klucz-wartość używany do kierowania kampanii Ad Managera. Te pary muszą być reprezentowane jako ciąg znaków zapytań zakodowany w formacie URL.

Przykład:
Parametry
  • section = sports
  • strona = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi to playlista mpd MPEG-DASH.

Metoda: szablon okresu w ramach DASH

Metody
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Wymaga od Google Ad Managera przesłania szablonu okresu DASH. Ten szablon zawiera makr, które musisz wypełnić parametrami strumienia. Po wypełnieniu tych makro szablon staje się okresem przerwy na reklamę i może zostać zszyty z plikiem manifestu DASH.

Żądanie HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Parametry ścieżki

Parametry
network_code string

Kod sieci Google Ad Managera wydawcy.

custom_asset_key string

Identyfikator niestandardowy powiązany z tym zdarzeniem w Google Ad Manager.

Parametry zapytania

Parametry
stream_id wymagany string

Identyfikator strumienia dla bieżącej sesji użytkownika. Ta wartość jest zwracana przez zakończone powodzeniem żądanie do punktu końcowego stream.

Treść odpowiedzi

Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierać nowy obiekt PodTemplateResponse.

Metoda: weryfikacja mediów

Po napotkaniu identyfikatora multimediów reklamy podczas odtwarzania natychmiast prześlij żądanie, używając parametru media_verification_url uzyskanego z punktu końcowego stream. Te żądania nie są potrzebne w przypadku strumieniowania z wykorzystaniem sygnałów na serwerze, w którym to serwer inicjuje weryfikację multimediów.

Żądania wysyłane do punktu końcowego media verification są idempotentne.

Metody
media verification GET /{media_verification_url}/{ad_media_id}

powiadamia interfejs API o zdarzeniu weryfikacji mediów;

Żądanie HTTP

GET https://{media-verification-url}/{ad-media-id}

Treść odpowiedzi

media verification zwraca te odpowiedzi:

  • HTTP/1.1 204 No Content, jeśli weryfikacja mediów się powiedzie i wszystkie pingi zostaną wysłane.
  • HTTP/1.1 404 Not Found, jeśli nie można zweryfikować multimediów z powodu nieprawidłowego formatowania adresu URL lub jego wygaśnięcia.
  • HTTP/1.1 404 Not Found jeśli poprzednia prośba o weryfikację tego dokumentu tożsamości zakończyła się sukcesem.
  • HTTP/1.1 409 Conflict jeśli w tym samym czasie wysyłana jest inna prośba.

Identyfikatory mediów reklamy

Identyfikatory multimediów reklamowych będą kodowane w osobnej ścieżce metadanych – metadanych zsynchronizowanych w przypadku strumienia transportowego HLS lub emsg w przypadku plików mp4. Identyfikatory multimediów reklamy zawsze zaczynają się od ciągu znaków google_.

Przed wysłaniem żądania weryfikacji reklamy do adresu URL weryfikacji reklamy należy dołączyć cały tekst zawarty w pliku z metadanymi.

Metoda: metadane

Punkt końcowy metadanych pod adresem metadata_url zwraca informacje używane do tworzenia interfejsu użytkownika reklamy. Punkt końcowy metadanych jest niedostępny w przypadku strumieniowania za pomocą sygnałów na serwerze, gdy to serwer jest odpowiedzialny za inicjowanie weryfikacji multimediów reklamy.

Metody
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

Pobiera informacje o metadanych reklam.

Żądanie HTTP

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

Treść odpowiedzi

Jeśli operacja się powiedzie, odpowiedź zwróci instancję PodMetadata.

Analiza metadanych

Metadane składają się z 3 oddzielnych sekcji: tags, ads i reklamy breaks. Punktem wejścia do danych jest sekcja tags. Następnie przejrzyj tagi, by znaleźć pierwszy wpis, którego nazwa jest prefiksem identyfikatora mediów reklamowych znalezionego w strumieniu wideo. Identyfikator multimediów reklamy może na przykład wyglądać tak:

google_1234567890

Następnie znajdź obiekt tagu o nazwie google_12345. W tym przypadku jest on zgodny z identyfikatorem mediów w reklamie. Gdy znajdziesz odpowiedni obiekt prefiksu multimediów reklamowych, możesz sprawdzić identyfikatory reklam, identyfikatory przerw na reklamę i typ zdarzenia. Identyfikatory reklam są następnie używane do indeksowania obiektów ads, a identyfikatory przerw reklamowych do indeksowania obiektów breaks.

Dane odpowiedzi

Strumień

Strumień służy do renderowania listy zasobów nowo utworzonego strumienia w formacie JSON.
Zapis JSON
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
Pola
stream_id string

Identyfikator strumienia GAM.
media_verification_url string

Adres URL weryfikacji multimediów używany jako podstawowy punkt końcowy do śledzenia zdarzeń odtwarzania.
metadata_url string

Adres URL metadanych używany do okresowego ankietowania informacji o nadchodzących zdarzeniach reklamowych w strumieniu.
session_update_url string

Adres URL aktualizacji sesji służący do aktualizowania parametrów kierowania dla tego strumienia. Pierwotne wartości parametrów kierowania są rejestrowane podczas początkowego żądania utworzenia strumienia.
heartbeat_url string

Adres URL heartbeat, który służy do utrzymywania aktywności strumienia beaconów po stronie serwera. Musi być pingowany co {PollingFrequency} sekund. Wypełnione w przypadku strumieni sygnalizowania po stronie serwera.
polling_frequency number

Częstotliwość odpytywania (w sekundach) podczas wysyłania żądania do metadanych_url lub heartbeat_url.
pod_manifest_url string

Szablon adresu URL pliku manifestu poda służy do generowania adresu URL umożliwiającego pobranie pliku manifestu poda strumienia. Odpowiada on adresowi URL playlisty z wieloma wariantami w HLS lub MPD w DASH. Wartość wypełniana w przypadku zdarzeń transmisji na żywo typu POD_SERVING_MANIFEST. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

Format pliku manifestu to format pliku manifestu pobranego z pod_manifest_url, czyli dash lub hls.

PodMetadata

Metadane PodMetadata zawierają informacje o reklamach, przerwach na reklamy i tagach identyfikatorów multimediów.
Zapis JSON
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
Pola
tags map[string, object(TagSegment)]

Mapa segmentów tagów posortowanych według prefiksu tagu.
ads map[string, object(Ad)]

Mapa reklam posortowanych według identyfikatora reklamy
ad_breaks map[string, object(AdBreak)]

Mapa przerw na reklamę zindeksowanych według identyfikatora przerwy na reklamę.

TagSegment

TagSegment zawiera odwołanie do reklamy, jej przerwy reklamowej i typu zdarzenia. TagSegment z typem="progress" nie powinien być wywoływany pingiem do punktu końcowego weryfikacji mediów reklam.
Zapis JSON
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
Pola
ad string

Identyfikator reklamy tego tagu.
ad_break_id string

Identyfikator przerwy na reklamę tego tagu.
type string

Typ zdarzenia tego tagu.

AdBreak

AdBreak opisuje pojedynczą przerwę na reklamę w strumieniu. Zawiera czas trwania, typ (połowa/przed/po) i liczbę reklam.
Zapis JSON
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
Pola
type string

Prawidłowe typy przerw na reklamy to: przed, w środku i po.
duration number

Łączny czas trwania tej przerwy na reklamę (w sekundach).
expected_duration number

Oczekiwany czas trwania przerwy na reklamę (w sekundach) z uwzględnieniem wszystkich reklam i plansz.
ads number

Liczba reklam w przerwie na reklamę.
Reklama opisuje reklamę w strumieniu.
Zapis JSON
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
Pola
ad_break_id string

Identyfikator przerwy na reklamę w tej reklamie.
position number

Pozycja tej reklamy w przerwie na reklamę, zaczynając od 1.
duration number

Czas trwania reklamy w sekundach.
title string

Opcjonalny tytuł reklamy.
description string

Opcjonalny opis reklamy.
advertiser string

Opcjonalny identyfikator reklamodawcy.
ad_system string

Opcjonalny system reklamowy.
ad_id string

Opcjonalny identyfikator reklamy.
creative_id string

Opcjonalny identyfikator kreacji.
creative_ad_id string

Opcjonalny identyfikator reklamy powiązanej z kreacją.
deal_id string

Opcjonalny identyfikator umowy.
clickthrough_url string

Opcjonalny docelowy URL
click_tracking_urls string

Opcjonalne linki monitorujące kliknięcia
verifications [object(Verification)]

Opcjonalne wpisy weryfikacyjne Open Measurement zawierające zasoby i metadane wymagane do wykonania kodu pomiarowego firmy zewnętrznej w celu weryfikacji odtwarzania kreacji.
slate boolean

Opcjonalna wartość logiczna wskazująca, że bieżący wpis to Slate.
icons [object(Icon)]

Lista ikon, pomijana, jeśli jest pusta.
wrappers [object(Wrapper)]

Lista kodów towarzyszących tagów, pomijana, jeśli jest pusta.
universal_ad_id object(UniversalAdID)

Opcjonalny uniwersalny identyfikator reklamy.
extensions string

Opcjonalna lista wszystkich węzłów <Extension> w pliku VAST.
companions [object(Companion)]

Opcjonalne elementy towarzyszące, które mogą być wyświetlane z tą reklamą.
interactive_file object(InteractiveFile)

Opcjonalna kreacja interaktywna (SIMID), która powinna wyświetlać się podczas odtwarzania reklamy.

PodTemplateResponse

PodTemplateResponse reprezentuje ładunek JSON zwrócony do VTP na potrzeby łączenia podów.
Zapis JSON
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
Pola
dash_period_template string

DashPeriodTemplate to szablon XML okresu, który należy wypełnić odpowiednimi danymi przed zszyciem.
segment_duration_ms int64

SegmentDurationMS to czas trwania segmentów okresu w milisekundach.

Ikona

Ikona zawiera informacje o ikonie VAST.
Zapis JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
Pola
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

ClickData zawiera informacje o kliknięciu ikony.
Zapis JSON
{
  "url": string,
}
Pola
url string

FallbackImage

FallbackImage zawiera informacje o zastępczym obrazie VAST.
Zapis JSON
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
Pola
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

Element wrapper zawiera informacje o reklamie typu wrapper. Nie zawiera identyfikatora oferty, jeśli nie istnieje.
Zapis JSON
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
Pola
system string

Identyfikator systemu reklamowego.
ad_id string

Identyfikator reklamy użyty w reklamie opakowującej.
creative_id string

Identyfikator kreacji użytej w reklamie w ramce.
creative_ad_id string

Identyfikator reklamy kreacji użytej w reklamie z kodem towarzyszącym
deal_id string

Opcjonalny identyfikator umowy dla reklamy z kodem towarzyszącym.

Weryfikacja

Weryfikacja zawiera informacje dotyczące Open Measurement, które ułatwiają pomiar widoczności i weryfikację przez zewnętrznych dostawców. Obecnie obsługiwane są tylko zasoby JavaScript. Informacje znajdziesz na stronie https://iabtechlab.com/standards/open-measurement-sdk/
Zapis JSON
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
Pola
vendor string

Dostawca systemu weryfikacji.
java_script_resources [object(JavaScriptResource)]

Lista zasobów JavaScriptu do weryfikacji.
tracking_events [object(TrackingEvent)]

Lista zdarzeń śledzenia na potrzeby weryfikacji.
parameters string

Nieprzejrzysty ciąg znaków przekazany do kodu weryfikacyjnego wczytywania.

JavaScriptResource

JavaScriptResource zawiera informacje potrzebne do weryfikacji przez JavaScript.
Zapis JSON
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
Pola
script_url string

Identyfikator URI wskazujący ładunek JavaScriptu.
api_framework string

APIFramework to nazwa platformy wideo, która uruchamia kod weryfikacyjny.
browser_optional boolean

Określenie, czy ten skrypt można uruchomić poza przeglądarką.

TrackingEvent

Tag TrackingEvent zawiera adresy URL, które w określonych sytuacjach powinny być pingowane przez klienta.
Zapis JSON
{
  "event": string,
  "uri": string,
}
Pola
event string

Typ zdarzenia śledzenia.
uri string

Zdarzenie śledzenia, które ma być pingowane.

UniversalAdID

UniversalAdID służy do podawania unikalnego identyfikatora kreacji, który jest utrzymywany w różnych systemach reklamowych.
Zapis JSON
{
  "id_value": string,
  "id_registry": string,
}
Pola
id_value string

Uniwersalny identyfikator reklamy wybranej dla reklamy.
id_registry string

Ciąg znaków służący do identyfikacji adresu URL witryny rejestru, w której katalogowany jest uniwersalny identyfikator reklamy wybranej kreacji.

Reklama towarzysząca

Element towarzyszący zawiera informacje o reklamach towarzyszących, które mogą być wyświetlane razem z reklamą.
Zapis JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
Pola
click_data object(ClickData)

Dane o kliknięciach tej reklamy towarzyszącej.
creative_type string

Atrybut CreativeType w węźle <StaticResource> w pliku VAST, jeśli jest to kreacja towarzysząca typu static.
height int32

Wysokość reklamy towarzyszącej w pikselach.
width int32

Szerokość tego elementu w pikselach.
resource string

W przypadku statycznych i towarzyszących elementów iframe będzie to adres URL do wczytania i wyświetlania. W przypadku kreacji towarzyszących HTML będzie to fragment kodu HTML, który powinien być wyświetlany jako kreacja towarzysząca.
type string

Typ tej kreacji towarzyszącej. Może być statyczny, iframe lub HTML.
ad_slot_id string

Identyfikator boksu towarzyszącego.
api_framework string

Platforma interfejsu API dla tego urządzenia.
tracking_events [object(TrackingEvent)]

Lista zdarzeń śledzenia tej reklamy towarzyszącej.

InteractiveFile

Element InteractiveFile zawiera informacje o kreacji interaktywnej (tj. SIMID), które powinny być wyświetlane podczas odtwarzania reklamy.
Zapis JSON
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
Pola
resource string

Adres URL interaktywnej kreacji.
type string

Typ MIME pliku dostarczonego jako zasób.
variable_duration boolean

Czy ta kreacja może poprosić o wydłużenie czasu trwania.
ad_parameters string

Wartość węzła <AdParameters> w VAST.