Kàyyiti defarkat bi

Laaj bu nekk dañu koy wóoral ak benn caabi bu ñu nëbb ci boppu ndigal gi, ci jëfandikoo doxalinu Bearer.

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

Su fekkee ne say API keys dañuy ubbil say jëfandikukat seen bopp ay kontu piblisiteer (mode Connect — seetal Authentication ci kaw), dinga am sa wàll ci li piblisiteer yooyu di fey ngir seeni piblisite. Séddale bi ci suuf, ci endpoint bii lañu koy jëlee ci saa si, duñu ko bind ci code bi, te dafa wuute bépp ak komisyon referral bi nekk ci suuf ci xët wii.

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

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

Naka la doxee

1. Benn ci say siiwalkat yu nekk ci Connect-mode fay na ngir am ab siiwal jaarale ko ci sa integration.
2. Pub bi dañu koy seetlu te nangu ko — ci anam gu otomaatig, walla sunu ekip bu saytu bi.
3. Sa xaalis bi, dañu ko teg ci lim bi ngir fey la ko ci sa portmonee, ci anam gu otomaatig, te mooy menn doxalin bi nekk ci porogaraamu yónnee bi ci suuf.

Sart yi ngir jot xaalis bi

• Benn portmone crypto ngir fayam lañu regle ci kontu sa partener bi.
• Soxlawuloo KYC ci sa wet — sa kontu partener bi, seetlu nañu ko ba pare bi ñu ko sossee.

Misal: jàng aksiyoŋ yi dajaloo

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
}

Kont bu nekk bu kiy siiwal am na ay jumtukaay AI yu ñu ci boole — benn buy sos li ñuy siiwal ak nataal yi, ab ndimbal bu lay waxal, ab xelal ci wàllu bidse, ak ab seetkat bu bitim-kër ci SEO — te loolu lépp ñu ngi koy fey ak ay kredi AI, ci kaw njëg gu ñu tëral gu at mi.

Misal — sos li ñuy siiwal

Kureel gi ak melokaanu liggéey bi ñoo tax itam nataalukaay bii ci suuf di dox.

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
}

Defaral nataal bu ànd ak siiwal bii:

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
}

Dàllal benn unit pub bu ñu la waajal ba noppi ci sa daluweb bi — soxlawul benn tabax, soxlawul iframe. Script bi dafay wonewu ci biir xët wi ci biir benn Shadow DOM bu beru, kon stilam yi duñu mukk dugg ci sa daluweb, te stilu sa daluweb bi itam duñu mukk dugg ci biiram.

Yokkal ko ci sa xët.

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

Ci lu jekk, lii dafay wone klasmaan bu mboolem bu kategori bi — bépp publisiteer ci platform bi, du rekk ñi nga indi. Ngir wone rekk publisiteer yi nga sos ak Connect mode (ñi lay jox sa xaalis), yokkal data-partner ak sa ID partner (gise ko ci xëtu Developpeur yi ci sa dashboard):

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

Su fekkee ne say siiwal-kat yi ñoo ngi ci ay kategori yu bare, bàyyil data-category bépp — ak data-partner rekk, widget bi dina wone say siiwal-kat yépp ci kategori yépp ci benn grid, ci palàsu nga soxla benn bloc widget ngir kategori bu nekk:

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

Ndax bëgg nga benn widget bu melni footer ci wetu bi nga am ci biir content bi, te bu nekk di wone ay pub yu wuute? Yokkal benn ñaareelu widget block ak data-layout="compact" (benn pub rekk, bu ñu mën a tëj mu nekk benn butoŋ bu ndaw) ak data-offset bi nga teg ci limu pub yi sa widget bu njëkk bi di wone ba léegi:

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

Jikko yi

Naka la komisyonu joxe-joxe bi di aggee ci ki ko joxe — pàrtsaŋaas bi, ni ñu koy feye, ak sart yi war a fekku.

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
}

Sart yi ngir jot xaalis bi

• Xaalisu publisiteer bi ñu ko war a fey yépp mat na tolluwaay bi gën a tuuti bi ñu koy feye.
• Benn portmone crypto ngir fayam lañu taxawal ci kontam.
• Seetlu nañu seen KYC ba mu wóor.

Misal: Jàng xaalis bu dajaloo

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
}

Pàcc-pàccu njëg yi (mu ngi dox)

Jàngal ci saa si ci endpoint bii — bul mukk bind valeur yii ci code bi, ndaxte mën nañoo soppiku ci sunu wet. Defaral say jëfandikukat benn tànnukaayu tolluwaay ci palàsu benn toolu lim bu ubbeeku: tolluwaay bu nekk buñu wone mooy xaalis biñu war a yónnee ci saa si suñuy sos fey gi, te njariñ yiñu fi wone te ubbeeku dañuy xamal jëfandikukat yi li tolluwaay boobu di jural, ngir ñu tànn tolluwaay buñu xam ci palàsu di xalaat benn lim.

Laaj yi dañu leen a dayo ci kiliye bu nekk, ci simili bu nekk. Tontu bu nekk bu ñu wóoral dafa ànd ak tàggatukaay yu tudd X-RateLimit-Limit, X-RateLimit-Remaining, ak X-RateLimit-Reset; su weesoo dayo bi, dafay delloo 429 Too Many Requests ak tàggatukaay bu tudd Retry-After.

Tànneef la, ci partener bu nekk. Ba keroog nga dugal benn duggal, say caabi dañuy nangu laaj yu jóge ci IP bu mu mën a doon — duggal bu njëkk bi dafay soppi caabi yépp yu partener boobu ngir ñu nangu rekk li ñu laa ngel.

Webhook bu nekk dañu koy sinye ak HMAC-SHA256, ci jëfandikoo ab sekere bu ñu joxe benn yoon rekk, ci waxtu sos gi — seetal sinye bi bala ngaa wóolu li nekk ci biir. Xibaar yi, dañu leen di yónnee rekk partener bi moom piblisiteer bi mu àju.