Events tracking
Events let you track actions that occur after the initial conversion, for example a first purchase after a free-trial registration, or an in-app purchase after an install. Events require a conversion to exist first; they cannot fire without a matching transaction_id from an earlier click.
Before you begin
- Create an offer with at least one conversion definition.
- Set up conversion tracking so the click-to-conversion path works end to end.
How events work
Events use the same postback mechanism as conversions, with two additional parameters:
event_id: the numeric ID of the event in Integr8.event_name: the name of the event as defined in Integr8.
Either parameter alone is sufficient, or you can pass both. The values must match exactly what was defined when the event was created.
Example postback URLs:
https://your.domain.com/?secure=TOKEN&event_id=5&transaction_id=REPLACEhttps://your.domain.com/?secure=TOKEN&event_name=purchase&transaction_id=REPLACECreate an event
- Go to Offers > Offers Management and open the offer.
- Select the Revenue & Payout tab.
- Click Create.
- Set:
- Event Name: must match the name the advertiser passes in their postback. For AppsFlyer integrations, use the exact event name from the AppsFlyer dashboard.
- Revenue Type and Revenue Value.
- Payout Type and Payout Value.
- Map any additional parameters for the event postback URL.
- Optionally enable Allow multiple events with the same click ID if the same user can trigger this event more than once.
- Click Create.
Get the event postback URL
After creating the event, its dedicated postback URL appears in the Revenue & Payout tab. The URL is specific to this offer and event combination.
You can also use the global postback URL for events by appending &event_id= or &event_name= to it.
Field reference
| Field | Required | Description |
|---|---|---|
| Event Name | Yes | Must match the name the advertiser sends in the postback |
| Revenue Type | Yes | How the advertiser pays you for this event (CPA, CPS, CPL, Fixed) |
| Revenue Value | Yes | Amount or percentage |
| Payout Type | Yes | How you pay the publisher for this event |
| Payout Value | Yes | Amount or percentage |
| Allow multiple events with the same click ID | No | Enable when one user can fire the event more than once |
Next steps
- View event performance in Reports > Conversion and events report.
- Forward events to publishers so they receive the same notification.