Links
Comment on page

Magic Receipts Standalone

This page describes how to setup Magic Receipts as a standalone offering.

What is Magic Receipts?

Magic Receipts is a product that allows your user to scan receipts of their recent purchases in exchange for rewards.

How to Integrate Magic Receipts as a Standalone Offering

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.

Step 1: Create an AdGate Rewards Offer Wall

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.

Step 2: Obtain your wall code

You can find your wall code here. It will look like the following image:
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=

Step 4: Append Offer Wall Information (Optional)

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.

Hashing

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. 1.
    Ask your account manager for your publisher secret key.
  2. 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. 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.