Edge實作概觀
Adobe Experience Platform Edge Network可讓您將預計要用於多個產品的資料傳送至單一端點,接著將適當的資訊轉送至每個產品。 這是實作串流媒體收集的建議方法,也是從單一實作同時支援Adobe Analytics和Customer Journey Analytics的唯一方法。
舊版Media SDK方法需要每個Adobe解決方案使用產品專屬的檢測工具,相比之下,Edge實作則使用共用XDM資料模型和單一資料流。 資料會從SDK或API傳輸至Edge Network,接著路由至資料串流中設定的Adobe產品(Analytics、CJA、AJO或RTCDP)。 這表示稍後切換或新增下游產品不需要重新檢測您的媒體事件。
無論您使用哪個程式碼基底,都必須先完成本頁所述的平台設定:建立結構、建立資料集及設定資料流。
先決條件
-
完成一般必要條件。 請參閱一般必要條件。
-
確認相容的Adobe解決方案。 您必須具備下列其中至少一個的有效實作:
- Customer Journey Analytics: Edge媒體資料的主要報表目的地
- Adobe Analytics:透過相同資料流支援隨附或替代CJA
- Adobe Journey Optimizer或Real-Time Customer Data Platform:在設定其中一項時,將 Adobe Experience Platform 服務新增至您的資料流
在Adobe Experience Platform中設定結構
為了標準化使用Adobe Experience Platform之應用程式的資料收集,Adobe建立了開放式、公開記錄的體驗資料模型(XDM)標準。
-
在Adobe Experience Platform中,開始建立結構描述,如在UI中建立和編輯結構描述中所述。
-
在[結構描述詳細資料]頁面上,選擇 體驗事件 作為結構描述的基底類別。
-
選取「下一步」。
-
指定結構描述顯示名稱和說明,然後選取完成。
-
在 構成 區域中,在 欄位群組 區段中,選取新增,然後搜尋下列欄位群組並將其新增至結構描述:
End User ID DetailsImplementation DetailsMediaAnalytics Interaction Details
新增欄位群組後,它們會顯示在 欄位群組 區段中:
-
選取 儲存 以儲存您的變更。
-
(選用)您可以在結構描述UI中隱藏某些欄位。 這些欄位是Adobe填充在後端的伺服器計算報表欄位 — 並非由SDK或API傳送,不會影響資料收集。 隱藏這些功能不會影響功能,只會減少在AEP UI中瀏覽結構描述時的視覺雜訊。 這些欄位僅參考
MediaAnalytics Interaction Details欄位群組中的欄位。accordion 展開以檢視可隱藏欄位的指示。 -
在 結構 區域中,選取
Media Collection Details欄位,然後選取管理相關欄位。
-
啟用選項 顯示欄位 的顯示名稱,然後更新結構描述,如下所示:
-
在
Media Collection Details>Advertising Details欄位中,隱藏下列報告欄位:Ad Completed、Ad Started和Ad Time Played。 -
在
Media Collection Details>Advertising Pod Details欄位中,隱藏下列報告欄位:Ad Break ID -
在
Media Collection Details>Chapter Details欄位中,隱藏下列報告欄位:Chapter Completed、Chapter ID、Chapter Started和Chapter Time Played。 -
在
Media Collection Details欄位中,隱藏List Of States欄位。
-
在
Media Collection Details>List Of States End和Media Collection Details>List Of States Start欄位中,隱藏下列報告欄位:Player State Count、Player State Set和Player State Time。要隱藏的
-
在
Media Collection Details>Qoe Data Details欄位中,隱藏下列報告欄位:Average Bitrate、Average Bitrate Bucket、Bitrate Change Impacted Streams、Bitrate Changes、Buffer Impacted Streams、Buffer Events、Dropped Frame Impacted Streams、Drops Before Starts、Errors、External Error IDs、Error Impacted Streams、Media SDK Error IDs、Player SDK Error IDs、Stalling Impacted Streams、Stalling Events、Total Buffer Duration和Total Stalling Duration。 -
在
Media Collection Details>Session Details欄位中,隱藏下列報告欄位:10% Progress Marker、25% Progress Marker、50% Progress Marker、75% Progress Marker、95% Progress Marker、Ad Count、Average Minute Audience、Content Completes、Chapter Count、Content Starts、Content Time Spent、Estimated Streams、Federated Data、Media Segment Views、Media Downloaded Flag、Media Starts、Media Session ID、Media Session Server Timeout、Media Time Spent、Pause Events、Pause Impacted Streams、Pev3、Pccr、Total Pause Duration、Unique Time Played以及Video Segment。
-
-
選取 確認 以儲存變更。
-
在 結構 區域中,啟用選項顯示欄位顯示名稱,然後選取
List Of Media Collection Downloaded Content Events欄位。 -
選取管理相關欄位,然後依照下列方式更新結構描述:
-
在
List Of Media Collection Downloaded Content Events>Media Details>Advertising Details欄位中,隱藏下列報告欄位:Ad Completed、Ad Started和Ad Time Played。 -
在
List Of Media Collection Downloaded Content Events>Media Details>Advertising Pod Details欄位中,隱藏下列報告欄位:Ad Break ID -
在
List Of Media Collection Downloaded Content Events>Media Details>Chapter Details欄位中,隱藏下列報告欄位:Chapter Completed、Chapter ID、Chapter Started和Chapter Time Played。 -
在
List Of Media Collection Downloaded Content Events>Media Details欄位中,隱藏List Of States欄位。 -
在
List Of Media Collection Downloaded Content Events>Media Details>List Of States End和Media Collection Details>List Of States Start欄位中,隱藏下列報告欄位:Player State Count、Player State Set和Player State Time。 -
在
List Of Media Collection Downloaded Content Events>Media Details>Qoe Data Details欄位中,隱藏下列報告欄位:Average Bitrate、Average Bitrate Bucket、Bitrate Change Impacted Streams、Bitrate Changes、Buffer Events、Buffer Impacted Streams、Drops Before Starts、Dropped Frame Impacted Streams、Error Impacted Streams、Errors、External Error IDs、Media SDK Error IDs、Player SDK Error IDs、Stalling Events、Stalling Impacted Streams、Total Buffer Duration以及Total Stalling Duration。 -
在
List Of Media Collection Downloaded Content Events>Media Details>Session Details欄位中,隱藏下列報告欄位:10% Progress Marker、25% Progress Marker、50% Progress Marker、75% Progress Marker、95% Progress Marker、Ad Count、Average Minute Audience、Chapter Count、Content Completes、Content Starts、Content Time Spent、Estimated Streams、Federated Data、Media Downloaded Flag、Media Segment Views、Media Session ID、Media Session Server Timeout、Media Starts、Media Time Spent、Pause Events、Pause Impacted Streams、Pccr、Pev3、Total Pause Duration、Unique Time Played和Video Segment。 -
在
List Of Media Collection Downloaded Content Events>Media Details欄位中,隱藏Media Session ID欄位。
-
-
選取 確認 以儲存變更。
-
在 結構 區域中,選取
Media Reporting Details欄位,然後選取管理相關欄位。 -
啟用選項 顯示欄位 的顯示名稱,然後更新結構描述,如下所示:
- 在
Media Reporting Details欄位中,隱藏下列欄位:Error Details、List Of States End、List of States Start和Media Session ID。
- 在
-
選取確認 > 儲存以儲存變更。
-
-
(選用)您可以將自訂中繼資料新增到結構描述。 這可讓您針對特定需求或內容包含其他使用者定義的中繼資料。 如需使用Media Edge API自訂中繼資料的詳細資訊,請參閱自訂中繼資料支援。
accordion 展開以檢視將自訂中繼資料新增至結構描述的指示。 -
選取帳戶資訊 > 指派的組織 > 組織名稱 > 租使用者,以找出組織的租使用者名稱稱。
透過此路徑接收自訂欄位。 (例如,租使用者名稱稱: _dcbl → myCustomField路徑: _dcbl.myCustomField。)
-
新增自訂欄位群組至您定義的媒體結構描述。
-
將您想要追蹤的任何自訂欄位新增至欄位群組。
-
使用產生的路徑作為要求承載中的自訂欄位。
-
在 Adobe Experience Platform 中建立資料集
-
在Adobe Experience Platform中,依照資料集UI指南中的說明開始建立資料集。
為資料集選取結構描述時,請選擇您先前建立的結構描述。
在Adobe Experience Platform中設定資料串流
-
如設定資料流中所述,建立新的資料流。
建立資料串流時,請進行下列選擇:
-
在 事件結構描述 欄位中,選取您在中建立的結構描述。在Adobe Experience Platform中設定結構描述。
note important IMPORTANT 選取儲存;不要選取儲存並新增對應。 選取 儲存並新增對應 會造成時間戳記欄位的對應錯誤。
-
根據您的Adobe解決方案,將適當的服務新增至資料流。 如需新增服務的相關資訊,請參閱設定資料流中的「將服務新增至資料流」。
-
Adobe Analytics (若使用Adobe Analytics):如建立報表套裝中所述,定義報表套裝。
-
Adobe Experience Platform (若使用Customer Journey Analytics、Adobe Journey Optimizer或Real-Time Customer Data Platform)
-
-
展開進階選項,然後啟用 Media Analytics 選項。
-
選擇您的實作方法
在準備好結構、資料集和資料流後,實作下列其中一個程式碼庫,以開始將串流媒體資料傳送到Edge Network。 每個頁面都涵蓋串流媒體特定的設定;每個事件和每個變數的程式碼都存在於事件和變數中。
程式碼內實作會直接在應用程式原始碼中寫入SDK呼叫。 使用標籤實作使用Adobe Experience Platform標籤,可讓您設定及部署追蹤規則,而不需修改應用程式程式碼。 選擇適合您的部署工作流程的方法。
下一步
開始收集資料後,您可以設定報表:
- 設定Edge實作的報表 (Customer Journey Analytics)
- 為僅限Analytics的實施設定報告 (如果您的資料流摘要Adobe Analytics)