使用 REST API 整合視訊雲端與市場

本主題說明如何使用 REST API 配置 Campaign 模塊以與 Marketo 一起使用。

Campaign 模塊允許 Video Cloud 將觀看數據從 Brightcove Players 同步到 Marketo。一旦進入 Marketo，此資料可用於細分、行銷活動邏輯、報告、潛在客戶評分，以及個人化通訊。

與 Marketo 集成的 Campaign 模塊包含兩個主要組件：

  • 可追蹤影片觀看資料的 Brightcove 播放程式外掛程式
  • 將追蹤資料從視訊雲端傳送至 Marketo 的同步程序

需求

要將 Campaign 模塊與 Marketo REST 集成結合使用，您必須：

  • 在 Marketo 中創建一個可以訪問所有 API 權限的角色
  • 建立啟動點服務
  • 擁有專業或企業視訊雲端帳戶
  • 通過在打開活動模塊時出現的初始啟動屏幕中提交所需信息，為您的帳戶啟用活動模塊
  • 第一次使用模組時，按一下服務合約
  • 發布您的播放器時使用高級嵌入（頁面內）發布代碼; 標準嵌入（iframe）發布代碼將無法工作，因為插件將在 iframe 內運行，因此將無法訪問任何父頁面 URL 參數，並且可能無法獲得正確的 cookie

建立僅限 API 的使用者和啟動點服務

在您可以呼叫 Marketo REST API 之前，您需要建立具有存取所有 API 的新 API 角色、建立僅限 API 的使用者，然後建立唯一識別用戶端應用程式的服務。完成這些任務的步驟概述於 Marketo 文件中。

設定連線

完成 Marketo 端的設定步驟後，請依照下列步驟設定視訊雲端和 Marketo 之間的連線。

建立視頻雲和 Marketo 之間的連接

  1. 打開 市場活動 模塊。
  2. 在左側導覽中，按一下「資料連線」。
  3. 按一下「新增連線」。
  4. 選取「行銷」做為整合。
  5. (選擇性) 輸入「連線名稱」。
    活動設置
  6. 按一下「連線」。
  7. 選取 [ 標準 (REST API)]，然後按一下 [ 儲存]。
    市場整合類型

    您將需要從您的 Marketo 帳戶粘貼多個值。請注意，您必須以 Marketo 管理員身分登入，才能完成下列步驟。對於下列步驟，請按一下空白連結並提供適當的值：

  8. Marketo 帳戶 ID - 要獲得此值，請在 Marketo 中單擊行政 > 一體化 > 芒奇金 .
  9. Marketo REST API 端點網址 -若要取得此值，請在 Marketo 中按一下管理 > 整合 > 網路服務。
  10. Marketo REST API 身分識別網址 -若要取得此值，請在 Marketo 中按一下 [ 管理員] > [ 整合] > [ Web 服務]。
  11. Marketo LaunchPoint 客戶端 ID - 要獲得此值，請在 Marketo 中單擊行政 > 一體化 > 發射點然後點擊查看詳情您之前作為此設置的一部分創建的 LaunchPoint 的鏈接。
  12. Marketo 啟動點用戶端密碼 -若要取得此值，請在 Marketo 中按一下 [ 管理員] > [ 啟動點]，然後按一下您先前建立的啟動點的 [ 檢視詳細資料]連結，做為此設定的一部分。
  13. 按一下設定。

與 Marketo 的視頻雲連接現在已經設置並可以使用。

設定整合

視頻雲到 Marketo 的連接完成後，您可以配置整合。

已連線的選項
  1. 依預設，「連線狀態」為「已啟用」。「連線狀態」會決定視訊雲端視訊互動資料是否傳送至 Marketo。
    • 啟用 -資料會收集並傳送至 Marketo
    • 停用 -未收集任何資料 (已停用整合)
  2. 依預設，「未知檢視者的追蹤資料」將設定為「已停用」。啟用此選項會追蹤未知使用者的資料。資料將會根據選取的資料保留政策來保留。如果將資料保留設定為 [ 無保留]，則不會顯示此欄位。
  3. 選取資料保留原則。資料保留原則決定您所擷取的潛在客戶資訊資料是否會保留在您的 Video Cloud 帳戶和 Marketo 中，以及是否會保留多久。收集的數據可以選擇在視頻雲中保留長達 1 個月。在 Video Cloud 中保留資料可讓您從中斷的同步處理中復原。不過，您應該根據自己的隱私權政策調整保留設定，不需要在 Video Cloud 中保留任何使用者資料。資料將於資料保留期後刪除。
    資料保留選項

若要移除與 Marketo 的整合，請按一下中斷連線。

創建啟用廣告系列的播放器

僅當您使用支持 Campaign 的視頻播放器時，視頻參與數據才會發送到 Marketo。如需建立啟用促銷活動的 Brightcove 玩家的資訊，請參閱建立啟用活動的玩家。

識別檢視者

具有 Marketo 集成的啟用廣告系列的播放器將引用在用戶瀏覽器中創建的 Munchkin cookie (_mkto_trk)。該值在 Campaign 模塊的查看數據中捕獲，並用於將查看數據同步到 Marketo。

使用者的電子郵件地址可以在顯示視訊的頁面上傳入 bcemail URL 參數。如需詳細資訊和範例，請參閱促銷活動模組如何識別檢視者。

驗證整合

設定整合後，測試整合，以確認視訊檢視資料傳送至 Marketo。如需有關驗證整合的資訊，請參閱 Marketo REST 整合測試指南。