Singular is a marketing attribution and analytics platform that unifies campaign data across ad networks, measures ROI, and provides fraud prevention. Integrating Singular with Aftrad allows you to send traffic through Singular-tracked offers and receive postback notifications in Aftrad when installs or in-app events occur.
Overview
The setup consists of two parts:
Configure the offer in Aftrad — map Aftrad macros to the required Singular URL parameters
Configure the postback URL in Singular — set up Aftrad's event endpoint in Singular so it can notify Aftrad of conversions
Part 1 — Configure the offer in Aftrad
Create or edit the offer in Aftrad and set the Singular tracking URL provided by the advertiser as the offer's Tracking URL.
Singular tracking URLs require specific parameters to receive attribution data. Add the following parameters to the URL, using the corresponding Aftrad macros as values:
Singular parameter | Aftrad macro | Description |
|
| iOS Identifier for Advertisers |
|
| Google Advertising ID (Android) |
|
| Publisher / source name |
|
| Creative identifier |
|
| Operating system |
|
| User IP address |
|
| Aftrad click ID — used by Singular to send postbacks back to Aftrad |
|
| Publisher site ID |
|
| Custom parameter 1 |
|
| Aggregated click ID |
|
| User agent |
A typical Singular tracking URL with all parameters would look like:
https://singular.tracking-link.sng.link?[your-offer-params] &idfa={idfa} &andi={gaid} &psn={source} &pcrn={creative} &ve={os} &ip={client_ip} &cl={click_id} &psid={source} &pca={custom1} &source_media_type={aggregate_id} &ua={af_ua}
Not all parameters are required for every offer. Add only the ones relevant to your setup and that Singular is expecting for the given integration.
Part 2 — Configure the postback URL in Singular
In your Singular account, configure Aftrad's postback endpoint as the postback URL for this integration. This allows Singular to notify Aftrad whenever an install or in-app event occurs.
The postback URL to configure in Singular is:
https://[your-event-domain]/api/v1/events?click_id={cl}&event_parameter={EVTNAME}&payout={AMOUNT}Replace [your-event-domain] with the event domain configured for the Advertiser in Aftrad.
The Singular macros used are:
Singular macro | Aftrad parameter | Description |
|
| The Aftrad click ID passed in the original tracking URL — used to match the postback to the original click |
|
| The event name as defined in Singular (e.g. |
|
| The revenue amount associated with the event |
Network-specific click ID format
Singular supports a network-qualified format for the {cl} macro:
{cl?network-name}Where network-name is the identifier of your network in Singular. Use this format if Singular requires it for your specific integration to ensure the click ID is correctly resolved.