열린 측정 SDK Datazoom 프리 플레이어 SDKs RAF TheoPlayer MediaTailor SDK

클라이언트 측 광고 추적 통합

이 섹션에서는 MediaTailor 와 다양한 클라이언트 측 광고 추적 서버 간의 통합에 대해 설명합니다.

주제

열린 측정 SDK
Datazoom 프리 플레이어 SDKs
Roku 광고 프레임워크(RAF)
TheoPlayer
MediaTailor SDK

열린 측정 SDK

Interactive Advertising Bureau(IAB) Open MeasurementSDK(OM SDK)는 웹 비디오 및 네이티브 앱 환경에 제공되는 광고에 대한 타사 가시성 및 확인 측정을 용이하게 합니다.

이전 VAST 버전 3 문서의 경우 확장 유형이 인 확장 노드로 확인 코드를 로드해야 합니다AdVerifications. 확장 노드의 루트는 VAST4.1 요소와 스키마가 동일한 AdVerifications 노드입니다.

OM를 더 쉽게 채택할 수 있도록 SDK MediaTailor 는 Datazoom과 협력하여 Open Measurement에 대해 구성되고 확인된 프리 플레이어SDKs를 제공합니다. 자세한 내용은 Datazoom 프리 플레이어 SDKs 단원을 참조하십시오.

참고

MediaTailor 는 현재 VAST 버전 3만 지원합니다.

예 : 버전 VAST 4.1 이전 3의 확인 노드


