Giveaway.com
  • OVERVIEW
    • What is Giveaway.com?
      • Introduction for Users
      • Introduction for Project Partner
      • Contact US
      • What is Provably Fair
      • How to Verify Fairness
    • Core Features of Giveaway.com
      • Earn
      • Penny Win
      • Offer
    • Benefit
      • For user:
      • For project partner:
  • WEB3 KNOWLEDGE
    • What is Web3?
    • How Giveaway.com Integrates Web3
    • Key Features for Web3 Beginners
    • Getting Started with Web3 on Giveaway.com
    • Why Web3 Makes Giveaway.com Unique
  • USER TUTORIAL
    • To Get Started: Sign in
    • How to Participate in EARN Activities
      • Guideline:
      • Reward
      • Other FAQ
        • What Can I do If I Do Not Receive My Reward
        • Why I am Unable to Check Retweet Task
        • Why Does it Show that I Have not Completed the Task Even Though I Have done it
        • Why Telegram's Invitation Task Cannot be Verified
    • How to Play Penny Win
      • Buzz Spin:
      • Lucky Draw
      • How Do We Ensure Fairness in Penny Win?
    • How to Engage with Offers
      • Guideline
      • Reward
      • Notes for Offer
  • PROJECT PARTNER TUTORIAL
    • To Get Started
      • Sign In
      • Giveaway Verification(KYC)
    • Giveaway Mode
      • Lucky Giveaway
      • Competition Giveaway
      • Achievement Giveaway
      • Referral Giveaway
    • How to Create a Giveaway
    • Reward Payment
    • Giveaway Data
    • How Can I Check My Giveaway Creation History
    • Other FAQ
      • Toolkit
        • Offline Event Luckydraw
      • Tasks
        • Task Types and Set Up
          • Social Media Tasks
          • Website Tasks
          • App Tasks
          • Share Giveaway Tasks
          • Collect/Verify Information Tasks
          • Eligibility Tasks
        • Callback Verifications Instruction
          • How to Verify App Installs with Callback Verification
          • How to Verify Custom Reward From Your Website with Callback Verification
          • How to Verify the User/Player/VIP Level Requirement on Your Website with Callback Verification
          • How to Set and Verify Custom App Actions with Callback Verification
          • How to Verify Actions on Your Website with Callback Verification
        • Why Does My Group/Channel not Listed in Telegram Task
      • Reward-related issues
        • Reward Types and Set Up
          • Token Reward
          • NFT Reward
          • OAT Reward
          • Gift Cards/Keys/Codes Reward
          • Pass Reward
          • Subscription Reward
          • Custom Reward
          • Other Prize
        • If the Token Reward Have not Been Fully Auto-Distributed, When Will I Receive a Refund
        • How to Create Free Mint NFT Rewards
      • Why is My Giveaway No Activated/ Invalid? And How to Activate it?
      • How to Edit My Giveaway
      • How to Customize and Design My Giveaway Page
      • What Kind of Draw Methods are Supported & How to Select the Appropriate One
      • How Can I Check the History of the Giveaways I Have Created
      • What Happens If Fail to Meet the Goal in Goal-Triggered Giveaway?
      • What is Project Dashboard & How to Build/Manage/Use My Project Profile
      • What is ''Share Giveaway to Get More Chance to Win'' Feature and How to Use it
      • How to Create a Partnership with Another Project to Co-Host a Giveaway
  • Conditions and Policy
    • Anti-Money Laundering Policy
    • Anti-Robot Strategies
    • Privacy Policy
    • Terms of Service
Powered by GitBook
On this page
  • Why Callback Verification?
  • Step 1
  • Step 2
  • Step 3
  • Step 4
  • Step 5
  1. PROJECT PARTNER TUTORIAL
  2. Other FAQ
  3. Tasks
  4. Callback Verifications Instruction

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.

PreviousHow to Set and Verify Custom App Actions with Callback VerificationNextWhy Does My Group/Channel not Listed in Telegram Task

Last updated 1 year ago

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.

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.

Official API:

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