이정표 개요 milestone-overview

비디오 지표

변수 유형

설명

콘텐츠

eVar
기본 만료: 방문

(필수) 구현에 지정된 대로 비디오의 이름을 수집합니다.

콘텐츠 유형

eVar
기본 만료: 페이지 보기

방문자가 본 콘텐츠 유형에 대한 데이터를 수집합니다. 비디오 측정에 의해 전송된 히트에 video. 콘텐츠 유형이 할당됩니다.
이 변수는 비디오 추적에 대해서만 예약할 필요가 없습니다. 이와 동일한 변수를 사용하는 다른 콘텐츠 보고서 콘텐츠 유형이 있으면 다른 콘텐츠 유형에 대해 방문자 분포를 분석할 수 있습니다. 예를 들어 이 변수를 사용하여 article 또는 product page와 같은 값을 사용하는 다른 콘텐츠 유형에 태그를 지정할 수 있습니다.
비디오 측정 관점에서 콘텐츠 유형 ​을 사용하면 비디오 방문자를 식별할 수 있고 비디오 전환율을 계산할 수 있습니다.

콘텐츠 체류 시간

이벤트
유형: 카운터

마지막 데이터 컬렉션 처리(이미지 요청) 이후 비디오를 시청하는 데 걸린 시간(초)을 계산합니다.

비디오 시작

이벤트
유형: 카운터

방문자가 비디오를 일정 부분 보았음을 나타냅니다. 그러나 방문자가 비디오에서 본 내용이나 분량에 대한 정보는 제공하지 않습니다.

비디오 완료

이벤트
유형: 카운터

사용자가 비디오 전체를 보았음을 의미합니다. 기본적으로 완료 이벤트는 비디오 종료 1초 전에 측정됩니다.
구현 중에 비디오 종료 몇 초 전을 보기 완료로 고려할 것인지 지정할 수 있습니다. 정의된 끝이 없는 라이브 비디오 및 기타 스트림의 경우 시청한 특정 시간 이후와 같이 사용자 지정 지점을 지정하여 완료를 측정할 수 있습니다.

변수

설명

구문:

s.Media.trackUsingContextData = true;
이 옵션은 통합된 비디오 추적을 활성화합니다. 참으로 설정하면 미디어 모듈은 기존 pev3 대신 미디어 추적을 위한 컨텍스트 데이터를 생성합니다.
Media.contextDataMapping을 사용하여 컨텍스트 데이터를 선택한 eVar와 이벤트에 매핑합니다.
기본값: false

구문:

s.Media.contextDataMapping = {
     "a.media.name":"eVar2, prop2",
     "a.media.segment":"eVar3",
     "a.contentType":"eVar1",
     "a.media.timePlayed":"event3",
     "a.media.view":"event1",
     "a.media.segmentView":"event2",
     "a.media.complete":"event7",
     "a.media.milestones":{
         25:"event4",
         50:"event5",
         75:"event6"
     }
};

비디오 측정에 사용할 eVar와 이벤트에 대한 변수 매핑을 정의하는 개체입니다. 이 개체는 다음 필드에 매핑해야 합니다.

a.media.name: (필수) 변수를 비디오 이름으로 채웁니다. 비디오 이름을 저장하기 위해 선택한 eVar와 비디오 경로 지정에 사용할 사용자 지정 통찰력 비디오 변수(s.prop)를 제공합니다. 쉼표로 구분된 목록으로 값을 제공합니다.

a.media.segment: (선택 사항) 미디어 세그먼트 이름을 저장할 eVar입니다. a.contentType: (선택 사항) 비디오 값을 저장할 eVar로, 비디오 방문 횟수 및 방문자 보고를 생성하기 위해 활성화된 방문 횟수 및 방문자 추적을 포함합니다. 선택한 변수는 문서 슬라이드 쇼 또는 제품 페이지와 같은 데이터를 저장하는 데 이미 사용되었을 수 있습니다.

a.media.view: (필수) 미디어 보기를 카운트할 이벤트입니다.

a.media.segmentView: (선택 사항) 세그먼트 보기를 카운트할 이벤트입니다.

a.media.complete: (선택 사항) 완료 보기를 카운트할 이벤트입니다.

a.media.timePlayed: (선택 사항, 권장) 비디오 재생 시간(초)을 저장할 숫자 이벤트입니다.

