設定 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 提供的新使用者介面，將 Adobe Marketing Cloud 適用於行動應用程式的各項行動行銷功能整合在一起。Mobile 服務起初是提供 Adobe Analytics 和 Adobe Target 解決方案的應用程式分析和定位功能流暢整合。如需詳細資訊，請參閱 Adobe Mobile Services 文件。

Experience Cloud 解決方案適用的 Chromecast v3.x Adobe Mobile Library 可讓您測量在 JavaScript 中撰寫的 Chromecast 應用程式、透過對象管理利用和收集對象資料，以及測量視訊參與。

Mobile Library/SDK 實作

將下載的 Chromecast 程式庫新增至專案。

AdobeMobileLibrary-Chromecast-[version] zip 檔案包含下列軟體元件：
- adbmobile-chromecast.min.js：
  
  此程式庫檔案將會包含在您的 Chromecast 應用程式來源檔案夾中。
- ADBMobileConfig 設定
  
  此元件為根據您應用程式自訂的 SDK 設定檔案。範例 ADBMobileConfig 實作會連同 SDK 一併提供 (位於 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 ID) 會繼續在每次點撃時一併傳送。

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