Technical Documentation
"Traditional ad platforms bleed capital through bot-inflation and proxy inaccuracies. Connekt Ads uses RACP verification to ensure you only pay for human-verified, economic actions."
Infrastructure Overview
Connekt Ads is the ultimate yield engine for the African digital economy. Built for Professional Marketers and Performance Advertisers, the infrastructure combines protocol-level asset compression (CompRes™) with immutable settlement layers.
Our unified network layer uses intelligent regional routing to ensure sub-100ms response times for the Southern African market.
Transparent 70/30 revenue split for developers, paid out weekly in ZiG or USD via local banking rails.
Quick Start Guide
Follow these 3 steps to start earning with Connekt Ads:
- Register: Create a Publisher account to get your `PUB_ID` and `API_KEY`.
- Install: Add the Connekt Ads SDK to your project via `pip` or `npm`.
- Integrate: Initialize the SDK and call `serve()` to display ads.
Candidate Selection
Our algorithms select the best ad candidate based on user region, device profile, and available bandwidth. To request a manual candidate selection via API:
Response Payload
{
"status": "success",
"candidate": {
"id": "crt_8892",
"ad_type": "banner",
"content_url": "https://cdn.connekt.social/ads/v/banner_01.cp",
"click_url": "https://ads.connekt.social/track/clk/..."
}
}
Impression Logic
Impressions are verified via the **Robust Agent Communication Protocol (RACP)**. A valid impression must be sent using a POST request once the ad is visible for more than 1 second.
{ "creative_id": "crt_8892", "publisher_id": "pub_72", "signature": "..." }
Ad Formats
Connekt Ads supports a variety of formats designed for high-performance delivery. Preview them below using our live renderer.
Standard Banner
320x50 OptimizedInterstitial
Full Screen SignalVideo Signal
HD AutoplayPython SDK Reference v1.0.2 LTS
Install the professional-grade library via pip from our SDK repository or download the pre-packaged zip for offline use.
client = ConnektClient(publisher_id="...", api_key="...")
ad = client.get_ad(ad_type="banner")
Web SDK (Zero Config)
For frontend-only applications (React, Vue, or static HTML), use our standalone JavaScript SDK. This method is Zero Config—no backend or complex signature logic required.
1. The Snippet
<script src="https://ads.connekt.social/static/js/connekt-ads.js"></script>
<!-- Placement Placeholder -->
<div data-connekt-ad
data-pub-id="YOUR_PUBLISHER_ID"
data-ad-type="banner">
</div>
SECURITY NOTICE: The Web SDK uses 1x1 tracking pixels for secure front-end attribution. It does not require your `API_KEY`. Video ads are automatically rendered with autoplay and muted-loop settings.
Game Engine Integration
Connekt Ads is designed for immersive digital worlds. Our REST API allows you to pull high-fidelity creatives directly into Unity (C#), Godot (GDScript), or Unreal Engine for in-game billboards and meta-ads.
1. Setup (C#/GDScript)
Fetch the ad candidate and apply the `creative_url` as a Texture2D to your material.
GET /api/v1/ads/serve?publisher_id={ID}&ad_type=banner
// Step 2: Load Texture
Unity: UnityWebRequestTexture.GetTexture(data.creative_url);
Godot: var img = HTTPRequest.request(data.creative_url);
// Step 3: Log (Minimal Effort)
GET {track_url} when visible.
In-Game Billboards
Map the `creative_url` to a Quad or Plane in your 3D world. Support for both static Images and Video Textures is natively supported via the `VideoPlayer` component.
Full-Screen Ads
Instantiate a Canvas/UI overlay. Display the image or video commercial and provide a "skip" button after 5 seconds.