Brightcove Player 용 Google 태그 관리자 플러그인

개요

Google의 태그 관리자(GTM)를 사용하면 웹사이트, 동영상 콘텐츠 및 모바일 앱의 사용을 추적할 수 있습니다. 먼저 자산에 컨테이너 태그를 추가합니다. 그런 다음 웹 기반 사용자 인터페이스를 사용하여 비즈니스 규칙에 따라 컨테이너 태그와 연결된 개별 태그를 사용자 지정합니다.

다음은 몇 가지 태그 예입니다.

• Google 애널리틱스 범용 추적 코드
• 애드워즈 리마케팅 및/또는 전환 추적 코드
• 사용자 지정 HTML 스크립트

GTM을 처음 사용하는 경우 Google의 태그 관리자 개요 문서를 검토하세요.

Google 애널리틱스, 애드워즈 및 DoubleClick을 이미 사용하고 있다면 이러한 도구와 잘 통합되는 Google 태그 관리자를 사용할 수도 있습니다. GTM은 다양한 변수 및 트리거 옵션을 제공합니다.

주요 구현 단계

높은 수준에서 GTM을 구현하고 사용하기 위해 따라야 하는 주요 단계는 다음과 같습니다.

1. GTM 계정 생성 및 컨테이너 설정 - 둘 다 초기 GTM 설정의 일부입니다.
2. 웹 페이지에 구현해야 하는 컨테이너 스니펫을 복사하여 붙여넣습니다. Google은 이 코드를 <머리> 태그 또는 개봉 직후 <몸> 꼬리표.
3. 태그 만들기 - Google Analytics 또는 Brightcove Player용
4. 태그를 게시합니다.

설정에 대한 자세한 내용은 Google의 태그 관리자 설정 및 설치 문서를 참조하세요.

작업 Brightcove Player

Brightcove의 GTM 플러그인을 사용하면 Google Analytics 대시보드를 사용하여 Brightcove Player 이벤트를 추적할 수 있습니다. 다음 플레이어 이벤트를 추적할 수 있습니다.

• 플레이어로드
• 비디오 인상
• 비디오보기
• 비디오 참여
• 플레이 요청
• 비디오 완료
• 광고 시작, 광고 종료와 같은 고급 플레이어 이벤트
• 재생 경험을 방해하는 오류

요구 사항

GTM 플러그인을 사용하려면 다음 요구 사항이 필요합니다.

• Brightcove Player v6.46.0 이상

시작하기

Google 태그 관리자를 설정하려면 다음 단계를 따르세요.

단계

1. 에태그 관리자 , 계정을 만들거나 기존 계정을 사용하십시오. 새 계정을 만들려면 계정 만들기 버튼을 클릭합니다.

   기본적으로 새 계정에 대한 새 컨테이너가 생성됩니다. 각 계정 내에 추가 컨테이너를 만들 수 있습니다.

   

2. 계정 이름 및 컨테이너 이름을 포함하여 새 계정 페이지의 값을 입력하고 대상 플랫폼을 선택합니다.

   

3. 만들기단추를 클릭합니다.
4. 서비스 약관에 동의합니다.
5. Google 태그 관리자 설치 대화상자가 나타납니다. 여기에서 스니펫을 복사하여 지정된 위치에 배치해야 합니다.

   

6. 스니펫으로 돌아가야 하는 경우 GTM 대시보드에서 컨테이너 ID를 클릭합니다.

   

이벤트 및 차원 검토

Brightcove Player에서 추적하려는 이벤트 및 차원을 선택하십시오.

이벤트

Brightcove 플레이어 이벤트에서 사용하는 모든analytics-beacon이벤트 이름을 사용할 수 있지만 GTM 플러그인에서는 다음과 같은 항목을 특수 처리합니다.

해상도 및 비트레이트

모든 이벤트(오류 제외)에 대해 다음 차원이 전송됩니다.

이벤트별 차원

이러한 맞춤 측정기준은 특정 이벤트에서 전송됩니다.

변수, 태그 및 트리거 생성

추적하려는 모든 Brightcove 이벤트는 Google 태그 관리자(GTM)에서 이벤트 태그로 생성되어야 합니다. 그러면 GTM의 이벤트 ID가 플레이어 모듈 내에서 사용됩니다. 이를 통해 Brightcove 이벤트 데이터를 GTM 이벤트로 전달할 수 있습니다.

