HudaTech — Platform Documentation

Overview

Hudatech is an ethical advertising network connecting advertisers with publishers through clean and safe ads. The platform focuses on protecting users and publishers by filtering harmful advertising and allowing only trusted campaigns.

Clearn Ads, Real Results. A trusted platform where publishers earn safely and advertisers reach real audiences — with 100% clean and safe-filtered ads.

Create Campaigns — advertisers can launch campaigns quickly.
Connect App / Website — publishers integrate easily using the Hudatech SDK.
Global Reach — campaigns can reach audiences worldwide.
Ad Formats — multiple ad formats supported.
24/7 Support — continuous assistance for advertisers and publishers.
Real-Time Reporting — track impressions, clicks, and performance instantly.

Payout Model

Hudatech pays publishers based on two revenue models: CPC (Cost Per Click) and CPV (Cost Per View). Publishers earn revenue when users click on ads or when ads receive valid views.

Clean Advertising Revenue

Even if the payout per click or view appears small, the real value comes from clean and trustworthy advertising. Hudatech only serves safe advertising inventory. That means your earnings do not come from adult (18+), gambling, scam, pirated media, or misleading ads.

This protects your website or app, your visitors, and your reputation while still generating consistent income. Over time, small but honest earnings can grow into reliable revenue you can trust.

Getting started

Create an account at hudatech.com.ng and verify your email.
Publishers: Add a new source at /publisher/sources — after approval you'll receive a unique publisher key (API key) scoped for ad retrieval.
Advertisers: Use the advertiser dashboard to create campaigns via the web UI.
Integrate the Web SDK using the snippets below. Replace the apiKey / publisher key with your assigned key.

Web SDK (Stable)

The HudaTech Web SDK allows publishers to integrate advertising into websites using a lightweight JavaScript library. The SDK automatically handles ad loading, rendering, impression tracking, and click tracking.

Each ad format requires two components:

The global SDK configuration (window.__HUDA_SDK_CONFIG__)
The format-specific SDK script

Replace your_apikey with your publisher API key from the HudaTech dashboard.

Ad Code Formats

Web — Banner Ad

Banner ads render inside a container element placed anywhere on your page. Add the configuration and script inside <head>, then place the banner container where you want the ad to appear.


<script>
window.__HUDA_SDK_CONFIG__ = {
  baseUrl: "https://ads.hudatech.com.ng",
  apiKey: "your_apikey"
};
</script>

<script src="https://ads.hudatech.com.ng/sdk/web/v1/banner.min.js"></script>

<div data-huda-banner data-huda-adunit="bottom_banner"></div>

Web — Box Ad

Box ads work similarly to banner ads but are typically used inside content areas, sidebars, or between sections of a page.


<script>
window.__HUDA_SDK_CONFIG__ = {
  baseUrl: "https://ads.hudatech.com.ng",
  apiKey: "your_apikey"
};
</script>

<script src="https://ads.hudatech.com.ng/sdk/web/v1/box.min.js"></script>

<div data-huda-box data-huda-adunit="home_box_1"></div>

Web — Interstitial Ad

Interstitial ads are full-screen ads that appear between page interactions such as page loads, button clicks, or navigation events.

Step 1 — Add SDK in the page head


<script>
window.__HUDA_SDK_CONFIG__ = {
  baseUrl: "https://ads.hudatech.com.ng",
  apiKey: "your_apikey"
};
</script>

<script src="https://ads.hudatech.com.ng/sdk/web/v1/interstitial.min.js"></script>

Step 2 — Trigger the ad display

Example: Show automatically on page load


<script>
document.addEventListener("DOMContentLoaded", function () {
  if (window.HudaInterstitial) {
    HudaInterstitial.show({
      adUnit: "page_interstitial"
    });
  }
});
</script>

Example: Show on user interaction (recommended)


<script>
function showHudaInterstitial() {
  if (window.HudaInterstitial) {
    HudaInterstitial.show({
      adUnit: "click_interstitial"
    });
  }
}
</script>

You can trigger the interstitial from any user action such as a button click:


<button onclick="showHudaInterstitial()">Continue</button>

Important: Loading the interstitial SDK alone will not display an ad. The ad will only appear when the HudaInterstitial.show() function is called. If the function is not triggered, the interstitial ad will not be displayed.

Security note: Never expose sensitive server keys in client code. Always use the publisher API key provided in your dashboard.

Mobile SDKs

HudaTech is expanding support for mobile and cross-platform development frameworks. Native SDKs and integration guides for the following platforms are currently in development. Full documentation and code examples will be published once they are released.

Android Studio (Android SDK) — Coming soon
Xcode (iOS SDK) — Coming soon
Flutter — Coming soon
Unity — Coming soon
Kodular — Coming soon
React Native — Coming soon
Ionic / Capacitor — Coming soon
Cordova — Coming soon

Until these SDKs are released, HudaTech advertising is currently supported on websites through the Web SDK described above.

API Reference (Publishers & Platform)

All API endpoints use HTTPS and require Authorization: Bearer YOUR_API_KEY. The documented APIs here focus on publisher operations (ad retrieval, reporting, earnings). Advertiser campaign management is done via the dashboard UI.

Error codes

Code	HTTP	Description
ERR_AUTH_01	401	Invalid or missing API key
ERR_REQ_02	400	Malformed request / validation error
ERR_RATE_03	429	Rate limit exceeded
ERR_APPPKG_04	400	Missing or invalid app_package parameter (mobile WebView requests)
ERR_INTERNAL_05	500	Server error — contact support

Rate limits

Default limits: 100 requests/minute per API key. Bulk/reporting endpoints may have different limits—see endpoint docs in the developer portal.

Authentication & Security

Use HTTPS for all requests. HTTP is not supported.
Keep API keys secret. Rotate keys if compromised.
Publisher keys are scoped for ad retrieval only; Advertiser actions must be performed via the dashboard UI.
Do not embed advertiser billing keys in client apps; perform sensitive operations server-side.

Policies & Moderation

All creatives and campaigns are reviewed for compliance with HudaTech's halal and ethical standards. Common rejection reasons include:

Non-halal offers (interest-based loans, gambling)
Adult or provocative content
Misleading claims
Malicious landing pages

Contact support for appeal: hudatech00@gmail.com.

Troubleshooting

Ad not showing

Confirm the apiKey is correct and publisher/source is approved.
Open the browser/device console for network errors.
Disable ad blockers and test again.

Missing app_package error

Mobile requests without app_package return ERR_APPPKG_04. Ensure you pass the correct package name/bundle id when mobile support is released.

Invalid traffic & payments withheld

We run automated fraud detection; if invalid traffic is detected impressions may be invalidated and payments adjusted. Publishers receive a report with details and can request review.

Support

For integration help and urgent issues email hudatech00@gmail.com. Include account ID, source ID, SDK version, and example URLs. For finance/payout queries include your publisher ID.

Changelog

v1.1.0 (2026-03-12) — Web SDK release: per-format web SDK snippets (banner, box, interstitial). Mobile / WebView integrations marked as coming soon.
v1.0.0 (2025-11-05) — Initial production documentation release.