Communities-Scoring und -Abzeichen

Übersicht

Die AEM Communities-Scoring- und -Badges-Funktion bietet die Möglichkeit, Community-Mitglieder zu identifizieren und zu belohnen.

Die wichtigsten Aspekte von Scoring und Badges sind:

• Zuweisen von Abzeichen die Rolle eines Mitglieds in der Gemeinschaft zu identifizieren.

• Grundlegende Vergabe von Abzeichen an die Mitglieder, um ihre Teilnahme zu fördern (Menge der erstellten Inhalte).

• Erweiterte Vergabe von Abzeichen Identifizierung der Mitglieder als Experten (Qualität der erstellten Inhalte).

Hinweis die Vergabe von Abzeichen nicht standardmäßig aktiviert.

Zeichen

Abzeichen werden unter dem Namen eines Mitglieds platziert, um entweder ihre Rolle oder ihre Stellung in der Community anzugeben. Abzeichen können entweder als Bild oder als Name angezeigt werden. Wenn der Name als Bild angezeigt wird, wird er als alternativer Text für die Barrierefreiheit eingefügt.

Standardmäßig befinden sich Abzeichen im Repository unter

• /libs/settings/community/badging/images

Wenn sie an einem anderen Speicherort gespeichert sind, sollten sie für alle lesbar sein.

Abzeichen werden in UGC dahingehend unterschieden, ob sie gemäß den Regeln zugewiesen wurden oder verdient wurden. Derzeit werden zugewiesene Abzeichen als Text und Earned Abzeichen als Bild angezeigt.

Benutzeroberfläche der Badge-Verwaltung

Die Gemeinschaften Badges-Konsole bietet die Möglichkeit, benutzerdefinierte Abzeichen hinzuzufügen, die für ein Mitglied angezeigt werden können, wenn es eine bestimmte Rolle in der Community übernimmt (zugewiesen).

Zugewiesene Abzeichen

Rollenbasierte Abzeichen werden von einem Administrator den Community-Mitgliedern basierend auf ihrer Rolle in der Community zugewiesen.

Zugewiesene (und erwartete) Zeichen werden in der ausgewählten SRP und nicht direkt zugänglich sind. Solange keine grafische Benutzeroberfläche verfügbar ist, können rollenbasierte Abzeichen nur mit Code oder cURL zugewiesen werden. Anweisungen zu cURL finden Sie im Abschnitt mit dem Titel Zuweisen und Sperren von Abzeichen.

In der Version sind drei rollenbasierte Abzeichen enthalten:

• Moderator

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

• Gruppenmanager

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

• privilegiertes Mitglied

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

  

Ausgezeichnete Abzeichen

Belohnungsbasierte Abzeichen werden vom Scoring-Dienst an Community-Mitglieder vergeben, basierend auf Regeln, die auf ihre Aktivität in der Community angewendet werden.

Damit Abzeichen als Belohnung für Aktivitäten angezeigt werden, müssen zwei Dinge geschehen:

• Badging muss enabled für die Funktionskomponente.
• Scoring- und Badging-Regeln müssen angewendet auf der Seite (oder dem Vorgänger), auf der die Komponente platziert wird.

In der Version sind drei belohnungsbasierte Abzeichen enthalten:

• Gold

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

• silber

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

• Bronze

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

  

Benutzerdefinierte Abzeichen

Benutzerdefinierte Abzeichen können mit der Badges-Konsole und entweder zugewiesen oder in Badging-Regeln angegeben.

Bei der Installation über die Badges-Konsole werden benutzerdefinierte Abzeichen automatisch in die Veröffentlichungsumgebung repliziert.

Scoring aktivieren

Die Auswertung ist standardmäßig nicht aktiviert. Die grundlegenden Schritte zum Einrichten und Aktivieren der Auswertung und Verleihung von Abzeichen sind:

• Identifizieren Sie Regeln für Ertragspunkte (Scoring-Regeln).