a.media.milestones: (선택 사항) s.Media.trackMilestones 이정표를 카운터 이벤트에 매핑하는 개체입니다. 이정표를 정의하는 경우 Media.segmentByMilestones을 true로 설정해야 합니다.

광고 추적 광고를 추적하려면 다음 컨텍스트 데이터 변수를 사용합니다.
a.media.ad.name: (필수) 변수를 광고 이름으로 채웁니다. 광고 이름을 저장하기 위해 선택한 eVar와 경로 지정에 사용할 사용자 지정 통찰력 비디오 변수(s.prop)를 제공합니다. 쉼표로 구분된 목록으로 값을 제공합니다.

a.media.ad.pod: 기본 콘텐츠에서 광고가 재생되는 위치입니다.

a.media.ad.podPosition: Pod 내에서 광고가 재생되는 위치입니다.

a.media.ad.CPM: 이 재생에 적용되는 CPM 또는 암호화된 CPM(앞에 "~"가 붙음)입니다.

a.media.ad.view: a.media.view와 동일하게 작동합니다.

a.media.ad.clicked: 광고 클릭 수를 카운트합니다(Media.click 호출)

a.media.ad.timePlayed: a.media.timePlayed와 동일하게 작동합니다.

a.media.ad.complete: a.media.complete와 동일하게 작동합니다. a.media.ad.segment: a.media.segment와 동일하게 작동합니다.

a.media.ad.segmentView: a.media.segmentView와 동일하게 작동합니다.

a.media.ad.milestones: a.media.milestones와 동일하게 작동합니다.

a.media.ad.offsetMilestones: a.media.offsetMilestones와 동일하게 작동합니다.

구문:

s.Media.trackVars =
   "events, prop2, eVar1, eVar2, eVar3";

비디오 추적 코드에 설정되어 있으며, 쉼표로 구분된 모든 변수의 목록입니다.

구문:

s.Media.trackEvents =
   "event1, event2, event3, event4, event5, event6, event7"

비디오 추적 코드에 설정되어 있으며, 쉼표로 구분된 모든 이벤트의 목록입니다.

변수

설명

구문:

s.Media.autoTrack = true

지원되는 플레이어에 대해 자동 추적을 활성화합니다. 지원되는 플레이어는 다음과 같습니다.

