VOD 스트림 건너뛸 수 있는 광고

이 가이드에서는 DAI API를 사용하여 건너뛸 수 있는 광고가 포함된 VOD 스트림을 요청하고, Google Ads 요구사항에 따라 건너뛰기 버튼을 렌더링하고, 연결된 추적 이벤트를 전송하는 방법을 보여줍니다.

기본 요건

건너뛸 수 있는 광고 요청하기

건너뛸 수 있는 광고가 포함된 VOD 스트림을 요청하려면 스트림 요청에 dai-sas 매개변수를 전달해야 합니다.

API 엔드포인트

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

경로 매개변수

{CMS_ID} 스트림의 CMS ID입니다.
{VIDEO_ID} 스트림의 동영상 ID입니다.

본문 매개변수

dai-sas 건너뛸 수 있는 광고를 사용 설정하려면 dai-sas=1을(를) 설정하세요.

예시 요청 (cURL)

HLS 스트림 요청의 경우:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

URL에서 'dash'를 DASH 스트림으로 대체합니다.

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

요청 본문에 여러 스트림 매개변수를 포함하려면 다음 형식을 사용합니다.

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

광고 건너뛰기 처리

광고 건너뛰기를 처리하려면 현재 광고를 건너뛰는지 아니면 전체 광고 시점을 건너뛰는지에 따라 Ad 구조체 또는 AdBreak 구조체의 정보를 사용합니다. start 값을 사용하고 duration 값을 추가한 후 스트림에서 해당 지점을 찾습니다. SkipMetadata 하위 메시지에는 광고를 건너뛸 수 있게 되기 전 경과 시간(초)인 offset 값도 포함됩니다. SkipMetadata 하위 메시지는 건너뛸 수 있는 광고에만 포함됩니다.

ad_breaks 광고 시점 목록입니다.
start (숫자) 스트림에서 브레이크가 시작되는 위치(초)입니다.
duration (숫자) 광고 시점의 길이(초)입니다.
ads (object(Ad)) 스트림의 광고 목록입니다.
start (숫자) 스트림에서 광고가 시작되는 위치(초)입니다.
duration (숫자) 광고의 재생 시간(초)입니다.
skip_metadata (object(SkipMetadata)) 건너뛸 수 있는 광고를 위한 선택적 메타데이터입니다. 설정된 경우 광고를 건너뛸 수 있음을 나타내며 건너뛰기 UI 및 추적 이벤트를 처리하는 방법에 관한 안내를 포함합니다.
offset (숫자) 오프셋은 플레이어가 건너뛰기 버튼을 렌더링하기 위해 기다려야 하는 광고 재생 시간(초)을 나타냅니다. VAST에서 제공되지 않으면 생략됩니다.
tracking_url (문자열) 건너뛰기 이벤트에서 핑해야 하는 URL입니다.

응답 예

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

광고를 건너뛰면 스트림 응답에 포함된 이벤트 건너뛰기 URL을 핑합니다. SkipMetadata 하위 메시지에 포함되어 있습니다.

건너뛰기 버튼 요구사항

건너뛸 수 있는 광고의 경우 다음 디자인 요구사항에 따라 건너뛰기 버튼을 렌더링합니다. 이러한 요구사항을 준수하지 않으면 사이트 또는 앱에 게재되는 Google 광고에 제한이 적용될 수 있습니다.

카운트다운 타이머

VAST에 지정된 skipoffset 시간 전에는 광고를 건너뛸 수 없어야 합니다. 건너뛸 수 없는 기간에는 X초 후에 광고를 건너뛸 수 있음을 알리는 알림을 사용자에게 표시해야 합니다. 알림은 사용자의 언어로 번역되어야 합니다.

건너뛰기 버튼 위치

왼쪽에서 오른쪽으로 읽는 언어의 경우 건너뛰기 버튼을 동영상 플레이어의 오른쪽 하단에 배치합니다. 오른쪽에서 왼쪽으로 읽는 언어의 경우 건너뛰기 버튼을 동영상 플레이어 왼쪽 하단에 배치하세요.

건너뛰기 버튼 크기

버튼과 텍스트는 편안한 환경에서 명확하게 읽을 수 있을 만큼 커야 합니다.

텍스트 및 아이콘

건너뛰기 버튼에는 텍스트와 아이콘이 모두 있어야 합니다. 다음 머티리얼 건너뛰기 아이콘을 아이콘으로 사용할 수 있습니다.

접근성

사용자가 키보드나 리모컨을 사용하여 건너뛰기 버튼으로 이동할 수 있어야 합니다. 카운트다운이 완료되면 앱은 건너뛰기 버튼에 포커스를 두어야 합니다.

다국어 지원

건너뛰기 텍스트는 사용자의 언어로 번역하는 것이 좋습니다.

광고 모음

건너뛰기 버튼은 광고 모음에 있는 현재 광고를 건너뛰거나 전체 광고 모음을 건너뛰는 데 사용할 수 있습니다.

'광고 건너뛰기' 번역

사용자의 언어에 따라 '광고 건너뛰기' 텍스트를 번역하려면 skipAdTranslations.json 파일을 사용하세요.