...
<Extensions>
    <Extension type="AdVerifications">
        <AdVerifications>
            <Verification vendor="company.com-omid">
                <JavaScriptResource apiFramework="omid" browserOptional="true">
                    <![CDATA[https://verification.com/omid_verification.js]]>
                </JavaScriptResource>
                <TrackingEvents>
                    <Tracking event="verificationNotExecuted">
                        <![CDATA[https://verification.com/trackingurl]]>
                    </Tracking>
                </TrackingEvents>
                <VerificationParameters>
                    <![CDATA[verification params key/value pairs]]>
                </VerificationParameters>
            </Verification>
        </AdVerifications>
    </Extension>
</Extensions>

MediaTailor 는 <Extensions> 노드에서 AdVerifications 데이터를 추출하여 클라이언트 측 추적 응답의 adVerifications 배열에 배치합니다.

예 클라이언트 측 추적 응답의 : adVerifications array


{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "3062770",
          "adParameters": "",
          "adProgramDateTime": "2023-08-23T16:25:40.914Z",
          "adSystem": "2.0",
          "adTitle": "AD-polarbear-15",
          "adVerifications": [
            {
              "executableResource": [],
              "javaScriptResource": [
                {
                  "apiFramework": "omid",
                  "browserOptional": "true",
                  "uri": "https://verification.com/omid_verification.js"
                }
              ],
              "trackingEvents": [
                {
                  "event": "verificationNotExecuted",
                  "uri": "https://verification.com/trackingurl"
                }
              ],
              "vendor": "company.com-omid",
              "verificationParameters": "verification params key value pairs"
            }
          ],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>",
              "type": "AdVerifications"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT10.11S",
          "startTimeInSeconds": 10.11,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "3062770",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT10.11S",
              "startTimeInSeconds": 10.11
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "3062770",
      "availProgramDateTime": "2023-08-23T16:25:40.914Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT10.11S",
      "startTimeInSeconds": 10.11
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D",
  "nonLinearAvails": []
}

참고

IAB Tech Lab과 협력하여 애플리케이션이 규정 준수를 보장하기 위해 매년 인증을 받도록 합니다.

OM에 대한 자세한 내용은 IAB Tech Lab 웹 사이트의 Open MeasurementSDK를 SDK참조하세요.

Datazoom 프리 플레이어 SDKs

플레이어를 더 쉽게 채택할 수 있도록 SDKs MediaTailor 는 Datazoom과 협력하여 Google Ad Manager와의 클라이언트 측 AWS Elemental MediaTailor 통합 및 IAB Tech 로 구성 및 테스트SDKs된 무료 플레이어를 제공합니다열린 측정 SDK.

Datazoom 플레이어는 다음 기능을 SDK 지원합니다.

라이브 및 VOD 재생 목록
DASH 및 HLS 사양
Bitmovin, exoplayer, Android 미디어 플레이어, Apple AVPlayer, Brightcove, Chromecast Receiver, Dash.js, hls.js, JWPlayer, Shaka 플레이어, THEO 플레이어, Video.js, Roku 등에 대한 플레이어 공급업체 지원
IAB Tech Lab Open Measurement 인증, 선택한 디바이스에서 사용 가능한 경우
클릭스루 이벤트 처리
광고 카운트다운 타이머, 광고 오버레이 및 비선형 이벤트, 광고 중단 시작, 광고 중단 종료와 같은 광고 이벤트 디스패처
클라이언트 측 광고 비컨
Google 프로그래밍 방식 액세스 라이브러리(PAL) SDK- 선택적 구성 설정

Datazoom은 플레이어가 SDKs 지원하는 유료 분석 및 원격 측정 서비스도 제공합니다. 고객은 Datazoom 관리 콘솔에서 플레이어 SDK 원격 측정을 옵트인하고 제어할 수 있습니다. Datazoom 플레이어에 액세스SDKs하고 부가가치 원격 측정 및 분석 서비스에 대해 자세히 알아보려면 Datazoom 사이트의 연락처 정보를 사용합니다.

Roku 광고 프레임워크(RAF)

Roku Ad Framework(RAF)는 Roku 플랫폼 전체에서 일관된 광고 환경을 유지합니다. 비디오 광고를 포함한 모든 채널은에 대한 Roku의 인증 요구 사항을 충족해야 합니다RAF. 특히 앱은 항상를 통한 클라이언트 측 이벤트 파이어링을 사용해야 합니다RAF.는 서버 측 광고 삽입(SSAI) 공급자 MediaTailor로서 클라이언트 측 이벤트 파이어링을 지원합니다. RAFX SSAI 어댑터는 매SSAI니페스트 서버 또는 스티처 및에 인터페이스를 제공합니다RAF. 이러한 인터페이스에는 다음이 포함됩니다.

masterURL 응답을 구문 분석하고 playURL, AdURL및 광고 메타데이터를 추출합니다.
광고 메타데이터를 MediaTailor SSAI RAF사용 가능한 광고 메타데이터로 변환하고 재생을 RAF 위해를 구성합니다.
스트림 이벤트 및 시간 지정된 메타데이터 관찰.
스트림 이벤트, 광고 메타데이터 및 발사 이벤트 픽셀을 정시에 일치시킵니다.
매니페스트 서버에서 요구하는 AdURL MediaTailor SSAI 대로를 핑/폴링한 다음를 구문 분석하고 재구성합니다RAF.

용 SSAI 어댑터에 대한 자세한 내용은 Roku 웹 사이트의 Roku 어댑터를 사용하여 서버 측 광고 삽입 구현을 RAF참조하세요. https://developer.roku.com/docs/developer-program/advertising/ssai-adapters.md

TheoPlayer

TheoPlayer 와의 통합은 다음을 MediaTailor 수행합니다.

HLS 및 VOD 라이브 워크플로 모두에 DASH 대한 MediaTailor 클라이언트 측 이벤트 추적을 지원하는 기능을 제공합니다.
선형 광고에 대해서만 추적 비컨 전송을 지원합니다.
광고 중에 탐색을 비활성화합니다. 그러나 사용자가 광고 중단 시간을 지나려고 할 때 광고를 재생하기 위한 로직은 없습니다.

SSAI의 TheoPlayer및에 대한 웹, Android, iOS 및 tvOS 검토MediaTailor에 SDKs 대한 자세한 내용은 TheoPlayer 웹 사이트의 섹션을 MediaTailor참조하세요.

MediaTailor SDK

AWS Elemental은 a JavaScript기반 소프트웨어 개발 키트()를 유지 관리합니다SDK. AWS Elemental은 묵시적 보증 없이 있는 SDK 그대로를 제공합니다. 를 참조 데모SDK로 사용하여 온보딩을 로 간소화합니다 MediaTailor. 는 MediaTailor 클라이언트 측 추적과 상호 작용하는 방법을 SDK 보여줍니다API. 는 HTML5기반 플레이어에 대한 클라이언트 측 광고 추적 및 보고를 SDK 구현합니다. 는 MediaTailor 클라이언트 측 보고 세션을 SDK 초기화한 다음 광고 추적 정보를 주기적으로 요청합니다. 재생 중에는 새 광고 이벤트가 감지되면 광고 추적 이벤트를 SDK 내보냅니다.

는 MediaTailor SDK 다음 기능을 지원합니다.

라이브 및 VOD 재생 목록
DASH 및 HLS 사양
클릭스루 이벤트 처리
Ad-event 디스패처
사용자 지정 이벤트 후크
클라이언트 측 광고 비컨. 광고 비컨 전송에 대한 자세한 내용은 섹션을 참조하세요클라이언트측 비코닝.

참고

AWS 지원 티켓을 제출하여 샘플을 JavaScript SDK 받습니다 MediaTailor. 패키지 및 해당 파일에 대한 다운로드 링크를 받게 됩니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

하이브리드 모드

오버레이 광고