Přejít na: Struktura záznamů protokolu | Odpověď VMAP s vloženou šablonou VAST | Odpověď VMAP bez vložené šablony VAST | Samostatné žádosti VAST
Protokoly interakcí s reklamním serverem DAI poskytují informace o interakcích s reklamním serverem za účelem získání reklam. Tento článek popisuje strukturu záznamů protokolu a poskytuje konkrétní příklady reprezentace žádostí VMAP ve výstupních souborech protokolů.
Žádosti VMAP a struktura záznamů protokolu
Na žádosti VMAP mohou být vráceny reklamní pody s vloženými odpověďmi VAST, bez vložených odpovědí VAST nebo se samostatnými žádostmi VAST. Struktura záznamu protokolu se liší v závislosti na odpovědi VMAP.
Všechny pody v konkrétní žádosti VMAP nutně nemusí mít buď všechny vložené šablony VAST, nebo všechny adresy URL přesměrování VAST. Některé mohou mít vloženou šablonu VAST a jiné s adresy URL přesměrování VAST.
Pole záznamu protokolu
Všechny záznamy v protokolech interakcí s reklamním serverem obsahují následující pole v uvedeném pořadí. Některá pole však mohou být prázdná. Další informace o polích protokolu interakcí s reklamním serverem
"timestamp","entry_id","stream_id","network_code","content","vid","asset_key","pod_id","ad_server_host_name","response_time","response_type",
"response_code","row_type","vast_error_code","prefetch_stage","ad_position","ad_id","ad_system","ad_title","creative_id","creative_ad_id","universal_ad_id_registry","universal_ad_id_value","creative_duration"
Struktura a pole protokolu interakcí
Odpověď VMAP s vloženou šablonou VAST
Zde je znázorněna stromová struktura vzorové odpovědi VMAP, která vrací vložené odpovědi VAST. Protokoly interakcí s reklamním serverem obsahují záznam pro každý uzel ve výše uvedeném stromu žádostí a odpovědí.
-
P představuje primární žádost VMAP na reklamní server. V tomto příkladu vedla primární žádost VMAP ke dvěma vloženým reklamním podům (Pod-1 a Pod-2):
-
Kód VAST podu Pod-1 obsahuje dvě obálky (W-1 a W-2) a vloženou reklamu (Ad-3):
- Obálka W-1 vedla k další obálce (W-1-2), která vrátila vloženou reklamu (Ad-1).
- Obálka W-2 vedla k vložené reklamě ( Ad-2).
-
Kód VAST podu Pod-2 obsahuje dvě obálkové reklamy (W-3 a W-4):
- U žádosti o obálku W-3 vypršel časový limit.
- Obálka W-4 vedla k vložené reklamě (Ad-4).
-
Celkově Pod-1 vedl ke 3 vloženým reklamám ( Ad-1 ,Ad-2 a Ad-3) a Pod-2 vedl k jedné vložené reklamě (Ad-4). Pokud nedošlo k žádným chybám, měly by všechny tyto koncové uzly vést k vloženým reklamám.
Koncové uzly vždy pocházejí z nadřazených odpovědí.
Pokud by například uzel obálky obsahoval vloženou reklamu, u záznamu uzlu obálky by byly uvedeny hodnoty v polích ad_server_host_name
, response_time
, ad_system
a volitelně v polích ad_position
a ad_id
. Každý koncový uzel pod uzlem obálky bude obsahovat informace o reklamě a kreativě pro každou vloženou reklamu v obálce, konkrétně pro pole ad_position
, ad_id
, ad_system
. ad_title
, creative_id
, creative_ad_id
, universal_ad_id_registry
, universal_ad_id_value
a creative_duration
.
Vzorové záznamy protokolu pro odpověď VMAP s vloženou šablonou VAST
Vyjdeme z tohoto vzorového streamu:
- ID streamu:
12345abc-0abc-1234-5678-9abc12345def
- Kód sítě:
12345678
- ID v systému CMS:
12345
- ID videa:
sample-vid
Záznamy uzlů by mohly obsahovat následující informace:
Uzel: P
"1629979322398140","ZmMyNmUwMTAtOGU2Ni00ZjFkLTgzYmUtNTMxNDA3NGExMDgx","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","","pubads.g.doubleclick.net","0.058311558","VMAP","200","PRIMARY_REQUEST","","PREFETCH_STAGE_NONE","","","","","","","","",""
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel P:
- Pole
pod_id
je prázdné (""
), protože se jedná o primární žádost VMAP. - Pole
row_type
je nastaveno na hodnotuPRIMARY_REQUEST
. - Pole
ad_position
je prázdné (""
). - Všechny informace související s reklamami a kreativami jsou prázdné (
""
).
Uzel: Pod-1
"1629979322398140","YTZlMjY5OTUtODliMy00MmI0LWE3OTUtMzc0NjAwZWViMjFm","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","","",""
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel Pod-1:
- Pole
pod_id
je nastaveno na hodnotumid-roll-1
, kterou poskytl reklamní server. - Pole
row_type
je nastaveno na hodnotuAD_POD
. - Pole
ad_server_host_name
je prázdné (""
), protože informace o podu byly odeslány jako vložená šablona VAST v primární žádosti. - Pole
ad_position
je prázdné (""
). - Všechny informace související s reklamami a kreativami jsou prázdné (
""
).
Uzel: W-1
"1629979322398140","MTRmN2YxNzgtNTY2NS00NGYyLWI5NDMtNGYzYjU5NGNhNTIz","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","pubads.g.doubleclick.net","0.048344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
Uzel: W-1-2
"1629979322398140","YTFkYTA5YTItYzgxMC00NTUwLTlmZDctZjU0NjhjY2E5YWRm
","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","pubads.g.doubleclck.net","0.042344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730126","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel W-1-2:
- Pole
ad_server_host_name
je nastaveno na hodnotupubads.g.doubleclick.net
. - Pole
response_time
je nastaveno na hodnotu0.042344558
.
Uzel: Ad-1
"1629979322398140","NTYyMDc4ZWYtODRkOS00MjFkLWI0NDEtNTY3OTEwZWVmZDQ0","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","INLINE","","PREFETCH_STAGE_NONE","1","4617730730","GDFP","LI first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Zobrazit pole záznamů v protokolu
Ad-1 je vložená reklama, která je obsažena v obálce W-1-2. Záznam protokolu pro uzel Ad-1:
- Pole
pod_id
je nastaveno na hodnotumid-roll-1
. - Pole
row_type
je nastaveno na hodnotuINLINE
. - Pole
ad_server_host_name
je prázdné (""
). - Pole
ad_position
je nastaveno na hodnotu1
.
Uzel: W-2
"1629979322398140","MmEzNjAwMTUtZTE1MS00ZTA0LTlhNWYtYmJmMzFkY2Y3YmJi","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","pubads.g.doubleclick.net","0.034534558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","2","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
Uzel: Ad-2
"1629979322398140","MjIzYzYyNzItZWU0Zi00NGM2LWIxYWYtZTdiYjkxMzZmYWFl
","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","INLINE","","PREFETCH_STAGE_NONE","2","4617858678","GDFP","LI second position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Zobrazit pole záznamů v protokolu
Uzel: Ad-3
"1629979322398140","ZTgwMWVkYzYtMmNkMS00NmUyLTk1ZDMtMTA3ZTM0ODQ5Yjhj","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","INLINE","","PREFETCH_STAGE_NONE","3","4617858678","GDFP","LI third position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Zobrazit pole záznamů v protokolu
Uzel: Pod-2
"1629979322398140","NTg1ZjMwZDQtYWY5Mi00ZjA0LWI0YTMtZWYxNmIwZTNkYWZj","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","","","","","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","",""
Zobrazit pole záznamů v protokolu
Uzel: W-3
"1629979322398140","MGFmZTE4ZGYtZGZiYS00NTU1LWIzOWQtZjAyY2FhZmY4ZmM0","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","pubads.g.doubleclick.net","5.000000000","","","WRAPPER","301","PREFETCH_STAGE_NONE","0","","","","","","","",""
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel W-3:
- Pole
vast_error_code
je301
, protože časový limit žádosti vypršel. - Pole
ad_position
je nastaveno na hodnotu0
. - Pole
response_type
je prázdné (""
), protože časový limit žádosti vypršel.
Uzel: W-4
"1629979322398140","MzI3NTg1Y2UtNGQyMy00NGE4LTg3YTItNGI2ZWJiMjM1YTQ1","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","pubads.g.doubleclick.net","0.042344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730126","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
Uzel: Ad-4
"1629979322398140","MmEwZTU2YmMtOGQ4NS00NjgxLTlhMzEtMGQ2MmRhZTZhZjc0","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","","","","","INLINE","","PREFETCH_STAGE_NONE","1","4617731672","GDFP","LI first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel Ad-4:
- Pole
ad_position
je nastaveno na hodnotu1
.
Odpověď VMAP bez vložené šablony VAST (s adresami URL přesměrování VAST)
Stromová struktura odpovědi VMAP může místo vložených odpovědí VAST obsahovat adresy URL přesměrování VAST. Bez ohledu na způsob získání odpovědi (prostřednictvím vložených adres URL nebo adres URL s přesměrováním) zůstávají celkové uzly stromu velmi podobné.
Jediný rozdíl je v tom, že u odpovědí získaných prostřednictvím přesměrování bude záznam AD_POD
obsahovat hodnoty parametrů ad_server_host_name
, response_time
a response_type
, které uvádějí, že došlo k dalšímu přesměrování.
V následujících ukázkových záznamech jsou tyto dodatečné informace zvýrazněny.
Vzorové záznamy protokolu pro odpověď VMAP brz vložené šablony VAST
Vyjdeme z tohoto vzorového streamu:
- ID streamu:
12345abc-0abc-1234-5678-9abc12345def
- Kód sítě:
12345678
- ID v systému CMS:
12345
- ID videa:
sample-vid
Záznamy uzlů by mohly obsahovat následující informace:
Uzel: Pod-1
"1629979322398140","Nzg0MDczZGMtNzA5Yy00ODllLTgxZTAtNDBlZmMyMmU5OTE5","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","adpodreq1.example.com","0.234231433","VAST","200","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","",""
Zobrazit pole záznamů v protokolu
Podřízené uzly obálek a reklam odpovědí VMAP bez vložené šablony VAST se chovají stejně jako uzly s vloženými šablonami VAST.
Samostatné žádosti VAST
Protože většina žádostí o reklamy VAST pochází ze systému DAI pro lineární/živé vysílání, pole cms_id
a vid
u těchto záznamů nejsou nastavena. Místo toho je nastaveno pole asset_key
.
Vzorové záznamy protokolu pro samostatnou žádost VAST
Vyjdeme z tohoto vzorového streamu:
- ID streamu:
d07258a5-0abc-47e8-954d-e61fdaeb739c
- Kód sítě:
51636543
- Klíč podkladu:
asset_key
Záznamy uzlů by mohly obsahovat následující informace:
Uzel: P
"1629979322398140","Nzg0MDczZGMtNzA5Yy00ODllLTgxZTAtNDBlZmMyMmU5OTE5","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.058311558","VAST","200","PRIMARY_REQUEST","","PREFETCH_STAGE_NONE","","","","","","","","",""
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel P:
- Pole
pod_id
je prázdné (""
), protože se jedná o primární žádost VMAP. - Pole
row_type
je nastaveno na hodnotuPRIMARY_REQUEST
. - Pole
ad_position
je prázdné (""
). - Všechny informace související s reklamami a kreativami jsou prázdné (
""
).
Uzel: Pod-1
"1629979322398140","ZmMwYzA4N2ItNmUxOC00OTgxLWE4OTYtZmUxZTc1NGJlYThk","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","","","","","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","","",""
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel P-1:
- Podle
pod_id
je nastaveno na hodnotu363
(podle oznámení o reklamní přestávce). - Pole
row_type
je nastaveno na hodnotuAD_POD
. - Pole
ad_server_host_name
,response_time
aresponse_type
jsou prázdná (""
), protože informace o podu byly získány prostřednictvím primární žádosti. - Pole
ad_position
je prázdné (""
). - Všechny informace související s reklamami a kreativami jsou prázdné (
""
).
Uzel: W-1
"1629979322398140","NWY4YTM0YTYtZTgwMy00YWYyLWE3N2UtNTVmMzA0ZDNhYzQ4","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.048344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
Uzel: W-1-2
"1629979322398140","ZTY3ZWViZmUtNzg1Ny00MmFhLWE0ZTctNjE2YzQyNjA3NmQx","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.042344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730126","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
Uzel: Ad-1
"1629979322398140","MGRjMzg3OTctM2U3NS00NWE4LWFkMWEtNzg4YTg1ZmE0NTI2","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","","","","","INLINE","","PREFETCH_STAGE_NONE","1","4617730730","GDFP","LI Sponsorship - CT External_Home - CH DFP - first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Zobrazit pole záznamů v protokolu
V záznamu protokolu pro uzel Ad-1:
- Podle
pod_id
je nastaveno na hodnotu363
(podle oznámení o reklamní přestávce). - Pole
row_type
je nastaveno na hodnotuINLINE
. - Pole
ad_server_host_name
je prázdné (""
). - Pole
ad_position
je nastaveno na hodnotu1
.
Uzel W-2
"1629979322398140","ZjcxMWYyOTYtMmI4ZC00NDYxLTg4NDUtZmFhNGUxM2NlZThl","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.034534558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","2","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Zobrazit pole záznamů v protokolu
Uzel: Ad-2
"1629979322398140","NjEyY2QxNWQtNDQ3NS00MzRiLWI2YTAtNTU5NDI5MDZiZTR","d07258a5-0abc-47e8-954hd-e61fdaeb739c","51636543","","","asset_key","363","","","","","INLINE","","PREFETCH_STAGE_NONE","2","4617858678","GDFP","LI Sponsorship - CT External_Home - CH DFP - first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Zobrazit pole záznamů v protokolu
Uzel: Ad-3
"1629979322398140","NWJlMTQzY2EtOTI4NS00OWY0LThlZjYtODU1ZDk2YjU4Nzlm
","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","","","","","INLINE","","PREFETCH_STAGE_NONE","3","4617858678","GDFP","LI Sponsorship - CT External_Home - CH DFP - first position in midroll","138228457232","","GDFP","138228457232","30.000000000"