⚡
claimr
  • Getting started
    • Create an account
    • Sign in to your account
    • Reset password
    • Edit profile
  • ⚡️claimr core components
  • Team roles and management
  • Campaigns
    • Create new campaign
    • Campaign settings
  • Groups
    • Create new group
    • Group settings
  • Quests
    • Create new quest
    • Quest settings
  • Tasks
    • Create new task
    • Task settings
    • Telegram tasks
    • X (Twitter) tasks
    • TikTok tasks
    • Discord tasks
    • YouTube tasks
    • Web3 tasks
      • Connect a wallet
      • Transactions count
      • Wallet balance
      • Token balance
      • NFT balance
      • Link3 balance
      • Mint an NFT (721)
      • Mint an NFT (1155)
      • Verify transactions
    • PoW tasks
    • HTTP request tasks
    • Referral tasks
    • Form tasks
    • Poll tasks
    • Events tasks
    • API tasks
  • Widget
    • Publish campaign
    • Widget configurations
    • Widget attributes
    • Integrate claimr widget into your website
    • claimr widget integrations
      • Google Analytics integration
      • Google Analytics Client ID
      • Google Tag Manager integration
      • HotJar integration
  • Rewards
    • Reward settings
    • Custom rewards
  • Events
    • Daily check-ins
    • Challenges
    • Ranks
    • KOLs
  • Codes
    • Secret codes
    • Invite codes
      • Enter invite code task
      • Claim invite code task
    • Gift codes
  • Test users
  • Pop-ups
    • Into pop-up
    • Completion pop-up
  • API
    • API token
    • API methods
    • User token
  • Webhooks
    • Set up webhooks
    • Assign webhooks
    • Webhook scopes
  • SDK
  • Forms
    • Create forms
    • Form settings
    • Pages
    • Blocks
    • Quizzes
  • Data analytics
    • Activity
    • PoW analytics
    • User information
    • Failed actions
    • Issues analytics
  • How to
    • Create X campaign
    • Create Discord campaign
    • Integrate claimr widget into dApp
    • Integrating claimr widget into Telegram mini app
    • Customize user experience with tags and attributes
    • Add custom points to users
  • UX requirements
    • Campaign UX requirements
    • Group UX requirements
    • Quest card UX requirements
    • Quest UX requirements
    • Task UX requirements
    • User progress UX requirements
    • Pop-ups UX requirements
    • Interactive components UX requirements
Powered by GitBook
On this page
  • What are Events Tasks?
  • Use Events tasks to:
  • Events count
  • Events value
  • Example of a query generated by Chat GPT:

Was this helpful?

  1. Tasks

Events tasks

PreviousPoll tasksNextAPI tasks

Last updated 3 days ago

Was this helpful?

What are Events Tasks?

The Events task type allows you to reward users in claimr based on specific actions or occurrences that happen within your own application or product. This is ideal for integrating off-platform user activity with your claimr reward system.

Use Events tasks to:

  • Reward users for in-app actions, like completing levels in a game or making a purchase.

  • Sync external user achievements with their claimr profile.

  • Track specific user behaviors that are relevant to your campaign goals.

  • Encourage participation in activities outside of the claimr platform

For detailed information about general task settings, including task name, header, description, rewards, dependencies, and more, refer to Task settings.

Events count

  1. Select Events.

  2. Select Custom Events Count to specify the task.

Once you've selected both, move on to configuring the specific settings for your Event task and configure the following fields:

  • Event Category: This defines a broad classification for the event that is sent from your application. For example, it could be "Dices" if the action is related to a game, or "Transaction" for a financial action. This helps in filtering and organizing events within your claimr analytics.

  • Name: This is the specific name of the action or event you want to count. For instance, if the category is "Dices," the name could be "game session" to signify a completed gaming session. This precisely identifies the user action.

  • Platform: This field helps claimr identify how the user involved in the event was logged in or recognized on your platform. For example, if the user logs in via Web3, you would specify "Web3," linking the event to their wallet. This ensures that the incoming event data from your application is correctly associated with the specific user in claimr.

  • Events count: Specify the target number of times this event must occur for the user to complete the task and receive the reward.

  • Button text: This is the text that will appear on the button for this task in the claimr widget for users to interact with.

Events value

  1. Select Events.

  2. Select Custom Events Value to specify the task.

Select Custom Events Value to specify the task. Once you've selected both, move on to configuring the specific settings for your Event task and configure the following fields:

  • Event Category: This defines a broad classification for the event that is sent from your application. For example, it could be "Dices" if the action is related to a game, or "Transaction" for a financial action. This helps in filtering and organizing events within your claimr analytics.

  • Event Name: This is the specific name of the action or event you want to count. For instance, if the category is "Dices," the name could be "game session" to signify a completed gaming session. This precisely identifies the user action.

  • Platform: This field helps claimr identify how the user involved in the event was logged in or recognized on your platform. For example, if the user logs in via Web3, you would specify "Web3," linking the event to their wallet. This ensures that the incoming event data from your application is correctly associated with the specific user in claimr.

  • Query: This field holds the detailed data requested by the API call, such as a list of completed actions or quests. Its specific content will vary depending on the type of activity retrieved.

  • Events value: The aggregated numerical result related to the query, such as a total count or a final score.

  • Button text: This is the text that will appear on the button for this task in the claimr widget for users to interact with.

Example of a query generated by Chat GPT:

Prompt example: Provide a JMESPath query to extract the data.bet attribute from each item in a list.

Prompt answer:

To extract the data.bet attribute from each item in a list using JMESPath, use the [].data.bet query:

  • [] — iterates over each element in the list.

  • .data.bet — accesses the data.bet attribute of each element.

[
  { "data": { "bet": 100 } },
  { "data": { "bet": 200 } },
  { "data": { "bet": 300 } }
]

Result

[100, 200, 300]

Remember, these events are sent from your client application to claimr via an API method. For details on the API method used to send these events, please refer to the API methods.