Documentation Integration API Reference Log in Get Started
Integration guide

Embed the offerwall and credit users automatically.

Everything you need to integrate AdswedMedia: an iFrame tracking link and a server-to-server postback. You will need your PUBLIC KEY and SECRET KEY from the Setup page.

iFrameS2S PostbackHTTP GETMD5 Signature
Publisher Apply Documentation overview
#sec-iframe

iFrame Integration

An application is required to use our tools. Once you create an app and get approved, you will receive a PUBLIC KEY and a SECRET KEY that you will need to integrate our offerwall.

Step 1 — Publisher Apply

Go to https://adswedmedia.com/publishers/apply and fill in the form.

Publisher apply

Step 2 — Manage Apps

Log into your AdswedMedia account and click Monetize.

Monetize

On the Monetize page click Setup.

Setup

Step 3 — Tracking Link

On the Setup page you can get your wall tracking link and your site keys for the offerwall and postback setup. Replace YOUR_KEY with your Public Key and USER_ID with your user's unique identifier.

iframe.html
<iframe
  src="https://adswedmedia.com/offer/YOUR_KEY/USER_ID"
  width="100%"
  height="700"
  frameborder="0"
  allow="clipboard-write"
></iframe>
iFrame
#sec-postback

Postback (Server-to-Server)

Whenever a user completes an offer, we make an HTTP GET request to the Postback URL you configured in your app, with all the information needed to credit your user.

Parameters

ParameterDescription
subIdUnique identifier code of the user who completed the action on your platform.
transIdUnique identification code of the transaction made by your user on AdswedMedia.
rewardExact amount of your virtual currency to be credited to your user.
round_rewardAmount of your virtual currency to be credited to your user in the selected decimal points.
payoutOffer payout in USD.
signatureMD5 hash that can be used to verify that the call has been made from our servers.
status1 when the virtual currency should be added  ·  2 when it should be subtracted (advertiser cancelation, fraud or mistake).
userIpThe user's IP address.
offer_idID of the completed offer.
offer_nameName of the completed offer.
countryCountry (ISO 2-letter) from where the lead comes.
uuidUnique identification code of the click made by your user on AdswedMedia.
event_idID of the offer event that was credited. Empty for non-event conversions.
event_nameName of the offer event that was credited. Empty for non-event conversions.
Heads up: reward and payout parameters are always absolute values.

Signature & PHP example

You should verify the signature received in the postback to ensure that the call comes from our servers. The signature parameter must match the MD5 of subId + transId + reward + secret. You can find your secret key on the Setup page.

postback.php
<?php
$secret    = ''; // Get your secret key from AdswedMedia
$subId     = isset($_REQUEST['subId'])     ? $_REQUEST['subId']     : null;
$transId   = isset($_REQUEST['transId'])   ? $_REQUEST['transId']   : null;
$reward    = isset($_REQUEST['reward'])    ? $_REQUEST['reward']    : null;
$signature = isset($_REQUEST['signature']) ? $_REQUEST['signature'] : null;

// Validate signature
if (md5($subId . $transId . $reward . $secret) != $signature) {
  echo "ERROR: Signature doesn't match";
  return;
}
?>

Postback Response

Our server expects one of the following text responses:

  • OK when you receive a new transaction.
  • DUP when you receive a duplicate transaction. In that case our server stops further attempts for that transaction.
We wait for a response up to 60 seconds before timing out. On timeout, the same transaction is retried up to 5 times during the next few hours. Always deduplicate by transId to avoid crediting the same user twice.

Testing Tool

A testing tool is available on the Setup page (where your tracking links are). It lets you send test postbacks to verify your integration.

Postback testing tool