设置 Roku

先决条件

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

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

请参阅 Adobe Mobile Services 文档，以了解更多信息。

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

SDK 实施

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

AdobeMobileLibrary-2.*-Roku.zip 下载文件包含以下软件组件：
- adbmobile.brs：此库文件将包含在您的 Roku 应用程序源文件夹中。
- ADBMobileConfig.json：这是为您的应用程序自定义的 SDK 配置文件。

将库文件和 JSON 配置文件添加到您的项目源。

用于配置 Adobe Mobile 的 JSON 具有一个用于媒体心率的专有密钥，其名称为 mediaHeartbeat。这是媒体心率的配置参数所属的位置。

小贴士

此包中提供了一个 ADBMobileConfig JSON 文件示例。有关设置，请与 Adobe 代表联系。

例如：

{
  "version":"1.0", 
  "analytics":{
    "rsids":"",
    "server":"",
    "charset":"UTF-8", 
    "ssl":false, 
    "offlineEnabled":false, 
    "lifecycleTimeout":30, 
    "batchLimit":50, 
    "privacyDefault":"optedin", 
    "poi":[ ]
},
"marketingCloud":{
  "org":""
},
"target":{ 
  "clientCode":"", 
  "timeout":5
},
"audienceManager":{ 
  "server":""
},
"acquisition":{ 
  "server":"example.com",
  "appid":"sample-app-id"
},

"mediaHeartbeat":{ 
   "server":"example.com", 
   "publisher":"sample-publisher", 
   "channel":"sample-channel", 
   "ssl":false,
   "ovp":"sample-ovp", 
   "sdkVersion":"sample-sdk", 
   "playerName":"roku"
   }    
}

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

重要

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

配置 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（如 custom 和 automatically-generated）将继续随每次点击一起发送。

Experience Cloud 访客 ID 服务方法

小贴士

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

方法	描述
`visitorMarketingCloudID`	从访客 ID 服务中检索 Experience Cloud 访客 ID。 `ADBMobile().visitorMarketingCloudID()`
`visitorSyncIdentifiers`	使用 Experience Cloud 访客 ID，您可以设置其他可与每个访客关联的客户 ID。访客 API 接受同一访客具有多个客户 ID，并且使用客户类型标识符区分不同客户 ID 的适用范围。此方法对应于 `setCustomerIDs`。例如： `identifiers={}` `identifiers["idType"]="idValue"` `ADBMobile().visitorSyncIdentifiers(identifiers)`
`setAdvertisingIdentifier`	用于在 SDK 上设置 Roku ID for Advertising (RIDA)。例如： `ADBMobile().setAdvertisingIdentifier(` `"<sample_roku_identifier_for_advertising>")` 使用 Roku SDK getRIDA() API 获取 Roku ID for Advertising (RIDA)。