集成

丰富与限制

丰富和定制媒体数据跟踪

在本指南中，我们将学习如何自定义跟踪视频和音频媒体内容(例如如何自定义视频标题和视频url)，以及如何指定应该跟踪或忽略哪些视频和音频。

设置视频和音频标题

在Matomo(以前的Piwik)中分析媒体报告时，媒体标题通常比媒体HTTP url(可能只包含随机数字和字母)更有用。YouTube和Vimeo播放器让我们自动检索视频标题，因此您的视频报告直接显示原始视频标题。如果你使用HTML5视频或音频，或者你希望在分析报告中定制视频标题，请继续阅读。媒体分析将通过搜索以下信息来检测媒体标题:

  • 首先,data-matomo-titleHTML属性。
  • 接下来,data-piwik-titleHTML属性。
  • 来自YouTube / Vimeo播放器的媒体标题。
  • 标题HTML属性。
  • 最后,altHTML属性。

标题将在此优先级中检测，这意味着您可以设置data-matomo-title(推荐)或adata-piwik-title属性覆盖YouTube或Vimeo视频标题。一个data-matomo-title始终具有最高优先级，并覆盖从媒体播放器接收的任何标题。

 .

在上面的例子中，你在Matomo中的视频分析报告将显示“我的自定义视频标题”作为媒体标题。如果无法检测到视频标题(取决于您的媒体播放器)，并且没有设置这些HTML属性，那么标题将显示为“未知”。

JW球员

如果你想跟踪一个与你的视频标题不同的自定义标题，你可以通过在设置方法中指定一个播放列表项来提供一个只用于跟踪目的的自定义标题:

playerInstance。setup({playlist: [{file: "https://example.org/actualUrl.mp4"， title: "My Video"， matomoTitle: "My custom Video title"}});

而不是matomoTitle属性(推荐)也可以使用piwikTitle．

Flowplayer

在使用flowplayer进行跟踪时，可以指定一个自定义标题matomoTitle或piwikTitle属性:

flowplayer("#player"，{剪辑:{来源:[{类型:"application/x-mpegurl"， src: "https://example.org/actualUrl.m3u8"}，{类型:"video/mp4"， src: "https://example.org/actualUrl.mp4"}]， title: "Javascript设置"，matomoTitle: "我的自定义视频标题"}});

如果您使用视频元素，您可以设置data-matomo-title属性直接添加到视频元素上，如上所述。

覆盖正在跟踪的视频/音频资源URL

默认情况下，媒体的HTTP URL从播放器API获取或在DOM中读取。在某些情况下，您可能希望跟亚博技术支持 专业的彩票系统平台踪自定义资源URL而不是实际资源。例如，当您的媒体url包含唯一的id，而您在分析Matomo报告时希望使用更可读的url。方法定义自定义资源data-matomo-resource(推荐)或data-piwik-resourceHTML属性。例如:

JW球员

例如，如果你的资源URL依赖于用户，并且你总是想跟踪相同的资源，你可以通过在setup方法中指定播放列表项来提供一个自定义资源，就像这样:

playerInstance。设置({播放列表:[{文件:"https://example.org/actualUrl.mp4"，标题:"My Video"， matomoResource: "https://example.org/trackedUrl.mp4"}});

而不是matomoResource属性(推荐)也可以使用piwikResource．

Flowplayer

使用flowplayer时，可以指定一个自定义资源URLmatomoResource或者一个piwikResource属性:

flowplayer("#player"，{剪辑:{来源:[{类型:"应用程序/x-mpegurl"， src: "https://example.org/actualUrl.m3u8"}，{类型:"视频/mp4"， src: "https://example.org/actualUrl.mp4"}]，标题:"Javascript设置"，matomoResource: "https://example.org/trackedUrl"}});

如果您使用视频元素，您可以设置data-matomo-resource(推荐)或data-piwik-resource属性直接添加到视频元素上，如上所述。

限制跟踪哪些媒体数据

排除特定媒体的跟踪

默认情况下，所有检测到的视频和音频都会被跟踪。为防止跟踪特定媒体，同时跟踪其他媒体，您可以设置data-matomo-ignore(推荐)或adata-piwik-ignore属性上的< >视频或<音频>元素来忽略它。例如:

<视频data-matomo-ignore >…