라이브 API를 게재하는 동적 광고 삽입 광고 모음

동적 광고 삽입 API를 사용하면 DAI 라이브 스트림을 요청하고 추적할 수 있습니다.

서비스: dai.google.com

모든 URI는 https://dai.google.com을 기준으로 합니다.

메서드: 스트림

HTTP 요청

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

경로 매개변수

요청 본문

요청 본문은 application/x-www-form-urlencoded 유형이며 다음 매개변수를 포함합니다.

응답 본문

성공하면 응답 본문에 새 Stream 객체가 포함됩니다.

Open Measurement

DAI API에는 Verifications 필드에 Open Measurement 인증에 관한 정보가 포함되어 있습니다. 이 필드에는 광고 재생을 확인하기 위해 서드 파티 측정 코드를 실행하는 데 필요한 리소스와 메타데이터를 나열하는 Verification 요소가 하나 이상 포함됩니다. JavaScriptResource만 지원됩니다. 자세한 내용은 IAB Tech Lab 및 VAST 4.1 사양을 참고하세요.

메서드: 광고 모음 세그먼트

HTTP 요청

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

경로 매개변수

쿼리 매개변수

각주

1. 초기화 세그먼트에는 sd가 필요하지 않습니다. ↩
2. 길이가 없는 광고 시점이 사용 설정된 이벤트에는 pd가 필요하지 않습니다. ↩

예

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

응답 본문

요청이 성공하면 응답 본문은 요청에 지정된 형식 및 매개변수와 일치하는 재생 가능한 스트림 세그먼트가 됩니다.

메서드: HLS 포드 매니페스트

클라이언트 동영상 플레이어가 로드 및 재생할 준비가 된 라이브 스트림의 HLS 광고 모음 매니페스트를 검색합니다.

HTTP 요청

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}.m3u8?stream_id={stream_id}&pd={pod_duration}

경로 매개변수

쿼리 매개변수

응답 본문

성공하면 응답 본문은 HLS 다중 변형 재생목록입니다.

메서드: DASH 광고 모음 매니페스트

클라이언트 동영상 플레이어가 로드하고 재생할 준비가 된 라이브 스트림의 MPEG-DASH 광고 모음 매니페스트를 검색합니다.

HTTP 요청

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

경로 매개변수

쿼리 매개변수

응답 본문

성공한 경우 응답 본문은 MPEG-DASH mpd 재생목록입니다.

방법: DASH 포드 기간 템플릿

HTTP 요청

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

경로 매개변수

쿼리 매개변수

응답 본문

성공하면 응답 본문에 새 PodTemplateResponse 객체가 포함됩니다.

방법: 미디어 인증

재생 중에 광고 미디어 식별자를 발견하면 위의 stream 엔드포인트에서 가져온 media_verification_url을 사용하여 즉시 요청합니다. 이러한 요청은 서버가 미디어 인증을 시작하는 서버 측 비커닝 스트림에 필요하지 않습니다.

media verification 엔드포인트에 대한 요청은 멱등적입니다.

HTTP 요청

GET https://{media-verification-url}/{ad-media-id}

응답 본문

media verification는 다음 응답을 반환합니다.

• 미디어 인증이 성공하고 모든 핑이 전송되면 HTTP/1.1 204 No Content입니다.
• HTTP/1.1 404 Not Found: 잘못된 URL 형식 또는 만료로 인해 요청이 미디어를 확인할 수 없는 경우.
• HTTP/1.1 404 Not Found: 이 ID에 대한 이전 확인 요청이 성공한 경우
• HTTP/1.1 409 Conflict: 이 시점에 다른 요청에서 이미 핑을 전송하고 있는 경우

광고 미디어 ID

광고 미디어 식별자는 별도의 메타데이터 트랙(HLS 전송 스트림의 경우 시간 메타데이터, mp4 파일의 경우 emsg)으로 인코딩됩니다. 광고 미디어 식별자는 항상 google_ 문자열로 시작합니다.

각 광고 인증 요청을 실행하기 전에 메타데이터 항목의 전체 텍스트 콘텐츠를 광고 인증 URL에 추가해야 합니다.

메서드: metadata

metadata_url의 메타데이터 엔드포인트는 광고 UI를 빌드하는 데 사용되는 정보를 반환합니다. 메타데이터 엔드포인트는 서버가 광고 미디어 확인을 시작해야 하는 서버 측 비커닝 스트림에 사용할 수 없습니다.

HTTP 요청

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

응답 본문

성공하면 응답은 PodMetadata 인스턴스를 반환합니다.

메타데이터 파싱

메타데이터에는 tags, ads, 광고 breaks의 세 가지 개별 섹션이 있습니다. 데이터의 진입점은 tags 섹션입니다. 거기에서 태그를 반복하면서 동영상 스트림에서 찾은 광고 미디어 ID의 접두어 이름인 첫 번째 항목을 찾습니다. 예를 들어 다음과 같은 광고 미디어 ID가 있을 수 있습니다.

google_1234567890

그런 다음 google_12345라는 태그 객체를 찾습니다. 이 경우 광고 미디어 ID와 일치합니다. 올바른 광고 미디어 프리픽스 객체를 찾으면 광고 ID, 광고 시점 ID, 이벤트 유형을 찾을 수 있습니다. 그런 다음 광고 ID는 ads 객체의 색인을 생성하는 데 사용되고, 광고 시점 ID는 breaks 객체의 색인을 생성하는 데 사용됩니다.

응답 데이터

스트림

{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}

PodMetadata

{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}

TagSegment

{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}

AdBreak

{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}

광고

{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}

PodTemplateResponse

{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}

아이콘

{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}

ClickData

{
  "url": string,
}

FallbackImage

{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}

래퍼

{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}

인증

{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}

자바스크립트 리소스

{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}

TrackingEvent

{
  "event": string,
  "uri": string,
}

UniversalAdID

{
  "id_value": string,
  "id_registry": string,
}

컴패니언

{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}

InteractiveFile

{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}