각 이벤트 태그에 대해 이벤트를 Google 애널리틱스로 보내려면 GTM 트리거를 만들어야 합니다. 그런 다음 GTM 변수 탭에서 각 이벤트와 관련된 맞춤 매개변수를 만듭니다.

GTM에 변수 추가

Brightcove 매개 변수는 추가 데이터를 전달하며 이벤트와 함께 전달됩니다. 기록 될 모든 Brightcove 매개 변수는 Google 태그 관리자에서 변수로 생성되어야합니다. 매개변수 이름은 플레이어 내부에서 사용되어 Brightcove 매개변수를 Google 태그 관리자 변수에 전달할 수 있습니다.

Google 태그 관리자에서 변수를 만들려면 다음 단계를 따르세요.

1. Google 태그 관리자 계정에 로그인하십시오.

2. 왼쪽 탐색에서 변수를 클릭합니다.

3. 사용자 정의 변수 섹션에서 새로 만들기 버튼을 클릭합니다.

   

4. 변수 유형 으로 데이터 계층 변수를 선택합니다.

   

5. 구성 세부 정보는 다음과 같습니다.

   • 데이터 영역 변수 이름 -변수 이름
   • 데이터 영역 버전 - 버전 2

6. 먼저 다음과 같이 세 개의 사용자 정의 변수를 만듭니다. 이벤트 작업 , 이벤트 범주 및 이벤트 레이블 . 구성은 이와 유사해야 합니다.

   • 이벤트 액션 - eventAction
   • 이벤트 카테고리 - eventCategory
   • 이벤트 레이블 - eventLabel

   

7. 그런 다음 Brightcove 매개 변수를 반영하는 데 필요한 변수를 만듭니다. 이 경우, 이름은데이터 영역 변수플레이어의 JSON 구성에 있는 내용과 일치해야 합니다. paramsToTrack ~ 후에맞춤 치수 GTM 변수에서. 다음은 예입니다.

   

8. GTM 변수로 생성할 수 있는 Brightcove 매개변수:

   • 계정 - Brightcove 계정 ID
   • 플레이어 -플레이어 ID
   • 선수 이름 - 선수 이름
   • 플랫폼 버전 -플랫폼 버전 번호
   • 세션 -세션 식별자
   • 비디오 -비디오 ID
   • 비디오 이름 -동영상 이름
   • 범위 -StartSecond..EndSecond 형식으로 표시된 초 범위
   • 동영상 조회 시간 (초) -시청 한 초 수
   • 비디오 길이 -동영상 길이 (초)
   • 비디오 조회 율 -비디오 시청 비율
   • 에러 코드 -이벤트와 관련된 플랫폼 별 오류 코드
   • 비디오 마일스톤 -동영상으로 완성 된 마일스톤 (25 %, 50 %, 75 %, 100 %)
   • 비디오 플레이 헤드 -동영상에서 이벤트가 트리거 된 시간
   • 목적지 -이벤트가 발생한 URI

9. 사용자 정의 변수는 GTM에서 다음과 유사해야합니다.

   

GTM에 태그 추가

추적 할 이벤트를 결정한 후 Google 태그 관리자에서 태그를 만들어야합니다.

Google 태그 관리자에서 태그를 만들려면 다음 단계를 따르세요.

1. Google 태그 관리자 계정에 로그인하십시오.

2. 왼쪽 탐색에서 태그를 클릭하고 새로 만들기 버튼을 클릭합니다.

3. 선택태그 유형같이 Google Analytics : 유니버설 애널리틱스 .

   

4. 태그 세부 정보 입력 :

   • 트랙 유형 - 로 설정행사
   • 범주 -이벤트 카테고리 변수
   • 동작 -이벤트 액션 변수
   • 상표 -이벤트 라벨 변수
   • 값 -없음
   • 비 상호 작용 적중 - 로 설정진실
   • Google Analytics 설정 - 기본 설정
   • 추적 ID -GA 대시 보드의 추적 ID. 추적 ID 변수를 선택합니다.

5. 고급 설정으로 이동하여 관련 맞춤 측정 기준 색인 및 측정 기준 값을 설정하세요. 이 지수는 Google 애널리틱스에 있는 것과 일치해야 합니다.

6. 태그는 GTM에서 다음과 유사해야합니다.

   