• OSMF(Open Source Media Framework)
• FLVPlayback(Flash Professional에서 비디오 가져오기 마법사로 만든 비디오 플레이어)
• Silverlight
• MediaDisplay
• MediaPlayback
• Brightcove API 버전 2 및 3(Brightcove 참조
• Windows Media Player, Quicktime 또는 Real Player(JavaScript 사용)

위의 플레이어를 사용하지 않는 경우 Media.open Media.play Media.stop Media.close를 사용하여 플레이어 이벤트를 추적할 수 있습니다.

구문:

s.Media.autoTrackNetStreams = true

Flash 10.3에는 NetStream 구성 요소에 향상된 비디오 추적을 활성화하는 새로운 기능이 도입되었습니다. 사용자 지정 Flash NetStream 플레이어를 사용하는 경우 이 변수를 활성화하여 autoTrack과 유사한 기능을 활성화할 수 있습니다. 이 방법을 사용하려면 비디오를 Flash 10.3 이상에서 봐야 합니다.

구문:



s.Media.completeByCloseOffset = true

이 설정을 사용하여 실제 비디오가 종료되기 전에 몇 초 전 비디오 보기 완료를 카운트할 수 있습니다.

이 이벤트는 completeCloseOffsetThreshold에 지정된 초 수를 기반으로 하여 전송됩니다. 이를 통해 오프셋이 비디오 길이와 같다고 보고하지 않는 비디오 플레이어에서 완료를 측정할 수 있습니다.

기본적으로 이 값은 true로 설정되고, 임계값은 1초로 설정됩니다. 이들 기본값을 사용하여 완료 이벤트는 비디오 종료 1초 전에 전송됩니다.

구문:

s.Media.completeCloseOffsetThreshold = 1

이 임계값을 사용하여 실제 비디오가 종료되기 몇 초 전에 비디오 보기 완료를 카운트할 수 있습니다. 이 임계값을 사용하려면 Media.completeByCloseOffset을 true로 설정해야 합니다.

제공한 정수 값은 종료 시 비디오 길이에서 오프셋하고 완료로 카운트할 수 있는 시간(초)을 결정합니다. 이를 통해 오프셋이 비디오 길이와 같다고 보고하지 않는 비디오 플레이어에서 완료를 측정할 수 있습니다.

기본 임계값은 1초입니다.

구문:

s.Media.playerName = "Custom Player Name"

사용자 지정 비디오 플레이어 이름을 지정합니다.

구문:

s.Media.trackSeconds = 15

비디오가 재생되는 동안 비디오 추적 데이터를 Adobe 데이터 컬렉션 서버로 전송하는 간격(초)을 정의합니다. 이 값은 5초 단위로 증가하도록 설정해야 합니다.

Media.trackSeconds를 활성화하면 Media.contextDataMapping에 정의된 이벤트만 트리거합니다. 비디오 측정에 대해 지정된 변수 외에 추가 변수를 전송하려면 Media.monitor를 사용해야 합니다.

비디오 길이 비율로 이정표를 추적합니다.

구문:

s.Media.trackMilestones = "25, 50, 75";

비디오 추적 데이터를 Adobe 데이터 컬렉션 서버로 전송할 간격을 비디오 길이의 비율로 정의합니다. 쉼표로 구분한 정수 목록으로 이정표를 지정합니다. 예: 10 = 10%, 23 = 23%.

이들 이정표는 비디오에서 고정된 지점이므로 방문자가 10% 이정표를 지나서 시청한 경우 10% 이정표를 다시 되감고 지나가면 미디어 모듈이 추적 데이터가 여러 번 전송됩니다. 마찬가지로, 방문자가 이정표를 지나서 빨리 감으면 미디어 모듈이 해당 이정표에 대한 추적 데이터를 전송하지 않습니다.

Media.trackMilestones를 활성화하면 Media.contextDataMapping에 정의된 이벤트만 트리거합니다. 비디오 측정에 대해 지정된 변수 외에 추가 변수를 전송하려면 Media.monitor를 사용해야 합니다.

비디오 시작부터 경과된 시간(초)으로 이정표를 추적합니다.

구문:

s.Media.trackOffsetMilestones = "20, 40, 60";

비디오 추적 데이터를 Adobe 데이터 컬렉션 서버로 전송할 간격을 비디오 시작부터 경과된 시간(초)으로 정의합니다. 쉼표로 구분한 정수 목록으로 이정표를 지정합니다. 예: 20 = 20초, 40 = 40초).

이들 이정표는 비디오에서 고정된 지점이므로 방문자가 20초 이정표를 지나서 본 경우 20초 이정표를 다시 되감고 지나가면 미디어 모듈이 추적 데이터를 여러 번 전송합니다. 마찬가지로, 방문자가 이정표를 지나서 빨리 감으면 미디어 모듈이 해당 이정표에 대한 추적 데이터를 전송하지 않습니다.

Media.trackOffsetMilestones를 활성화하면 Media.contextDataMapping에 정의된 이벤트만 트리거합니다. 비디오 측정에 대해 지정된 변수 외에 추가 변수를 전송하려면 Media.monitor를 사용해야 합니다.

구문:

s.Media.segmentByMilestones = true;

미디어의 길이와 Media.trackMilestones에 지정된 마일스톤을 기반으로 하여 세그먼트 이름, 세그먼트 번호 및 세그먼트 길이 데이터를 자동으로 생성합니다.

마일스톤별 세그먼트화는 autoTrack 사용 시 세그먼트를 정의하는 유일한 방법입니다.

기본값: false

구문:

s.Media.segmentByOffsetMilestones = true;

미디어의 길이와 Media.trackOffsetMilestones에 지정된 마일스톤을 기반으로 하여 세그먼트 이름, 세그먼트 번호 및 세그먼트 길이 데이터를 자동으로 생성합니다.

마일스톤별 세그먼트화는 autoTrack 사용 시 세그먼트를 정의하는 유일한 방법입니다.

기본값: false

변수

설명

구문:

s.Media.adTrackSeconds = 15;

비디오가 재생되는 동안 비디오 광고 추적 데이터를 Adobe 데이터 컬렉션 서버로 전송하는 간격(초)을 정의합니다. 이 값은 5초 단위로 증가하도록 설정해야 합니다.

