Introduction

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 the best picture using the brand’s #hashtag and mentions the @brand.

• Instagram comment contest: offering a prize to those who leave the best comment on one of the selected Instagram posts.

This document introduces how to set up the module in the Backoffice and in the Meta for Developers application. First, the connection configuration will be explained between Antavo and Instagram. Then, the discusses 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.

...

and the ways to set them up.

Configuring the Instagram contest module

In the Antavo Backoffice, go to the “Modules” 'Modules' icon on the sidebar, search for “Instagram contests”'Instagram contests', then click on enabling configuring the module to access the configuration page. 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:

• Facebook Login

• Instagram Graph API

• Instagram Basic Display

...

After adding them, the next step is to click on the “Facebook Login” product. Go to Settings and add the Antavo brand’s URLs to the Facebook login page’s Valid OAuth Redirect URL list.

The following URLs need to be whitelisted:

https://loyalty.{stack}.antavo.com/{brandID}/extensions/instagram-contests/settings/connect/callback

https://loyalty.{stack}.antavo.com/{brandID}/extensions/instagram-contests/settings

https://loyalty.{stack}.antavo.com/{brandID}/extensions/instagram-contests/settings/connect

Selecting the accounts for contests

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 proceed 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: by using the URL generated by this card, your customers can connect their Instagram accounts to their shopper accounts.

...

Contact our Service desk in case the module is not active on your brand and they will connect the Instagram (Meta) application to your Backoffice.

Creating Instagram contests

Go to “Create 'Create new contest” contest' in the left-hand side menu of the module. Here, the The two contest options will show here the two types of contests.

...

• Name

• Description

• Starts at

• Ends at

• Selecting the post – here you will be offered a list of posts that are uploaded to your brand’s Instagram business account. Pick which one you wish to present as the topic of the contest.

Running Instagram contests

There needs to be a service automation set up to fetch the data from your contests to Antavo’s system.

Contact our Service desk to perform this actionIn 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.

To finalize, click Update and Set active.