SSAI(Server-Side Ads) 및 Brightcove Player용 Open Measurement

이 항목에서는 Brightcove Player의 SSAI(Server-Side Ad Insertion) 플러그인과 함께 iab Open Measurement SDK를 사용하는 방법을 알아봅니다.

개요

웹 비디오용 Open Measurement SDK는 videojs-ssai 플러그인과 통합되어 IAB 파트너 및 광고 공급업체 "제3자"가 표준화된 API를 사용하여 크리에이티브 성능 측정 데이터에 액세스할 수 있도록 합니다.

SSAI 플러그인에는 라이브 또는 VOD 콘텐츠 재생 중에 클라이언트 세션 및 OM 광고 수명 주기 이벤트를 관리하기 위해 사용자가 가져온 VAST 광고 확인 데이터 및 OM(Open Measurement) 서비스/클라이언트 스크립트를 사용하는 옵트인 기능 세트가 포함되어 있습니다.

요구 사항

SSAI용 Open Measurement 세션 기능에는 다음이 필요합니다.

  • 조직 이름 공간 등록 및 OM SDK 파일 액세스를 위한 IAB Tech Lab 의 활성 멤버십
  • 다음에 대한 액세스 및 직접 호스트 능력:
    • omweb-v1.js서비스 스크립트
    • omid-session-client-v1.js세션 클라이언트 (IAB에서 제공하는 웹 비디오 OM SDK 파일의 일부)
    • 필요에 따라 도메인 액세스 모드를 사용하는 경우omloader-v1.html도 필요합니다.
  • SSAI 플러그인은 필수 옵션으로 플레이어에서 초기화되어야 합니다.
  • VMAP/VAST XML에는AdVerifications태그와 중첩된 콘텐츠가 포함되어야 합니다.
  • Brightcove Player SSAI 플러그인 v1.14.0 이상
  • Brightcove Player v6.57.2 이상

시작하기

videojs-ssai플러그인에 OM 기능을 활성화하는 것은 일반 SSAI 구현과 거의 동일하며 적극적으로 활용합니다.

OM 기능을 활성화하려면 다음 단계를 따르십시오.

  1. Brightcove Player 문서로 서버 측 광고 구현을 검토하십시오.

  2. SSAI 플러그인을 초기화할 때 다음과 같이 OM 옵션을 설정해야 합니다.

    • SSAI enableOM옵션은 true로 설정해야 합니다.
    • omParams.partnerName조직의 IAB 네임스페이스로 제공되어야 합니다.
    • omParams.partnerName앱 버전으로 제공되어야 합니다.
    • omParams.accessMode선택 사항이지만 아무 것도 지정하지 않은 경우 세션 클라이언트는 기본적으로 제한된 액세스 모드로 설정됩니다.

    자세한 내용은 개방형 측정을 위한 SSAI 옵션 섹션을 참조하십시오.

    이러한 옵션은 다음 중 하나를 사용하여 Brightcove Player 구성을 사용하여 플러그인에 전달할 수 있습니다.

  3. domain액세스 모드를 추가합니다. (선택 과목)

    domain액세스 모드 매개 변수를 사용하면 가져온 OM 서비스 스크립트가 다음 상대 디렉토리 경로에서omloader-v1.html파일을 찾게 됩니다.

    .well-known/omid/omloader-v1.html

    해당 특정 경로에 파일이 없으면 OM 세션 클라이언트가 시작되지 않습니다.

    자세한 내용은 액세스 모드와 관련된 게시자를 위한 IAB 문서를 참조하세요.

Studio를 사용하여 OM 구현

