🆘Troubleshooting

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

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.