Primetime TVE儀表板使用手冊 tve-db-user-guide
簡介 tve-db-intro
Adobe TVE儀表板(TVE儀表板) 是一個自助式儀表板,目標使用者是為與Adobe Pass驗證產品團隊有業務關係的媒體公司(程式設計師)工作。
請聯絡您的技術客戶經理(TAM)以取得存取權。 若要獲得存取權,您需要在您的Adobe Marketing Cloud組織中設定兩個新使用者群組:
- TVE控制面板讀寫 — 此群組的成員擁有控制面板所有可編輯區段的完整許可權
- TVE控制面板唯讀 — 此群組的成員在整個控制面板上只有檢視許可權
參閱本使用手冊前,建議您先瀏覽下列資源,以充分瞭解Adobe Pass驗證產品團隊提供的流程和功能,並熟悉本檔案所使用的術語:
繼續本使用手冊的後續章節,您將瞭解如何為貴公司的頻道、程式設計師或頻道與MVPD (多頻道視訊程式經銷商)之間的整合管理不同的設定。
圖1: Adobe Primetime TVE控制面板「基本/進階工作區」下拉式清單
環境 authn-environments
根據使用者可能需要完成的工作,他/她可能需要在Adobe Pass驗證環境之間切換。 如需Adobe Pass驗證環境的詳細資訊,請參閱以下檔案: 瞭解Adobe Pass驗證環境.
TVE Dashboard提供兩個名為「預合格」(預合格)和「發行」的環境,每個環境都有兩個名為「預備」和「生產」的設定檔,如下所示:
若要在環境之間切換,使用者可以從下面所示的下拉式元素中按一下由條目表示的所需環境:
圖2: Adobe Pass TVE儀表板環境下拉式清單
若要透過TVE控制面板對您的Adobe Pass驗證設定進行管理變更:
- 在中執行變更 發佈測試環境並進行驗證.
- 在中執行變更 預先生產並進行驗證.
- 在中執行變更 發佈生產環境並進行驗證.
圖3: Adobe Primetime TVE控制面板檢閱和推播變更通知
部分 sections
為媒體公司工作的使用者(程式設計師)可以從側邊欄存取TVE儀表板的下列區段:
- 頻道 — 包含與內容提供者相關的設定
- 程式設計師 — 包含與彙總一或多個父級組織相關的設定 頻道
- 整合 — 包含與整合相關的設定,介於 頻道 和 MVPDs
- MVPDs — 包含與可用專案相關的設定 MVPDs
- 報表 — 包含三種報表型別的彙總資料:AuthN TTL、AuthZ TTL、SSO
- 變更記錄 — 包含套用至TVE控制面板組態的最新修改
圖4: Adobe Primetime TVE控制面板區段
頻道 tve-db-channels-section
此區段可讓您檢視和編輯可用頻道的設定,或建立新頻道。 按一下其中一個可用的「色版」會傳回含有下列標籤的畫面:
-
管道資料
- 管道ID — 我們系統中使用的管道唯一ID,也稱為「請求者ID」。
- 顯示名稱 — 頻道的商業名稱。
-
一般設定
- Analytics設定 — 設定要轉送至Adobe Analytics的Adobe Pass驗證事件。 如需有關啟用此功能之前需要如何設定報表套裝ID (RSID)的詳細資訊,請聯絡Adobe。
-
憑證
包含驗證流程中使用的憑證清單,以及它們的發行組織、發行日期和到期日。 這些憑證可作為私人/公開金鑰,並用於驗證用途。
-
網域
包含各個通道要與Adobe Pass驗證通訊的網域清單。
-
整合
包含與可用MVPD的整合清單,以及可啟用或不可使用的每個整合的狀態。 按一下特定專案,即可導覽至整合頁面。
-
註冊的應用程式
包含應用程式註冊清單。 如需詳細資訊,請檢閱檔案 動態使用者端註冊管理.
-
自訂配置
包含自訂配置清單。 如需詳細資訊,請參閱 iOS/tvOS應用程式註冊 和 動態使用者端註冊管理
新增/刪除網域 add-delete-domains
若要啟動為所選管道新增網域的程式,您需要按一下「網域」清單下方的「新增網域」按鈕。 這會建立一個新的網域專案,您可以在其中指定網域名稱。 如果網域清單中已存在較通用的網域,則不應新增子網域。
圖:管道中的「網域」標籤
程式設計師 tve-db-programmers-section
此區段可讓您檢視和編輯可用程式設計師的設定,或建立新的設定。 按一下其中一個可用的程式設計人員將傳回包含以下索引標籤的畫面:
-
程式設計師資料
- 程式設計師ID — 我們系統中使用的程式設計師唯一ID。
- 顯示名稱 — 程式設計師的商業名稱。
- 標誌Url — 程式設計師的商業標誌統一資源定位器(URL)。
- 標誌預覽 — 程式設計師的商業標誌預覽,可從上述統一資源定位器(URL)下載。
-
憑證
包含驗證流程中使用的憑證清單,以及它們的發行組織、發行日期和到期日。 這些憑證可作為私人/公開金鑰,並用於驗證用途。
-
頻道
包含屬於此特定程式設計師的管道清單。 按一下特定專案,即可使用導覽至管道區段。
-
註冊的應用程式
包含應用程式註冊清單。 如需詳細資訊,請參閱 動態使用者端註冊管理.
-
自訂配置
包含自訂配置清單。 如需詳細資訊,請參閱 iOS/tvOS應用程式註冊 和 動態使用者端註冊管理.
整合 tve-db-integrations-sec
此區段可讓您檢視及編輯頻道與可用MVPD之間整合的設定,或建立新的設定。 按一下其中一個可用的整合,會在使用基本工作區時傳回單一頁面,或在使用進階工作區時傳回包含以下索引標籤的畫面:
-
整合資料
- 整合ID — 將MVPDs唯一ID附加至以「_」字元分隔的管道唯一ID的結果。
- 頻道顯示名稱 — 頻道的商業名稱。
- 管道ID — 我們系統中使用的管道唯一ID,也稱為「請求者ID」。
- MVPD顯示名稱 - MVPD的商業名稱。
- MVPD ID — 我們系統中使用的MVPD唯一ID。
-
一般設定
- 使用者中繼資料索引鍵 — 設定可用於特定整合的中繼資料索引鍵。
- 平台專屬設定 — 針對特定平台設定不同的設定(例如TTL、SSO和IFrames)。
-
驗證設定
- 包含與Adobe Pass驗證功能相關的設定。
-
授權設定
- 包含與Adobe Pass驗證授權功能相關的設定。
-
登出設定
- 包含與Adobe Pass驗證登出功能相關的設定。
建立整合 create-integration
若要建立新的整合,請遵循下列步驟:
- 按一下「新增整合」按鈕
- 搜尋並選取頻道
- 搜尋並選取MVPD
- 等候TVE儀表板計算「整合ID」並顯示可用的MVPD端點
- 選取驗證、授權和登出端點或使用預設值
- 按一下「建立整合」按鈕
- 根據MVPD設定,會出現快顯視窗並要求其他屬性,這些屬性應預先由MVPD提供,否則將重新導向至新建立的整合頁面
圖5. Adobe Primetime TVE控制面板新整合視窗
更新整合 update-integration
若要更新現有的整合,請從「整合」區段或從「管道」區段(包含「整合」索引標籤)按一下該特定整合的表格專案。
使用基本工作區模式時,本節將允許檢視及編輯最常更新的設定,例如驗證和授權權杖TTL (存留時間)以及iFrame設定。 請記住,與支援動態定義權杖持續性TTL的MVPD的整合可能會遺失TTL設定(請參閱中的專案1.19 MVPD整合需求)。
使用進階工作區模式時,此區段將允許檢視及編輯較不常見的設定。
在基本和進階工作區模式中,這些設定可在平台層級變更(例如,為Android上的授權TTL權杖選取自訂值,在所有其他平台上預設值)。
圖6. Adobe Primetime TVE Dashboard屬性繼承鏈元件
平台專屬設定 platform-sp-settings
此子區段可用於覆寫特定平台的設定。 可用的平台包括:
- 所有平台 — 設定將套用至所有平台的值,不論程式設計人員實施為何,以防沒有針對特定平台設定的其他值。
- Android — 設定將套用至Adobe Pass Authentication Android SDK上程式設計人員實作的值。
- 無使用者端REST API — 設定將透過Adobe Pass驗證REST API套用至程式設計師實作的值。
- Fire TV — 設定將套用至Adobe Pass Authentication FireTV SDK上程式設計師實作的值。
- FLASHSDK — 此平台已淘汰。 已棄用
- JavaScript SDK — 設定將套用至Adobe Pass Authentication JavaScript SDK上程式設計人員實作的值。
- Roku — 設定將透過Adobe Pass Authentication REST API套用至程式設計人員實作,且以裝置型別傳送「Roku」的值。 在Roku裝置的情況下,此優先於針對無使用者端REST API平台設定的值。
- Xbox原生SDK — 此平台已淘汰。 已棄用
- Xbox 360 REST API — 設定將透過Adobe Pass Authentication REST API套用至程式設計人員實作,以及將「xbox」作為裝置型別傳送的值。 在Xbox 360裝置的情況下,這會優先於針對無使用者端REST API平台設定的值。
- Xbox One REST API — 設定將透過Adobe Pass Authentication REST API套用至程式設計人員實作,且會傳送「xboxOne」作為裝置型別的值。 在XboxOne裝置的情況下,這會優先於針對無使用者端REST Api平台設定的值。
- iOS — 設定將套用至Adobe Pass Authentication iOS SDK上程式設計人員實作的值。
- tvOS — 設定將套用至Adobe Pass Authentication tvOS SDK上程式設計人員實作的值。
圖7. Adobe Primetime TVE儀表板平台專屬設定
啟用平台單一登入 enable-platform-sso
請依照下列步驟,為特定整合和平台啟用/停用單一登入:
-
確定您使用進階工作區模式
-
導覽至所需的整合
-
導覽至 一般設定 標籤
-
選取您要啟用或停用單一登入的所需平台
-
切換 啟用單一登入 標幟為所要的值(是/否)
note important IMPORTANT 請務必注意 啟用單一登入 標幟僅適用於iOS、tvOS、Roku及FireTV平台,且僅適用於在這些平台上支援「單一登入」的MVPD整合。 -
切換 強制執行平台許可權 標幟為所要的值(是/否)
note important IMPORTANT 請務必注意 強制執行平台許可權 標幟控制是否將強制執行使用者允許或拒絕平台存取其電視提供者訂閱的決定。 考慮以下情況 啟用單一登入 旗標設為「是」, 強制執行平台許可權 標幟也設為「是」,且使用者選擇拒絕平台存取其電視提供者訂閱,則個別應用程式(頻道)將無法使用其他應用程式(頻道)所取得的Adobe Pass驗證權杖。
啟用以住家為基礎的驗證 enable-hba
請依照下列步驟,為啟用/停用家用驗證 OAuth2 根據MVPD:
- 確定您使用進階工作區模式
- 導覽至所需的整合
- 瀏覽至 驗證設定 標籤
- 瀏覽至 AuthN動態規則 子標籤
- 切換 嘗試HBA 標幟為所要的值(是/否)
請聯絡 tve-support@adobe.com 以取得為基於SAML的MVPD啟用Home-Base驗證的資訊。
MVPDs tve-db-mvpds-sec
此段落可檢視可用MVPD的設定。 按一下其中一個可用的MVPD會傳回含有下列標籤的畫面:
-
MVPD資料
- MVPD ID — 我們系統中使用的MVPD唯一ID。
- 顯示名稱 - MVPD的商業名稱,可能用於使用者的選擇器中。
- 標誌Url - MVPD的商業標誌統一資源定位器(URL)。
- 標誌預覽 - MVPD的商業標誌預覽,可從上述統一資源定位器(URL)下載。
-
一般設定
-
使用者中繼資料索引鍵
- 適用於特定MVPD的中繼資料索引鍵。
-
使用者端資料屬性
- 驗證/彙總 — 如果設為「是」,則使用者嘗試存取的每個新頻道都需要新的驗證權杖。
- 被動驗證已啟用 — 如果Auth / Aggregator旗標設為「是」,且Passive AuthN Enabled設為「是」,則背景中會進行另一個頻道的驗證程式,不需要顯示完整的瀏覽器重新導向與選擇器。
- 驗證/瀏覽器工作階段 — 如果設為「是」,則使用者將在關閉瀏覽器後登出。 如果設為「否」,則使用者可以重新啟動瀏覽器並保持登入狀態。
- 需要IFrame — 如果設為「是」,則表示MVPD登入視窗需要iFrame。 「iFrame寬度」和「iFrame高度」欄位代表載入MVPD登入頁面的iFrame所需的大小。
-
-
驗證設定
- 選取端點
- 此欄位會指出MVPD公開的驗證端點。 端點可能會因使用的驗證通訊協定而異。
- AuthN一般設定
- 此子頁簽會顯示MVPD使用的驗證通訊協定以及通訊協定相關資訊。
- AuthN憑證
- 此子索引標籤會顯示MVPD在驗證流程中使用的憑證,以及其簽發者組織、發行日期和到期日。 這些憑證可作為私人/公開金鑰,並用於驗證用途。
- AuthN動態規則
- 此子標籤會顯示套用至驗證程式的規則。 按下圖表的「要求/回應/代號」時,您可以看到套用至該驗證流程部分的引數反白顯示。
- 選取端點
-
授權設定
-
選取端點
- 此欄位指出MVPD公開的授權端點。 端點可能會因使用的授權通訊協定而異。 可用的授權通訊協定為SOAP、REST (適用於無使用者端裝置)、SAML、XACML和OAUTH。
-
AuthZ一般設定
- 此子頁簽會顯示MVPD使用的授權通訊協定以及通訊協定相關資訊。
- 預檢設定
- 它說明在一次呼叫中MVPD可以預先授權的資源數量、使用的PreFlight模型,以及逾時臨界值。 有時,特定整合的資源數量可能會不同。 可透過編輯"預檢資源的最大數量「屬性」,可在「一般設定」標籤下使用。 此屬性僅適用於指定的整合,且一旦設定,就會取代授權設定 — > PreFlight設定 — > PreFlight最大資源中定義的值來使用。
- DOS保護
- 它說明MVPD授權端點上的拒絕服務保護。 如需每個欄位的確切說明,請將游標移至DOS保護欄位上方,檢視工具提示。
- 如果MVPD是 暫時傳遞,然後 AuthZ一般設定 也包含有關TempPass持續時間的資訊。
- 如果MVPD是 FlexibleTempPass,然後 AuthZ一般設定 也包含有關TempPass持續時間、最大資源數和識別欄位的資訊(請參閱下圖)。
-
AuthZ憑證
- 此子索引標籤會顯示MVPD在授權流程中使用的憑證,以及其簽發者組織、發行日期和到期日。 這些憑證可作為私人/公開金鑰,並用於驗證用途。
-
AuthZ動態規則
- 此子頁簽會顯示套用至授權程式的規則。 按一下圖表的 請求/回應/權杖,您會看到套用至該部分授權流程的引數以醒目提示。
-
-
登出設定
-
選取端點
-
此欄位會指出MVPD公開的登出端點。 提供的通訊協定可以是SAML或OAuth2。
-
登出一般設定
- 此子頁簽會顯示MVPD所使用的登出通訊協定以及通訊協定相關資訊。
- 需要簽署的登出回應 — 如果設為[是],則回應必須由受信任的憑證簽署。
-
登出憑證
- 此子索引標籤會顯示MVPD在登出流程中使用的憑證,以及其簽發者組織、發行日期和到期日。 這些憑證可作為私人/公開金鑰,並用於驗證用途。
-
登出動態規則
- 此子標籤會顯示適用於登出程式的規則。 按一下圖表的 請求/回應/權杖,您會看到醒目顯示套用至該部分登出流程的引數。
-
-
報表 tve-db-reports-sec
若要導覽至本節,請按一下「控制面板區段「 」功能表。 這會導覽至包含3個索引標籤的畫面,下列子區段將詳細顯示該畫面: 驗證TTL報表, AuthZ TTL報表, SSO報告.
本節可讓您檢視和匯出多種報表型別的彙總資料,供您在所有平台上使用各種MVPD進行管道整合。
平台 report-platforms
所有報表會彙總下列平台上的值:
瀏覽器
顯示將套用至Adobe Pass Authentication JavaScript SDK上程式設計師實作的值。
行動: IOS
顯示將套用至Adobe Pass Authentication iOS SDK上程式設計人員實作的值。
行動裝置:ANDROID
顯示將套用至Adobe Pass Authentication Android SDK上程式設計師實作的值。
行動:其他
顯示將套用至程式設計人員實作(透過為行動裝置開發的Adobe Pass Authentication REST API)的值。
TVCD: ROKU
顯示將透過Adobe Pass Authentication REST API套用至程式設計人員實作,以及將「Roku」作為裝置型別傳送的值。
TVCD:FIRETV
顯示將套用至Adobe Pass Authentication FireTV SDK上程式設計師實作的值。
TVCD: APPLETV
顯示將套用至Adobe Pass Authentication tvOS SDK上程式設計師實作的值。
TVCD:其他
顯示將套用至程式設計師實作的值,透過為電視連線裝置開發的Adobe Pass Authentication REST API執行。
平台:未知
顯示將套用至Adobe Pass驗證服務偵測到未知裝置型別的程式設計人員實作的值。
檢閱機制 傳遞使用者端資訊 前往Adobe Pass驗證REST API或SDK ,以取得有關如何傳送所需裝置型別(例如「Roku」)的詳細資訊。
所有報表彙總值是根據各個Adobe Pass驗證環境專屬的設定所計算得出的。 因此,在不同的TVE儀表板環境之間切換時,您可以預期不同的報表資料。
請檢閱 環境 區段,以取得與Adobe Pass驗證可用環境相關的詳細資訊。
選取特定通道/ MVPD selecting-specific-channels-mvpds
所有報表皆可藉由選取特定通道或選取要包含在結果報表中的特定MVPD,來允許使用篩選器。
若要選取一個或多個管道,請使用 下拉式清單 置於「為報表選取的管道」標籤之後。 請參閱圖8。/9./10. 下方影像的縮圖。
若要選取一或多個MVPD,請使用 下拉式清單 置於「為報表選取的MVPD」標籤之後。 請參閱圖8。/9./10. 下方影像的縮圖。
依預設,資料會跨貴公司的所有頻道(「所有頻道」)及其整合的MVPD(「所有MVPD」)進行彙總。
如果您選擇取消選取「所有頻道」或「所有MVPD」而未選擇特定選項,UI會顯示「沒有可用的資料」預留位置。
匯出報告 export-report
所有報表都允許匯出逗號分隔值(CSV)格式檔案的資料。
為了匯出資料,請使用置於視窗右上角的「匯出報告」按鈕。 請參閱圖8。/9./10. 下方影像的縮圖。
名為的檔案 Report.csv 將會自動下載到您的電腦。 因此,請確定您的瀏覽器設定允許下載檔案。
計算Report.csv檔案時,畫面上會出現「匯出資料」載入圖示,此動作可能需要花費 到幾分鐘 視您要匯出的資料大小而定。
AuthN TTL報表(#authn-ttl-reports)
此報表顯示針對您管道整合,以及所有平台上的各種MVPD所設定的驗證Token的存留時間(TTL)。
驗證Token Time-To-Live,也稱為 驗證TTL,會以人類可讀的值顯示,例如: 天、小時、分鐘、秒.
就使用者體驗而言,AuthN TTL報表可讓您根據特定MVPD和特定平台,以視覺化方式檢查使用者驗證的時間長度。
若要導覽至這類報告,請按一下「報告」區段中的「驗證TTL報告」索引標籤。
圖8: Adobe Primetime TVE控制面板驗證TTL報告標籤
「AuthN TTL報告」表格包含頁面,並可根據熒幕大小進行水平和垂直捲動。
如果您考慮變更AuthN TTL值,請檢閱 整合 區段。
AuthZ TTL報表 authz-ttl-reports
此報表顯示針對您管道整合設定的授權權杖與所有平台上的各種MVPD的存留時間(TTL)。
授權權杖存留時間,也稱為 AuthZ TTL,會以人類可讀的值顯示,例如: 天、小時、分鐘、秒.
就使用者體驗而言,AuthZ TTL報表可讓您透過視覺化方式,針對特定MVPD和特定平台,檢查使用者獲授權的時間長度。
若要導覽至這類報告,請按一下「報告」區段中的「AuthZ TTL報告」索引標籤。
圖9. Adobe Primetime TVE控制面板AuthZ TTL報告標籤
AuthZ TTL報告表格包含頁面,並可根據熒幕大小進行水平和垂直捲動。
如果您考慮變更AuthZ TTL值,請參閱 整合 區段。
SSO報告 sso-reports
此報表顯示針對您管道與所有平台之各種MVPD的整合所設定的單一登入(SSO)狀態。
「單一登入」狀態,也稱為 SSO狀態,會顯示為3State,可能值如下: SSO停用、SSO啟用、SSO不確定.
就使用者體驗而言,SSO報告可讓您檢視預期的使用者驗證SSO體驗,並考量特定MVPD和特定平台。
若要導覽至此型別的報告,請按一下「SSO報告「 」標籤中的「 」報表「 」區段。
圖10: Adobe Primetime TVE控制面板SSO報告標籤
「SSO報告」表格包含頁面,並可根據熒幕大小進行水平和垂直捲動。
如果您考慮變更SSO狀態,請檢閱 整合 區段。
變更記錄 tve-db-changelog-sec
本區段顯示透過TVE控制面板推送至Adobe Pass驗證環境和設定的所有修改清單。
有些欄可指出推播日期、操作修改的使用者以及推播的狀態。
此區段也允許比較兩個表格專案,以縮小您要檢查的特定修改範圍,甚至將比較共用為郵件專案。
意見反應 tve-db-feedback-sec
此區段可讓使用者傳送意見反應。 請依照下列步驟,向Adobe Pass驗證產品團隊提供意見回饋:
- 按一下畫面右側的「意見回饋」按鈕
- 輸入主旨
- 輸入訊息
- 如有需要,請按一下「上傳熒幕擷圖」按鈕,將熒幕擷圖上傳至訊息
- 按一下「提交」按鈕
圖11: Adobe Primetime TVE控制面板意見回饋區段
如需如何擷取熒幕擷取畫面的指示,請檢視下列連結:
疑難排解 tve-db-troubleshoot
維護模式 maintenance-mode
圖:處於維護模式的TVE應用程式
如果TVE儀表板處於「維護模式」,那麼使用者將無法檢視或進行新的變更。
如果發生這種狀況,您必須等候Adobe Pass驗證工程團隊完成TVE控制面板的維護工作。
降級狀態 degraded-state
圖:TVE應用程式處於降級狀態
如果TVE儀表板處於「降級狀態」,則使用者將缺乏搜尋和排序功能,但使用者將能夠檢視或進行新變更。
如果發生這種狀況,您必須等候Adobe Pass驗證工程團隊完成TVE控制面板的維護工作。