Sanada misoomaa

Gaaffiin hundi, mala 'Bearer scheme' fayyadamuun, mata duree 'Authorization' keessatti furtuu icciitiitiin ni mirkanaa'a.

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

Yoo furtuuwwan API keessan fayyadamtoota keessaniif akkaawuntii beeksisitootaa uuman (haala Wal-qunnamsiisii — mirkaneessa olitti ilaali), kaffaltii beeksisitoonni sun beeksisa isaaniif kaffalan irraa qoodni isin argattu jira. Qoodni armaan gadii kun kallattiidhaan iddoo xumuraa (endpoint) kana irraa dubbifama, gonkumaa koodii keessatti hin galle, akkasumas guutummaatti komishinii ergaa (referral commission) fuula kana irratti gara gadiitti argamu irraa adda.

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

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

Akkaataa itti hojjetu

1. Beeksisitoota kee kanneen moodii 'Connect-mode' fayyadaman keessaa tokko, wal-simsiisa kee fayyadamuun beeksisaaf kaffala.
2. Beeksisichi ni sakatta'ama, ni mirkanaa'as — ofumaan, yookaan garee keenya kan to'annoo raawwatuun.
3. Qoodni kee boorsaa keetti kaffaltii ofumaan raawwatamuuf hiriirfameera, kunis akkuma sagantaa namatti erguu isa gadii sanaati.

Ulaagaalee kaffaltii

• Boorsaan kaffaltii kiriptoo herrega hiriyaa kee irratti qindaa'eera.
• Gama keessaniin KYC kamiyyuu hin barbaachisu — herregni hiriyaa keessanii yeroo uumamu duraanuu mirkanaa'eera.

Fakkeenya: Aksiyoonota kuufaman dubbisuu

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
}

Akkaawuntiin beeksisaan hundi meeshaalee AI kanneen keessatti ijaaraman argata — kanneen akka jenereetara qabiyyee beeksisaa fi mul'ataa, gargaaraa haasawaa, gorsaa baajataa, fi odiitara SEO alaa — kanneen gatii waggaa murtaa'e irratti dabalataan kireeditii AI-tiin kaffalamu.

Fakkeenya — qabiyyee beeksisaa uumi

Ramaddiifi ibsi daldalaa kanuma akkasumas fakkii uumtuu isa gadii ni humneessu.

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
}

Beeksisa isaumaaf fakkii wal-fakkaatu uumi:

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
}

Yuunitii beeksisaa qophaa'e tokko marsariitii kee irratti buusi — tarkaanfii ijaarsaa hin qabu, ifraamii hin qabu. Iskiriiptiin kun kallattiidhaan fuula sana keessatti Shadow DOM adda ta'e keessatti mul'ata, kanaafuu istaayiloonni isaa gonkumaa gara marsariitii keetii hin babal'an, akkasumas istaayiloonni marsariitii keetii gara isaatti hin babal'an.

Fuula keetti dabali

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

Akka idileetti kun sadarkaa uummataa guutuu ramaddii sanaaf agarsiisa — beeksis-harkistuu madalicha irra jiru hunda, kanneen isin fiddan qofa miti. Beeksisa beeksis-harkistuuwwan karaa 'Connect mode' uumtan irraa qofa agarsiisuuf (kanneen qooda keessan maddisiisan), 'data-partner' lakkoofsa addaa hiriyaa keessanii wajjin dabalaa (fuula 'Developers' kan daashboordii keessanii irraa argadhaa):

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

Yoo beeksiftoonni kee ramaddiiwwan hedduu keessatti argaman, 'data-category' guutummaatti dhiisi — 'data-partner' qofaan, wiijetichi ramaddii hunda keessatti beeksisa kee hunda giridii tokko keessatti agarsiisa, ramaddii tokkoof biilookii wiijetii tokko barbaaduu mannaa:

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

Yoo yuunitii akka footer qabduu kan qabduu kee isa keessa-barruu cinaatti argamu, kan tokkoon tokkoon isaanii beeksisa adda addaa agarsiisan barbaadde, boolokii wiijetii lammaffaa kan data-layout="compact" (beeksisa tokko, kan gara qorqora xiqqootti cuunfamuu danda'u) fi data-offset kan akka lakkoofsa beeksisoota wiijetii kee inni jalqabaa duraan agarsiisuutti qindaa'e itti dabali:

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

Amaloota

Komiishiniin ergaa hiriyaa akkamitti dhugumaan isaan bira ga'a — dhibbeentaa, mala kaffaltii, fi uunkaalee dursaa.

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
}

Ulaagaalee kaffaltii

• Galii beeksisaan kaffaluu qabu walii galaa hamma kaffaltii xiqqaa ga'eera.
• Boorsaan kaffaltii kiriptoo herrega isaanii irratti qindaa'eera.
• Haalli KYC isaanii mirkanaa'eera.

Fakkeenya: galii walitti qabame dubbisuu

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
}

Sadarkaalee gatii (kallattiin)

Iddoo dhumaa kana irraa kallattiin dubbisi — gatiiwwan kana gonkumaa koodii keessatti qajeelchuu hin yaalin, gama keenyaan jijjiiramuu danda'u. Bakkaa dirree gatii bilisaa, fayyadamtoota keessaniif filannoo sadarkaa gatii ijaaraa: gatiin agarsiifamu hundi yeroo kaffaltii uumtu gatii sirrii ergamuudha, faayidaaleen banamoon asitti agarsiifamanis fayyadamtoonni gatiin sun maal akka isaan argamsiisu sirriitti akka beekaniif isaan gorsu, kanaafuu lakkoofsa tilmaamuu mannaa gatii isaan hubatan filatu.

Gaaffileen furtuu tokkoof daqiiqaa tokko keessatti daangaan itti kaa'ama. Deebiin mirkanaa'e hundi mata dureewwan X-RateLimit-Limit, X-RateLimit-Remaining, fi X-RateLimit-Reset of keessaa qaba; daangaa darbuun immoo, mata duree Retry-After waliin koodii dogoggoraa 429 Too Many Requests deebisa.

Filannoo, hiriyaa tokkoof. Hanga galmee itti dabaltutti, furtuuwwan kee gaaffii IP kamiyyuu irraa dhufu ni fudhatu — galmeen jalqabaa furtuuwwan hiriyaa sanaa hunda gara 'allowlist-only'tti jijjiira.

Webhook hundi yeroo uumamu icciitii yeroo tokkoof kennamuun HMAC-SHA256'n mallatteeffama — fe'umsa isaa amanuu keessan dura mallattoo isaa mirkaneeffadhaa. Taateewwan beeksisaan walqabatu qofa hiriyaa beeksisichaa abbummaadhaan qabuuf dhiyaatu.