동적 광고 삽입(DAI) 라이브 스트림 활동 모니터링 도구(SAM) API를 사용하면 개별 라이브 스트림 및 VOD 시청 세션을 검사하고 문제를 해결할 수 있습니다.
개별 라이브 스트림 또는 VOD 시청 세션을 시각적으로 검사하고 문제를 해결하려면 Google Ad Manager UI에서 스트림 활동 모니터링 도구를 사용하세요.
세션의 진단 데이터를 프로그래매틱 방식으로 가져오려면 Ad Manager API networks.daiSessions 리소스를 사용하세요.
사용 사례 이해
SAM API를 사용하면 다음과 같은 DAI 통합에서 스트림 진단을 자동화하고 광고 게재 문제를 해결할 수 있습니다.
- 스트림 세션 생성 확인: 라이브 스트림 또는 VOD 세션을 만들 때 Google DAI가 수신하는 매개변수,
STITCHED또는POD_SERVING의 병합 모드, 보고 모드, 콘텐츠 메타데이터를 확인합니다. - 광고 요청 및 응답 감사: 발신 동영상 광고 게재 템플릿(VAST) 및 동영상 광고 재생목록(VMAP) 광고 태그, HTTP 상태 코드, 응답 지연 시간, 원시 XML 응답 본문, 래퍼 리디렉션 체인을 검사합니다.
- 광고 모음 결정 및 광고 소재 문제 해결: Google DAI가 각 광고 모음에 대해 선택하거나 삭제하는 광고, 광고 모음의 각 광고 길이, 광고 소재의 소스 광고 시스템을 확인합니다.
- 광고 미리 가져오기 실행 추적: Google DAI가 광고 모음을 미리 가져오는지 확인하고 각 광고 모음의 미리 가져오기 단계를 확인합니다.
- DAI 광고 시점 API 및 광고 모음 게재 DAI API 호출 검증: DAI 광고 시점 API 및 광고 모음 게재 DAI API와 같은 API 호출에 대해 실제 광고 시점 실행, 게재된 광고 시간, 삽입된 슬레이트 시간을 확인합니다.
- 광고 이벤트 추적 확인: 클라이언트 측 또는 서버 측 추적 핑이 성공했는지 확인하고 광고 서버의 HTTP 응답을 검사합니다.
- 세션 모니터링 및 알림 자동화:
INFO,WARNING또는ERROR심각도가 있는 구조화된 발견 항목 항목을 파싱하여 자동화된 통합 테스트 및 프로덕션 모니터링 파이프라인에서 재생 또는 수익 창출 문제를 감지합니다.
최상위 리소스 알아보기
SAM API는 admanager.googleapis.com 엔드포인트의 Google Ad Manager REST API(베타)의 일부이며 networks.daiSessions.get 읽기 전용 메서드를 노출합니다. DAI 세션 ID 또는 맞춤 디버그 키를 사용하여 DaiSession 리소스를 쿼리할 수 있습니다. DAI는 재생 후 최대 3일 동안 세션 기록을 보관합니다.
SAM API는 Google Ad Manager 네트워크의 모든 DaiSession 리소스 나열을 지원하지 않습니다.
SAM으로 DAI 스트림 응답 검사
Google DAI가 스트림 요청을 처리하는 방식을 확인하려면 DaiSession 응답을 검사합니다.
- 전체 서비스 DAI API:
creationContext.streamCreateRequest필드를 검사하여 스트림 등록 호출을 확인하고,adSelections및adPods맵을 확인하여 광고 결정을 검토하고,adBreaks맵을 검사하여 병합된 광고, 슬레이트 광고 소재, 기본 콘텐츠 길이를 확인합니다. - 광고 모음 게재 DAI API:
creationContext.stitchingType필드가POD_SERVING값으로 설정되어 있는지 확인하고,adPods및adBreaks맵의adBreakId필드를 광고 모음 매니페스트 또는 광고 모음 세그먼트 요청 호출과 교차 확인하고,trackingPings맵에서 서버 측 또는 미디어 확인 비콘을 검사합니다. - DAI 광고 시점 API:
AdBreak객체의breakSequence값을AdBreak.breakSequence속성과 일치시킵니다.
첫 번째 요청하기
인증을 설정하고 DAI 세션 리소스를 가져오려면 라이브 스트림 활동 모니터링 도구 API 사용을 참고하세요.