文件AEM 6.5Communities 指南

社群功能的Analytics設定 analytics-configuration-for-communities-features

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員

概觀 overview

Adobe Analytics和Adobe Experience Manager (AEM)都是Adobe Experience Cloud的解決方案。

Adobe Analytics可針對AEM Communities進行設定，以便在成員與支援的Communities功能互動時，事件會傳送至Adobe Analytics，以便產生報表。

例如，管理員可從社群網站檢視有關視訊播放的各種報表。

此外，以下作業還需要分析：

支援的Communities功能包括：

本檔案本節說明如何連結Analytics報表套裝與Communities功能。 基本步驟為：

  1. 復寫加密金鑰，以便確保所有AEM執行個體上都能正確進行加密/解密

  2. 準備Adobe Analytics 報告套裝

  3. 建立AEM Analytics 雲端服務和架構

  4. 為社群網站啟用Analytics

  5. 驗證 Analytics與AEM變數的對應

  6. 識別主要發行者

  7. Publish社群網站

  8. 設定將報告資料從Adobe Analytics匯入至社群網站

先決條件 prerequisites

若要設定Analytics for Communities功能，您必須與帳戶代表合作，以設定Adobe Analytics帳戶和報表套裝。 建立後，應會提供下列資訊：

  • 公司名稱

    與Adobe Analytics帳戶關聯的公司。

  • 使用者名稱

    有權管理Analytics帳戶之使用者的登入使用者名稱
    （應該包含Web服務存取許可權）。

  • 密碼

    授權使用者的登入密碼。

  • Analytics資料中心

    帳戶的Analytics資料中心URL。

  • 報告套裝

    要使用的Analytics報表套裝名稱。

適用於視訊報表的Adobe Analytics報表套裝 adobe-analytics-report-suite-for-video-reporting

使用Adobe Experience Cloud的報表套裝管理員，可以設定Analytics報表套裝，以便啟用社群網站來提供Communities功能的報告。

使用公司名稱和使用者名稱登入Adobe Experience Cloud後，即可設定新的或現有的報表套裝：

  • 11個轉換變數 (eVar)

    • evar1 ​到​ evar11 ​已啟用

    • 可以重新利用（重新命名）現有的eVar，或建立要用於Communities功能的專案

  • 7個成功事件 （個事件）

    • event1 ​到​ event7 ​已啟用

    • 型別​ Counter

      • 不是​ Counter (no subrelations)

    • 可以重新利用（重新命名）現有事件，或建立用於Communities功能的事件

  • 視訊管理

    • 視訊報表主控台

      • 啟用Video Core
      • 選取儲存

    • 視訊核心測量主控台

      • 選取Use Solution Variables
      • 選取儲存

如果使用​ 新報表套裝，則新報表套裝可能只有4個evar和6個事件變數，而Communities則需要11個evar和7個事件變數。

如果使用​ 現有的報表套裝，在啟用社群網站的Analytics架構之前，可能需要修改變數對應。

如有關於社群專用變數的疑慮，請聯絡您的客戶代表。

CAUTION
如果使用已在 ​內使用變數的現有報表套裝

  • evar1 ​透過​**evar11**

  • event1 ​透過​**event7**

在發佈社群網站之前， ​請務必移動在社群網站啟用Analytics時自動對應至Analytics變數的AEM變數，以還原預先存在的對應。
若要還原先前存在的對應，並將AEM變數移至其他Analytics變數，請參閱修改Analytics變數對應一節。
若未這麼做，可能會導致無法復原的資料遺失。

影片心率分析 video-heartbeat-analytics

在授權Video Heartbeat Analytics時，會指派Marketing Cloud Org Id。

若要在為視訊報表設定Analytics報表套裝後啟用視訊心率報表：

修改社群網站屬性，可在社群網站建立或更新版本時輸入Marketing Cloud Org Id。

marketing-org-id

啟用視訊心率Analytics時，視訊播放器的JavaScript (JS)程式碼會例項化視訊心率程式庫程式碼（同樣在JS中）。 程式碼會處理每10秒將視訊狀態更新傳送至Analytics視訊追蹤伺服器的所有邏輯（無法設定）。 最後，影片會將視訊工作階段的累積報表傳送至主要Analytics伺服器。

若未啟用，視訊心率程式碼永遠不會例項化，而且只有視訊進度和恢復位置追蹤會儲存至SRP以供報告。

