社群功能的Analytics設定

概覽

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

Adobe Analytics可針對AEM Communities進行設定，如此當會員與支援的「社群」功能互動時，事件就會傳送至產生報表的Adobe Analytics。

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

此外，必須分析以下事項：

• 在發佈環境中：

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

• 在作者環境中：

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

支援的社群功能包括：

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

本節說明如何將Analytics報表套裝與社群功能連接。 基本步驟為：

1. 複製加密金鑰 ，以確保所有AEM例項都能正確執行加密／解密
2. 準備Adobe Analytics報 表套裝
3. 建立AEM Analytics雲端 服務 和架 構
4. 啟用社群網站的Analytics
5. 驗證 Analytics與AEM變數對應
6. 識別主 要發行者
7. 發佈 社群網站
8. 設 定從Adobe Analytics匯入報表資料 至社群網站

必備條件

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

• 公司名稱

  與Adobe Analytics帳戶關聯的公司

• 使用者名稱

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

  （應包含Web服務存取權限）

• 密碼

  授權使用者的登入密碼

• Analytics資料中心

  帳戶的Analytics資料中心URL

• 報表套裝

  要使用的Analytics報表套裝名稱

適用於視訊報告的Adobe Analytics報表套裝

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

透過「公司名 稱」和「使用者名稱」登入 Adobe Marketing Cloud ，您可以設定新的或現有的報表套裝，以便：

• 11轉換變數 (evar)

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

• 7成功事件 （事件）

  • event1 啟用 event7

  • 類型 Counter

    • 非 Counter (no subrelations)

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

• 視訊管理

  • 視訊報告主控台

    • 啟用 Video Core
    • 選擇保存

  • 視訊核心測量主控台

    • 選取 Use Solution Variables
    • 選擇保存

如果使用新 的報表套裝，請注意，新的報表套裝可能只有4個eVar和6個事件變數，而社群則需要11個eVar和7個事件變數。

如果使用 現有報表套裝，則可能需要在啟 動社群網站的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服務設定

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

• 從全域導覽： 工具>部署>雲端服務
• 向下捲動至 Adobe Analytics
• 選擇「 立即配置 」或 「顯示配置」

「建立配置」對話框

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

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

• 標題

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

  例如，輸入 Enablement Community Analytics

• 名稱

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

  For example, enter communities

• 範本

  選取 Adobe Analytics Configuration

• Select Create

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

Analytics設定對話方塊

初次建立新Analytics設定時，會顯示設定，並顯示新對話方塊以輸入Analytics設定。 此對話方塊需要從 帳戶代表處取得 必要的帳戶資訊。

• 公司

  與Adobe Analytics帳戶關聯的公司

• 使用者名稱

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

• 密碼

  授權使用者的登入密碼

• 資料中心

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

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

  保留為預設值（未勾選）

• 使用 AppMeasurement

  保留為預設值（未勾選）

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

  保留為預設值（未勾選）

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

  保留為預設值（勾選）

要保存設定：

• 選擇 連線至Analytics

  • 如果未成功，

    • 驗證條目是否不包含前導空格
    • 試用不同的資料中心
    • 聯絡您的帳戶代表

• 選擇「確 定」

建立框架

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

• 選取 [+] 可用架構旁 的圖示 ，以建立新架構

• 標題

  （必要）架構的顯示標題

  例如，輸入 Enablement Community Framework

• 名稱

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

  For example, enter communities

• 範本

  選取 Adobe Analytics Framework

• Select Create

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

AEM Analytics Framework設定

此架構的目的是將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
   選擇發 布

Analytic雲端服務與架構現已完成。 在啟用此Analytics服務後，社群網站建立後，即會定義映射。

啟用社群網站的Analytics

啟用新社群網站

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

• 在步驟3中

• 在「分 析」標籤下:

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

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

啟用現有社群網站

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

• 導覽至「社 群>網站主控台 」

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

• 選取「設定」

• 在「分析」區段中：

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

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

啟用自訂網站

