동적 광고 삽입(DAI)용 API를 사용하면 IMA SDK가 지원되지 않는 수익 창출 스트림(예: 스마트 TV)에 액세스할 수 있습니다. IMA는 사용 가능한 플랫폼에서 필요합니다. API는 모든 기존 DAI 기능을 지원하지만 게시자의 구현이 필요합니다.
API 사용 시 요구사항
다음 기능을 사용하려면 API를 사용할 때 게시자 구현이 필요합니다.
- HTTP 엔드포인트를 통해 DAI 스트림 액세스 및 JSON 응답 처리
- API 매개변수 구성 및 키-값 타겟팅
- 사용자 환경 구현(예: 클릭연결 및 아이콘)
- 플레이어의 ID3 이벤트를 수신하여 선형 실시간 방송 및 VOD 모두에 대한 플레이어 컨트롤 및 광고 추적/측정 구현
- 스크러빙 동작, 스냅백, 북마크 기능 구현
- 스트리밍 형식 선택: HLS 또는 DASH
API를 통해 VOD 또는 선형 실시간 방송 스트림에 대해 스트림을 요청하고 처리하는 방법에 다음 정보를 사용할 수 있습니다.
VOD
VOD API는 스트림 생성부터 광고 재생 확인까지 간단한 수명 주기를 따릅니다.
-
API 키 또는 HMAC 토큰과 함께 콘텐츠 소스 ID(
cmsid) 및 동영상 ID(vid)를 사용하는 HTTP POST와 광고 타겟팅 매개변수를 통해 스트림을 요청합니다.https://dai.google.com/ondemand/v1/hls/content/<contentId>/vid/<vid>/stream -
콘텐츠 재생 매니페스트, 자막, 광고 시점 및 콘텐츠 타이밍 정보에 대한 응답을 처리합니다.
{"content_duration": 123.451,"stream_manifest": "https://dai.google.com/.../master.m3u8","media_verification_url": "https://dai.google.com/.../media/","stream_id": "9ca0c62a-3291-4f95-986f-d1721f8b96f0","total_duration": 163.451,"valid_for": "8h0m0s","valid_until": "2018-05-16T23:21:16.558053292-07:00","ad_breaks": [...]} -
광고 시점별로 UI 렌더링을 위한 클릭연결, 컴패니언 및 광고 길이 정보와 같은 광고 요소의 개별 광고 세부정보를 처리합니다.
{"clickthrough_url": "https://dai.google.com/.../videoclick/1835622921898938400","description": "Example pre-roll ad","duration": 10,"seq": 1,"title": "Example pre-roll"} -
광고별로 광고 미디어 재생에서 추가된 ID3 값으로
media_verification_url을 트리거합니다.https://dai.google.com/view/p/service/vod/stream/3647080d-c223-442e-a364-c456ee712ece/loc/CBF/network/124319096/content/2474148/vid/bbb-clear/media/
Progress 이벤트는 광고 시간 이내 및 그 외 재생을 구분하고 다른 광고 추적용으로 게재되지 않습니다.
메타데이터 json 파일에서 미디어 식별자를 검색하여 progress 이벤트를 식별하고 type 필드가 progress로 설정되어 있는지 확인할 수 있습니다. 예를 들어 progress ID3는 동영상 컨트롤을 차단하는 데 사용할 수 있습니다.
선형 실시간 방송 스트림
선형 API는 스트림 생성부터 광고 재생 확인까지 간단한 수명 주기를 따릅니다.
-
API 키 또는 HMAC 토큰과 함께 이벤트 ID를 사용하는 HTTP POST와 광고 타겟팅 매개변수를 통해 스트림을 요청합니다.
https://dai.google.com/linear/v1/hls/event/<eventid>/stream
https://dai.google.com/linear/v1/dash/event/<eventid>/stream -
콘텐츠 재생 매니페스트, 자막, 광고 시점 및 콘텐츠 타이밍 정보에 대한 응답을 처리합니다.
{"stream_manifest": "https://dai.google.com/linear/.../master.m3u8","media_verification_url": "https://dai.google.com/linear/.../media/","metadata_url": "https://dai.google.com/linear/.../metadata","polling_frequency": 10,"stream_id": "793bf10c-2323-404d-b23b-0a529d96e651:MRN",} -
쿼리 매개변수의 메타데이터 URL에 광고 미디어 ID를 추가하여 폴링 실행 빈도 또는 각 ID3 광고 미디어 ID에 대해 광고 메타데이터를 요청합니다.
{"ad_breaks": {"0001127859": {"ads": 3,"duration": 30,"type": "mid"}},"ads": {"0001127859_ad2": {"ad_break_id": "0001127859","ad_id": "39135088","ad_system": "GDFP","clickthrough_url": "http://pubads.g.doubleclick.net/pcs/click?...","creative_id": "103990016608","description": "Example linear 10s ad","duration": 10,"position": 2,"title": "Example linear ad"}},"tags": {"google_0028792773": {"ad": "0001127859_ad2","ad_break_id": "0001127859","type": "firstquartile"}, ...}} -
광고별로 광고 미디어 재생에서 ID3 값을 추가하는
media_verification_url을 트리거합니다.https://dai.google.com/view/p/service/linear/stream/f0b8970b-cacb-4a9f-83ee-2ef29db47129:CBF2/loc/CBF2/network/51636543/event/sN_IYUG8STe1ZzhIIE_ksA/media/
Progress 이벤트는 광고 시간 이내 및 그 외 재생을 구분하고 다른 광고 추적용으로 게재되지 않습니다.
메타데이터 json 파일에서 미디어 식별자를 검색하고 type 필드가 progress로 설정되었는지 확인하여 진행 이벤트를 식별할 수 있습니다. 예를 들어 progress ID3는 동영상 컨트롤을 차단하는 데 사용할 수 있습니다.
DAI API를 사용하여 스트림에서 광고 시점이 언제 시작/종료됐는지 감지
DAI는 분위 이벤트(예: 시작, 1분위, 미드포인트, 3분위, 완료)에 대한 ID3 메타데이터를 광고 세그먼트에 삽입하고 진행 이벤트(1초마다)를 광고 및 슬레이트 세그먼트에 삽입합니다. 이러한 ID3 태그가 처음 관찰되면 '광고 시점 시작' 이벤트가 발생할 수 있습니다. 이후 2.5초 동안 이러한 ID3 태그가 발견되지 않으면 '광고 시점 종료'가 발생할 수 있습니다. DAI 삽입 ID3 태그는 'google_' 접두사 및 메타데이터 JSON 파일에서의 현재 위치를 통해 식별할 수 있습니다.
사용자 스트림당 타겟팅 또는 키-값을 동적으로 업데이트
session_update_url은 실시간 스트림의 경우 게재 예정 광고 요청에 사용하는 모든 광고 태그 매개변수를 대체하는 데 사용할 수 있습니다(replaceAdTagParameters와 유사). 이는 프로그램별 및 사용자별로 타겟팅 정보를 업데이트해야 하는 경우에 유용합니다(예: 타겟팅을 미리 알 수 없는 실시간 스포츠의 경우).