• Für Punkte, die nach Scoring-Regeln gesammelt wurden, weisen Sie Badges (Badging-Regeln).

• Anwenden der Scoring- und Badging-Regeln auf eine Community-Site.

• Aktivieren von Abzeichen für Community-Funktionen.

Siehe Schnelltest -Abschnitt, um die Scoring-Funktion für eine Community-Site mithilfe der standardmäßigen Scoring- und Badging-Regeln für Foren und Kommentare zu aktivieren.

Regeln auf Inhalt anwenden

Um Scoring und Badges zu aktivieren, fügen Sie die Eigenschaften hinzu scoringRules und badgingRules zu einem beliebigen Knoten in der Inhaltsstruktur für die Site.

Wenn die Site bereits veröffentlicht wurde, veröffentlichen Sie die Site erneut, nachdem Sie alle Regeln angewendet und Komponenten aktiviert haben.

Regeln, die für eine Badging-fähige Komponente gelten, sind diejenigen für den aktuellen Knoten oder dessen Vorgänger.

Wenn der Knoten vom Typ cq:Page (empfohlen) und fügen Sie dann mithilfe von CRXDE|Lite die Eigenschaften zu seiner jcr:content Knoten.

Aktivieren von Abzeichen für Komponenten

Die Scoring- und Bading-Regeln sind nur für Instanzen von Komponenten wirksam, die Badging aktiviert haben, indem sie die Komponentenkonfiguration in Authoring-Modus.

eine boolesche Eigenschaft, allowBadgesaktiviert/deaktiviert die Anzeige von Abzeichen für eine Komponenteninstanz. Er kann im Dialogfeld "Komponentenbearbeitung" für Forum-, Fragen- und Kommentarkomponenten über ein Kontrollkästchen mit der Bezeichnung Anzeigemarken.

Beispiel : allowBadges für die Instanz der Forum-Komponente

Scoring-Regeln

Scoring-Regeln sind die Grundlage für die Bewertung zum Zweck der Vergabe von Badges.

Jede Scoring-Regel ist ganz einfach eine Liste mit einer oder mehreren Unterregeln. Scoring-Regeln werden auf den Community-Site-Inhalt angewendet, um die Regeln zu identifizieren, die bei der Aktivierung von Badges angewendet werden sollen.

Scoring-Regeln werden vererbt, sind jedoch nicht additiv. Beispiel:

• Wenn Seite 2 die Scoring-Regel2 enthält und ihr Vorgänger Seite 1 die Scoring-Regel 1 enthält.

• Eine Aktion auf einer Komponente "Seite 2"ruft sowohl Regel1 als auch Regel2 auf.

• Wenn beide Regeln anwendbare Unterregeln für dasselbe enthalten topic/verb:

  • Nur die Unterregel aus Regel 2 wirkt sich auf das Ergebnis aus.
  • Die Bewertungen aus beiden Unterregeln werden nicht zusammen hinzugefügt.

Wenn es mehr als eine Scoring-Regel gibt, werden die Werte für jede Regel separat beibehalten.

Scoring-Regeln sind Knoten des Typs cq:Page mit Eigenschaften auf jcr:content -Knoten, der die Liste der Unterregeln angibt, die ihn definieren.

Die Bewertungen werden im SRP gespeichert.

Scoring-Unterregeln

Die Scoring-Unterregeln enthalten die Eigenschaften, die die Werte für die Teilnahme an der Community detailliert beschreiben.

Jede Scoring-Unterregel identifiziert:

• Welche Aktivitäten werden verfolgt?
• Welche speziellen Community-Funktionen sind betroffen?
• Wie viele Punkte werden vergeben?

Standardmäßig werden Punkte dem Mitglied zugewiesen, das eine Aktion durchführt, es sei denn, die Unterregel legt den Eigentümer des Inhalts als Empfänger der Punkte fest ( forOwner).

