An advertiser can notify more than one event for the same click, both payable and non-payable: for example, a mobile game that reports the install, the registration, purchases in the game and subscription renewals. In Aftrad, each event has its own payout rule in the offer, and the advertiser says which event it is with the event parameter of each postback.
This article walks you through a complete example, Bug Hunter, a mobile game. Open the offer and go to General → Payouts & Events.
Overview
Event | Payout rule | Event parameter the advertiser sends | Classification | Visibility | Payout |
Install | Default payout | None | KPI | Public | No payout |
Registration | Registration, ES; Registration, FR & IT; Registration, other countries |
| Payable | Public | Fixed, by country |
Purchase | Purchase |
| Payable, recurrent | Private | Sent by the advertiser in the postback; the affiliate isn't paid |
Subscription renewal | Subscription |
| Payable, recurrent | Public | Sent by the advertiser in the postback |
Aftrad checks the custom rules from top to bottom and applies the first one whose event parameter and targeting (countries, affiliates, carriers, platforms) match the postback and its click. A postback that matches no custom rule gets the default payout.
Default payout: the install
The default payout takes every postback that doesn't match a custom rule, so it's the place for the event the advertiser sends without an event parameter: here, the install.
Event type: Install.
Event parameters: Any. A postback with no event parameter lands here.
Classification: KPI. The install is counted, but it isn't paid.
Note: The default payout accepts any event parameter. A postback whose event parameter matches no custom rule (for example level_up) also gets the default payout and counts as an install, with no payout. Agree on the exact values with the advertiser.
Custom rules
Registration: one rule per country
The three registration rules use the same event parameter: a List with the value registration. What changes is the country of the click and the payout:
Rule | Countries | Advertiser payout | Affiliate payout |
Registration, ES | Spain | $10 | $8 |
Registration, FR & IT | France, Italy | $14 | $11.20 |
Registration, other countries | Worldwide (empty) | $8 | $6 |
All three are Payable, with Payout in post back set to Ignored: the payouts are the fixed amounts of the rule.
Note: Put the most specific rules first. A registration from Spain matches Registration, ES before it reaches the rule for other countries.
Purchase: private, with the payout in the postback
Event parameter: List, with the value
purchase.Recurrent: Yes. The user can buy several items: each purchase is a new event, with its own price.
Payout in post back: Required. The advertiser sends the price of each purchase in the
payoutparameter.Advertiser payout modifier: 100%. Aftrad takes the full amount the advertiser sends.
Visibility: Private. The purchases aren't attributed to the affiliate: the advertiser pays for them, but the affiliate doesn't see them and isn't paid for them. That's why a private rule has no affiliate payout or margin.
Subscription: weekly renewals
Event parameter: List, with the value
premium. The value doesn't have to match the event type name: it's the text the advertiser sends.Recurrent: Yes. Aftrad accepts every renewal on the same click, for example one a week.
Payout in post back: Required, with an 80% margin: a $5 renewal offers the affiliate $1.
For every field of a payout rule, see Offer payout rules.
Share the postback URL with the advertiser
Click Copy advertiser's postback URL at the top of the offer and share it with the advertiser (you also find it in the advertiser's Postback URL tab). Agree on the event parameter value of each event: it must match the value in your payout rules exactly.
The URL has placeholders that the advertiser fills in for every event:
https://<event domain>/api/v1/events?click_id={click_id}&event_parameter={event_type}&payout={payout}
For one user of Bug Hunter, the advertiser sends these postbacks, all with the same click_id:
Event | Postback |
Install |
|
Registration |
|
Purchase: special item |
|
Purchase: power-up |
|
Purchase: skin pack |
|
Premium renewal (every week) |
|
Check the events in Advertiser Events
Go to Tools → Advertiser Events, click Filter and filter by Click event ID: you see every event the advertiser notified for that click.
These columns show how each postback matched its rule (choose them in Columns):
Event status: Withheld for the events of a private rule. Aftrad accepts the advertiser's payout, but the event isn't attributed to the affiliate.
Request event parameter and Request payout parameter: what the advertiser sent.
Postback event accepted payout: the payout Aftrad accepted from the advertiser.
Affiliate postback offered payout: the payout offered to the affiliate.
Returned offer event type: the event type of the rule that matched.
The eight postbacks of the example, for a click from Spain:
Event | Event status | Request event parameter | Request payout parameter | Returned offer event type | Accepted payout | Offered to the affiliate |
Install | Processed | – | – | Install | $0 | $0 |
Registration | Processed |
| – | Registration | $10 | $8 |
Purchase: special item | Withheld |
| $10 | Purchase | $10 | $0 |
Purchase: power-up | Withheld |
| $20 | Purchase | $20 | $0 |
Purchase: skin pack | Withheld |
| $30 | Purchase | $30 | $0 |
Renewal (×3) | Processed |
| $5 | Subscription | $5 each | $1 each |
