REST API를 사용하여 비디오 클라우드와 허브 스팟 통합

이 항목에서는 HubSpot과 함께 사용할 캠페인 모듈을 구성하는 방법에 대해 설명합니다.

캠페인 모듈을 사용하면 Video Cloud가 Brightcove Players에서 HubSpot으로 보기 데이터를 동기화할 수 있습니다. HubSpot에서 이 데이터는 세분화, 캠페인 로직, 보고서, 잠재 고객 점수 및 개인 설정 커뮤니케이션에 사용할 수 있습니다.

비디오 클라우드를 HubSpot과 통합하기 위한 두 가지 옵션이 있습니다.

표준(REST API) 방법 사용 - 이 방법을 사용하면 캠페인은 알려진 시청자의 시청 데이터만 추적합니다. 기본적으로 리드 양식은 알 수 없는 시청자에게만 표시됩니다. 이 방법에 대해서는 이 항목에서 다룹니다.
대용량 (클라이언트측API) 메서드 사용 - 이 방법을 사용하면 Campaign에서 모든 시청자의 시청 데이터를 추적합니다. 이러한 유형의통합에 대한 자세한 내용은 클라이언트측 API를 사용하여 HubSpot과 비디오 클라우드 통합을 참조하십시오 .

HubSpot과의 캠페인 모듈 통합은 두 가지 주요 구성 요소로 구성됩니다.

비디오 조회수 데이터 추적을 지원하는 브라이트코브 플레이어 플러그인
비디오 클라우드에서 HubSpot으로 추적 데이터를 전송하는 동기화 프로세스

요구 사항

HubSpot과 함께 캠페인 모듈을 사용하려면 다음을 수행해야 합니다.

허브스팟 계정이 있는 경우
프로페셔널 또는 엔터프라이즈 비디오 클라우드 계정
캠페인 모듈을 열 때 나타나는 초기 스플래시 화면에 필요한 정보를 제출하여 계정에 대해 캠페인 모듈을 활성화하십시오.
모듈을 처음 사용할 때 서비스 계약을 클릭하십시오.
플레이어를 게시 할 때 고급 포함 (페이지 내) 게시 코드를 사용하십시오. 플러그인이 iframe 내부에서 실행되므로 표준 임베드 (iframe) 게시 코드가 작동하지 않으므로 상위 페이지 URL 매개 변수에 액세스 할 수 없으며 올바른 쿠키를 얻지 못할 수 있습니다.

특징

비디오 클라우드 - HubSpot 통합의 주요 기능은 다음과 같습니다.

잠재 고객 양식 - 시청자가 동영상을 볼 때 자동으로 표시되는 HubSpot 양식을 만듭니다. 자세한 내용은 HubSpot용 사용자 지정 리드 양식생성을 참조하십시오 .
데이터 형식 - 보기 데이터는 사용자 지정타임라인 이벤트 유형으로 제공됩니다 . HubSpot에 복제되는 데이터는 다음과 같습니다.
- 비디오 이름
- 비디오 ID
- 계정 ID (비디오 클라우드)
- 페이지 URL (참조 페이지의 URL)
- 플레이어 ID (비디오 클라우드 플레이어)
- 감시률 (25%, 50%, 75%, 95%)
데이터 전송 -보기 데이터는 자동화 된 프로세스를 사용하여 HubSpot으로 전송됩니다. 그러나 HubSpot 플랫폼의 일부 보고서는 새로 고치는 데 다소 시간이 걸릴 수 있습니다.
데이터 보존 - 수집된 데이터는 선택적으로 최대 1개월 동안 Video Cloud에 보존될 수 있습니다.

연결 설정

비디오 클라우드와 HubSpot 간의 연결을 설정하려면 다음 단계를 따르십시오.

비디오 클라우드와 HubSpot 간의 연결 설정

캠페인 모듈을 엽니다.
왼쪽 탐색에서 데이터 연결 을 클릭합니다.
새 연결추가를 클릭합니다 .
선택하다허브스팟통합으로.
참고: 사용 가능한 통합은 Video Cloud 구독을 기반으로 합니다.
(선택 사항) 연결 이름을 입력합니다 .
연결을 클릭합니다 .
표준 (REST API)을 선택한 다음저장을 클릭합니다 .
HubSpot에연결을 클릭합니다 .
HubSpot에 로그인하라는 메시지가 표시됩니다. 이메일주소와비밀번호를 입력합니다 . 로그인을 클릭합니다 .
로그인에 성공하면 계정을 선택하라는 메시지가 표시됩니다. 계정 선택 을 클릭합니다.

이제 HubSpot에 대한 비디오 클라우드 연결이 설정되고 사용할 준비가 되었습니다.

통합 구성

비디오 클라우드와 HubSpot 연결이 완료되면 통합을 구성할 수 있습니다. HubSpot 계정 정보를클릭하면 연결된 HubSpot 계정 정보가 표시됩니다.

