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)。 這表示稍後切換或新增下游產品不需要重新檢測您的媒體事件。

無論您使用哪個程式碼基底,都必須先完成本頁所述的平台設定:建立結構、建立資料集及設定資料流。

先決條件

  1. 完成一般必要條件。 請參閱一般必要條件

  2. 確認相容的Adobe解決方案。 您必須具備下列其中至少一個的有效實作:

在Adobe Experience Platform中設定結構

為了標準化使用Adobe Experience Platform之應用程式的資料收集,Adobe建立了開放式、公開記錄的體驗資料模型(XDM)標準。

  1. 在Adobe Experience Platform中,開始建立結構描述,如在UI中建立和編輯結構描述中所述。

  2. 在[結構描述詳細資料]頁面上,選擇​ 體驗事件 ​作為結構描述的基底類別。

    已新增欄位群組

  3. 選取​「下一步」

  4. 指定結構描述顯示名稱和說明,然後選取​完成

  5. 在​ 構成 ​區域中,在​ 欄位群組 ​區段中,選取​新增,然後搜尋下列欄位群組並將其新增至結構描述:

    • End User ID Details
    • Implementation Details
    • MediaAnalytics Interaction Details

    新增欄位群組後,它們會顯示在​ 欄位群組 ​區段中:

    已新增欄位群組

  6. 選取​ 儲存 ​以儲存您的變更。

  7. (選用)您可以在結構描述UI中隱藏某些欄位。 這些欄位是Adobe填充在後端的伺服器計算報表欄位 — 並非由SDK或API傳送,不會影響資料收集。 隱藏這些功能不會影響功能,只會減少在AEP UI中瀏覽結構描述時的視覺雜訊。 這些欄位僅參考MediaAnalytics Interaction Details欄位群組中的欄位。

    accordion
    展開以檢視可隱藏欄位的指示。
    1. 在​ 結構 ​區域中,選取Media Collection Details欄位,然後選取​管理相關欄位

      管理相關欄位

    2. 啟用選項​ 顯示欄位 ​的顯示名稱,然後更新結構描述,如下所示:

      • Media Collection Details > Advertising Details欄位中,隱藏下列報告欄位: Ad CompletedAd StartedAd Time Played

      • Media Collection Details > Advertising Pod Details欄位中,隱藏下列報告欄位: Ad Break ID

      • Media Collection Details > Chapter Details欄位中,隱藏下列報告欄位: Chapter CompletedChapter IDChapter StartedChapter Time Played

      • Media Collection Details欄位中,隱藏List Of States欄位。

        隱藏媒體集合狀態

      • Media Collection Details > List Of States EndMedia Collection Details > List Of States Start欄位中,隱藏下列報告欄位: Player State CountPlayer State SetPlayer State Time

        要隱藏的 欄位

      • Media Collection Details > Qoe Data Details欄位中,隱藏下列報告欄位: Average BitrateAverage Bitrate BucketBitrate Change Impacted StreamsBitrate ChangesBuffer Impacted StreamsBuffer EventsDropped Frame Impacted StreamsDrops Before StartsErrorsExternal Error IDsError Impacted StreamsMedia SDK Error IDsPlayer SDK Error IDsStalling Impacted StreamsStalling EventsTotal Buffer DurationTotal Stalling Duration

      • Media Collection Details > Session Details欄位中,隱藏下列報告欄位: 10% Progress Marker25% Progress Marker50% Progress Marker75% Progress Marker95% Progress MarkerAd CountAverage Minute AudienceContent CompletesChapter CountContent StartsContent Time SpentEstimated StreamsFederated DataMedia Segment ViewsMedia Downloaded FlagMedia StartsMedia Session IDMedia Session Server TimeoutMedia Time SpentPause EventsPause Impacted StreamsPev3PccrTotal Pause DurationUnique Time Played以及Video Segment

    3. 選取​ 確認 ​以儲存變更。

    4. 在​ 結構 ​區域中,啟用選項​顯示欄位顯示名稱,然後選取List Of Media Collection Downloaded Content Events欄位。

    5. 選取​管理相關欄位,然後依照下列方式更新結構描述:

      • List Of Media Collection Downloaded Content Events > Media Details > Advertising Details欄位中,隱藏下列報告欄位: Ad CompletedAd StartedAd 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 CompletedChapter IDChapter StartedChapter 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 EndMedia Collection Details > List Of States Start欄位中,隱藏下列報告欄位: Player State CountPlayer State SetPlayer State Time

      • List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details欄位中,隱藏下列報告欄位: Average BitrateAverage Bitrate BucketBitrate Change Impacted StreamsBitrate ChangesBuffer EventsBuffer Impacted StreamsDrops Before StartsDropped Frame Impacted StreamsError Impacted StreamsErrorsExternal Error IDsMedia SDK Error IDsPlayer SDK Error IDsStalling EventsStalling Impacted StreamsTotal Buffer Duration以及Total Stalling Duration

      • List Of Media Collection Downloaded Content Events > Media Details > Session Details欄位中,隱藏下列報告欄位: 10% Progress Marker25% Progress Marker50% Progress Marker75% Progress Marker95% Progress MarkerAd CountAverage Minute AudienceChapter CountContent CompletesContent StartsContent Time SpentEstimated StreamsFederated DataMedia Downloaded FlagMedia Segment ViewsMedia Session IDMedia Session Server TimeoutMedia StartsMedia Time SpentPause EventsPause Impacted StreamsPccrPev3Total Pause DurationUnique Time PlayedVideo Segment

      • List Of Media Collection Downloaded Content Events > Media Details欄位中,隱藏Media Session ID欄位。

    6. 選取​ 確認 ​以儲存變更。

    7. 在​ 結構 ​區域中,選取Media Reporting Details欄位,然後選取​管理相關欄位

    8. 啟用選項​ 顯示欄位 ​的顯示名稱,然後更新結構描述,如下所示:

      • Media Reporting Details欄位中,隱藏下列欄位: Error DetailsList Of States EndList of States StartMedia Session ID
    9. 選取​確認 > 儲存​以儲存變更。

  8. (選用)您可以將自訂中繼資料新增到結構描述。 這可讓您針對特定需求或內容包含其他使用者定義的中繼資料。 如需使用Media Edge API自訂中繼資料的詳細資訊,請參閱自訂中繼資料支援

    accordion
    展開以檢視將自訂中繼資料新增至結構描述的指示。
    1. 選取​帳戶資訊 > 指派的組織 > 組織名稱 > 租使用者,以找出組織的租使用者名稱稱。

      透過此路徑接收自訂欄位。 (例如,租使用者名稱稱: _dcbl → myCustomField路徑: _dcbl.myCustomField。)

    2. 新增自訂欄位群組至您定義的媒體結構描述。

      add-custom-metadata

    3. 將您想要追蹤的任何自訂欄位新增至欄位群組。

      add-custom-metadata

    4. 使用產生的路徑作為要求承載中的自訂欄位。

      add-custom-metadata

