Onboarding

Wicked Reports channels offer a straightforward setup process using your API Key and event mapping to link your Wicked Reports account with EdgeTag seamlessly. This connection enables your site to stream conversion events — including clicks, contacts, and orders — to Wicked Reports, providing accurate first-party attribution and optimisation. Let's walk through the steps.

Add Channel

To add a channel, begin by entering the channel's name. We recommend choosing a name that clearly describes the channel you are adding. This will assist with debugging if any issues arise. Once you have entered the name, you'll need to configure your API Key authentication and map your conversion events.

Set Up API Key Authentication

Navigate to the Authorizations tab in your https://my.wickedreports.com/auth/dashboard and locate the API widget.

Click Enable to generate your unique API Key. Copy the API Key — you will need to paste it into EdgeTag.

Make sure to store your API Key securely. You will need it to authenticate all server-side events sent from EdgeTag to Wicked Reports.

In your EdgeTag channel configuration, paste the API Key into the API Key field. This allows EdgeTag to authenticate with the Wicked Reports Inbound API on every server-side request.

Configure Test Mode

Before going live, we recommend validating your setup using Wicked Reports' test mode.

Please refer the API documentation for details

Create Event Mappings in EdgeTag

Navigate to the Event Mapping section in your EdgeTag channel configuration. Click Add Event Mapping to begin mapping your site events to Wicked Reports endpoints.

Configure your event mappings with the following settings:

• Event Type: Select the appropriate type based on your conversion goal:

  • Click - For tracked click events with UTM parameters

  • Contact - For lead/signup/form submission events

  • Order - For purchase and transaction events

  • Order Item - For individual product line items within an order

  • Order Payment - For payment status events (approved, failed, refunded)

• EdgeTag Event Name: Select or enter the event name as configured on your site (e.g., purchase, lead, add_to_cart)

• Wicked Reports Event Name: Enter the corresponding event identifier that Wicked Reports expects for this endpoint

For the Event Name field, you'll need to copy the exact event name from EdgeTag. Navigate to your EdgeTag event mapping section, add the appropriate event mapping, and copy the exact Wicked Reports Event Name.

Copy the event name from EdgeTag (e.g., blotout_purchase) and paste it into the corresponding mapping. This ensures proper mapping between EdgeTag and Wicked Reports events.

Data Format Requirements

Ensure the following data requirements are met for accurate attribution:

• All dates must be converted to UTC timezone (UTC-0)

• Limit data to 1,000 rows per request (10MB) per endpoint

• Send only new, unique data — do not re-send duplicate historic records

• Contact events must include a valid email address for attribution matching

Save & Deploy

After configuring your API Key and mapping all desired events, click Save & Deploy to finalize the integration.