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

From TITAN Wiki
Jump to: navigation, search
(Created page with "This tutorial will guide you through the process of integrating OfferToro Offer Wall into your website. {{InstallingOfferwalls1}} Go to http://www.offertoro.com/register and...")
 
m
(Tag: visualeditor)
Line 7: Line 7:
 
!Example
 
!Example
 
|-
 
|-
|The name of your app
+
|The name of your app or game
 
|''Up to you''
 
|''Up to you''
 
|MyWebsite
 
|MyWebsite
 
|-
 
|-
|Type
+
|What kind of app?
|Web
+
|Web - other
 
|
 
|
 
|-
 
|-
|The URL of your app
+
|Type of incentive?
 +
|VC
 +
|
 +
|-
 +
|The URL of your game or app
 
|''Your website URL''
 
|''Your website URL''
 
|<nowiki>http://mywebsite.com</nowiki>
 
|<nowiki>http://mywebsite.com</nowiki>
 
|-
 
|-
|Currency name
+
|The name of your currency
 
|''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 value
+
|1 US $ value of Your Currency
 
|''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 = 1000 Points
+
|1000
 
|-
 
|-
 
|Postback URL
 
|Postback URL
Line 36: Line 40:
 
[[File:SuperRewardsClientTest.png|thumbnail|Test your Website]]
 
[[File:SuperRewardsClientTest.png|thumbnail|Test your Website]]
 
[[File:SuperRewardsPostback1.png|thumbnail|Test postback: step 1]]
 
[[File:SuperRewardsPostback1.png|thumbnail|Test postback: step 1]]
[[File:SuperRewardsPostback2.png|thumbnail|Test postback: step 2]]
+
Once saved, go to ''integrate'' section and find the iframe code. Return to your Titan Admin Panel Offer Wall. Paste your iframe code into "HTML code" field. Make sure to replace USER_ID with '''[USERNAME]''' variable.  
Find your Offer Wall HTML on Offer Wall provider website and return to your Titan Admin Panel Offer Wall. Paste your Offer Wall HTML code into "HTML code" field. Make sure to replace current member username with '''[USERNAME]''' variable.  
 
  
 
The HTML code should look something like:
 
The HTML code should look something like:
  
<iframe src="<nowiki>https://wall.superrewards.com/super/offers?h=qwertylxvcp.23498734876</nowiki>'''&uid=[USERNAME]'''" frameborder="0" width="728" height="2400" scrolling="no"></iframe>
+
<iframe src="http://www.offertoro.com/ifr/show/1234/USER_ID/0987" frameborder="0" width="860" height="2400" ></iframe>
 
 
Full list of supported variables can be found below:
 
{| class="wikitable"
 
!Variable
 
!Description
 
!Required
 
|-
 
|[USERNAME]
 
|Username of currently logged in member
 
|'''Yes'''
 
|-
 
|[AGE]
 
|Age of the member
 
|No
 
|-
 
|[GENDER]
 
|Gender of the member ('M', 'F' or 'U' if unknown)
 
|No
 
|}Example of HTML code with additional parameters:
 
 
 
<iframe src="<nowiki>https://wall.superrewards.com/super/offers?h=qwertylxvcp.23498734876</nowiki>'''&uid=[USERNAME]&gender=[GENDER]&age=[AGE]'''" frameborder="0" width="728" height="2400" scrolling="no"></iframe>
 
  
 
=== Crediting ===
 
=== Crediting ===
Line 79: Line 61:
  
 
==== 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:
+
OfferToro does not provide IP adresses. Leave ''Restrict Postback IPs'' unchecked.
'''54.85.0.76, 54.84.205.80, 54.84.27.163'''
 
 
 
As the above may change, make sure to visit http://docs.superrewards.com/docs/notification-postbacks 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 92: Line 69:
 
|-
 
|-
 
|Username variable
 
|Username variable
|uid
+
|user_id
 
|-
 
|-
 
|Points/money variable
 
|Points/money variable
|new
+
|amount
 
|-
 
|-
 
|Tracking Info variable
 
|Tracking Info variable
|id
+
|oid
 
|}
 
|}
 
==== Credit type variable ====
 
==== Credit type variable ====
Line 111: Line 88:
 
|Signature variable
 
|Signature variable
 
|sig
 
|sig
|md5([id]:[new]:[uid]:SECRET_KEY
+
|MD5([oid]-[user_id]-'''AppKey''')
|Replace SECRET_KEY with your APP SECRET KEY
+
|Replace '''AppKey''' with your AppKey
 
|-
 
|-
 
|Successful response text
 
|Successful response text
Line 126: Line 103:
  
 
==== 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 SuperRewards Offer Wall is being displayed properly.  
+
Go to your Titan Website → Menu → Earn → Offerwall and check if OfferToro Offer Wall is being displayed properly.  
 +
 
 +
Go to OfferToro website and find test postback feature. Enter example variables and test:
 +
* Amount: 10
  
Go to SuperRewards website and find test postback feature. Enter example variables and test:
 
 
* User ID: admin   
 
* User ID: admin   
* Payout($): 1
 
 
Now return to your Titan Admin Panel and go to [[Offer Walls|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 Walls|Offer Wall]] has been installed and configured properly.
 
Now return to your Titan Admin Panel and go to [[Offer Walls|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 Walls|Offer Wall]] has been installed and configured properly.
 +
 +
=== Earnings ===
 +
''See [http://wiki.usetitan.com/Earnings%20from%20Offer%20Walls Earnings from Offer Walls]''

Revision as of 13:56, 7 June 2016

This tutorial will guide you through the process of integrating OfferToro 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 http://www.offertoro.com/register and register. Next log into your account as Publisher, and go to Apps → Add App. Fill in all details:

Field Value Example
The name of your app or game Up to you MyWebsite
What kind of app? Web - other
Type of incentive? VC
The URL of your game or app Your website URL http://mywebsite.com
The name of your currency Your website virtual currency name. Should be the same as in Admin Panel → Money → Currency → Virtual currency Points
1 US $ value of Your Currency Your website virtual currency value. Should be the same as in Admin Panel → Money → Currency → Virtual currency 1000
Postback URL Copy-paste from Titan Admin Panel

 Offer Wall HTML

Edit Offer Wall: step 1
Edit Offer Wall: step 2
Test your Website
Test postback: step 1

Once saved, go to integrate section and find the iframe code. Return to your Titan Admin Panel Offer Wall. Paste your iframe code into "HTML code" field. Make sure to replace USER_ID with [USERNAME] variable.

The HTML code should look something like:

<iframe src="http://www.offertoro.com/ifr/show/1234/USER_ID/0987" frameborder="0" width="860" height="2400" ></iframe>

Crediting

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

Postback

Restrict Postback IPs

OfferToro does not provide IP adresses. Leave Restrict Postback IPs unchecked.

Postback variables

Variable Value
Username variable user_id
Points/money variable amount
Tracking Info variable oid

 Credit type variable

Leave all fields blank.

Signature variable

Variable Value 1 Value 2 Comment
Signature variable sig MD5([oid]-[user_id]-AppKey) Replace AppKey with your AppKey
Successful response text 1

Test and finish

Save settings

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

Test if your Offer Wall is displaying properly

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

Go to OfferToro website and find test postback feature. Enter example variables and test:

  • Amount: 10
  • User ID: admin

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