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
  • 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 App Installs with Callback Verification

Enable callback verification to automatically verify if users really downloaded the app. Only participants who have downloaded the app are able to complete this task.

PreviousCallback Verifications InstructionNextHow to Verify Custom Reward From Your Website with Callback Verification

Last updated 1 year ago

Enable callback verification to automatically verify if users really downloaded the app. Only participants who have downloaded the app are able to complete this task.

Follow the steps to enable the callback verification:

Step 1

To let participants know what the task is, choose one or more tasks and give them a name as a description.

  • Add Single or Multiple Tasks

You can choose one of the existing tasks or click the 'Custom task' button to add a different task with or without a specific value related to the task. You can also choose or custom multiple tasks for participants to complete in order to join your giveaway.

Step 2

Then, you need to get url search params from your website and parse out the track_id.

track_id=U$MikHklwcY&sign_up=true&invite=true

About track_id:

  • Every participant will have a unique track_id, so that we can verify if the participant really complete the required task. The ?track_id={{ track_id }} will be used for verification.

  • You will see the ?track_id={{ track_id }}&send=true applied to your website link:

For example, if your website link is

http://example.com

the participants may come to your site via a link like this

http://example.com/?track_id=12345_67890&send=true

Step 3

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

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=send&remark=${remark}`; // remark is optional.

Step 4

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

Note: adding a remark is optional.

const api_key = "{{your api_key}}";
const {track_id} = queryString.parse(window.location.search); // url search
const event="send" //your chosen event
const remark = "remark"; //add remark optional
const value="{{your event value}}"
const data = `track_id=${track_id}&event=${event}&value=${value}&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. So you only need to integrate once for a website. Also, you will be able to create tasks on multiple websites if you need to.

Add a Custom Tasks Moreover, it is also possible to customize tasks and add relevant required amount. Like 3 articles on your website Then your custom tasks will appear as follows:

Official API:

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