AEM Analytics Cloud服務設定 aem-analytics-cloud-service-configuration

若要建立Analytics整合，即使用作者例項上的標準UI，將Adobe Analytics與AEM社群網站整合：

  • 從全域導覽： 工具 > 部署 > Cloud Service
  • 向下捲動至​ Adobe Analytics
  • 選取​ 立即設定 ​或​ 顯示設定

雲端設定

建立設定對話方塊 create-configuration-dialog

  • 選取​ 可用組態 ​旁的[+]圖示，以便您建立組態。

在「建立組態」對話方塊中，要輸入的值可識別組態。

create-cloud-config

  • 標題

    （必要）設定的顯示標題。
    例如，輸入 社群分析

  • 名稱

    （選擇性）如果未指定，則名稱會預設為從標題衍生的有效節點名稱。
    例如，輸入 communities

  • 範本

    選取Adobe Analytics Configuration

  • 選取​ 建立

    • 啟動設定頁面並開啟Analytics Settings對話方塊

Analytics設定對話方塊 analytics-settings-dialog

首次建立新的Analytics設定後，系統會顯示設定並顯示Analytics設定專案的新對話方塊。 此對話方塊需要從帳戶代表取得的必要帳戶資訊。

分析設定

  • 公司

    與Adobe Analytics帳戶關聯的公司。

  • 使用者名稱

    有權管理Analytics帳戶之使用者的登入使用者名稱。

  • 密碼

    授權使用者的登入密碼。

  • 資料中心

    選取託管報表套裝的Analytics資料中心。

  • 不要新增追蹤標籤至頁面

    保留為預設值（取消選取）。

  • 使用AppMeasurement

    保留為預設值（取消選取）。

  • 不要每晚匯入頁面印象（作者）

    保留為預設值（取消選取）。

  • 不要每晚匯入頁面印象（發佈）

    保留為預設值（取消選取）。

若要儲存設定：

  • 選取​ 連線至Analytics

    • 如果未成功，

      • 確認專案不包含前置空格。
      • 嘗試不同的資料中心。

  • 選取​ 確定。

    分析設定

建立框架 create-framework

成功設定Adobe Analytics的基本連線後，需要建立或編輯社群網站的架構。 此架構的目的是將Communities功能(AEM)變數對應至Analytics （報表套裝）變數。

  • 選取​ 可用架構 ​旁的[+]圖示，以便您建立架構。

    analytics-framework

  • 標題

    （必要）框架的顯示標題
    例如，輸入 社群架構。

  • 名稱

    （選擇性）如果未指定，則名稱會預設為從標題衍生的有效節點名稱。
    例如，輸入 communities。

  • 範本

    選取Adobe Analytics Framework。

  • 選取「建立」。

建立Analytics框架會開啟框架以進行設定。

AEM Analytics框架設定 aem-analytics-framework-configuration

此架構的目的是將AEM變數對應至Analytics變數（eVar和事件）。 可用於對應的Analytics變數是在報表套裝中定義。

analytics-framework

選取報表套裝 select-report-suite

選取已針對視訊報表設定的報表套裝。

如果報表套裝尚未建立或設定不正確，請參閱上一節：
用於視訊報表的Adobe Analytics報表套裝

Sidekick不是必要專案，且可以最小化，這樣就不會阻礙報表套裝設定的存取。

選取「新增專案」之前和之後的報表套裝對話方塊 report-suites-dialog-before-and-after-selecting-add-item

報告套裝

  1. 選取​ 新增專案+。

    兩個下拉式方塊隨即顯示。

  2. 選擇Report suite.

    與公司帳戶相關聯的報表套裝可供選取。

  3. 在開啟的對話方塊中選取​ 是：

    code language-none 
    Load default server settings?
 Do you want to load the default server settings and overwrite current values in the Server section?

  4. 選擇Run Mode。

  5. 選取「發佈」。

analytics-framework2

Analytics雲端服務與架構現已完成。 在啟用此Analytics服務的情況下建立社群網站後，就會定義對應。

為社群網站啟用Analytics enable-analytics-for-a-community-site

為新社群網站啟用 enable-for-new-community-site

若要在建立社群網站時新增Analytics Cloud服務：

  • 在步驟3的ANALYTICS標籤下：

    • 選取​ 啟用Analytics ​核取方塊。
    • 從下拉式方塊中選取架構。

  • 或者返回Analytics框架設定以調整變數對應。

為現有的社群網站啟用 enable-for-existing-community-site

