Akwụkwọ ntuziaka onye mmepe

Arịrịọ ọ bụla na-enweta nkwenye site n'iji igodo nzuzo dị na isi Authorization, na-eji usoro Bearer.

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

Ọ bụrụ na igodo API gị na-emepụta akaụntụ ndị mgbasa ozi maka ndị ọrụ gị (ụdị njikọ — lee Nnwale n'elu), ị na-enweta òkè nke ihe ndị mgbasa ozi ahụ na-akwụ maka mgbasa ozi ha. Nkewa dị n'okpuru a na-agụ ya ozugbo site na otu njedebe a, a naghị ede ya n'ime koodu, ma ọ dịkwa iche kpamkpam na komishọn ntụnyere dị n'okpuru peeji a.

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

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

Otu ọ si arụ ọrụ

1. Otu n'ime ndị mgbasa ozi gị nọ na Connect-mode na-akwụ ụgwọ mgbasa ozi site na njikọ gị.
2. A na-enyocha ma kwado mgbasa ozi ahụ — na-akpaghị aka, ma ọ bụ site n'aka otu nchịkwa anyị.
3. E tinyeela òkè gị n'usoro maka ịkwụ ụgwọ akpaghị aka n'akpa ego gị, otu usoro ahụ dị ka mmemme ntụnyere dị n'okpuru.

Ọnọdụ ịkwụ ụgwọ

• E haziri akpa ego nkwụghachi crypto na akaụntụ onye mmekọ gị.
• Enweghị mkpa KYC n'akụkụ gị — a nyochaala akaụntụ onye mmekọ gị kemgbe e kere ya.

Nlereanya: ịgụ òkè e chịkọtara

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
}

Akaụntụ onye mgbasa ozi ọ bụla na-enweta ngwugwu ngwaọrụ AI etinyere n'ime ya — ngwaọrụ mmepụta ọdịnaya mgbasa ozi na ihe onyonyo, onye enyemaka mkparịta ụka, onye ndụmọdụ mmefu ego, na onye nyocha SEO si n'èzí — a na-akwụ ụgwọ ha site na kredit AI, na mgbakwunye na ọnụahịa kwa afọ kwụ ọtọ.

Nlereanya — mepụta ọdịnaya mgbasa ozi

Nkewa ahụ na nkọwa azụmahịa ahụ na-enyekwa ike igwe mmepụta onyonyo dị n'okpuru.

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
}

Mepụta onyonyo kwekọrọ na mgbasa ozi ahụ:

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
}

Tụba otu ngalaba mgbasa ozi e kwadebere na saịtị gị — enweghị usoro iwuli, enweghị iframe. Skript ahụ na-egosipụta ozugbo n'ime ibe ahụ n'ime Shadow DOM mechiri emechi, ya mere ụdị ya anaghị apụta na saịtị gị, na ụdị saịtị gị anaghị apụta na ya.

Tinye ya na ibe gị

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

N'ozuzu, nke a na-egosi nhazi ọha zuru ezu maka ụdị ahụ — onye mgbasa ozi niile dị na ikpo okwu ahụ, ọ bụghị naanị ndị ị butere. Iji gosi naanị mgbasa ozi sitere n'aka ndị mgbasa ozi ị mepụtara site na usoro njikọ (ndị na-emepụta òkè gị), tinye data-partner yana ID onye mmekọ gị (chọta ya na ibe ndị mmepe na dashboard gị):

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

Ọ bụrụ na ndị mgbasa ozi gị gbasara ọtụtụ ụdị, wepụ data-category kpamkpam — site n'iji data-partner naanị, widget ahụ na-egosi mgbasa ozi gị niile gafee ụdị niile n'otu grid, kama ịchọ otu blok widget maka ụdị ọ bụla:

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

Ị chọrọ otu ngwá ọrụ ụdị footer n'akụkụ nke dị n'ime ọdịnaya gị, nke ọ bụla na-egosi mgbasa ozi dị iche? Tinye blọkụ widget nke abụọ nwere data-layout="compact" (otu mgbasa ozi, nke a pụrụ ime ka ọ bụrụ obere mbadamba) na data-offset haziri ka ọ bụrụ ọnụọgụ mgbasa ozi nke widget gị mbụ na-egosi:

<!-- 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>

Àgwà

Otu ego nkwụnye maka ntinye onye mmekọ si erute ha n'eziokwu — pasentị, usoro ịkwụ ụgwọ, na ihe achọrọ tupu.

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
}

Ọnọdụ ịkwụ ụgwọ

• Ọnụ ego niile onye mgbasa ozi ga-akwụ ruru oke kacha nta a ga-akwụ.
• E haziri akpa ego nkwụghachi crypto na akaụntụ ha.
• A kwadoro ọnọdụ KYC ha.

Nlereanya: ịgụ ego e chịkọtara

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
}

Ọkwa ọnụahịa (na-arụ ọrụ)

Gụọ ozugbo site na njedebe a — ejila koodu kwụ ọtọ dee ụkpụrụ ndị a, n'ihi na ha nwere ike ịgbanwe n'akụkụ anyị. Mepụta ngwa nhọpụta ogo maka ndị ọrụ gị kama iji ubi ọnụego efu: ọnụahịa ọ bụla egosiri bụ kpọmkwem ego ị ga-eziga mgbe ị na-emepụta ịkwụ ụgwọ, na uru ndị mepere emepe ebe a na-egosi ndị ọrụ kpọmkwem ihe ọnụahịa ahụ na-eweta, ka ha họrọ ọnụahịa ha ghọtara kama ịtụ ọnụọgụ.

A na-etinye oke arịrịọ kwa igodo kwa nkeji. Azịza ọ bụla e kwadoro nwere isi ozi X-RateLimit-Limit, X-RateLimit-Remaining, na X-RateLimit-Reset; ịgafe oke ahụ na-eweta koodu njehie 429 Too Many Requests yana isi ozi Retry-After.

Nhọrọ, maka onye mmekọ ọ bụla. Ruo mgbe ị ga-etinye ntinye, igodo gị na-anabata arịrịọ site na IP ọ bụla — ntinye mbụ na-agbanwe igodo niile nke onye mmekọ ahụ ka ha bụrụ naanị na ndepụta a kwadoro.

A na-ede akara HMAC-SHA256 na webhook ọ bụla site n'iji ihe nzuzo e nyere otu ugboro na oge e kere ya — nyochaa akara ahụ tupu ịtụkwasị obi na ibu ozi. A na-ebuga ihe omume naanị nye onye mmekọ nke nwe onye mgbasa ozi metụtara ya.