设置 Chromecast

常见问题解答

我应该使用 Chromecast JavaScript SDK 还是标准 JavaScript SDK?

正确答案是“Chromecast”,原因如下:

  • Standard JS SDK 中的 AppMeasurement 和 VisitorAPI 库未经认证可在 OTT 平台上工作。在 Chromecast JS SDK 中,视频心率库 (VHL)、Analytics 和 VisitorAPI 都内置于一个经过 Chromecast 认证的统一 SDK 中。
  • Chromecast SDK 比 Standard JS SDK 更加轻巧。这对于 OTT 平台使用的低端硬件来说非常重要。

先决条件

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

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

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

SDK 实施

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

    1. AdobeMobileLibrary-Chromecast-[version] zip 文件包含以下软件组件:

      • adbmobile-chromecast.min.js

        此库文件将包含在您的 Chromecast 应用程序源文件夹中。

      • ADBMobileConfig 配置

        这是为您的应用程序自定义的 SDK 配置文件。随 SDK 提供了一个 ADBMobileConfig 实施示例(在 samples/ 下)。请从 Adobe 代表处获取正确的设置。

    2. 将库文件添加到 index.html 文件中,并按照以下方式创建 ADBMobileConfig 全局变量(用于配置 Adobe Mobile for Heartbeats 的全局变量具有一个名为 mediaHeartbeat 的排他键):

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

      如果未正确配置 mediaHeartbeat,则媒体模块 (VHL) 会进入错误状态并将停止发送跟踪调用。

      mediaHeartbeat 键的 ADBMobile 配置参数:
      | 配置参数 | 描述     |
      | — | — |
      | server | 表示后端跟踪端点的 URL 的字符串。 |
      | publisher | 表示内容发布者唯一标识符的字符串。 |
      | channel | 表示内容分发渠道名称的字符串。 |
      | ssl | 布尔值,表示是否应使用 SSL 来跟踪调用。 |
      | ovp | 表示视频播放器提供程序名称的字符串。 |
      | sdkversion | 表示应用程序/SDK 当前版本的字符串。 |
      | playerName | 表示播放器名称的字符串。 |

  2. 配置 Experience Cloud 访客 ID。

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

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

    "marketingCloud": {
        "org": YOUR-MCORG-ID"
    }
    

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

    重要

    确保包含 @AdobeOrg

    配置完成后,将生成一个 Experience Cloud 访客 ID,并将其包含在所有点击中。其他访客 ID(如 customautomatically-generated)将继续随每次点击一起发送。

    Experience Cloud 访客 ID 服务方法

    小贴士

    Experience Cloud 访客 ID 方法以 visitor 为前缀。

    方法 描述
    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);

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now