Media.adTrackSeconds를 활성화하면 Media.contextDataMapping에 정의된 이벤트만 트리거합니다. 비디오 측정에 대해 지정된 변수 외에 추가 변수를 전송하려면 Media.monitor를 사용해야 합니다.

광고 길이 비율로 광고 이정표를 추적합니다.

구문:

s.Media.adTrackMilestones = "25, 50, 75";

광고 추적 데이터를 Adobe 데이터 컬렉션 서버로 전송할 간격을 광고 길이의 비율로 정의합니다. 쉼표로 구분한 정수 목록으로 이정표를 지정합니다. 예: 10 = 10%, 23 = 23%).

이들 이정표는 광고에서 고정된 지점이므로 방문자가 10% 이정표를 지나서 본 경우 10% 이정표를 다시 되감고 지나하면 미디어 모듈이 추적 데이터를 여러 번 전송합니다. 마찬가지로, 방문자가 이정표를 지나서 빨리 감으면 미디어 모듈이 해당 이정표에 대한 추적 데이터를 전송하지 않습니다.

Media.adTrackMilestones를 활성화하면 Media.contextDataMapping에 정의된 이벤트만 트리거합니다. 비디오 측정에 대해 지정된 변수 외에 추가 변수를 전송하려면 Media.monitor를 사용해야 합니다.

광고 시작부터 경과된 시간(초)으로 광고 이정표를 추적합니다.

구문:

s.Media.adTrackOffsetMilestones = "20, 40, 60";

광고 추적 데이터를 Adobe 데이터 컬렉션 서버로 전송할 간격을 광고 시작부터 경과된 시간(초)으로 정의합니다. 쉼표로 구분한 정수 목록으로 이정표를 지정합니다. 예: 20 = 20초, 40 = 40초).

이들 이정표는 광고에서 고정된 지점이므로 방문자가 20초 이정표를 지나서 본 경우 20초 이정표를 다시 되감고 지나하면 미디어 모듈이 추적 데이터를 여러 번 전송합니다. 마찬가지로, 방문자가 이정표를 지나서 빨리 감으면 미디어 모듈이 해당 이정표에 대한 추적 데이터를 전송하지 않습니다.

Media.adTrackOffsetMilestones를 활성화하면 Media.contextDataMapping에 정의된 이벤트만 트리거합니다. 비디오 측정에 대해 지정된 변수 외에 추가 변수를 전송하려면 Media.monitor를 사용해야 합니다.

구문:

s.Media.adSegmentByMilestones = true;

미디어의 길이와 Media.adTrackMilestones에 지정된 마일스톤을 기반으로 하여 세그먼트 이름, 세그먼트 번호 및 세그먼트 길이 데이터를 자동으로 생성합니다.

마일스톤별 세그먼트화는 autoTrack 사용 시 세그먼트를 정의하는 유일한 방법입니다.

기본값: false

구문:

s.Media.adSegmentByOffsetMilestones = true;

미디어의 길이와 Media.adTrackOffsetMilestones에 지정된 마일스톤을 기반으로 하여 세그먼트 이름, 세그먼트 번호 및 세그먼트 길이 데이터를 자동으로 생성합니다.

마일스톤별 세그먼트화는 autoTrack 사용 시 세그먼트를 정의하는 유일한 방법입니다.

기본값: false

메서드

설명

구문:

s.Media.open(mediaName, mediaLength, mediaPlayerName)

비디오 추적 데이터를 수집하도록 미디어 모듈을 준비합니다. 이 메서드는 다음 매개 변수를 사용합니다.

• mediaName: (필수) 비디오 보고서에 나타낼 비디오 이름입니다.
• mediaLength: (필수) 비디오 길이(초)입니다.
• mediaPlayerName: (필수) 비디오를 보는 데 사용되는 미디어 플레이어의 이름으로 비디오 보고서에 나타나도록 할 이름입니다.

구문:

s.Media.openAd(name, length, playerName, parentName,
   parentPod, parentPodPosition, CPM)

광고 추적 데이터를 수집하도록 미디어 모듈을 준비합니다. 이 메서드는 다음 매개 변수를 사용합니다.

