Android 용 기본 SDK에서 Brightcove Analytics 보내기

이 주제에서는 Android용 브라이트코브 SDK를 사용하여 모바일 앱에서 브라이트코브 애널리틱스에서 속성을 설정하는 방법에 대해 알아봅니다.

분석 통합

브라이트코브 플레이어를 사용하고 SDK에catalog포함되어 비디오를 검색하고 재생하는 경우 분석 데이터가 자동으로 수집되어 Video Cloud Analytics 모듈에 표시됩니다.

재정의하면BrightcoveVideoView클래스 또는 Brightcove 플레이어 및 카탈로그를 사용하지 않는 경우 계정 ID를 Video Cloud Analytics로 보내야합니다.

등록 정보 사용자 정의

Android 용 Brightcove Mobile SDK 버전 4.2.7부터는 앱에서 계정 ID, 대상 URI 및 소스 URI에 대한 사용자 지정 값을 Brightcove Analytics로 보낼 수 있습니다.

계정 ID는 필수이지만 브라이트코브 플레이어와 를 사용할 때 자동으로 설정됩니다catalog .

원하는 경우 대상 및 소스 URI를 설정할 수 있습니다. 기본값은 응용 프로그램 패키지 이름을 기반으로 합니다.

이러한 속성은 Android에서 설정할 수 있습니다. MainActivity클래스 파일 :

brightcoveVideoView = (SeamlessVideoView) findViewById(R.id.brightcove_video_view);

Analytics analytics = brightcoveVideoView.getAnalytics();
analytics.setAccount("your accountID");
analytics.setDestination("valid URI");
analytics.setSource("valid URI");

계정

브라이트코브 애널리틱스에서 계정 ID 값을 설정하려면 이account속성을 사용합니다. 이 속성은 비디오의 메타데이터에accountId값이 없는 경우에만 유용합니다 (예: 앱에서accountId속성이 포함된 Video Cloud 비디오와 비 Video Cloud 비디오, accountId속성을 포함하지 않습니다).

예를 들어 다음과 같이 accountId 속성을 설정할 수 있습니다.

brightcoveVideoView.getAnalytics().setAccount("your accountId");

당신이 계정 속성을 설정하면, 이 속성의 값은 아직 속성이없는 비디오에 사용됩니다. accountId 이 속성에 가장 유용한 값은 자신의 계정 ID입니다.브라이트코브 애널리틱스는 현재 브라이트코브 카탈로그 서비스를 통해 검색되지 않는 비디오에 대한 자세한 보고를 지원하지 않으므로 이러한 동영상은 애널리틱스 모듈에서기타/타사로보고됩니다.

Video Cloud 비디오의 경우 동영상의accountId메타데이터 값이 변경되지 않으므로 이 계정 재정의를 설정해도 보고에 영향을 주지 않습니다. 이 계정 값을 설정하여 해당 값을 재정의할 수 없습니다.

대상

destination속성을 사용하여 이벤트를 시작한 위치의 값을 설정합니다. 대상 속성의 값은 다음 예제와 비슷한 적절한 URI 형식이어야 합니다.

bcsdk://com.mhogben.source

대상 속성의 기본값은bcsdk://앱 이름, 패키지 이름이 차례로 표시됩니다.

예를 들어 Android SDK HLS 샘플 앱에서 대상 값은 다음과 같습니다.

bcsdk://HLSSampleApp/com.brightcove.player.samples.hls.basic

인스턴스를 생성하는 앱의 모든 화면brightcoveVideoView이 대상 재정의를 고유 한 값으로 설정하여 앱 자체 내에서 동영상 조회수를 더 잘 추적 할 수 있습니다.

소스

source속성을 사용하여 최종 사용자를 대상 URI로 보낸 URI를 설정합니다. 대상 값과 마찬가지로 source 속성의 값은 다음 예제와 비슷한 적절한 URI 형식이어야 합니다.

bcsdk://com.mhogben.source

소스 속성의 기본값은 null입니다. 값이 null이면 소스 속성이 Analytics 서버로 전송되지 않습니다.

예를 들어 다음과 같이 source 속성을 설정할 수 있습니다.

brightcoveVideoView.getAnalytics().setSource("bcsdk://com.brightcove.HLSPlayerSampleAppSource");

참고: 대상 및 소스 필드에서 사용할 URI 구조에 대한 자세한 내용은URI 스키마 Wikipedia 페이지를 참조하십시오. 이URL 인코더와같은 도구를 사용하여 문자를 UTF-8 인코딩 형식으로 변환할 수 있습니다.

분석보기

Video Cloud Analytics 모듈에서는 계정 수준 또는 비디오와 같은 세부 수준에서 지표 데이터를 볼 수 있습니다. 방법을 알아보려면 다음 문서를 참조하십시오.

참고: Brightcove Analytics는 사용자가 설정한 대상 및 소스 값을 모든 보고서에서 모두 소문자 문자열 값으로 변환합니다.