Technical Documentation

Marketer's Advisory

"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.

Edge Optimization

Our unified network layer uses intelligent regional routing to ensure sub-100ms response times for the Southern African market.

Revenue Model

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:

  1. Register: Create a Publisher account to get your `PUB_ID` and `API_KEY`.
  2. Install: Add the Connekt Ads SDK to your project via `pip` or `npm`.
  3. 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:

GET /api/v1/ads/serve?publisher_id={PUB_ID}&format=banner

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.

POST /api/v1/ads/impression
{ "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 Optimized

Interstitial

Full Screen Signal

Video Signal

HD Autoplay

Python 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.

Option 1: Direct Zip Installation
pip install https://ads.connekt.social/sdk/python/download/connekt-ads-sdk-v1.0.2.zip
Option 2: Local Source
pip install ./sdk/python
from connekt_ads import ConnektClient

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

<!-- Load the SDK -->
<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.

// Step 1: Request Ad
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.