為了讓Analytics追蹤和匯入能正常運作於社群網站，必須有具有類別和href屬 scf-js-site-title 性的頁面元素。 頁面上只應存在一個此類元素，例如社群網站的未修改 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網站 ，但不是使用網站建立精靈 建立的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會自動用於數個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映射

	啟用資源類型	網站標題	函式類型	群組標題	群組路徑	UGC類型	UGC標題	使用者（會員）	UGC路徑	網站路徑
	eVar1	eVar2	eVar3	eVar4	eVar5	eVar6	eVar7	eVar8	eVar9	eVar10
event1資源播放	(a)	-	-	-	-	-	-	-	(i)	-
event2SCFView	(a)	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	(j)
event3SCFCreate（貼文）	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	(j)
event4SCFFollow	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	(j)
event5SCFVoteUp	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	(j)
event6SCFVoteDown	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	(j)
event7SCFRate	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	(j)

eVar值的範例：

• MIME類型: video/mp4
• Community site title: Geometrixx Communities
• 社群函式名稱: 論壇
• 社群群組名稱: 遠足
• 社群群組內容的路徑： /content/sites/communities/tw/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/tw/jcr:content/content/primary/forum
• 社群網站內容的路徑： /content/sites/community/tw

修改Analytics變數對應

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

啟用Analytics後，在社群網站發佈之前，從左側導軌拖曳所需的Analytics evar或事件並拖曳至對應表格的相關列，即可在架構中變更對應。

若要避免重複映射，請務必將滑鼠指標暫留在行上並選取Analytics變數元素右側的「X」，以移除已取代的Analytics evar或事件。

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

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

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

範例步驟3: AEM var eventdata.siteId已重新映射至Analytics evar14

發佈社群網站

驗證Analytics與AEM變數對應

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

請參閱章節：

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

主要發行者

當選擇的部署是發 布場，則必須將一個AEM發佈例項識別為主要發佈者，以輪詢Adobe Analytics，以便將報表資料寫入 SRP。

By default, the AEM Communities Publisher Configuration OSGi configuration identifies its publish instance as the primary publisher, such that all publish instances in a publish farm would self-identify as the primary.

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

For specific instructions, see the primary publisher section of Deploying Communities.

Replicate the Crypto Key

Adobe Analytics認證會加密。 To faciitate the replication or transmission of encrypted analytics credentials between author and publishers, all AEM instances must share the same primary encryption key.

To do so, follow the instructions at Replicate the Crypto Key.

Publish Community Site and Analytics Cloud Service

在社群網站啟用Analytics雲端服務後，並視需要調整Analytics與 AEM變數的對應，就必須透過 （重新）發佈社群網站，將設定複製至發佈環境。

從Analytics取得報表

報表管理

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

在作者上，查詢是即時報告。

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

查詢間隔預設為10秒。

報表匯入工具

一旦發佈啟用Analytics的社群網站後，主要發行者的 AEM Communities Analytics Report ImporterOSGi組態即可設定為針對CRXDE中未個別設定的組態設定預設輪詢間隔。

輪詢間隔控制向Adobe Analytics請求提取並保存到 SRP中的資料的頻率。

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

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

元件報表自訂

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

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

• 在主要發行者上

• 使用管理權限登入

• 導覽至 CRXDE Lite

  • 例如， http://localhost:4503/crx/de

• Under the jcr:content node of the language root

  • 例如， /content/sites/engage/en/jcr:content

• Navigate to the component configured for Analytics reporting

  • 例如， analytics/reportConfigs/social_forum_components_hbs_topic

• Notice the time periods created

  • last30Days
  • last90Days
  • thisYear

• Notice the totalnode

  • 修改屬 interval 性將覆寫「報表匯入工具」間隔
  • 值以秒為單位，並設為4小時（14400秒）

在Analytics中管理使用者資料

Adobe Analytics provides APIs that allow you to access, export, and delete user data. 如需詳細資訊，請參 閱提交存取權和刪除請求。

資源

• Adobe Marketing Cloud: Analytics Help and Reference
• AEM: Integrating with Adobe Analytics
• AEM: Analytics with External Providers