Zjištění ID relace DAI nebo ladicího klíče

Každému streamu uživatele je přiřazeno ID relace, které po události zůstane 48 hodin uloženo. Sledované relace zůstanou uloženy 60 dní. ID relace můžete zadat do pole Identifikátor relace v nástroji ke sledování aktivity streamování. Ve výsledcích vyhledávání uvidíte podrobnosti o žádostech uživatele o reklamy, abyste mohli odstranit problémy s videostreamem.

Popíšeme následující způsoby zjištění ID relace:

• Zjištění ID relace v aplikaci, která používá sadu IMA SDK
• Zjištění ID relace při kontrole provozu HTTP
• Zjištění ID relace z emulovaného požadavku HTTP
• Zjištění ID relace v žádosti o stream SSB

Použití ladicího klíče k zobrazení aktivity nebo odstraňování problémů s videostreamem ^{(verze beta)} 

K zobrazení aktivity nebo odstraňování potíží s videostreamem můžete použít také ladicí klíč.

Pro každý stream či relaci můžete nastavit nebo předat jedinečný klíč, pomocí kterého stream budete moci ladit v nástroji SAM. Pokud použijete pro několik relací stejný klíč, bude možné prohledávat a ladit pouze nejnovější z nich.

• Streamy vyžádané pomocí sady IMA SDK: Prostudujte si informace o volání API k nastavení klíče v dokumentaci sady SDK.
• Streamy vyžádané bez sady IMA SDK (SSB): Ladicí klíč předejte pomocí parametru dai-sam-id.

  _{Příklad: https://dai.google.com/linear/hls/event/.../master.m3u8?dai-sam-id=abcdef-0a1b-12a3}

Klíče nesmějí obsahovat žádné údaje umožňující zjištění totožnosti:.

Zjištění ID relace v aplikaci, která používá sadu IMA SDK

Když stream videa vytvoříte pomocí sady IMA SDK, můžete ID relace streamu zjistit zavoláním k tomu určené metody. Podívejte se, jak ID získat v sadě SDK pro konkrétní platformu:

• Sada SDK pro Android
• iOS SDK
• tvOS SDK
• HTML5 SDK
• Chromecast SDK
• Roku SDK

Vývojáři aplikací často ID relace zjišťují a protokolují, aby bylo k dispozici k řešení problémů se streamováním.

Protože ID relace je zásadní při zjišťování podrobností o zobrazování reklam ve streamu uživatele, je dobré do aplikace implementovat metodu nebo skrytou funkci, pomocí které jej bude možné snadno zobrazit.

Zjištění ID relace při kontrole provozu HTTP

Požadavky odesílané z aplikace se sadou IMA SDK můžete sledovat pomocí nástroje na sledování provozu HTTP.

Když pomocí sady IMA SDK požádáte o videostream dynamického vkládání reklam (DAI), odešlou se dva požadavky HTTP:

• Požadavek HTTP POST, na který by měla být vrácena odpověď se stavem 201 potvrzující, že byl vytvořen nový stream.
• Požadavek HTTP GET odeslaný na adresu URL uvedenou v poli stream_manifest. *

Ve struktuře JSON jsou poskytnuty další informace, včetně údaje stream_id. Tento údaj je ID relace, které je potřeba zadat do pole Identifikátor relace.

Zjištění ID relace z emulovaného požadavku HTTP

Sekvenci požadavků HTTP sady SDK můžete emulovat z příkazového řádku pomocí nástroje curl. Je třeba použít ID obsahu a ID videa z adresy URL streamu videa na vyžádání.

Příklad s ID obsahu 12345 a ID videa sample-video:

1. Na příkazovém řádku zadejte toto:

   curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"

2. (Volitelné) Přesměrujte výsledek do nástroje python -mjson.tool, abyste si ho mohli prohlédnout ve snadno čitelném formátu.

Ukázka výstupu *

{
"duration": 784,
"stream_id": "19b40be0-7942-44ca-97e0-fc7b27f14029",
"stream_manifest": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/master.m3u8",
"stream_type": "on_demand",
"subtitles": [ ... ],
"time_events_url": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/time-events.json"
}

^{* Adresu URL manifestu stream_manifest lze použít k otestování přehrávání v přehrávači HLS (například ve webovém prohlížeči Safari).}

Zjištění ID relace v žádosti o stream SSB

Když pomocí SSB požádáte o videostream dynamického vkládání reklam (DAI), odešlou se dva požadavky HTTP:

1. Požadavek HTTP GET, na který by měla být vrácena odpověď se stavem 302, což značí přesměrování.
2. Požadavek HTTP GET na přesměrovanou adresu URL. Tato adresa URL obsahuje ID relace, které byste měli zadat do pole Identifikátor relace.

ID relace můžete zjistit také sledováním požadavků HTTP v nástroji na sledování síťového provozu z mobilní aplikace nebo aplikace OTT.

Zjištění ID relace u žádosti o stream SSB pomocí Chromu

1. Načtěte v prohlížeči adresu URL streamu s obsahem.

   Příklad s ID obsahu 12345 a ID videa sample-video:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. V Chromu načtěte Nástroje pro vývojáře.
3. V nástrojích pro vývojáře přejděte na kartu Síť.
4. Vyfiltrujte požadavky, které obsahují řetězec dai.google.com.

5. První dva požadavky odeslané do domény dai.google.com by měly být žádosti o soubor master.m3u8:

   První požadavek: Odpověď 302

   

   Druhý požadavek: Adresa URL s ID relace.

   
6. Zkopírujte ID relace a zadejte ho do pole Identifikátor relace.

Ohledně záležitostí souvisejících s odstraňováním problémů s DAI nebo s výpadky DAI kontaktujte podporu pro majitele obsahu.