Adding and configuring a new campaign

What is it?

ITONICS Campaigns support you to run multiple campaigns of different type, scope and workflow in parallel. This is particularly helpful if you have multiple departments involved who want to run their own idea campaigns, i.e., have individual stage-gate processes.

Learn in the following article more about

• (1) Creation and definition of the basic campaign information
• (2) Invite users and manage the specific campaign's accessibility
• (3) Define the campaign workflow and permissions
• (4) Define the rating criteria
• (5) Define the submission form
• (6) Assign users to manage a campaign

How does it work?

(1) Creation and definition of the basic campaign information

To create a campaign, find the create button in the top navigation menu. A popup will open from which you can decide whether the campaign should be always open for idea submissions or whether the submission phase is bound to a specific timeframe (time-bound).
Please note that your Application Owner has defined who has access rights for creating campaigns.

You are also asked whether you want to define the campaign visibility, workflow, and submission form from scratch or whether you want to rely on a blueprint.

After hitting "next", you will be asked to fill in the general campaign information. You need to provide a campaign title, abstract, and start date. You can also add a banner image, tags, a description, an end date, name a campaign manager, or add custom fields/rename existing field names, text fields, or help texts via the entity configuration of the campaign entity.

(2) Invite users and manage the specific campaign's accessibility

After filling in the general information, you will be asked in the visibility tab to define who can access the specific campaign that you are creating. You can choose from two different options to grant visibility.

1. Choose to invite all users if you want to give all users view access to the campaign.
   
   Note: If a user has no permission to see the entity type (campaign entity), they will not see this specific campaign. If you check the Send notification to the invited users' checkbox, a warning message will appear to prevent you from mistakenly sending out notifications to a large number of users when creating a campaign element.
2. Choose Others if you want to restrict the visibility of this element further. Now, no user can view the element except for the ones that are added via the search field below (5). You can add single users, user groups, roles, and contexts.

You can also define whether the list of idea submitters should be displayed or not. Everyone invited to the campaign will see a participant tab if the checkbox is activated.

(3) Define the campaign workflow and permissions

The workflow of every campaign can in theory differ. When using the campaign blueprints you don't have to worry about the workflow configuration since you are relying on a predefined process for frequent campaigns. However, if you have designed your campaign from scratch, you need to define the following.

Under the 'workflow configuration' tab, you are first asked to provide the different phases of your campaign. Afterward, you can define the specific actions per phase.

You can either use already existent phase names or create a new phase (name) by using the add phase button. If you 'add a phase', you will be asked to provide a name for this phase. After providing the title and adding the phase, it will be displayed in the phase selection menu. Select now the phases for your campaign by checking the respective box(es). You have to select at least two phases to start the campaign.

The phases will be later displayed on the campaign page as a pearl chain. 

Based on the role definition in your application, you will now find a permission scheme for each phase that you have activated. By using the drag-and-drop option, you can also adjust the order of the phases to reflect the right logical sequence.

The displayed permission options include permissions to create, edit, view, delete, or rate submissions. From the scheme, you can select what permissions should be granted to the respective user roles per phase. By checking the box on the left of each permission, you can grant the permission to all roles at once.

(4) Define the rating criteria

For some of your phases (or all), you might want to use specific evaluation criteria. By clicking on "Configure Ratings" at the end of a scheme, you can define your rating criteria.

You can either select already existing rating criteria or create new rating criteria by clicking the button at the bottom left. If you create new rating criteria, you will be asked to provide a label, a tooltip (optional), and the rating range as well as the names of the values.

You can also configure individual permissions for each phase for which ratings are enabled.

Just type in a Username, Role or Group you want to grant access. If you leave the field empty only the bulk assigned evaluators from the selected phase will be able to rate. 

If at least one rating criterion is chosen, the rating will be displayed as standard rating. If more than two criteria are selected, the spider rating will be displayed. This defines the form of how users are asked to rate and also how the different ratings are displayed in the rating analysis tab. Please note that for the spider rating, you need at least three rating criteria to be selected to span the spider.

(5) Define the submission form

The submission form comes with standard form fields like Title, Header Image, Abstract, Description, Tags, and Authors. By clicking on the arrow of the respective field, you can adjust the title, help text (if it is a text field), tooltip, and for the authors' field the provided permissions for users being mentioned in this submission field (read more below). 

If you like to ask for more information, you can also define your own, additional fields, such as:

• Single Choice (dropdown field)
• Multiple Choice (dropdown field)
• Textfield
• Textarea
• Rich Text Field
• Date
• User

Click on the Add Field button at the bottom right. You will see that a new placeholder has been added to the list, and you are now asked to further configure it.

First, you need to select the field type on the right-hand side.

After the selection, you can then provide the other details, such as the field name, values (only applicable for dropdown fields), and validation options.

Within the validation options, you can indicate whether a field is mandatory, in which phase it should be displayed, and who should be able to see the field in the create/edit submission form and later submission view form.

As mentioned before, you can name multiple authors in the author field, and with that, you can grant more specific permissions to those authors (besides the create and edit permissions granted in the workflow definition). This is helpful if you want to enable an idea submitter to assemble a team of people to collaborate on ideas. The submitters can indicate other users to join as authors. Authors can get View and/or Edit permissions for the respective Idea.

Note 1: By default, the Authors will not get any permissions for the idea. The Campaign Managers have to adjust the settings accordingly. 

Note 2: The default tooltip is not appropriate for all settings. Please make sure to adjust it according to your settings. However, the creator of the submission must be allowed to view and/or edit the element in the current workflow phase via the workflow configuration tab. Otherwise, the other authors will not get the indicated permissions. A (co-)author has never more permissions than the creator of the submission.

Note 3: Authors will not automatically have permission to view the campaign if they are added to a submission. This needs to be handled from the visibility tab of the campaign (and the user needs in general permission to view any campaign).
The author field only suggests users that are already invited to the campaign.

Note 4: All fields can be selected as mandatory except for title, abstract, and authors.

Last but not least before publishing it, you can also add relations to other content elements in your application.

(6) Assign users to manage a campaign

Assigning one or more users as campaign managers for specific campaigns allows users from within your organization to set up, host, and manage the campaigns. Distributing the work of managing campaigns enables shared responsibility that furthers transparency.

When creating a new campaign or editing an existing campaign, there is a user search field called Campaign Manager in the General Information Tab. You can assign one or more users from the system to this field. Make sure to hit the Save button at the bottom of the page

On the detail page of the Campaign, all users with permission to edit the campaign see an action button Add more next to the Campaign Managers field in the sidebar. (1) Clicking on the button opens a popup window that shows all recommended campaign managers, based on the interests that have been added to their user profile (2), and a user search field to add Campaign Managers manually (3). Make sure to hit the Save button at the bottom of the popup window once you have made your changes. 

Campaign Managers have permission to view and edit their specific campaign regardless of their role. Users assigned to the Campaign Manager field do not necessarily need permission to "View all Campaigns" or "Edit all Campaigns" which can be given to the individual roles via Entity Configuration.

Note: the campaign manager field can not be deleted or deactivated via the Field Configuration in the Entity Configuration. But you can edit the Tooltip and the Help text.