Export dat streamu DAI v reálném čase

Obsah této stránky

• Dodání protokolu
• Protokol doručení manifestu
• Protokol zobrazených přestávek
  • Struktura protokolu zobrazených přestávek
    • Stav reklam
    • Stav prvků slate
• Protokol interakcí s reklamním serverem
   

Pomocí protokolů v reálném čase pro dynamické vkládání reklam (DAI) můžete téměř v reálném čase exportovat data na úrovni streamu za účelem sledování a odstraňování problémů se zobrazováním. Tento článek popisuje specifikace doručování souborů protokolů, konkrétní pole a známé problémy.

Dodání protokolu

Soubory protokolů se přibližně každých 5 minut ukládají do segmentů úložiště konkrétních vydavatelů ve službě Google Cloud.

Název segmentu je: gs://gdai-[NETWORK_CODE]

Názvy souborů mají tento formát:

[Log Type]_[Network Code]_[Stream Type]_[Content ID]_[YYYYMMDD]_[HHMMSS]_
[Random Number].gz

Kde:

• Log Type: Je buď DAIAdServerInteraction, DAIManifest, nebo DAIServedBreak
• Network Code: Kód sítě Ad Manager.
• Stream Type: Buď VOD, nebo Linear.
• Content ID: ID zdroje obsahu pro VOD, klíč podkladu pro živé vysílání.
• YYMMDD, HHMMSS: Čas vygenerování protokolu v UTC.
• Random Number: Náhodné číslo.

Soubory jsou zabaleny do formátu gzip a obsahují data ve formátu hodnot uzavřených ve dvojitých rovných uvozovkách a oddělených čárkami podle standardu RFC4180. V souladu s oddílem 2 bodem 5 standardu RFC4180, který uvádí, že každé pole může, ale nemusí být uzavřeno do dvojitých uvozovek, jsou všechna data v souborech protokolů uzavřena ve dvojitých uvozovkách.

Soubory zůstávají v segmentu 7 dní a pak jsou odstraněny.

Protokol doručení manifestu

Tento protokol poskytuje informace o dodání datového proudu videa. K dispozici jsou následující pole:

Pole**	Popis
timestamp INTEGER	Časové razítko UTC požadavku (v unixovém čase)
entry_id STRING	Jedinečný identifikátor záznamu v protokolu Záznamy protokolu se v současné době v našem systému mohou vyskytovat více než jednou. Toto ID lze použít k odstranění duplicitních záznamů.
stream_id STRING	Jedinečný identifikátor přiřazený každému streamu (tzv. ID SAM)
network_code INTEGER	Kód sítě majitele obsahu
content INTEGER	ID zdroje obsahu
vid STRING	ID videa
asset_key STRING	Klíč podkladu živého přenosu
manifest_type STRING	Typ manifestu videa: MANIFEST_TYPE_HLS MANIFEST_TYPE_DASH
stream_type STRING	Typ streamu: STREAM_TYPE_VOD STREAM_TYPE_LINEAR
request_type STRING	Typ žádosti: REQUEST_TYPE_STREAM_CREATE REQUEST_TYPE_MASTER_PLAYLIST REQUEST_TYPE_MEDIA_PLAYLIST REQUEST_TYPE_MPD REQUEST_TYPE_SUBTITLES REQUEST_TYPE_INTERSTITIALS REQUEST_TYPE_IFRAME_PLAYLIST REQUEST_TYPE_AD_METADATA (ID3 events)
beaconing_type STRING	Typ signálů reklamy pro stream: BEACONING_TYPE_SERVER_TRIGGERED: Na straně serveru BEACONING_TYPE_CLIENT_TRIGGERED: Na straně klienta (sada IMA SDK) BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED: Na straně klienta (brzy bude k dispozici rozhraní API DAI a IMA SDK)
http_method STRING	Metoda použitá v požadavku HTTP
user_agent STRING	User-agent zařízení
response_code INTEGER	Kód odpovědi HTTP
response_time DOUBLE	Latence požadavku (v sekundách)

