이 가이드에서는 DAI API를 사용하여 건너뛸 수 있는 광고가 포함된 VOD 스트림을 요청하고, Google Ads 요구사항에 따라 건너뛰기 버튼을 렌더링하고, 관련 추적 이벤트를 전송하는 방법을 보여줍니다.
기본 요건
- VOD 스트림의 DAI API 호출을 구현하는 앱 자세한 내용은 DAI VOD 스트림 요청을 참고하세요.
건너뛸 수 있는 광고 요청
건너뛸 수 있는 광고가 포함된 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
DASH 스트림의 URL에서 '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 |
광고 시점 목록입니다.
|
응답 예
{
...
"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초 후에 광고를 건너뛸 수 있음을 알리는 알림을 표시해야 합니다. 알림은 사용자의 언어로 번역되어야 합니다.
건너뛰기 버튼 위치
왼쪽에서 오른쪽으로 읽는 언어의 경우 건너뛰기 버튼을 동영상 플레이어의 오른쪽 하단에 배치합니다. 오른쪽에서 왼쪽으로 읽는 언어의 경우 건너뛰기 버튼을 동영상 플레이어 왼쪽 하단에 배치합니다.
건너뛰기 버튼 크기
버튼과 텍스트는 편안하게 시청하는 환경에서도 명확하게 읽을 수 있을 만큼 커야 합니다.
텍스트 및 아이콘
건너뛰기 버튼에는 텍스트와 아이콘이 모두 있어야 합니다. 다음 Material 아이콘 건너뛰기를 아이콘으로 사용할 수 있습니다.
접근성
사용자는 키보드나 리모컨을 사용하여 건너뛰기 버튼으로 이동할 수 있어야 합니다. 카운트다운이 완료되면 앱이 건너뛰기 버튼에 포커스를 맞춰야 합니다.
다국어 지원
건너뛰기 텍스트를 사용자의 언어로 번역하는 것이 좋습니다.
광고 모음
건너뛰기 버튼을 사용하면 광고 모음의 현재 광고를 건너뛰거나 전체 광고 모음을 건너뛸 수 있습니다.
'광고 건너뛰기' 번역
사용자의 언어에 따라 '광고 건너뛰기' 텍스트를 번역하려면 skipAdTranslations.json 파일을 사용하세요.