모든 사용자 스트림에는 이벤트 후 48시간 동안 저장되는 세션 ID가 부여됩니다. 모니터링된 세션은 60일 동안 저장됩니다. 실시간 스트림 활동 모니터링 도구(SAM)의 '세션 식별자' 필드에 세션 ID를 입력할 수 있습니다. 검색결과를 통해 사용자 광고 요청에 대한 세부정보를 확인하여 동영상 스트림 문제를 해결할 수 있습니다.
다음과 같은 세션 ID 검색 방법에 대해 알아보겠습니다.
디버그 키를 사용하여 활동 확인 또는 동영상 스트림 문제 해결 (베타)
또는 디버그 키를 사용하여 활동을 확인하거나 동영상 스트림 문제를 해결할 수 있습니다.
SAM을 사용하여 스트림을 디버그할 수 있도록 모든 스트림이나 세션에 고유 키를 설정하거나 전달할 수 있습니다. 세션 전반에서 동일한 키를 사용하면 가장 최근 세션만 검색 가능하며 디버그에 사용할 수 있게 됩니다.
- IMA SDK를 포함하여 요청한 스트림: API 호출 관련 SDK 문서를 참조하여 키를 설정하세요.
- IMA SDK(SSB)를 제외하고 요청한 스트림:
dai-sam-id
매개변수를 사용하여 디버그 키를 전달합니다.예:
https://dai.google.com/linear/hls/event/.../master.m3u8?dai-sam-id=abcdef-0a1b-12a3
키에는 개인 식별 정보가 포함되면 안 됩니다.
IMA SDK를 사용하는 앱에서 세션 ID 찾기
동영상 스트림 생성 시 IMA SDK를 사용하는 경우 세션 ID를 가져오도록 메서드를 호출할 수 있습니다. 각 플랫폼의 SDK에서 ID를 가져오는 방법에 대해 자세히 알아보세요.
대부분의 애플리케이션 개발자는 스트림 문제 해결 시 사용할 수 있도록 세션 ID를 캡처하여 기록합니다.
세션 ID는 사용자 스트림의 광고 게재와 관련된 세부정보를 검토할 때 반드시 필요하므로 ID를 쉽게 표시하는 메서드나 숨겨진 기능을 애플리케이션에 구현하면 좋습니다.
HTTP 트래픽을 검사할 때 세션 ID 찾기
IMA SDK를 사용하는 애플리케이션에서 프록시 도구로 HTTP 요청을 모니터링할 수 있습니다.
IMA SDK를 사용하여 동적 광고 삽입(DAI) 동영상 스트림을 요청하면 다음과 같은 두 가지의 HTTP 요청이 발생합니다.
- HTTP
POST
가 새로운 스트림이 생성되었음을 나타내는 201 상태로 반환되어야 합니다. stream_manifest
필드의 URL에 대한 HTTPGET
요청입니다. *
추가 정보는 JSON 구조로 반환되며, 여기에는 stream_id
가 포함됩니다. 이는 '세션 식별자' 필드에 입력해야 하는 세션 ID입니다.
에뮬레이션된 HTTP 요청에서 세션 ID 찾기
명령줄 프롬프트의 curl
및 VOD 스트림 URL의 콘텐츠 ID와 동영상 ID를 사용하여 SDK HTTP 요청 순서를 에뮬레이션할 수 있습니다.
예를 들어 콘텐츠 ID 12345
와 동영상 ID sample-video
를 사용하는 경우:
- 명령줄 프롬프트에 다음과 같이 입력합니다.
curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"
-
(선택사항) Pretty Print로 보려면
python -mjson.tool
을 파이프 문자로 연결합니다.
샘플 출력 *
{
"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"
}
* stream_manifest
URL을 사용하여 HLS 플레이어에서 재생 테스트가 가능할 수도 있습니다(예: Safari 웹브라우저).
SSB 스트림 요청에서 세션 ID 찾기
SSB를 사용하여 동적 광고 삽입(DAI) 동영상 스트림을 요청하면 다음과 같은 두 가지의 HTTP 요청이 발생합니다.
- HTTP
GET
요청이 리디렉션을 나타내는 302 상태로 반환되어야 합니다. - 리디렉션된 URL에 대한 HTTP
GET
요청입니다. 이 URL에는 '세션 식별자' 필드에 입력해야 하는 '세션 ID'가 포함되어 있습니다.
모바일 또는 OTT 애플리케이션에서 프록시 도구로 HTTP 요청을 모니터링할 때 세션 ID를 찾을 수도 있습니다.
Chrome을 사용하여 SSB 스트림 요청의 세션 ID 찾기
-
브라우저에서 콘텐츠 스트림 URL을 로드합니다.
예를 들어 콘텐츠 ID
12345
와 동영상 IDsample-video
를 사용하는 경우 다음을 로드합니다.
http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8
- Chrome에서 개발자 도구를 로드합니다.
- 개발자 도구의 네트워크 탭으로 이동합니다.
dai.google.com
을 포함하는 요청을 필터링합니다.-
'dai.google.com' 도메인에 대한 첫 두 가지 요청은 'master.m3u8' 파일이 대상이 되어야 합니다.
첫 번째 요청: 302 응답
두 번째 요청: 세션 ID가 포함된 URL
- 세션 ID를 복사하여 세션 식별자 필드에 입력합니다.