Protokol zobrazených přestávek

Tento protokol poskytuje informace o reklamních přestávkách, které byly zobrazeny v klientech DAI. Další podrobnosti a příklady prezentace informací v protokolu najdete v sekci Struktura protokolu realizovaných reklamních přestávek. 

Pole**	Popis
timestamp INTEGER	Časové razítko UTC požadavku (v unixovém čase)
entry_id STRING	Jedinečný identifikátor záznamu v protokolu Záznamy protokolu se v současné době v našem systému mohou vyskytovat více než jednou. Toto ID lze použít k odstranění duplicitních záznamů.
stream_id STRING	Jedinečný identifikátor přiřazený každému streamu (tzv. SAM ID)
network_code STRING	Kód sítě majitele stránek
content INTEGER	ID zdroje obsahu
vid STRING	ID videa
asset_key STRING	Klíč podkladu živého přenosu
break_id STRING	ID této realizované reklamní přestávky V případě videa na vyžádání se jedná o ID přestávky VMAP. Příklady: „preroll-1“, „midroll-2“ U živého vysílání se bude jednat o pořadové číslo přestávky přiřazené k této přestávce poskytovatelem DAI. Příklady: „0000000001“, „0000000024“
expected_break_duration DOUBLE	Doba, po kterou DAI žádala o reklamy na základě toho, jak dlouho DAI očekávala, že bude reklamní přestávka trvat.
actual_break_duration DOUBLE	Doba, po kterou server DAI vyplnil obsah. Jedná se o souhrnnou dobu trvání reklam, prvků slate a podkladového obsahu DAI vyplněných v reklamní přestávce.
ads_duration DOUBLE	Trvání reklamních médií v reklamní přestávce. U obsahu na vyžádání se jedná také o skutečnou dobu trvání reklamní přestávky.
slate_duration DOUBLE	Trvání médií slate v reklamní přestávce.
ads_status STRING	Stav vložení reklamy do reklamní přestávky. Další podrobnosti najdete v sekci Struktura protokolu zobrazených přestávek.
slate_status STRING	Stav vložení prvku slate do reklamní přestávky. Další podrobnosti najdete v sekci Struktura protokolu zobrazených přestávek.
complete BOOLEAN	Zda byl reklamní pod dokončen. U streamů HLS to znamená, že služba DAI vložila signál cue-in, která signalizuje konec reklamního podu. U streamů DASH to znamená, že časový úsek pro reklamy skončil.

Struktura protokolu zobrazených přestávek

Protokoly přestávek zobrazovaných pomocí DAI poskytují informace o tom, jak DAI zobrazuje reklamní přestávky klientům. Následující tabulky Stav reklam a Stav prvků slate představují informace z protokolů DAI v různých případech vkládání reklam do obsahu. Další informace o protokolech zobrazených přestávek pro živé streamy

Stav reklam

Níže je uveden seznam stavů reklam a jejich význam.

Stav reklam	Popis
ADS_STATUS_INSERTED	Reklama byla úspěšně vložena.
ADS_STATUS_DROPPED_UNKNOWN	Reklamní pod byl z neznámého důvodu vynechán.
ADS_STATUS_ALL_ADS_MISSING	Reklamní pod byl vynechán, protože v něm chyběly všechny reklamy.
ADS_STATUS_TOO_MANY_MIDROLLS	Reklamní pod byl vynechán, protože reklamní server vrátil více podů pro reklamy uprostřed videa, než kolik jich do reklamních přestávek bylo možné vložit.
ADS_STATUS_OUT_OF_WINDOW	Reklamní přestávka je v okamžiku odeslání žádosti částečně nebo zcela mimo období pro vložení a místo reklam se vloží podkladový obsah.
ADS_STATUS_DISABLED	U tohoto streamu byly reklamy deaktivovány.
ADS_STATUS_DROPPED_FOR_PREROLL	Tento reklamní pod uprostřed videa byl vynechán, protože probíhala reklamní přestávka po reklamě před videem.
ADS_STATUS_EXPIRED	Platnost reklamního podu vypršela, protože žádost o reklamu nebyla dokončena včas, aby mohla být vložena do obsahu.
ADS_STATUS_HOLIDAY	Reklamní pod byl kvůli probíhajícím reklamním prázdninám vynechán.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	Reklamy byly zrušeny kvůli chybě, která se vyskytla v prvku slate. Viz stav prvků slate.

