Ditokomane tsa motlhabolodi

Kopo nngwe le nngwe e netefatswa ka senotlolo se se fitlhegileng mo sehloohong sa Tumelelo, go dirisiwa mokgwa wa Bearer.

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

Fa di-API key tsa gago di bula diakhaonto tsa babapatsi go badirisi ba gago (mokgwa wa Connect — bona Netefatso kwa godimo), o amogela kabelo ya se babapatsi bao ba se duelang dipapatso tsa bone. Kgaoganyo e e fa tlase e balwa ka tlhamalalo go tswa mo go yone endpoint eno, ga e ise e ke e kwalwe ka khoutu, mme e kgaogane gotlhelele le khomišene ya phetisetso e e kwa tlase mo tsebeng eno.

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

Kafa e dirang ka teng

1. Mongwe wa babapatsi ba gago ba Connect-mode o duela papatso ka kgolagano ya gago.
2. Papatso e sekasekwa le go amogelwa — ka boyone, kgotsa ke setlhopha sa rona sa bolaodi.
3. Kabelo ya gago e beilwe mo moleng go duelwa ka boyone mo sepatshe sa gago, ka mokgwa o o tshwanang le wa lenaneo la go romela batho le le fa tlase.

Maitemogelo a tuelo

• Sekwalo sa go duela ka crypto se rulagantswe mo akhaontong ya molekane wa gago.
• Ga go tlhokafale KYC mo letlhakoreng la gago — akhaonto ya gago ya molekane e setse e tlhatlhobilwe fa e tlhamiwa.

Sekao: go bala diabe tse di kgobokantsweng

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

Akhaonto nngwe le nngwe ya mo-phasalatsi e bona sete ya didirisiwa tsa AI tse di agilweng mo teng — motlhagisi wa diteng tsa phasalatso le ditshwantsho, mothusi wa dipuisano, mogakolodi wa tekanyetsokabo, le motlhatlhobi wa SEO wa kwa ntle — tse di duelelwang ka dikeretiti tsa AI, go tlaleletsa mo tlhwatlhweng e e sa fetogeng ya ngwaga le ngwaga.

Sekao — tlhama diteng tsa papatso

Setlhopha se se tshwanang le tlhaloso ya kgwebo gape di tsamaisa motlhagisi wa ditshwantsho o o kwa tlase.

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

Tlhama setshwantsho se se tsamaelanang le papatso e e tshwanang:

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

Tsenya yuniti ya papatso e e setseng e dirilwe mo saeteng ya gago — ga go tlhokege go e aga, ga go tlhokege iframe. Script e tlhagisa diteng ka tlhamalalo mo tsebeng mo teng ga Shadow DOM e e ikemetseng, ka jalo ditaele tsa yone ga di tsene mo saeteng ya gago, mme ditaele tsa saete ya gago ga di tsene mo go yone.

E tsenye mo tsebeng ya gago

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Ka tlwaelo seno se bontsha maemo a a feletseng a botlhe a setlhopha — motlamedi mongwe le mongwe mo sethaleng, e seng fela ba o ba tlisitseng. Go bontsha fela dipapatso go tswa go batlamedi ba o ba dirileng ka mokgwa wa Connect (ba ba go direlang kabelo ya gago), tsenya data-partner ka ID ya molekane wa gago (e bone mo tsebeng ya Batlhami mo dashboardeng ya gago):

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Fa dipapatso tsa gago di akareditse mefuta e le mentsi, tlogela data-category gotlhelele — ka go dirisa data-partner fela, widget e bontsha dipapatso tsotlhe tsa gago mo mefuteng yotlhe mo lenaneong le le lengwe, go na le go tlhoka boloko e le nngwe ya widget mo mofuteng mongwe le mongwe:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

A o batla yuniti ya moetlele e e bapileng le ya gago e e mo teng ga dikgang, nngwe le nngwe e supa dipapatso tse di farologaneng? Tsenya boloko jwa bobedi jwa widget ka data-layout="compact" (papatso e le nngwe, e e ka phuthwang go nna selanyana se sennye) le data-offset e e beilweng go ya ka palo ya dipapatso tse widget ya gago ya ntlha e setseng e di supa:

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Dikarolo

Kafa khomišene ya phetisetso ya molekane e mo fitlhelelang ka teng tota — phesente, mokgwa wa go duela, le mabaka a a botlhokwa.

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

Melao ya tuelo

• Palogotlhe ya mopapatsi ya madi a a duelelwang e fitlha mo selekanyong se se kwa tlase sa tuelo.
• Wallet ya go duela ka crypto e rulagantswe mo akhaontong ya bone.
• Maemo a bone a KYC a netefaditswe.

Sekao: go bala madi a a kgobokantsweng

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

Maemo a ditlhwatlhwa (e tsweletse)

Bala ka tlhamalalo go tswa mo ntlheng eno — o se ka wa kwala boleng jono ka go tlhamalala mo khoutung, ka gonne bo ka fetoga mo letlhakoreng la rona. Aga sebopi sa maemo a ditlhwatlhwa sa badirisi ba gago mo boemong jwa lebokoso la palo ya mahala: tlhwatlhwa nngwe le nngwe e e bontshiwang ke yone tota e e tshwanetseng go romelwa fa go dirwa tuelo, mme mesola e e senotsweng e e bontshiwang fano e bolelela badirisi gore tlhwatlhwa eo e ba fa eng, gore ba kgone go tlhopha tlhwatlhwa e ba e tlhaloganyang mo boemong jwa go fopholetsa palo.

Dikopo di lekanyeditswe ka senotlolo, ka motsotso. Karabo nngwe le nngwe e e netefaditsweng e na le ditlhogo tsa X-RateLimit-Limit, X-RateLimit-Remaining, le X-RateLimit-Reset; go feta selekanyo go busetsa 429 Dikopo di le Dintsi Thata ka tlhogo ya Retry-After.

Go itlhophela, ka molekane mongwe le mongwe. Go fitlha o tsenya tsenyo, dilotlolo tsa gago di amogela dikopo go tswa mo IP nngwe le nngwe — tsenyo ya ntlha e fetola dilotlolo tsotlhe tsa molekane yoo go di letla fela mo lenaaneng la ba ba letleletsweng.

Webhook nngwe le nngwe e saenilwe ka HMAC-SHA256 go dirisiwa sephiri se se ntshitsweng gangwe fela, ka nako ya tlhamo — tlhomamisa mosaeno pele o ka tshepa payload. Ditiragalo di romelwa fela kwa molekaneng yo e leng mong wa motlhagisi yo o amanang.