Takardun mai haɓakawa

Ana tabbatar da sahihancin kowace buƙata ta amfani da makullin asiri a cikin taken izini, ta hanyar tsarin Bearer.

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

Idan makullin API ɗinku suna ƙirƙirar asusun masu talla ga masu amfani da ku (hanyar Haɗawa — duba Tabbatar da sahihanci a sama), za ku sami kaso na abin da waɗannan masu talla ke biya don tallansu. Rarraba kaso da ke ƙasa ana karanta shi kai tsaye daga wannan wurin ƙarshen, ba a taɓa saka shi a rubuce ba, kuma gaba ɗaya ya bambanta da kuɗin tallan da ke ƙasa a wannan shafin.

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

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

Yadda yake aiki

1. Ɗaya daga cikin masu tallan ku na yanayin haɗin kai yana biyan kuɗin talla ta hanyar haɗin ku.
2. An duba talla kuma an amince da ita — ta atomatik, ko ta ƙungiyar tantancewarmu.
3. An sanya rabonka a jerin jiran biyan kuɗi ta atomatik zuwa walat ɗinka, irin tsarin da ke a cikin shirin tura kawaye da ke ƙasa.

Sharuddan biyan kuɗi

• An saita walat na biyan crypto a asusun abokin hulɗarka.
• Ba a buƙatar KYC daga gare ku — an riga an tantance asusun abokin hulɗarku tun lokacin ƙirƙirarsa.

Misali: karanta hannun jari da aka 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
}

Kowane asusun mai talla yana samun tarin kayan aikin AI da aka gina a ciki — mai ƙirƙirar abun talla da abubuwan gani, mataimakin tattaunawa, mai ba da shawara kan kasafin kuɗi, da mai duba SEO na waje — ana biyan su da kiredit na AI, a ƙari ga farashin shekara-shekara da aka kayyade.

Misali — samar da abun talla

Kayan rukuni iri ɗaya da bayanin kasuwanci suna kuma ba da ƙarfi ga mai ƙirƙirar hoto da ke ƙasa.

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
}

Samarda hoto mai dacewa don wannan talla:

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
}

Sauke raka'ar talla da aka riga aka shirya zuwa shafinka — babu matakin gini, babu iframe. Skript din yana nuna kai tsaye a cikin shafin a cikin Shadow DOM mai zaman kansa, don haka salonninsa ba sa zubowa zuwa shafinka, kuma salon shafinka ba sa zubowa zuwa gare shi.

Ƙara shi zuwa shafinka

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

Ta tsohuwa, wannan yana nuna cikakken jerin matsayi na jama'a na rukuni — duk masu talla a dandamali, ba kawai waɗanda ka kawo ba. Don nuna tallace-tallace kawai daga masu talla da ka ƙirƙira ta hanyar yanayin Haɗin Kai (waɗanda ke samar da rabonka), ƙara data-partner tare da ID ɗin abokin tarayyarka (za ka same shi a shafin Masu Haɓaka na dashboard ɗinka):

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

Idan masu tallace-tallacenku sun shafi rukuni da yawa, ku cire data-category gaba ɗaya — da data-partner kaɗai, widget ɗin zai nuna duk tallace-tallacenku a duk rukunoni a cikin grid ɗaya, maimakon buƙatar bulo ɗaya na widget ga kowane rukuni:

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

Kana so a sami wani rukunin talla irin na ƙasan shafi (footer) a gefe guda da na cikin abun ciki, kowannensu yana nuna tallace-tallace daban? Ƙara wani rukunin widget na biyu da data-layout="compact" (talla guda ɗaya, mai iya ninka zuwa ƙananan ƙwaya) da data-offset da aka saita gwargwadon adadin tallace-tallacen da widget ɗinka na farko ke nunawa:

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

Halaye

Yadda ainihin kudaden komishin tura abokin hulɗa ke isa gare su — kaso, tsarin biyan kuɗi, da sharuddan da suka gabata.

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
}

Sharuddan biyan kudi

• Jimillar kuɗin da mai talla zai biya ta kai mafi ƙarancin adadin biyan kuɗi.
• An saita jakar biyan kuɗi ta crypto a asusunsu.
• An tabbatar da matsayin KYC ɗinsu.

Misali: karanta ribar da aka 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
}

Matakai na farashi (kai tsaye)

Karanta kai tsaye daga wannan endpoint — kada a rubuta waɗannan ƙimomi a lambar kai tsaye, za su iya canzawa a ɓangarenmu. Gina na'urar zaɓin mataki ga masu amfani da ku maimakon filin adadin kyauta: kowane farashi da aka nuna shi ne daidai adadin da za a tura lokacin ƙirƙirar biyan kuɗi, kuma fa'idodin da aka buɗe anan suna gaya wa masu amfani daidai abin da wannan farashin zai ba su, don haka su zaɓi farashi da suka fahimta maimakon yin hasashen lambar.

An iyakance buƙatu ga kowane maɓalli a kowane minti. Duk amsa da aka tabbatar tana ɗauke da kanun labarai X-RateLimit-Limit, X-RateLimit-Remaining, da X-RateLimit-Reset; idan an wuce iyaka, za a dawo da kuskuren 429 Too Many Requests tare da kanun labarai Retry-After.

Zaɓi ne, ga kowane abokin hulɗa. Har sai ka ƙara shigarwa, makullanka suna karɓar buƙatu daga kowace adireshin IP — shigarwa ta farko tana sa duk makullan wannan abokin hulɗa su zama suna karɓar buƙatu ne kawai daga jerin da aka amince da shi.

Kowane webhook ana sanya masa sa hannu da HMAC-SHA256 ta amfani da asiri da aka bayar sau ɗaya a lokacin ƙirƙira — tabbatar da sa hannun kafin a yarda da abun cikin saƙon. Ana isar da abubuwan da suka faru ne kawai ga abokin hulɗa da ke da mai talla da abin ya shafa.