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 (number) 오프셋은 플레이어가 광고를 렌더링하기 위해 기다려야 하는 시간(초)을 건너뛰기 버튼을 클릭합니다. 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 파일 '광고 건너뛰기'의 번역을 맞춤 텍스트를 생성합니다.