Advertiser S2S Postback & MMP Integration

Complete technical specifications for Server-to-Server (S2S) postback conversion tracking and Mobile Measurement Partner (MMP) integrations.

How Tracking & S2S Postbacks Work

Step 1

User Clicks Offer

When a user clicks your offer on our network, our server generates a unique {click_id} token and redirects the user to your tracking URL.

Step 2

Goal Completed

The user completes your designated conversion goal (e.g. app install, registration, level 10). Your MMP or backend stores the initial click_id.

Step 3

S2S Postback Fired

Your server sends an HTTP GET request to our Postback endpoint with the matching click_id. Our system verifies and credits the conversion.

Destination URL Dynamic Macros

Include any of the following macros in your Destination Tracking URL. Our engine automatically substitutes them with real-time visitor data upon each click:

Macro	Description	Example Output	Required?
`{click_id}`	Unique click identifier generated by our system.	`clk_9f82a1c0d4e5`	Required for S2S
`{user_id}`	Publisher's unique player / user ID.	`USR_884210`	Optional
`{sub1}`	Sub-affiliate parameter 1.	`sub_affiliate_01`	Optional
`{sub2}`	Sub-affiliate parameter 2.	`placement_banner_top`	Optional
`{ip}`	Visitor's IPv4 or IPv6 address.	`192.168.1.1`	Optional
`{country}`	ISO 2-letter uppercase country code.	`US`, `SA`, `GB`	Optional
`{device}`	Visitor device platform (`android`, `ios`, `desktop`).	`android`	Optional

Inbound S2S Postback Endpoint

To register a conversion, fire an HTTP GET request to:

        https://advanta-new.winwallgame.com/postback?click_id={click_id}&event_id={event_id}
    

Query Parameters

Parameter	Type	Description	Example
`click_id`	`string`	Required. The exact click ID received when our network redirected the user.	`clk_9f82a1c0d4e5`
`event_id`	`string`	Optional (Required for Multi-Reward). The specific milestone event identifier.	`install`, `level_5`, `purchase`
`payout`	`numeric`	Optional. Override payout amount for variable CPS or dynamic purchase value.	`5.50`

Multi-Reward Campaigns Setup

For Multi-Reward tiered offers, each goal step defines an event_id (e.g. install_open, level_5, castle_lvl14).

When the user achieves each separate level, trigger a postback with the matching event_id:

        https://advanta-new.winwallgame.com/postback?click_id=clk_9f82a1c0d4e5&event_id=install_open
    

        https://advanta-new.winwallgame.com/postback?click_id=clk_9f82a1c0d4e5&event_id=level_5
    

        https://advanta-new.winwallgame.com/postback?click_id=clk_9f82a1c0d4e5&event_id=castle_lvl14
    

MMP Integration Templates

1. AppsFlyer

Tracking URL Format:

        https://app.appsflyer.com/com.yourapp.package?af_c_id={click_id}&af_sub1={user_id}&af_sub2={sub1}
    

AppsFlyer Postback Configuration:

        https://advanta-new.winwallgame.com/postback?click_id=(af_c_id)&event_id=(event-name)
    

2. Adjust

Tracking URL Format:

https://app.adjust.com/XXXXXX?adid={click_id}&campaign={sub1}&idfa={user_id}

Adjust S2S Postback Configuration:

        https://advanta-new.winwallgame.com/postback?click_id={adid}&event_id={event_name}
    

3. Singular

Tracking URL Format:

https://singular.net/track?p_id={click_id}&sub1={user_id}&sub2={sub1}

Singular Postback Configuration:

https://advanta-new.winwallgame.com/postback?click_id={p_id}&event_id={event}

4. Branch.io

Tracking URL Format:

https://yourapp.app.link/launch?click_id={click_id}&~campaign={sub1}

Branch Webhook Postback:

        https://advanta-new.winwallgame.com/postback?click_id=${(click_id)}&event_id=${(name)}
    

Server HTTP Response Codes

Status Code	Meaning	Explanation
200 OK	Success	Conversion recorded and approved successfully.
400 Bad Request	Invalid Parameters	Missing `click_id` parameter.
404 Not Found	Click Not Found	The `click_id` does not exist or has expired.
409 Conflict	Duplicate Conversion	This conversion was already registered and deduplicated.