Testing your campaign before going live

Overview

Merkl is not deployed on testnets, but you can still run test campaigns using our test token: aglaMerkl. This lets you validate the full flow and integrate our data before your real campaign starts.

Before you start

Test campaigns are not mandatory. They're available to help you experiment with how Merkl works using valueless tokens. A few things to keep in mind:

• Test campaigns will not appear on the Merkl app and are automatically filtered out from the interface
• Since they consume computation resources, please only use this feature when there's a clear need
• aglaMerkl has no monetary value and is only intended for creating test campaigns
• Test tokens have no price, so test campaigns will not have APRs. To validate an APR integration, use an existing live campaign instead

Step-by-step

1. Get the test token

Send us a message and we'll provide you with aglaMerkl tokens.

2. Create your test campaign

Create your campaign normally on Merkl Studio using aglaMerkl as the reward token. A campaign ID will be generated at creation, keep it handy.

3. Verify via the API

While the campaign won't show up in the Merkl app, you'll be able to check everything is working properly via the Merkl API, using the campaign ID generated at creation. Refer to the API integration page in the Merkl docs for details on how to query campaign data effectively.

Test campaigns and opportunities are filtered out of API responses by default. Append ?test=true to your requests to include them.

Make sure to verify:

• Distribution is functioning as expected: rewards are being computed and attributed correctly
• Key metrics like TVL are correctly computed: the protocol data is being indexed properly

Once everything looks good

If the API returns correct data, it will appear correctly in the Merkl frontend once your real campaign is live. You're ready to launch!

If you need help setting up your first test campaign, feel free to reach out to us.