Difference between revisions of "Installing and configuring Persona.ly Offer Wall"

From TITAN Wiki
Jump to: navigation, search
(Created page with "This tutorial will guide you through the process of integrating Persona.ly Offer Wall into your website. {{InstallingOfferwalls1}} Go to http://persona.ly/ and register choos...")
 
m
(Tag: visualeditor)
Line 7: Line 7:
 
!Example
 
!Example
 
|-
 
|-
|Site Name
+
|Name
 
|''Up to you''
 
|''Up to you''
 
|mywebsite
 
|mywebsite
 
|-
 
|-
|Site Slogan
+
|Type
|''Up to you''
+
|Rewards
 
|
 
|
 
|-
 
|-
|Contact Email
+
|Currency
 +
|''Your website [[virtual currency]] name. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
 +
|Points
 +
|-
 +
|Currency Short Name
 
|''Up to you''
 
|''Up to you''
 +
|P
 +
|-
 +
|Currency Singular
 +
|''Your website [[virtual currency]] name. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
 +
|Point
 +
|-
 +
|Platform
 +
|Web
 
|
 
|
 
|-
 
|-
|App Status
+
|Award users for disqualify/termination in surveys 
|ONLINE
+
|''Leave unchecked''
 
|
 
|
 
|-
 
|-
|Offline Message
+
|Exchange Rate
|''Up to you''
+
|''Your website [[virtual currency]] value. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
|Site under construction
+
|100
 
|-
 
|-
|Site URL
+
|URL
 
|''Your website URL''
 
|''Your website URL''
 
|<nowiki>http://mywebsite.com</nowiki>
 
|<nowiki>http://mywebsite.com</nowiki>
 
|-
 
|-
|Notification (Postback) URL
+
|Postback URL
 
|Copy-paste from Titan Admin Panel
 
|Copy-paste from Titan Admin Panel
 
|
 
|
 
|-
 
|-
|Site Currency Name
+
|Decimal
|''Your website [[virtual currency]] name. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
+
|''Leave unchecked''
|Points
+
|
|-
 
|Currency Symbol ($)
 
|''Up to you''
 
|P
 
|-
 
|Site Currency Ratio
 
|''Your website [[virtual currency]] value. Should be the same as in Admin Panel → Money → Currency → Virtual currency''
 
|1:100
 
|-
 
|Profit Share
 
|[[Earnings from Offer Walls|The percentage you want to share with your members]]
 
|50
 
 
|}
 
|}
 
Press ''Edit App''. "Success! App edit success" message should be displayed.
 
Press ''Edit App''. "Success! App edit success" message should be displayed.
Line 60: Line 60:
 
