This is where you will need the API key from the dashboard, as you will need to replace "{your_api_key}" with it. For "{user_id}", you will need to dynamically insert the user id for each app user. Make sure the ID used here is unique and that it does not change, as the user's profile will be stored under this ID.
<iframe src="https://offerwall.upwall.net/?app_id=[YOUR_API_KEY]&userid=[USER_ID]"
style="position:fixed;
top:0px; left:0px;
bottom:0px; right:0px;
width:100%; height:100%;
border:none; margin:0; padding:0;
overflow:hidden; z-index:999999;">
</iframe>
Parameter | Required | Type | Description |
---|---|---|---|
app_id | Required | String | Your app id to show offers in ifarme , It will be added automatically in iframe |
userid | Required | String | Your User's Unique ID E.g.: &userid=user1234 |
What is a Postback?
A postback allows you to receive notifications on your server every time your account receives a conversion. This is necessary for you to be able to provide your users with rewards. For example, whenever you receive a conversion, you may wish to be notified what the payout, user ID, and point value are. Example Postback URL:
https://your-site.com/?userid={userid}&offer_name={offer_name}&user_amount={user_amount}&payout={payout}&ip_address={ip_address}
Parameter | Description | Macros |
---|---|---|
app_name | Returns the app name | {app_name} |
userid | This is the unique identifier code of the user who completed action on your platform. | {userid} |
password | If your postback has a password associated, we pass this password back to you | {password} |
user_amount | The amount of your virtual currency to be credited to your user. | {user_amount} |
offer_name | Name of completed offer. | {offer_name} |
offer_id | ID of completed offer. | {offer_id} |
payout | The offer payout in $ (USD) | {payout} |
ip_address | Converting device's IP address if known, 0.0.0.0 otherwise | {ip_address} |
currency_name | Virtual currency name defined in your app settings. | {currency_name} |
date | The date on which the offer was completed | {date} |
<?php
//php code example
$user_id = $_REQUEST['userid'];
$ip_address = $_REQUEST['ip_address'];
$offer_name = $_REQUEST['offer_name'];
$offer_id = $_REQUEST['offer_id'];
$app_name = $_REQUEST['app_name'];
$user_amount = $_REQUEST['user_amount'];
$payout = $_REQUEST['payout'];
$currency_name = $_REQUEST['currency_name'];
$date = $_REQUEST['date'];
//If your postback has a password associated, we pass this password back to you
$password = $_REQUEST['password'];
$my_password = "your-postback-password-here";
//Database Connection
$host = "your-host-server";
$dbuser = "your-database-username";
$dbpassword = "your-database-password";
$dbname = "your-database-name";
$db = mysqli_connect($host,$dbuser,$dbpassword,$dbname);
if (isset($user_id) && $password == $my_password) {
mysqli_query($db,"INSERT INTO
leads (user_id , offer_name , offer_id , ip_address , app_name , offer_payout , user_amount , currency_name , date)
VALUES ('".$user_id."','".$offer_name."','".$offer_id."','".$ip_address."','".$app_name."','".$offer_payout."','".$user_amount."','".$currency_name."','".$date."')");
}
?>
The offer API is designed to be called by a backend/server. This API returns you the inventory we have available for you
https://offerwall.upwall.net/api/?app_id={your_api_key}&country={country_code}&os=android&userid={user_id}
An application is required to use the API. Once you have created an app you will have an API KEY, that you will need in the following steps.
1 - Go To Apps Page
2 - Click on View Button
Parameter | Required | Type | Description |
---|---|---|---|
app_id | Required | String | The Api key for the app |
userid | Required | String | Your userid (Unique ID) E.g.: &userid=user1234 |
country | Optional | String | country code of the user, This will help show the offers available to the user in his country || value : TR , US , GB etc.. |
os | Optional | String | Filters the list of offers to show the offers available to that device. Android = android || IOS = ios || web = desktop || |
{
"status": "success",
"count": 2,
"offers": [
{
"offer_id": "47489",
"title": " Bright Objects Hidden object",
"description": "Play and Reach Level 120 (New Users Only) ",
"icon": "https:\/\/adrumedia.cdns-works.com\/files\/uploads\/Off_A_70677.jpg",
"conversion": "Play and Reach Level 120 (New Users Only) ",
"payout": "0.28",
"link": "http:\/\/trck.app.adrumedia.com\/?offer_url=64ded38a57199==&uid=64ded38a5719b4600==&from=api&appid=232",
"user_amount": 28.000000000000004,
"devices": [
"android"
],
"available_in": "TR",
"countries": [
"TR"
]
},
{
"offer_id": "45052",
"title": " Kariyer.net",
"description": "Register (new users only)",
"icon": "https:\/\/adrumedia.cdns-works.com\/files\/uploads\/Off_A_68235.png",
"conversion": "Register (new users only)",
"payout": "0.03",
"link": "http:\/\/trck.app.adrumedia.com\/?offer_url=64ded38a5eb00==&uid=64ded38a5eb024389==&from=api&appid=232",
"user_amount": 3.0,
"devices": [
"ios"
],
"available_in": "TR",
"countries": [
"TR"
]
},
]
}
<?php
$curl = curl_init();
$url = "https://offerwall.upwall.net/api/?app_id={your_api_key}&country={country_code}&os={os}&userid={user_id}";
curl_setopt_array($curl, array(
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
$offers = json_decode($response,true);
if ($offers['status'] == "success"){
foreach($offers['offers'] as $var => $value){
echo $value['offer_id']."\n";
echo $value['title']."\n";
//and more
}
}
?>