Difference between revisions of "Installing and configuring Wannads Offer Wall"

From TITAN Wiki
Jump to: navigation, search
(Created page with "This tutorial will guide you through the process of integrating Wannads Offer Wall into your website. {{InstallingOfferwalls1}} Go to https://www.virool.com/signup?publisher=...")
 
m
(Tag: visualeditor)
Line 1: Line 1:
 
This tutorial will guide you through the process of integrating Wannads Offer Wall into your website.
 
This tutorial will guide you through the process of integrating Wannads Offer Wall into your website.
  
{{InstallingOfferwalls1}} Go to https://www.virool.com/signup?publisher=1 and register. Next log into your account, and go to https://www.virool.com/sites and add a new site. Fill in all details:
+
{{InstallingOfferwalls1}} Go to https://www.wannads.com/register and register. Next log into your account, and Create App. Follow the App Wizard:
 
{| class="wikitable"
 
{| class="wikitable"
 
!Field
 
!Field
Line 7: Line 7:
 
!Example
 
!Example
 
|-
 
|-
|Site Name
+
|App/Website Name
 
|''Up to you''
 
|''Up to you''
 
|mywebsite
 
|mywebsite
 
|-
 
|-
|Site Slogan
+
|App URL
|''Up to you''
+
|''Your website URL''
|
+
|<nowiki>http://mywebsite.com</nowiki>
|-
 
|Contact Email
 
|''Up to you''
 
|
 
 
|-
 
|-
|App Status
+
|Type
|ONLINE
+
|''Web''
 
|
 
|
 
|-
 
|-
|Offline Message
+
|Reward
|''Up to you''
+
|Virtual Currency
|Site under construction
 
|-
 
|Site URL
 
|''Your website URL''
 
|<nowiki>http://mywebsite.com</nowiki>
 
|-
 
|Notification (Postback) URL
 
|Copy-paste from Titan Admin Panel
 
 
|
 
|
 
|-
 
|-
|Site Currency Name
+
|Currency Name
 
|''Your website [[virtual currency]] name. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
 
|''Your website [[virtual currency]] name. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
 
|Points
 
|Points
 
|-
 
|-
|Currency Symbol ($)
+
|$1.00 USD
|''Up to you''
 
|P
 
|-
 
|Site Currency Ratio
 
 
|''Your website [[virtual currency]] value. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
 
|''Your website [[virtual currency]] value. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
|1:100
+
|100
 
|-
 
|-
|Profit Share
+
|Postback URL
|[[Earnings from Offer Walls|The percentage you want to share with your members]]
+
|Copy-paste from Titan Admin Panel
|50
+
|
 
|}
 
|}
Press ''Edit App''. "Success! App edit success" message should be displayed.
 
 
 
=== Offer Wall HTML ===
 
=== Offer Wall HTML ===
 
[[File:MinuteStaff1.png|thumbnail|Create MinuteStaff Offer Wall: step 1]]
 
[[File:MinuteStaff1.png|thumbnail|Create MinuteStaff Offer Wall: step 1]]
Line 60: Line 42:
 
[[File:MinuteStaff5.png|thumbnail|Edit Offer Wall: step 2]]
 
[[File:MinuteStaff5.png|thumbnail|Edit Offer Wall: step 2]]
 
[[File:MinuteStaffClientTest.png|thumbnail|Test your Website]]
 
[[File:MinuteStaffClientTest.png|thumbnail|Test your Website]]
Go to www.minutestaff.com → Offer Wall App → Integration → App Overview.
+
Go to your newly created App on https://www.wannads.com/user/apps<nowiki/>and press Get Offerwall Code.
  
Copy iframe Code and return to your Titan Admin Panel Offer Wall. Paste your iframe Code into "HTML code" field. Make sure to replace the app_id variable with your site's App ID*, site_code with your Site Code*, and set user_id = [USERNAME], user_email = [USEREMAIL].  
+
Copy iframe Code and return to your Titan Admin Panel Offer Wall. Paste your iframe Code into "HTML code" field. Make sure to replace [USER_ID] with [USERNAME].  
  
 
The HTML code should look something like:
 
The HTML code should look something like:
  <nowiki><iframe src="https://offerwall.minutecircuit.com/display.php?app_id=999&site_code=123456qwertyu&user_id=[USERNAME]&user_email=[EMAIL]&site_type=all" width="100%" height="500" frameBorder="0">Browser not compatible.</iframe></nowiki>