在 Adobe Experience Platform 中建立資料集

  1. 在Adobe Experience Platform中,依照資料集UI指南中的說明開始建立資料集。

    為資料集選取結構描述時,請選擇您先前建立的結構描述。

在Adobe Experience Platform中設定資料串流

  1. 設定資料流中所述,建立新的資料流。

    建立資料串流時,請進行下列選擇:

    • 在​ 事件結構描述 ​欄位中,選取您在中建立的結構描述。在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)

      新增Adobe Analytics服務

    • 展開​進階選項,然後啟用​ Media Analytics ​選項。

      Media Analytics選項

選擇您的實作方法

在準備好結構、資料集和資料流後,實作下列其中一個程式碼庫,以開始將串流媒體資料傳送到Edge Network。 每個頁面都涵蓋串流媒體特定的設定;每個事件和每個變數的程式碼都存在於事件變數中。

程式碼內​實作會直接在應用程式原始碼中寫入SDK呼叫。 使用標籤​實作使用Adobe Experience Platform標籤,可讓您設定及部署追蹤規則,而不需修改應用程式程式碼。 選擇適合您的部署工作流程的方法。

程式碼基底
程式碼內
使用標籤
Web
Web SDK
Web SDK標籤延伸模組
iOS
iOS
iOS (標籤)
Android
Android
Android (標籤)
Roku
Roku Edge
API
Media Edge API

下一步

開始收集資料後,您可以設定報表:

recommendation-more-help
media-analytics-help