The Instagram contests module allows you to drive customer-generated content through two types of contests:
Instagram #hashtag contest: Participants compete by posting their best picture using a #hashtag and tagging an @account
Instagram comment contest: Participants compete for a prize by writing the best comment to a selected Instagram post.
To access the configuration page, open the Modules menu and search for the Instagram contest module. The page displays a list of previously set-up contests, providing the following information:
Name | The name of the contest. A label below the name indicates whether the status is active or inactive. |
Type | The type of the contest |
Start date | The start date of the contest |
End date | The conclusion date of the contest |
Connecting your Instagram account
Before creating a contest, ensure you’ve connected your Instagram app created under your Facebook Business Account by entering the credentials in the Social accounts module.
On the module configuration interface, locate the Continue with Facebook button. This button redirects you to authorized access to your Facebook Business Account via the connected app. This enables Antavo to retrieve 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
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
Define the unique #hashtag participants must include in their Instagram posts to enter the contest. To qualify, contestants must adhere to these requirements:
Use the specified #hashtag in their post.
Tag the specified @account in the post.
Points economy
If your workspace 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
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
Choose the post from a list of those already uploaded to your connected Instagram account. Contestants must meet the following criteria to be eligible to participate:
Comment on the selected post.
Tag the specified @account in the comment.
Points economy
If your workspace 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 the initial save, the Instagram contest will be saved as inactive, appearing only in the list of contests on the module configuration page.
To activate it, click the Set active button in the upper right-hand corner of the setup page and confirm the activation in the subsequent dialog.
Entry logs
An instagram-contest cron job is automatically created to periodically check the Instagram account for new entries in any running Instagram contest. By default, the cron job runs every hour for comment contests and every 15 minutes for hashtag contests. You can modify this interval under the Jobs tab of the Settings menu.
Please note that the Entry log displays all the posts or comments that meet the entry criteria, regardless of whether the Instagram user is a loyalty program member. Antavo can only identify the owner of the entry if the contestant’s Instagram username is provided in the instagram_username customer attribute.
Instagram hashtag contest
When the job discovers a new post, it registers an instagram_contest_enter event in the customer’s event history with the instagram_mentions attribute value. Additionally, the post is included in the list of entries under the Entries tab.
instagram_contest_enter event is registered in the customer’s events history
.png "mention_IG(1).png")
Entries are registered under the Entries tab of the contest
Instagram comment contest
When the cron job discovers a new comment under the selected post, it registers an instagram_contest_enter event in the customer’s events history with the instagram_comments attribute value. Additionally, the post is included in the list of entries under the Comments tab.
instagram_contest_enter event is registered in the customer’s events history
Entries are registered under the Comments tab of contest
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 in the event history of each contestant if the contestant has their 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
Make the necessary changes
Click Update to save your changes
Deactivate a contest
Follow these steps if you want to deactivate a contest:
Navigate to the Contests tab
Click the Edit button of the contest you want to deactivate
Click the Set inactive button in the upper right-hand corner 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 in the upper right-hand corner of the page
Confirm your choice in the dialog that appears
Archiving is irreversible. Once a contest is archived, it cannot be restored.