가시성

서문

플레이어의 가시성은 광고 통합 및 플로팅 플레이어와 같은 일부 UI 처리에 근본적으로 중요합니다. 이 맥락에서 우리는 "조회 가능성"을 주어진 순간에 브라우저 뷰포트에 표시되는 플레이어의 비율로 정의합니다. 플레이어의 특정 비율이 뷰포트에 있는 경우 플레이어는 "볼 수 있는" 것으로 간주됩니다.

Brightcove Player 7에는 조회 가능성 추적 DOM 이벤트와 플레이어의 조회 가능한 상태에 따라 달라지는 몇 가지 중요한 동작이 도입되었습니다.

플레이어 구성

플레이어의 조회 가능성 이벤트 및 동작은 플레이어의 JSON 구성에서 구성할 수 있습니다. 모든 구성은 가시성 속성에서 사용할 수 있습니다.

예

조회 가능성을 포함하는 플레이어 구성에 대한 JSON은 다음과 같습니다.

{
  ... other properties ...
  "viewability": {
    "viewability_threshold": 0.3,
    "pause_when_not_viewable": true
  }
}

이 예에서는 사용자가 플레이어를 시야 밖으로 스크롤하여 플레이어의 30% 미만이 브라우저 뷰포트에 표시되면 재생이 일시 중지됩니다. 플레이어가 다시 표시되면 재생이 다시 시작됩니다.

조회가능성 이벤트

사용자는 조회 가능성과 관련된 세 가지 새로운 이벤트에 연결할 수 있습니다.

• viewable-change

  이 이벤트는 플레이어가 볼 수 있는 상태로 전환하거나 볼 수 있는 상태에서 전환할 때 발생합니다.

  부동산	유형	설명
  viewable	부울	플레이어가 볼 수 있는 상태인지 여부를 나타냅니다.
  viewablePercent	번호	현재 뷰포트에 있는 플레이어의 비율을 나타냅니다.

  예

  player.on('viewable-change', (e) => {
    if (e.viewable) {
      player.log('the player is viewable!');
    } else {
      player.log('the player is not viewable!');
    }
  });

  
  

• viewable-percent-change

  이 이벤트는 플레이어의 조회 가능한 비율이 변경될 때 발생합니다.

  부동산	유형	설명
  viewable	부울	플레이어가 볼 수 있는 상태인지 여부를 나타냅니다.
  viewablePercent	번호	현재 뷰포트에 있는 플레이어의 비율을 나타냅니다.

  예

  player.on('viewable-percent-change', (e) => {
    player.log(`the player is ${e.viewablePercent}% viewable!`);
  });

  
  

• viewable-ad-impression

  이 이벤트는 조회 가능한 광고 노출이 측정될 때 실행됩니다. 광고 재생 컨텍스트 외부에서는 실행되지 않습니다.

  즉, 광고가 시작되고 플레이어가 볼 수min_duration_for_viewable_impression있는 시간 (밀리초) 동안 광고가 재생되면 해당 이벤트가 실행됩니다.

  이 이벤트에는 추가 데이터가 전달되지 않습니다.