[[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 http://persona.ly/publisher/app, find the App you created and press  "Get 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 set userid = [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>
+
  <nowiki><iframe src="https://persona.ly/widget/?appid=ras987asdlk9655712dkj87a09p0098&userid=[USERNAME]" width="690" height="1400" frameborder="0" ></iframe></nowiki>
Full list of supported variables can be found below:
 
{| class="wikitable"
 
!Variable
 
!Description
 
!Required
 
|-
 
|app_id
 
|Your site's App ID*
 
|'''Yes'''
 
|-
 
|site_code
 
|Your Site Code
 
|'''Yes'''
 
|-
 
|[USERNAME]
 
|Username of currently logged in member
 
|'''Yes'''
 
|-
 
|site_type
 
|Available offer categories. Default = all
 
|'''Yes'''
 
|-
 
|[EMAIL]
 
|Email of currently logged in member
 
|No
 
|}<sub>*</sub><sub>Can be found on www.minutestaff.com → Offer Wall App → Integration → App Overview</sub>
 
 
 
 
=== Crediting ===
 
=== Crediting ===
 
{| class="wikitable"
 
{| class="wikitable"
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'''
+
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: '''162.243.242.7, 162.243.34.227, 52.200.142.249'''
  
As the above may change, make sure to visit http://www.minutestaff.com/ to find the up-to-date list.
+
As the above may change, make sure to visit https://github.com/personaly/Postback-sample/blob/master/personaly_postback.php 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).
 
Check the ''Restrict Postback IPs'' checkbox and enter the above IPs into the ''Whitelisted IPs'' textbox (should be seperated by a comma).
Line 123: Line 96:
 
|-
 
|-
 
|Points/money variable
 
|Points/money variable
|credit_amount/real_amount
+
|amount
 
|-
 
|-
 
|Tracking Info variable
 
|Tracking Info variable
|notify_id
+
|offer_id
 
|}
 
|}
 
==== Credit type variable ====
 
==== Credit type variable ====
{| class="wikitable"
+
Leave all fields blank.
!Variable
+
 
!Value
 
!(Credit)
 
!(Reverse)
 
|-
 
|Credit type variable
 
|status
 
|1
 
|2
 
|}
 
 
==== Signature variable ====
 
==== Signature variable ====
 
{| class="wikitable"
 
{| class="wikitable"
Line 148: Line 112:
 
|-
 
|-
 
|Signature variable
 
|Signature variable
|verify_code
+
|validation_signature
|MD5('''notify_code'''[app_id][user_id][notify_id])
+
|MD5([user_id]:[app_id]:'''SecretKey''')
|Replace '''notify_code''' with your Notify Code*
+
|Replace '''SecretKey''' with you Sekret Key*
 
|}
 
|}
<sub>*</sub><sub>Can be found on www.minutestaff.com → Offer Wall App → Integration → App Overview</sub>
+
<sub>*</sub><sub>Can be found by pressing 'Update' on your App list (<nowiki>http://persona.ly/publisher/app</nowiki>)</sub>
  
 
==== Successful response text ====
 
==== Successful response text ====
Leave blank
+
1
  
 
=== Test and finish ===
 
=== Test and finish ===
  
 
==== Save settings ====
 
==== Save settings ====
Save your settings on both: MinuteStaff website and Titan Admin Panel.  
+
Save your settings on both: Persona.ly website and Titan Admin Panel.  
  
 
==== 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 Persona.ly Offer Wall is being displayed properly.  
  
 
Congratulations! Your [[Offer Walls|Offer Wall]] has been installed and configured properly.
 
Congratulations! Your [[Offer Walls|Offer Wall]] has been installed and configured properly.

Revision as of 08:39, 8 June 2016

This tutorial will guide you through the process of integrating Persona.ly 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://persona.ly/ and register choosing the In-Game advertising. Next log into your account and create a new App. Fill in all details:

Field Value Example
Name Up to you mywebsite
Type Rewards
Currency Your website virtual currency name. Should be the same as in Admin Panel → Money → Currency → Virtual currency Points
Currency Short Name Up to you P
Currency Singular Your website virtual currency name. Should be the same as in Admin Panel → Money → Currency → Virtual currency Point
Platform Web
Award users for disqualify/termination in surveys  Leave unchecked
Exchange Rate Your website virtual currency value. Should be the same as in Admin Panel → Money → Currency → Virtual currency 100
URL Your website URL http://mywebsite.com
Postback URL Copy-paste from Titan Admin Panel
Decimal Leave unchecked

Press Edit App. "Success! App edit success" message should be displayed.

 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 http://persona.ly/publisher/app, find the App you created and press "Get Code".

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

The HTML code should look something like:

<iframe src="https://persona.ly/widget/?appid=ras987asdlk9655712dkj87a09p0098&userid=[USERNAME]" width="690" height="1400" frameborder="0" ></iframe>

Crediting

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

Postback

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: 162.243.242.7, 162.243.34.227, 52.200.142.249

As the above may change, make sure to visit https://github.com/personaly/Postback-sample/blob/master/personaly_postback.php 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

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

 Credit type variable

Leave all fields blank.

Signature variable

Variable Value 1 Value 2 Comment
Signature variable validation_signature MD5([user_id]:[app_id]:SecretKey) Replace SecretKey with you Sekret Key*

*Can be found by pressing 'Update' on your App list (http://persona.ly/publisher/app)

Successful response text

1

Test and finish

Save settings

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

Test if your Offer Wall is displaying properly

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

Congratulations! Your Offer Wall has been installed and configured properly.

Earnings

See Earnings from Offer Walls