市場 REST 集成測試指南

當建立基於 Marketo REST 的全新整合時，測試和確認視訊觀看資料確實會傳遞給 Marketo 是否有挑戰性。在本主題中，您將學習如何系統地測試並確認整合運作，以及檢視資料和潛在客戶正在傳送至 Marketo。

如需如何設定促銷活動模組以使用 REST API 與 Marketo 搭配使用的資訊，請參閱使用 REST API 整合視訊雲端與 Marketo。

開始之前

驗證整合之前，假設您有：

成功完成了Brightcove Campaign REST 集成與市場
建立至少一個啟用促銷活動的播放程式，並將其設定為使用 Marketo 連線

配置測試線索表格並發布視頻

出於測試目的，您將需要在 Campaign 中創建和配置自定義潛在客戶表單。這是一個 Marketo 表單，您已將其嵌入代碼粘貼到 Campaign 中。即使您不會在生產環境中使用潛在客戶表單，也可以使用該潛在客戶表單來確保您在數據庫和頁面中均已知曉。要創建 Marketo 表單並配置 Campaign 以使用它，請按照以下步驟操作。

登錄到您的市場帳戶。
建立並設定「行銷」表單的樣式。如需有關建立 Marketo 表單的資訊，請參閱為 Marketo 建立自訂潛在客戶表單。
以滑鼠右鍵按一下左側導覽中的表單，然後按一下「內嵌
將表單嵌入代碼複製到剪貼板。
返回到 Campaign 模塊。
使用 Marketo 表單內嵌程式碼建立新的潛在客戶表單。
設置您的自定義窗體以在5秒標記處顯示該窗體。這樣，您將確切知道何時顯示。
核取方塊以永遠顯示潛在客戶表單，即使潛在客戶已知也是如此。這將確保在測試過程中填寫表格後，表格繼續顯示。
儲存表單。
使用 Marketo 連線設定布萊特灣玩家，以使用剛才建立的 Marketo 主機表單。

生成預覽鏈接以觀看視頻

要生成視頻的預覽鏈接，請按照下列步驟操作。

開啟「媒體」模組。
選擇一個視頻並將其發佈到網絡播放器。確保選擇具有潛在客戶表單的啟用廣告系列的播放器。
按一下預覽連結，在新的瀏覽器視窗中開啟視訊。通過這種方式進行測試，可以消除嵌入HTML頁面的播放器可能引入的任何潛在變量。
確認播放了視頻，並且線索表顯示在5秒標記處。
使用獨特的聯絡資訊和電子郵件地址 (例如名人姓名或包含「bctest」字樣的名稱) 填寫潛在客戶表單，以便稍後在 Marketo 中輕鬆找到該表單。這消除了任何瀏覽器，播放器或數據庫級別的變量。透過以新使用者身分填寫表單，我們可以確定您現在是 Marketo 中的已知使用者。

確認 Campaign 正在成功捕獲數據

在 Marketo 中查找視頻觀看數據之前，首先確認 Campaign 確實捕獲了視頻觀看。請注意，查看數據最多可能需要 3 小時才能顯示在 Campaign UI 中。要確認 Campaign 正在成功捕獲數據，請執行以下步驟。

打開 市場活動 模塊。
按一下左側導覽中的「所有最近的活動」。
確認有一個帶有最近時間戳記的事件，該事件顯示了剛剛觀看的視頻的名稱。事件狀態應為未處理。這表示 Campaign 已捕獲視圖但尚未嘗試將其同步到 Marketo。
要手動觸發 Campaign 和 Marketo 之間的同步，請單擊同步活動在左側導航中。
從「選取連線」下拉式清單中，選取您的 Marketo 整合。應該會出現「測試同步」按鈕。
按一下「測試同步」以觸發手動同步。請注意，您限於觸發手動同步的頻率。默認情況下，Campaign 每小時將視圖同步到 Marketo 一次。
按一下左側導覽中的「所有最近的活動」。
您的檢視事件的狀態將會排入佇列。資料可能需要 15 分鐘左右的時間才能實際同步到 Marketo。數據同步後，狀態將更改為以下兩種狀態之一：
- 已同步 -表示該用戶是已知用戶，並且數據已成功傳送到其活動日誌。數據也應該在幾分鐘內可以在 Marketo 中查看。
- unknown_contact -表示該用戶被視為未知用戶，並且Marketo無法接受數據。如果您取得 unknown_contact狀態，請檢查您是否使用正確的播放器發佈影片、準備 Marketo 表單，並正在使用預覽連結進行測試，而不是內嵌在頁面中。

確認視訊檢視資料位於 Marketo

促銷活動顯示同步狀態後，請按照下列步驟驗證資料是否在 Marketo 中。

登錄到您的市場帳戶。
瀏覽至潛在客戶資料庫，並搜尋新的潛在客戶。使用您在填寫潛在客戶表單時使用的唯一名稱或電子郵件地址進行搜尋。
按兩下新的潛在客戶以開啟潛在客戶資訊。
按一下「活動記錄」標籤。
使用快速尋找...在頁面底部，搜尋 Brightcove 視訊檢視。
雙擊一行以顯示 Campaign 已填充的字段。彈出窗口將顯示從 Campaign 傳送到 Marketo 的視頻觀看數據，例如播放器 ID、視頻 ID、視頻名稱、觀看百分比和其他字段。