Communities功能的Analytics設定

概覽

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

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

例如，當啟用社群網站的成員檢視指派給他們的視訊資源時，資源播放器會將事件傳送至Analytics，包括視訊心率資料。 從社群網站，管理員可以查看有關播放視訊的各種報表。

此外，對於以下情況，也需要分析：

• 在發佈環境中：

  • 關於社群趨勢的報告
  • 允許網站訪客依「檢視次數最多」、「最活躍」、「最喜歡」排序
  • 查看UGC清單上的計數

• 在製作環境中：

  • 在成員管理控制台中顯示參與率資料（檢視、貼文、後續、按贊）
  • 啟用資源報表的趨勢摘要、視訊心率和視訊裝置

支援的社群功能包括：

• 啟用資源
• 論壇
• QnA
• 部落格
• 檔案庫
• 日曆

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

1. 複製加密密 鑰以確保在所有AEM實例上正確進行加密/解密
2. 準備Adobe Analytics 報表套裝
3. 建立AEM Analytics 雲端服務和framework
4. 為社 群網站啟用分析
5. 🔗 驗證AEM與Analytics變數的對應
6. 識別主要發佈者
7. 🔗 發佈社群網站
8. 設定從Adobe Analytics匯入報表資料至社群網站

必備條件

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

• 公司名稱

  與Adobe Analytics帳戶相關聯的公司

• 使用者名稱

  獲授權管理Analytics帳戶之使用者的登入使用者名稱

  （應包含網站服務存取權限）

• 密碼

  授權用戶的登錄密碼

• Analytics資料中心

  帳戶的Analytics資料中心URL

• 報表套裝

  要使用的Analytics報表套裝名稱

Adobe Analytics視訊報表報表套裝

使用Adobe Marketing Cloud的報表套裝管理器，即可設定Analytics報表套裝，讓社群網站能夠提供社群功能的報表。

透過公司名稱和使用者名稱登入Adobe Marketing Cloud，即可設定新或現有的報表套裝，使其具備：

• 11轉換變數 (evar)

  • evar1 啟用 evar11
  • 可以重新使用（重新命名）現有的eVar，或建立新eVar以用於Communities功能

• 7成功事件 （事件）

  • event1 啟用 event7

  • 類型 Counter

    • 非 Counter (no subrelations)

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

• 視訊管理

  • 視訊報表主控台

    • 啟用 Video Core
    • 選擇保存

  • 視訊核心測量主控台

    • 選取 Use Solution Variables
    • 選擇保存

若使用​新的報表套裝，請注意，新的報表套裝可能只有4個eVar和6個事件變數，而Communities則需有11個eVar和7個事件變數。

若使用​現有報表套裝，則在啟用社群網站的Analytics架構之前，可能需要修改變數對應。 如對社群專用變數有任何疑慮，請連絡您的客戶代表。

視訊心率分析

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

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

• 建立Analytics雲端服務
• 為社群網站啟用Analytics
• 將Marketing Cloud Org Id與社區站點關聯

Marketing Cloud Org Id可在社區站點建立時或更後通過修改社區站點屬性來輸入。🔗

啟用視訊心率分析時，視訊播放器的Javascript(JS)程式碼會實例化視訊心率程式庫程式碼（亦在JS中），其會處理每10秒傳送視訊狀態更新至Analytics視訊追蹤伺服器（不可設定）的所有邏輯，並最終傳送視訊工作階段的累積報表至主要Analytics伺服器。

若未啟用，視訊心率程式碼將不會具現化，且只會將視訊進度和繼續位置追蹤保存至SRP以供報告。

AEM Analytics Cloud服務設定

若要使用製作執行個體上的標準UI，建立整合Adobe Analytics與AEM社群網站的新Analytics整合：

• 從全局導航：工具>部署>Cloud Services
• 向下捲動至​Adobe Analytics
• 選擇「立即配置」或「顯示配置」

建立配置對話框

• 選擇​可用配置​旁的[+]表徵圖以建立新配置

在「建立配置」對話框中，要輸入的值標識配置。

• 標題

  （必要）設定的顯示標題。

  例如，輸入​啟用社群分析

• 名稱

  （可選）如果未指定，則名稱將預設為從標題派生的有效節點名稱。

  例如，輸入​communities

• 範本

  選取 Adobe Analytics Configuration

• 選擇​建立

  • 啟動配置頁並開啟Analytics Settings對話框

Analytics設定對話方塊

初始建立新Analytics設定時，會顯示設定，並顯示新對話方塊，供您輸入Analytics設定。 此對話框要求從帳戶代表處獲取必備帳戶資訊。

• 公司

  與Adobe Analytics帳戶相關聯的公司

• 使用者名稱

  獲授權管理Analytics帳戶之使用者的登入使用者名稱

• 密碼

  授權用戶的登錄密碼

• 資料中心

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

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

  保留為預設值（未勾選）

• 使用 AppMeasurement

  保留為預設值（未勾選）

• 不要每晚匯入頁面印象 (作者)

  保留為預設值（未勾選）

• 不要每晚匯入頁面印象 (發佈)

  保留為預設值（已勾選）

若要儲存設定：

• 選取​連線至Analytics

  • 若未成功，

    • 驗證條目是否包含前導空格
    • 嘗試其他資料中心
    • 請連絡您的客戶代表

• 選擇​OK

建立框架

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

• 選擇​可用框架​旁的[+]表徵圖以建立新框架

• 標題

  （必要）架構的顯示標題

  例如，輸入​啟用社群架構