Stav prvků slate

Níže je uveden seznam stavů prvků slate a jejich význam.

Protokol interakcí s reklamním serverem

Tento protokol poskytuje informace o interakcích s reklamním serverem za účelem získání reklam. Další podrobnosti a příklady prezentace informací v protokolu najdete v článku Struktura protokolu interakcí s reklamním serverem.

Pole**	Popis
timestamp INTEGER	Časové razítko UTC požadavku (v unixovém čase)
entry_id STRING	Jedinečný identifikátor záznamu v protokolu Záznamy protokolu se v současné době v našem systému mohou vyskytovat více než jednou. Toto ID lze použít k odstranění duplicitních záznamů.
stream_id STRING	Jedinečný identifikátor přiřazený každému streamu (tzv. ID SAM)
network_code INTEGER	Kód sítě Ad Manager
content INTEGER	ID zdroje obsahu
vid STRING	ID videa
asset_key STRING	Klíč podkladu živého přenosu
pod_id INTEGER	ID reklamní přestávky: V případě videa na vyžádání se jedná o ID přestávky z formátu VMAP U živého vysílání se jedná o pořadové číslo přestávky
ad_server_host_name STRING	Název domény reklamního serveru
response_time DOUBLE	Latence požadavku (v sekundách)
response_type STRING	Typ odpovědi: VAST VMAP UNKNOWN: znamená, že byla přijata neplatná odpověď nebo vypršel časový limit odpovědi
response_code INTEGER	Kód odpovědi HTTP
row_type STRING	Typ záznamu v souboru protokolu: PRIMARY_REQUEST AD_POD WRAPPER INLINE Podívejte se na příklad odpovědi VMAP, který obsahuje všechny typy souborů protokolu.
vast_error_code STRING	Kód chyby šablony VAST
prefetch_stage STRING	Fáze předběžného načtení (pokud je povoleno)
ad_position STRING	Pozice vybrané reklamy v reklamním podu Hodnota vybraných reklam začíná od 1 U nepoužitých reklam z výběru samostatných reklam a u vynechaných reklam je toto pole prázdné
ad_id STRING	ID reklamy *
ad_system STRING	Reklamní systém *
ad_title STRING	Nadpis reklamy *
creative_id STRING	ID kreativy *
creative_ad_id STRING	ID reklamy kreativy *
universal_ad_id_registry STRING	Registr univerzálních ID reklam *
universal_ad_id_value STRING	Hodnota univerzálního ID reklamy *
creative_duration DOUBLE	Trvání kreativy
mezzanine_uri STRING	Adresa URL souboru Mezzanine * Vše v URI je escapováno s výjimkou znaků, které jsou v dokumentu RFC3986 uvedeny jako nerezervované.
media_uri STRING	Jedná se o první prvek v uzlu MediaFiles.* Vše v URI je escapováno s výjimkou znaků, které jsou v dokumentu RFC3986 uvedeny jako nerezervované.
break_start_uri STRING	Měřicí prvek, který slouží k měření začátku reklamní přestávky. Tato data pocházejí z odpovědi VMAP. Vše v URI je escapováno s výjimkou znaků, které jsou v dokumentu RFC3986 uvedeny jako nerezervované.
google_video_id STRING	Jedinečný identifikátor kreativy přidružené k této reklamě.

  * Tyto hodnoty pochází ze šablony VAST

** Pole, která pro konkrétní řádek nejsou relevantní, v něm mohou být ponechána prázdná.