Fuul
  • INTRO
    • ⚑What is Fuul?
    • πŸ’ͺWhy use Fuul?
    • πŸ€”Use Cases
    • βš™οΈIntegration
    • πŸ”—Main Links
  • HOW IT WORKS
    • πŸ’ΈTypes of Rewards
    • βœ…Conversion Events
      • 1️⃣CLAMM LPs (e.g. Uniswap V3)
      • 2️⃣Constant LPs (e.g., Uniswap V2)
      • 3️⃣Lending & Borrowing
      • 4️⃣Staking
      • 5️⃣Token Holders
      • 6️⃣Custom Onchain Events
      • 7️⃣Custom Offchain Events
  • πŸ€‘Incentive Payouts
    • πŸ—ΏFixed Rewards
    • 🌊Variable Rewards
    • πŸ’°Pool Distribution
  • πŸ§‘β€πŸ€β€πŸ§‘Referrals
  • ♾️Attribution Methods
  • πŸ’²Budgets
  • ⚑Fuul Incentives Manager
  • πŸŽ–οΈLeaderboards
  • πŸ’»Incentives Hub
    • πŸ‘¨β€πŸ’»White-Label Implementation
    • πŸ‘No-Code
  • FOR DEVS
    • ⭐Getting started with Fuul Web SDK
    • βš™οΈSending Custom Events through the API
    • πŸ“„Tracking referrals in your app
    • πŸ‘¨β€πŸ’»API Key Management
    • πŸ› οΈBuilding your incentives hub in your app (white-label)
      • ℹ️Getting all incentives information
      • πŸ”—Creating affiliate links or codes
      • πŸ’―Getting Leaderboard Data
        • πŸͺ™Tokens
        • 🌟Points
      • πŸ™‹Getting Individual Rewards
        • πŸͺ™Tokens
        • 🌟Points
      • πŸ€™Claiming Onchain Rewards
    • πŸ”§Building widgets
    • πŸ“’Managing Audiences and Segments
      • πŸ‘€Getting User Audiences using Fuul SDK
      • πŸ‘₯Updating Audience Segments using Fuul API
    • ✈️Migration from older SDK versions
    • πŸ†˜Troubleshooting
  • PROTOCOL
    • ⛓️Smart Contracts
    • 🧡Subgraphs
  • Guides
    • ✏️Getting Started
      • Creating Your First Incentive Program
      • How to Add a Budget in Fuul
  • 🏁Creating Triggers & Conversions
    • Understanding Triggers Types
    • Creating an Event with CSV file
  • 🎨Program Incentive Page
    • Building no code landing pages
  • πŸ“ŠAnalytics
    • Understanding Sybil Detection
Powered by GitBook
On this page
  • Finding Conversions Events
  • Finding Payouts
  1. FOR DEVS

Troubleshooting

This guide will help you resolve common issues related to missing conversion events or payouts in Fuul.

PreviousMigration from older SDK versionsNextSmart Contracts

Last updated 4 months ago

Important: Fuul uses a metadata system. Any changes made to your setup must be published for them to go live. If you don’t publish, the latest version will not be active.

Finding Conversions Events

If you cannot locate a conversion event, follow these steps:

  1. Check the Conversion Logs: Start by looking in the Conversion Logs.

  1. If the conversion is not there:

    1. Go to the Event Logs to search for the trigger event.

    2. Use the following filters:

      1. Date Range

      2. Address or Conversion Name

For Token Holders or Subgraph events, they are logged at the scheduled time - at 0 UTC if they run once a day, or at the specific times following the corresponding frequency.

  1. If you find the event in the Event Logs:

    1. Open the event and check the Trigger Execution section in the drawer:

      1. If there's an error, review the error message and adjust the configuration.

      2. If the trigger execution exists, check the conversion's rule configuration to ensure it's set up correctly.

  2. If the event doesn't have a trigger execution:

    1. Verify the trigger configuration

      1. Check if there are Condition Filters set.

      2. For Off-Chain Events, make sure the trigger's signature matches the event name sent via API.

  3. If the event is not in the Event Logs, this means Fuul did not receive the event.

    1. For Off-Chain Events, check if the API request returned a 201 (created) status.

    2. For On-Chain Events, verify that the trigger is configured correctly, including the contract and signature setup.

Finding Payouts

If you cannot locate a payout, follow these steps:

  1. Check the Conversion Logs: Look for the conversion in the Conversion Logs and review its Payment Status.

  1. If the conversion is in the logs but does not have a payout, open the conversion and check the status in the drawer:

    1. It may be flagged as fraud.

    2. The user may not belong to any audience.

  2. If none of these apply, check the incentive's payout configuration:

    1. Make sure payouts are set correctly. For example, if payouts are only for affiliates, verify that the conversion involves an affiliate.

    2. Confirm the conversion is configured to generate a payout.

  1. If you cannot find the conversion in the Conversion Logs, follow the steps in Finding Conversion Events above.

If you have reviewed these steps and still cannot locate the payout, contact us for assistance.

πŸ†˜