All Collections
Christmas Advent Calendars
Introduction to the Calendar game
Introduction to the Calendar game

This article provides an introductory guide to getting started with the calendar game

Asta Dybdal avatar
Written by Asta Dybdal
Updated over a week ago

In a calendar, participants open a new door each day or each week. Behind each door is a quiz question, and if the participant answers correctly, they are in the drawing for a prize.

You as the game designer decide how many doors there are and when they can be opened. Most commonly, there are 24 or 25 doors in an advent calendar, but you can use the calendar in many creative ways.

Daily Calendar

Weekly calendar

Game settings

General game settings

This section gives an overview of the calendar settings under Game Settings > General.

How should the door open

  • If opening by scratch, you will define the size of the scratch area. You will also want to upload a scratcher icon under Layout (for desktop only)

  • If opening by click, you will decide what the field animation should be (see below).

Game content alignment

This controls whether the quiz question and answers are aligned in the left/right/center of the game addon.

Enable test date

This lets you simulate a date in the future using the Demo URL. This is how you can see what the calendar will look like when it is live. The test date can be enabled both in backend and in the frontend editor:

Show active prizes on the question

This feature is available for regular prizes only (not bulk prizes). If you have associated a prize with the field, information about the prize will be shown under the day's quiz question.

Field animation

  • Fade gradually reveals the image behind the door

  • Open creates a swinging door animation (works best for perfectly square doors)

  • Instant goes straight to the question without showing the image behind the door (note the image will still be visible on standard desktop calendars on subsequent days).

Field settings

The calendar works by creating date-controlled fields, which are active only on the day or during the date range you define.

Under Game Settings > Fields, you will find a list of all of your calendar's dates. These fields are linked to the right day on your calendar graphic under Game Settings > Layout.

In the daily template, there are 24 fields, one for each day in December. The weekly template has 4 fields, each lasting one week.

Editing a field allows you to edit everything that is specific to that date in your calendar, including:

  • when the field is active

  • what image is behind the door

  • the action (quiz, URL, or flowpage)

  • the question, answer, and feedback (if using a quiz)

  • the label on the door, if using auto-generated doors

  • the daily door graphic, for single-door calendars and mobile door graphics

  • which prizes are connected to the date

Field action: Quiz

The default settings of a calendar include a quiz question (or multiple questions). When the participant opens the door, they will see that day's quiz. You will have the following options for editing the integrated quiz:

  • include up to three answer options, either text or images

  • define the correct answer

  • include a link to where the participant can find the answer

  • add a video to the question

  • if using multiple questions, decide how many a participant must answer correctly to win the game

Field action: Flowpage

Instead of directing to a quiz question, you can set your field to instead go to a specific flow page. This could be if you are just using the calendar to give away prizes or share information.

When directing to a flow page from the game, you will likely want to have your registration page come before the game.

Our recommended flow is: Registration > Game > Winner page. You can activate autosubmit on your registration form if you don't want participants to see it every time they visit the campaign.

It is also possible to set up the flow of: Game > Registration > Winner page. In this instance, you may want to include a date control on your winner page so that you have a different page for each day or week of your calendar.

Another possible flow might be: Game > Winner page > Registration > Confirmation, if you want to show participants the possible prize before they register. But this flow is not likely to result in the highest conversion rate.

Field action: URL

Another option for your field action is go to URL.

This option is most often used to direct to another Playable game, though you can also link to another page on your website.

There are some things you need to keep in mind if you choose this options:

  1. Each game has to be built first. You will link to the game's Live URL.

  2. The statistics, prizes, and registrations on the different games are not connected. Registration must take place on the individual games in order for the prize logic to work.*

  3. The game experience will be better in an iframe. Otherwise, participants will be able to see the URL of the 2nd game in their browser. For more information about iframes, see the Publishing course.

*Based on browser cookies, the registration form in the 2nd game can remember the user's data if entered in the 1st game (the calendar). But this is only true if the registration form fields have the same names.

Also, make sure you are giving your participants the opportunity to accept your terms and conditions, if they vary from game to game!

Graphics and Design

In our Calendar design guide you will find our general recommendations for graphics sizing.

Calendar design and graphics (desktop)

When building a desktop calendar, the game settings you choose will depend on the layout you choose. You have three different options for your calendar background and doors:

  1. A calendar graphic where background and doors are combined

  2. A calendar background image where doors are generated by the platform

  3. Only doors

1. Calendar image where the doors are included in the image

This is the option you will choose if you are creating your own door graphic. Depending on the design, we recommend that your graphic measures maximum 1000 x 600px, which works on both desktop and tablet.

2. Calendar image without the doors

This is the option you will choose for a graphic background that doesn't include any doors. You will define in the platform

  • What the doors should look like, including door background, border color, border type, font type etc.

  • Where on this graphic the doors should be generated