若要將Analytics Cloud服務新增至現有的社群網站：

  • 導覽至​ 社群>網站 ​主控台。

  • 選取社群網站的「編輯網站」圖示。

  • 選取「設定」。

  • 在Analytics區段中：

    • 選取​ 啟用Analytics ​核取方塊。
    • 從下拉式方塊中選擇架構。

  • 或者返回Analytics框架設定以調整變數對應。

為自訂網站啟用 enable-for-customized-sites

若要讓Analytics追蹤和匯入功能在社群網站中正常運作，必須存在具有scf-js-site-title類別和href屬性的頁面元素。 頁面上只能有一個這樣的元素，例如它會在社群網站未修改的sitepage.hbs指令碼中。 siteUrl的值已擷取並傳送至Adobe Analytics做為​ 網站路徑。

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

對於覆蓋sitepage.hbs指令碼的​ 自訂社群網站，請確定元素存在。 siteUrl變數是在伺服器上轉譯時設定，然後才提供給使用者端。

對於包含Communities元件但不是使用網站建立精靈建立的​ 一般AEM網站，必須新增元素。 href的值應為網站的路徑。 例如，如果網站路徑為/content/my/company/en，則使用：

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Analytics for Communities功能 analytics-for-communities-features

Analytics會自動用於數個Communities功能。

作者環境的OSGi設定 AEM Communities Analytics Component Configuration提供已針對Analytics檢測的元件清單。 變數的自動對應是由列出的元件所決定。

如果建立了針對Analytics檢測的新自訂元件，應將其新增到此已設定元件清單中。

元件組態 component-configuration

元件組態1

NOTE
日誌元件可用來實作部落格功能。

將Analytics對應至AEM變數 mapped-analytics-to-aem-variables

社群網站儲存後，在啟用Analytics並選取雲端設定架構的情況下，AEM變數會自動對應至Analytics eVar和事件。 它分別從evar1和event1開始，並增加1。

如果使用對evar1到evar11以及event1到event7的任何變數的現有報表套裝，則必須重新對應AEM變數並還原原始對應。

以下是預設對應的範例：

地圖 — 分析

隨每個事件傳送的eVar地圖 map-of-evars-sent-with-each-event

啟用
資源
型別
網站
標題
函式
型別
群組
標題
群組
路徑
UGC
型別
UGC
標題
使用者
（成員）
UGC
路徑
網站
路徑
EVAR1
EVAR2
EVAR3
EVAR4
EVAR5
EVAR6
EVAR7
EVAR8
EVAR9
eVar10
event1
資源播放
(a)
-
-
-
-
-
-
-
(i)
-
事件2
SCFView
(a)
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)
事件3
SCFCreate (Post)
-
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)
事件4
SCFFollow
-
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)
event5
SCFVoteUp
-
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)
event6
SCFVoteDown
-
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)
事件7
SCFRate
-
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)

eVar值的​ 範例：

  • MIME型別： video/mp4

  • 社群網站標題：Geometrixx社群

  • 社群功能名稱：論壇

  • 社群群組名稱：健行

  • 社群群組內容的路徑： /content/sites/<site name>/en/groups/hiking

  • UGC元件resourceType： social/forum/components/hbs/topic

  • UGC元件標題：健行主題

  • 登入(authorizableId)： aaron.mcdonald@mailinator.com

  • UGC的SRP路徑： /content/usergenerated/asi/.../forum/jmtz-topic3
    或 要追蹤的元件路徑： /content/sites/<site name>/en/jcr:content/content/primary/forum

  • 社群網站內容的路徑： /content/sites/<site name>/en

修改Analytics變數對映 modifying-analytics-variable-mapping

為社群網站啟用Analytics後，可從框架設定中看見Analytics eVar和事件到AEM變數的對應。

啟用Analytics之後以及發佈社群網站之前，可能會在框架中變更對應。 只要從左側邊欄拖曳所需的Analytics Evar或事件，並將它拖曳至對應表格中的相關列。

若要避免重複的對應，請務必從列移除取代的Analytics變數或事件，方法是暫留在該列上，並選取顯示在Analytics變數元素右側的「X」。

如果Communities eVar和事件覆寫報表套裝中預先存在的對應，則為避免資料遺失，請將Communities功能的AEM變數指派給其他Analytics eVar或事件，並還原原始對應。

