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

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 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. 選取​ 確認 > 儲存 ​以儲存變更。

  1. (選用)您可以將自訂中繼資料新增到結構描述。 這可讓您包含其他使用者定義的中繼資料,這些中繼資料可以根據特定需求或內容進行自訂。 若現有結構描述未涵蓋所需的資料點,此彈性就相當實用。 (您也可以搭配Media Edge API使用自訂中繼資料。 如需詳細資訊,請參閱使用Media Edge API建立自訂中繼資料
展開此處以檢視如何新增自訂中繼資料至結構描述的指示。
  1. 選取​ 帳戶資訊 > 指派的組織 > 組織名稱 > 租使用者,以找出組織的租使用者名稱稱。

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

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

    add-custom-metadata

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

    add-custom-metadata

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

    add-custom-metadata

  1. 繼續在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 APIMedia Edge SDK,以開始收集媒體分析資料。

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

在 Customer Journey Analytics 中建立連線

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
只有在使用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. (視條件而定)如果您將自訂中繼資料新增至結構描述,如在Adobe Experience Platform中設定結構描述中的步驟8所述,則您需要為自訂欄位設定持續性,如Customer Journey Analytics指南中的持續性元件設定所述。

    當資料到達Customer Journey Analytics時,將可使用自訂使用者ID維度。

    設定 — 自訂中繼資料

    note note
    NOTE
    如果您將Adobe Analytics設定為您的資料串流的上游,自訂中繼資料也會出現在ContextData中,其名稱為您在結構描述中設定(沒有租使用者首碼,例如myCustomField)。 這可讓您使用所有可用於ContextData的Adobe Analytics功能,例如建立處理規則
  7. 依照共用專案中的說明共用專案。

    note note
    NOTE
    如果您想要共用的使用者無法使用,請確定使用者擁有在Adobe Admin Console中Customer Journey Analytics的使用者和管理員存取權。
  8. 繼續傳送資料至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