Magic Receipts Standalone
This page describes how to setup Magic Receipts as a standalone offering.
Magic Receipts is a product that allows your user to scan receipts of their recent purchases in exchange for rewards.
The Magic Receipts offering is automatically included in the AdGate Rewards Offer Wall. However, publishers may also display Magic Receipts as a standalone offering within their website or app.
Follow the steps listed here to setup your AdGate Rewards offer wall. You may skip this step if you already have an AdGate Rewards offer wall created.
You can see the wall code here is nq6Upw
Replace the WALLCODE text below with the value from the previous step. Replace USERID with the unique identifying value for each of your users.
https://seek.gg/magic/WALLCODE/USERID
Optionally, you may also append additional tracking parameters to the url. ex: https://seek.gg/magic/WALLCODE/USERID?s2=&s3=&s4=&s5=
By default, all point and conversion information will be taken from your AdGate Rewards Wall settings as configured on the dashboard. However, if you wish to dynamically pass that information in, you can do so by following the steps below.
You may append the following offer wall information to the link:
Parameter | Description | Type | Example |
|---|---|---|---|
cr | Conversion rate | Integer | 100 |
pp | Plural points | String | Points |
ps | Singular points | String | Point |
pa | Points abbreviation | String | Pts |
Example:
https://seek.gg/magic/WALLCODE/USERID?cr=100&pp=Points&ps=Point&pa=Pts
NOTE: If you want to append the conversion rate in the link, you need to hash the url for security purposes.
To hash the link you need to encrypt everything after the domain name (https://seek.gg) with the HMAC SHA-256 hashing algorithm, and append the hash to the link. Here is a list of steps you need to follow to do the hashing:
Example URL:
https://seek.gg/magic/WALLCODE/USERID?cr=100&pp=Points&ps=Point&pa=Pts- 1.Ask your account manager for your publisher secret key.
- 2.Generate a hash by encrypting the path and query using your secret key with this pseudo-code: hash = hmac_256("/magic/WALLCODE/USERID?cr=100&pp=Points&ps=Point&pa=Pts", secret_key)
- 3.Append the hash to the url with the parameter "hash":
https://seek.gg/magic/WALLCODE/USERID?cr=100&pp=Points&ps=Point&pa=Pts&hash=abcdefg123
PHP Script
// We hash only path and query.
// Root path "/" is always included in the data to sign.
// "?" included only if query string is not empty.
$path = parse_url($url, PHP_URL_PATH);
$query = parse_url($url, PHP_URL_QUERY);
$pathAndQuery = $path . ($query !== null ? ('?' . $query) : '');
$hash = hash_hmac(
'sha256',
utf8_encode($pathAndQuery),
$secretKey,
);
$url .= "&hash={$hash}";
Use your newly generated link to send users to the Magic Receipts product. You will receive a postback for each successfully scanned receipt.
Last modified 2mo ago