라이브 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 객체가 포함됩니다.

개방형 측정

DAI API에는 Open Measurement 인증을 위한 정보가 포함되어 있습니다. Verifications 필드 이 필드에는 하나 이상의 값이 포함됩니다. 실행하는 데 필요한 리소스와 메타데이터가 나열된 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/{pod_id}/profile/{profile_name}/{segment_number}.{segment_format}

경로 매개변수

쿼리 매개변수

각주

1. sd는 초기화 세그먼트에 필요하지 않습니다. ↩
2. 재생 시간이 없는 광고가 포함된 이벤트에는 pd가 필요하지 않습니다. 사용 설정되어 있습니다. ↩

응답 본문

성공한 경우 응답 본문은 다음과 일치하는 재생 가능한 스트림 세그먼트가 됩니다. 형식 및 매개변수가 포함됩니다.

방법: 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의 메타데이터 엔드포인트는 광고를 만드는 데 사용된 정보를 반환합니다. 있습니다. 메타데이터 엔드포인트는 서버 측 비커닝 스트림에 사용할 수 없습니다. 여기서 서버가 광고 미디어 인증을 시작할 책임이 있습니다.

HTTP 요청

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

GET https://{metadata_url}

응답 본문

성공하면 응답은 PodMetadata

메타데이터 파싱

메타데이터에는 tags, ads, 광고 breaks라는 3가지 섹션이 있습니다. 항목 데이터 포인트는 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,
}