Chat with us, powered by LiveChat

A|B Voting Addon

The A|B Voting addon is a cool social interactive content tool that allows your users to compete for votes, while being motivated to continuously contribute in the voting:

  1. A user participates with some form of media, such as a photo and a comment
  2. The user then needs to vote in an A vs. B fashion on content from other participants in order to gain Karma points each time the user votes
  3. Karma is then automatically spent in order for others to see their participation for a chance to be voted on

So Karma is the currency of the game! For a user’s participations to be voted on by others, they must be seen by others, and that costs Karma, which can be acquired by voting on the participations of others.

How To Setup

To enable and configure the A|B Voting Addon:

  1. Open the Addons menu on the right sidebar of the Editor
  2. Enable the A|B Voting addon and click Edit Settings
  3. Create a new A|B Voting addon and give it a name, e.g. My Photo Contest
  4. Check the settings below and configure the addon
Connect with Account Addon

Default: None

A User ID is required for a user to participate in an A|B Voting competition. This User ID is used to identify the user’s participation or participations.

You can however choose to connect with an instance of the Account addon. Make sure an instance of the Account addon is enabled and you will be able to select it on the dropdown of this setting.

Then simply follow the instructions on how to setup and use the Account addon.

Starting Karma

Default: 20

Define the starting Karma for a user. The value will start decreasing as soon as others start to see the user’s participation, regardless if it gets voted or not.

Maximum Karma

Default: 100

Limiting the amount of a Karma a user can have motivates the user to return multiple times over the period of the competition.

Maximum number of participations

Default: 1

By default a user participates once and then starts voting. You can use this setting to allow multiple participations per user and make a different type of competition.

Minimum Karma to participate more

Default: 0

If you allow multiple participations, you can then define a minimum amount of Karma for the user to be able to participate more, which again motivates the users to engage more in voting.

Karma cost to participate more

Default: 0

If you allow multiple participations, you can also define a Karma cost for a user to participate more, which again motivates the users to engage more in voting.

Participation Data

You must define at least one field in the Participation Data table. The datafields you create here will be the data collected per participation of your users.

A most basic – yet awesome – example would be to add a field named Image, of the type image, and then in the experience ask the user to participate by taking a photo.

Actions

Once your A|B Voting addon is enabled and configured, you get access to the following actions with which you can interact with the addon:

Check Participation

Checks if User ID has any participations in this A|B Voting addon.

Settings User ID. Select a value from a datafield to be the User ID that will identify the participation. This setting only appears if the A|B Voting addon is not connected to an Account addon.
Outcomes Has not participated. Executes if the user has not yet participated; changes Participation Status datafield to Has Not Participated.
Has participated. Executes if the user has already participated; all participations become available under the User Participations datafield; changes Participation Status datafield to Has Participated; updates Karma datafield value.

Participate

Creates a participation for User ID with the data defined in Participation Data.

Settings User ID. Select a value from a datafield to be the User ID that will identify the participation. This setting only appears if the A|B Voting addon is not connected to an Account addon.
Data. Select values for each datafield of those you have defined under Participation Data in the A|B Voting Addon settings.
Outcomes If success. Executes if a participation is successfully created; changes Participation Status datafield to Has Participated; updates Karma datafield value.
Max participations reached. Executes if it fails to create a participation due to the maximum participations per user limit setting.
Not enough karma. Executes if the participation is not successful due to not having Karma enough. This can be due to the minimum Karma requirement or Karma cost.

Get Next Vote Pair

Gets the next pair of participations for the current user to vote on.

Settings User ID. Select a value from a datafield to be the User ID that will identify the participation. This setting only appears if the A|B Voting addon is not connected to an Account addon.
Outcomes Votes available. Executes if there is an A|B pair available for the current user to vote on; data defined on Participation Data becomes available with the appended A and B suffixes. For example, if you had a field “Image”, you can now refer to “Image A” and “Image B” and use the Vote A and Vote B actions accordingly.
No more votes available. Executes if no more vote pairs are at the moment available for the current user.

Vote A

Casts a vote for participant A, among the two participations A and B provided by successfully executing the Get Next Vote Pair action.

Vote B

Casts a vote for participant B, among the two participations A and B provided by successfully executing the Get Next Vote Pair action.

Datafields

The following datafields are available on the A|B Voting addon:

Participation Status

Unknown The Check Participation action has not yet been executed.
Has Participated The user has at least one participation.
Has Not Participated The user has 0 participations.

Karma

The current Karma points of the participant.

Top Media

A catalog with the nine most voted entries of the competition.

You can use the Catalog Presenter component from the tools menu on the left sidebar of the editor to present the top entries.

The data fields available when editing an item template inside the Catalog Presenter will be the same ones you have defined under Participation Data.

User Participations

A catalog with the current user’s participations.

You can use the Catalog Presenter component from the tools menu on the left sidebar of the editor to present the top entries.

The data fields available when editing an item template inside the Catalog Presenter will be the same ones you have defined under Participation Data.

One Addon, Multiple Pages

When you unbind an A|B Voting addon from a project, it is still be available for that project, but can now be simultaneously enabled on any other project, so you should only do this if you wish to use an A|B Voting addon in multiple projects.

To allow users to reutilize the same credentials across multiple experiences:

  1. Open the Addons menu on the right sidebar of the Editor
  2. Enable the A|B Voting addon and click Edit Settings
  3. Click to enter the A|B Voting addon you wish to use, or create a new one
  4. Click the three dots menu on the top right corner
  5. Select Unbind from page, then click Yes, unbind this A|B Voting addon

Important: This change is irreversible.

Updated on June 10, 2019

Was this article helpful?

Related Articles