CAUTION
在社群網站為已發佈且已啟用Analytics之前，請務必重新對應，否則會有資料遺失的風險。

範例步驟1：將Analytics evar14拖曳至對應表格 example-step-dragging-analytics-evar-into-mapping-table

analytics-mapping-evar

範例步驟2：選取「x」以移除取代的evar11 example-step-selecting-x-to-remove-replaced-evar

analytics-mapping-evar1

範例步驟3：將AEM var eventdata.siteId重新對應至Analytics evar14 example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

analytics-mapping-evar2

發佈社群網站 publishing-the-community-site

驗證Analytics與AEM變數的對應 verify-analytics-to-aem-variable-mapping

明智的做法是在發佈社群網站(也會發佈Analytics Cloud服務和架構)之前驗證變數對應。

請參閱以下小節：

CAUTION
如果使用已在 ​內使用變數的現有報表套裝

  • evar1 ​透過​**evar11**

  • event1 ​透過​**event7**

在發佈社群網站之前， ​請先還原現有的對應。 將自動對應的Communities AEM變數（社群網站啟用Analytics時）移至其他Analytics變數。 所有Communities元件之間均應一致進行此重新對應。
若未這麼做，可能會導致無法復原的資料遺失。

主要發行者 primary-publisher

當選擇的部署是發佈伺服器陣列時，必須將一個AEM發佈執行個體識別為輪詢Adobe Analytics以寫入至SRP的報告資料的主要發佈者。

根據預設，AEM Communities Publisher Configuration OSGi設定會將其發佈執行個體識別為主要發佈者，這樣發佈伺服器陣列中的所有發佈執行個體都會自行識別為主要發佈者。

因此，必須編輯所有次要發佈執行個體的組態，以取消選取​ 主要發佈者 ​核取方塊。

如需特定指示，請參閱部署社群的主要發行者區段。

CAUTION
請務必設定主要發佈程式，以防止從多個發佈執行個體進行輪詢。

復寫加密金鑰 replicate-the-crypto-key

Adobe Analytics憑證已加密。 為了便於作者和發佈者之間複製或傳輸加密的分析憑證，所有AEM執行個體都必須共用相同的主要加密金鑰。

若要這樣做，請依照復寫加密金鑰中的指示進行。

Publish社群網站與Analytics Cloud服務 publish-community-site-and-analytics-cloud-service

為社群網站啟用Analytics Cloud服務，並在必要時調整Analytics至AEM變數的對應後，透過（重新發佈社群網站）將設定復寫至發佈環境。

從Analytics取得報表 obtaining-reports-from-analytics

報告管理 report-management

作者和主要發行者的OSGi設定 AEM Communities Analytics Report Management是用來查詢Analytics。

對於作者，查詢用於即時報表。

在主要發佈者上，會使用查詢來提供資訊，以準備Report Importer的分析資料匯入。

查詢間隔預設為10秒。

報告匯入工具 report-importer

啟用Analytics的社群網站發佈後，主要發行者的OSGi設定 AEM Communities Analytics Report Importer可能會設定為在CRXDE中未個別設定的這些設定設定設定預設輪詢間隔。

輪詢間隔會控制向Adobe Analytics請求提取資料並儲存至SRP的頻率。

當資料可能被分類為「巨量資料」時，更頻繁的輪詢可能會對社群網站造成大量負載。

預設輪詢​ 匯入間隔 ​設定為12小時。

report-importer

元件報表自訂 component-report-customization

目前，為了自訂要追蹤的量度，在存放庫中建立節點，定義要產生該量度報表的時間期間。

論壇主題是目前此自訂的唯一範例：

  • 在主要發行者上，以管理許可權登入。

  • 瀏覽至CRXDE Lite。 例如，https://localhost:4503/crx/de。

  • 在語言根目錄的jcr:content節點下（例如/content/sites/engage/en/jcr:content），導覽至為Analytics報表設定的元件。
    例如 analytics/reportConfigs/social_forum_components_hbs_topic

  • 請注意已建立的時間週期：

    • last30Days
    • last90Days
    • thisYear

  • 注意total節點。

    • 修改​ interval ​屬性會覆寫Report Importer間隔。
    • 該值以秒為單位，並設為四小時(14400秒)。

元件報告

在Analytics中管理使用者資料 manage-user-data-in-analytics

Adobe Analytics提供的API可讓您存取、匯出和刪除使用者資料。 如需詳細資訊，請參閱提交存取及刪除要求。

資源 resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791