文件Analytics串流媒體收集指南

使用Edge Network實作串流媒體收集附加元件

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined
  • undefined

Adobe Experience Platform Edge Network 可讓您將預計要送給多個產品的資料傳送到一個集中位置。Experience Edge 會將適當的資訊轉送給所需的產品。 此概念可讓您整合實施工作，特別是橫跨多個資料解決方案時。

下圖說明如何實作Adobe串流媒體收集附加元件，以使用Experience Platform Edge在Adobe Analytics或Customer Journey Analytics中讓資料可在Analysis Workspace中使用：

CJA 工作流程

如需所有實作選項的概觀，包括不使用Experience PlatformEdge的實作方法，請參閱實作串流媒體收集附加元件。

無論您是使用Adobe Experience Platform Web SDK、Adobe Experience Platform Mobile SDK、Adobe Experience Platform Roku SDK或API來透過Experience Edge實作串流媒體收集附加元件，您都必須先完成下列章節：

在Adobe Experience Platform中設定結構

為了標準化資料彙集以跨利用 Adobe Experience Platform 的應用程式使用，Adobe 建立了開放且公開記錄標準，即體驗資料模型 (XDM)。

若要建立及設定綱要：

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

  2. 在建立結構描述時，請在[結構描述詳細資訊]頁面上，為結構描述選擇基底類別時，選擇​ 體驗事件。

    已新增欄位群組

  3. 選取​ 「下一步」。

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

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

    • Adobe Analytics ExperienceEvent Template
    • Implementation Details
    • MediaAnalytics Interaction Details

    新增欄位群組後，它們應該顯示在​ 欄位群組 ​區段中，如下所示：

    已新增欄位群組

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

  7. （選用）您可以隱藏Media Edge API未使用的特定欄位。 隱藏這些欄位可讓結構描述更容易閱讀和理解，但並非必要。 這些欄位僅參考MediaAnalytics Interaction Details欄位群組中的欄位。

展開此處以檢視可隱藏欄位的指示。

  1. 在​ 結構 ​區域中，選取Media Collection Details欄位，然後選取​ 管理相關欄位。

    管理相關欄位

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

    • 在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。

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

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

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

    • 在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欄位。

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

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

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

    • 在Media Reporting Details欄位中，隱藏下列欄位： Error Details、List Of States End、List of States Start和Media Session ID。

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

  10. 繼續在Adobe Experience Platform中建立資料集。

在Adobe Experience Platform中建立資料集

  1. 請確定您已依照在Adobe Experience Platform中設定結構描述中的說明設定結構描述。

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

    為資料集選取結構描述時，請選擇您先前建立的結構描述，如在Adobe Experience Platform中設定結構描述中所述。

  3. 繼續在Customer Journey Analytics中設定資料串流。

在Adobe Experience Platform中設定資料串流

  1. 請確定您已按照在Adobe Experience Platform中建立資料集中的說明建立資料集。

  2. 如設定資料流中所述，建立新的資料流。

    建立資料串流時，請務必選取下列設定：

    • 在建立資料流時，請在​ 事件結構描述 ​欄位中，確定您選取您在中建立的結構描述。在Adobe Experience Platform中設定結構描述。 選取「儲存」。

      note important
      IMPORTANT
      不要選取 儲存並新增對應，因為這樣做會導致Timestamp欄位的對應錯誤。

      建立資料流並選取結構描述

    • 根據您使用的是Adobe Analytics還是Customer Journey Analytics，將以下任一服務新增至資料流：

      • Adobe Analytics (若使用Adobe Analytics)

        如果您使用Adobe Analytics，請務必定義報表套裝，如建立報表套裝中所述。

      • Adobe Experience Platform (若使用Customer Journey Analytics)

      如需有關如何將服務新增至資料串流的資訊，請參閱設定資料串流中的「將服務新增至資料串流」區段。

      新增Adobe Analytics服務

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

      Media Analytics選項

  3. 您現在已準備好實作Media Edge API或Media Edge SDK，以開始收集媒體分析資料。

    收集一些資料之後，您可以在Customer Journey Analytics中建立連線。

在 Customer Journey Analytics 中建立連線

note note
NOTE
只有在使用Customer Journey Analytics時，才需要執行下列程式。

  1. 請確定您已建立資料串流，如在Customer Journey Analytics中設定資料串流中所述。

  2. 在Customer Journey Analytics中建立連線，如建立連線中所述。

    建立連線時，實作串流媒體收集附加元件需要下列設定選擇：

    1. 選取您先前建立的資料集，如在Adobe Experience Platform中建立資料集中所述。

    2. 確定已啟用​ 匯入所有新資料 ​設定。

  3. 繼續在Customer Journey Analytics中建立資料檢視。

在Customer Journey Analytics中建立資料檢視

