Introduction
...
The User Manual has moved! For the most up-to-date information, please visit our new site at docs.antavo.com.
We're committed to providing you with the best resources, and our new site offers an enhanced experience with the latest documentation. Thank you for your understanding and continued support.
The Instagram contests module facilitates brand owners to drive customer-generated content by setting up two types of contests:
Instagram #hashtag contest: the winner is the one who posts offers a prize to those who post the best picture using the brand’s #hashtag and mentions mention the @brand.
Instagram comment contest: offering offers a prize to those who leave the best comment on one either of the selected Instagram posts.
First, the connection configuration will be explained between Antavo and Instagram. Then, the two ways to conduct Instagram contests (hashtagging and commenting) will also be discussed.
Configuring the connection between Antavo and Meta
Instagram is part of Meta Platforms, Inc. (also mentioned as Facebook) and there are several prerequisites that need to be met on both Antavo’s and Meta’s platform settings to run the contests.
Accessing the Instagram Contests module
...
| Table of Contents | ||||
|---|---|---|---|---|
|
Find the configuration page of the module by clicking the 
icon in the sidebar. The page will open to the fields requesting the App ID and the App Secret.
Accessing the App ID and App Secret from the Developers’ app
First, you need to create an account in the Meta for Developers application and as soon as it is set up, the App ID and App Secret can be located under the Settings menu’s Basic page.
...
Paste the strings to the designated fields in the module settings in Antavo’s Backoffice, then click Submit. This will lead you to a link that asks you to Continue with Facebook.
Before connecting with Facebook, go back to the developers’ app. There are three products that need to be added here to run Instagram Contests successfully. These are:
Facebook Login
Instagram Graph API
Instagram Basic Display
After adding them, the next step is to go to the “Facebook Login” product. Click on Settings and add the Antavo brand’s URL to the Facebook login page’s Valid OAuth Redirect URL list. The following screenshot illustrates these three products and how to navigate to their Settings page.
...
Selecting the accounts where to run the contests
Afterwards, go back to the Antavo Backoffice and click on “Continue with Facebook”. Here, you need to log in with your company’s Facebook account which also has an associated Instagram business account. This login will lead to a page where you need to pick the specific Facebook page and the Instagram business account where you wish to run the contests.
Creating a card for the customer
The final step to configure your brand’s loyalty settings with Meta is to create a card that serves as a bridge: by using the URL generated by this card, your customers can connect their Instagram accounts to their shopper accounts.
...
Creating Instagram contests
Go to “Create new contest” the list of contests that have been set up previously with the following information:
Name of the contest
A text label below the name specifies the status of the contest.Type of the contest
Start date
End date
Connecting your Instagram account
Before you can create a contest, first you need to make sure you have connected your Instagram app created under your Facebook Business Account by entering the credentials under the Social accounts module.
On the module configuration interface, you’ll find a 'Continue with Facebook' button that will redirect you to the page where you can give access to your Facebook Business Account through the app that has been connected under the Social accounts module so that Antavo can query the contest entries from the Instagram page.
...
Once you have connected your Instagram account, you can start creating contests.
Creating a new Instagram contest
Click ‘Create new contest' in the left-hand side menu of the module
...
Instagram Hashtag contest
Except for Description, all of these fields are mandatory to fill for this type of contest:
Name
Description
Starts at
Ends at
Hashtag – specify here
Select the type of contest you’d like to create
Click 'Next’
...
Instagram hashtag contest
Basic information
Name
Set the name of your contest.Description
Describe the specifics and rules of the contest.Starts at
Set the start date of the contest.Ends at
Set the end date of the contest.
...
Hashtag
Specify the #hashtag to scrape from Instagram. The
...
contestant has to fulfill the following criteria to be eligible to participate:
use this ‘#hashtag’ to tag the picture they wish to submit to the game.
In order to successfully participate in the game, the players also need to mention your brand’s business account in their post’s text using a @ sign, for example.
...
image
mention your ‘@brand’s business account’ in the post
...
Points economy
If your brand uses Multi-accounts, use the ‘Accounts’ field to select the account to which the related events and earn points should be registered.
...
Click ‘Create’ to finalize the setup.
Instagram comment contest
Except for Description, all of the fields are mandatory to fill for this type of contest:
...
Name
...
Description
...
Starts at
...
Ends at
...
Basic information
Name
Set the name of your contest.Description
Describe the specifics and rules of the contest.Starts at
Set the start date of the contest.Ends at
Set the end date of the contest.
...
Instagram Settings
Select the post. You will be offered a list of posts that are already uploaded to your
...
connected Instagram
...
account.
...
Select the one you wish to present as the topic of the contest.
...
Running Instagram contests
There needs to be a Cron job set up to fetch the data from your contests to Antavo’s system. Follow these steps to create the job.
...
Go to the Cron page by clicking the Admin settings in the bottom left corner.
...
Give a name to the job and set the status to Active.
...
Type in your brand’s name.
...
In the Task field, put “instagram-contests”. Note that these need to be all lower-case, otherwise the job will fail to run.
...
and as action, type “processComments” or “processHashtag”, depending on the type of game you wish to submit.
...
The contestants need to fulfill the following criteria to be eligible to participate:
comment under the selected post
mention your ‘@brand’s business account’ in the post
Points economy
If your brand uses Multi-accounts, use the ‘Accounts’ field to select the account to which the related events and earn points should be registered.
Click ‘Create’ to finalize the setup.
Activating a contest
After saving for the first time, the status of an Instagram contest is ‘inactive’, which means it appears only in the list of contests on the module configuration page.
You can activate it right away using the ‘Set active’ button on the upper right-hand side of the setup page and confirm the activation in the dialog that subsequently appears.
...
Entry logs
A instagram-contests cron job is automatically created that periodically checks the Instagram account for new entries to any Instagram contest that is running currently. The default frequency of the cronjob running is 1 hour for comment contests and 15 minutes for hashtag contests. You can modify the interval under the Jobs tab of the Settings menu.
| Note |
|---|
Please note that the Entry logs list all the posts or comments that fulfill the entry criteria, regardless of the Instagram user being a loyalty program member or not, and Antavo can only identify the owner of the entry if the contestant’s Instagram username is populated in the |
Instagram hashtag contest
When a new post is found by the job, an instagram_contest_enter event is registered with the instagram_mentions attribute value on the customer’s events history, and the post is added to the list of entries under the Entries tab.
...
Instagram comment contest
When a new comment under the selected post is found by the cronjob, an instagram_contest_enter event is registered with the instagram_comments attribute value on the customer’s events history, and the post is added to the list of entries under the Comments tab.
...
Selecting winners
Navigate to the Entries/Comments tab
Tick the checkbox next to the entries that you’d like to select as winners
Click the ‘Select winner’ button that appears at the right-side end of the green bar
...
When the ‘Select winner’ button is clicked, the instagram_contest_non_winner/ instagram_contest_winner events are automatically registered on the event history of each contestant, in case the contestant has the Instagram username added to their profile.
Managing contests
Edit a contest
Navigate to the Contests tab
Click the ‘Edit’ button of the contest you want to edit
Edit the contest
Save your changes by clicking ‘Update’
Deactivate a contest
Follow these steps in case you chose to inactivate a contest:
Navigate to the Contests tab
Click the ‘Edit’ button of the contest you want to inactivate
Click the ‘Set inactive’ button on the upper right-hand side of the page
Confirm your choice in the dialog that appears
Archive a contest
You can delete inactive contests by archiving them.
Navigate to the Contests tab
Click the ‘Edit’ button of the inactive contest you want to archive
Click the ‘Archive’ button on the upper right-hand side of the page
Confirm your choice in the dialog that appears
Archiving is irreversible. Once a contest is archived, it cannot be restored anymore.