Developer Documentation
DashboardHelp
  • Getting Started
  • AdGate Rewards Monetization
    • AdGate Rewards Setup
    • Web Integration
    • iOS SDK
    • Android SDK
    • Unity SDK
    • Magic Receipts Standalone
  • Postbacks
    • Postback Information
    • Magic Receipts Postbacks
    • PHP Postback Examples
  • APIs
    • User Based API (v1)
      • Get Offers
      • Get Offers By Ids
      • Post Devices
      • Get History
      • Get Offer History - DEPRECATED
    • Offers API (v3)
    • Offers API (v2)
    • Publisher Reporting API
    • Advertiser Reporting API
Powered by GitBook
On this page
  • What is Magic Receipts?
  • How to Integrate Magic Receipts as a Standalone Offering
  • Step 1: Create an AdGate Rewards Offer Wall
  • Step 2: Obtain your wall code
  • Step 3: Create your unique link
  • Step 4: Append Offer Wall Information (Optional)
  • Step 5: Send users through your link

Was this helpful?

  1. AdGate Rewards Monetization

Magic Receipts Standalone

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

PreviousUnity SDKNextPostback Information

Last updated 1 year ago

Was this helpful?

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

Step 2: Obtain your wall code

Step 3: Create your unique link

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. 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}";

Step 5: Send users through your link

Follow the steps listed to setup your AdGate Rewards offer wall. You may skip this step if you already have an AdGate Rewards offer wall created.

You can find your wall code . It will look like the following image:

Use your newly generated link to send users to the Magic Receipts product. You will receive a for each successfully scanned receipt.

here
here
postback
You can see the wall code here is nq6Upw