# Nielsen DCR
ByteArk Player รองรับการเชื่อมต่อกับระบบ Nielsen DCR (opens new window) เพื่อส่งข้อมูลสถิติการรับชมวิดีโอไปยังระบบของ Nielsen ฟีเจอร์นี้ช่วยให้เว็บไซต์ที่นำ ByteArk Video Player ไปใช้งาน สามารถส่งสถิติการเล่นวิดีโอภายในเว็บไซต์ไปยังระบบ Nielsen ได้ตามมาตรฐาน Digital Content Rating โดยระบบรองรับการส่งสถิติการเล่นอย่างต่อเนื่องตามระยะเวลาที่ผู้ชมเปิดดู รวมไปถึงการส่ง metadata ที่เป็นรายละเอียดของเนื้อหาที่กำลังเล่นตามข้อกำหนดของ Niesen ด้วย โดยมีรายละเอียดในการใช้งานดังต่อไปนี้
# การเปิดใช้งาน ByteArk Nielsen Plugin
- การเปิดใช้งาน ByteArk Nielsen Plugin บน ByteArk Player สามารถทำได้โดยระบุ
plugins.bytearkNielsenในoptionsเมื่อทำการสร้าง video player โดยสามารถตั้งค่าพารามิเตอร์ต่างๆ ตามตาราง options ด้านล่าง
{
fluid: true,
poster: '/assets/samples/player/images/poster-big-buck-bunny.jpg',
sources: [{
title: 'Big Buck Bunny',
src: 'https://byteark-playertzxedwv.stream-playlist.byteark.com/streams/TZyZheqEJUwC/playlist.m3u8',
type: 'application/x-mpegURL'
}],
plugins: {
bytearkNielsen: {
// TODO: add your options here
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
- ระบุ
appidที่ได้จาก Nielsen และตั้งค่าnol_sdkDebug: 'debug'เพื่อแสดง debug log สำหรับการตั้งค่าในครั้งแรก
...
plugins: {
bytearkNielsen: {
apid: 'XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
nol_sdkDebug: 'debug'
}
}
...
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- เพิ่มฟีลด์
nielsenใน sources object เพื่อส่ง metadata object ไปยังระบบของ Nielsen โดยฟีลด์ต่างๆ สามารถอ้างอิงได้จาก เอกสารการตั้งค่า Nielson DCR Content Metadata (opens new window) ทั้งนี้สำหรับการส่งสถิติการชม Live Stream ระบบจะมีการส่งข้อมูลตาม
...
sources: [{
title: 'Big Buck Bunny',
src: 'https://byteark-playertzxedwv.stream-playlist.byteark.com/streams/TZyZheqEJUwC/playlist.m3u8',
type: 'application/x-mpegURL',
videoId: 'QObeO02cMYWl',
poster: '/assets/samples/player/images/poster-big-buck-bunny.jpg',
nielsen: {
type: 'content',
assetid: 'QObeO02cMYWl',
title: 'Big Buck Bunny',
isfullepisode: 'y',
// TODO: add other content metadata
}
}],
...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
- ทดลองเปิดเว็บเพจแล้วเปิด Developer console หากเห็นข้อความลักษณะนี้แปลว่าสามารถติดตั้งได้ถูกต้อง
Nielsen Log: Debug - SDK instance "byteark-player" initialized with globals {"apid":"XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","sfcode":"dcr","nsdkv":600,"nol_sdkDebug":"debug","optout":"false"}
1
- นำ
nol_sdkDebug: 'debug'ออก เมื่อเริ่มใช้งานใน production
# การตั้งค่า
สามารถอ้างอิงพารามิเตอร์ในการตั้งค่าของ Nielsen DCR ได้จาก เอกสารการตั้งค่า Nielson DCR Prerequisites (opens new window)
| Options | Type | Required | Description |
|---|---|---|---|
| apid | String | Yes | apid ที่ได้รับจากทาง Nielsen DCR XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX |
| nol_sdkDebug | String | No | เปิดใช้งาน debug log มีค่าเป็น debug, info, warn, true |
# ตัวอย่าง
<!doctype html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<div id="video-player"></div>
<script src="https://byteark-sdk.cdn.byteark.com/player/v2/byteark-player.min.js"></script>
<script>
var player = bytearkPlayer('video-player', {
fluid: true,
poster: '/assets/samples/player/images/poster-big-buck-bunny.jpg',
sources: [{
title: 'Big Buck Bunny',
src: 'https://byteark-playertzxedwv.stream-playlist.byteark.com/streams/TZyZheqEJUwC/playlist.m3u8',
type: 'application/x-mpegURL',
videoId: 'QObeO02cMYWl',
poster: '/assets/samples/player/images/poster-big-buck-bunny.jpg',
nielsen: {
type: 'content',
assetid: 'QObeO02cMYWl',
program: 'Entertainment Animation',
title: 'Big Buck Bunny',
length: 596,
airdate: '2021-03-21T12:00:00Z',
isfullepisode: 'y',
adloadtype: '1'
}
}],
plugins: {
bytearkNielsen: {
apid: 'XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
nol_sdkDebug: 'debug'
}
}
});
</script>
</body>
</html>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
z