Skip to main content

How to configure an offer with several events

How to configure an offer with several events

J
Written by Jorge Rubia

Some Offers track more than one conversion event — for example, an app campaign that tracks an Install, a Registration, and a Sale within the same Offer. Each event can have its own classification, payout, and visibility settings.

This article walks through a complete example of how to set up a multi-event Offer in Aftrad.


Overview

In this example, the Offer has three events:

  • Install — tracked as a KPI (informational, no payout)

  • Registration — tracked as Payable ($2 per conversion)

  • Sale — tracked as Payable ($10 per conversion)

Each event is configured as a separate payout rule in General > Payouts & Events. The Install is set as the Default payout rule, and Registration and Sale are set as Custom payout rules.

💡 Tip: The Default payout rule acts as a catch-all — any event that doesn't match a Custom rule will be attributed as the default event type. In multi-event Offers, it's common to use the Default rule for the first event in the funnel (e.g., Install) and Custom rules for subsequent events.


Step 1 — Configure the Default payout rule (Install)

The Install event is configured as the Default payout rule with the following key settings:

  • ClassificationKPI — this event is tracked for reporting purposes only and does not generate a payout for the Affiliate.

  • Event parameter — leave empty or set to None, since any postback without an event_parameter value will match the Default rule.

For a full description of all available fields, see Offer payout rules.


Step 2 — Configure the first Custom payout rule (Registration)

The Registration event is configured as a Custom payout rule with the following key settings:

  • Event parameter — set to List, with the value registration. This means Aftrad will apply this rule only when the Advertiser sends event_parameter=registration in their postback.

  • ClassificationPayable — this event generates a payout for the Affiliate.


Step 3 — Configure the second Custom payout rule (Sale)

The Sale event is configured as a Custom payout rule with the following key settings:

  • Event parameter — set to List, with the value sale. Aftrad will apply this rule only when the Advertiser sends event_parameter=sale in their postback.

  • ClassificationPayable — this event generates a payout for the Affiliate.

Step 4 — Share the Postback URL with the Advertiser

Share the Advertiser Postback URL with the Advertiser and agree on the event_parameter value they will send for each event. These values must match exactly what you configured in the payout rules above.

For this example, the Postback URL structure is:

https://yourpostbackurl.com/api/v1/events?click_id={click_id}&event_parameter={event_type}&payout={payout}

And the expected postbacks per event are:

Installevent_parameter is empty or not sent:

https://yourpostbackurl.com/api/v1/events?click_id=XXXXXXXX

Registrationevent_parameter=registration:

https://yourpostbackurl.com/api/v1/events?click_id=XXXXXXXX&event_parameter=registration

Saleevent_parameter=sale:

https://yourpostbackurl.com/api/v1/events?click_id=XXXXXXXX&event_parameter=sale&payout=10

Step 5 — Verify events in Advertiser Events

Once the Advertiser starts sending postbacks, go to Performance Hub > Advertiser Events and filter by Click event ID to verify that each event is being received and correctly attributed.


Related articles

Did this answer your question?