GTM에 트리거 추가

추적하려는 각 이벤트에 대해 Google 태그 관리자에도 트리거가 필요합니다.

Google 태그 관리자에서 트리거를 만들려면 다음 단계를 따르세요.

1. Google 태그 관리자 계정에 로그인하십시오.

2. 왼쪽 탐색에서 트리거를 클릭하고 새로 만들기 버튼을 클릭합니다.

3. 선택트리거 유형같이맞춤 이벤트 .

   

4. 이벤트 이름을 입력하십시오. 이벤트 이름은 아래 이미지와 유사해야 합니다.

   

5. 추적하려는 각 이벤트에 대한 트리거를 만듭니다.

6. 트리거는 GTM에서 다음과 유사해야합니다.

   

Brightcove와 통합

GTM을 Brightcove Player와 통합하려면 Google 태그 관리자 플러그인을 플레이어에 추가하십시오.

스튜디오 사용

다음 단계에서는 Video Cloud Studio를 사용하여 플러그인을 로드하는 방법에 대해 자세히 설명합니다.

1. 비디오 클라우드 스튜디오에서 플레이어 모듈을 열고 새 플레이어를 만들거나 플러그인을 추가하려는 플레이어를 찾습니다.
2. 플레이어에 대한 링크를 클릭하여 플레이어의 속성을 엽니다.
3. 왼쪽 탐색 메뉴에서플러그인을클릭합니다.

4. 그런 다음 플러그인 추가 버튼을 클릭한 다음 Brightcove 플러그인을 선택합니다.

   

5. 확장 Brightcove 플러그인드롭 다운 및 선택 Google 태그 관리자 .

   

6. 플레이어에게 추적하려는 이벤트 및 맞춤 측정 기준을 알리려면 JSON 개체를 만들어옵션 (JSON)텍스트 상자.

   필드 설명 :

   • tracker -Google 태그 관리자 추적 ID (GTM-XXXXXXX)
   • eventsToTrack -추적하려는 이벤트
   • paramsToTrack -추적하려는 맞춤 측정 기준
   • milestones - 마일스톤을 기본값인 25, 50, 75, 100% 에서 변경하는 정수 배열입니다. 물론 이것은 bcvideo_video_milestone이 추적되고 있을 때만 적용됩니다.

   다음은 예입니다.

    { 
     "tracker":"your Google Tag Manager id", 
     "eventsToTrack": {
       "ad_end": "Ad End",
       "ad_start": "Ad Start",
       "error": "Error",
       "play_request": "Play Request",
       "player_load": "Player Load",
       "video_complete": "Video Complete",
       "video_engagement": "Video Engagement", "video_impression": "Video Impression", "video_view": "Video View"
     },
     "paramsToTrack": {
       "bcvideo_video_duration": "duration",
       "bcvideo_error_code": "error",
       "bcvideo_account": "account",
       "bcvideo_session": "session",
       "bcvideo_video_milestone": "milestone", "bcvideo_video_name": "video_name",
       "bcvideo_range": "range",
       "bcvideo_video_seconds_viewed": "seconds_viewed", "bcvideo_player_name": "player_name",
       "bcvideo_video_percent_viewed": "percent_viewed", "bcvideo_destination": "destination",
       "bcvideo_video_playhead": "playhead"
     }
    
    }

7. 저장버튼을 클릭합니다. 이제 Google 태그 관리자플레이어의 플러그인 목록에 플러그인이 추가되었습니다.

   

8. 플레이어를 게시하려면게시 및 포함 변경 내용 > 게시를선택합니다.
9. 대화 상자를 닫으려면 닫기 를 클릭합니다.

10. MEDIA 모듈로 돌아가서 방금 Google 태그 관리자용으로 업데이트한 플레이어를 사용하여 동영상 또는 재생 목록을 게시합니다.

    플레이어가로드되고 사용자가 플레이어와 상호 작용할 때 지정된 이벤트 및 매개 변수가 추적됩니다.

맞춤 측정 기준 만들기

맞춤 측정 기준은 Google 애널리틱스에서 직접 만드는 측정 항목입니다. 맞춤 측정기준을 추가하는 방법에는 두 가지가 있습니다. 첫 번째는 Google 애널리틱스에서 직접 측정기준을 추가하는 것이고 다른 하나는 Google 스크립트를 사용하는 것입니다.

