Facebook Actions
This documentation covers the actions and integrations that we support from Facebook.
Applications that support Facebook actions:
Want to run a Facebook contest but not sure where to start? Check out everything you need to know about running Facebook contests with Gleam including powerful demos, best practice examples, feature breakdowns and expert guides.
Authentication
If a user tries to login or perform any Facebook actions that require authentication then they will be asked to authorize the Gleam Competitions Facebook app.
Check-in
The Facebook Check-in action allows you to award an entry if users check-in or have previously checked-in to a specific location on Facebook.
This action is perfect for local businesses, or businesses that have a physical location that users can check into. It's also a fantastic way to incentivize loyal customers.
Admin View
Public View
This action cannot be validated automatically because Gleam does not have access to the entrant's Facebook posts
Entry / Login / Connect
The Facebook Entry action allows you to award an entry for logging into Facebook within the widget. The action has two states, you can award the entry right away, or you can optionally ask the user to Like your Facebook page after login.
This option is preferrable to the Visit action if you are running a contest inside a Facebook Tab, as it will keep users on your Tab rather than sending them away unnecessarily.
Admin View
Public View
Visit a Page
The Facebook Visit action allows you to ask a user to visit a specific Facebook page. If they like the content they might interact with your page or comment on some of your posts. They will also have the option to Like the page after visiting, this is a completely optional step.
Admin View
When setting up the action you will need the URL of the Facebook page, the name of the page then any specific instructions for the user to complete.
You also have the option to ask users to:
- Optionally Like a Facebook Page
- Spend x seconds on the Facebook Page
- Optionally answer a question about the Facebook Page
Public View
Users cannot complete the action until they visit the Facebook page, after which they can show their appreciation by also Liking it (provided they like the content).
Liking is a completely optional step & cannot be mandatory for the action to be completed.
Like a Page
Select a Photo From Facebook
Gleam makes it easy to run photo competitions - The Facebook photo select action allows you accept photo submissions from a users Facebook feed or albums as a competition entry or to unlock a reward.
Admin View
This action is very easy to setup, just give it a title (i.e. Select a Photo From Facebook or Show Off Your Latest Style) then give the user some instructions.
Tip: You can use the description to make it clear to the user that the photo must first exist on Facebook before they are able to select it for submission.
Restrict Selection to #hashtag
This will only show the user any photos that contain a specific #hashtag. If the user only has 1 photo with the required #hashtag then the action will automatically complete, if there's more than 1 then the user will be allowed to choose which to submit.
Automatic Imports
You can setup the Facebook Select action to automatically import photos from certain Facebook sources on the Business plan:
- Posts to Page: Import photos that have been posted publicly to any Facebook Page
- Post Comments: Import photos that have been posted pulicly in the comments of any Facebook Post or Photo
Public View
When the user clicks the action we ask them to authenticate with Facebook (if they haven't already), then they will be able to choose from their last 21 Facebook photos to submit.
Facebook Photo / UGC Galleries
Gleam has the ability to send images submitted from the Facebook Selection action into a beautiful photo gallery.
The Gallery can be installed inside a Facebook Tab or even embedded on your own website.
You can do this by selecting Galleries in the left hand menu, creating a new gallery & choosing the campaign which feeds it photos on the Import tab. You can also choose to automatically show all photos or put them into a moderation queue before they appear in the gallery.
Check out this guide for more information on how to setup a Photo Contest on Gleam.
View Post
Draw attention to a specific Facebook Post or Video with the View Post action, users are welcome to optionally engage with the post if they find the content meaningful.
Admin View
Public View
Viral Share
One of the most requested action types is asking users to share something on their personal timeline, however Facebook's policies do not permit you to directly give entries for this. This means that you can't give an entry for sharing a link, but you can give entries to users when they successfully refer a user via a shared link.
You can get users to share your competition on Facebook using our Viral Share action type. This will give users entries when they refer friends who successfully enter the competition.
Please note, users will not see an increase in entries until they sucessfully refer someone that enters. Regardless of how many time they share your link.
Admin View
There's quite a few options to setup this particular action. First give it a title, how you define the title can greatly impact whether or not people will share it.
The second option allows you to lock the Viral Share until the user completes a certain number of other actions first. For example you may not allow users to share until they first like you on Facebook or join your email list.
You can choose to show the share option with any mandatory action types you have created. However the share itself won't count towards a mandatory action (but will still allow users to do it).
The default share text is used for everything except Facebook sharing, the text you see here is pulled from the description on your prize. This allows you to have separate text for both Twitter & Facebook.
Public View
This is what the users will see, they are free to take the link generated & share it wherever they want. You also have control over which sharing buttons are present by default.
Share View
If a user shares to Facebook this is the popup they will see, there's a few important areas to cover here.
Image
By default we use the prize image as the og:image that gets shared on Facebook. If you want this image to show you must have a feature image that is at least 287px high.
If you want the image to work perfectly when someone Virally Shares on Facebook then use 1080px x 567px.
Custom Share Image
Business users have the ability to add a Custom Share image to the campaign. This means you can make your Feature Image whatever size you wish (or use the Carousel).
The recommended Facebook Image Size for the custom share image is 1200 x 630.
Description
We currently pull the description for the Facebook share from your Prize. However if you set the Default Share Text during the setup of the action that will be used for everything except Facebook.
Facebook Competition Example
We've created an example competition that you can play with, it contains all of the actions that we've covered in this guide.
Facebook Contest Guides
We have a number of other resources and guides that can help you get more out of your Facebook contest with Gleam.
40+ Facebook Contest Tips + Tricks Using Gleam
The Ultimate Guide to Running a Facebook Contest
Facebook Photo Image Size Guide
Known Facebook Issues
Invalid Page ID
There will be certain scenarios when we're unable to find the PageID for a particular page due to their settings. In this instance you will be required to enter the PageID manually.
On Facebook The PageID is located here: Edit Page -> Edit Settings -> Page Info -> Facebook Page ID
Pages With Location Restrictions
Having certain country or strict age restrictons on a page can make it appear blank when users try to like it within the widget.
Facebook Groups
It is not possible to put in a Facebook group page into the Facebook Visit action type, you can just use a normal Visit action.