개방형 측정 SDK RAF TheoPlayer MediaTailor SDK

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

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

주제

개방형 측정 소프트웨어 개발 키트 () SDK
Roku 광고 프레임워크 () RAF
TheoPlayer
MediaTailor 소프트웨어 개발 키트 () SDK

개방형 측정 소프트웨어 개발 키트 () SDK

대화형 광고국 (IAB) Open Measurement, OM SDK (Open MeasurementSDK) 은 웹 비디오 및 네이티브 앱 환경에 제공되는 광고에 대한 타사 가시성 및 검증 측정을 용이하게 합니다.

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

참고

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

예 : 버전 VAST 3.1의 검증 노드, 버전 4.1 이전


...
<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 측 추적 응답의 배열


{
  "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기술 연구소와 협력하여 규정 준수를 보장하기 위해 매년 애플리케이션이 인증되는지 확인하십시오.

SDKOM에 대한 자세한 내용은 IAB Tech Lab 웹 사이트의 공개 측정을 SDK 참조하십시오.

Roku 광고 프레임워크 () RAF

Roku 광고 프레임워크 (RAF) 는 Roku 플랫폼 전반에 걸쳐 일관된 광고 경험을 유지합니다. 동영상 광고를 포함한 모든 채널은 Roku의 인증 요건을 충족해야 합니다. RAF 특히 앱은 항상 클라이언트측 이벤트 실행을 사용해야 합니다. RAF MediaTailor는 서버측 광고 삽입 (SSAI) 제공업체로서 클라이언트측 이벤트 발생을 지원합니다. RAFXSSAI어댑터는 SSAI 매니페스트 서버 또는 스티처 모두에 인터페이스를 제공합니다. RAF 이러한 인터페이스에는 다음이 포함됩니다.

masterURL응답 파싱 및 추출 playURLAdURL, 광고 메타데이터
광고 메타데이터를 RAF 사용 가능한 MediaTailor SSAI 광고 메타데이터로 변환하고 재생되도록 구성합니다. RAF
스트림 이벤트 및 시간이 정해진 메타데이터 관찰.
스트림 이벤트, 광고 메타데이터, 발사 이벤트 픽셀을 적시에 매칭합니다.
MediaTailor SSAI매니페스트 서버의 필요에 따라 ping/폴링을 수행한 다음 파싱하고 재구성합니다. AdURL RAF

의 SSAI 어댑터에 대한 자세한 내용은 Roku 웹 사이트에서 RAF Roku 어댑터를 사용한 서버 측 광고 삽입 구현을 참조하십시오.

TheoPlayer

TheoPlayer 와의 MediaTailor 통합은 다음과 같은 작업을 수행합니다.

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

SSAIin에 대한 자세한 내용과 웹 TheoPlayer, Android, iOS 및 MediaTailortvOS에 SDKs 대한 MediaTailor 리뷰를 보려면 TheoPlayer 웹 사이트를 참조하십시오.

MediaTailor 소프트웨어 개발 키트 () SDK

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

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

라이브 및 VOD 플레이리스트
DASH및 사양 HLS
클릭스루 이벤트 처리
광고 이벤트 디스패처
커스텀 이벤트 후크
클라이언트측 광고 비코닝. 광고 비콘 전송에 대한 자세한 내용은 을 참조하십시오. 클라이언트측 비코닝

참고

제출하기 AWS 샘플을 받을 수 있는 Support JavaScript SDK MediaTailor 티켓입니다. 패키지 및 해당 파일의 다운로드 링크를 받게 됩니다.

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

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

문서 규칙

하이브리드 모드

동적 광고 변수 사용