Developer Documentation
ZenTrack Integration Docs
Integrate the ZenTrack offerwall into your application using our secure offerwall URLs, iframe integrations, and postback tracking system.
Offerwall Integration
Use the following URL format to integrate the ZenTrack offerwall into your website or mobile application.
https://zentrack.company/offerwall.php?placement_id=12&user_id=USER_123
| Parameter | Description | Example |
|---|---|---|
| placement_id | Your placement ID | 12 |
| user_id | Your unique user identifier | USER_123 |
Iframe Integration
Embed the ZenTrack offerwall inside your platform using iframe integration.
<iframe
src="https://zentrack.company/offerwall.php?placement_id=12&user_id=USER_123"
width="100%"
height="800"
frameborder="0"
style="border:none;border-radius:16px;">
</iframe>
| Option | Description |
|---|---|
| width="100%" | Responsive full width |
| height="800" | Offerwall frame height |
| border:none | Removes iframe border |
Postback Setup Guide
Use these macros in your Postback URL to receive conversion data in real time.
https://yourwebsite.com/postback.php?user_id={subid1}&offer_name={offer_name}&payout={payout}&reward={currency_amount}&transaction_id={transactionId}&status={status}&ip={ip_address}
| Macro | Description | Example Value |
|---|---|---|
| {subid1} | Your User ID | USER_123 |
| {offer_name} | The completed offer name | Coin Master |
| {payout} | Payout amount in USD | 0.75 |
| {currency_amount} | Reward amount | 75 |
| {transactionId} | Unique conversion ID | TXN_93822 |
| {status} | Conversion status | approved |
| {ip_address} | User IP address | 192.168.0.1 |
Response Examples
Example JSON responses from your server after receiving a postback.
{
"success": true,
"message": "Reward added successfully"
}
{
"success": false,
"message": "Duplicate transaction"
}
Best Practices
Recommended Integration Tips
- Always validate postbacks server-side
- Prevent duplicate transaction IDs
- Use HTTPS only
- Store conversion logs
- Validate payout amounts
- Avoid iframe inside iframe
- Use responsive layouts for mobile users