Instagram contests

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:

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 #hashtat 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 on 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.

Instagram hashtag contest

When the job discovers a new post, it registers an instagram_contest_enter event is registered 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 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.

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, 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

• 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 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.