How to Verify Actions on Your Website with Callback Verification

If you host a giveaway, you might want to learn how to optimize the performance of your campaign, and gain leads and traffic.

Why Callback Verification?

If you host a giveaway, you might want to learn how to optimize the performance of your campaign, and gain leads and traffic.

With callback verification, you can get users to do tasks on your website such as sign up, deposit, purchase, clicks and everything else. It is VERIFIABLE regardless of the tasks. It is possible to add multiple tasks to the same website, as well as to use multiple websites.

Please follow the steps to set up the task and to integrate API callback.

Step 1

Enter the name of your app and at least one of download URLs for the Apple App Store and Google Play Store, and the Android APK URL.

Step 2

After that, you will need to get deep link params (something like track_id=4wmmHtD4rSA) from your app and parse out the trackId.

track_id=4wmmHtD4rSA

About track_id:

• TrackId is necessary to detect the user's participation in the task and to verify it. We will detect when a user clicks to participate in the task, the ?track_id={{ track_id }} will be used for detection.

• You will see the ?track_id={{ track_id }}&send={{ download }} applied to your website link: If your app deep link is

example://app_download

the visitors may come to your site via the link

example.com://app_download?track_id=4wmmHtD4rSA

Step 3

Next, please copy the API key we provide you to integrate it with your app.

Then enter the parameters according to the rules of const data, and encrypt the whole const data using the standard HmacSHA256 algorithm.

const data = `track_id=${track_id}&event=app_download&remark=${remark}`; // remark is optional.

Step 4

Use our official API below and pass the corresponding parameters in the following code.

Official API: https://giveaway.com/public/v1/giveaway/task/callback

const api_key = "{{your api_key}}";
const {track_id} = queryString.parse(window.location.search); // url search
const event="app_download" //your chosen event
const remark = "remark"; //add remark optional
const data = `track_id=${track_id}&event=${event}&remark=${remark}`; // optional
const sign = crypto.HmacSHA256(data, api_key).toString(); // HmacSHA256
fetch("https://giveaway.com/public/v1/giveaway/task/callback", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    track_id,
    sign,
    event,
    remark,
    value
  }),
}).then(async (res) => {
  console.log(await res.json());
});

Step 5

After the above steps are completed, enter your url-scheme and click the 'Check API callback' to test it.

Each project you created on Giveaway.com will have a unique API key, and it will not change. Additionally, each app must be integrated separately.