Contest app for Facebook Page/tab

Create Facebook Tab with the contest and add this tab to your Facebook Page.
Users can like your Facebook Page (fanpage) or go to it through link above the app.  You can also require liking your fanpage before entering the contest.

See sample contest app as Facebook tab:


Special requirements for Facebook applications

To run a contest on Facebook just set up a contest on competizer platform the same way as website contest . 
Just remember about those details:


  • Remember that contest would be displayed in a 810px frame. Use template "Facebook tab" or other responsive template, which will serve wider layout outside the Facebook.
  • Max entry width that would fit Facebook layout is 780px (for 810px FB frame).


  • Set up Internet Address under your custom domain or
    It will be necessary to enable mobile Facebook users to see posts in mobile Facebook application and enter contest via mobile browser (as Facebook mobile application doesn't serve apps).
  • Make all external links to be opened in new window (ie. links to your site, links on banners etc.).
    If you edit links in source mode apply target property:
    <a href="http://www...." target="_blank">Link</a>
    This is necessary as facebook application is displayed as iframe and you don't want to open those links under Facebook...
  • Don't use external layout if you want to use contest as application on Facebook. 


  • In rules add acknowledgment that the promotion is in no way sponsored, endorsed or administered by, or associated with, Facebook.
  • Disclosure that the participant is providing information to you (an organizer) and not to Facebook.


Basic steps

Competizer doesn't require access to your Facebook admin account, so you can feel confident and safe. The application that you will use will be your own, so you would be able to use all customization and branding options provided by Facebook for applications. All you need to do is:

  1. Integrate with Facebook
    Sign in on Facebook and create new app. 
    When you are ready copy and paste application identification numbers to competizer.
    (It's compulsory for all contests, even if not run as contest on Facebook).
  2. Set up Facebook Tab 
  3. Add contest app as tab to your Facebook Page.
  4. Test, promote the contest, follow statistics.

How to do this? Find detailed step by step instructions below.

To go smoothly through all steps I'll give you advice:
Keep one browser window with Facebook settings opened and the second with the admin for Competizer and switch between those windows while following next steps.

I. Integrate with Facebook

Sign in on Facebook and create new app.

When you are ready copy and paste application identification numbers to competizer.

Read this tutorial to find out how to do this step by step.

  1. Please note: you must have verified your Facebook personal user account to create apps on Facebook. 
    Click here for more information on verifying your account.
  2. Go to
  3. Click on "Add a New App" button.
  4. In the form that will appear type "Display name", it could be a competiton title or domain name.
  5. Add contact email and choose category Promotions and Contests (or other).
  6. Then...

    1. Choose Settings.
    2. Below the form click on "+Add Platform" and add Website.
    3. Provide your contest Site Url starting with http://
    4. Add App Domain - the same domain, but without http://
    5. Optionally add links to Privacy Policy and T&C (you can also add them later). 
    6. Save Changes
  7. Facebook generated special account for you with unique App ID and App Secret.
    Apply Facebook integration settings in competizer, which are available:
    • on the level of one contest in Setup&edit > Main > Internet address > Facebook integration settings
    • if you are going to use one domain for multiple competitions you can add it once. If you are site admin, go to Company setup > Domains and edit or add new domain. There are also Facebook integration settings.

      Copy codes from Facebook for developers and paste in Facebook integration settings in Competizer as follows:
    • Find App ID and paste in Competizer Facebook integration settings into Application ID. Then copy App Secret

      and paste it to Application secret:

      And Save.

  8. On Facebook go to App Review and switch the app to public.


Now your contest is integrated with Facebook, which means that users may sign in with Facebook.

Entries in the contest could be shared, commented and liked. All those actions could be displayed on user's wall. Check here how to customize shared entries descriptions and image.

II. Set up Facebook Tab

You can set up tab for Facebook if the contest is in a FULL option.

  1. Go to Competizer admin, find Summary of the contest. Here you can find addresses and other settings that would be used to set up tab on Facebook as listed below:

    Summary for settings in Facebook
  2. Go to and click on Edit app button.
  3. In Basic Info add  Namespace: short name of the contest. It can only contain lowercase letters, dashes and underscores.
    It won't be visible for users, it's only for technical purposes.
  4. In Basic Info add second domain in App Domains:
  5. Turn on Page Tab:
    • provide user friendly Page Tab Name
    • add Page Tab URL starting with http://
    • add Secure Page Tab URL starting with https://
      Make sure there are any empty spaces before or after those URLs!
    • set width to Normal (810px)
    • add 111x74 tab icon
    • Save changes.

The tab is ready, now could be added to your page.

Set up Facebook Tab as default contest address

You can skip this part if you primerly want to run contest on www.

Follow these instructions if you want to primerly run contest on Facebook Page tab. 
  1. Make sure that your fanpage already has custom URL (without numbers). If not yet then go to and set a username. This will make it much easier to share and promote your Facebook page by the way.

    Sample good URLs:

    Sample bad URLs:
  2. Go to Setup&Edit > Main > Internet Address and click on add another internet address. Scroll down and find Facebook > Page tab form.
    Add Page Username.


    Page Username is bold green:
    so in the form should be placed WebestPL.
  3. For the tab address check: Default 
    It will redirect users that would find any post or ad to your contest to the tab on your fanpage.
  4. For Facebook Integration settings add Application ID and Application secret.
    You can find them in application settings on Facebook.
    App ID and APP Secret
  5. Save.
  6. In Competizer go  to your www address settings and check:
    Use for sharing and mobile devices  
    Then in some cases (ie. hen exact internet address is displayed on shared post or if user goes to the contest from the post in mobile FB app) this address will be used.
    (If you don't provide your own domain then optionally use your free domain for sharing and mobile devices).
  7. Go to Summary. Copy Default address, that would look similiar to this:

    Go back to Facebook for developers and in Basic section and paste it to Website with Facebook Login

    There is Invite friends link in main menu available for users that sign up with Facebook. Invited friends would be directed to the address you've just set (so directly to your tab).

  8. If you want to require liking your fanpage before entering the contest than go to Setup&Edit > Options > Facebook Tab and check User have to like a Facebook page before entering competition
    Add info as text or as image which would guide users to the Like button on the top right. 
    It's also good idea to provide some info about the contest: what's about, what are prizes, what's the task to encourage users to like and enter your contest.

III. Add contest app as tab to your Facebook Page

  1. Go to Summary of the competition and in Facebook section find link Add Page Tab. Click on it.
  2. Choose your Facebook Page, where the tab should be added.

Now your custom Facebook tab should be included with your standard tabs like Photos, Events, etc.
If you'd like to re-order the tabs on your page, hover over it in the 'Views & Apps' part of your page, click the pencil button, and replace that tab with another from your list of available choices where it reads "Swap position with." Make sure it's visible above the tab fold when the contest is open.

Place the contest on multiple Facebook pages

If you have partners or sponsors they can also have the same contest on their page. If you are an admin of their pages just Add Page Tab to the other pages. If you are not then right click on this link in competizer tab, choose "Copy link location.." and send it to the admin.

Only one of the tabs could be the default one (it's the tab where users are directed from posts), but each one could gather page likes (by the buttons provided by Facebook above contest canvas) separately.

IV. Test, promote the contest, follow statistics.

In the contest Summary you can find list of Online links:

  • Promote this address - it should be your domain (follow instructions in admin if not set yet). If you use redirection for main domain you can promote main domain instead. 
    Use this address to promote the contest on your website, on Facebook, in advertisements.
  • Default address - it's where you want to direct your users: it could be contest on Facebook or your domain.
  • System address - this address would be always available, even if you wouldn't set up your domain, so you can use it for testing purposes.

Test like gate

If you are admin of the application then you will always have the access to the contest even if you don't like your fanpage.
So if you want to check how the  Page displayed before the user likes a Facebook page looks like then sign out from Facebook or open contest in other browser, where you're not signed in.

Follow statistics

Facebook provides detailed analytics about the demographics of your users and how users are sharing from your contest whether they sign up with Facebook or only like, share or comment with Facebook on the contest website or within Facebook app.

These reports include rich data about users sharing content within Facebook and other Facebook-enabled apps no matter where those activity originated. For example, if a user puts a URL from your contest into a Facebook status message, that data is included in the analytics.

Facebook statistics include:

  • Daily, weekly, and monthly active users, app growth by number of new users, and overall user demographics: gender and age, countries, towns/cities, language
  • See how people react to the stories your app publishes via the Open Graph API on timeline and news feed on the web.
  • Clicks to apps on Open Graph or stream published stories made by users on mobile devices
  • and many other.

To find all stats go to and choose your app (if you have few of them). On the dashboard you can see some basic Insights. If you want to go to the details click on See all link on the right.

App statistics