Difference between revisions of "Installing and configuring Persona.ly Offer Wall"
(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 | ||
|- | |- | ||
− | | | + | |Name |
|''Up to you'' | |''Up to you'' | ||
|mywebsite | |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'' | |''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'' | |''Your website URL'' | ||
|<nowiki>http://mywebsite.com</nowiki> | |<nowiki>http://mywebsite.com</nowiki> | ||
|- | |- | ||
− | | | + | |Postback URL |
|Copy-paste from Titan Admin Panel | |Copy-paste from Titan Admin Panel | ||
| | | | ||
|- | |- | ||
− | | | + | |Decimal |
− | |'' | + | |''Leave unchecked'' |
− | | | + | | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
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 | + | 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 | + | 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:// | + | <nowiki><iframe src="https://persona.ly/widget/?appid=ras987asdlk9655712dkj87a09p0098&userid=[USERNAME]" width="690" height="1400" frameborder="0" ></iframe></nowiki> |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== 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: ''' | + | 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 | + | 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 | ||
− | | | + | |amount |
|- | |- | ||
|Tracking Info variable | |Tracking Info variable | ||
− | | | + | |offer_id |
|} | |} | ||
==== Credit type variable ==== | ==== Credit type variable ==== | ||
− | + | Leave all fields blank. | |
− | + | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==== Signature variable ==== | ==== Signature variable ==== | ||
{| class="wikitable" | {| class="wikitable" | ||
Line 148: | Line 112: | ||
|- | |- | ||
|Signature variable | |Signature variable | ||
− | | | + | |validation_signature |
− | |MD5(''' | + | |MD5([user_id]:[app_id]:'''SecretKey''') |
− | |Replace ''' | + | |Replace '''SecretKey''' with you Sekret Key* |
|} | |} | ||
− | <sub>*</sub><sub>Can be found on | + | <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 ==== | ||
− | + | 1 | |
=== Test and finish === | === Test and finish === | ||
==== Save settings ==== | ==== Save settings ==== | ||
− | Save your settings on both: | + | 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 | + | 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
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
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.