Jede Unterregel kann in einer oder mehreren Scoring-Regeln enthalten sein.

Der Name der Unterregel folgt normalerweise dem Muster der Verwendung einer subject , Objekt und verb. Beispiel:

• member-comment-create
• member-receive-Votum

Unterregeln sind Knoten des Typs cq:Page mit Eigenschaften auf jcr:contentKnoten, der die verbs und topics .

Einbezogene Scoring-Regeln und Unterregeln

In der Version sind zwei Scoring-Regeln für die Forumsfunktion (jeweils eine für die Komponenten Forum und Kommentare der Funktion Forum ):

1. /libs/settings/community/scoring/rules/comments-scoring

   • subRules[] = /libs/settings/community/scoring/rules/sub-rules/member-comment-create /libs/settings/community/scoring/rules/sub-rules/member-receive-opt /libs/settings/community/scoring/rules/sub-rules/member-given-Vage /libs/settings/community/scoring/rules/sub-rules/member-is-moderiert

2. /libs/settings/community/scoring/rules/forums-scoring

   • subRules[] = /libs/settings/community/scoring/rules/sub-rules/member-forum-create /libs/settings/community/scoring/rules/sub-rules/member-receive-Vo /libs/settings/community/scoring/rules/sub-rules/member-given-voice /libs/settings/community/scoring/rules/sub-rules/member-is-moderiert

Anmerkungen:

• Beide rules und sub-rules -Knoten sind vom Typ cq:Page.

• subRules ist ein Attribut des Typs String[] zur Regel jcr:content Knoten.

• sub-rules kann für verschiedene Scoring-Regeln freigegeben werden.

• rules sollte sich in einem Repository-Speicherort mit Leseberechtigung für alle befinden.

  • Regelnamen müssen unabhängig vom Speicherort eindeutig sein.

Aktivieren benutzerdefinierter Scoring-Regeln

Änderungen oder Ergänzungen an Scoring-Regeln oder Unterregeln, die in der Autorenumgebung vorgenommen werden, müssen in der Veröffentlichungsumgebung installiert werden.

Badging-Regeln

Badging-Regeln verknüpfen Scoring-Regeln mit Abzeichen, indem Folgendes angegeben wird:

• Scoring-Regel
• Für ein bestimmtes Zeichen erforderliche Punktzahl

Badging-Regeln sind Knoten des Typs cq:Page mit Eigenschaften auf jcr:content -Knoten, der Scoring-Regeln mit Bewertungen und Abzeichen korreliert.

Die Badging-Regeln beinhalten eine obligatorische thresholds -Eigenschaft, die eine geordnete Liste von Bewertungen darstellt, die Abzeichen zugeordnet sind. Die Werte müssen in zunehmendem Wert geordnet werden. Beispiel:

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

  • Ein Bronze-Badge wird für 1 Punkt erwartet.

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

  • Wenn 60 Punkte gesammelt wurden, wird ein Silberabzeichen vergeben.

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

  • Wenn 80 Punkte gesammelt wurden, wird ein Goldabzeichen erwartet.

Badging-Regeln werden mit Scoring-Regeln gepaart, die bestimmen, wie Punkte gesammelt werden. Siehe Abschnitt mit dem Titel Regeln auf Inhalt anwenden.

Die scoringRules -Eigenschaft einer Badging-Regel schränkt einfach ein, welche Scoring-Regeln mit dieser Badging-Regel gepaart werden können.

Einbezogene Badging-Regeln

In der Version sind zwei Badging-Regeln enthalten, die dem Foren und Kommentar-Scoring-Regeln.

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

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

Anmerkungen:

• rules -Knoten sind vom Typ cq:Page.

• rules sollte sich in einem Repository-Speicherort mit Leseberechtigung für alle befinden.

  • Regelnamen müssen unabhängig vom Speicherort eindeutig sein.

Aktivieren benutzerdefinierter Badging-Regeln

