設定 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 (例如 customautomatically-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);

本頁內容