+
  <iframe style="width:100%;height:800px;border:0;padding:0;margin:0;" scrolling="yes" "frameborder="0" src="<nowiki>https://wall.wannads.com/wall?apiKey=12kljh1298k378askp23&userId=</nowiki>[USERNAME]"><nowiki></iframe></nowiki>
 +
Additionally you can specify '''&age''' attribute to improve targeting.
 +
 
 
Full list of supported variables can be found below:
 
Full list of supported variables can be found below:
 
{| class="wikitable"
 
{| class="wikitable"
Line 71: Line 55:
 
!Description
 
!Description
 
!Required
 
!Required
|-
 
|app_id
 
|Your site's App ID*
 
|'''Yes'''
 
|-
 
|site_code
 
|Your Site Code
 
|'''Yes'''
 
 
|-
 
|-
 
|[USERNAME]
 
|[USERNAME]
Line 84: Line 60:
 
|'''Yes'''
 
|'''Yes'''
 
|-
 
|-
|site_type
+
|[AGE]
|Available offer categories. Default = all
+
|Age of the member
|'''Yes'''
 
|-
 
|[EMAIL]
 
|Email of currently logged in member
 
 
|No
 
|No
|}<sub>*</sub><sub>Can be found on www.minutestaff.com → Offer Wall App → Integration → App Overview</sub>
+
|}Example of HTML with optional attributes:
 +
<iframe style="width:100%;height:800px;border:0;padding:0;margin:0;" scrolling="yes" "frameborder="0" src="<nowiki>https://wall.wannads.com/wall?apiKey=12kljh1298k378askp23&userId=</nowiki>[USERNAME]'''&age=[AGE]'''"></iframe>
  
 
=== Crediting ===
 
=== Crediting ===
Line 108: Line 81:
  
 
==== Restrict Postback IPs ====
 
==== Restrict Postback IPs ====
For better security, it is recommended to restrict IP addresses that have access to your postback handler. At the time of writing this article, the SuperRewards IPs are: '''108.170.27.234, 108.170.27.238, 198.15.95.74,  198.15.113.58'''
+
wannads.com does not provide their IP list. Leave ''Restrict Postback IPs'' unchecked and ''Whitelisted IPs'' blank.
 
 
As the above may change, make sure to visit http://www.minutestaff.com/ to find the up-to-date list.
 
 
 
Check the ''Restrict Postback IPs'' checkbox and enter the above IPs into the ''Whitelisted IPs'' textbox (should be seperated by a comma).
 
  
 
==== Postback variables ====
 
==== Postback variables ====
Line 120: Line 89:
 
|-
 
|-
 
|Username variable
 
|Username variable
|user_id
+
|subid
 
|-
 
|-
 
|Points/money variable
 
|Points/money variable
|credit_amount/real_amount
+
|reward
 
|-
 
|-
 
|Tracking Info variable
 
|Tracking Info variable
|notify_id
+
|transId
 
|}
 
|}
 
==== Credit type variable ====
 
==== Credit type variable ====
Line 148: Line 117:
 
|-
 
|-
 
|Signature variable
 
|Signature variable
|verify_code
+
|signature
|MD5('''notify_code'''[app_id][user_id][notify_id])
+
|MD5([subid][transID][reward]'''YourSecretKey''')
|Replace '''notify_code''' with your Notify Code*
+
|Replace '''YourSecretKey''' with your Secret*
 
|}
 
|}
<sub>*</sub><sub>Can be found on www.minutestaff.com → Offer Wall App → Integration → App Overview</sub>
+
<sub>*</sub><sub>Can be found in your App overview</sub>
  
 
==== Successful response text ====
 
==== Successful response text ====
Leave blank
+
OK
  
 
=== Test and finish ===
 
=== Test and finish ===
Line 163: Line 132:
  
 
==== Test if your Offer Wall is displaying properly ====
 
==== Test if your Offer Wall is displaying properly ====
Go to your Titan Website → Menu → Earn → Offerwall and check if MinuteStaff Offer Wall is being displayed properly.  
+
Go to your Titan Website → Menu → Earn → Offerwall and check if Wannads Offer Wall is being displayed properly.  
  
Congratulations! Your [[Offer Walls|Offer Wall]] has been installed and configured properly.
+
==== Test Postback ====
 +
Go to your App on https://www.wannads.com/user/apps and find test postback feature. Enter example variables and test:
 +
* User ID: admin
 +
