This article covers all of the entry methods that SweepWidget allows with Twitter.
Table of contents:
- Login
- Follow Account (* API verified)
- Post A Tweet (* API verified)
- Retweet (* API verified)
- Post A Tweet Containing A Hashtag (* API verified)
- Select An Image Or Video Containing A Hashtag (* API verified)
- Example Giveaway
Twitter login
SweepWidget allows users to login to a giveaway through their Twitter account. This features is enabled by default, but you can opt in or out within the build/edit section for a giveaway.
Admin view
Navigate to User login steps. Then make sure the Twitter checkbox is ticked. You can choose only Twitter, or as many multiple options as you like. Also, you can make the Twitter login optional or mandatory.
Public view
Optional Twitter login
The user will have a choice of social media oAuth logins to chose from (Twitter included).
Required Twitter login
You can also make it mandatory for the user to login with Twitter (or multiple social media login options).
After the user clicks the Twitter login button, they will be redirected a Twitter login page where they must authorize the SweepWidget app.
That’s it! After that, the users name/email address will be auto-filled into your giveaway and they will get entered.
Follow a Twitter account
SweepWidget allows users to gain entries by following a Twitter page.
Admin view
To enable this entry method:
- Navigate to Ways Users Can Enter.
- Click on Twitter > Follow.
3. Fill in all required fields. You can require API validation or make it optional.
Public view
The user will be asked to follow your Twitter page.
When they click the follow button, they will be redirected to authenticate their Twitter account with the SweepWidget app.
After the user successfully authenticates the SweepWidget app, they will be redirected back to the giveaway. Now they must enter the username which they followed the Twitter account with. If they aren’t actually following the account, they will not get credit. The API will validate if they’re actually following in real-time (if you have the API validated entries enabled).
Post a tweet
SweepWidget allows users to gain entries by posting a tweet to their Twitter page.
Admin view
To enable this entry method:
- Navigate to Ways Users Can Enter.
- Click on Twitter > Follow.
3. Fill in all required fields.
Daily tweets (up to 3 per day)
You can optionally create a chain of Tweets by clicking the Add Another Tweet + button. Then, you can allow users to come back anywhere from once per hour to once per day. Each time they come back to enter again, it will most to the next tweet in the sequence you have set up. There is no limit to how many tweets you can set up in this sequence.
Note: every tweet must be uniquely different from each other. The reason we have this requirement is because Twitter disallows duplicate tweets.
Public view
The user must click the Tweet button and post it to their page.
If you have API validation enabled, the user will be redirected to authenticate the SweepWidget app.
After they authenticate the SweepWidget, the tweet will be automatically posted to their page.
Retweet a tweet
SweepWidget allows users to gain entries by retweeting a tweet.
Admin view
To enable this entry method:
- Navigate to Ways Users Can Enter.
- Click on Twitter > Retweet.
3. Fill in all required fields.
Public view
The user must click the “Retweet this tweet” button.
If you have API validation enabled, the user will be redirected to authenticate the SweepWidget app.
After authenticating the SweepWidget app, the tweet will automatically get retweeted to their page.
Post a tweet containing a hashtag
With this entry method, you can require users to post a tweet to their profile containing one or more hashtags.
Admin view
To enable this entry method:
- Navigate to Ways Users Can Enter.
- Click on Twitter > Hashtag
Next, you must fill in all of the required information. You can require one or more hashtags to be in the tweet. Additionally, you can set a default text for the tweet.
Public view
First, the user must click the “Tweet” button. They will get instructions on which hashtags are required in their tweet.
After the user clicks the “Tweet” button, they will be required to authorize the SweepWidget app.
The user will now be redirected to Twitter enter a tweet.
Once they have completed their tweet, they will be asked to enter their Twitter handle. The API will now scan their Twitter account to check if they have any tweets with the required hashtags.
Select an image or video containing a hashtag
With this entry method, you can require users to select a photo/video from their Twitter page. Additionally, you can require them to use a one or more hashtags on this tweet.
Admin view
To enable this entry method:
- Navigate to Ways Users Can Enter.
- Click on Twitter > Submit A Photo/Video
Next, you must fill in all of the required information. You can require one or more hashtags to be in the tweet.
Public view
First, the user will be asked to click the “Fetch Media” button.
After they click the button, they will be redirected to Twitter to authorize the SweepWidget app.
The user will be redirected back to the SweepWidget giveaway where it will fetch any tweets containing media (photo or video). If there are required hashtags, it will filter the results to only include media with those hashtags.