Änderungen oder Ergänzungen an Badging-Regeln oder Bildern, die in der Autorenumgebung vorgenommen werden, müssen in der Veröffentlichungsumgebung installiert werden.

Zuteilen und Entziehen von Abzeichen

Abzeichen können Mitgliedern zugewiesen werden, indem sie entweder Mitgliederkonsole oder programmgesteuert mithilfe von cURL-Befehlen.

Die folgenden cURL-Befehle zeigen, was für eine HTTP-Anfrage zum Zuweisen und Sperren von Badges erforderlich ist. Das Standardformat lautet:

cURL -i -X POST -H header -u Anmeldung -F operation -F badge member-profile-url

header = Benutzerdefinierte Kopfzeile "Accept:application/json", die an den Server übergeben wird (erforderlich)

Anmeldung = administrator-id:password zum Beispiel : admin:admin

operation = ":operation=social:assignBadge" ODER ":operation=social:deleteBadge"

badge = "badgeContentPath=badge-image-file"

badge-image-file = der Speicherort der Badge-Bilddatei im Repository, z. B. : /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

member-profile-url = Endpunkt für das Profil des Mitglieds in der Veröffentlichungsinstanz, z. B. : https://<server>:<port>/home/users/community/riley/profile.social.json

Beispiele:

Moderatorzeichen zuweisen

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

Verknüpftes Silber-Zeichen sperren

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

Scoring und Abzeichen für benutzerdefinierte Komponenten

Scoring- und Badging-Regeln können für benutzerdefinierte Komponenten erstellt werden, indem die für die Komponente erstellten Ereignisthemen Verben zugeordnet werden.

Themen und Verben

Wenn Mitglieder mit Communities-Funktionen interagieren, werden Ereignisse gesendet, die asynchrone Listener wie Benachrichtigungen und Scoring Trigger werden können.

Die SocialEvent-Instanz einer Komponente zeichnet die Ereignisse als actions die für topic. Das SocialEvent enthält eine Methode zum Zurückgeben einer verb mit der Aktion verknüpft ist. Es gibt eine n-1 Beziehung actions und verbs.

Die folgenden Tabellen beschreiben für die bereitgestellten Communities-Komponenten die verbs für jeden topic zur Verwendung in Scoring-Unterregeln.

Kalenderkomponente
SocialEvent topic= com/adobe/cq/social/calendar

Kommentarkomponente
SocialEvent topic= com/adobe/cq/social/comment

Dateibibliothekskomponente
SocialEvent topic= com/adobe/cq/social/fileLibrary

Forumkomponente
SocialEvent topic= com/adobe/cq/social/forum

Journalkomponente
SocialEvent topic= com/adobe/cq/social/journal

QnA-Komponente
SocialEvent topic = com/adobe/cq/social/qna

Überprüfungskomponente
SocialEvent topic= com/adobe/cq/social/review

Bewertungskomponente
SocialEvent topic= com/adobe/cq/social/tally/rating

Abstimmungskomponente
SocialEvent topic= com/adobe/cq/social/tally/stimmberechtigt

Moderationsfähige Komponenten
SocialEvent topic= com/adobe/cq/social/moderation

Benutzerdefinierte Komponentenereignisse

Bei einer benutzerdefinierten Komponente wird ein SocialEvent instanziiert, um die Ereignisse der Komponente als actions die für topic.

Um die Auswertung zu unterstützen, muss das SocialEvent die Methode überschreiben getVerb() , damit verb wird für jeden action. Die verb für eine Aktion zurückgegeben wird, kann eine häufig verwendete Aktion sein (z. B. POST) oder einer für die Komponente spezialisierten Komponente (z. B. ADD RATING). Es gibt eine n-1 Beziehung actions und verbs.

Fehlerbehebung

Abzeichen werden nicht angezeigt

Wenn Scoring- und Badging-Regeln auf den Inhalt der Website angewendet wurden, Abzeichen jedoch für keine Aktivität erwartet werden, stellen Sie sicher, dass Abzeichen für die Instanz dieser Komponente aktiviert wurden.

Siehe Aktivieren von Abzeichen für Komponenten.

Scoring-Regel hat keine Auswirkung

Wenn Scoring- und Badging-Regeln auf den Inhalt der Website angewendet wurden und Abzeichen für einige Aktionen, aber nicht für andere zugewiesen werden, überprüfen Sie, ob die Badging-Regel die Scoring-Regeln, für die sie gilt, nicht eingeschränkt hat.

Siehe scoringRules Eigenschaft von Badging-Regeln.

Groß-/Kleinschreibung

Bei den meisten Eigenschaften und Werten, insbesondere den Verben, wird zwischen Groß- und Kleinschreibung unterschieden. Verben müssen bei Verwendung in einer Scoring-Unterregel alle UPPERCASE sein.

Wenn die Funktion nicht wie erwartet funktioniert, stellen Sie sicher, dass die Daten korrekt eingegeben wurden.

Schnelltest

Mit dem Tutorial "Erste Schritte" Site (engagieren) :

• Zugriff auf die CRXDE Lite auf der Autoreninstanz.

• Navigieren Sie zur Basisseite:

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

• Fügen Sie die Eigenschaft badgingRules hinzu:

  • Name: badgingRules
  • Typ: String
  • Auswählen Multi
  • Klicken Sie auf Hinzufügen
  • Geben Sie /libs/settings/community/badging/rules/forums-badging ein
  • Wählen Sie nun eine der folgenden Optionen aus +
  • Geben Sie /libs/settings/community/badging/rules/comments-badging ein
  • Klicken Sie auf OK

• Fügen Sie die Eigenschaft scoringRules hinzu:

  • Name: scoringRules
  • Typ: String
  • Auswählen Multi
  • Klicken Sie auf Hinzufügen
  • Geben Sie /libs/settings/community/scoring/rules/forums-scoring ein
  • Wählen Sie nun eine der folgenden Optionen aus +
  • Geben Sie /libs/settings/community/scoring/rules/comments-scoring ein
  • Klicken Sie auf OK

• Wählen Sie Alle speichern aus.

Stellen Sie als Nächstes sicher, dass die Forum- und Kommentarkomponenten die Anzeige von Abzeichen zulassen:

• Wieder mit CRXDE Lite.

• Navigieren Sie zur Forumkomponente .

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

• Fügen Sie ggf. die boolesche Eigenschaft allowBadges hinzu und stellen Sie sicher, dass sie wahr ist.

  • Name: allowBadges
  • Typ: Boolean
  • Wert: true

Als Nächstes erneut veröffentlichen die Community-Site.

Abschließend,

• Navigieren Sie zur Komponente in der Veröffentlichungsinstanz.

• Melden Sie sich als Community-Mitglied an (z. B. : weston.mccall@dodgit.com / password).

• Posten Sie ein neues Forumthema.

• Die Seite muss aktualisiert werden, damit der Badge angezeigt wird.

  • Melden Sie sich ab und melden Sie sich als anderes Community-Mitglied an (z. B.: aaron.mcdonald@mailinator.com/password).

• Wählen Sie das Forum aus.

Dies sollte dem Community-Mitglied ein Bronzesymbol mit seinem Forumsbeitrag vermitteln, da der erste Schwellenwert der Regel für Forumsabzeichen 1 beträgt.

Zusätzliche Informationen

Weitere Informationen finden Sie unter Grundlagen zu Scoring und Abzeichen für Entwickler.

Informationen zur erweiterten Scoring-Engine finden Sie unter Erweiterte Scoring- und Badges.

Das konfigurierbare Leaderboard component und function vereinfacht die Anzeige von Mitgliedern und deren Ergebnissen auf einer Community-Site.

Ressourcen für Business.Adobe.com

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