Google 애널리틱스로 맞춤 측정기준 추가

Google 애널리틱스에서 맞춤 측정기준을 직접 추가하려면 다음 단계를 따르세요.

1. 구글 애널리틱스에로그인합니다.

2. 관리자 를 클릭합니다.

   

3. 클릭맞춤 정의확장하려면 다음을 선택하십시오. 맞춤 측정 기준 .

   

4. 새 맞춤 측정기준 버튼을 클릭합니다.

   

5. 맞춤 측정기준 이름을 입력한 다음 만들기를 클릭합니다. Google Analytics는 색인 번호를 자동으로 할당합니다. 추적하려는 각 매개변수에 대해 맞춤 측정기준을 만들어야 합니다.

   

Google App Script로 맞춤 측정기준 추가

Google App Script를 사용하여 맞춤 측정기준을 만들려면 다음 단계를 따르세요.

1. 맞춤 측정기준을 처음 사용하는 경우 Google의맞춤 측정기준 및 측정항목문서를 검토하세요.
2. Google에 로그인하십시오.

3. 다음으로 이동 G Suite 개발자 허브 Apps Script 새 빈 프로젝트를 선택합니다.

   

4. 고르다제목없는 프로젝트프로젝트 이름을 지정하십시오.

   

5. 다음 사용자 지정 앱 스크립트 코드를 편집기에 복사하고 다음 값을 업데이트합니다.

   • accountId -Google Analytics 계정 ID
   • webPropertyId -Google 계정 추적 ID
   • dimensions -추가 할 맞춤 측정 기준입니다. 현재 목록에는 모든 맞춤 측정 기준이 포함되어 있습니다. 치수 앞에는bcvideo_ . 이는 이러한 변수와 이름 충돌이 없는지 확인하기위한 것입니다.

    //Set values for GA Account ID and web property ID to which you have to set custom dimensions.
    var accountId='your account id'; var webPropertyId='your tracking code'; 
    //Add required custom dimensions to be created to this list 
    var dimensions=['bcvideo_video_seconds_viewed','bcvideo_video_playhead','bcvideo_account','bcvideo_player','bcvideo_player_name','bcvideo_video','bcvideo_video_name','bcvideo_session','bcvideo_platform_version','bcvideo_range','bcvideo_video_duration', 'bcvideo_video_percent_viewed','bcvideo_error_code','bcvideo_milestone','bcvideo_destination']; 
    //Function to create custom dimensions in GA 
    function createGACustomDimensions() {
    //This loop iterates through the custom dimensions in order to set the custom dimension scope, active values into our GA property 
    for(var index=0;index<dimensions.length;index++){ 
     var customDimensions ={
       'name': dimensions[index],
       'scope':'HIT',
       'active':true,
    }
    //This create a request to the new custom dimension Analytics.Management.CustomDimensions.insert(customDimensions,accountId,webPropertyId); 
    // Pause for 1 second between adding each custom dimension, this ensure that the GA property has time 
    // to process the request fully before moving to the next custom dimension.
    Utilities.sleep(1000)
    }
    }

6. 교체function myFunction(){}아래에 표시된대로 사용자 지정 앱 스크립트가있는 코드 블록.

    function myFunction() { }

7. 프로젝트를 저장하십시오. Google Analytics API를 사용하려면 프로젝트를 저장해야합니다.

8. Google Analytics API를 사용하려면 스크립트 편집기에서자원 > 고급 Google 서비스 .

   

9. 그런 다음고급 Google 서비스 , 돌려의 위에 . 확인을 클릭합니다.

   

10. 앱 스크립트를 실행하려면 실행을 클릭합니다. > function 을 실행 하고 스크립트를 선택하십시오.

    

11. 인증 대화 상자에서 권한 검토를 클릭합니다.

    

12. 허용 버튼을 클릭합니다.

    

맞춤 측정 기준보기

Google 애널리틱스에서 맞춤 측정 기준을 보려면 다음 단계를 따르세요.

1. 구글 애널리틱스에로그인합니다.

2. 관리자를 클릭합니다.

   

3. 클릭맞춤 정의확장하려면 다음을 선택하십시오. 맞춤 측정 기준 .

   

4. 관련 색인과 함께 맞춤 측정 기준이 표시되어야합니다.