* Amount: 10
 +
Now return to your Titan Admin Panel and go to Postback Log. If everything has been configured properly, you should see your test postback record with status "'''CreditedByOfferwall'''" or "'''CreditedAndPointsLocked'''" (if Points locking is set). Congratulations! Your Offer Wall has been installed and configured properly.
  
 
=== Earnings ===
 
=== Earnings ===
 
''See [[Earnings from Offer Walls]]''
 
''See [[Earnings from Offer Walls]]''

Revision as of 10:42, 8 June 2016

This tutorial will guide you through the process of integrating Wannads Offer Wall into your website.

Preparation

Adding new Offer Wall
Activating newly added Offer Wall
Editing newly added Offer Wall

Create new Offer Wall

Go to Admin Panel → CPA/GPT → Offer Walls → Add new and click "Add new, empty Offer Wall" button. After you click the button, you should see a success message. Now return to Installed Offerwalls page. You should now see your newly created Offer Wall as "Awaiting setup..". Activate it.

Edit the Offer Wall

In Admin Panel CPA/GPT Offer Walls Installed Offerwall click "See details and edit" button. You will now see Offer Wall summary page. To edit its settings, click "Edit Offer Wall" in the panel to the left.

Create the Offer Wall in the Offer Wall provider website

Open a new tab. Go to https://www.wannads.com/register and register. Next log into your account, and Create App. Follow the App Wizard:

Field Value Example
App/Website Name Up to you mywebsite
App URL Your website URL http://mywebsite.com
Type Web
Reward Virtual Currency
Currency Name Your website virtual currency name. Should be the same as in Admin Panel → Money → Currency → Virtual currency Points
$1.00 USD Your website virtual currency value. Should be the same as in Admin Panel → Money → Currency → Virtual currency 100
Postback URL Copy-paste from Titan Admin Panel

 Offer Wall HTML

Create MinuteStaff Offer Wall: step 1
Create MinuteStaff Offer Wall: step 2
Integration data
Edit Offer Wall: step 1
Edit Offer Wall: step 2
Test your Website

Go to your newly created App on https://www.wannads.com/user/appsand press Get Offerwall Code.

Copy iframe Code and return to your Titan Admin Panel Offer Wall. Paste your iframe Code into "HTML code" field. Make sure to replace [USER_ID] with [USERNAME].

The HTML code should look something like:

<iframe style="width:100%;height:800px;border:0;padding:0;margin:0;" scrolling="yes" "frameborder="0" src="https://wall.wannads.com/wall?apiKey=12kljh1298k378askp23&userId=[USERNAME]"></iframe>

Additionally you can specify &age attribute to improve targeting.

Full list of supported variables can be found below:

Variable Description Required
[USERNAME] Username of currently logged in member Yes
[AGE] Age of the member No
Example of HTML with optional attributes:
<iframe style="width:100%;height:800px;border:0;padding:0;margin:0;" scrolling="yes" "frameborder="0" src="https://wall.wannads.com/wall?apiKey=12kljh1298k378askp23&userId=[USERNAME]&age=[AGE]"></iframe>

Crediting

Name Value
Credit as Choose how you want to credit users
What is sent? Points

Postback

Restrict Postback IPs

wannads.com does not provide their IP list. Leave Restrict Postback IPs unchecked and Whitelisted IPs blank.

Postback variables

Variable Value
Username variable subid
Points/money variable reward
Tracking Info variable transId

 Credit type variable

Variable Value (Credit) (Reverse)
Credit type variable status 1 2

Signature variable

Variable Value 1 Value 2 Comment
Signature variable signature MD5([subid][transID][reward]YourSecretKey) Replace YourSecretKey with your Secret*

*Can be found in your App overview

Successful response text

OK

Test and finish

Save settings

Save your settings on both: MinuteStaff website and Titan Admin Panel.

Test if your Offer Wall is displaying properly

Go to your Titan Website → Menu → Earn → Offerwall and check if Wannads Offer Wall is being displayed properly.

Test Postback

Go to your App on https://www.wannads.com/user/apps and find test postback feature. Enter example variables and test:

  • User ID: admin
  • Amount: 10

Now return to your Titan Admin Panel and go to Postback Log. If everything has been configured properly, you should see your test postback record with status "CreditedByOfferwall" or "CreditedAndPointsLocked" (if Points locking is set). Congratulations! Your Offer Wall has been installed and configured properly.

Earnings

See Earnings from Offer Walls