设置适用于 Chromecast 的 Mobile SDK v3.x set-up-chromecast

Last update: Thu Jun 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

用户
管理员
开发人员

此部分介绍为流媒体收集加载项设置Chromecast安装的先决条件。

先决条件

获取有效的配置参数

在设置 Media Analytics 帐户后，这些参数可以从 Adobe 代表获取。
在媒体播放器中包含以下 API
- 用于订阅播放器事件的 API – Media SDK 要求在播放器中发生事件时调用一组简单的 API。
- 提供播放器信息的 API - 此信息包括媒体名称和播放头位置等详细信息。

Adobe Mobile Services 提供了新的 UI，以将 Adobe Marketing Cloud 中针对移动设备应用程序的移动营销功能整合到一起。最初，移动服务可无缝集成 Adobe Analytics 和 Adobe Target 解决方案的应用程序分析和定位功能。请参阅 Adobe Mobile Services 文档，以了解更多信息。

适用于 Experience Cloud 解决方案的 Adobe Mobile Library for Chromecast v3.x 让您能够测量使用 JavaScript 编写的 Chromecast 应用程序，通过受众管理收集并利用受众数据，以及测量视频参与。

移动设备库/SDK 实施

将下载的 Chromecast 库添加到您的项目中。

AdobeMobileLibrary-Chromecast-[version] zip 文件包含以下软件组件：
- adbmobile-chromecast.min.js：
  
  此库文件将包含在您的 Chromecast 应用程序源文件夹中。
- ADBMobileConfig 配置
  
  这是为您的应用程序自定义的 SDK 配置文件。随 SDK 提供了一个 ADBMobileConfig 实施示例（在 samples/ 下）。请从 Adobe 代表处获取正确的设置。

将库文件添加到 index.html 文件中，并按照以下方式创建 ADBMobileConfig 全局变量（用于配置 Adobe Mobile for Media Analytics 的全局变量具有一个名为 mediaHeartbeat 的排他键）：

code language-js

code language-js
<script> var ADBMobileConfig = { "marketingCloud": { "org": "972C898555E9F7BC7F000101@AdobeOrg" }, "target": { "clientCode": "", "timeout": 5 }, "audienceManager": { "server": "obumobile5.demdex.net" }, "analytics": { "rsids": "example.sample.player", "server": "example.sc.omtrc.net", "ssl": true, "offlineEnabled": false, "charset": "UTF-8", "lifecycleTimeout": 300, "privacyDefault": "optedin", "batchLimit": 0, "timezone": "MDT", "timezoneOffset": -360, "referrerTimeout": 0, "poi": [] }, "mediaHeartbeat": { "server": "example.hb-api.omtrdc.net", "publisher": "972C898555E9F7BC7F000101@AdobeOrg", "channel": "test-channel-chromecast", "ssl": true, "ovp": "chromecast-player", "sdkVersion": "chromecast-sdk", "playerName": "Chromecast" } }; </script> <script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>

<script>
    var ADBMobileConfig = {
      "marketingCloud": {
        "org": "972C898555E9F7BC7F000101@AdobeOrg"
      },
      "target": {
        "clientCode": "",
        "timeout": 5
      },
      "audienceManager": {
        "server": "obumobile5.demdex.net"
      },
      "analytics": {
        "rsids": "example.sample.player",
        "server": "example.sc.omtrc.net",
        "ssl": true,
        "offlineEnabled": false,
        "charset": "UTF-8",
        "lifecycleTimeout": 300,
        "privacyDefault": "optedin",
        "batchLimit": 0,
        "timezone": "MDT",
        "timezoneOffset": -360,
        "referrerTimeout": 0,
        "poi": []
      },
      "mediaHeartbeat": {
        "server": "example.hb-api.omtrdc.net",
        "publisher": "972C898555E9F7BC7F000101@AdobeOrg",
        "channel": "test-channel-chromecast",
        "ssl": true,
        "ovp": "chromecast-player",
        "sdkVersion": "chromecast-sdk",
        "playerName": "Chromecast"
      }
    };
  </script>
<script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>

note important
IMPORTANT
如果未正确配置 `mediaHeartbeat`，则媒体模块会进入错误状态并将停止发送跟踪调用。

mediaHeartbeat 键的 ADBMobile 配置参数：

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
配置参数	描述
`server`	表示后端跟踪端点的 URL 的字符串。
`publisher`	表示内容发布者唯一标识符的字符串。
`channel`	表示内容分发渠道名称的字符串。
`ssl`	布尔值，表示是否应使用 SSL 来跟踪调用。
`ovp`	表示视频播放器提供程序名称的字符串。
`sdkversion`	表示应用程序/SDK 当前版本的字符串。
`playerName`	表示播放器名称的字符串。

配置 Experience Cloud 访客 ID。

Experience Cloud 访客 ID 提供了一个跨 Experience Cloud 解决方案的通用访客 ID。Media Analytics 和其他 Marketing Cloud 集成都需要使用访客 ID 服务。

验证您的 ADBMobileConfig 配置包含 marketingCloud 组织 ID。

code language-none
`"marketingCloud": { "org": "YOUR-MCORG-ID" }`

Experience Cloud 组织 ID 唯一标识 Adobe Marketing Cloud 中的每个客户公司，它类似于以下值：016D5C175213CCA80A490D05@AdobeOrg。

note important
IMPORTANT
确保包含 `@AdobeOrg`。

配置完成后，将生成一个 Experience Cloud 访客 ID，并将其包含在所有点击中。其他访客 ID（如 custom 和 automatically-generated）将继续随每次点击一起发送。

Experience Cloud 访客 ID 服务方法

note tip
TIP
Experience Cloud 访客 ID 方法以 `visitor` 为前缀。

table 0-row-2 1-row-2 2-row-2
方法	描述
`getMarketingCloudID()`	从访客 ID 服务中检索 Experience Cloud 访客 ID。 `ADBMobile.visitor.getMarketingCloudID();`
`syncIdentifiers()`	使用 Experience Cloud 访客 ID，您可以设置其他可与每个访客关联的客户 ID。访客 API 接受同一访客具有多个客户 ID，并且使用客户类型标识符区分不同客户 ID 的适用范围。此方法对应于 JavaScript 库中的 `setCustomerIDs()`。例如： `var identifiers = {};` `identifiers["idType"] = "idValue";` `ADBMobile.visitor.syncIdentifiers(identifiers);`

对于跟踪媒体，实施 MediaDelegate 协议

code language-js

code language-js
`var delegate = { // Replace <currentPlaybackTime> with the video player current playback time getCurrentPlaybackTime = function() { return <currentPlaybackTime>; }, // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values. getQoSObject = function() { return ADBMobile.media.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>); } } ADBMobile.media.setDelegate(delegate); }`

 var delegate = {
   // Replace <currentPlaybackTime> with the video player current playback time
   getCurrentPlaybackTime = function() {
     return <currentPlaybackTime>;
   },
   // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
   getQoSObject = function() {
      return ADBMobile.media.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>);
   }
 }

 ADBMobile.media.setDelegate(delegate);
}

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb