自訂連結實作指南 custom-link-implementation-guide
自訂視訊追蹤採用 Analytics appMeasurement
中的使用自訂連結程式碼手動追蹤連結。自訂視訊連結視訊追蹤經常用於不太需要視訊測量的平台與裝置上。
- 在 JavaScript 中:
s.tl()
函數 - 在行動應用程式中:trackAction() Android、trackAction() iOS、trackAction() OTT
- 在 Data Insertion API 中:linktype 標記
需求
- 視訊播放器 API 事件與資料的存取權
- 使用 Analytics SDK 時可新增指令碼
- 使用 Data Insertion API 時可新增追蹤信標 (自訂指令碼或硬式編碼)
中繼資料
- 您可以將中繼資料視為連結資料的一部分,新增到任何追蹤呼叫中
- 請記得更新
linkTrackVars
與linkTrackEvents
/* Call on video complete */
if (e.type == "ended") {
s.linkTrackVars = 'events, prop10, eVar10, eVar12, eVar13, eVar15';
s.linkTrackEvents = 'event3';
s.prop10 = mediaName;
s.eVar10 = mediaName;
s.eVar12 = "video";
s.eVar13 = document.title;
s.eVar15 = mediaPlayerName;
s.events = 'event3';
s.tl(this,'o','Video Complete');
};
為什麼要使用自訂連結
- 需滿足最低必要條件
- 適用於任何平台,包括 NoScript 平台
- 所有計算 (如逗留時間或四分位數) 都必須在自訂指令碼中進行
- 簡單明瞭,沒有隱藏的資料庫或指令碼
- 全面掌握視訊資料的各個層面
HTML5 播放器適用的範例 JavaScript
<script type="text/javascript">
myvideo = document.getElementById('movie');
myvideo.addEventListener('play',myHandler,false);
myvideo.addEventListener('seeked',myHandler,false);
myvideo.addEventListener('seeking',myHandler,false);
myvideo.addEventListener('pause',myHandler,false);
myvideo.addEventListener('ended',myHandler,false);
function myHandler(e) {
var video = document.getElementsByTagName('video')[0];
var mediaName="13502979:Sailing";
var mediaLength = video.duration;
var mediaPlayerName = "HTML5 Player";
/*Define video offset*/
if (video.currentTime > 0) {
mediaOffset = Math.floor(video.currentTime);
} else {
mediaOffset = 0;
};
/*Call on video start*/
if (e.type == "play") {
if (mediaOffset == 0) {
console.log(mediaPlayerName +
' -> start -> playhead: ' +
Math.floor(video.currentTime));
s.linkTrackVars='events,prop10,eVar10,eVar12,eVar13,eVar15';
s.linkTrackEvents='event2';
s.prop10=mediaName;
s.eVar10=mediaName;
s.eVar12="video";
s.eVar13=document.title;
s.eVar15=mediaPlayerName;
s.events='event2';
s.tl(this,'o','Video Start');
}
};
/*Call on video pause*/
if (e.type == "pause") {
console.log(mediaPlayerName +' -> pause -> playhead: ' + Math.floor(video.currentTime));
if (video.currentTime != video.duration) {
s.linkTrackVars='events,prop10,eVar10,eVar12,eVar13,eVar15';
s.linkTrackEvents='event7';
s.prop10=mediaName;
s.eVar10=mediaName;
s.eVar12="video";
s.eVar13=document.title;
s.eVar15=mediaPlayerName;
s.events='event7';
s.tl(this,'o','Video Pause');
}
};
/*Call on video complete*/
if (e.type == "ended") {
console.log(mediaPlayerName +
' -> ended -> playhead: ' +
Math.floor(video.currentTime));
s.linkTrackVars = 'events, prop10, eVar10, eVar12, eVar13, eVar15';
s.linkTrackEvents = 'event3';
s.prop10= m ediaName;
s.eVar10=mediaName;
s.eVar12="video";
s.eVar13=document.title;
s.eVar15=mediaPlayerName;
s.events='event3';
s.tl(this,'o','Video Complete');
};
};
</script>
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb