Skip to main content

Tutorial - Swiper

Description

The Swiper module allows you to easily collect feedback from your community about your brand, products, offers, or services. Users interact by swiping a visual to the left or right to indicate their preference. You can also offer additional options such as Super Like or Joker. This module is accessible and particularly suited for Mobile first campaigns.


Creating Graphics

To get started, please check the page that provides all essential information for creating graphics for your campaign. For Swiper-specific elements, please refer to the dedicated article.

If you want to include game variables on your background, leave space for them in your design.


User Flow

The Swiper template is composed of four pages. The Form page allows you to collect user information. The Swiper page is where users swipe visuals. The Result page shows user preferences. The End-of-campaign page marks the end of the campaign.

You can add additional pages and game mechanics if needed. We recommend adding a welcome page and a teaser page. Set up your campaign parameters, including the publication dates, rules, and privacy policy.


Backgrounds

Import your Web backgrounds by clicking the plus icon in Background Image. For graphic specifications, refer to the Game Design section. You can also add a solid background color around your game pages to match your brand or unify the campaign visually.


Settings

  • Set the number of participations per day, week, month, or campaign per user. Create and select your Already Played page. Users who try to play again will be redirected to this page.

  • Choose the swipe actions for left and right to assign Like or Dislike. By default, a swipe to the right is a Like. If there is a tie at the end of the campaign, the first visual liked will be shown as the favorite. For a Top 3 result page, the three first liked visuals are displayed.

Display swipe buttons to show Like and Dislike options. These buttons are optional and users can always swipe directly on the visual. If disabled, the change will apply to both Web and Mobile views.

You can limit the number of visuals displayed per session. If this option is not activated, the session ends when all uploaded visuals have been displayed.

The minimum number of visuals is two, but we recommend at least ten for better weighting. The maximum number of visuals is one hundred per session. For visual formats and maximum numbers, consult the Swiper graphic specifications.

Enable the Joker option to let users skip a visual without voting. No points are awarded. You can define a maximum usage. Jokered visuals move to the top of the game area. If the visual limit is active, a Jokered visual is still counted as displayed.

Enable the Super Like option to let users emphasize a visual. This gives two points to the visual and can have a maximum usage. By default, Super Liked visuals move to the right like a standard Like.

Select the result page such as a Thank You page or a Top 3 Most Liked Visuals page using dedicated variables. This module does not use scores, so Score to Reach or Winner/Loser pages are not available.


Points Distribution

Points in Swiper are not for grading user performance but for evaluating preferences. Different user actions have varying point values. Points for each visual are available in your export data and campaign statistics.

One point is given for Like. Two points are given for Super Like. Minus one point is given for Dislike. Zero points are given for Joker.

Only positive scores are displayed to users. Negative scores appear as zero. In exports, negative scores are preserved for complete ranking.


Content

Select None if you want to import all visible photos for voting. Click Import Content or go to the Media section of your campaign.

To use media from another page, select the Upload Media page, or a Customizer or Shopping List page if your Swiper votes on user creations.

Filter by category if a page is linked to show only specific categories. Show only approved media to make moderation mandatory before visuals appear. Enable random content display to shuffle visuals per session and prioritize unseen content.


Upload Media

You must publish your campaign once before importing media.

To import predefined photos, go to Users or click Import Content. Select Media and click Import Media. Upload images, keeping them under 400 KB for optimal performance. Fill in name, description, category, URL, language, and other information. Photos are then ready to configure.

Visually check the campaign during testing as previews in the editor do not reflect final appearance.

For multiple Swipers, divide categories and assign each visual to the correct Upload Media page and category. Refresh the page to apply.

For multilingual campaigns, duplicate visuals per language and assign each visual to the appropriate language flag. Only one language can be assigned per visual.


Appearance Customization

Choose a border type or no border. Customize color, size, and roundness. Add drop shadows for depth. Activate Like and Super Like animations to highlight user preferences.

Visuals can appear with fade, from top, bottom, left, right, or both sides. Swiped visuals can disappear with fade, bounce, fall, rotation, scale, or a badge.

Visuals can be portrait, landscape, or square. The module adapts visuals to the customized border.

For Liked or Super Liked visuals, shapes include heart, star, circle, diamond, and square. Effects include beating, shaking, and sparkling.

Animations are not visible in the editor preview and must be verified during testing.


Variables

You can show the visuals most liked by the user, display the names of most liked content using the %swiper_content_name_X% variable, and add buttons linking to content-specific URLs.


Mobile Setup

After configuring your Web campaign, switch to Mobile view to import dedicated backgrounds and format pages. Follow the same process as for Web backgrounds.


Testing and Publishing

Preview and test your Web and Mobile versions. Check essential points in the relevant article. Once tested, publish your campaign and share it with your audience.


Data Export

Participant export includes the number of Joker, Super Like, Dislike, and Like actions per user, as well as the names of most liked visuals. Participation export includes each visual viewed with its associated flags, points, and tags.


Statistics Analysis

The Clicks graph shows the percentage of Like, Super Like, Dislike, and Joker per visual, globally or by page or tag. The Top 10 Content graph shows the most liked visuals with cumulative points.

Visuals in this article are used with permission from Stanley Chow.

You need inspiration ?

Did this answer your question?