SSAI를 사용하여 Open Measurements에 대해 플레이어를 구성하는 가장 쉬운 방법은 Video Cloud Studio를 사용하는 것입니다. 다음과 같이 플레이어를 구성합니다.

  1. Video Cloud Studio에서 플레이어 모듈로 이동하여 새 플레이어를 생성하거나 플러그인을 추가하려는 플레이어를 찾습니다.
  2. 플레이어에 대한 링크를 클릭하여 플레이어의 속성을 엽니다.
  3. 왼쪽 탐색에서 플러그인 을 클릭합니다.

  4. 플러그인 추가드롭다운에서사용자 정의 플러그인을선택합니다.

    맞춤형 플러그인
  5. 에 대한플러그인 이름시작하다ssai .
  6. 자바 스크립트 URL의 경우 다음을 입력합니다. 
    https://players.brightcove.net/videojs-ssai/1/videojs-ssai.js
  7. CSS URL에 다음을 입력합니다. 
    https://players.brightcove.net/videojs-ssai/1/videojs-ssai.css

  8. 옵션(JSON) 섹션에서 OM 옵션에 대한 값을 추가합니다.

    {
  "enableOM": true,
  "omParams": {
    "partnerName": "IAB Partner Name",
    "partnerVersion": "1.0.0",
    "accessMode": "full"
  }
}
  9. 저장을 클릭합니다.
  10. 플레이어를 게시하려면게시 및 포함 변경 내용 > 게시를클릭합니다.

  11. OM 스크립트를 가져옵니다.

    omweb-v1.js및omid-session-client-v1.js파일은 페이지 DOM의 다른 스크립트 태그보다 먼저 가져와야 합니다. 로컬 또는 CDN을 통해 호스팅할 수 있습니다.

    예

    <script src="./omweb-v1.js"></script>
<script src="./omid-session-client-v1.js"></script>
<script src="./video.core.js"></script>
...

JSON 편집기 사용

또는 Studio의 JSON 편집기를 사용하여 이미 SSAI 플러그인으로 구성된 플레이어에 OM 옵션을 추가할 수 있습니다.

  1. Video Cloud Studio에서 플레이어 모듈로 이동합니다.
  2. 왼쪽 탐색에서 JSON 편집기 를 클릭하십시오.
  3. plugins배열에서 옵션 객체에 OM 옵션을 추가합니다.
    4. "options": {
  "enableOM": true,
  "omParams": {
    "partnerName": "IAB Partner Name",
    "partnerVersion": "1.0.0",
    "accessMode": "full"
  }
}
  4. 저장을 클릭합니다.
  5. 플레이어를 게시하려면게시 및 포함 변경 내용 > 게시를클릭합니다.

  6. OM 스크립트를 가져옵니다.

    omweb-v1.js및omid-session-client-v1.js파일은 페이지 DOM의 다른 스크립트 태그보다 먼저 가져와야 합니다. 로컬 또는 CDN을 통해 호스팅할 수 있습니다.

    예

    <script src="./omweb-v1.js"></script>
<script src="./omid-session-client-v1.js"></script>
<script src="./video.core.js"></script>
...

프로그래밍 방식으로 OM 구현