note note
NOTE
只有在使用Customer Journey Analytics時，才需要執行下列程式。

  1. 請確定您已按照在Customer Journey Analytics中建立連線中的說明在Customer Journey Analytics中建立連線。

  2. 在Customer Journey Analytics中，依照建立或編輯資料檢視中的說明建立資料檢視。

    建立資料檢視時，實作串流媒體收集附加元件需要以下設定選擇：

    1. 在​ 連線 ​欄位中，選取您先前建立的連線，如在Customer Journey Analytics中建立連線中所述。

      您建立的連線最長可能需要15分鐘才能選取。

    2. 在​ 元件 ​標籤的​ 結構描述欄位 ​區段中，搜尋下清單格中列出的每個元件，並將其拖曳至​ 量度 ​面板。 如果存在多個相同名稱的欄位，請使用XDM路徑來確保它是正確欄位。

      主要內容 — 內容量度

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
      元件名稱 XDM 路徑
      媒體開始次數 mediaReporting.sessionDetails.isViewed
      媒體區段檢視次數 mediaReporting.sessionDetails.hasSegmentView
      內容開始 mediaReporting.sessionDetails.isPlayed
      內容完成 mediaReporting.sessionDetails.isCompleted
      內容逗留時間 mediaReporting.sessionDetails.timePlayed
      媒體逗留時間 mediaReporting.sessionDetails.totalTimePlayed
      不重複播放時間 mediaReporting.sessionDetails.uniqueTimePlayed
      10% 進度標記 mediaReporting.sessionDetails.hasProgress10
      平均每分鐘對象數 mediaReporting.sessionDetails.averageMinuteAudience

      章節與廣告 — 章節與廣告量度

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
      元件名稱 XDM 路徑
      章節已開始 mediaReporting.chapterDetails.isStarted
      章節已完成 mediaReporting.chapterDetails.isCompleted
      章節時間已播放 mediaReporting.chapterDetails.timePlayed
      廣告開始 mediaReporting.advertisingDetails.isStarted
      廣告完成 mediaReporting.advertisingDetails.isCompleted
      廣告播放時間 mediaReporting.advertisingDetails.timePlayed

      QoE - QoE量度

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2
      元件名稱 XDM 路徑
      開始時間 mediaReporting.qoeDataDetails.timeToStart
      開始前掉格 mediaReporting.qoeDataDetails.isDroppedBeforeStart
      緩衝影響的資料流 mediaReporting.qoeDataDetails.hasBufferImpactedStreams
      位元速率變更影響的資料流 mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
      位元速率變更 mediaReporting.qoeDataDetails.bitrateChangeCount
      平均位元速率 mediaReporting.qoeDataDetails.bitrateAverage
      掉格 mediaReporting.qoeDataDetails.droppedFrames
      錯誤 mediaReporting.qoeDataDetails.errorCount
      錯誤影響的資料流 mediaReporting.qoeDataDetails.hasErrorImpactedStreams
      掉格影響的資料流 mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

      播放器狀態 — 播放器狀態量度

      table 0-row-2 1-row-2 2-row-2 3-row-2
      元件名稱 XDM 路徑
      播放器狀態集 mediaReporting.states.isSet
      播放器狀態計數 mediaReporting.states.count
      播放器狀態時間 mediaReporting.states.time

    3. 更新下表中元件的標籤（在​ 內容標籤 ​下拉式功能表中）。 搜尋並拖曳量度面板中尚未的任何元件至面板。

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
      元件名稱 內容標籤
      媒體工作階段伺服器逾時 媒體：自上次呼叫以來的秒數
      媒體逗留時間 媒體：媒體逗留時間
      總緩衝期間 媒體：總緩衝期間
      開始時間 媒體：開始時間
      總暫停期間 媒體：總暫停期間

    4. 若要將劃分加入您的Customer Journey Analytics專案，請將下列維度新增至「Dimension」面板：

      table 0-row-2 1-row-2 2-row-2
      XDM 路徑 元件名稱
      mediaReporting.states.name 播放器狀態名稱
      mediaReporting.sessionDetails.ID 媒體工作階段 ID

      除了此表格中的維度外，您也可以新增任何其他維度，以便用於在Customer Journey Analytics專案中篩選資料。

  3. 選取「儲存並繼續」>「 ​儲存並完成」以儲存您的變更。

  4. 繼續在Customer Journey Analytics中建立並設定專案。

在Customer Journey Analytics中建立及設定專案

  1. 請確定您已按照在Customer Journey Analytics中建立資料檢視中的說明在Customer Journey Analytics中建立資料檢視。

  2. 在Customer Journey Analytics的​ Workspace ​索引標籤的​ 專案 ​區域中，選取​ 建立專案。

  3. 選取​ 空白專案 > 建立。

  4. 在新專案中，選取您先前建立的資料檢視。

    在專案中建立面板時，您可以使用新增至資料檢視的任何元件，如在Customer Journey Analytics中建立資料檢視中所述。

    下列4個面板是您可以建立的面板範例：

    主要內容面板

    章節和廣告面板

    QoE面板

    平板狀態面板

  5. 選取左側邊欄中的​ 面板 ​圖示，然後拖曳至​ 媒體同時檢閱者 ​面板和​ 媒體播放時間 ​面板。

    這2個面板看起來應該像這樣：

    媒體同時檢閱者面板

    媒體播放時間面板

  6. 依照共用專案中的說明共用專案。

    note note
    NOTE
    如果您想要共用的使用者無法使用，請確定使用者擁有在Adobe Admin Console中Customer Journey Analytics的使用者和管理員存取權。

  7. 繼續傳送資料至Experience PlatformEdge。

傳送資料至Experience PlatformEdge

根據您要傳送至Experience PlatformEdge的資料型別，您可以使用下列任一方法：

Web：使用Adobe Experience Platform Web SDK

行動：使用Adobe Experience Platform Mobile SDK

使用下列檔案資源來完成iOS和Android的實作：

Roku：Adobe Experience Platform Roku SDK

API：網頁及其他

此API是目前唯一支援將網路資料傳送至Experience Platform Edge的方式。

如果您想要使用Edge API的自訂實作，也可使用此API。

如需Media Edge API的詳細資訊，請參閱下列資源：

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb