社群計分和徽章

概觀

AEM Communities計分和徽章功能提供識別和獎勵社群成員的能力。

評分和徽章的主要方面是：

• 指派徽章 確定成員在社區中的作用。

• 基本獎章 鼓勵成員參與（建立的內容數量）。

• 高級徽章獎勵 將成員識別為專家（建立的內容質量）。

附註 頒發徽章 預設為未啟用.

徽章

徽章會放置在成員的名下，以指出其角色或在社群中的地位。 徽章可以顯示為影像或名稱。 顯示為影像時，名稱會包含為協助工具的替代文字。

預設情況下，徽章位於存放庫的

• /libs/settings/community/badging/images

如果儲存在不同的位置，則每個人都應該可以讀取這些內容。

徽章在UGC中區別於是指定的徽章，還是根據規則掙得的徽章。 當前，已分配的徽章以文本形式顯示，而已獲得的徽章以影像形式顯示。

徽章管理UI

社群 徽章主控台 提供添加自定義徽章的功能，該徽章可在獲得（授予）成員或成員在社區中承擔特定角色（已分配）時為成員顯示。

指派的徽章

管理員會根據社群中的角色，將角色型徽章指派給社群成員。

已分配（和已喚醒）的徽章儲存在選定的 SRP 和無法直接存取。 在GUI可用之前，指派角色型徽章的唯一方法是使用程式碼或cURL來指派。 如需cURL指示，請參閱 指派和撤銷徽章.

此發行包含三個角色型徽章：

• 版主

  /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

• 群組管理員

  /libs/settings/community/badging/images/group-manager/jcr:content/group-manager.png

• 特權成員

  /libs/settings/community/badging/images/privileged-member/jcr:content/privileged-member.png

  

獎章

評分服務會根據套用至社群中活動的規則，將基於獎勵的徽章授予社群成員。

為了讓徽章顯示為活動的獎勵，必須執行下列兩項操作：

• 簽名必須是 已啟用 （特徵元件）。
• 計分和加號規則必須 已套用 至元件所在的頁面（或上階）。

發行包含三個獎勵型徽章：

• 黃金

  /libs/settings/community/badging/images/gold-badge/jcr:content/gold.png

• 銀

  /libs/settings/community/badging/images/silver-badge/jcr:content/silver.png

• 銅

  /libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png

  

自訂徽章

可使用 徽章主控台 和在標籤規則中指定或指定的。

從徽章控制台安裝時，自訂徽章會自動複製到發佈環境。

啟用計分

預設未啟用計分。 設定及啟用徽章評分與獎勵的基本步驟為：

• 識別收入點的規則(計分規則)。

• 針對每個分數規則累積的點數，指派 徽章 (亂碼規則)。

• 將分數和徽章規則套用至社群網站.

• 啟用社區功能的簽名.

請參閱 快速測試 區段，使用論壇和留言的預設計分和徽章規則來啟用社群網站的計分。

將規則套用至內容

要啟用計分和徽章，請添加屬性 scoringRules 和 badgingRules 至網站內容樹中的任何節點。

如果網站已發佈，在套用所有規則並啟用元件後，請重新發佈網站。

適用於啟用徽章的元件的規則是當前節點或其上階的規則。

如果節點為類型 cq:Page （建議），然後使用CRXDE|Lite將屬性新增至其中 jcr:content 節點。

為元件啟用徽章

計分和徽章規則僅適用於已透過編輯元件組態以啟用徽章的元件例項 製作模式.

布林屬性， allowBadges，會啟用/停用元件例項的徽章顯示。 可在 元件編輯對話方塊 針對論壇、QnA和通過標籤為 顯示徽章.

範例：論壇元件例項的allowBadges

計分規則

評分規則是評分的基礎，用於授予徽章。

很簡單，每個分數規則都是一或多個子規則的清單。 計分規則會套用至社群網站內容，以識別在啟用徽章時要套用的規則。

分數規則是繼承的，但不是加性的。 例如：

• 如果page2包含計分規則2，其上階page1包含計分規則1。

• page2元件上的動作會同時叫用rule1和rule2。

• 如果這兩個規則包含相同的適用子規則 topic/verb:

  • 只有規則2的子規則會影響分數。
  • 兩個子規則的分數不會加在一起。

當有多個計分規則時，會針對每個規則分別維護分數。

計分規則是類型的節點 cq:Page 具有屬性 jcr:content 指定定義子規則清單的節點。

分數會儲存在SRP中。

計分子規則

分數子規則包含詳細說明參與社群之值的屬性。

每個計分子規則識別：

• 要追蹤哪些活動？
• 涉及哪些特定的社區功能？
• 分多少分？

預設情況下，除非子規則將內容的所有者指定為接收點( forOwner)。

每個子規則可以包含在一個或多個計分規則中。

子規則的名稱通常遵循使用 主旨 , 物件 和 動詞. 例如：

• member-comment-create
• 成員接受表決

子規則是類型的節點 cq:Page 具有屬性 jcr:content指定節點 動詞和主題 .

包含計分規則和子規則

此發行包含的兩個計分規則 論壇功能 （論壇功能的「論壇」和「評論」元件各一個）:

1. /libs/settings/community/scorning/rules/comments計分

   • subRules[] = /libs/settings/community/scoring/rules/subrules/member-comment-create /libs/settings/community/scoring/rules/sub-rules/member-receive-vote /libs/settings/community/scoring/rules/subrules/subrules/member-give-vote /libs/settings/community/scoring/rules/sub-rules/mer-is-dered

2. /libs/settings/community/scoring/rules/forums計分

   • subRules[] = /libs/settings/community/scoring/rules/subrules/member-forum-create /libs/settings/community/scoring/rules/sub-rules/member-receive-vote /libs/settings/community/scoring/rules/subrules/member-give-vote /libs/settings/community/scorning/s/rules/sub-rules/mer-is-ded

附註:

• 兩者 rules 和 sub-rules 節點類型為cq:Page。

• subRules 是字串類型的屬性[] 規則 jcr:content 節點。

• sub-rules 可在各種計分規則之間共用。

• rules 應位於具有每個人讀取權限的存放庫位置。

  • 無論位置為何，規則名稱都必須是唯一的。

啟用自訂計分規則

必須在發佈時安裝在製作環境中對計分規則或子規則所做的任何變更或新增。

簽章規則

簽名規則通過指定以下內容將計分規則連結到徽章：

• 計分規則
• 喚醒特定徽章所需的分數

簽名規則是類型的節點 cq:Page 具有屬性 jcr:content 將計分規則與分數和徽章關聯的節點。

簽章規則是強制性的 thresholds 屬性，此屬性是對應至徽章之分數的有序清單。 必須以增加的值排序分數。 例如：

• 1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png

  • 獲得1分時獲得銅牌。

• 60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png

  • 當積分達60分時，授予銀牌。

• 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png

  • 累積80分時，會發出金徽章。

徽章規則與分數規則搭配，可決定積分的累積方式。 請參閱 將規則套用至內容.

此 scoringRules 徽章規則上的屬性只會限制哪些分數規則可以與該特定徽章規則配對。

包含徽章規則

此發行包含與 論壇和評論評分規則.

• /libs/settings/community/badging/rules/comments-badging

• /libs/settings/community/badging/rules/forums-badging

附註:

• rules 節點類型為cq:Page。

• rules 應位於具有每個人讀取權限的存放庫位置。

  • 規則名稱必須是唯一的，無論位置為何。

啟用自訂徽章規則

在製作環境中對標籤規則或影像所做的任何變更或新增，都必須安裝在發佈上。

指派和撤銷徽章

徽章可以使用 成員控制台 或以程式設計方式使用cURL命令。

下列cURL命令顯示指派和撤銷徽章的HTTP要求所需的項目。 基本格式為：

cURL -i -XPOST-H 標題 -u 簽入 -F 操作 -F 徽章 member-profile-url

標題 = "Accept:application/json"要傳遞至伺服器的自訂標頭（必要）

簽入 = administrator-id:password，例如：admin:admin

操作 = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"

徽章 = "badgeContentPath=徽章 — 影像檔案"

徽章 — 影像檔案 =徽章影像檔案在存放庫中的位置，例如：/libs/settings/community/badging/images/daldorator/jcr/content/moderator.png

member-profile-url =例如，在發佈時成員設定檔的端點：https://<server>:<port>/home/users/community/riley/profile.social.json

範例：

指派協調者徽章

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/libs/settings/community/badging/images/moderator/jcr:content/moderator.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

撤銷指派的銀徽章

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/libs/settings/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

自訂元件的計分和徽章

可為自訂元件建立計分和徽章規則，方法是將為元件建立的事件主題與動詞相關聯。

主題和動詞

當成員與社區功能交互時，會發送可觸發非同步偵聽器的事件，如通知和計分。

元件的SocialEvent例項會將事件記錄為 actions 在 topic. SocialEvent包含傳回 verb 與動作相關聯。 有 n-1 關係 actions 和 verbs.

對於傳遞的社群元件，下表說明 verbs 為每個 topic 供使用 計分子規則.

日曆元件
SocialEvent topic= com/adobe/cq/social/calendar

注釋元件
SocialEvent topic= com/adobe/cq/social/comment

檔案庫元件
SocialEvent topic= com/adobe/cq/social/fileLibrary

論壇元件
SocialEvent topic= com/adobe/cq/social/forum

日記帳元件
SocialEvent topic= com/adobe/cq/social/journal

QnA元件
SocialEvent topic = com/adobe/cq/social/qna

查看元件
SocialEvent topic= com/adobe/cq/social/review

評等元件
SocialEvent topic= com/adobe/cq/social/tally/rating

投票元件
SocialEvent topic= com/adobe/cq/social/tally/voting

已啟用協調的元件
SocialEvent topic= com/adobe/cq/social/moderation

自訂元件事件

對於自訂元件，SocialEvent會實例化，以將元件的事件記錄為 actions 在 topic.

若要支援計分，SocialEvent必須覆寫方法 getVerb() 這樣才合適 verb 會針對每個 action. 此 verb 針對動作傳回的可能是常用的(例如 POST)或專用於元件(例如 ADD RATING)。 有 n-1 關係 actions 和 verbs.

疑難排解

徽章未顯示

如果已將分數和徽章規則套用至網站的內容，但未察覺任何活動的徽章，請確定已為該元件的例項啟用徽章。

請參閱 為元件啟用徽章.

計分規則無效

如果已對網站的內容應用了計分和徽章規則，並且為某些操作（但不為其他操作）授予徽章，請檢查徽章規則是否未限制其應用的計分規則。

請參閱 scoringRules 屬性 簽章規則.

區分大小寫類型

大部分的屬性和值（尤其是動詞）都區分大小寫。 在計分子規則中使用動詞時，必須全部大寫。

如果功能未如預期運作，請確定資料已正確輸入。

快速測試

您可以快速嘗試使用 快速入門教學課程 （參與網站）:

• 存取作者CRXDE Lite。

• 瀏覽到基頁：

  • /content/sites/engage/en/jcr:content

• 新增badgingRules屬性：

  • 名稱: badgingRules
  • 類型: String
  • 選擇 多
  • 選擇 新增
  • 輸入 /libs/settings/community/badging/rules/forums-badging
  • 選取 +
  • 輸入 /libs/settings/community/badging/rules/comments-badging
  • 選擇 確定

• 添加scorinRules屬性：

  • 名稱: scoringRules
  • 類型: String
  • 選擇 多
  • 選擇 新增
  • 輸入 /libs/settings/community/scoring/rules/forums-scoring
  • 選取 +
  • 輸入 /libs/settings/community/scoring/rules/comments-scoring
  • 選擇 確定

• 選擇 全部儲存.

接下來，請確定論壇和注釋元件允許顯示徽章：

• 再次使用CRXDE Lite。

• 瀏覽至論壇元件

  • /content/sites/engage/en/forum/jcr:content/content/primary/forum

• 如有必要，請新增allowBadges布林屬性，並確認為true。

  • 名稱: allowBadges
  • 類型: Boolean
  • 值: true

下一個， 重新發佈 社群網站。

最後，

• 瀏覽至發佈執行個體上的元件。

• 以社群成員身分登入(例如：weston.mccall@dodgit.com /密碼)。

• 張貼新論壇主題。

• 必須重新整理頁面才會顯示徽章。

  • 登出並以不同社群成員身分登入(例如：aaron.mcdonald@mailinator.com/password)。

• 選擇論壇。

這應該能為社群成員爭取到銅牌，因為第一個論壇徽章規則的第一個臨界值是1分，可在論壇貼文上看到。

其他資訊

如需詳細資訊，請參閱 計分和徽章要點 頁面。

有關高級計分引擎的資訊，請參閱 進階計分和徽章.

可配置的排行榜 元件 和 函式 可簡化成員及其分數在社群網站上的顯示。

Business.Adobe.com 資源

Ecommerce Integrations Content Insights Targeted Content Managed Cloud Customer Experience Management Digital Asset Management