이전 섹션에 표시된 대로 Video Cloud Studio를 사용하여 플레이어에 OM 기능을 쉽게 추가할 수 있습니다. 프로그래밍 방식으로이 작업을 수행하려면 다음 단계를 따르세요.

  1. Studio에서 미디어 모듈로 이동하고 비디오를 선택합니다.
  2. 상단 메뉴에서 게시 및 퍼가기를 클릭합니다.
  3. 코드 복사 섹션에서 고급 플레이어 포함 코드를 복사합니다.

  4. SSAI 플러그인 및 OM 옵션을 포함하도록 고급 플레이어 포함 코드를 수정합니다.

    <script>
  videojs.getPlayer('myPlayerID').ready(function() {
    var myPlayer = this;
    myPlayer.ssai({
      enableOM: true,
      omParams: {
        partnerName: 'IAB Partner Name',
        partnerVersion: '1.0.0',
        accessMode: 'full'
      });
  });
</script>

  5. OM 스크립트를 가져옵니다.

    omweb-v1.js및omid-session-client-v1.js파일은 페이지 DOM의 다른 스크립트 태그보다 먼저 가져와야 합니다. 로컬 또는 CDN을 통해 호스팅할 수 있습니다.

    예

    <script src="./omweb-v1.js"></script>
<script src="./omid-session-client-v1.js"></script>
<script src="./video.core.js"></script>
...

개방형 측정을 위한 SSAI 옵션

초기화 시 SSAI 플러그인에 옵션을 전달할 수 있습니다. OM 세션을 시작하려면enableOM및omParams옵션이 모두 필요합니다.

enableOM

true (및 필요한 Open Measurement SDK 스크립트를 성공적으로 가져온 경우) 플러그인은omParams개체의 값을 사용하여 OM 관리자를 시작하고 새 OM 세션 클라이언트를 만듭니다.

예

"enableOM": true

omParams

Open Measurement 세션 클라이언트 및 OM 광고/미디어 이벤트 호출을 시작하는 데 필요한 매개변수를 설명하는 개체입니다.

  • omParams.partnerName

    파트너 이름 문자열. 이것은 IAB 파트너십에 따라 조직에 이름이 지정됩니다.

  • omParams.partnerVersion

    semver 형식의 파트너 애플리케이션 버전 문자열입니다.

  • omParams.accessMode

    기본 액세스 모드 문자열입니다. 값:

    • limited
    • domain
    • creative

    • full

    값이 없거나 인식할 수 없는 경우 OM 클라이언트는 기본적으로limited /로 설정됩니다.

예

"omParams": {
  "partnerName": "IAB Partner Name",
  "partnerVersion": "1.0.0",
  "accessMode": "full"
}

플레이어 및 확장 지원

OM (Open Measurement) 관리자는 VAST AdVerifications태그의 데이터를 사용하여 OM 세션 클라이언트를 통해 콘텐츠를 재생하기 전과 도중에 플레이어, 광고 및 미디어 이벤트 정보를 전달합니다.

AdVerifications VAST 3.0을 사용한 태그 지원은 를 통해 제공됩니다Extensions . AdVerifications태그는 VAST 4.0 이상에서InLine요소에 중첩될 것으로 예상됩니다.

광대

VAST/Ad/InLine/Extensions/AdVerifications/...

VAST 4.0+

VAST/Ad/InLine/AdVerifications/...

샘플AdVerifications태그 및 하위 요소

<AdVerifications>
  <Verification vendor="sample-vendor">
    <JavaScriptResource apiFramework="omid" browserOptional="false">
      <![CDATA[vendor-defined-url/omid-script.js]]>
    </JavaScriptResource>
    <VerificationParameters>
      <![CDATA[vendor-defined-content]]>
    </VerificationParameters>
  </Verification>
</AdVerifications>

SSAI OM 관리자는 특히 세션 컨텍스트 정의를 위해 다음 항목에 관심이 있습니다.

  • vendor속성
  • JavascriptResource함유량
  • VerificationParameters함유량

OM 광고 이벤트

OM 관리자는 현재 다음 Brightcove Player 광고 이벤트를 수신하고 중재합니다.

Brightcove Player 이벤트
행사 설명
ads-ad-started 시작
ads-first-quartile 1사분위수
ads-midpoint 중점
ads-third-quartile 3분위
ads-ad-ended 완료
ads-pause 일시 중지
ads-play 재개하다
adwaiting 버퍼 시작
adplaying 버퍼 종료
advolumechange 플레이어 볼륨 변경
ads-ad-skipped 생략

참고

다음 참고 사항은 Open Measurement 통합에 적용됩니다.

  • OM 서비스와 관리자는 모두 VAST 데이터에AdVerifications요소가 포함될 것으로 예상합니다. 인라인 광고에 대한 요소가 없으면 OM 세션 클라이언트가 이를 건너뜁니다.
  • OM 관리자는 광고 노출의 예상 플레이어 정의와 일치하도록 노출 유형을loaded (“통합에서 다운로드 횟수 기준 사용 중”) 으로 설정합니다.
  • IAB는omweb서비스 스크립트 연결을 시도하지 말 것을 권고합니다. 스크립트 태그와 함께 가져와야 합니다.

변경 로그

SSAI 플러그인 릴리스 정보를 참조하십시오.

이전 릴리스 정보는 여기에서 변경 로그를 참조하세요.