• 名稱

  （可選）如果未指定，則名稱將預設為從標題派生的有效節點名稱。

  例如，輸入​communities

• 範本

  選取 Adobe Analytics Framework

• 選擇​建立

建立Analytics架構會開啟設定的架構。

AEM Analytics架構設定

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

選取報表套裝

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

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

不需要Sidekick，且可盡可能最小化，以免妨礙存取報表套裝設定。

選取「新增項目」前後的報表套裝對話方塊

1. 選擇​添加項+​兩個下拉框
2. 選擇Report suite與公司帳戶相關聯的報表套裝可供選取
3. 在開啟的對話框中選擇​是:Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
4. 選擇Run Mode
   選擇​publish

Analytic雲服務和架構現已完成。 一旦建立社群網站並啟用此Analytics服務，就會定義對應。

為社群網站啟用Analytics

為新社區站點啟用

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

• 在步驟3中

• 在ANALYTICS標籤下：

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

• （可選）返回Analytics架構設定以調整變數對應。

為現有社區站點啟用

若要將Analytics雲端服務新增至現有社群網站:

• 導覽至​Communities > Sites​主控台

• 選擇社區站點的「編輯站點」表徵圖

• 選取設定

• 在Analytics區段中：

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

• （可選）返回Analytics架構設定以調整變數對應。

為自訂網站啟用

為了讓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變數將在伺服器上呈現後再提供給客戶端時設定。

對於​一般AEM網站（包含Communities元件），但未使用網站建立精靈建立)，必須新增元素。 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會自動用於數個Communities功能。

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

如果已建立為Analytics創作的新自訂元件，則應將其新增至已設定元件的清單。

元件配置

注意：journal元件用於實作部落格功能。

將Analytics對應至AEM變數

在啟用Analytics並選取雲端設定架構後，儲存社群網站時，AEM變數會自動對應至分別以evar1和event1開頭的Analytics evar和事件，並增加1。

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

以下是遵循快速入門教程之後的預設映射的示例：

隨每個事件傳送的eVar地圖

eVar值的範例：

• MIME類型:video/mp4
• 社群網站標題:Geometrixx社群
• 社區函式名稱:論壇
• 社群群組名稱:徒步旅行
• 社群群組內容路徑：/content/sites/communities/en/groups/hiking
• UGC元件resourceType:social/forum/components/hbs/topic
• UGC元件標題：健行主題
• 登入（可授權Id）:aaron.mcdonald@mailinator.com
• SRP到UGC的路徑：/content/usergenerated/asi/…/forum/jmtz-topic3或​要遵循的元件路徑:/content/sites/communities/en/jcr:content/content/primary/forum
• 社群網站內容路徑：/content/sites/community/en

修改Analytics變數對應

為社群網站啟用Analytics後，可從架構設定看到Analytics evar和事件對應至AEM變數。

啟用Analytics後，在社群網站發佈前，您可將所需的Analyticsevar或事件從左側邊欄拖曳至對應表格中的相關列，以在架構中變更對應。

若要避免重複對應，請務必將游標移至該列並選取Analytics變數元素右側顯示的「X」，以移除該列中已取代的Analytics evar或事件。

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

範例步驟1:將Analytics evar14拖曳至對應表格

範例步驟2:選取「x」以移除已取代的evar11

範例步驟3:AEM var eventdata.siteId重新對應至Analytics evar14

發佈社群網站

驗證Analytics與AEM變數的對應

發佈社群網站（亦會發佈Analytics雲端服務和架構）前，最好先驗證變數對應。

請參閱以下章節：

• 將Analytics對應至AEM變數
• 修改Analytics變數對應

主要發行者

當選擇的部署是publish farm時，必須將一個AEM發佈執行個體識別為輪詢Adobe Analytics以寫入SRP的報表資料的主要發佈者。

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

因此，必須編輯所有次要發佈執行個體的設定，以取消勾選「主要發佈者」核取方塊。

有關具體說明，請參閱Deploying Communities的主要發佈者部分。

複製加密密鑰

Adobe Analytics憑證會經過加密。 為方便製作者與發佈者之間復寫或傳輸加密的分析憑證，所有AEM執行個體必須共用相同的主要加密金鑰。

要執行此操作，請按照複製加密密鑰中的說明操作。

發佈社群網站和Analytics Cloud服務

為社群網站啟用Analytics雲端服務後，若有需要，對應AEM變數便需要透過(re)發佈社群網站，將設定複製到發佈環境。

從Analytics取得報表

報表管理

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

在作者上，查詢適用於即時報表。

在主要發佈者上，查詢可用來提供資訊，以準備報表匯入工具的Analytic資料匯入。

查詢間隔預設為10秒。

報表匯入工具

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

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

當資料可歸類為「大資料」時，更頻繁的輪詢可能會給社群網站帶來大量負載。

預設輪詢​Import interval​設定為12小時。

元件報表自訂

目前，若要自訂要追蹤的量度，系統會在儲存庫中建立節點，定義要針對該量度產生報表的時段。

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

• 在主要發佈者上

• 使用管理權限登入

• 導覽至CRXDE Lite

  • 例如， http://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屬性將覆寫報表匯入工具間隔
  • 值以秒為單位，設為4小時(14400秒)

在Analytics中管理使用者資料

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

資源

• Adobe Marketing Cloud:Analytics說明和參考
• AEM:與Adobe Analytics整合
• AEM:具有外部提供者的Analytics