You will upload a plain graphic background, again with a maximum size of 1000 x 600px.

3. Only doors

This is the option you will choose for a full-screen background and auto-generated doors.

With this option, you will not upload any graphics under game settings. You will only define the placement of the auto-generated doors.

A full-screen background should be at least 1600 x 1000 px (maximum 2560 x 1600 px), though the exact dimensions depend on whether it should be on the game flow section or the entire landing page.

Mobile specific design

On mobile devices, only one calendar door is shown at a time*.

Auto-generated doors

If you don't have a specific mobile design, you can use the platform's auto-generated doors on mobile, even if you are using a graphic on desktop.

This will generate a square door, 200x200px in size. If you enable extra theming, you can define the color, font, and border just like with auto-generated doors on desktop. In the image below you can see an example of an auto-generated door.

Mobile door graphic

To use a graphic on mobile, you will upload the image of the door and only the door.

The entire mobile door is the active area, so you will not set an active area on the mobile graphic the way you do on the desktop graphic.

This also means that any background you want for your mobile calendar door will be uploaded under the Layout or Style tabs.

When designing your mobile door graphic, remember:

  • The "image behind the door" should match the shape of the mobile door graphic. If your mobile doors and desktop doors are different shapes, you will upload two versions of this image.

  • If you are using 1 generic mobile door graphic, the platform can generate each day's number. The is the "mobile label" under Game Settings > Fields.

  • If you are using a unique graphic for each day, you will upload each day's mobile door graphic under Game Settings > Fields. Remember to delete the mobile label if your graphic includes a label.

*If your fields are date-ranges (weekly calendar), you have the option to place each of the 4 weekly doors on mobile. But this only works with an uploaded graphic, not with auto-generated doors.

Single door calendar

A single-door calendar shows only one door per day.

To build a single-door calendar, you need to upload your own door graphic. The platform's auto-generated door feature is not available with this calendar type. See this article for more information about the one-door calendar here.

Graphical assets

You can find a shareable design guide here.

Want to try building a calendar but don't have any graphics yet?

Download our graphics pack, with correctly sized assets for desktop and mobile!

You can also download design templates to help you build your own calendar graphic.

A summary of the recommended sizes for graphical assets:

Materials

Recommended Size

Full-screen background (desktop)

2560 x 1600 pixels

Full-screen background (mobile)

640 x 960 pixels

Calendar graphic (desktop)

1000 x 600 pixels

Calendar door (mobile)

200 x 200 pixels

Image behind doors (should match door dimensions)

200 x 200 pixels


Single-door graphic (front and back)

300 x 500 pixels

Prizes and prize sponsors

In a calendar game, you can use both bulk prizes and regular prizes. If you are in doubt about what prizes to use, you can use our guide to choose the right prize for your campaign.

Drawing winners

If you are giving out regular prizes, and don't want to have to manually draw a winner for every prize in your advent calendar, you can program the system to select winners automatically. This is especially helpful if you are offering one or more prizes each day throughout the campaign. You can find the settings for automatic draw under Prizes > Draw settings.

Tip: If you are offering multiples of the same prize for each day, it's a good idea to set up your automatic prize drawing before duplicating the prize. That way, your prize-draw settings will be copied into the new prizes and you won't have to adjust them individually.

Displaying available prizes

The prize add-on displays the prizes available in a campaign. This add-on works best in a calendar, where different prizes may be available on different days. By using the prize add-on, the prizes on display will automatically update.

The calendar game also allows you to display the prize directly under the quiz question. The right solution for your campaign will depend on what prizes you have and where you want to display them.

Displaying prize sponsors

If the prizes in your advent calendar are donated or sponsored by another company or organization, you can show your appreciation and recognition using the sponsor add-on.

Each prize can have a sponsor associated with it, and you can display this information along with the prizes or separately in your campaign. The sponsor information can be added under the individual prize settings:

Additional options

Creating a pre-launch campaign

It's common to set up a pre-launch campaign for your calendar to collect permissions and build anticipation leading up to December 1. There are several ways to design a pre-launch campaign. You can read more about the options in this article.

Adding snow animation

You can add falling snowflakes to your holiday campaign.

Add the snow integration under Integrations > Misc. > Particle Generator.

When you configure the integration, you can adjust the appearance of the snow:

  • if you want to use a specific image as your snowflake (select "custom variant" and upload up to 3 PNG images)

  • whether it should fall across the entire campaign landing page or just one section (usually the game flow section)

  • whether it should be visible throughout the entire game flow or only on a certain flow page


We hope that this article can serve as a good guide for getting started with the calendar. If you need further assistance, please reach out to our chat support!

Did this answer your question?