REST API를 사용하여 비디오 클라우드와 허브 스팟 통합
캠페인 모듈을 사용하면 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 간의 연결 설정
- 캠페인 모듈을 엽니다.
- 왼쪽 탐색에서 데이터 연결 을 클릭합니다.
- 클릭합니다.
- 통합으로HubSpot을선택합니다.
- (선택 사항) 연결 이름을입력합니다.
- 클릭합니다.
- 표준 (REST API) 을 선택한 다음 클릭합니다.
- 클릭합니다.
- 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
- 예: 플레이어 임베드 코드에 추가됨
<비디오 데이터 - 비디오 ID="6033402539001" 데이터 계정 = “1486906377” data-player = "기본값" 데이터 포함 = “기본값” 데이터 애플리케이션 ID 클래스="비디오-js” 데이터 BC 추적 ID="12345" > <컨트롤/비디오 > <스크립트 스크립트 스크립트: “> </” >
Campaign은 동기화된 다른 필드로 값을 HubSpot에 전달합니다.
시청자 식별
시청자 추적이 수행되도록 하려면 다음 두 가지 방법 중 하나로 뷰어를 추적할 수 있습니다.
- URL 매개 변수 - 사용자의 전자 메일 주소를 비디오를 표시하는 페이지의bcemail URL 매개 변수로 전달할 수 있습니다. 자세한 내용 및 예는 캠페인 모듈이 뷰어를 식별하는 방법을 참조하십시오.
- HubSpot 쿠키 - 플레이어가 로드되면 Campaign은 사용자가 이미 HubSpot에 의해 쿠키되었는지 확인합니다. 그렇다면 Campaign은 쿠키 값을 통해 사용자가 누구인지 알고 있는지 HubSpot에 묻습니다. HubSpot이 연락처를 반환하면 Campaign은 모든 보기 데이터를 해당 사용자와 연결합니다.
한 가지 가능한 시나리오는 추적을 위해 고유하게 생성된 URL로 동영상 랜딩 페이지를 만드는 것입니다. 그런 다음 캠페인 모듈은 URL 매개변수를 사용하여 사용자 서버 측을 조회하고 보기 데이터를 동기화합니다.
플레이어/플러그인이 URL 매개 변수를 읽으려면 고급 임베드 (페이지 내) 게시 코드를 사용해야 합니다. 플러그인이 iframe 내부에서 실행되므로 매개 변수가있는 상위 페이지 URL에 액세스 할 수 없으므로 표준 포함 (iframe) 게시 코드가 작동하지 않습니다.
알 수 없는 시청자에 대한 참고 사항
플레이어가 로드되면 Campaign은 즉시 쿠키 기반 GUID를 통해 뷰어를 조회하려고 시도합니다. 알 수 없는 것으로 표시되면 해당 응답은 최소 일주일 동안 캐시됩니다. 뷰어가 양식을 작성하더라도 캠페인 캐싱 레이어로 인해 페이지를 다시 로드하면 여전히 알 수 없는 뷰어 상태가 반환됩니다.