Network Integration Guide¶
The Preads Platform serves as a high-performance aggregator for global advertising networks. With 28+ native integrations, the platform provides a unified interface for offer management, automated synchronization, and surgical postback tracking across all major industry providers.
🌐 Native Integrations (28+)¶
The platform is pre-configured with direct API hooks for the world's leading offerwall and CPA networks:
- Tier 1 Offerwalls: AdGate Media, Lootably, BitLabs, Monlix, Torox (formerly DoneData), Revlum, and Wannads.
- Performance Networks: CPALead, CPAGrip, OGAds, Adscend Media, and AdGem.
- Specialized Providers: CPX Research (Surveys), Pubscale, Farly, and AyetStudios.
- Emerging Aggregators: Notik, AdBreak, PrimeWall, KiwiWall, and others.
🔄 Automated Offer Engine¶
Manage thousands of offers across dozens of networks with our streamlined three-step synchronization workflow.
1. Unified Configuration¶
Each network can be activated by providing its specific API credentials (API Keys, Media IDs, User IDs). The platform automatically maps these to the correct network service.
2. Fetch & Preview¶
- On-Demand Refresh: Trigger real-time API fetches to retrieve the latest offer inventory.
- Intelligent Preview: Review offer details (Name, Payout, Country, Device Requirements) in a paginated sandbox before importing them into your live wall.
3. Background Import¶
- Asynchronous Scaling: Imports are processed via a background queue system (
ImportOffersJob), allowing you to scale up to 10,000+ offers without impacting system performance. - Payout Ratio Control: Automatically adjust your profit margins by setting a global or per-network payout ratio (e.g., set to 80% to retain a 20% platform margin).
- Automated Sync: Enable
Auto-Importto let the system periodically refresh and prune offer inventory via background CRON tasks.
📡 Universal Postback System¶
The platform features a surgical Server-to-Server (S2S) postback engine for real-time conversion reporting between external networks and your platform.
Standard Postback Macro Set¶
Integrate with any network using our comprehensive set of dynamic macros:
| Macro | Description |
|---|---|
{user_id} |
End-user identifier from your platform |
{transaction_id} |
Unique conversion/network transaction ID |
{offer_id} |
Internal ID of the offer or providing network |
{payout} |
Payout amount in USD from the network |
{reward} |
Calculated reward in your app's virtual currency |
{ip} |
User's IP address at the time of conversion |
{status} |
Current state (approved, rejected, pending) |
{aff_sub1-4} |
Pass-through parameters for advanced tracking |
🛠️ Performance & Monitoring¶
- Postback Logs: Complete visibility into every incoming network hit and every outgoing publisher notification, including full HTTP headers and response bodies.
- Retry Logic: Automated retry queues for failed outgoing postbacks to ensure publishers never miss a conversion due to transient network issues.
- Status Mapping: Intelligent status translation that ensures network-specific responses are correctly mapped to platform-standard
ApprovedorRejectedstates.