기본적으로연결 상태될거야사용 . 연결 상태는 비디오 클라우드 비디오 참여 데이터를 HubSpot으로 전송할지여부를 결정합니다.
- 사용 - 데이터가 수집되어 HubSpot으로 전송됩니다.
- 사용 안 함 - 데이터가 수집되지 않습니다 (통합이 비활성화됨).
기본적으로, 알 수 없는 시청자에 대한 데이터 추적로 설정됩니다장애가 있는 . 이 옵션을 사용하면 알 수 없는 사용자에 대한 데이터가 추적됩니다. 선택한 데이터 보존 정책에 따라 데이터가 보존됩니다. 데이터 보존이 보존없음으로 설정된경우 이 필드는 표시되지 않습니다.
데이터 보존 정책을 선택합니다. 데이터 보존 정책은 보기 데이터 및 리드 양식 데이터(Campaign 리드 양식을 사용하는 경우)가 Video Cloud 계정에 보존되는 기간을 결정합니다. Video Cloud에 데이터를 보관하면 중단된 동기화로부터 복구할 수 있습니다. 또한 캠페인은 이벤트가 데이터 보존 기간을 지날 때까지 동기화에 실패한 이벤트를 계속 재시도합니다(일반적으로 시청자가 비디오를 볼 당시 알려진 연락처가 아니었기 때문). 개인 정보 보호 정책에따라 보존 설정을 조정해야 합니다. Video Cloud에 사용자 데이터를 보존할 필요는 없습니다. 데이터는 데이터 보존 기간이 지나면 삭제됩니다.

HubSpot과의 통합을 제거하려면연결 해제를 클릭합니다 . 캠페인 모듈은 마케팅 플랫폼에 대한 다중 연결을 지원합니다. 새 연결추가를 클릭하여 추가 통합을 구성합니다.

통합 확인

통합이 구성되면 통합을 테스트하여 비디오 보기 데이터가 HubSpot으로 전송되는지 확인합니다. 통합 확인에 대한 자세한 내용은 HubSpot REST API 통합 테스트 가이드를 참조하십시오 .

캠페인 활성화 플레이어 만들기

동영상 참여 데이터는 캠페인 지원 동영상 플레이어를 사용하는 경우에만 HubSpot으로 전송됩니다. 캠페인 활성화 Brightcove 플레이어 생성에 대한 자세한 내용은 캠페인 활성화 플레이어 생성을 참조하십시오.

추적 ID 전달

캠페인 모듈은 추적 ID 값을 HubSpot에 전달하는 기능을 지원합니다. 추적 ID는 캠페인 ID를 추적하는 데 사용할 수 있습니다. 추적 ID는 캠페인 활성화 플레이어를 표시하는 URL에 추가하거나 플레이어 포함 코드에 추가할 수 있습니다.

예: URL에 추가됨

    http://www.myurl.com/video.html?bctrackingid=12345

예: 플레이어 임베드 코드에 추가됨

    <video data-video-id="6033402539001" 
           데이터 계정 = “1486906377” 
           data-player = "기본값" 
           데이터 포함 = “기본값” 
           데이터 애플리케이션 ID 
           클래스="비디오-js”
           데이터 BC 추적 ID="12345" 
           > <컨트롤/비디오 >
    <script src="//players.brightcove.net/1486906377/default_default/index.min.js"></script>

Campaign은 동기화된 다른 필드로 값을 HubSpot에 전달합니다.

시청자 식별

시청자 추적이 수행되도록 하려면 다음 두 가지 방법 중 하나로 뷰어를 추적할 수 있습니다.

URL 매개 변수 - 동영상을 표시하는 페이지의 bcemail URL 매개 변수로 사용자의 이메일 주소를 전달할 수 있습니다. 자세한 내용 및 예는 캠페인 모듈이 뷰어를 식별하는 방법을 참조하십시오.
HubSpot 쿠키 - 플레이어가 로드되면 Campaign은 사용자가 이미 HubSpot에 의해 쿠키되었는지 확인합니다. 그렇다면 Campaign은 쿠키 값을 통해 사용자가 누구인지 알고 있는지 HubSpot에 묻습니다. HubSpot이 연락처를 반환하면 Campaign은 모든 보기 데이터를 해당 사용자와 연결합니다.

한 가지 가능한 시나리오는 추적을 위해 고유하게 생성된 URL로 동영상 랜딩 페이지를 만드는 것입니다. 그런 다음 캠페인 모듈은 URL 매개변수를 사용하여 사용자 서버 측을 조회하고 보기 데이터를 동기화합니다.

플레이어/플러그인이 URL 매개 변수를 읽으려면 고급 임베드 (페이지 내) 게시 코드를 사용해야 합니다. 플러그인이 iframe 내부에서 실행되므로 매개 변수가있는 상위 페이지 URL에 액세스 할 수 없으므로 표준 포함 (iframe) 게시 코드가 작동하지 않습니다.

알 수 없는 시청자에 대한 참고 사항

플레이어가 로드되면 Campaign은 즉시 쿠키 기반 GUID를 통해 뷰어를 조회하려고 시도합니다. 알 수 없는 것으로 표시되면 해당 응답은 최소 일주일 동안 캐시됩니다. 뷰어가 양식을 작성하더라도 캠페인 캐싱 레이어로 인해 페이지를 다시 로드하면 여전히 알 수 없는 뷰어 상태가 반환됩니다.