Documentation

Getting Started
Gleam Updates
Capture
Competitions
Galleries
Rewards
Installation
Advanced
Integrations
Action Types
Guides

Instagram Actions

This documentation covers the actions that we support via Instagram.

Applications that support Instagram actions:

Learn to to put these actions into practice with our Instagram Contest Tips & Tricks Guide.

Authentication

If a user tries to perform certain Instagram action via Gleam they will be asked to authenticate the Gleam Competitions app to perform certain actions on their behalf.

Entry

The Instagram Entry action allows you to award an entry for logging into Instagram within the widget. This can be a great way of ensuring that you are able to identify the Instagram @profile of all users that enter your campaigns.

Admin View

Public View

Visit a Profile

The Instagram visit action allows you to ask a user to check out a specific Instagram profile. This action will send the user externally to that profile where they are free to optionally engage.

Admin View

This is the backend view of the action, you only need to enter the username of the account or the complete Instagram URL for the profile.

Public View

This is the public view of what the action will look like to the end user, users only need to click the action to visit the Instagram profile.

View a Photo or Video

The View a photo action type allows you to ask users to check out a specific photo or view inside the widget without having to leave for Instagram. Users engaging on the photo is completely optional.

Admin View

In the admin area you must include the full URL to the Instagram post containing the photo or video you want to include in the action.

Public View

Users will be able to hover to see the image before they click to give intent to open it (as there may be times when a user doesn't actually want to like your image).

Once they click the action it will expand to show them the full image or video. They are free to engage with it as they see fit, we do not force or ask the user to take any other actions.

Select a Photo

Probably one of our most popular Instagram actions, the Select a Photo action type allows you to accept photo submissions from a users Instagram feed as an entry into a contest or to unlock a reward.

Admin View

The setup for this action type is a little more complex than the previous ones, you must first give your action a title. The title is what users will see before they click on the action in the widget.

Title: Showoff your latest outfit from ASOS

The next thing you can do is to restrict the submission to a specific hashtag, this action currently is restricted to a single hashtag. This means that the user must have tagged a specific hashtag that you have specificed in the photo on Instagram before it will be accepted.

You can then provide specific instructions for the user which will reveal when they click on the action.

Public View

When the user clicks on the action it will first ask them to authenticate with Instagram (if they haven't already), then the user will see the instructions & a list of their last 21 Instagram posts (if you haven't restricted by hashtag).

If you restrict by hashtag we will look for that hashtag automatically in their last 21 posts & show the filtered images in a list. The user can then choose which one they would like to submit.

Instagram Photo Galleries

Gleam now has the ability to send Instagram images submitted from the widget directly to a photo gallery.

You can do this by selecting Galleries in the left hand menu, creating a new gallery & choosing the campaign which feeds it photos. You can also choose to automatically show all photos or put them into a moderation queue before they appear in the gallery.

Please note, Galleries currently do not have the ability to vote on images or pull images directly from a #hashtag without the user interfacing directly with the widget.

Instagram Example

The widget below is a live demo of our Instagram contest functionality, feel free to have a play:

Instagram Example Competition

Known Instagram Issues

API Downtime

Occassionally the Instagram API may go down (502 errors), which will prevent us from completing actions. In this scenario we will prompt users to try again later.

Connect With Us