• name: (필수) 광고 이름 또는 ID입니다.
• length: (필수) 광고 길이입니다.
• playerName: (필수) 광고를 보는 데 사용되는 미디어 플레이어의 이름입니다.
• parentName: 광고가 포함된 기본 콘텐츠의 이름 또는 ID입니다.
• parentPod: 기본 콘텐츠에서 광고가 재생되는 위치입니다.
• parentPodPosition: Pod 내에서 광고가 재생되는 위치입니다.
• CPM: 이 재생에 적용되는 CPM 또는 암호화된 CPM(앞에 "~"가 붙음)입니다.

구문:

s.Media.click(name, offset)

비디오에서 광고를 클릭할 때 추적합니다. 이 메서드는 다음 매개 변수를 사용합니다.

• name: 광고 이름입니다. 이 이름은 Media.openAd에 사용된 이름과 일치해야 합니다.
• offset: 클릭이 발생했을 때 광고에 대한 오프셋입니다.

구문:

s.Media.close(mediaName)

비디오 데이터 컬렉션을 종료하고 정보를 Adobe 데이터 컬렉션 서버로 전송합니다. 비디오 종료 시 이 메서드를 호출합니다. 이 메서드는 다음 매개 변수를 사용합니다.

mediaName: 비디오 이름입니다. 이 이름은 Media.open에 사용된 이름과 일치해야 합니다.

구문:

s.Media.complete(name, offset)

이 메서드는 완료 이벤트를 수동으로 추적합니다. 이 메서드는 Media.completeByCloseOffset을 사용하여 처리할 수 없는 특수한 논리를 사용하여 이벤트를 트리거해야 하는 경우에 사용됩니다.

예를 들어 정의된 끝이 없는 라이브 스트림을 측정하는 경우 사용자가 X초 동안 라이브 스트림을 시청한 후 완료를 트리거할 수 있습니다. 콘텐츠의 길이 및 유형을 기반으로 한 퍼센트 계산을 사용하여 완료를 측정할 수 있습니다. 이 메서드는 다음 매개 변수를 사용합니다.

• mediaName: 비디오 이름입니다. 이 이름은 Media.open에 사용된 이름과 일치해야 합니다.
• mediaOffset: 비디오에 완료 이벤트를 전송해야 하는 시간(초 수)입니다. 두 번째 0에서 시작하는 비디오를 기반으로 하여 오프셋을 지정합니다.
  
  미디어 플레이어가 밀리초를 사용하여 추적하는 경우 Media.complete를 호출하기 전에 값이 초로 변환되었는지 확인하십시오.

수동으로 전체 호출을 하려면

을 설정합니다. s.Media.completeByCloseOffset = false를 참조하십시오.

구문:

s.Media.play(name, offset, segmentNum, segment, segmentLength)

비디오가 재생을 시작할 때 언제든지 이 메서드를 호출합니다. 수동 비디오 측정 사용 시 비디오 측정 데이터를 전송할 때 현재 세그먼트 데이터를 제공할 수 있습니다.

어떤 이유로든 플레이어가 한 세그먼트에서 다른 세그먼트로 변경되면 Media.stop Media.play를 호출해야 합니다.

이 메서드는 다음 매개 변수를 사용합니다.

mediaName: 비디오 이름입니다. 이 이름은 Media.open에 사용된 이름과 일치해야 합니다.

mediaOffset: 비디오에 재생이 시작되는 초 수입니다. 두 번째 0에서 시작하는 비디오를 기반으로 하여 오프셋을 지정합니다. 미디어 플레이어가 밀리초를 사용하여 추적하는 경우 Media.play를 호출하기 전에 값이 초로 변환되었는지 확인하십시오.

segmentNum: (선택 사항) 마케팅 보고서에서 보고서에 세그먼트 표시 순서를 지정하는 데 사용하는 현재 세그먼트 번호입니다. segmentNum 매개 변수는 0보다 커야 합니다.

segment: (선택 사항) 현재 세그먼트 이름입니다.

segmentLength: (선택 사항)

현재 세그먼트 길이(초)입니다.

예:

s.Media.play("My Video", 1800, 2,"Second Quarter", 1800)

s.Media.play("My Video", 0, 1,"Preroll", 30)

구문:

s.Media.stop(mediaName, mediaOffset)

