Show Menu
主題×

設定 Chromecast

常見問題解答

我該使用 Chromecast JavaScript SDK 嗎?還是說,我可以使用標準 JavaScript SDK 呢?
正確答案為「Chromecast」,原因如下:
  • 標準 JS SDK 中的 AppMeasurement 和 VisitorAPI 程式庫未經認證可在 OTT 平台上運作。在 Chromecast JS SDK 中,視訊心率程式庫 (VHL)、Analytics 和 VisitorAPI 均內建於單一、統一且經過 Chromecast 認證的 SDK 中。
  • Chromecast SDK 比起標準 JS SDK 更輕量得多。這對 OTT 平台使用的低階硬體非常重要。

必備條件

  • 取得心率適用的有效設定參數
    在您設定媒體分析帳戶後,即可從 Adobe 代表取得這些參數。
  • 在您的媒體播放器中提供下列功能:
    • 訂閱播放器事件專用的 API
      - 當您的播放器中發生事件時,Media SDK 需要您呼叫一組簡易 API。
    • 提供播放器資訊的 API
      - 此資訊包含媒體名稱和播放點位置等詳細內容。
Adobe Mobile Services 提供的新使用者介面,將 Adobe Marketing Cloud 適用於行動應用程式的各項行動行銷功能整合在一起。Mobile 服務起初是提供 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 設定檔案。範例
        ADBMobileConfig
        實作會連同 SDK 一併提供 (位於
        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 (例如
    custom
    automatically-generated
    ID) 會繼續在每次點撃時一併傳送。
    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);