지정된 비디오에 대한 중지 이벤트(중지, 일시 정지 등)를 추적합니다. 이 메서드는 다음 매개 변수를 사용합니다.

• mediaName: 비디오 이름입니다. 이 이름은 Media.open에 사용된 이름과 일치해야 합니다.
• mediaOffset: 비디오에 중지 또는 일시 중지 이벤트가 발생하는 초 수입니다. 두 번째 0에서 시작하는 비디오를 기반으로 하여 오프셋을 지정합니다.

구문:

s.Media.monitor(s, media)

Silverlight 구문:

s.Media.monitor =
   new AppMeasurement_Media_Monitor(myMediaMonitor);

Silverlight 앱 미디어 모니터는 Objective-C 위임 디자인 패턴을 구현합니다. myMediaMonitor 클래스 메서드는 s 및 media 매개 변수를 사용합니다.

이 메서드를 사용하여 추가 비디오 지표를 전송합니다. 추가 변수(Prop, eVar, Event)를 설정하고, 재생 중인 비디오의 현재 상태에 따라 Media.track을 사용하여 전송할 수 있습니다.

Media.monitor를 사용하여 추가 지표 측정을 참조하십시오.

이 메서드는 다음 매개 변수를 사용합니다.

s: AppMeasurement 인스턴스(또는 JavaScript s 개체)입니다.

media: 구성원이 비디오의 상태를 제공하는 개체입니다. 이들 구성원은 다음과 같습니다.

• media.name: 비디오의 이름입니다. 이 이름은 Media.open에 사용된 이름과 일치해야 합니다.
• media.length: Media.open 호출에 제공된 비디오의 길이(초)입니다.
• media.playerName: Media.open 호출에 제공된 미디어 플레이어의 이름입니다.
• media.openTime: Media.open이 호출되는 시기에 대한 데이터가 포함된 NSDate 개체입니다.
• media.offset: 비디오의 현재 오프셋(초)(비디오의 실제 지점)입니다. 오프셋은 0에서 시작합니다(비디오의 시작 초는 0초임);
• media.percent: 비디오 길이 및 현재 오프셋을 기반으로 한, 재생된 비디오의 현재 비율입니다.;
• media.timePlayed: 지금까지 재생된 총 시간(초 수)입니다;
• media.eventFirstTime: 이 비디오에 대해 이 미디어 이벤트가 처음 호출되었는지를 나타냅니다;
• media.mediaEvent: 모니터 호출을 발생시킨 이벤트 이름이 들어 있는 문자열입니다.

media.mediaEvent events:

• OPEN: Media.autoTrack를 통해 또는 Media.play 호출을 통해 재생이 처음 관찰되는 때입니다.
• CLOSE: Media.autoTrack을 통해 또는 Media.close 호출을 통해 비디오 완료 시 재생이 종료되는 때입니다.
• PLAY: Media.autoTrack을 통해 또는 Media.play 재호출을 통해 일시 중지되었거나 스크러빙된 후 재생이 다시 시작되는 때입니다.
• STOP: Media.autoTrack을 통해 또는 Media.stop 호출을 통해 스크러빙 시작의 일시 중지로 재생이 중지되는 경우입니다.
• MONITOR: 자동 모니터링에서 비디오가 재생되는 동안 비디오의 상태를 확인하는 때(매 초)입니다.
• SECONDS: Media.trackSeconds 변수에 정의된 간격(초)입니다.
• MILESTONE: Media.trackMilestones 변수에 의해 정의된 이정표입니다.

구문:

s.Media.track(mediaName)

정의한 Media.trackVars 및 Media.trackEvents와 함께 현재 비디오 상태를 즉시 전송합니다. 이 메서드는 Media.monitor 내에서 사용됩니다.

Media.monitor를 사용하여 추가 지표 측정을 참조하십시오.

이 메서드가 호출되기 전에 비디오에서 Media.open 및 Media.play를 호출합니다. 이 메서드는 다음 매개 변수를 사용합니다.

• mediaName: 비디오 이름입니다. 이 이름은 Media.open에 사용된 이름과 일치해야 합니다.

이 메서드는 비디오가 재생되는 동안 추가적인 변수를 유일한 방법입니다. 이 메서드는 초 간격 및 비율 이정표 카운터를 0으로 재설정하여 여러 추적 히트를 방지합니다.